调用DescribeTransitRouterAttachments接口，查询满足指定条件的TR连接，包括VPC、VPN、专线网关类型网络实例连接和跨地域连接。
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeTransitRouterAttachments | 要执行的操作，取值为DescribeTransitRouterAttachments。 |
| Version | String | 是 | 2020-04-01 | API版本信息，当前版本为2020-04-01。 |
| TransitRouterId | String | 否 | tr-7qthudw0ll6jmc**** | 中转路由器实例的ID。您可以调用DescribeTransitRouters接口获取中转路由器实例ID。 |
| PageNumber | Integer | 否 | 1 | 列表的页码，默认值为1。 |
| PageSize | Integer | 否 | 20 | 分页查询时每页的行数，取值范围为1 ~ 100，默认值为20。 |
ResourceType | String | 否 | VPC | 网络实例的类型。取值如下：
|
ResourceId | String | 否 | vpc-bp1aevy8sofi8mh1**** | 网络实例的ID。
|
TransitRouterAttachmentIds.N | String | 否 | TransitRouterAttachmentIds.1=tr-attach-13n2l4c****&TransitRouterAttachmentIds.2=tr-attach-b1h2p6g**** | 网络实例连接的ID。
说明
|
TagFilters.N.Key | String | 否 | TagFilters.1.Key=k1&TagFilters.2.Key=k2 | 网络实例连接标签的标签键。
|
TagFilters.N.Values.N | String | 否 | TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2&TagFilters.2.Values.1=v3 | 网络实例连接标签的标签值。
说明
|
| TransitRouterForwardPolicyTableId | String | 否 | tr-fpt-hy13n2l4c6c0v**** | 跨地域连接关联的转发策略的ID。 您可以调用DescribeTransitRouterForwardPolicyTables接口获取转发策略的ID。 |
TransitRouterTrafficQosMarkingPolicyId | String | 否 | tr-tmp-3t6b1n60vg4jks0txrs8**** | 跨地域连接关联的流标记策略的ID。 |
TransitRouterTrafficQosQueuePolicyId | String | 否 | tr-tqp-1wzpagcsk5dz48ny6hgzb**** | 跨地域连接关联的流队列策略的ID。 |
名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| PageSize | Integer | 20 | 当前分页的行数。 |
| PageNumber | Integer | 1 | 当前页码。 |
| TotalCount | Integer | 2 | 符合条件的网络实例连接总数。 |
| TransitRouterAttachments | Array of Struct | - | 符合条件的网络实例连接的详细信息。具体请参见下表“ TransitRouterAttachments ”。 |
TransitRouterAttachments
名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| CreationTime | String | 2021-04-09T08:36:47+08:00 | 网络实例连接的创建时间。 |
| Description | String | This attachment is used for test. | 网络实例连接的描述信息。 |
| ResourceId | String | vpc-bp1aevy8sofi8mh1**** | 网络实例连接关联的网络实例ID。 |
ResourceType | String | VPC | 网络实例连接关联的网络实例类型。
|
Status | String | Available | 网络实例连接的状态。
|
| TransitRouterAttachmentId | String | tr-attach-13n2l4c**** | 网络实例连接的ID。 |
| TransitRouterAttachmentName | String | trattachment-01 | 网络实例连接的名称。 |
| TransitRouterId | String | tr-3tehy13n2l4c6c0v**** | 中转路由器实例的ID。 |
| TransitRouterRouteTableId | String | tr-rtb-hy13n2l4c6c0v**** | 网络实例连接关联转发的路由表ID。 |
| TransitRouterForwardPolicyTableId | String | tr-fpt-hy13n2l4c6c0v**** | 跨地域连接关联的转发策略的ID。 |
| TransitRouterTrafficQosMarkingPolicyId | String | tr-tmp-3t6b1n60vg4jks0txrs8**** | 跨地域连接关联的流标记策略的ID。 |
| TransitRouterTrafficQosQueuePolicyId | String | tr-tqp-1wzpagcsk5dz48ny6hgzb**** | 跨地域连接关联的流队列策略的ID。 |
| UpdateTime | String | 2021-04-10T09:18:28+08:00 | 网络实例连接的最近操作时间。 |
AutoPublishRouteEnabled | Boolean | false | 是否自动同步TR路由到网络实例路由表中。
|
| AccountId | String | 200001**** | 网络实例连接所属的账号ID。 |
BusinessStatus | String | Normal | 网络实例连接的业务状态。取值如下：
|
| DeletedTime | String | 2021-05-07 23:23:23 | 网络实例连接的删除时间。 |
| OverdueTime | String | 2021-05-07 23:23:23 | 网络实例连接的欠费关停时间。 |
| Tags | Array of Struct | - | 网络实例连接的标签信息。具体请参见下表“Tags”。 |
Tags
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Key | String | k1 | 网络实例连接标签的标签键。 |
| Value | String | v1 | 网络实例连接标签的标签值。 |
GET /?Action=DescribeTransitRouterAttachments&Version=2020-04-01&TransitRouterId=tr-7qthudw0ll6jmc**** HTTP/1.1 Host: open.volcengineapi.com Service: transitrouter Region: cn-guangzhou
{ "ResponseMetadata": { "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****", "Action": "DescribeTransitRouterAttachments", "Version": "2020-04-01", "Service": "transitrouter", "Region": "cn-guangzhou" }, "Result": { "PageNumber": 1, "PageSize": 20, "TotalCount": 1, "TransitRouterAttachments": [ { "TransitRouterId": "tr-7qthudw0ll6jmc****", "TransitRouterRouteTableId": "tr-rtb-hy13n2l4c6c0v****", "TransitRouterForwardPolicyTableId": "tr-fpt-hy13n2l4c6c0v****", "TransitRouterTrafficQosMarkingPolicyId": "", "TransitRouterTrafficQosQueuePolicyId": "", "TransitRouterAttachmentId": "tr-attach-13n2l4c****", "TransitRouterAttachmentName": "trattachment-01", "Description": "This transit router is used for test.", "ResourceType": "VPC", "ResourceId": "vpc-bp1aevy8sofi8mh1****", "AutoPublishRouteEnabled": false, "CreationTime": "2021-04-09T08:36:47+08:00", "UpdateTime": "2021-04-10T09:18:28+08:00", "Status": "Available", "AccountId": "2000001****", "Tags": [ { "Key": "k1", "Value": "v1" } ], "BusinessStatus": "Normal", "OverdueTime": "", "DeletedTime": "" } ] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidPage.Malformed | The specified page is malformed. | 指定的分页参数不合法。 |
| 400 | LimitExceeded.ResourceIds | You've reached the limit of 100 resource IDs that can be specified in this request. | 该请求传入了非法或不支持的参数。资源查询数目最大限制100。 |
| 400 | InvalidTagFilter.Disorder | The specified index order of tag filter is malformed. | 指定标签过滤项的索引顺序参数格式不合法。 |
| 400 | InvalidTagFilterKey.Malformed | The specified parameter tag filter key is invalid. | 过滤标签键不合法。 |
| 400 | InvalidTagFilterValue.Malformed | The specified parameter tag filter value is invalid. | 过滤标签值不合法。 |
| 400 | mitExceeded.TagFilterKey | You've reached the limit on the number of tag keys that you can filter. | 已达到单次可指定过滤标签键数量的上限。 |
| 400 | LimitExceeded.TagFilterValue | You've reached the limit on the number of tag values that you can filter. | 已达到单次可指定过滤标签值数量的上限。 |