全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

DescribeInstanceRamRole

更新时间:2017-09-13 09:26:14

描述

查询实例 RAM 角色相关的信息,该 API 可以根据实例 ID 查询实例角色相关信息。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:DescribeInstanceRamRole。
InstanceIds String 实例 ID,最多 100 个实例,[“instanceId1”, “instanceId2”, “instanceId3”…]。

返回参数

名称 类型 描述
InstanceRamRoleSets InstanceRamRoleSetType 实例 RAM 角色信息集

错误码

错误代码 描述 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 实例 RAM 角色不能被用于经典网络。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例 ID 不存在。
InvalidRamRole.NotFound The specified RamRoleName does not exist. 404 指定的 RamRoleName 不存在。

示例

请求示例

  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. }
本文导读目录