功能介紹
添加IP地址組中的IP網(wǎng)段。 該接口屬于異步接口，接口返回后，后臺的添加任務(wù)仍在執(zhí)行；可以使用查詢IP地址組詳情接口查詢狀態(tài)，當IP地址組狀態(tài)為ACTIVE時，表示條目添加完成。
調(diào)用方法
請參見如何調(diào)用API。
URI
POST /v1/ip-groups/{ip_group_id}/add-ips
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
ip_group_id |
是 |
String |
IP地址組ID。 最小長度：1 最大長度：36 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取（響應消息頭中X-Subject-Token的值）。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
ip_list |
是 |
IP地址組中的IP網(wǎng)段列表，一次最多支持添加20個條目。 數(shù)組長度：1 - 20 |
響應參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
request_id |
String |
請求ID。 |
請求示例
在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"
} ]
}
響應示例
狀態(tài)碼： 200
操作成功
{
"request_id" : "ac1bf54f-6a23-4074-af77-800648d25bc8"
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
操作成功 |
錯誤碼
請參見錯誤碼。
