Anda dapat memanggil operasi ini untuk mengikat RAM role instance ke satu atau beberapa Instance ECS. Jika suatu instance sudah memiliki RAM role instance, sistem akan mengembalikan error saat Anda mencoba mengikat RAM role instance lain ke instance tersebut.
Debugging
Parameter permintaan
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | AttachInstanceRamRole | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AttachInstanceRamRole. |
| InstanceIds | String | Yes | ["i-bp14ss25xca5ex1u****", "i-bp154z5o1qjalfse****", "i-bp10ws62o04ubhvi****"...] | ID instans yang ingin Anda ikat dengan instance RAM role. Nilai ini dapat berupa array JSON yang terdiri dari maksimal 100 ID instans. Pisahkan beberapa ID instans dengan koma (,). |
| RamRoleName | String | Yes | testRamRoleName | Nama instance RAM role. Anda dapat memanggil operasi ListRoles yang disediakan oleh RAM untuk mengkueri RAM role yang telah Anda buat. |
| RegionId | String | Yes | cn-hangzhou | ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru. |
| Policy | String | No | {"Statement": [{"Action": ["*"],"Effect": "Allow","Resource": ["*"]}],"Version":"1"} | Kebijakan izin. Kebijakan harus terdiri dari 1 hingga 1.024 karakter. Saat Anda mengikat RAM role ke satu atau beberapa instans, Anda dapat menentukan kebijakan tambahan untuk lebih membatasi izin RAM role tersebut. Untuk informasi selengkapnya, lihat Policy overview. |
Parameter respons
| Parameter | Type | Example | Description |
| AttachInstanceRamRoleResults | Array of AttachInstanceRamRoleResult | Detail hasil pengikatan instance RAM role. | |
| AttachInstanceRamRoleResult | |||
| Code | String | 200 | Menunjukkan apakah instance RAM role berhasil diikat. Jika nilai 200 dikembalikan, berarti RAM role berhasil diikat. Jika nilai lain dikembalikan, berarti pengikatan RAM role gagal. Untuk informasi selengkapnya, lihat bagian "Error codes" pada topik ini. |
| InstanceId | String | i-bp10ws62o04ubhvi**** | ID instans. |
| Message | String | success | Menunjukkan apakah instance RAM role berhasil diikat. Jika nilai success dikembalikan, berarti RAM role berhasil diikat. Jika nilai lain dikembalikan, berarti pengikatan RAM role gagal. Untuk informasi selengkapnya, lihat bagian "Error codes" pada topik ini. |
| Success | Boolean | true | Menunjukkan apakah RAM role berhasil diikat. |
| FailCount | Integer | 0 | Jumlah RAM role yang gagal diikat. |
| RamRoleName | String | testRamRoleName | Nama instance RAM role. |
| RequestId | String | D9553E4C-6C3A-4D66-AE79-9835AF705639 | ID permintaan. |
| TotalCount | Integer | 1 | Total jumlah instans yang Anda coba ikat dengan instance RAM role. |
Contoh
Contoh permintaan
https://ecs.aliyuncs.com/?Action=AttachInstanceRamRole
&InstanceIds=["i-bp10ws62o04ubhvi****"]
&RamRoleName=testRamRoleName
&RegionId=cn-hangzhou
&<Common request parameters>Contoh respons sukses
XML format
<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 format
{
"RequestId": "D9553E4C-6C3A-4D66-AE79-9835AF705639",
"AttachInstanceRamRoleResults": {
"AttachInstanceRamRoleResult": [
{
"Message": "success",
"InstanceId": "i-bp10ws62o04ubhvi****",
"Code": "200"
}
]
},
"TotalCount": 1,
"FailCount": 0,
"RamRoleName": "testRamRoleName"
}Kode kesalahan
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Description |
| 400 | InvalidInstanceIds.Malformed | The specified instanceIds are not valid. | Pesan kesalahan yang dikembalikan karena parameter InstanceIds yang ditentukan tidak valid. |
| 404 | InvalidInstanceId.NotFound | The specified instanceId does not exist | Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar. |
| 403 | InvalidNetworkType.MismatchRamRole | Ram role cannot be applied to instances of Classic network type. | Pesan kesalahan yang dikembalikan karena instance RAM role hanya dapat digunakan untuk instans di VPC, bukan untuk instans di jaringan klasik. |
| 403 | InvalidUser.PassRoleForbidden | The RAM user does not have the privilege to pass a RAM role. | Pesan kesalahan yang dikembalikan karena RAM user tidak memiliki otorisasi untuk meneruskan RAM role. |
| 404 | InvalidRamRole.NotFound | The specified RAMRoleName does not exist. | Pesan kesalahan yang dikembalikan karena parameter RamRoleName yang ditentukan tidak ada. |
| 404 | InvalidRamRole.NotEcsRole | The specified ram role is not authorized for ecs, please check your role policy. | Pesan kesalahan yang dikembalikan karena RAM role yang ditentukan tidak memiliki otorisasi untuk menggunakan ECS. Periksa kebijakan role Anda. |
Untuk daftar kode kesalahan, kunjungi API Error Center.