查询路由目标组列表。
接口说明
查询路由目标组列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| VpcId |
string |
否 |
路由目标组所属的 VPC 的 ID。 |
vpc-xxxx |
| RouteTargetGroupIds |
array |
否 |
路由目标组实例 ID 列表。 单次查询最多支持传入 50 个实例 ID。 |
|
|
string |
否 |
路由目标组实例 ID。 |
rtg-xxxx |
|
| MemberId |
string |
否 |
路由目标组成员实例 ID。 筛选成员包含传入成员实例 ID 的路由目标组。 |
ep-xxxx |
| MaxResults |
integer |
否 |
分页大小，取值范围：1~50，默认值：50。 |
50 |
| NextToken |
string |
否 |
是否拥有下一次查询的令牌（Token）。取值：第一次查询和没有下一次查询时，均无需填写。如果有下一次查询，取值为上一次 API 调用返回的 NextToken 值。 |
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| RegionId |
string |
是 |
路由目标组所属的 VPC 的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| ResourceGroupId |
string |
否 |
资源组 ID。关于资源组的更多信息，请参见什么是资源组。 |
rg-acfmxazdjdhd**** |
| ClientToken |
string |
否 |
客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明 若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。 |
123e4567-e89b-12d3-a456-426655440000 |
| Tag |
array<object> |
否 |
标签列表。 |
|
|
object |
否 |
资源的标签。 |
||
| Key |
string |
否 |
资源的标签键。最多支持输入 20 个标签键。如需传入该值，则不能输入空字符串。 一个标签键最多支持 128 个字符，不能以 |
FinanceJoshua |
| Value |
string |
否 |
资源的标签值。最多支持输入 20 个标签值。如需传入该值，可以输入空字符串。 最多支持 128 个字符，不能以 |
FinanceJoshua |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6 |
| NextToken |
string |
是否拥有下一次查询的令牌（Token）。取值：如果 NextToken 为空表示没有下一次查询。如果 NextToken 有返回值，该取值表示下一次查询开始的令牌。 |
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| TotalCount |
integer |
列表条目数。 |
1 |
| RouteTargetGroups |
array<object> |
路由目标组列表。 |
|
|
array<object> |
|||
| Status |
string |
路由目标组的状态。取值：
枚举值：
|
Available |
| RouteTargetGroupDescription |
string |
路由目标组描述信息。 |
myRouteTargetGroupDescription |
| RouteTargetMemberList |
array<object> |
路由目标组的成员列表。 |
|
|
object |
路由目标组的成员列表。 |
||
| MemberId |
string |
路由目标组成员实例 ID。 |
ep-xxxx |
| EnableStatus |
string |
路由目标组成员使能状态。取值：
只有未使能状态的路由目标组成员允许被修改为其他实例。使能中的路由目标组成员禁止修改。 枚举值：
|
Enable |
| MemberType |
string |
路由目标组的成员类型。 当前支持的类型：
枚举值：
|
GatewayLoadBalancerEndpoint |
| HealthCheckStatus |
string |
路由目标组成员健康检查状态。取值：
枚举值：
|
Normal |
| Weight |
integer |
路由目标组成员的权重值。取值：
权重值仅支持在创建时设置，不支持修改。 |
100 |
| VpcId |
string |
路由目标组所属 VPC 的 ID。 |
vpc-uf60y8uzhsvbhmuh3l654 |
| RouteTargetGroupId |
string |
路由目标组的实例 ID。 |
rtg-xxxx |
| ConfigMode |
string |
路由目标组的配置模式，支持模式如下：
枚举值：
|
Active-Standby |
| RegionId |
string |
路由目标组所属的 VPC 的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| Tags |
array<object> |
资源的标签值。最多支持输入 20 个标签值。如需传入该值，可以输入空字符串。 最多支持 128 个字符，不能以 |
|
|
object |
资源的标签。 |
||
| Value |
string |
资源的标签值。最多支持输入 20 个标签值。如需传入该值，可以输入空字符串。 最多支持 128 个字符，不能以 |
8 |
| Key |
string |
资源的标签键。 |
image/upload/cbbec42e0be33abb27babefcbe0397f0 |
| RouteTargetGroupName |
string |
路由目标组名称信息。 |
myRouteTargetGroupName |
| ResourceGroupId |
string |
路由目标组所属的资源组 ID。 |
rg-acfm3swh6ta56ri |
| CreateTime |
string |
创建路由目标组的时间。 |
2025-12-30T06:40:50Z |
| MaxResults |
integer |
分页大小。 |
50 |
示例
正常返回示例
JSON格式
{
"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
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IllegalParam.NextToken | The specified NextToken is invalid. | 参数NextToken非法. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。