組織を調整する

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

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

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

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

調整の手順

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

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

変更後（Opt-out 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 の値を復元します。
- 変更後（Opt-in 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 トピックを復元する）

復元された構成