All Products
Search

This Product

    Cloud Enterprise Network:DescribePublishedRouteEntries

    Document Center

    Cloud Enterprise Network:DescribePublishedRouteEntries

    Last Updated:Jun 10, 2026

    Mengkueri entri rute virtual private cloud (VPC) dan virtual border router (VBR) diiklankan ke instans Cloud Enterprise Network (CEN) tempat VPC dan VBR dilampirkan, tipe instans lompatan berikutnya setiap rute, serta entri rute yang diiklankan dapat ditarik.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    cen:DescribePublishedRouteEntries

    get

    *CenInstance

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

    *virtualborderrouter

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

    *VPC

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    PageNumber

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    PageSize

    integer

    No

    Jumlah entri per halaman. Nilai default: 10. Nilai valid: 1 hingga 500.

    10
    CenId

    string

    Yes

    ID instans CEN.

    cen-7qthudw0ll6jm****
    ChildInstanceId

    string

    Yes

    ID instans jaringan.

    vpc-bp18sth14qii3pnv****
    ChildInstanceType

    string

    Yes

    Tipe instans jaringan. Nilai valid:

    • VPC: virtual private cloud.

    • VBR: virtual border router.

    • CCN: Cloud Connect Network.

    VPC
    ChildInstanceRegionId

    string

    Yes

    ID wilayah tempat instans jaringan diterapkan.

    Untuk informasi selengkapnya, lihat .

    cn-hangzhou
    ChildInstanceRouteTableId

    string

    No

    ID tabel rute instans jaringan.

    vtb-bp174d1gje79u1g4****
    DestinationCidrBlock

    string

    No

    Blok CIDR tujuan entri rute yang ingin Anda kueri.

    172.16.0.0/16

    Elemen respons

    Element

    Type

    Description

    Example

    object

    PageSize

    integer

    The number of entries per page.

    10
    RequestId

    string

    The request ID.

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

    integer

    The page number.

    1
    TotalCount

    integer

    The total number of entries returned.

    2
    PublishedRouteEntries

    object

    PublishedRouteEntry

    array<object>

    A list of route entries.

    array<object>

    NextHopId

    string

    The ID of the instance associated with the next hop.

    ecs-bp18sth14qii3pn****
    PublishStatus

    string

    The publish status of the route in the CEN instance:

    • Published: The route is published.

    • NonPublished: The route is not published.

    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 published to or withdrawn from the CEN instance.

    • true: The route can be published or withdrawn.

    • false: The route cannot be published 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

    Contoh

    Respons sukses

    JSONformat

    {
  "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"
            }
          ]
        }
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    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.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.