Todos os produtos
Search
Central de documentação

Cloud Firewall:DescribeVpcFirewallCenDetail

Última atualização: Sep 17, 2026

Consulta os detalhes de um firewall de VPC que controla o tráfego de acesso mútuo entre uma instância de rede em uma instância do Cloud Enterprise Network (CEN) e uma VPC especificada.

Descrição da operação

Esta operação é usada para consultar os detalhes de um firewall de VPC. O firewall de VPC controla o tráfego de acesso mútuo entre instâncias de rede (incluindo VPCs, roteadores de borda virtuais (VBRs) e instâncias do Cloud Connect Network (CCN)) em uma instância do CEN e uma VPC especificada.

Limite de QPS

O limite de QPS para um único usuário nesta operação é de 10 chamadas por segundo. Se o número de chamadas por segundo exceder o limite, a limitação de taxa será acionada. A limitação de taxa pode afetar seus negócios. Invoque esta operação dentro do limite.

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:DescribeVpcFirewallCenDetail

get

*VpcFirewallCen.

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Lang

string

Não

O idioma da solicitação e da resposta. Valores válidos:

  • zh (padrão): Chinês.

  • en: Inglês.

zh

VpcFirewallId

string

Sim

O ID da instância do firewall de VPC.

Nota

Você pode invocar a operação DescribeVpcFirewallCenList para consultar o ID da instância do firewall de VPC.

vfw-m5e7dbc4y****

NetworkInstanceId

string

Não

O ID da VPC para a qual o firewall de VPC é criado.

vpc-2zefk9fbn8j7v585g****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

ConnectType

string

O tipo de conexão do firewall de VPC. Valores válidos: cen, que indica CEN.

cen

FirewallSwitchStatus

string

O status do firewall de VPC. Valores válidos:

  • opened: ativado.

  • closed: desativado.

  • notconfigured: não configurado.

opened

FirewallVpc

object

A VPC usada pelo firewall.

AllowConfiguration

integer

Indica se o bloco CIDR da VPC do firewall pode ser configurado ao criar um firewall de VPC para a Edição Básica do CEN. Valores válidos:

  • 1: Permitido.

  • 0: Não permitido.

0

FirewallServiceMode

string

O modo de implantação do serviço de firewall de VPC. Valores válidos: PrimaryStandby (modo primário/standby) e MultiPrimary (modo ativo-ativo).

PrimaryStandby

FirewallServiceZones

array

A lista de IDs de zona usados pelo serviço de firewall de VPC.

string

O ID da zona usado pelo serviço de firewall de VPC.

cn-hangzhou-i

StandbyZoneId deprecated

string

O ID da zona secundária do firewall.

cn-hangzhou-k

VpcCidr

string

O bloco CIDR da VPC.

10.0.0.0/8

VpcId

string

O ID da instância da VPC.

vpc-bp1245k5oagy2bp74****

VswitchCidr

string

O bloco CIDR do vSwitch.

10.0.0.1/24

VswitchId

string

O ID do vSwitch.

vsw-bp1sqg9wms9wxcs1****

VswitchZoneId

string

O ID da zona do vSwitch.

cn-hangzhou-i

ZoneId deprecated

string

O ID da zona primária do firewall.

cn-hangzhou-i

LocalVpc

object

Os detalhes da VPC.

AttachmentId

string

O ID de conexão da instância de rede.

tr-attach-sxig7bye51fid5****

AttachmentName

string

O nome da conexão da instância de rede.

local-test

DefendCidrList

array

A lista de blocos CIDR protegidos pelo firewall de VPC.

string

O bloco CIDR protegido pelo firewall de VPC.

10.0.XX.XX/24

EniList

array<object>

A lista de interfaces de rede elásticas (ENIs).

object

EniId

string

O ID da instância da interface de rede elástica (ENI) na VPC.

eni-8vbhfosfqv2rff42****

EniPrivateIpAddress

string

O endereço IP privado da interface de rede elástica (ENI) na VPC.

192.168.XX.XX

EniVSwitchId

string

O ID do vSwitch da interface de rede elástica (ENI) na VPC.

vsw-wz9viido7j436b0n1****

EniZoneId

string

O ID da zona da interface de rede elástica (ENI).

cn-hangzhou-i

ManualVSwitchId

string

O ID do vSwitch especificado quando o modo de roteamento é definido como manual.

vsw-zeq4o875u****

NetworkInstanceId

string

O ID da VPC para a qual o firewall de VPC é criado.

vpc-2zefk9fbn8j7v585g****

NetworkInstanceName

string

O nome da instância de rede.

test-vpc

NetworkInstanceType

string

O tipo da instância de rede. Valores válidos: VPC.

VPC

OwnerId

string

O UID da conta Alibaba Cloud à qual a VPC pertence.

158039427902****

RegionNo

string

O ID da região da VPC.

cn-hangzhou

RouteMode

string

O modo de roteamento. Valores válidos:

  • auto: modo automático.

  • manual: modo manual.

auto

SupportManualMode

string

Indica se o modo de roteamento manual é suportado. Valores válidos:

  • 1: Suportado.

  • 0: Não suportado.

