DescribeTags - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengkueri daftar tag yang memenuhi kondisi filter yang ditentukan.

Deskripsi operasi

Tentukan setidaknya ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value) di permintaan untuk menentukan objek yang akan dikueri.
Tag.N adalah tag Sumber daya dan terdiri dari pasangan kunci-nilai. Jika Anda hanya menentukan Tag.N.Key, semua nilai tag yang terkait dengan kunci tag tersebut akan dikembalikan. Jika Anda hanya menentukan Tag.N.Value, error akan dikembalikan.
Jika Anda menentukan Tag.N dan ResourceId.N untuk memfilter tag, ResourceId.N harus cocok dengan salah satu pasangan kunci tag dan nilai tag yang ditentukan.
Jika Anda menentukan beberapa pasangan kunci-kunci tag, hasil akan berisi semua tag yang cocok dengan salah satu pasangan kunci-kunci tag tersebut.

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

vpc:DescribeTags

get

*全部资源

*

vpc:tag

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ResourceType	string	No	Tipe Sumber daya. Nilai valid: VPC: instans virtual private cloud (VPC). VSWITCH: instans vSwitch. ROUTETABLE: instans tabel rute. EIP: instans elastic IP address (EIP). VPNGATEWAY: instans Gateway VPN. NATGATEWAY: instans gerbang NAT. COMMONBANDWIDTHPACKAGE: instans Internet Shared Bandwidth. PREFIXLIST: instans daftar awalan. PUBLICIPADDRESSPOOL: instans kolam alamat IP. IPV4GATEWAY: instans gerbang IPv4. IPV6GATEWAY: instans gerbang IPv6. NETWORKACL: instans ACL jaringan. TRAFFICMIRRORFILTER: instans filter cermin Trafik. TRAFFICMIRRORSESSION: instans sesi cermin Trafik. FLOWLOG: instans Log aliran. HAVIP: instans alamat IP virtual ketersediaan tinggi. DHCPOPTIONSSET: instans set opsi DHCP. GATEWAYENDPOINT: instans titik akhir gerbang. Catatan Nilai tipe Sumber daya tidak peka huruf besar/kecil.	VPC
RegionId	string	Yes	ID wilayah Sumber daya. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
NextToken	string	No	Token pagination. Nilai valid: Jika ini adalah kueri pertama atau tidak ada kueri berikutnya, biarkan parameter ini kosong. Jika ada kueri berikutnya, atur parameter ini ke nilai NextToken yang dikembalikan oleh panggilan API sebelumnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResult	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 50. Nilai default: 50.	50
ResourceId	array	No	ID Sumber daya. Anda dapat menentukan hingga 50 ID Sumber daya.
	string	No	ID Sumber daya. Anda dapat menentukan hingga 50 ID Sumber daya. Catatan Saat Anda menentukan parameter ini, Anda juga harus menentukan parameter ResourceType.	vpc-bp16qjewdsunr41m1****
Tag	array<object>	No	Tag Sumber daya.
	object	No	Tag Sumber daya.
Key	string	No	Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh berupa string kosong atau diawali dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Panjang nilai tag dapat mencapai 128 karakter. Dapat berupa string kosong tetapi tidak boleh diawali dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object	objek.
NextToken	string	Token pagination. Nilai valid: Jika NextToken kosong, tidak ada kueri berikutnya. Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	ID permintaan.	C46FF5A8-C5F0-4024-8262-B16B639225A0
TagResources	object
TagResource	array<object>	Daftar semua tag yang memenuhi kondisi filter.
	object	Daftar tag.
TagValue	string	Nilai tag.	FinanceJoshua
TagKey	string	Kunci tag.	FinanceDept

Contoh

Respons sukses

JSONformat

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0",
  "TagResources": {
    "TagResource": [
      {
        "TagValue": "FinanceJoshua",
        "TagKey": "FinanceDept"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.	标签和资源组不能同时为空
400	MissingParameter.TagKey	The input parameter TagKey that is mandatory for processing this request is not supplied.	缺少参数TagKey
400	MissingParameter.TagValue	The input parameter TagValue that is mandatory for processing this request is not supplied.	缺少参数TagValue
400	InvalidTagKey	The tag keys are not valid.	无效的标签索引
400	InvalidTagValue	The tag values are not valid.	无效的标签值
400	MissingParam	%s
400	InvalidInstanceType.NotFound	The instance type is not found	实例类型没有找到
400	InvalidInstanceIds.NotFound	The instanceIds are not found	实例ID没有找到
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	没有权限操作TagKeys
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	quota超限
400	Forbidden.NotAllowedCategary	The System tag is not valid	系统tag无效
400	Forbidden.TagKey.Duplicated	The specified tag key already exists.	标签资源重复
400	SizeLimitExceeded.TagNum	The maximum number of tags is exceeded.	标签数量超限
400	SizeLimitExceeded.ResourceId	The maximum number of resource IDs is exceeded.	资源组ID数目超限
403	Forbidden	User not authorized to operate on the specified resource.	您没有权限操作指定资源，请申请权限后再操作。

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.