このAPIを呼び出して、インスタンスRAMロールを1つ以上のECSインスタンスにバインドできます。 インスタンスにインスタンスRAMロールが既にある場合、別のインスタンスRAMロールをインスタンスにバインドするとエラーが返されます。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須／任意 | 例 | 説明 |
操作 | String | 必須 | AttachInstanceRamRole | 実行する操作です。 値を AttachInstanceRamRole に設定します。 |
InstanceIds | String | 必須 | ["i-bp14ss25xca5ex1u ****" 、"i-bp154z5o1qjalfse ****" 、"i-bp10ws62o04ubhvi ****"...] | インスタンスRAMロールをバインドするインスタンスのID。 最大100個のインスタンスIDで構成されるJSON配列にすることができます。 複数のインスタンス ID はカンマ (,) で区切ります。 |
RamRoleName | String | 必須 | testRamRoleName | インスタンスRAMロールの名前。 RAM によって提供される ListRoles 操作を呼び出して、作成した RAM ロールを照会できます。 |
RegionId | String | 必須 | cn-hangzhou | インスタンスのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。 |
Policy | String | 任意 | {"Statement": [{"Action": ["*"]],"Effect": "Allow","Resource": ["*"]}],"Version": "1"} | 権限ポリシー。 ポリシーの長さは1 ~ 1,024文字である必要があります。 RAMロールを1つ以上のインスタンスにバインドする場合、追加のポリシーを指定して、RAMロールの権限をさらに制限できます。 詳細については、「ポリシーの概要」をご参照ください。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
AttachInstanceRamRoleResults | AttachInstanceRamRoleResultの配列 | インスタンスRAMロールのバインド結果の詳細。 | |
AttachInstanceRamRoleResult | |||
Code | String | 200 | インスタンスRAMロールがバインドされたかどうかを示します。 200が返された場合、RAMロールはバインドされています。 他の値が返された場合、RAMロールのバインドに失敗しました。 詳細については、このトピックの「エラーコード」セクションを参照してください。 |
InstanceId | String | i-bp10ws62o04ubhvi **** | インスタンスの ID。 |
Message | String | success | インスタンスRAMロールがバインドされたかどうかを示します。 成功が返された場合、RAMロールはバインドされています。 他の値が返された場合、RAMロールのバインドに失敗しました。 詳細については、このトピックの「エラーコード」セクションを参照してください。 |
Success | Boolean | true | RAMロールがバインドされたかどうかを示します。 |
FailCount | Integer | 0 | バインドに失敗したRAMロールの数。 |
RamRoleName | String | testRamRoleName | インスタンスRAMロールの名前。 |
RequestId | String | D9553E4C-6C3A-4D66-AE79-9835AF705639 | リクエストの ID です。 |
TotalCount | Integer | 1 | The total number of instances to which you attempted to attach the instance RAM role. |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=AttachInstanceRamRole
&InstanceIds=["i-bp10ws62o04ubhvi ****"]
&RamRoleName=testRamRoleName
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
<AttachInstanceRamRoleResponse>
<RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
<AttachInstanceRamRoleResults>
<AttachInstanceRamRoleResult>
<InstanceId>i-bp10ws62o04ubhvi ****</InstanceId>
<Code>200</Code>
<Message>success</Message>
</AttachInstanceRamRoleResult>
</AttachInstanceRamRoleResults>
<TotalCount>1</TotalCount>
<FailCount>0</FailCount>
<RamRoleName>testRamRoleName</RamRoleName>
</AttachInstanceRamRoleResponse>JSON 形式
{
"RequestId": "D9553E4C-6C3A-4D66-AE79-9835AF705639" 、
"AttachInstanceRamRoleResults": {
"AttachInstanceRamRoleResult": [
{
"Message": "success",
"InstanceId": "i-bp10ws62o04ubhvi ****" 、
"Code": "200"
}
]
},
"TotalCount": 1,
"FailCount": 0、
"RamRoleName": "testRamRoleName"
}エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
400 | InvalidInstanceIds.Malformed | 指定されたinstanceIdsは無効です。 | 指定されたInstanceIdsパラメーターが無効な場合に返されるエラーメッセージ。 |
404 | InvalidInstanceId.NotFound | 指定された InstanceId は存在しません | 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。 インスタンスIDが正しいかどうかを確認します。 |
403 | InvalidNetworkType.MismatchRamRole | Ram role cannot be applied to instances of Classic network type. | インスタンスRAMロールはVPC内のインスタンスにのみ使用でき、クラシックネットワーク内のインスタンスには使用できない場合に返されるエラーメッセージ。 |
403 | InvalidUser.PassRoleForbidden | The RAM user does not have the privilege to pass a RAM role. | RAM ユーザーに、RAM ロールを実行する権限が付与されていない場合に返されるエラーメッセージ。 |
404 | InvalidRamRole.NotFound | The specified RAMRoleName does not exist. | 指定されたRamRoleNameパラメーターが存在しない場合に返されるエラーメッセージ。 |
404 | InvalidRamRole.NotEcsRole | The specified ram role is not authorized for ecs, please check your role policy. | 指定された RAM ロールに ECS へのアクセス権限がない場合に返されるエラーメッセージ。 ロールポリシーを確認してください。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。