调用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 错误码 错误信息 描述
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

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