功能介紹
刪除IP地址組中的IP網(wǎng)段。 該接口屬于異步接口,接口返回后,后臺的刪除任務仍在執(zhí)行;可以使用查詢IP地址組詳情接口查詢狀態(tài),當IP地址組狀態(tài)為ACTIVE時,表示條目刪除完成。
調用方法
請參見如何調用API。
URI
POST /v1/ip-groups/{ip_group_id}/remove-ips
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
ip_group_id |
是 |
String |
IP地址組ID。 最小長度:1 最大長度:36 |
請求參數(shù)
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用戶Token。通過調用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值)。 |
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
ip_list |
是 |
Array of strings |
IP地址組中的IP網(wǎng)段列表,一次最多支持刪除20個條目。 最小長度:1 最大長度:50 數(shù)組長度:1 - 20 |
響應參數(shù)
狀態(tài)碼: 200
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
request_id |
String |
請求ID。 |
請求示例
刪除IP地址組中的IP網(wǎng)段
POST https://{ga_endpoint}/v1/ip-groups/e8996cd6-28cf-4ff2-951e-fa8ac895a6cd/remove-ips { "ip_list" : [ "127.0.0.0/24" ] }
響應示例
狀態(tài)碼: 200
操作成功
{ "request_id" : "ac1bf54f-6a23-4074-af77-800648d25bc8" }
狀態(tài)碼
狀態(tài)碼 |
描述 |
---|---|
200 |
操作成功 |
錯誤碼
請參見錯誤碼。