DescribeNetworkAcls - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Consulta uma lista de ACLs de rede chamando a operação DescribeNetworkAcls.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:DescribeNetworkAcls

list

*NetworkAcl

acs:vpc:{#regionId}:{#accountId}:networkacl/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
NetworkAclId	string	Não	O ID da ACL de rede.	nacl-bp1lhl0taikrbgnh****
NetworkAclName	string	Não	O nome da ACL de rede. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	acl-1
VpcId	string	Não	O ID da VPC associada à ACL de rede.	vpc-m5ebpc2xh64mqm27e****
ResourceType	string	Não	O tipo do recurso associado. Valores válidos: VSwitch: vSwitch. Os parâmetros ResourceType e ResourceId devem ser especificados juntos para terem efeito.	VSwitch
ResourceId	string	Não	O ID do recurso associado.	vsw-bp1de348lntdwnhbg****
PageNumber	integer	Não	O número da página da lista. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página em uma consulta paginada. Valor máximo: 50. Valor padrão: 10.	10
RegionId	string	Sim	O ID da região da ACL de rede. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-hangzhou
Tags	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. Uma chave de tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceJoshua
RegionId	string	Sim	O ID da região da ACL de rede. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-hangzhou
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Gere um valor de parâmetro a partir do seu cliente para garantir a exclusividade em diferentes solicitações. O ClientToken suporta apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageSize	string	O número de entradas por página em uma consulta paginada.	10
RequestId	string	O ID da solicitação.	F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1
PageNumber	string	O número da página da lista.	1
TotalCount	string	O número total de ACLs de rede na lista.	2
NetworkAcls	object
NetworkAcl	array<object>	Os detalhes da ACL de rede.
	array<object>	Os detalhes da ACL de rede.
Status	string	The status of the network ACL. Valid values: Available Modifying	Available
VpcId	string	The ID of the associated VPC.	vpc-m5ebpc2xh64mqm27e****
CreationTime	string	The time when the network ACL was created.	2021-12-25 11:44:17
Description	string	The description of the network ACL.	This is my NetworkAcl.
NetworkAclName	string	The name of the network ACL.	acl-1
NetworkAclId	string	The ID of the network ACL.	nacl-a2do9e413e0spxscd****
OwnerId	integer	The ID of the Alibaba Cloud account to which the network ACL belongs.	253460731706911258
RegionId	string	The region ID of the network ACL.	cn-hangzhou
IngressAclEntries	object
IngressAclEntry	array<object>	The configurations of the inbound rules.
	object
NetworkAclEntryId	string	The ID of the inbound rule.	nae-a2dk86arlydmezasw****
EntryType	string	The type of the inbound rule. custom system	custom
NetworkAclEntryName	string	The name of the inbound rule.	acl-3
Policy	string	The action to be performed on network traffic that matches the rule. Valid values: accept drop	accept
Description	string	The description of the inbound rule.	This is IngressAclEntries.
SourceCidrIp	string	The source CIDR block.	10.0.0.0/24
IpVersion	string	The IP version. IPv4 IPv6	IPv4
Protocol	string	The protocol. Valid values: icmp gre tcp udp all	all
Port	string	The destination port range of the inbound traffic. If the protocol of the inbound rule is set to all, icmp, or gre, the port range is -1/-1, which specifies all ports. If the protocol of the inbound rule is set to tcp or udp, set the port range in the following format: 1/200 or 80/80, which specifies port 1 to port 200 or port 80. Valid ports: 1 to 65535.	-1/-1
EgressAclEntries	object
EgressAclEntry	array<object>	The outbound rules.
	object
NetworkAclEntryId	string	The ID of the outbound rule.	nae-a2d447uw4tillfvgb****
EntryType	string	The type of the inbound rule. custom system	custom
NetworkAclEntryName	string	The name of the outbound rule.	acl-2
Policy	string	The action to be performed on network traffic that matches the rule. Valid values: accept drop	accept
Description	string	The description of the outbound rule.	This is EgressAclEntries.
Protocol	string	The protocol. Valid values: icmp gre tcp udp all	all
DestinationCidrIp	string	The destination CIDR block.	10.0.0.0/24
IpVersion	string	The IP version. IPv4 IPv6	IPv4
Port	string	The destination port range of the outbound traffic. If the protocol of the outbound rule is set to all, icmp, or gre, the port range is -1/-1, which specified all ports. If the protocol of the outbound rule is set to tcp or udp, set the port range in the following format: 1/200 or 80/80, which specifies port 1 to port 200 or port 80. Valid values for a port: 1 to 65535.	-1/-1
Resources	object
Resource	array<object>	The resources that are associated with the network ACL.
	object
Status	string	The association status of the resource. Valid values: BINDED BINDING UNBINDING	BINDED
ResourceType	string	The type of resource with which you want to associate the network ACL.	VSwitch
ResourceId	string	The ID of the associated resource.	vsw-bp1de348lntdwcdf****
Tags	object
Tag	array<object>	The information about the tags.
	object
Key	string	The key of tag N added to the resource.	FinanceDept
Value	string	The value of tag N added to the resource.	FinanceJoshua

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": "10",
  "RequestId": "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1",
  "PageNumber": "1",
  "TotalCount": "2",
  "NetworkAcls": {
    "NetworkAcl": [
      {
        "Status": "Available",
        "VpcId": "vpc-m5ebpc2xh64mqm27e****",
        "CreationTime": "2021-12-25 11:44:17",
        "Description": "This is my NetworkAcl.",
        "NetworkAclName": "acl-1",
        "NetworkAclId": "nacl-a2do9e413e0spxscd****",
        "OwnerId": 253460731706911260,
        "RegionId": "cn-hangzhou",
        "IngressAclEntries": {
          "IngressAclEntry": [
            {
              "NetworkAclEntryId": "nae-a2dk86arlydmezasw****",
              "EntryType": "custom",
              "NetworkAclEntryName": "acl-3\t",
              "Policy": "accept",
              "Description": "This is IngressAclEntries.",
              "SourceCidrIp": "10.0.0.0/24\t",
              "IpVersion": "IPv4",
              "Protocol": "all",
              "Port": "-1/-1\t"
            }
          ]
        },
        "EgressAclEntries": {
          "EgressAclEntry": [
            {
              "NetworkAclEntryId": "nae-a2d447uw4tillfvgb****",
              "EntryType": "custom",
              "NetworkAclEntryName": "acl-2\t",
              "Policy": "accept",
              "Description": "This is EgressAclEntries.",
              "Protocol": "all",
              "DestinationCidrIp": "10.0.0.0/24\t",
              "IpVersion": "IPv4",
              "Port": "-1/-1\t"
            }
          ]
        },
        "Resources": {
          "Resource": [
            {
              "Status": "BINDED",
              "ResourceType": "VSwitch",
              "ResourceId": "vsw-bp1de348lntdwcdf****"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	ParameterMissing.AliUid	ParameterMissing.AliUid
400	ParameterMissing.Bid	ParameterMissing.Bid
400	ParameterMissing.RegionId	ParameterMissing.RegionId
400	ParameterEmpty.RegionId	ParameterEmpty.RegionId
400	NotSupport.NetworkAcl	Network acl is not support now.
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.