この API を呼び出して、1 つや複数の ECS インスタンスに接続されている RAM ロールをクエリできます。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメーター

名前 データ型 必須/省略可能 例 説明
RegionId String 必須 cn-hangzhou

インスタンスのリージョン ID 。 DescribeRegions を実行すると、最新のリージョンリストが表示されます。

Action String 省略可能 DescribeInstanceRamRole

実行する操作。 値を DescribeInstanceRamRole に設定します。

InstanceIds String 省略可能 ["instanceId1", "instanceId2", "instanceId3"…]

インスタンス ID セット 一度に最大 100 個のインスタンスを入力できます。

PageNumber Integer 省略可能 1

ページ番号。

この値は 1 から始まります。

既定値 : 1。

PageSize Integer 省略可能 10

1 ページあたりの行数。

最大値：50

既定値: 10 。

RamRoleName String 省略可能 FinanceDeptOnly

指定された RAM ロールがアタッチされているすべての ECS インスタンス。 ListRoles API を呼び出して、指定したインスタンスのRAM ロールを表示できます。

レスポンスパラメーター

名前 データ型 例 説明
InstanceRamRoleSets

返された RAM ロールの情報。 DetachInstanceRamRoleResult データからなる配列です。

└InstanceId String i-instance1

インスタンスの ID 。

└RamRoleName String FinanceDeptOnly

RAM ロール名のリスト。

RegionId String cn-hangzhou

インスタンスのリージョン ID 。 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=100 
&RamRoleName=FinanceDeptOnly
&<Common request parameters>

通常のレスポンスの例

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"
			}
		]
	}
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 InvalidParameter.AllEmpty %s 必要なパラメーターが指定されていない場合に返されるエラーメッセージ。

エラーコードの表示