All Products
Search
Document Center

Key Management Service:ListTagResources

Last Updated:Dec 21, 2025

Mengambil tag dari suatu kunci atau rahasia.

Deskripsi operasi

Untuk detail kebijakan izin yang perlu diberikan kepada pengguna RAM atau peran RAM guna memanggil OpenAPI ini, lihat Access Control.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah dari resource tersebut.

Catatan

Anda dapat memanggil DescribeRegions untuk menanyakan daftar wilayah terbaru.

cn-hangzhou

NextToken

string

No

Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru.

Catatan

Jika pemanggilan tidak mengembalikan semua entri hasil, nilai parameter NextToken akan dikembalikan. Secara default, 200 baris dikembalikan. Anda dapat memanggil operasi ini lagi dan mengatur nilai parameter tersebut ke nilai yang dikembalikan pada pemanggilan sebelumnya untuk menerapkan kueri berhalaman.

caeba0bbb2be03f84eb48b699f0a4883

ResourceType

string

Yes

Tipe resource yang tag-nya ingin Anda tanyakan. Nilai yang valid:

  • key

  • secret

key

ResourceId

array

No

Daftar ID resource yang tag-nya ingin Anda tanyakan. Anda dapat memasukkan maksimal 50 ID resource.

Masukkan beberapa ID resource dalam format ["ResourceId. 1","ResourceId. 2",...].

string

No

ID resource yang tag-nya ingin Anda tanyakan. Anda dapat memasukkan maksimal 50 ID resource.

Masukkan beberapa ID resource dalam format ["ResourceId. 1","ResourceId. 2",...].

key-hzz62f1cb66fa42qo****

Tag

array<object>

No

Daftar tag yang ingin Anda tanyakan. Nilai N yang valid: 1 hingga 20.

object

No

Key

string

No

Kunci dari tag tersebut. Sebuah tag terdiri dari pasangan kunci-nilai.

Anda dapat memasukkan hingga 20 tag. Masukkan beberapa tag dalam format [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

Catatan

Kunci tidak boleh diawali dengan aliyun atau acs:.

disk-encryption

Value

string

No

Nilai dari tag tersebut. Sebuah tag terdiri dari pasangan kunci-nilai.

Anda dapat memasukkan hingga 20 tag. Masukkan beberapa tag dalam format [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

true

Elemen respons

Element

Type

Description

Example

object

NextToken

string

Token paginasi. Token ini dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru.

  • Jika NextToken kosong ("NextToken": ""), berarti tidak ada halaman berikutnya.

  • Jika NextToken tidak kosong, diperlukan kueri berikutnya, dan nilainya adalah token yang digunakan untuk memulai kueri selanjutnya.

e71d8a535bd9cc11

RequestId

string

ID permintaan.

00827261-20B7-4562-83F2-4DF39876A45A

TagResources

object

TagResource

array<object>

Daftar tag.

object

ResourceType

string

Tipe resource tersebut.

key

TagValue

string

Nilai tag tersebut.

true

ResourceId

string

ID resource tersebut.

key-hzz62f1cb66fa42qo****

TagKey

string

Kunci tag tersebut.

disk-encryption

Contoh

Respons sukses

JSONformat

{
  "NextToken": "e71d8a535bd9cc11",
  "RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "key",
        "TagValue": "true",
        "ResourceId": "key-hzz62f1cb66fa42qo****",
        "TagKey": "disk-encryption"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 Duplicate.TagKey The specified tagKey is duplicate.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.
404 InvalidResourceId.NotFound The specified ResourceId is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.