Todos os produtos
Search
Central de documentação

:DescribeCenRouteMaps

Última atualização: Jul 03, 2026

Consulta as políticas de roteamento de uma instância do Cloud Enterprise Network (CEN).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim DescribeCenRouteMaps

Operação a ser executada. Defina o valor como DescribeCenRouteMaps.

PageNumber Integer Não 1

Número da página a retornar. Valor padrão: 1.

PageSize Integer Não 10

Quantidade de entradas a retornar por página. Valor padrão: 10.

CenId String Sim cen-wx12mmlt17ld82****

ID da instância CEN.

RouteMapId String Não cenrmap-y40mxdvf7joc12****

ID da política de roteamento.

CenRegionId String Não cn-hangzhou

ID da região onde a política de roteamento é aplicada.

Chame a operação DescribeChildInstanceRegions para consultar a lista mais recente de regiões.

TransmitDirection String Não RegionOut

Direção de aplicação da política de roteamento. Valores válidos:

  • RegionIn: anuncia rotas para os gateways nas regiões conectadas pela instância CEN.

    Por exemplo, rotas de instâncias de rede na região atual ou em outras regiões são anunciadas para o gateway na região atual.

  • RegionOut: anuncia rotas a partir dos gateways nas regiões conectadas pela instância CEN.

    Por exemplo, rotas do gateway na região atual são anunciadas para instâncias de rede na mesma região ou para gateways em outras regiões.

TransitRouterRouteTableId String Não vtb-gw8nx3515m1mbd1z1****

ID da tabela de rotas do transit router associado à política de roteamento.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
PageSize Integer 10

Quantidade de entradas retornadas por página.

RequestId String 24CE1987-D1D1-5324-9BAD-2750B60E6ABB

ID da solicitação.

PageNumber Integer 1

Número da página retornada.

TotalCount Integer 1

Quantidade total de entradas retornadas.

RouteMaps Array of RouteMap

Informações sobre a política de roteamento.

RouteMap
RouteMapId String cenrmap-y40mxdvf7joc12****

ID da política de roteamento.

Status String Active

Status da política de roteamento. Valores válidos:

  • Creating: criação da política em andamento.
  • Active: política disponível.
  • Deleting: exclusão da política em andamento.
TransmitDirection String RegionOut

Direção de aplicação da política de roteamento.

SourceInstanceIdsReverseMatch Boolean false

Indica se os IDs das instâncias de rede de origem são excluídos da correspondência.

  • false (padrão): há correspondência se o ID da instância de rede de origem estiver na lista especificada por SourceInstanceIds.N.
  • true: há correspondência se o ID da instância de rede de origem não estiver na lista especificada por SourceInstanceIds.N.
CenRegionId String cn-hangzhou

ID da região onde a política de roteamento é aplicada.

CenId String cen-wx12mmlt17ld82****

ID da instância CEN.

Priority Integer 5000

Prioridade da política de roteamento. Quanto menor o valor, maior a prioridade.

TransitRouterRouteTableId String vtb-gw8nx3515m1mbd1z1****

ID da tabela de rotas do transit router associado à política de roteamento.

CommunityOperateMode String Additive

Ação executada na comunidade da rota.

  • Additive: adiciona a comunidade à rota.
  • Replace: substitui a comunidade original da rota.

Este parâmetro define a ação realizada quando uma rota atende à condição de correspondência.

MapResult String Deny

Ação executada em uma rota que atende às condições de correspondência.

  • Permit: permite a rota.
  • Deny: nega a rota.
CommunityMatchMode String Include

Método de correspondência de rotas com base na comunidade.

  • Include: correspondência aproximada. Há correspondência se a comunidade da rota se sobrepor à comunidade especificada na condição.
  • Complete: correspondência exata. Há correspondência apenas se a comunidade da rota for idêntica à comunidade especificada na condição.
Description String desctest

Descrição da política de roteamento.

AsPathMatchMode String Include

Método de correspondência de rotas com base no caminho AS.

  • Include: correspondência aproximada. Há correspondência se o caminho AS da rota se sobrepor ao caminho AS especificado na condição.
  • Complete: correspondência exata. Há correspondência apenas se o caminho AS da rota for idêntico ao caminho AS especificado na condição.
Preference Integer 20

Nova prioridade da rota.

Quanto menor o valor, maior a prioridade.

Este parâmetro define a ação realizada quando uma rota atende à condição de correspondência.

DestinationInstanceIdsReverseMatch Boolean false

Indica se os IDs das instâncias de rede de destino são excluídos da correspondência.

  • false (padrão): há correspondência se o ID da instância de rede de destino estiver na lista especificada por DestinationInstanceIds.N.
  • true: há correspondência se o ID da instância de rede de destino não estiver na lista especificada por DestinationInstanceIds.N.
CidrMatchMode String Include

Método de correspondência de rotas com base no prefixo. Valores válidos:

  • Include: correspondência aproximada. Há correspondência se o prefixo da rota estiver incluído nas condições de correspondência.

    Por exemplo, se a condição de correspondência for 10.10.0.0/16 e a correspondência aproximada estiver ativada, a rota com prefixo 10.10.1.0/24 será considerada correspondente.

  • Complete: correspondência exata. Há correspondência apenas se o prefixo da rota for idêntico ao prefixo especificado na condição.

    Por exemplo, se a condição de correspondência for 10.10.0.0/16 e a correspondência exata estiver ativada, haverá correspondência apenas se o prefixo for 10.10.0.0/16.

NextPriority Integer 33

Prioridade da política de roteamento a ser associada à política atual.

