Kueri tag instans ApsaraDB RDS - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi ListTagResources untuk mengkueri tag yang terikat pada satu atau beberapa instans ApsaraDB RDS.

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	Wajib	Contoh	Deskripsi
Action	String	Yes	ListTagResources	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ListTagResources.
RegionId	String	Yes	cn-hangzhou	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
ResourceType	String	Yes	INSTANCE	Jenis resource. Tetapkan nilainya ke INSTANCE.
NextToken	String	No	212db86sca4384811e0b5e8707ec21345	Token yang diperlukan untuk mendapatkan hasil tambahan. Parameter ini tidak diperlukan dalam kueri pertama. Jika suatu kueri tidak mengembalikan semua hasil, pada kueri berikutnya Anda dapat menentukan token yang dikembalikan dari kueri sebelumnya untuk mendapatkan hasil tambahan.
ResourceId.N	String	No	rm-uf6wjk5*******	ID instans. Anda dapat mengkueri tag dari N instans sekaligus. Nilai N yang valid: 1 hingga 50. Catatan Anda harus menentukan setidaknya salah satu parameter ResourceId.N atau Tag.N.Key.
Tag.N.Key	String	No	testkey1	Kunci tag. Anda dapat mengkueri N kunci tag sekaligus. Nilai N yang valid: 1 hingga 20. Nilai parameter ini tidak boleh berupa string kosong. Catatan Anda harus menentukan setidaknya salah satu parameter ResourceId.N atau Tag.N.Key.
Tag.N.Value	String	No	testvalue1	Nilai tag yang terkait dengan kunci tag yang ditentukan. Anda dapat menentukan N nilai tag sekaligus. Nilai N yang valid: 1 hingga 20. Parameter ini boleh berupa string kosong.

Parameter respons

Parameter	Type	Contoh	Deskripsi
NextToken	String	212db86sca4384811e0b5e8707ec21345	Token yang diperlukan untuk mendapatkan hasil tambahan. Jika suatu kueri tidak mengembalikan semua hasil, pada kueri berikutnya Anda dapat memberikan token yang dikembalikan oleh kueri sebelumnya untuk mendapatkan hasil tambahan.
RequestId	String	47A514A1-4B77-4E30-B4C5-2A880650B3FD	ID permintaan.
TagResources	Array of TagResource		Informasi instans dan tag yang dikembalikan.
TagResource
TagValue	String	testvalue1	Nilai tag yang terkait dengan kunci tag yang ditentukan.
ResourceType	String	ALIYUN::RDS::INSTANCE	Jenis resource. Nilai `ALIYUN::RDS::INSTANCE` menunjukkan instans ApsaraDB RDS.
ResourceId	String	rm-uf6wjk5xxxxxxx	ID instans.
TagKey	String	testkey1	Kunci tag.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&<Common request parameters>

Contoh respons sukses

XML format

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

<ListTagResourcesResponse>
<TagResources>
    <TagResource>
        <ResourceType>ALIYUN::RDS::INSTANCE</ResourceType>
        <TagValue>testvalue1</TagValue>
        <ResourceId>rm-uf6wjk5xxxxxxx</ResourceId>
        <TagKey>testkey1</TagKey>
    </TagResource>
</TagResources>
<RequestId>47A514A1-4B77-4E30-B4C5-2A880650B3FD</RequestId>
</ListTagResourcesResponse>

JSON format

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

{
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "ALIYUN::RDS::INSTANCE",
      "TagValue" : "testvalue1",
      "ResourceId" : "rm-uf6wjk5xxxxxxx",
      "TagKey" : "testkey1"
    } ]
  },
  "RequestId" : "47A514A1-4B77-4E30-B4C5-2A880650B3FD"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.	Pesan kesalahan yang dikembalikan karena parameter Tag.N.Key dan ResourceId tidak boleh keduanya kosong.
400	InvalidParameter.ResourceType	The parameter ResourceType is invalid.	Pesan kesalahan yang dikembalikan karena nilai parameter ResourceType tidak valid.

Untuk daftar kode kesalahan lengkap, kunjungi API Error Center.