查询专线网关ECR（Express Connect Router）关联的专有网络（VPC）和转发路由器（TR）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| expressconnectrouter:DescribeExpressConnectRouterAssociation | list | *ExpressConnectRouter acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| EcrId | string | 是 | 专线网关实例 ID。 | ecr-mezk2idmsd0vx2**** |
| AssociationId | string | 否 | 专线网关与 VPC 或 TR 的关联 ID。 | ecr-assoc-9p2qxx5phpca2m**** |
| AssociationRegionId | string | 否 | VPC 或 TR 所属的地域信息。 | cn-hangzhou |
| AssociationNodeType | string | 否 | 关联的资源类型：
| VPC |
| VpcId | string | 否 | VPC 实例的 ID。 | vpc-bp1h37fchc6jmfyln**** |
| TransitRouterId | string | 否 | 转发路由器实例的 ID。 | tr-2ze4i71c6be454e2l**** |
| CenId | string | 否 | 云企业网实例的 ID。 | cen-of3o1the3i4gwb**** |
| NextToken | string | 否 | 是否拥有下一次查询的令牌（Token）。取值：
| AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4**** |
| MaxResults | integer | 否 | 本次读取的最大数据量。取值范围：1~2147483647。默认值：20。 | 20 |
| DryRun | boolean | 否 | 是否只预检此次请求。取值：
| false |
| ClientToken | string | 否 | 客户端 Token，用于保证请求的幂等性。 从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。
| 02fb3da4-130e-11e9-8e44-00**** |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "05130E79-588D-5C40-A718-C4863A59****",
"Success": true,
"Code": 200,
"Message": "OK",
"HttpStatusCode": 200,
"DynamicCode": "IllegalParamFormat.EcrId",
"DynamicMessage": "The param format of EcrId **** is illegal.",
"AccessDeniedDetail": "Authentication is failed for ****",
"TotalCount": 1,
"MaxResults": 20,
"NextToken": "AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4****\n",
"AssociationList": [
{
"AssociationId": "ecr-assoc-9p2qxx5phpca2m****\n",
"RegionId": "cn-hangzhou",
"OwnerId": 0,
"GmtCreate": "2024-01-09T12:18:23Z",
"GmtModified": "2024-01-09T12:18:23Z",
"Status": "ACTIVE",
"AssociationNodeType": "VPC",
"TransitRouterOwnerId": 0,
"TransitRouterId": "tr-2ze4i71c6be454e2l****\n",
"CenId": "cen-5510frtx8zi54q****",
"VpcOwnerId": 0,
"VpcId": "vpc-2zeeaxet4i2j1a7n7****",
"AllowedPrefixes": [
"192.0.**.**/28"
],
"EcrId": "ecr-fu8rszhgv7623c****",
"AllowedPrefixesMode": "MatchMode",
"Description": "test "
}
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | MissingParam.%s | The param of %s is missing. | 请求参数未填写，请核对对应的参数后重试。 |
| 400 | IllegalParamFormat.%s | The param format of %s is illegal. | 参数格式非法 |
| 400 | IllegalParam.%s | The param of %s is illegal. | 参数非法 |
| 404 | ResourceNotFound.EcrId | EcrId not found. | ECR实例不存在 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-10-17 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2024-09-11 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2024-06-28 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |