この API を呼び出して、1 つやそれ以上の ECS インスタンスに RAM のロールを割り当てることができます。 1 つのインスタンスに割り当てられる RAM ロールは 1 つだけです。 インスタンスに RAM ロールがアタッチされている場合、同じインスタンスに別の RAM ロールをアタッチするとエラーコードが返されます。

デバッグ

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

リクエストパラメータ

名前 必須 / 省略可能 説明
InstanceIds String はい [“instanceId1”, “instanceId2”, “instanceId3”…]

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

RamRoleName String はい RamRoleTest

インスタンスの RAM ロール名。 ListRoles API を呼び出して、指定したインスタンスの RAM ロールを表示できます。

RegionId String はい cn-hangzhou

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

Action String いいえ AttachInstanceRamRole

実行する API. 値を AttachInstanceRamRole に設定します。

レスポンスパラメータ

名前 説明
AttachInstanceRamRoleResults

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

  └Code String 200

RAM ロールが割り当てられているかどうかを示します。 200 が返される場合、操作は成功です。 他の値が返される場合、操作は失敗です。 詳細は、エラーコードをご参照ください。

  └InstanceId String i-instanceid1

インスタンスの ID。

  └Message String Success

RAM ロールが割り当てられているかどうかを示します。 Success が返される場合、操作は成功です。 他の値が返される場合、操作は失敗します。 詳細は、エラーコードをご参照ください。

  └Success Boolean true

RAM ロールが割り当てられているかどうかを示します。

FailCount Integer 0

接続に失敗した RAM ロールの数。

RamRoleName String RamRoleTest

Arn と RAM ロールの名前。

RequestId String D9553E4C-6C3A-4D66-AE79-9835AF705639

リクエスト ID。 API 操作が成功したかどうかにかかわらず、システムは各 API リクエストに対して一意の RequestId を返します。

TotalCount Integer 1

アタッチされている RAM ロールの数。

リクエストのコーディング例


https://ecs.aliyuncs.com/?Action=AttachInstanceRamRole
&InstanceId_1 = "i-instance1" 
&RamRoleName=RamRoleTest 
&RegionId=cn-hangzhou 
&<Common request parameters>

成功したレスポンスのコーディング例

XML 形式

<AttachInstanceRamRoleResponse>
  <RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
  <AttachInstanceRamRoleResults>
    <AttachInstanceRamRoleResult>
      <InstanceId>i-instance1</InstanceId>
      <Code>200</Code>
      <Message>success</Message>
    </AttachInstanceRamRoleResult>
  </AttachInstanceRamRoleResults>
  <TotalCount>1</TotalCount> 
  <FailCount>0</FailCount>
  <RamRoleName>RamRoleTest</RamRoleName>
</AttachInstanceRamRoleResponse>

JSON 形式

{
	"TotalCount":1,
	"RequestId":"D9553E4C-6C3A-4D66-AE79-9835AF705639",
	"AttachInstanceRamRoleResults":{
		"AttachInstanceRamRoleResult":[
			{
				"Message":"success",
				"InstanceId":"i-instance1",
				"Code":"200"
			}
		]
	},
	"RamRoleName":"RamRoleTest",
	"FailCount":0
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidRamRole.NotEcsRole 指定された RAM ロールは ECS に権限付与されていません。ロールポリシーをご確認ください。 指定された RAM ロールは ECS へのアクセスを許可されていない場合に返されるエラーメッセージ。

エラーコードの表示。