调用 DescribeInstancesIamRoles 接口查询一台或多台ECS实例上已绑定的IAM角色。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | DescribeInstancesIamRoles | 要执行的操作，取值：DescribeInstancesIamRoles。 |
Version | String | 是 | 2020-04-01 | API的版本，取值：2020-04-01。 |
InstanceIds.N | Array of String | 否 | InstanceIds.1=i-cm9tn4z1eohuu4d3****&InstanceIds.2=i-3tiegs1y963vj0**** | 实例ID，最多支持100个ID。
|
MaxResults | Integer | 否 | 10 | 分页查询时设置的每页行数。
|
NextToken | String | 否 | -- | 分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
InstancesIamRoles | Array of Object | -- | 符合条件的AssumeRole集合。 |
NextToken | String | bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq****** | 本次调用返回的查询凭证值，返回为空表示该页为末页。 |
GET /?Action=DescribeInstancesIamRoles&Version=2020-04-01&InstanceIds.1=i-cm9tn4z1eohuu4d3**** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata": { "RequestId": "2021110417394001022514606307******", "Action": "DescribeInstancesIamRoles", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "InstancesIamRoles": [ { "InstanceId": "i-cm9tn4z1eohuu4d3****", "RoleNames": [ "EcsTestRole" ] } ], "NextToken": "" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | InvalidArgument | The specified argument is invalid. | 指定的参数不合法。 |
400 | LimitExceeded.MaximumInstanceIds | You've reached the limit on the number of InstanceIds that you can set. | 指定的InstanceIds数量超过最大限制。 |
429 | FlowLimitExceeded | You've reach the limit on request rate of resources. | 您已超过资源请求限速。 |
500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |