DescribeInstanceRamRole - - Alibaba Cloud Documentation Center

Kueri role Resource Access Management (RAM) yang dilampirkan ke satu atau beberapa instans.

Deskripsi

Saat memanggil operasi API menggunakan Alibaba Cloud CLI, Anda harus menentukan nilai parameter permintaan dengan berbagai tipe data dalam format yang ditentukan. Untuk informasi selengkapnya, lihat Ikhtisar format parameter.

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 untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
Action	String	Ya	DescribeInstanceRamRole	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeInstanceRamRole.
PageNumber	Integer	Tidak	1	Nomor halaman yang akan dikembalikan. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	Tidak	10	Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 50. Nilai default: 10.
RegionId	String	Ya	cn-hangzhou	ID wilayah dari peran RAM instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
InstanceIds	String	Tidak	["i-bp67acfmxazb1p**", "i-bp67acfmxazb2p", "bp67acfmxazb3p**"…]	ID instans. Anda dapat menentukan hingga 100 ID instans dalam satu permintaan. Anda harus menentukan setidaknya salah satu parameter `InstanceIds` dan `RamRoleName`.
RamRoleName	String	Tidak	EcsServiceRole-EcsDocGuideTest	Nama peran RAM instans. Anda dapat memanggil operasi ListRoles yang disediakan oleh RAM untuk mengkueri peran RAM instans yang telah Anda buat. Anda harus menentukan setidaknya salah satu parameter `InstanceIds` atau `RamRoleName`.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID dari permintaan tersebut.
TotalCount	Integer	1	Jumlah total peran RAM instans yang dikembalikan.
RegionId	String	cn-hangzhou	ID wilayah dari peran RAM instans.
InstanceRamRoleSets	Array of InstanceRamRoleSet		Detail mengenai Peran RAM Instans.
InstanceRamRoleSet
RamRoleName	String	EcsServiceRole-EcsDocGuideTest	Nama peran RAM instans.
InstanceId	String	i-bp67acfmxazb4p****	ID instans

Contoh

Permintaan contoh

https://ecs.aliyuncs.com/?Action=DescribeInstanceRamRole
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb1p****", "i-bp67acfmxazb2p****", "bp67acfmxazb3p****"]
&PageNumber=1
&PageSize=1
&<Common request parameters>

Respons sukses contoh

XML format

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

<DescribeInstanceRamRoleResponse>
    <RequestId>8F4CAE3F-7892-4662-83A5-2C2FFD639553</RequestId>
    <InstanceRamRoleSets>
        <InstanceRamRoleSet>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <RamRoleName>EcsServiceRole-EcsDocGuideTest</RamRoleName>
        </InstanceRamRoleSet>
    </InstanceRamRoleSets>
    <TotalCount>1</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>1</PageSize>
</DescribeInstanceRamRoleResponse>

JSON format

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

{
  "RequestId" : "8F4CAE3F-7892-4662-83A5-2C2FFD639553",
  "InstanceRamRoleSets" : {
    "InstanceRamRoleSet" : [ {
      "InstanceId" : "i-bp67acfmxazb4p****",
      "RamRoleName" : "EcsServiceRole-EcsDocGuideTest"
    } ]
  },
  "TotalCount" : 1,
  "PageNumber" : 1,
  "PageSize" : 1
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidInstanceIds.Malformed	The specified instanceIds are not valid.	Pesan kesalahan yang dikembalikan karena parameter InstanceIds yang ditentukan tidak valid.
500	InternalError	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Pesan kesalahan yang dikembalikan karena role RAM instans hanya dapat digunakan untuk instans di virtual private cloud (VPC), bukan untuk instans di jaringan klasik.
403	InvalidParameter.AllEmpty	%s	Pesan kesalahan yang dikembalikan karena parameter yang diperlukan tidak ditentukan.
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.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.