All Products
Search

This Product

    Elastic Compute Service:ListTagResources

    Document Center

    Elastic Compute Service:ListTagResources

    Last Updated:Jun 12, 2026

    Mengkueri tag yang terikat pada satu atau beberapa Sumber daya ECS.

    Deskripsi operasi

    Deskripsi operasi

    Tentukan setidaknya satu dari parameter berikut di permintaan untuk menentukan objek kueri:

    • ResourceId.N

    • Tag.N (Tag.N.Key dan Tag.N.Value)

    • TagFilter.N

    Jika Anda menentukan pasangan parameter berikut secara bersamaan, tanggapan hanya berisi Sumber daya ECS yang memenuhi kedua kondisi:

    • Tag.N dan ResourceId.N

    • TagFilter.N dan ResourceId.N.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ecs:ListTagResources

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah tempat resource berada. Anda dapat memanggil DescribeRegions untuk melihat daftar wilayah Alibaba Cloud terbaru.

    cn-hangzhou
    RegionId

    string

    Yes

    资源所属的地域 ID，您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou
    NextToken

    string

    No

    Token yang digunakan untuk memulai kueri berikutnya.

    caeba0bbb2be03f84eb48b699f0a4883
    ResourceType

    string

    Yes

    Tipe Sumber daya. Nilai valid:

    • instance: Instance ECS.

    • disk: cloud disk.

    • snapshot: Snapshot.

    • image: image.

    • securitygroup: grup keamanan.

    • volume: volume penyimpanan.

    • eni: Elastic Network Interface (ENI).

    • ddh: host khusus.

    • ddhcluster: kluster host khusus.

    • keypair: pasangan kunci SSH.

    • launchtemplate: template peluncuran.

    • reservedinstance: Instans terjadwal.

    • snapshotpolicy: Kebijakan Snapshot otomatis.

    • elasticityassurance: jaminan elastisitas.

    • capacityreservation: reservasi kapasitas.

    • command: perintah Asisten Cloud.

    • invocation: hasil eksekusi perintah atau pengiriman file Asisten Cloud.

    • activation: Kode aktivasi Instans terkelola Asisten Cloud.

    • managedinstance: Instans terkelola Asisten Cloud.

    instance
    ResourceId

    array

    No

    ID Sumber daya ECS. Nilai valid N: 1 hingga 50.

    i-bp1j6qtvdm8w0z1o****

    string

    No

    ID Sumber daya ECS. Nilai valid N: 1 hingga 50.

    i-bp1j6qtvdm8w0z1o****
    Tag

    array<object>

    No

    Tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag yang digunakan untuk melakukan Pencarian tepat pada Sumber daya ECS. Panjang kunci tag harus 1 hingga 128 karakter. Nilai valid N: 1 hingga 20.

    Catatan penggunaan untuk parameter Tag.N:

    • Metode 1: Gunakan parameter ini untuk melakukan Pencarian tepat pada Sumber daya ECS yang memiliki tag tertentu terikat. Setiap tag terdiri dari pasangan kunci-nilai.

      • Jika Anda hanya menentukan Tag.N.Key, semua Sumber daya yang terkait dengan kunci tag tersebut akan dikembalikan.

      • Jika Anda hanya menentukan Tag.N.Value, error InvalidParameter.TagValue akan dikembalikan.

      • Jika Anda menentukan beberapa pasangan kunci-nilai tag secara bersamaan, hanya Sumber daya ECS yang cocok dengan semua pasangan kunci-nilai tag yang ditentukan akan dikembalikan.

    • Metode 2: Gunakan parameter ini untuk mengkueri Sumber daya di kelompok sumber daya non-default. Atur Key ke acs:rm:rgId dan atur Value yang sesuai ke ID kelompok sumber daya.

      • Jika Key diatur ke acs:rm:rgId, Value hanya dapat diatur ke ID kelompok sumber daya non-default. Jika Anda menentukan ID kelompok sumber daya default, Paket error akan dikembalikan.

      • Jika Key diatur ke acs:rm:rgId, Anda tidak dapat menentukan pasangan kunci-nilai tag lainnya. Jika Anda menggunakan beberapa parameter Tag.N untuk mengkueri Sumber daya berdasarkan kelompok sumber daya dan berdasarkan tag secara bersamaan, Paket error akan dikembalikan.

    TestKey
    Value

    string

    No

    Nilai tag yang digunakan untuk melakukan pencarian tepat pada resource ECS. Panjang nilai tag harus 1 hingga 128 karakter. Nilai valid N: 1 hingga 20.

    Catatan

    Jika Key=acs:rm:rgId, parameter ini hanya dapat diatur ke ID kelompok sumber daya, dan ID kelompok sumber daya tidak boleh merupakan kelompok sumber daya default.

    TestValue
    TagFilter

    array<object>

    No

    Aturan filter tag.

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.

    object

    No

    Aturan filter tag.

    TagValues

    array

    No

    Nilai tag yang digunakan untuk melakukan pencarian fuzzy pada Sumber daya ECS. Panjang nilai tag harus 1 hingga 128 karakter. Nilai valid N: 1 hingga 5. Untuk deskripsi data deret waktu, lihat deskripsi parameter TagFilter.N.TagKey.

    TestTagFilter

    string

    No

    Nilai tag yang digunakan untuk melakukan pencarian fuzzy pada Sumber daya ECS. Panjang nilai tag harus 1 hingga 128 karakter. Nilai valid N: 1 hingga 5. Untuk deskripsi data deret waktu, lihat deskripsi parameter TagFilter.N.TagKey.

    TestTagFilter
    TagKey

    string

    No

    Kunci tag yang digunakan untuk melakukan pencarian fuzzy pada Sumber daya ECS. Panjang kunci tag harus 1 hingga 128 karakter. Nilai valid N: 1 hingga 5.

    TagFilter.N digunakan untuk melakukan pencarian fuzzy pada Sumber daya ECS yang memiliki tag tertentu terikat. Setiap filter tag terdiri dari satu kunci dan satu atau lebih nilai. Pencarian fuzzy dapat memiliki latensi hingga 2 detik dan hanya mendukung skenario di mana jumlah Sumber daya setelah pemfilteran fuzzy kurang dari atau sama dengan 5.000.

    • Untuk melakukan pencarian fuzzy pada Sumber daya ECS berdasarkan kunci tag (TagFilter.N.TagKey), nilai tag (TagFilter.N.TagValues.N) harus kosong. Misalnya, untuk melakukan pencarian fuzzy pada Sumber daya ECS yang kunci tagnya adalah environment, Anda dapat mengatur TagFilter.1.TagKey ke env* (pencocokan awalan), *env* (pencocokan tengah), atau env (pencocokan tepat), dan TagFilter.1.TagValues harus kosong.

    • Untuk melakukan pencarian fuzzy pada Sumber daya ECS berdasarkan nilai tag (TagFilter.N.TagValues.N), kunci tag (TagFilter.N.TagKey) harus diatur ke nilai tepat. Misalnya, untuk melakukan pencarian fuzzy pada Sumber daya ECS yang kunci tagnya adalah env dan nilai tagnya adalah Produk, TagFilter.1.TagKey harus diatur ke nilai tepat env, dan TagFilter.1.TagValues.1 dapat diatur ke proc* (pencocokan awalan), *proc* (pencocokan tengah), atau proc (pencocokan tepat). Hanya satu metode pencarian yang dapat digunakan untuk TagKey yang sama. Jika beberapa metode pencarian ditentukan, metode pertama akan diutamakan.

    • Kunci tag memiliki hubungan AND. Hanya Sumber daya ECS yang cocok dengan semua kunci tag yang ditentukan akan dikembalikan.

    • Nilai tag di bawah kunci tag yang sama memiliki hubungan OR. Sumber daya ECS yang cocok dengan salah satu nilai tag yang ditentukan untuk sebuah kunci tag akan dikembalikan.

    Catatan

    Parameter TagFilter.N dan Tag.N tidak dapat digunakan secara bersamaan. Jika tidak, Paket error akan dikembalikan.

    env

    Elemen respons

    Element

    Type

    Description

    Example

    object

    NextToken

    string

    Token yang digunakan untuk memulai kueri berikutnya.

    caeba0bbb2be03f84eb48b699f0a4883
    RequestId

    string

    ID permintaan.

    484256DA-D816-44D2-9D86-B6EE4D5BA78C
    TagResources

    object

    TagResource

    array<object>

    Kumpulan Sumber daya dan tagnya, yang berisi informasi seperti ID Sumber daya, tipe Sumber daya, dan pasangan kunci-nilai tag.

    object

    TagValue

    string

    The tag value of the resource.

    TestValue
    ResourceType

    string

    The resource type. Valid values:

    • instance: ECS instance

    • disk: disk

    • snapshot: snapshot

    • image: image

    • securitygroup: security group

    • volume: storage volume

    • eni: ENI

    • ddh: dedicated host

    • ddhcluster: dedicated host cluster

    • keypair: SSH key pair

    • launchtemplate: launch template

    • reservedinstance: reserved instance

    • snapshotpolicy: automatic snapshot policy

    • elasticityassurance: elasticity assurance

    • capacityreservation: capacity reservation

    • command: Cloud Assistant command

    • invocation: Cloud Assistant command execution result

    • activation: activation code for a Cloud Assistant managed instance

    • managedinstance: Cloud Assistant managed instance

    instance
    ResourceId

    string

    The resource ID.

    i-bp1j6qtvdm8w0z1o****
    TagKey

    string

    The tag key of the resource.

    TestKey

    Contoh

    Respons sukses

    JSONformat

    {
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
  "TagResources": {
    "TagResource": [
      {
        "TagValue": "TestValue",
        "ResourceType": "instance",
        "ResourceId": "i-bp1j6qtvdm8w0z1o****",
        "TagKey": "TestKey"
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDefaultResourceGroup.NotSupported The specified parameter Tag is not support for default resource group.
    400 InvalidTag.NotSupported You can only specify Tag for either resource tag or resource group.
    400 NumberExceed.ResourceIds The ResourceIds parameter's number is exceed , Valid : 50.
    400 NumberExceed.Tags The Tags parameter's number is exceed , Valid : 20.
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
    400 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range.
    400 InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match.
    400 InvalidTagCount The specified tags are beyond the permitted range.
    400 Invalid.Scope The specified scope is invalid.
    400 InvalidTags.MalFormed The tags must be empty, when the tagFilters is not empty.
    500 ServiceUnavailable The service is unavailable, please try again later.
    500 InternalError The process of creating snapshot has failed due to some unknown error.
    403 PermissionDenied.TagOwnerBid The specified operator not have permission to set TagOwnerBid value.
    403 PermissionDenied.TagOwnerUid The specified operator not have permission to set TagOwnerUid value.
    403 PermissionDenied.Scope The specified operator not have permission to set Scope value.
    403 InvalidResourceId.NotSupported The specified ResourceId does not support tagging.
    403 NoPermission.Tag The operator is not permission for the tag.
    403 BothEmpty.TagsAndResources The specified Tags and ResourcesIds are not allow to both empty.
    403 PermissionDenied.TagsFuzzyQuery The specified operator has not permission to query fuzzy tags.
    403 NumberExceed.TagValues The number of the specified TagValues is beyond permitted range, the max is 5.
    403 InvalidFilter.Malformed The specified Filter is not valid.
    403 InvalidTagFilter.Malformed The specified TagFilter is not valid.
    403 Invalid.NextToken The specified NextToken is not valid.
    404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
    404 MissingParameter.ResourceIds The parameter - ResourceIds.N should not be null.
    404 MissingParameter.TagOwnerUid The parameter - TagOwnerUid should not be null.
    404 MissingParameter.TagOwnerBid The parameter - TagOwnerBid should not be null.
    404 MissingParameter.ResourceType The parameter - ResourceType should not be null.
    404 MissingParameter.Tags The parameter - Tags should not be null.
    404 MissingParameter.RegionId The parameter - RegionId should not be null.
    404 InvalidResourceId.NotFound The specified ResourceIds are not found in our records.
    404 InvalidResourceType.NotFound The ResourceType provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.