调用AssociateNetworkAcl接口，绑定网络ACL到交换机。
接口说明
- AssociateNetworkAcl 接口属于异步接口，即系统返回一个请求 ID，但该网络 ACL 尚未绑定成功，系统后台的绑定任务仍在进行。您可以调用 DescribeNetworkAclAttributes 查询网络 ACL 的绑定状态：
当网络 ACL 处于 BINDING 状态时，表示网络 ACL 正在绑定中。
当网络 ACL 处于 BINDED 状态时，表示网络 ACL 绑定成功。
AssociateNetworkAcl 接口不支持并发绑定同一个网络 ACL。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Resource |
array<object> |
否 |
关联的资源信息。 |
|
|
object |
否 |
关联的资源信息。 |
||
| ResourceType |
string |
是 |
关联资源的类型。取值：VSwitch，交换机。 N 的取值为 0~29，即最多可以关联 30 个资源。 |
VSwitch |
| ResourceId |
string |
是 |
关联资源的 ID。 |
vsw-bp1de348lntdw**** |
| NetworkAclId |
string |
是 |
网络 ACL 的 ID。 |
nacl-a2do9e413e0sp**** |
| RegionId |
string |
是 |
网络 ACL 所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| ClientToken |
string |
否 |
客户端 Token，用于保证请求的幂等性。 从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。 |
123e4567-e89b-12d3-a456-426655440000 |
| DryRun |
boolean |
否 |
是否检测此次请求。取值：
|
false |
| RegionId |
string |
是 |
网络 ACL 所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7 |
示例
正常返回示例
JSON格式
{
"RequestId": "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ParameterMissing.AliUid | ParameterMissing.AliUid | |
| 400 | ParameterMissing.Bid | ParameterMissing.Bid | |
| 400 | ParameterMissing.RegionId | ParameterMissing.RegionId | |
| 400 | ParameterEmpty.RegionId | ParameterEmpty.RegionId | |
| 400 | ParameterMissing.NetworkAclId | ParameterMissing.NetworkAclId | |
| 400 | ParameterEmpty.NetworkAclId | ParameterEmpty.NetworkAclId | |
| 400 | ParameterMissing.Resources | ParameterMissing.Resources | |
| 400 | ParameterEmpty.Resources | ParameterEmpty.Resources | |
| 400 | InvalidNetworkAcl.NotFound | The special Network Acl is not found. | 未找到指定的网络Acl |
| 400 | NetworkStatus.Modifying | The special Network Acl is in modifying. | 特殊网络Acl正在修改中。 |
| 400 | ResourceStatus.Error | The binding instance is in middle status. | 绑定实例处于中间状态。 |
| 400 | InvalidResource.NotFound | The binding instance is not found. | |
| 400 | InvalidResource.VpcError | The network acl and resource not in same vpc. | |
| 400 | InvalidResource.BindingExist | The binding instance has been binded. | 待绑定的实例已经处于绑定状态了 |
| 400 | NotSupport.NetworkAcl | Network acl is not support now. | |
| 400 | ParameterIllegal.ResourceType | The specified resource type is illegal. | |
| 400 | MissingParam.Resource | Missing parameter Resource. | 参数Resource缺失 |
| 400 | OperationDenied.NetworkAclAttachmentInMiddleStatus | The network ACL is being bound to or unbound from the switch. | 网络ACL 正在与交换机绑定中或者解绑中 |
| 500 | InternalError | The request processing has failed due to some unknown error. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。