全部产品
Search
文档中心

专有网络 VPC:GetRouteTargetGroup - 查询路由目标组

更新时间:Aug 28, 2026

获取路由目标组实例信息。

接口说明

获取路由目标组实例信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST / HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

RouteTargetGroupId

string

是

路由目标组成员实例 ID。

rtg-xxxx

RegionId

string

是

路由目标组所属地域的 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou

ClientToken

string

否

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明

若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。

02fb3da4-130e-11e9-8e44-0016e04115b

Tag

array<object>

否

标签信息。

object

否

资源的标签集合。

Key

string

否

资源的标签键。最多支持输入 20 个标签键。如需传入该值,则不能输入空字符串。

一个标签键最多支持 128 个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

FinanceDept

Value

string

否

资源的标签值。最多支持输入 20 个标签值。如需传入该值,可以输入空字符串。

最多支持 128 个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

FinanceJoshua

返回参数

名称

类型

描述

示例值

object

Schema of Response

RouteTargetGroupId

string

路由目标组实例 ID。

rtg-xxxx

RouteTargetGroupName

string

路由目标组名称。

myRouteTargetGroupName

RouteTargetGroupDescription

string

路由目标组描述。

myRouteTargetGroupDescription

VpcId

string

路由目标组所属的 VPC 的 ID。

vpc-xxxx

ConfigMode

string

路由目标组的配置模式,支持模式如下:

  • Active-Standby: 主备模式。

枚举值:

  • Active-Standby :

    Active-Standby

Active-Standby

Status

string

路由目标组的状态。取值:

  • Recovering:主备回切中

  • Switched:主备已切换

  • Available:可用

  • Abnormal:备实例异常

  • Pending:创建中

  • Switching:主备切换中

  • Deleting:删除中

  • Unavailable:主备实例均异常

枚举值:

  • Recovering :

    主备回切中

  • Switched :

    主备已切换

  • Available :

    可用

  • Abnormal :

    备实例异常

  • Pending :

    创建中

  • Switching :

    主备切换中

  • Deleting :

    删除中

  • Unavailable :

    主备实例均异常

Available

RouteTargetMemberList

array<object>

路由目标组的成员列表。

object

MemberId

string

路由目标组成员实例 ID。

ep-xxxx

MemberType

string

路由目标组的成员类型。

当前支持的类型:

  • GatewayLoadBalancerEndpoint

枚举值:

  • GatewayLoadBalancerEndpoint :

    网关型负载均衡终端节点

GatewayLoadBalancerEndpoint

Weight

integer

路由目标组成员的权重值。取值:

  • 100:表示成员为主实例。

  • 0:表示成员为备实例。

权重值仅支持在创建时设置,不支持修改。

枚举值:

  • 0 :

    0

  • 100 :

    100

100

HealthCheckStatus

string

路由目标组成员健康检查状态。取值:

  • Normal:正常

  • Abnormal:状态异常

枚举值:

  • Normal :

    Normal

  • Abnormal :

    Abnormal

Normal

EnableStatus

string

路由目标组成员使能状态。取值:

  • Enable:使能中。

  • Disable:未使能。

只有未使能状态的路由目标组成员允许被修改为其他实例。使能中的路由目标组成员禁止修改。

枚举值:

  • Enable :

    使能中

  • Disable :

    未使能

Enable

Tags

array<object>

路由目标组的标签。

object

资源的标签。

Key

string

标签键。

FinanceDept

Value

string

标签值。

FinanceJoshua

RegionId

string

路由目标组所属的 VPC 的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-qingdao

RequestId

string

请求 ID。

1AE05898-06E5-4782-xxxxx

ResourceGroupId

string

要查询的路由目标组所属资源组的 ID。

rg-acfmxazdjdhd****

CreateTime

string

创建路由目标组的时间。

2025-12-30T06:40:50Z

示例

正常返回示例

JSON格式

{
  "RouteTargetGroupId": "rtg-xxxx",
  "RouteTargetGroupName": "myRouteTargetGroupName",
  "RouteTargetGroupDescription": "myRouteTargetGroupDescription",
  "VpcId": "vpc-xxxx",
  "ConfigMode": "Active-Standby",
  "Status": "Available",
  "RouteTargetMemberList": [
    {
      "MemberId": "ep-xxxx",
      "MemberType": "GatewayLoadBalancerEndpoint",
      "Weight": 100,
      "HealthCheckStatus": "Normal",
      "EnableStatus": "Enable"
    }
  ],
  "Tags": [
    {
      "Key": "FinanceDept",
      "Value": "FinanceJoshua"
    }
  ],
  "RegionId": "cn-qingdao",
  "RequestId": "1AE05898-06E5-4782-xxxxx",
  "ResourceGroupId": "rg-acfmxazdjdhd****",
  "CreateTime": "2025-12-30T06:40:50Z"
}

错误码

HTTP status code

错误码

错误信息

描述

400 ResourceNotFound.RouteTargetGroup The specified resource of %s is not found. 指定资源%s不存在。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。