DetachInstanceRamRole - - Alibaba Cloud Documentation Center

Melepas role Resource Access Management (RAM) dari Instance ECS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DetachInstanceRamRole	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DetachInstanceRamRole.
RegionId	String	Yes	cn-hangzhou	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
RamRoleName	String	No	RamRoleTest	Nama instance RAM role. Anda dapat memanggil operasi ListRoles yang disediakan oleh RAM untuk mengkueri instance RAM role yang telah Anda buat.
InstanceIds	String	Yes	["i-bp67acfmxazb4p**", "i-bp67acfmxazb5p", "i-bp67acfmxazb6p**"…]	ID instans. Nilainya dapat berupa array JSON yang terdiri dari maksimal 100 ID instans. Pisahkan ID instans dengan koma (,).

Parameter respons

Parameter	Type	Example	Description
RamRoleName	String	RamRoleTest	Nama instance RAM role.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
TotalCount	Integer	1	Jumlah total instans tempat Anda mencoba melepas instance RAM role.
FailCount	Integer	0	Jumlah instans tempat pelepasan instance RAM role gagal dilakukan.
DetachInstanceRamRoleResults	Array of DetachInstanceRamRoleResult		Hasil pelepasan instance RAM role dari instans.
DetachInstanceRamRoleResult
Code	String	200	Menunjukkan apakah instance RAM role berhasil dilepas. Kode status 200 menandakan bahwa permintaan berhasil. Kode status lainnya menandakan bahwa permintaan gagal.
Message	String	Success	Menunjukkan apakah instance RAM role berhasil dilepas. Status Success menandakan bahwa permintaan berhasil. Kode status lainnya menandakan bahwa permintaan gagal. Untuk informasi selengkapnya, lihat bagian "Error codes" dalam topik ini.
InstanceId	String	i-bp67acfmxazb4p****	ID instans tempat Anda mencoba melepas instance RAM role.
Success	Boolean	true	Menunjukkan apakah instance RAM role berhasil dilepas.
InstanceRamRoleSets	Array of InstanceRamRoleSet		Instance RAM role dari instans.
InstanceRamRoleSet
RamRoleName	String	RamRoleTest	Nama instance RAM role.
InstanceId	String	i-bp67acfmxazb4p****	ID instans.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DetachInstanceRamRole
&InstanceIds=["i-bp67acfmxazb4p****", "i-bp67acfmxazb5p****", "i-bp67acfmxazb6p****"…]
&RegionId=cn-hangzhou
&RamRoleName=RamRoleTest
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DetachInstanceRamRoleResponse>
    <TotalCount>1</TotalCount>
    <DetachInstanceRamRoleResults>
        <DetachInstanceRamRoleResult>
            <Message>success</Message>
            <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
            <Code>200</Code>
            <InstanceRamRoleSets>
                <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
                <RamRoleName>RamRoleTest</RamRoleName>
            </InstanceRamRoleSets>
        </DetachInstanceRamRoleResult>
    </DetachInstanceRamRoleResults>
    <RequestId>14D5B163-CE6C-4489-B979-DBE5D0495A63</RequestId>
    <RamRoleName/>
    <FailCount>0</FailCount>
</DetachInstanceRamRoleResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "DetachInstanceRamRoleResults" : {
    "DetachInstanceRamRoleResult" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp16qng6jnvt6g7t****",
      "Code" : "200",
      "InstanceRamRoleSets" : {
        "InstanceId" : "i-bp16qng6jnvt6g7t****",
        "RamRoleName" : "RamRoleTest"
      }
    } ]
  },
  "RequestId" : "14D5B163-CE6C-4489-B979-DBE5D0495A63",
  "RamRoleName" : "",
  "FailCount" : 0
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidInstanceIds.Malformed	The specified instanceIds are not valid.	ID Instans yang ditentukan tidak valid.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Instance RAM role hanya dapat digunakan untuk instans di virtual private cloud (VPC), bukan untuk instans di jaringan klasik.
403	InvalidUser.PassRoleForbidden	The RAM user does not have the privilege to pass a RAM role.	RAM user tidak memiliki izin untuk meneruskan RAM role.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	ID instans yang ditentukan tidak ditemukan.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.