DescribeInstanceRamRole

佚, 佚名 • 2019年3月21日 pm8:47 • 阿里云 • 阅读 633

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

调试

前往【API Explorer】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。

请求参数


名称	类型	是否必选	示例值	描述
RegionId	String	是	cn-hangzhou	实例 RAM 角色所在的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。
Action	String	否	DescribeInstanceRamRole	接口名称，取值：DescribeInstanceRamRole
InstanceIds	String	否	[“instanceId1”, “instanceId2”, “instanceId3″…]	指定查询的实例 ID 的集合。最多支持一次查询 100 台实例。
PageNumber	Integer	否	1	查询接口返回资源信息列表的页码。起始值：1。默认值：1。
PageSize	Integer	否	10	分页展示响应信息时设置的每页行数，单位：行。最大值：100。默认值：10。
RamRoleName	String	否	FinanceDeptOnly	查询赋予了某一实例 RAM 角色的所有 ECS 实例。您可以使用 RAM API ListRoles 查询您已创建的实例 RAM 角色。

返回参数


名称	类型	示例值	描述
InstanceRamRoleSets			由实例 RAM 角色类型（InstanceRamRoleSetType）组成的信息集。
└InstanceId	String	i-instance1	实例 ID
└RamRoleName	String	FinanceDeptOnly	实例的 RAM 角色名称列表
RegionId	String	cn-hangzhou	实例 RAM 角色所在的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求 ID。
TotalCount	Integer	1	返回的 RAM 角色数量。

示例

请求示例


https://ecs.aliyuncs.com/?Action=DescribeInstanceRamRole
&RegionId=cn-hangzhou
&InstanceIds=["i-instance1"]
&PageNumber=1
&PageSize=10
&RamRoleName=FinanceDeptOnly
&<公共请求参数>

正常返回示例

XML 格式

<DescribeInstanceRamRoleResponse>
  <RequestId>8F4CAE3F-7892-4662-83A5-2C2FFD639553</RequestId>
  <InstanceRamRoleSets>
    <InstanceRamRoleSet>
      <InstanceId>i-instance1</InstanceId>
      <RamRoleName>RamRoleTest</RamRoleName>
    </InstanceRamRoleSet>
  </InstanceRamRoleSets>
  <TotalCount>1</TotalCount>
</DescribeInstanceRamRoleResponse>

JSON 格式

{
	"TotalCount":1,
	"RequestId":"8F4CAE3F-7892-4662-83A5-2C2FFD639553",
	"InstanceRamRoleSets":{
		"InstanceRamRoleSet":[
			{
				"InstanceId":"i-instance1",
				"RamRoleName":"RamRoleTest"
			}
		]
	}
}

错误码

查看本产品错误码

发布者：佚, 佚名，转转请注明出处：https://www.cms2.cn/aliyun/1972.html

DescribeInstanceRamRole

调试

请求参数

返回参数

示例

错误码

相关推荐

删除伸缩规则

DeleteHpcCluster

Azure迁移至阿里云ECS

ModifyLaunchTemplateDefaultVersion

CancelCopyImage

DDoS基础防护

发表评论