Todos os produtos
Search

Este produto

    Cloud Firewall:DescribeVpcFirewallControlPolicy

    Central de documentação

    Cloud Firewall:DescribeVpcFirewallControlPolicy

    Última atualização: Jul 24, 2026

    Consulta todas as informações de políticas de controle de acesso para um firewall de nuvem privada virtual (VPC) especificado.

    Descrição da operação

    Esta operação é usada para consultar políticas de controle de acesso de firewalls de nuvem privada virtual (VPC). Os firewalls de nuvem privada virtual (VPC) usam diferentes políticas de controle de acesso ao proteger o tráfego entre duas VPCs conectadas por meio da Cloud Enterprise Network (CEN) ou o tráfego entre duas VPCs conectadas por meio do Express Connect.

    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

    yundun-cloudfirewall:DescribeVpcFirewallControlPolicy

    get

    *VpcFirewallControlPolicy.

    acs:cloudfirewall::{#accountId}:vpcfirewallcontrolpolicy/{#AclUuid}

    *VpcFirewall.

    acs:cloudfirewall::{#accountId}:vpcfirewall/{#VpcFirewallId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Lang

    string

    Não

    O tipo de idioma para solicitações e respostas.

    zh
    VpcFirewallId

    string

    Sim

    O ID da instância do firewall de nuvem privada virtual (VPC). Valores válidos:

    vfw-a42bbb7b887148c9****
    CurrentPage

    string

    Não

    O número da página em uma consulta paginada. Define o número da página atual para paginação.

    1
    PageSize

    string

    Não

    O número de políticas de controle de acesso do firewall de nuvem privada virtual (VPC) em cada página em uma consulta paginada. Define o número de políticas por página para paginação.

    10
    Source

    string

    Não

    O endereço de origem na política de controle de acesso do firewall de nuvem privada virtual (VPC). Consultas aproximadas são suportadas.

    192.0.XX.XX/24
    Destination

    string

    Não

    O endereço de destino na política de controle de acesso do firewall de nuvem privada virtual (VPC). Consultas aproximadas são suportadas.

    192.0.XX.XX/24
    Description

    string

    Não

    A descrição da política de controle de acesso do firewall de nuvem privada virtual (VPC). Consultas aproximadas são suportadas.

    test.
    Proto

    string

    Não

    O tipo de protocolo do tráfego na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    TCP.
    AclAction

    string

    Não

    A ação (configurações) que o Cloud Firewall executa no tráfego da política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    accept.
    MemberUid

    string

    Não

    O UID de uma conta membro da conta atual do Alibaba Cloud.

    258039427902****
    AclUuid

    string

    Não

    O ID de identidade exclusivo da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    4037fbf7-3e39-4634-92a4-d0155247****
    Release

    string

    Não

    O status de ativação da política de controle de acesso. Valores válidos:

    true.
    RepeatType

    string

    Não

    O tipo de recorrência do período de validade da política de controle de acesso. Valores válidos:

    Valores válidos:

    • Daily :

      todos os dias.

    • Monthly :

      todos os meses.

    • Permanent :

      sempre.

    • Weekly :

      todas as semanas.

    • None :

      um período único especificado.

    Permanent.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    TotalCount

    string

    O número total de políticas de controle de acesso do firewall de nuvem privada virtual (VPC).

    20
    RequestId

    string

    O ID da solicitação.

    CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D.
    Policys

    array<object>

    As informações sobre as políticas de controle de acesso do firewall de nuvem privada virtual (VPC).

    object

    Destination

    string

    O endereço de destino na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    192.0.XX.XX/24
    Order

    integer

    A prioridade da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    1
    DestPortGroup

    string

    O nome do catálogo de endereços de porta de destino para o tráfego na política de controle de acesso do firewall de nuvem privada virtual (VPC).

    my_port_group.
    SourceType

    string

    O tipo de endereço de origem na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    net.
    ApplicationName

    string

    O tipo de aplicativo suportado pela política de controle de acesso do firewall de nuvem privada virtual (VPC). Use ApplicationNameList em vez disso. Valores válidos:

    HTTP.
    AclUuid

    string

    O ID de identidade exclusivo da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    4037fbf7-3e39-4634-92a4-d0155247****
    DestPortType

    string

    O tipo de porta de destino para o tráfego na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    port.
    Source

    string

    O endereço de origem na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    192.0.XX.XX/24
    DestinationType

    string

    O tipo de endereço de destino na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    net.
    HitTimes

    integer

    O número de acertos da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    100
    DestPort

    string

    A porta de destino do tráfego na política de controle de acesso do firewall de nuvem privada virtual (VPC).

    80
    Description

    string

    A descrição da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    test.
    AclAction

    string

    A ação (configurações) que o Cloud Firewall executa no tráfego da política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    accept.
    ApplicationId

    string

    O ID do aplicativo com configurações de tráfego na política de controle de acesso do firewall de nuvem privada virtual (VPC).

    10**
    Proto

    string

    O tipo de protocolo do tráfego na política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    TCP.
    DestinationGroupCidrs

    array

    As informações de bloco CIDR no catálogo de endereços de destino da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    string

    A lista de blocos CIDR no catálogo de endereços de destino da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    ["192.0.XX.XX/24", "192.0.XX.XX/32"]
    DestPortGroupPorts

    array

    Os detalhes do catálogo de endereços de porta de destino na política de controle de acesso do firewall de nuvem privada virtual (VPC).

    string

    A lista de portas no catálogo de endereços de porta de destino da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    [80,443]
    SourceGroupCidrs

    array

    Os detalhes do catálogo de endereços de origem na política de controle de acesso do firewall de nuvem privada virtual (VPC).

    string

    A lista de blocos CIDR no catálogo de endereços de origem da política de controle de acesso do firewall de nuvem privada virtual (VPC).

    ["192.0.XX.XX/24", "198.51.XX.XX/32"]
    MemberUid

    string

    O UID de uma conta membro da conta atual do Alibaba Cloud.

    258039427902****
    Release

    string

    O status de ativação da política de controle de acesso. A política é ativada por padrão após a criação. Valores válidos:

    true.
    SourceGroupType

    string

    O tipo do catálogo de endereços de origem na política de controle de acesso. O único valor válido é ip, que indica um catálogo de endereços IP contendo um ou mais blocos CIDR.

    ip
    DestinationGroupType

    string

    O tipo do catálogo de endereços de destino na política de controle de acesso. Valores válidos:

    ip
    HitLastTime

    integer

    A hora mais recente dos acertos. O valor é um timestamp UNIX no formato de segundos.

    1579261141
    ModifyTime

    integer

    A hora em que a política foi modificada. O valor é um timestamp UNIX em segundos.

    1761062400
    SpreadCnt

    integer

    O número de especificações de política de controle de acesso consumidas, que é o número cumulativo de especificações consumidas por cada política.

    10000
    CreateTime

    integer

    A hora em que a política foi criada. O valor é um timestamp UNIX em segundos.

    1761062400
    ApplicationNameList

    array

    A lista de nomes de aplicativos.

    string

    A lista de tipos de aplicativos suportados pela política de controle de acesso do firewall de nuvem privada virtual (VPC). Valores válidos:

    [
    RepeatType

    string

    O tipo de recorrência do período de validade da política de controle de acesso. Valores válidos:

    Valores válidos:

    • Daily :

      todos os dias.

    • Monthly :

      todos os meses.

    • Permanent :

      sempre.

    • Weekly :

      todas as semanas.

    • None :

      um período único especificado.

    Permanent.
    RepeatDays

    array

    A coleção de dias de recorrência para o período de validade da política de controle de acesso.

    integer

    O dia de recorrência para o período de validade da política de controle de acesso.

    1
    RepeatStartTime

    string

    A hora de início da recorrência do período de validade da política. O valor está no formato HH:mm usando um relógio de 24 horas, como 08:00.

    08:00
    RepeatEndTime

    string

    A hora de término da recorrência do período de validade da política. O valor está no formato HH:mm usando um relógio de 24 horas, como 23:00.

    23:30
    StartTime

    integer

    A hora de início do período de validade da política de controle de acesso. O valor é um timestamp UNIX em segundos. A hora deve ser na hora cheia ou meia-hora e deve ser pelo menos 30 minutos anterior à hora de término.

    1694761200
    EndTime

    integer

    A hora de término do período de validade da política de controle de acesso. O valor é um timestamp UNIX em segundos. A hora deve ser na hora cheia ou meia-hora e deve ser pelo menos 30 minutos posterior à hora de início.

    1694764800
    DomainResolveType

    string

    O método de resolução de nome de domínio da política de controle de acesso. Valores válidos:

    FQDN.

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "TotalCount": "20",
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D",
  "Policys": [
    {
      "Destination": "192.0.XX.XX/24",
      "Order": 1,
      "DestPortGroup": "my_port_group",
      "SourceType": "net",
      "ApplicationName": "HTTP",
      "AclUuid": "4037fbf7-3e39-4634-92a4-d0155247****",
      "DestPortType": "port",
      "Source": "192.0.XX.XX/24",
      "DestinationType": "net",
      "HitTimes": 100,
      "DestPort": "80",
      "Description": "test",
      "AclAction": "accept",
      "ApplicationId": "10**",
      "Proto": "TCP",
      "DestinationGroupCidrs": [
        "[\"192.0.XX.XX/24\", \"192.0.XX.XX/32\"]"
      ],
      "DestPortGroupPorts": [
        "[80,443]"
      ],
      "SourceGroupCidrs": [
        "[\"192.0.XX.XX/24\", \"198.51.XX.XX/32\"]"
      ],
      "MemberUid": "258039427902****",
      "Release": "true",
      "SourceGroupType": "ip",
      "DestinationGroupType": "ip",
      "HitLastTime": 1579261141,
      "ModifyTime": 1761062400,
      "SpreadCnt": 10000,
      "CreateTime": 1761062400,
      "ApplicationNameList": [
        "[\n    \"HTTPS\", \n    \"SMTPS\", \n    \"SSL\"\n]"
      ],
      "RepeatType": "Permanent",
      "RepeatDays": [
        1
      ],
      "RepeatStartTime": "08:00",
      "RepeatEndTime": "23:30",
      "StartTime": 1694761200,
      "EndTime": 1694764800,
      "DomainResolveType": "FQDN"
    }
  ]
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 ErrorParametersUid The aliUid parameter is invalid.
    400 ErrorParametersPageSizeOrNo Either pageSize or pageNo is invalid.
    400 ErrorDBSelect An error occurred while querying database.
    400 ErrorUUIDNew The UUID is invalid.
    400 ErrorParametersAppId The appId is invalid.
    400 ErrorParameterIpVersion The IP version is invalid.
    400 ErrorParametersDirection The direction is invalid.
    400 ErrorParametersSource The source is invalid.
    400 ErrorDomainResolve A domain resolution error occurred.
    400 ErrorParametersDestination The Destination parameter is invalid.
    400 ErrorParametersProto The protocol is invalid.
    400 ErrorParametersDestPort The dst_port is invalid.
    400 ErrorParametersAction The action is invalid.
    400 ErrorParameters Parameters error.
    400 ErrorMarshalJSON An error occurred while encoding JSON.
    400 ErrorParametersAclUuid Specified parameter AclUuid is not valid.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.