Associa uma lista de controle de acesso (ACL) de rede a um vSwitch.
Descrição da operação
Descrição
-
AssociateNetworkAcl é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Você pode chamar a operação DescribeNetworkAclAttributes para consultar o status da tarefa.
Se a ACL de rede estiver no estado BINDING, a ACL de rede está sendo associada.
Se a ACL de rede estiver no estado BINDED, a ACL de rede está associada.
-
Você não pode chamar repetidamente a operação AssociateNetworkAcl para associar uma ACL de rede dentro do período de tempo especificado.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| Resource |
array<object> |
Não |
As informações sobre os recursos associados. |
|
|
object |
Não |
|||
| ResourceType |
string |
Sim |
O tipo de recurso ao qual você deseja associar a ACL de rede. Defina o valor como VSwitch. Valores válidos de N: 0 a 29. Você pode associar uma ACL de rede a até 30 vSwitches. |
VSwitch |
| ResourceId |
string |
Sim |
O ID do recurso associado. |
vsw-bp1de348lntdw**** |
| NetworkAclId |
string |
Sim |
O ID da ACL de rede. |
nacl-a2do9e413e0sp**** |
| RegionId |
string |
Sim |
O ID da região da ACL de rede. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. |
cn-hangzhou |
| ClientToken |
string |
Não |
O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota
Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como o token de cliente. O ID da solicitação pode ser diferente para cada solicitação. |
123e4567-e89b-12d3-a456-426655440000 |
| DryRun |
boolean |
Não |
Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. |
false |
| RegionId |
string |
Sim |
O ID da região da ACL de rede. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. |
cn-hangzhou |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7 |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 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. | The network ACL is not found. |
| 400 | NetworkStatus.Modifying | The special Network Acl is in modifying. | The network ACL is being modified. |
| 400 | ResourceStatus.Error | The binding instance is in middle status. | The status of the instance is invalid. |
| 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. | The instance is already in the Associated state. |
| 400 | NotSupport.NetworkAcl | Network acl is not support now. | |
| 400 | ParameterIllegal.ResourceType | The specified resource type is illegal. | |
| 400 | MissingParam.Resource | Missing parameter Resource. | Missing parameter Resource |
| 400 | OperationDenied.NetworkAclAttachmentInMiddleStatus | The network ACL is being bound to or unbound from the switch. | The network ACL is being bound to or unbound from the switch. |
| 500 | InternalError | The request processing has failed due to some unknown error. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.