全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

DescribeInstanceRamRole

更新时间:2018-01-29 10:43:15

描述

查询某一台或者多台 ECS 实例上的已赋予的 实例 RAM 角色 的信息。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:DescribeInstanceRamRole
InstanceIds String 指定查询的实例 ID 的集合。最多支持一次查询 100 台实例,格式为 ["instanceId1", "instanceId2", "instanceId3"…]。
RamRoleName String 查询赋予了某一实例 RAM 角色的所有 ECS 实例。您可以使用 RAM API ListRoles 查询您已创建的实例 RAM 角色。

返回参数

名称 类型 描述
InstanceRamRoleSets Array 由实例 RAM 角色类型(InstanceRamRoleSetType)组成的信息集

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeInstanceRamRole
  2. &RegionId=cn-hangzhou
  3. &InstanceIds=["i-instance1"]
  4. &<公共请求参数>

返回示例

XML 格式

  1. <DescribeInstanceRamRoleResponse>
  2. <RequestId>8F4CAE3F-7892-4662-83A5-2C2FFD639553</RequestId>
  3. <InstanceRamRoleSets>
  4. <InstanceRamRoleSet>
  5. <InstanceId>i-instance1</InstanceId>
  6. <RamRoleName>RamRoleTest</RamRoleName>
  7. </InstanceRamRoleSet>
  8. </InstanceRamRoleSets>
  9. <TotalCount>1</TotalCount>
  10. </DescribeInstanceRamRoleResponse>

JSON 格式

  1. {
  2. "RequestId": "8F4CAE3F-7892-4662-83A5-2C2FFD639553",
  3. "InstanceRamRoleSets": {
  4. "InstanceRamRoleSet": [
  5. {
  6. "InstanceId": "i-instance1",
  7. "RamRoleName": "RamRoleTest"
  8. }
  9. ]
  10. },
  11. "TotalCount": 1
  12. }

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidInstanceIds.Malformed The specified InstanceIds is not valid. 400 指定的 InstanceIds 不合法。
InvalidNetworkType.MismatchRamRole Ram role cannot be attached to instances of Classic network type. 403 您指定的参数 InstanceIds 中包含了经典网络实例,实例 RAM 角色不支持经典网络类型。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例 ID 不存在。
InvalidRamRole.NotFound The specified RamRoleName does not exist. 404 指定的 RamRoleName 不存在。
本文导读目录