功能介紹
添加IP地址組中的IP網(wǎng)段。 該接口屬于異步接口，接口返回后，后臺(tái)的添加任務(wù)仍在執(zhí)行；可以使用查詢(xún)IP地址組詳情接口查詢(xún)狀態(tài)，當(dāng)IP地址組狀態(tài)為ACTIVE時(shí)，表示條目添加完成。
調(diào)用方法
請(qǐng)參見(jiàn)如何調(diào)用API。
URI
POST /v1/ip-groups/{ip_group_id}/add-ips
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
ip_group_id |
是 |
String |
IP地址組ID。 最小長(zhǎng)度：1 最大長(zhǎng)度：36 |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶(hù)Token。通過(guò)調(diào)用 IAM 服務(wù)獲取用戶(hù)Token接口獲取（響應(yīng)消息頭中X-Subject-Token的值）。 |
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
ip_list |
是 |
IP地址組中的IP網(wǎng)段列表，一次最多支持添加20個(gè)條目。 數(shù)組長(zhǎng)度：1 - 20 |
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|
|
request_id |
String |
請(qǐng)求ID。 |
請(qǐng)求示例
在IP地址組中添加IP網(wǎng)段127.0.0.0/24
POST https://{ga_endpoint}/v1/ip-groups/e8996cd6-28cf-4ff2-951e-fa8ac895a6cd/add-ips
{
"ip_list" : [ {
"cidr" : "127.0.0.0/24",
"description" : "cidr description"
} ]
}
響應(yīng)示例
狀態(tài)碼： 200
操作成功
{
"request_id" : "ac1bf54f-6a23-4074-af77-800648d25bc8"
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
操作成功 |
錯(cuò)誤碼
請(qǐng)參見(jiàn)錯(cuò)誤碼。
猜你喜歡
