Db2 Q レプリケーション構成でのレプリケーション・セットのリスト表示

Db2 Replication REST API を使用して、 Db2 Q Replication 構成内のレプリケーション・セットのリストを要求できます。

始める前に

このタスクは、複製ソースのクラスター・ホストで実行されます。 API 呼び出しを実行する前に、必ず以下の情報を収集してください。

  • Db2® インスタンス ID
  • クラスター・ホスト上のソースの基本許可トークン。1
  • レプリケーション・ソース・データベースのホスト名。
  • 複製ソース・データベースの外部ポート番号。2
  • レプリケーション・ソース・データベースのユーザー名とパスワード。
必要な Replication REST API 呼び出しを実行するには、この情報が必要です。
1 cURL 要求を実行するには、基本許可トークンを作成する必要があります。 トークンを作成するには、次のコマンドを実行します。
echo <source_db_username>:<source_db_password> | base64
2 以下のコマンドを実行して、複製ソース・データベースの外部ポート番号を取得できます。
oc get svc | grep <db2_instance_id> | grep db2u-engn-svc | grep 50001 | sed 's/.*50001://' | sed 's/\/TCP.*//')

このタスクについて

手順

Db2 Q レプリケーション構成からレプリケーション・セットのリストを取得します。
curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>'  
'https://<source_hostname>:<source_rest_port>/dr/v1/replicationset'

結果

executionState=COMPLETED および overallJobResult=PASS を含む応答メッセージが返されると、レプリケーション・セット・リスト要求が完了します。 これらの値が戻されるまで、応答内のエラー・コード、メッセージ、および解決を調べてください。
次の表は、レプリケーション・セット詳細要求で使用可能な HTTP ステータス・コードと応答メッセージの一覧です。 また、応答構文を示すサンプル・コードも含まれています。
HTTP状況コード 理由 応答モデル
200 レプリケーション・セットのリスト ユーザー・リクエストは、APIコールの開始時にジョブ （id ）と URL （サンプル値）を返す：

{
  "replicationSets": [
    {
      "rsName": "RS_MPP_2",
      "sourceHost": "dr-source1.ibm.com",
      "sourcePort": 31576,
      "sourceDatabase": "BLUDB",
      "targetHost": "dr-target1..ibm.com",
      "targetPort": 30138,
      "targetDatabase": "BLUDB",
      "consistencyGroups": [
        {
          "cgName": "RSMPP20001",
          "state": "ACTIVE",
          "alert": "NONE",
          "sourceState": "A",
          "sourceStateTime": 1676422252084,
          "targetState": "A",
          "targetStateTime": 1677360282268,
          "targetStateInfo": "ASN7526I",
          "lastConsistencyPoint": 1677377949000,
          "endToEndLatency": 0,
          "throughput": 0,
          "id": 8,
          "numOfActiveTables": 1,
          "numOfInactiveTables": 0,
          "numOfWaitingTables": 0,
          "numOfLoadingTables": 0,
          "numOfDelayedTables": 0,
          "numOfErrorTables": 0,
          "numOfTables": 1,
          "errors": []
        }
      ]
    },
    {
      "rsName": "RS_TEST2",
      "sourceHost": "dr-source1.ibm.com",
      "sourcePort": 31576,
      "sourceDatabase": "BLUDB",
      "targetHost": "dr-target3.ibm.com",
      "targetPort": 30138,
      "targetDatabase": "BLUDB",
      "consistencyGroups": [
        {
          "cgName": "apidrd0001",
          "state": "INACTIVE",
          "alert": "NONE",
          "sourceState": "I",
          "sourceStateTime": 1676419244157,
          "targetState": "A",
          "targetStateTime": 1677360282293,
          "targetStateInfo": "ASN7526I",
          "lastConsistencyPoint": -2208988800000,
          "endToEndLatency": 0,
          "throughput": 0,
          "id": -1,
          "numOfActiveTables": 0,
          "numOfInactiveTables": 0,
          "numOfWaitingTables": 0,
          "numOfLoadingTables": 0,
          "numOfDelayedTables": 0,
          "numOfErrorTables": 0,
          "numOfTables": 0,
          "errors": []
        }
      ]
    }
  ]
}
4xx クライアント要求エラー 誤った形式の要求構文またはその他のクライアントの問題が原因で、ユーザー要求が満たされませんでした。
{
  "errorCode": "string",
  "errorMessage": "string",
  "errorResolution": "string"
}
5xx サーバー・エラー ユーザー要求は有効と思われましたが、サーバーの問題が原因で実行されませんでした:
{
  "errorCode": "string",
  "errorMessage": "string",
  "errorResolution": "string"
}

例

以下の例は、レプリケーション・セットのリストを要求するためのコマンド構文を示しています。
curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic ZHNhZG06MDNRVWlMczFhcmoxb3ky' 
'https://dr-source1.ibm.com:31023/dr/v1/replicationset'

次のタスク

レプリケーションセットの詳細のリスト