调用AssociateNetworkAcl接口，绑定网络ACL至交换机。

使用说明

  • AssociateNetworkAcl接口属于异步接口，即系统返回一个请求ID，但该网络ACL尚未绑定成功，系统后台的绑定任务仍在进行。您可以调用DescribeNetworkAclAttributes查询网络ACL的绑定状态：
    • 当网络ACL处于BINDING状态时，表示网络ACL正在绑定中。
    • 当网络ACL处于BINDED状态时，表示网络ACL绑定成功。
  • AssociateNetworkAcl接口不支持并发绑定同一个网络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，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

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

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

返回数据

名称 类型 示例值 描述
RequestId String 4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

<AssociateNetworkAclResponse>
    <RequestId>4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7</RequestId>
</AssociateNetworkAclResponse>

JSON格式

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

{
  "RequestId" : "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidNetworkAcl.NotFound The special Network Acl is not found. 未找到指定的网络Acl
400 InvalidResource.BindingExist The binding instance has been binded. 待绑定的实例已经处于绑定状态了
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

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