機能の概要
テナントのプライマリゾーン設定を変更するために使用され、フェイルオーバーやロードバランシングなどのシナリオに適しています。
呼び出しの説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法については、アクセスキーの管理をご参照ください。
リクエストパス
PUT /api/v2/instances/{instanceId}/tenants/{tenantId}/primaryZone
リクエストパラメータ
Path
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
例 |
|---|---|---|---|---|
| instanceId | String | はい | OceanBaseクラスタID | obcluster-***** |
| tenantId | String | はい | テナントID | t4louaeei**** |
Query
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
例 |
|---|---|---|---|---|
| requestId | String | はい | リクエストID。追跡に使用されます | dc302d76-66b5-48d8-ab53-a035******** |
Body
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
例 |
|---|---|---|---|---|
| primaryZone | String | はい | テナントのプライマリゾーン | primaryZone_7766715fb478 |
| proxyAddressMasterZone | String | はい | リンクのプライマリゾーン | proxyAddressMasterZone_c0831d11a19e |
戻り値
パラメータ名 |
パラメータタイプ |
説明 |
|---|---|---|
| requestId | String | リクエストID |
| success | Boolean | リクエストが成功したかどうか |
例
リクエスト例
curl --digest -u '<Your AK:SK>' \
-X PUT \
'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/tenants/{tenantId}/primaryZone?requestId={requestId}' \
-H 'Content-Type: application/json' \
--data '{
"primaryZone": "primaryZone_7766715fb478",
"proxyAddressMasterZone": "proxyAddressMasterZone_c0831d11a19e"
}'
レスポンス例
JSON形式
{
"requestId": "xxxxxx",
"success": true
}
パブリッククラウドとの違い
マルチクラウドとパブリッククラウドでは、大きな違いがあります。パブリッククラウドでは、このインターフェースを使用してテナントのプライマリゾーンとリンクのプライマリゾーンを同時に変更できますが、ユーザーは対応するVPCとVSwitchを入力する必要があります。