首页 云企业网 API参考 API目录 网络实例连接 VPN连接 ListTransitRouterVpnAttachments - 查询VPN连接的信息

ListTransitRouterVpnAttachments - 查询VPN连接的信息

调用ListTransitRouterVpnAttachment接口查询VPN连接的信息。

接口说明

在您调用ListTransitRouterVpnAttachments接口的过程中:

  • 如果仅指定了CenIdRegionId参数的值,则系统自动查询当前地域下所有VPN连接的信息。
  • 如果指定了CenIdRegionIdTransitRouterAttachmentId的值,则系统仅查询指定VPN连接的信息。
  • 如果您指定了CenIdRegionId参数的值,则无需指定TransitRouterId参数的值。如果指定了TransitRouterId参数的值,则无需指定CenIdRegionId参数的值。

调试

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

调试

授权信息

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

请求参数

名称类型必填描述示例值
CenIdstring

云企业网实例ID。

cen-rsgxs8ng2awen2****
RegionIdstring

转发路由器实例所属的地域ID。

您可以通过调用DescribeChildInstanceRegions接口获取地域ID。

ap-southeast-2
TransitRouterAttachmentIdstring

VPN连接ID。

tr-attach-a6p8voaodog5c0****
TransitRouterIdstring

转发路由器实例ID。

tr-p0wm740vjnbaprv0m****
MaxResultsinteger

分页查询时每页显示的条目数。默认值:20

20
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
FFmyTO70tTpLG6I3FmYAXGKPd****
Tagarray

云企业网实例的标签信息。

一次最多支持查询20个标签。

object
Keystring

资源的标签键。

一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyun或者acs:开头,不能包含http://或者https://

一次最多支持输入20个标签的标签键。

tagtest
Valuestring

资源的标签值。

标签值可以为空或输入不超过128个字符的字符串,不能以aliyun或者acs:开头,不能包含http://或者https://

每一个标签键对应一个标签值,一次最多支持输入20个标签键对应的标签值。

value_A1

返回参数

名称类型描述示例值
object

返回结果。

NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
FFmyTO70tTpLG6I3FmYAXGKPd****
RequestIdstring

请求ID。

3D5530D2-3BBB-524E-8E98-59AB06A250E4
TotalCountinteger

列表条目数。

1
MaxResultsinteger

分页查询时每页显示的条目数。

20
TransitRouterAttachmentsarray

VPN连接信息列表。

object

VPN连接的信息。

CreationTimestring

创建VPN连接的时间。

时间按照ISO8601标准表示,并使用UTC时间。格式为:YYYY-MM-DDThh:mmZ。

2022-07-08T08:45Z
Statusstring

VPN连接的状态。

  • Attached:已加载。
  • Attaching:加载中。
  • Detaching:卸载中。
  • Detached:已卸载。
Attached
TransitRouterAttachmentIdstring

VPN连接ID。

tr-attach-a6p8voaodog5c0****
TransitRouterIdstring

转发路由器实例ID。

tr-p0wm740vjnbaprv0m****
ResourceTypestring

VPN连接所属的资源类型。

仅取值:VPN,表示转发路由器连接了IPsec连接。

VPN
VpnOwnerIdlong

IPsec连接所属的阿里云账号(主账号)ID。

1210123456123456
VpnIdstring

IPsec连接ID。

vco-p0wtu1xgd0l7fjo7k****
TransitRouterAttachmentDescriptionstring

VPN连接的描述信息。

desctest
VpnRegionIdstring

IPsec连接所属的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

ap-southeast-2
AutoPublishRouteEnabledboolean

是否允许转发路由器实例自动向IPsec连接发布路由条目。取值:

  • true:允许。
  • false:不允许。
true
TransitRouterAttachmentNamestring

VPN连接的名称。

nametest
Zonesarray

部署VPN连接的可用区列表。

object

部署VPN连接的可用区。

ZoneIdstring

可用区ID。

您可以通过调用DescribeZones接口查询可用区ID对应的可用区的信息。

ap-southeast-2a
Tagsarray

标签列表。

object
Keystring

标签键。

test
Valuestring

标签的值。

value_A1
ChargeTypestring

VPN连接的付费类型。

仅取值:POSTPAY,表示按使用量后付费。

POSTPAY
CenIdstring

云企业网实例ID。

cen-j3jzhw1zpau2km****

示例

正常返回示例

JSON格式

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "3D5530D2-3BBB-524E-8E98-59AB06A250E4",
  "TotalCount": 1,
  "MaxResults": 20,
  "TransitRouterAttachments": [
    {
      "CreationTime": "2022-07-08T08:45Z",
      "Status": "Attached",
      "TransitRouterAttachmentId": "tr-attach-a6p8voaodog5c0****",
      "TransitRouterId": "tr-p0wm740vjnbaprv0m****",
      "ResourceType": "VPN",
      "VpnOwnerId": 1210123456123456,
      "VpnId": "vco-p0wtu1xgd0l7fjo7k****",
      "TransitRouterAttachmentDescription": "desctest",
      "VpnRegionId": "ap-southeast-2",
      "AutoPublishRouteEnabled": true,
      "TransitRouterAttachmentName": "nametest",
      "Zones": [
        {
          "ZoneId": "ap-southeast-2a"
        }
      ],
      "Tags": [
        {
          "Key": "test",
          "Value": "value_A1"
        }
      ],
      "ChargeType": "POSTPAY",
      "CenId": "cen-j3jzhw1zpau2km****\n"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400IllegalParam.NextTokenThe specified NextToken is invalid.NextToken是无效的。
400IllegalParam.TrInstanceThe specified TransitRouter is invalid.TransitRouter是无效的。
400IllegalParam.RegionThe specified Region is invalid.参数中指定的Region不合法。
400IllegalParam.CenIdThe specified CenId is invalid.云企业网实例ID非法。
400IllegalParam.CenIdOrRegionIdThe specified CenId or RegionId is invalid.指定的CenId或RegionId不合法。
400IllegalParam.TransitRouterIdThe specified TransitRouterId is illegal.参数中指定的TransitRouterId不合法。
400InvalidParameterInvalid parameter.参数不合法。
400UnauthorizedThe AccessKeyId is unauthorized.账号无权限操作。

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

变更历史

变更时间变更内容概要操作
2023-03-01OpenAPI 描述信息更新,OpenAPI 错误码发生变更,OpenAPI 返回结构发生变更
变更项变更内容
API 描述OpenAPI 描述信息更新
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2022-12-22OpenAPI 错误码发生变更
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2022-09-15OpenAPI 错误码发生变更
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
2022-09-15OpenAPI 错误码发生变更
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
阿里云首页 云企业网 相关技术圈