删除已经导入的IP黑名单
功能介绍
删除流量过滤功能下已经导入的IP黑名单,指定生效范围进行删除。 标准版的墙只会存在生效范围为EIP的IP黑名单,专业版的墙会存在生效范围为EIP和NAT的IP黑名单。
调用方法
请参见如何调用API。
URI
DELETE /v1/{project_id}/ptf/ip-blacklist
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,可以通过调用API获取,也可以从控制台获取。项目ID获取方式 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
fw_instance_id |
是 |
String |
防火墙ID,可通过防火墙ID获取方式获取 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
effect_scope |
否 |
Array of integers |
指定生效范围,1指定生效范围为EIP进行删除,2指定生效范围为NAT进行删除,1,2生效范围为EIP和NAT进行删除 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
data |
Object |
导入数据 |
请求示例
删除项目ID为eefb11b22d5944f2aa067954516df1cf,防火墙实例ID为812f478c-940e-4e00-824f-7287250d76dc上的IP黑名单,指定生效范围为EIP进行删除。
https://{Endpoint}/v1/eefb11b22d5944f2aa067954516df1cf/ptf/ip-blacklist?fw_instance_id=812f478c-940e-4e00-824f-7287250d76dc { "effect_scope" : [ 1 ] }
响应示例
状态码:200
删除IP黑名单成功的响应,删除成功的情况下,此响应体内所有字符都为空。
{ }
SDK代码示例
SDK代码示例如下。
删除项目ID为eefb11b22d5944f2aa067954516df1cf,防火墙实例ID为812f478c-940e-4e00-824f-7287250d76dc上的IP黑名单,指定生效范围为EIP进行删除。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 |
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cfw.v1.region.CfwRegion; import com.huaweicloud.sdk.cfw.v1.*; import com.huaweicloud.sdk.cfw.v1.model.*; import java.util.List; import java.util.ArrayList; public class DeleteIpBlacklistSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CfwClient client = CfwClient.newBuilder() .withCredential(auth) .withRegion(CfwRegion.valueOf("<YOUR REGION>")) .build(); DeleteIpBlacklistRequest request = new DeleteIpBlacklistRequest(); IpBlacklistDeleteDto body = new IpBlacklistDeleteDto(); List<Integer> listbodyEffectScope = new ArrayList<>(); listbodyEffectScope.add(1); body.withEffectScope(listbodyEffectScope); request.withBody(body); try { DeleteIpBlacklistResponse response = client.deleteIpBlacklist(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } |
删除项目ID为eefb11b22d5944f2aa067954516df1cf,防火墙实例ID为812f478c-940e-4e00-824f-7287250d76dc上的IP黑名单,指定生效范围为EIP进行删除。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
# coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcfw.v1.region.cfw_region import CfwRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcfw.v1 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CfwClient.new_builder() \ .with_credentials(credentials) \ .with_region(CfwRegion.value_of("<YOUR REGION>")) \ .build() try: request = DeleteIpBlacklistRequest() listEffectScopebody = [ 1 ] request.body = IpBlacklistDeleteDto( effect_scope=listEffectScopebody ) response = client.delete_ip_blacklist(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) |
删除项目ID为eefb11b22d5944f2aa067954516df1cf,防火墙实例ID为812f478c-940e-4e00-824f-7287250d76dc上的IP黑名单,指定生效范围为EIP进行删除。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cfw "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cfw/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cfw/v1/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cfw/v1/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() client := cfw.NewCfwClient( cfw.CfwClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.DeleteIpBlacklistRequest{} var listEffectScopebody = []int32{ int32(1), } request.Body = &model.IpBlacklistDeleteDto{ EffectScope: &listEffectScopebody, } response, err := client.DeleteIpBlacklist(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } |
更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。
状态码
状态码 |
描述 |
---|---|
200 |
删除IP黑名单成功的响应,删除成功的情况下,此响应体内所有字符都为空。 |
401 |
Unauthorized,错误的请求 |
403 |
Forbidden,禁止访问 |
错误码
请参见错误码。