DescribeInstanceGrantedToExpressConnectRouter - 查询授权给专线网关（ECR）的网络实例

查询授权给专线网关ECR（Express Connect Router）的网络实例。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

expressconnectrouter:DescribeInstanceGrantedToExpressConnectRouter

list

*ExpressConnectRouter

acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId}

无

请求参数

名称	类型	必填	描述	示例值
EcrId	string	是	专线网关实例 ID。	ecr-mezk2idmsd0vx2****
InstanceRegionId	string	否	授权网络实例所在的地域。	cn-hangzhou
InstanceId	string	否	授权实例的 ID。	vbr-j6cwxhgg0s5nuephp****
InstanceOwnerId	integer	否	授权网络实例所属阿里云账号（主账号）ID。	1298452580502345
InstanceType	string	否	网络实例的类型。取值： VBR：边界路由器实例。 VPC：专有网络实例。	VBR
NextToken	string	否	是否拥有下一次查询的令牌（Token）。取值：第一次查询和没有下一次查询时，均无需填写。如果有下一次查询，取值为上一次 API 调用返回的 NextToken 值。	gAAAAABkyGzFbZR2NnxnyVk0EiL7F3qMBtBim8Es0mugRT3qb8yEHAMaHGanzuaHUmiEq9QRmok0RgxJAINBOJZa5KPjopEu_Q==
MaxResults	integer	否	本次读取的最大数据量。取值范围：1～2147483647。默认值为 20。	20
TagModels	array<object>	否	标签列表。
	object	否
TagKey	string	否	资源的标签键。最多支持输入 20 个标签键。如果传入该值，则不能输入空字符串。最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	key
TagValue	string	否	资源的标签值。最多支持输入 20 个标签值。如果传入该值，则不能输入空字符串。最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	value
ResourceGroupId	string	否	实例所属的资源组 ID。	rg-aek2tsvbnfe****
DryRun	boolean	否	是否只预检此次请求。取值： true：发送检查请求，不会修改服务资源。 false（默认值）：发送正常请求。	true
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	02fb3da4-130e-11e9-8e44-00****
CallerType	string	否	调用者类型 ECR OTHER 默认值: ECR	ECR

返回参数

名称	类型	描述	示例值
	object	RpcResponse
RequestId	string	请求 ID。	6FABF516-FED3-5697-BDA2-B18C5D9A****
Success	boolean	是否调用成功。取值： True：成功。 False：失败。	True
Code	string	判断调用是否成功。返回值为 200 表示加载成功，返回其他值表示加载失败，失败原因参见错误码。	200
Message	string	操作返回信息。	OK
HttpStatusCode	integer	HTTP 状态码。	200
DynamicCode	string	动态错误码。	IllegalParamFormat.Name
DynamicMessage	string	动态错误信息，用于替换返回参数 ErrMessage 错误信息中的`%s`。说明如果 ErrMessage 返回The Value of Input Parameter %s is not valid，且 DynamicMessage 返回 DtsJobId，则代表所传入的请求参数 DtsJobId 不合法。	The param format of Name **** is illegal.
AccessDeniedDetail	string	访问被拒绝详细信息。	Authentication is failed for ****
TotalCount	integer	授权给专线网关的网络实例总数。	10
MaxResults	integer	本次读取的最大数据量。取值范围：1~2147483647。默认值：20。	20
NextToken	string	是否拥有下一次查询的令牌（Token）。取值：如果 NextToken 为空表示没有下一次查询。如果 NextToken 有返回值，该取值表示下一次查询开始的令牌。	FFlMqGuJ10uN3l+FX/cBrGDNXUOUifNeOuAJlT4dc3vsWD6DsNSFAC2FtpeH5QOSG2WFdyRoun7gSLCm5o69YnAQ==
EcrGrantedInstanceList	array<object>	ECR 授权实例列表。
	object
GrantId	string	授权 ID。	gr-8gdelo13mi99g1****
Status	string	授权网络实例的状态。	Active
GmtCreate	string	创建实例的时间。	1669023139000
GmtModified	string	修改实例的时间	1669023139000
EcrId	string	专线网关实例 ID。	ecr-mezk2idmsd0vx2****
NodeId	string	授权实例 ID。	vbr-j6cwxhgg0s5nuephp****
NodeType	string	网络实例的类型。取值： VBR：边界路由器实例。 VPC：虚拟专有网络实例。	VBR
NodeRegionId	string	授权实例所属地域 ID。	cn-hangzhou
NodeOwnerUid	integer	实例所属的阿里云账号的 ID。	129845258050****
NodeOwnerBid	string	实例所属的阿里云企业账号 ID。	26842****
EcrOwnerAliUid	string	接受授权的专线网关实例所属阿里云账号（主账号）ID。	229845258050****

示例

正常返回示例

JSON格式

{
  "RequestId": "6FABF516-FED3-5697-BDA2-B18C5D9A****",
  "Success": true,
  "Code": "200",
  "Message": "OK",
  "HttpStatusCode": 200,
  "DynamicCode": "IllegalParamFormat.Name\n",
  "DynamicMessage": "The param format of Name **** is illegal.\n",
  "AccessDeniedDetail": "Authentication is failed for ****\n",
  "TotalCount": 10,
  "MaxResults": 20,
  "NextToken": "FFlMqGuJ10uN3l+FX/cBrGDNXUOUifNeOuAJlT4dc3vsWD6DsNSFAC2FtpeH5QOSG2WFdyRoun7gSLCm5o69YnAQ==",
  "EcrGrantedInstanceList": [
    {
      "GrantId": "gr-8gdelo13mi99g1****",
      "Status": "Active",
      "GmtCreate": "1669023139000",
      "GmtModified": "1669023139000",
      "EcrId": "ecr-mezk2idmsd0vx2****",
      "NodeId": "vbr-j6cwxhgg0s5nuephp****\n",
      "NodeType": "VBR",
      "NodeRegionId": "cn-hangzhou",
      "NodeOwnerUid": 0,
      "NodeOwnerBid": "26842****",
      "EcrOwnerAliUid": "229845258050****\n"
    }
  ]
}

错误码

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.	参数非法

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

变更历史

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