Todos os produtos
Search
Central de documentação

Virtual Private Cloud:AssociateNetworkAcl

Última atualização: Jul 07, 2026

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

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

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.