Todos os produtos
Search

Este produto

    Cloud Enterprise Network:DescribePublishedRouteEntries

    Central de documentação

    Cloud Enterprise Network:DescribePublishedRouteEntries

    Última atualização: Jun 28, 2026

    Consulta se as rotas de nuvens privadas virtuais (VPCs) e roteadores de borda virtuais (VBRs) são anunciadas para a instância da Cloud Enterprise Network (CEN) à qual as VPCs e os VBRs estão anexados, o tipo de instância do próximo salto de cada rota e se as rotas anunciadas podem ser retiradas.

    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

    cen:DescribePublishedRouteEntries

    get

    *CenInstance

    acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

    *virtualborderrouter

    acs:vpc:*:{#accountId}:virtualborderrouter/{#virtualborderrouterId}

    *VPC

    acs:vpc:*:{#accountId}:vpc/{#vpcId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    PageNumber

    integer

    Não

    O número da página. Valor padrão: 1.

    1
    PageSize

    integer

    Não

    O número de entradas por página. Valor padrão: 10. Valores válidos: 1 a 500.

    10
    CenId

    string

    Sim

    O ID da instância CEN.

    cen-7qthudw0ll6jm****
    ChildInstanceId

    string

    Sim

    O ID da instância de rede.

    vpc-bp18sth14qii3pnv****
    ChildInstanceType

    string

    Sim

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

    • VPC: nuvem privada virtual.

    • VBR: roteador de borda virtual.

    • CCN: Cloud Connect Network.

    VPC
    ChildInstanceRegionId

    string

    Sim

    O ID da região onde a instância de rede está implantada.

    Para mais informações, consulte .

    cn-hangzhou
    ChildInstanceRouteTableId

    string

    Não

    O ID da tabela de rotas da instância de rede.

    vtb-bp174d1gje79u1g4****
    DestinationCidrBlock

    string

    Não

    O bloco CIDR de destino da rota que você deseja consultar.

    172.16.0.0/16

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    PageSize

    integer

    O número de entradas por página.

    10
    RequestId

    string

    O ID da solicitação.

    FF1A7B2A-677F-4F71-96EA-6002B329F437
    PageNumber

    integer

    O número da página.

    1
    TotalCount

    integer

    O número total de entradas retornadas.

    2
    PublishedRouteEntries

    object

    PublishedRouteEntry

    array<object>

    Uma lista de entradas de rota.

    array<object>

    NextHopId

    string

    The ID of the instance associated with the next hop.

    ecs-bp18sth14qii3pn****
    PublishStatus

    string

    The advertise status of the route in the CEN instance:

    • Published: The route is advertised.

    • NonPublished: The route is not advertised.

    Published
    ChildInstanceRouteTableId

    string

    The ID of the route table of the network instance.

    vtb-il7qut3mjgtlcbpk2****
    NextHopType

    string

    The type of the instance associated with the next hop.

    • Instance: an ECS instance.

    • HaVip: a high-availability virtual IP address (HaVip).

    • RouterInterface: a router interface.

    • NetworkInterface: an elastic network interface (ENI).

    • VpnGateway: a VPN gateway.

    • IPv6Gateway: an IPv6 gateway.

    • Ipv4Gateway: an IPv4 gateway.

    • NatGateway: a NAT gateway.

    • Attachment: a network instance connection.

    • service: an Alibaba Cloud service.

    • VBR: a virtual border router.

    • CCN: a Cloud Connect Network instance.

    • VPC: a virtual private cloud.

    • local: The route is a system route of the network instance and has no next hop.

    • TR: a transit router.

    • BlackHole: The route is a blackhole route and has no next hop.

    • EcRouterInterface: an Express Connect router interface.

    • HealthCheck: a health check.

    • AS: an access gateway in a CCN instance.

    • classicLink: a classic network instance.

    • GatewayEndpoint: a gateway endpoint.

    • CPE: a data center connected to a VBR.

    Instance
    OperationalMode

    boolean

    Indicates whether the route can be advertised to or withdrawn from the CEN instance.

    • true: The route can be advertised or withdrawn.

    • false: The route cannot be advertised or withdrawn.

    true
    DestinationCidrBlock

    string

    The destination CIDR block of the route.

    172.16.0.0/16
    RouteType

    string

    The type of the route.

    • CEN: a route learned from the CEN instance.

    • System: a system route.

    • Custom: a custom route.

    System
    Conflicts

    object

    Conflict

    array<object>

    A list of conflicting routes.

    object

    Status

    string

    The cause of the route conflict.

    • conflict: The route conflicts with another route that has the same destination CIDR block.

    • overflow: The number of routes in the route table of another network instance has reached its limit.

    conflict
    DestinationCidrBlock

    string

    The destination CIDR block of the conflicting route.

    192.168.20.0/24
    InstanceId

    string

    The ID of the peer network instance with which the route conflicts.

    ccn-0q3b7oviikmm9h****
    InstanceType

    string

    The type of the peer network instance with which the route conflicts.

    • VPC: a virtual private cloud.

    • VBR: a virtual border router.

    • CCN: a Cloud Connect Network instance.

    CCN
    RegionId

    string

    The ID of the region where the peer network instance with which the route conflicts is deployed.

    ccn-cn-shanghai

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "PageSize": 10,
  "RequestId": "FF1A7B2A-677F-4F71-96EA-6002B329F437",
  "PageNumber": 1,
  "TotalCount": 2,
  "PublishedRouteEntries": {
    "PublishedRouteEntry": [
      {
        "NextHopId": " ecs-bp18sth14qii3pn****",
        "PublishStatus": "Published",
        "ChildInstanceRouteTableId": "vtb-il7qut3mjgtlcbpk2****",
        "NextHopType": "Instance",
        "OperationalMode": true,
        "DestinationCidrBlock": "172.16.0.0/16",
        "RouteType": "System",
        "Conflicts": {
          "Conflict": [
            {
              "Status": "conflict",
              "DestinationCidrBlock": "192.168.20.0/24",
              "InstanceId": "ccn-0q3b7oviikmm9h****",
              "InstanceType": "CCN",
              "RegionId": "ccn-cn-shanghai"
            }
          ]
        }
      }
    ]
  }
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 ParameterIllegal.CenInstanceId The parameter of CEN instance id is illegal.
    400 ParameterIllegal.ChildInstanceRegionId The parameter of child instance region id is illegal.
    400 VRC_ERROR VRC error
    400 ParameterIllegal.ChildInstanceType The parameter of child instance type is illegal.
    400 ParameterIllegal The parameter is illegal. The error message returned because a parameter is set to an invalid value.
    400 InvalidParameter Invalid parameter. The error message returned because the parameter is set to an invalid value.
    400 Unauthorized The AccessKeyId is unauthorized. The error message returned because you do not have the permissions to perform this operation.
    500 InternalError Internal error.
    404 Instance.NotExist The instance is not exist. The error message returned because the specified instance does not exist.
    409 InvalidOperation.ChildInstanceStatus The child-instance is not in a valid state for the operation.
    409 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation. The error message returned because the status of the CEN instance does not support this operation.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.