機能説明
このAPIは、テナントのセキュリティアローリスト情報を作成するために使用されます。アローリストの詳細な使用方法については、テナントアローリストグループの設定をご参照ください。
注意
現在、このAPIのアローリストは開放されています。使用する場合は、テクニカルサポートにお問い合わせください。
呼び出し説明
API制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法については、アクセスキーの管理をご参照ください。
リクエストパス
POST /api/v2/instances/{instanceId}/tenants/{tenantId}/securityIpGroups
リクエストパラメータ
Query
名前 |
タイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| instanceId | string | はい | OceanBase CloudデータベースインスタンスID。 | ob317v4uif**** |
| tenantId | string | はい | テナントID。 | t4louaeei**** |
| requestId | string | はい | 追跡用のリクエストID。 | dc302d76-66b5-48d8-ab53-a035******** |
Body
項目 |
タイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| securityIps | string | はい | IPセキュリティアローリストのリストです。JSON形式の配列で、配列内の各オブジェクトはIP文字列またはIPアドレス帯域です。最大40個を設定できます。 | "["192.*.."]" |
| securityIpGroupName | string | はい | IPセキュリティアローリストグループの名前です。小文字の英字で始まり、小文字の英字または数字で終わります。小文字の英字、数字、アンダースコアのみ含み、長さは2～32文字です。 | paytest |
戻り値
項目 |
タイプ |
説明 |
サンプル値 |
|---|---|---|---|
| data | object | テナントのセキュリティホワイトリスト情報。 | |
| tenantId | string | テナントID。 | t4louaeei**** |
| securityIpGroupName | string | ホワイトリストグループ名。 | paytest |
| securityIpGroupType | string | ホワイトリストグループタイプ。
|
|
| securityIps | string | ホワイトリストリスト。カンマ区切り文字列で、各要素はIPアドレスまたはIPアドレス範囲です。 | "["192.*.."]" |
例
リクエスト例
curl -v --location \
--digest -u '<Your AK:SK>' \
--request POST \
--url 'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/tenants/{tenantId}/securityIpGroups?requestId={requestId}' \
-H 'X-Ob-Project-Id: <Project ID>' \
-H 'Content-Type: application/json' \
--data '{"securityIps":"[\"192.*..\"]", "securityIpGroupName": "paytest"}'
説明
- プロジェクトIDはプロジェクトの一意の識別子です。プロジェクト管理を参照して、クラスタのプロジェクトIDを取得できます。
- インスタンスIDが属するプロジェクトのIDと指定したプロジェクトIDが一致していることを確認してください。
レスポンス例
JSON形式
{
"data": {
"instanceId": "ob3n****7mx9c",
"securityIpGroupName": "zhi****111",
"securityIps": "[\"127.x.x.x\", \"x.x.x.x\"]",
"tenantId": "t****2u5q6l4w"
},
"requestId": "b****1010",
"success": true
}