调用UnassociateNetworkAcl接口解除网络ACL与交换机的绑定。

使用说明

  • UnassociateNetworkAcl接口属于异步接口，即系统返回一个请求ID，但该网络ACL与交换机尚未解绑成功，系统后台的解绑任务仍在进行。您可以调用DescribeNetworkAclAttributes查询网络ACL与交换机的解绑状态：
    • 当网络ACL与交换机处于UNBINDING状态时，表示网络ACL与交换机正在解绑中。
    • 当网络ACL与交换机处于UNBINDED状态时，表示网络ACL与交换机解绑成功。
  • UnassociateNetworkAcl接口不支持针对同一个网络ACL并发解绑交换机。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Resource.N.ResourceType String 是 VSwitch

要解绑的关联资源类型。取值：VSwitch，交换机。

N的取值为0~29，即最多可以解绑30个资源。
Resource.N.ResourceId String 是 vsw-bp1de348lntdw****

要解绑的关联资源的ID。
NetworkAclId String 是 nacl-a2do9e413e0sp****

要解绑关联资源的网络ACL的ID。
RegionId String 是 cn-hangzhou

网络ACL所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

客户端Token，用于保证请求的幂等性。

由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。
Action String 是 UnassociateNetworkAcl

系统规定参数。取值：UnassociateNetworkAcl。

返回数据

名称 类型 示例值 描述
RequestId String AD024BAA-2D91-48FD-810B-8FB7489B6EE6

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Resource=[{"ResourceType":"VSwitch","ResourceId":"vsw-bp1de348lntdw****"}]
&NetworkAclId=nacl-a2do9e413e0sp****
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=UnassociateNetworkAcl
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UnassociateNetworkAclResponse>
    <RequestId>AD024BAA-2D91-48FD-810B-8FB7489B6EE6</RequestId>
</UnassociateNetworkAclResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "AD024BAA-2D91-48FD-810B-8FB7489B6EE6"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidNetworkAcl.NotFound The special Network Acl is not found. 未找到指定的网络Acl
400 Mismatch.NetworkAclAndVSwitch The specified network ACL and vSwitch are not matched. 指定的网络ACL和交换机没有关联关系
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

访问错误中心查看更多错误码。