ListRouteTargetGroups - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengkueri 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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

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 kelompok target entri rute. Anda dapat menentukan hingga 50 ID instans dalam satu permintaan.
	string	No	ID instans kelompok target entri rute.	rtg-xxxx
MemberId	string	No	ID instans anggota kelompok target entri rute. Parameter ini memfilter kelompok target entri rute yang berisi ID instans anggota yang ditentukan.	ep-xxxx
MaxResults	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 50. Nilai default: 50.	50
NextToken	string	No	Token paginasi untuk kueri berikutnya. Anda tidak perlu menentukan parameter ini untuk permintaan pertama atau jika tidak ada hasil lagi. Jika kueri berikutnya tersedia, atur parameter ini ke nilai NextToken yang dikembalikan dari panggilan 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. Nilai ClientToken hanya dapat berisi karakter ASCII. Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	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. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 128 karakter. Kunci tag tidak boleh diawali dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
Value	string	No	Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:` dan tidak boleh 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 paginasi untuk kueri berikutnya. Jika NextToken kosong, tidak ada hasil lagi. Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
TotalCount	integer	Jumlah total entri yang dikembalikan.	1
RouteTargetGroups	array<object>	Daftar kelompok target entri rute.
	array<object>
Status	string	Status kelompok target entri rute. Nilai valid: Recovering: Alih bencana balik aktif/standby sedang berlangsung. Switched: Alih bencana aktif/standby telah selesai. Available: Kelompok target entri rute tersedia. Abnormal: Instans standby mengalami kegagalan instans. Pending: Kelompok target entri rute sedang dibuat. Switching: Alih bencana aktif/standby sedang berlangsung. Deleting: Kelompok target entri rute sedang dihapus. Unavailable: Instans primer dan sekunder mengalami kegagalan instans. Valid values: Recovering : Alih bencana balik aktif/standby sedang berlangsung. Switched : Alih bencana aktif/standby telah selesai. Available : Kelompok target entri rute tersedia. Abnormal : Instans standby mengalami kegagalan instans. Pending : Kelompok target entri rute sedang dibuat. Switching : Alih bencana aktif/standby sedang berlangsung. Deleting : Kelompok target entri rute sedang dihapus. Unavailable : Instans primer dan sekunder mengalami kegagalan instans.	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	The ID of the route target group member instance.	ep-xxxx
EnableStatus	string	The enable status of the route target group member. Values: Enable: Enabled. Disable: Disabled. Only disabled route target group members can be modified to other instances. Enabled route target group members cannot be modified. Valid values: Enable : Enable Disable : Disable	Enable
MemberType	string	The type of the route target group member. Currently supported types: GatewayLoadBalancerEndpoint Valid values: GatewayLoadBalancerEndpoint : GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint
HealthCheckStatus	string	The health check status of the route target group member. Values: Normal: Normal Abnormal: Abnormal Valid values: Normal : Normal Abnormal : Abnormal	Normal
Weight	integer	The weight value of the route target group member. Values: 100: Indicates that the member is the primary instance. 0: Indicates that the member is the backup instance. The weight value can only be set during creation and cannot be modified.	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/standby. Valid values: Active-Standby : Mode aktif/standby.	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. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.
	object	Tag sumber daya.
Value	string	The value of the resource tag. Up to 20 tag values are supported. If you need to pass this value, you can input an empty string. A maximum of 128 characters is allowed. The value cannot start with `aliyun` or `acs:`, and it must not contain `http://` or `https://`.	8
Key	string	The key of the resource tag.	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 saat kelompok target entri rute dibuat.	2025-12-30T06:40:50Z
MaxResults	integer	Jumlah entri 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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.