機能の概要
このAPIは、テナント接続アドレスのポート番号を変更するために使用されます。
呼び出しの説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法については、アクセスキーの管理を参照してください。
リクエストパス
PUT /api/v2/instances/{instanceId}/tenants/{tenantId}/addressPort
リクエストパラメータ
Path
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| instanceId | string | はい | OceanBaseクラウドデータベースインスタンスID。 | ob317v4uif**** |
| tenantId | string | はい | テナントID。 | ob2mr3oae0**** |
Query
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| requestId | String | はい | リクエストID | 6e87d618-854e-4ca1-ae1f-babc******** |
Body
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| addressId | String | はい | アドレスID | your-address-id |
| proxyClusterId | String | はい | プロキシクラスタID | proxy-6tvgz6z2**** |
| serviceType | String | はい | アドレスタイプ | OBPROXY_INTRANET、OBPROXY_INTERNET、OBPROXY_READONLY、OBPROXY_READWRITE...... |
| port | Integer | はい | 新しいポート | 12345 |
実行結果
名前 |
型 |
説明 |
サンプル値 |
|---|---|---|---|
| success | boolean | 操作の成功 | true/false |
| errorCode | string | エラーコード | "E001" |
| errorMessage | string | エラーメッセージ | "操作は成功しました" |
| data | object | 業務データ | {...} |
| data.addressId | string | vip service group name | "12345" |
| cost | integer[int64] | 所要時間(ミリ秒) | 150 |
| server | string | サーバーアドレス | "xx.xxx.xx.xxx" |
| requestId | string | リクエストID | "req_20250811_001" |
| totalCount | integer[int64] | 総数 | 100 |
| extra | object | 追加情報 | {"key1": "value1"} |
例
リクエスト例
curl --digest -u '<Your AccessKey ID:AccessKey Secret>' \
--request PUT \
--url 'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/tenants/{tenantId}/addressPort?requestId={requestId}' \
-H 'X-Ob-Project-Id: <プロジェクトID>' \
-H 'Content-Type: application/json' \
--data '{"addressId": "your-address-id", "proxyClusterId": "proxy-6tvgz6z2****", "serviceType": "OBPROXY_INTRANET", "port": 33061}'
説明
- プロジェクトIDはプロジェクトを一意に識別するものです。プロジェクト管理を参照して、クラスタのプロジェクトIDを取得できます。
- instanceIdが属するプロジェクトのIDと指定されたプロジェクトIDが一致していることを確認してください。
レスポンス例
{
"success": true,
"errorCode": "E001",
"errorMessage": "操作は成功しました",
"data": {
"addressId": "your-address-id"
},
"cost": 150,
"server": "xxx.xxx.x.xxx:xxxx",
"requestId": "req_20250811_001",
"totalCount": 1,
"extra": {}
}