All Products
Search

This Product

    Virtual Private Cloud:ListRouteTargetGroups

    Document Center

    Virtual Private Cloud:ListRouteTargetGroups

    Last Updated:Oct 19, 2026

    Menampilkan daftar kelompok target entri rute.

    Deskripsi operasi

    Mengkueri daftar kelompok target entri rute.

    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

    vpc:ListRouteTargetGroups

    list

    *RouteTargetGroup

    acs:vpc:{#regionId}:{#accountId}:routetargetgroup/*

    		 None None

    Sintaks permintaan

    GET  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    VpcId

    string

    No

    ID VPC tempat kelompok target entri rute berada.

    vpc-xxxx
    RouteTargetGroupIds

    array

    No

    Daftar ID instans kelompok target entri rute. Anda dapat menentukan hingga 50 ID instans dalam satu kueri.

    string

    No

    ID instans kelompok target entri rute.

    rtg-xxxx
    MemberId

    string

    No

    ID instans anggota dalam kelompok target entri rute. Parameter ini digunakan untuk memfilter kelompok target entri rute yang berisi ID instans anggota yang ditentukan.

    ep-xxxx
    MaxResults

    integer

    No

    Jumlah entri yang dikembalikan pada setiap halaman. Nilai valid: 1 hingga 50. Nilai default: 50.

    50
    NextToken

    string

    No

    Token yang digunakan untuk mengambil halaman hasil berikutnya. Kosongkan parameter ini untuk kueri pertama atau ketika tidak diperlukan kueri berikutnya. Untuk kueri berikutnya, atur parameter ini ke nilai NextToken yang dikembalikan dalam pemanggilan API sebelumnya.

    FFmyTO70tTpLG6I3FmYAXGKPd****
    RegionId

    string

    Yes

    ID wilayah VPC tempat kelompok target entri rute berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    ResourceGroupId

    string

    No

    ID kelompok sumber daya. Untuk informasi selengkapnya tentang kelompok sumber daya, lihat Apa itu kelompok sumber daya?

    rg-acfmxazdjdhd****
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII. Catatan: Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dari setiap permintaan API bersifat unik.

    123e4567-e89b-12d3-a456-426655440000
    Tag

    array<object>

    No

    Daftar tag.

    object

    No

    Tag sumber daya.

    Key

    string

    No

    Kunci tag sumber daya. Anda dapat menentukan hingga 20 kunci tag. Jika Anda menentukan parameter ini, Anda tidak dapat memasukkan string kosong. Panjang kunci tag dapat mencapai 128 karakter. Kunci tag tidak dapat dimulai dengan aliyun atau acs:, dan tidak dapat mengandung http:// atau https://.

    FinanceJoshua
    Value

    string

    No

    Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Jika Anda menentukan parameter ini, Anda dapat memasukkan string kosong. Panjang nilai tag dapat mencapai 128 karakter. Nilai tag tidak dapat dimulai dengan aliyun atau acs:, dan tidak dapat mengandung http:// atau https://.

    FinanceJoshua

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
    NextToken

    string

    Token yang digunakan untuk mengambil halaman hasil berikutnya. Jika NextToken kosong, tidak diperlukan kueri berikutnya. Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.

    FFmyTO70tTpLG6I3FmYAXGKPd****
    TotalCount

    integer

    Jumlah total entri.

    1
    RouteTargetGroups

    array<object>

    Daftar kelompok target entri rute.

    array<object>

    Status

    string

    Status kelompok target entri rute. Nilai valid:

    • Recovering: Beralih kembali ke instans utama.

    • Switched: Alih bencana utama/sekunder selesai.

    • Available: Aktif.

    • Abnormal: Kegagalan instans sekunder.

    • Pending: Sedang dibuat.

    • Switching: Melakukan alih bencana utama/sekunder.

    • Deleting: Sedang dihapus.

    • Unavailable: Kedua instans utama dan sekunder mengalami kegagalan instans.

    Valid values:

    • Recovering :

      Beralih kembali ke instans utama.

    • Switched :

      Alih bencana utama/sekunder selesai.

    • Available :

      Tersedia.

    • Abnormal :

      Kegagalan instans sekunder.

    • Deleting :

      Menghapus.

    • Pending :

      Membuat.

    • Switching :

      Melakukan alih bencana utama/sekunder.

    • Unavailable :

      Kedua instans utama dan sekunder tidak normal.

    Available
    RouteTargetGroupDescription

    string

    Deskripsi kelompok target entri rute.

    myRouteTargetGroupDescription
    RouteTargetMemberList

    array<object>

    Daftar anggota dalam kelompok target entri rute.

    object

    Daftar anggota dalam kelompok target entri rute.

    MemberId

    string

    ID instans anggota kelompok target entri rute.

    ep-xxxx
    EnableStatus

    string

    Status pengaktifan anggota dalam kelompok target entri rute. Nilai valid:

    • Enable: Diaktifkan.

    • Disable: Dinonaktifkan.

    Hanya anggota dalam status Dinonaktifkan yang dapat diubah ke instans lain. Anggota dalam status Diaktifkan tidak dapat dimodifikasi.

    Valid values:

    • Enable :

      Enable.

    • Disable :

      Disable.

    Enable
    MemberType

    string

    Tipe anggota kelompok target entri rute.

    Tipe yang saat ini didukung:

    • GatewayLoadBalancerEndpoint

    Valid values:

    • GatewayLoadBalancerEndpoint :

      Endpoint Gateway Load Balancer.

    GatewayLoadBalancerEndpoint
    HealthCheckStatus

    string

    Status pemeriksaan kesehatan anggota dalam kelompok target entri rute. Nilai valid:

    • Normal: Normal.

    • Abnormal: Tidak normal.

    Valid values:

    • Normal :

      Normal.

    • Abnormal :

      Abnormal.

    Normal
    Weight

    integer

    Bobot anggota dalam kelompok target entri rute. Nilai valid:

    • 100: Anggota adalah instans utama.

    • 0: Anggota adalah instans sekunder.

    Bobot hanya dapat diatur selama pembuatan dan tidak dapat dimodifikasi.

    100
    VpcId

    string

    ID VPC tempat kelompok target entri rute berada.

    vpc-uf60y8uzhsvbhmuh3l654
    RouteTargetGroupId

    string

    ID instans kelompok target entri rute.

    rtg-xxxx
    ConfigMode

    string

    Mode konfigurasi kelompok target entri rute. Nilai valid:

    • Active-Standby: Mode aktif/siaga.

    Valid values:

    • Active-Standby :

      Mode aktif/siaga.

    Active-Standby
    RegionId

    string

    ID wilayah VPC tempat kelompok target entri rute berada.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    Tags

    array<object>

    Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Jika Anda menentukan parameter ini, Anda dapat memasukkan string kosong. Panjang nilai tag dapat mencapai 128 karakter. Nilai tag tidak dapat dimulai dengan aliyun atau acs:, dan tidak dapat mengandung http:// atau https://.

    object

    Tag sumber daya.

    Value

    string

    Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Jika Anda menentukan parameter ini, Anda dapat memasukkan string kosong. Panjang nilai tag dapat mencapai 128 karakter. Nilai tag tidak dapat dimulai dengan aliyun atau acs:, dan tidak dapat mengandung http:// atau https://.

    8
    Key

    string

    Kunci tag sumber daya.

    image/upload/cbbec42e0be33abb27babefcbe0397f0
    RouteTargetGroupName

    string

    Nama kelompok target entri rute.

    myRouteTargetGroupName
    ResourceGroupId

    string

    ID kelompok sumber daya tempat kelompok target entri rute berada.

    rg-acfm3swh6ta56ri
    CreateTime

    string

    Waktu pembuatan kelompok target entri rute. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.

    2025-12-30T06:40:50Z
    MaxResults

    integer

    Jumlah entri yang dikembalikan per halaman.

    50

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount": 1,
  "RouteTargetGroups": [
    {
      "Status": "Available",
      "RouteTargetGroupDescription": "myRouteTargetGroupDescription",
      "RouteTargetMemberList": [
        {
          "MemberId": "ep-xxxx",
          "EnableStatus": "Enable",
          "MemberType": "GatewayLoadBalancerEndpoint",
          "HealthCheckStatus": "Normal",
          "Weight": 100
        }
      ],
      "VpcId": "vpc-uf60y8uzhsvbhmuh3l654",
      "RouteTargetGroupId": "rtg-xxxx",
      "ConfigMode": "Active-Standby",
      "RegionId": "cn-hangzhou",
      "Tags": [
        {
          "Value": "8",
          "Key": "image/upload/cbbec42e0be33abb27babefcbe0397f0"
        }
      ],
      "RouteTargetGroupName": "myRouteTargetGroupName",
      "ResourceGroupId": "rg-acfm3swh6ta56ri",
      "CreateTime": "2025-12-30T06:40:50Z"
    }
  ],
  "MaxResults": 50
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalParam.NextToken The specified NextToken is invalid. Parameter NextToken tidak valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.