ListTagResources - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengkueri tag yang terikat ke sumber daya cloud.

Deskripsi operasi

Tentukan setidaknya ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value) dalam permintaan untuk menentukan objek kueri.
Tag.N adalah tag dari sumber daya dan terdiri dari pasangan kunci-nilai. Jika Anda hanya menentukan Tag.N.Key, semua nilai tag yang terkait dengan kunci tag akan dikembalikan. Jika Anda hanya menentukan Tag.N.Value, kesalahan akan dikembalikan.
Jika Anda menentukan kedua Tag.N dan ResourceId.N untuk memfilter tag, ResourceId.N harus cocok dengan semua pasangan kunci-nilai tag yang ditentukan.
Jika Anda menentukan beberapa pasangan kunci-nilai tag, hasil yang dikembalikan berisi sumber daya yang menyertakan semua pasangan kunci-nilai yang ditentukan.

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
ResourceType	string	Yes	Tipe sumber daya. Nilai yang valid: VPC: instans virtual private cloud (VPC). VSWITCH: instans virtual switch. ROUTETABLE: instans tabel rute. EIP: instans elastic IP address (EIP). VPNGATEWAY: instans VPN gateway. NATGATEWAY: instans NAT gateway. COMMONBANDWIDTHPACKAGE: instans Internet Shared Bandwidth. PREFIXLIST: instans prefix list. PUBLICIPADDRESSPOOL: instans IP address pool. IPV4GATEWAY: instans IPv4 gateway. IPV6GATEWAY: instans IPv6 gateway. NETWORKACL: instans network ACL. TRAFFICMIRRORFILTER: instans traffic mirror filter. TRAFFICMIRRORSESSION: instans traffic mirror session. FLOWLOG: instans flow log. HAVIP: instans high-availability virtual IP address (HAVIP). DHCPOPTIONSSET: instans DHCP options set. GATEWAYENDPOINT: instans gateway endpoint. IPV6ADDRESS: instans IPv6 address. Catatan Nilai tipe sumber daya tidak peka huruf besar-kecil.	VPC
NextToken	string	No	Token paginasi. Nilai yang valid: Jika ini adalah kueri pertama atau tidak ada kueri lanjutan, biarkan parameter ini kosong. Jika ada kueri lanjutan, atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	No	Jumlah entri per halaman. Nilai yang valid: 1 hingga 50. Nilai default: 50.	50
ResourceId	array	No	ID sumber daya. Anda dapat menentukan hingga 50 ID sumber daya.	vpc-bp16qjewdsunr41m1****
	string	No	ID sumber daya. Anda dapat menentukan hingga 50 ID sumber daya. Catatan Tentukan setidaknya ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value).	vpc-bp16qjewdsunr41m1****
RegionId	string	Yes	ID region sumber daya. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.	cn-hangzhou
Tag	array<object>	No	Informasi tag.	ListTagResources
	object	No	Kunci tag sumber daya.
Key	string	No	Kunci tag sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag dapat memiliki panjang hingga 128 karakter. Tidak boleh berupa string kosong atau dimulai dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`. Catatan Tentukan setidaknya ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value).	FinanceDept
Value	string	No	Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat memiliki panjang hingga 128 karakter. Boleh berupa string kosong tetapi tidak boleh dimulai dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`. Catatan Tentukan setidaknya ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value).	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
NextToken	string	Token paginasi. Nilai yang valid: Jika NextToken kosong, tidak ada kueri lanjutan. Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	ID permintaan.	DE65F6B7-7566-4802-9007-96F2494AC512
TagResources	object
TagResource	array<object>	Informasi tentang sumber daya yang terikat dengan tag.
	object	Informasi tentang sumber daya yang terikat dengan tag.
ResourceType	string	The type of the resource. Valid values: VPC: virtual private cloud (VPC) VSWITCH: vSwitch ROUTETABLE: route table EIP: EIP VpnGateWay: VPN gateway NATGATEWAY: NAT gateway COMMONBANDWIDTHPACKAGE: EIP bandwidth plan	VPC
TagValue	string	The tag value.	FinanceJoshua
ResourceId	string	The ID of the resource.	vpc-bp16qjewdsunr41m1****
TagKey	string	The tag key.	FinanceDept

Contoh

Respons sukses

JSONformat

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "DE65F6B7-7566-4802-9007-96F2494AC512",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "VPC",
        "TagValue": "FinanceJoshua",
        "ResourceId": "vpc-bp16qjewdsunr41m1****",
        "TagKey": "FinanceDept"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
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
400	Forbidden.TagKeys	The request do not allow to operate the tag keys
400	QuotaExceeded.TagNum	Custom Tags quota exceeded
400	Forbidden.NotAllowedCategary	The System tag is not valid
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.
400	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.
400	MissingParam.ResourceType	The param of ResourceType is missing.
403	Forbidden	User not authorized to operate on the specified resource.
403	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.