組織を調整する

調整プロセスでは、既存の Apigee Edge for Private Cloud 組織のすべての API メタデータ（プロキシ、環境など）を API ハブに再同期できます。通常、このプロセスは、データに不整合があると思われる場合や、すべての API 定義の完全な再同期が必要な場合に使用します。

このプロセスには、次の 2 つの主なアクションが含まれます:

コネクタの構成を変更して、特定の組織を一時的にオプトアウトする
すぐにオプトインする

このシーケンスにより、コネクタはその組織のすべてのメタデータの完全なフェッチとアップロードを再度実行します。

調整の手順

組織を調整するには、コネクタの構成ファイルを 2 回変更し、変更するたびにコネクタサービスを再起動します。

現在の構成ファイルのバックアップを作成します。
オプトアウトする組織から runtimeDataPubsub と metadataPubsub のみ削除します。
uapim コネクタサービスを再起動します。
ステップ 1 で作成したバックアップに元の uapim コネクタ設定を復元して、現在の組織をオプトインします。
uapim コネクタサービスを再起動します。

組織をオプトアウトする（Pub/Sub トピックを削除する）

このステップでは、組織を Pub/Sub トピックから削除します。コネクタに、ターゲット組織のメタデータの同期を一時的に停止するよう通知します。

コネクタの構成を編集する: コネクタ VM の構成ファイル /opt/apigee/customer/application/uapim-connector.properties を開きます。
conf_uapim_connector.uapim.settings.json を変更する: connectorConfig セクションで、調整する組織（organization1 など）の runtimeDataPubsub と metadataPubsub の値を削除します。serviceAccount と pluginInstanceId はそのままにします。

変更前（例）:

{
  "connectorConfig" : { 
    "organization1" : { 
      "runtimeDataPubsub" : "projects/p1/topics/rt-topic-org1", 
      "metadataPubsub":"projects/p1/topics/md-topic-org1",
      "serviceAccount": "mysa1@in.myfirstProject",
      "pluginInstanceId":"aaaa"
    }, 
    "organization2" : { 
      "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
      "metadataPubsub":"projects/p2/topics/md-topic-org2",
      "serviceAccount": "mysa2@in.mySecondProject",
      "pluginInstanceId":"bbbbb"
    }
  },
  "runtimeDataPath":"/the/nfs/mounted/path",
  "managementServer": "hostname"
}

変更後（organization1 をオプトアウト）:

{
  "connectorConfig" : { 
    "organization1" : { 
      "runtimeDataPubsub" : "", 
      "metadataPubsub":"",
      "serviceAccount": "mysa1@in.myfirstProject",
      "pluginInstanceId":"aaaa"
    }, 
    "organization2" : { 
      "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
      "metadataPubsub":"projects/p2/topics/md-topic-org2",
      "serviceAccount": "mysa2@in.mySecondProject",
      "pluginInstanceId":"bbbbb"
    }
  },
  "runtimeDataPath":"/the/nfs/mounted/path",
  "managementServer": "hostname"
}

コネクタサービスを再起動する（オプトアウト）:

Apigee API Hub for Private Cloud コネクタを再起動して、変更を適用します。
```
apigee-service edge-uapim-connector restart
```

組織をオプトインする（Pub/Sub トピックを復元する）

このステップでは、組織を Pub/Sub トピックに復元します。コネクタに、メタデータの完全な同期を新たに開始するよう通知します。
- コネクタの構成を編集する: 構成ファイルを再度開きます:/opt/apigee/customer/application/uapim-connector.properties
- conf_uapim_connector.uapim.settings.json を変更する: connectorConfig セクションで、調整する組織（organization1 など）の runtimeDataPubsub と metadataPubsub の値を復元します。
- 変更後（organization1 をオプトイン）:
```
{
  "connectorConfig" : { 
    "organization1" : { 
      "runtimeDataPubsub" : "projects/p1/topics/rt-topic-org1", 
      "metadataPubsub":"projects/p1/topics/md-topic-org1",
      "serviceAccount": "mysa1@in.myfirstProject",
      "pluginInstanceId":"aaaa"
    }, 
    "organization2" : { 
      "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
      "metadataPubsub":"projects/p2/topics/md-topic-org2",
      "serviceAccount": "mysa2@in.mySecondProject",
      "pluginInstanceId":"bbbbb"
    }
  },
  "runtimeDataPath":"/the/nfs/mounted/path",
  "managementServer": "hostname"
}
```
復元された構成

コネクタサービスを再起動する（オプトイン）:

コネクタサービスを再度再起動して、メタデータの完全な再同期をトリガーします。
```
apigee-service edge-uapim-connector restart
```

コネクタは、ターゲット組織のすべての API メタデータの完全なオプトインを実行します。ステータスエンドポイント curl localhost:8080/v1/uapim/status を使用して進行状況をモニタリングできます。

組織を調整する

調整の手順

組織をオプトアウトする（Pub/Sub トピックを削除する）

組織をオプトインする（Pub/Sub トピックを復元する）

復元された構成