0

TransitRouterId

string

O ID da instância do roteador de trânsito do CEN (CEN-TR).

tr-2zetwxskej633l3u1****

TransitRouterType

string

A edição do roteador de trânsito do CEN (CEN-TR). Valores válidos:

  • Basic: Edição Básica.

  • Enterprise: Edição Empresarial.

Basic

VpcCidrTableList

array<object>

A lista de blocos CIDR da VPC.

array<object>

RouteEntryList

array<object>

A lista de entradas de rota da VPC.

object

DestinationCidr

string

O bloco CIDR de destino da VPC.

192.168.XX.XX/24

NextHopInstanceId

string

O ID da instância do próximo salto na VPC.

vrt-m5eb5me6c3l5sezae****

RouteTableId

string

O ID da tabela de rotas da VPC.

vtb-1234

VpcId

string

O ID da instância da VPC.

vpc-8vbwbo90rq0anm6t****

VpcName

string

O nome da instância da VPC.

vpc-firewall-test

RequestId

string

O ID da solicitação.

850A84D6-0DE4-4797-A1E8-00090125g4d2

VpcFirewallId

string

O ID da instância do firewall de VPC.

vfw-m5e7dbc4y****

VpcFirewallName

string

O nome da instância do firewall de VPC.

vpc-firewall-test

Exemplos

Resposta de sucesso

JSON formato

{
  "ConnectType": "cen",
  "FirewallSwitchStatus": "opened",
  "FirewallVpc": {
    "AllowConfiguration": 0,
    "FirewallServiceMode": "PrimaryStandby",
    "FirewallServiceZones": [
      "cn-hangzhou-i"
    ],
    "StandbyZoneId": "cn-hangzhou-k",
    "VpcCidr": "10.0.0.0/8",
    "VpcId": "vpc-bp1245k5oagy2bp74****",
    "VswitchCidr": "10.0.0.1/24",
    "VswitchId": "vsw-bp1sqg9wms9wxcs1****",
    "VswitchZoneId": "cn-hangzhou-i",
    "ZoneId": "cn-hangzhou-i"
  },
  "LocalVpc": {
    "AttachmentId": "tr-attach-sxig7bye51fid5****",
    "AttachmentName": "local-test",
    "DefendCidrList": [
      "10.0.XX.XX/24"
    ],
    "EniList": [
      {
        "EniId": "eni-8vbhfosfqv2rff42****",
        "EniPrivateIpAddress": "192.168.XX.XX",
        "EniVSwitchId": "vsw-wz9viido7j436b0n1****",
        "EniZoneId": "cn-hangzhou-i"
      }
    ],
    "ManualVSwitchId": "vsw-zeq4o875u****",
    "NetworkInstanceId": "vpc-2zefk9fbn8j7v585g****",
    "NetworkInstanceName": "test-vpc",
    "NetworkInstanceType": "VPC",
    "OwnerId": "158039427902****",
    "RegionNo": "cn-hangzhou",
    "RouteMode": "auto",
    "SupportManualMode": "0",
    "TransitRouterId": "tr-2zetwxskej633l3u1****",
    "TransitRouterType": "Basic",
    "VpcCidrTableList": [
      {
        "RouteEntryList": [
          {
            "DestinationCidr": "192.168.XX.XX/24",
            "NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****"
          }
        ],
        "RouteTableId": "vtb-1234"
      }
    ],
    "VpcId": "vpc-8vbwbo90rq0anm6t****",
    "VpcName": "vpc-firewall-test"
  },
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125g4d2",
  "VpcFirewallId": "vfw-m5e7dbc4y****",
  "VpcFirewallName": "vpc-firewall-test"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ErrorAliUid The aliuid is invalid. O ID do usuário é inválido.
400 ErrorDBSelectError A database select error occurred. Ocorreu um erro interno durante a operação de consulta ao banco de dados.
400 ErrorVpcFirewallId The VPC firewall ID is invalid. O ID do firewall da VPC é inválido.
400 ErrorVpcFirewallExist The firewall has been configured and cannot be created repeatedly. O firewall já foi configurado e não pode ser criado repetidamente.
400 ErrorUnmarshalJSON An error occurred while parsing JSON. Erro interno: erro de decodificação JSON.
400 ErrorDBTxError A database transaction error occurred. Ocorreu um erro interno durante a transação do banco de dados.
400 ErrorVpcOpenApi vpc open api failed A chamada para a API da VPC falhou.
400 ErrorInvalidMemberUid Member uid is invalid A falha das contas de membro é inválida.
400 ErrorVpcIdPara vpc id and firewall id parameter not exist. O parâmetro VPC do firewall é inválido. Selecione uma VPC válida.
400 ErrorFirewallNotFound Firewall not found O firewall não existe.
400 ErrorDBNoRow No rows in database. Nenhum dado foi encontrado.
400 ErrorUserNotFound User not found O usuário não existe.
400 ErrorVpcFirewallTypeMismatch The specified VPC firewall is not of CEN type. Use the corresponding Describe API for the actual firewall type.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.