MatchAddressType String IPv4

Tipo de endereço IP a ser comparado com a condição de correspondência. Valores válidos:

  • IPv4: endereços IPv4
  • IPv6: endereços IPv6
  • Se nenhum valor for retornado, tanto endereços IPv4 quanto IPv6 serão comparados com a condição de correspondência.
SourceRegionIds Array of String cn-hangzhou

IDs das regiões de origem às quais as rotas pertencem.

SourceChildInstanceTypes Array of String VPC

Tipos de instância de rede de origem aos quais as rotas pertencem.

  • VPC: virtual private cloud (VPC)
  • VBR: virtual border router (VBR)
  • CCN: instância do Cloud Connect Network (CCN)
  • VPN: conexão IPsec-VPN
DestinationRouteTableIds Array of String vtb-adefrgtr144vf****

IDs das tabelas de rotas de destino às quais as rotas pertencem. É possível inserir até 32 IDs de tabela de rotas.

Nota Os IDs das tabelas de rotas de destino são válidos apenas quando a política de roteamento é aplicada a cenários em que as rotas são anunciadas do gateway na região atual para tabelas de rotas na região atual.
SourceInstanceIds Array of String vpc-adeg3544fdf34vf****

IDs das instâncias de rede de origem às quais as rotas pertencem.

DestinationCidrBlocks Array of String 10.10.10.0/24

Prefixos das rotas.

SourceRouteTableIds Array of String vtb-adfr233vf34rvd4****

IDs das tabelas de rotas de origem às quais as rotas pertencem.

MatchCommunitySet Array of String 65501:1

Conjunto de comunidades usado como base para comparação das rotas.

PrependAsPath Array of String 65501

Caminhos AS prefixados por meio de uma instrução de ação quando os gateways regionais recebem ou anunciam rotas.

Este parâmetro define a ação realizada quando uma rota atende à condição de correspondência.

RouteTypes Array of String System

Tipo de rota comparado. Valores válidos:

  • System: rotas geradas automaticamente pelo sistema.
  • Custom: rotas personalizadas adicionadas manualmente.
  • BGP: rotas anunciadas via Border Gateway Protocol (BGP).
DestinationChildInstanceTypes Array of String VPC

Tipos de instância de rede de destino aos quais as rotas pertencem.

  • VPC: VPC
  • VBR: VBR
  • CCN: instância CCN
  • VPN: conexão IPsec-VPN
Nota Os tipos de instância de rede de destino são válidos apenas quando a política de roteamento é aplicada a cenários em que as rotas são anunciadas do gateway na região atual para instâncias de rede na região atual.
DestinationInstanceIds Array of String vpc-afrfs434465fdf****

IDs das instâncias de rede de destino às quais as rotas pertencem.

Nota Os IDs das instâncias de rede de destino são válidos apenas quando a política de roteamento é aplicada a cenários em que as rotas são anunciadas do gateway na região atual para instâncias de rede na região atual.
MatchAsns Array of String 65501

Caminhos AS usados como base para comparação das rotas.

OperateCommunitySet Array of String 65501:1

Conjunto de comunidades no qual as ações são executadas.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=DescribeCenRouteMaps
&PageNumber=1
&PageSize=10
&CenId=cen-wx12mmlt17ld82****
&RouteMapId=cenrmap-y40mxdvf7joc12****
&CenRegionId=cn-hangzhou
&TransmitDirection=RegionOut
&TransitRouterRouteTableId=vtb-gw8nx3515m1mbd1z1****
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeCenRouteMapsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>24CE1987-D1D1-5324-9BAD-2750B60E6ABB</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <RouteMaps>
        <RouteMap>
            <Status>Active</Status>
            <TransitRouterRouteTableId>vtb-gw8nx3515m1mbd1z1****</TransitRouterRouteTableId>
            <Priority>5000</Priority>
            <SourceChildInstanceTypes>
                <SourceChildInstanceType>VBR</SourceChildInstanceType>
                <SourceChildInstanceType>CCN</SourceChildInstanceType>
            </SourceChildInstanceTypes>
            <CenId>cen-wx12mmlt17ld82****</CenId>
            <TransmitDirection>RegionOut</TransmitDirection>
            <CenRegionId>cn-hangzhou</CenRegionId>
            <RouteMapId>cenrmap-y40mxdvf7joc12****</RouteMapId>
            <MapResult>Deny</MapResult>
            <DestinationChildInstanceTypes>
                <DestinationChildInstanceType>VBR</DestinationChildInstanceType>
                <DestinationChildInstanceType>CCN</DestinationChildInstanceType>
            </DestinationChildInstanceTypes>
        </RouteMap>
    </RouteMaps>
</DescribeCenRouteMapsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "24CE1987-D1D1-5324-9BAD-2750B60E6ABB",
  "PageSize" : 10,
  "PageNumber" : 1,
  "RouteMaps" : {
    "RouteMap" : [ {
      "Status" : "Active",
      "TransitRouterRouteTableId" : "vtb-gw8nx3515m1mbd1z1****",
      "Priority" : 5000,
      "SourceChildInstanceTypes" : {
        "SourceChildInstanceType" : [ "VBR", "CCN" ]
      },
      "CenId" : "cen-wx12mmlt17ld82****",
      "TransmitDirection" : "RegionOut",
      "CenRegionId" : "cn-hangzhou",
      "RouteMapId" : "cenrmap-y40mxdvf7joc12****",
      "MapResult" : "Deny",
      "DestinationChildInstanceTypes" : {
        "DestinationChildInstanceType" : [ "VBR", "CCN" ]
      }
    } ]
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.