調用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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。