ListTagsForResource - AWS Transfer Family

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

ListTagsForResource

Daftar semua tag yang terkait dengan Amazon Resource Name (ARN) yang Anda tentukan. Sumber daya dapat berupa pengguna, server, atau peran.

Sintaksis Permintaan

{ "Arn": "string", "MaxResults": number, "NextToken": "string" }

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

Arn

Meminta tag yang terkait dengan Nama Sumber Daya Amazon (ARN) tertentu. ARN adalah pengidentifikasi untuk AWS sumber daya tertentu, seperti server, pengguna, atau peran.

Jenis: String

Batasan Panjang: Panjang minimum 20. Panjang maksimum 1600.

Pola: arn:\S+

Wajib: Ya

MaxResults

Menentukan jumlah tag untuk kembali sebagai respon terhadap ListTagsForResource permintaan.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

Wajib: Tidak

NextToken

Ketika Anda meminta hasil tambahan dari ListTagsForResource operasi, NextToken parameter dikembalikan dalam input. Anda kemudian dapat meneruskan perintah berikutnya ke NextToken parameter untuk melanjutkan daftar tag tambahan.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 6144.

Wajib: Tidak

Sintaksis Respons

{ "Arn": "string", "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Arn

ARN yang Anda tentukan untuk mencantumkan tag.

Jenis: String

Batasan Panjang: Panjang minimum 20. Panjang maksimum 1600.

Pola: arn:\S+

NextToken

Ketika Anda bisa mendapatkan hasil tambahan dari ListTagsForResource panggilan, NextToken parameter dikembalikan dalam output. Anda kemudian dapat meneruskan perintah berikutnya ke NextToken parameter untuk melanjutkan daftar tag tambahan.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 6144.

Tags

Pasangan kunci-nilai yang ditugaskan ke sumber daya, biasanya untuk tujuan pengelompokan dan pencarian item. Tag adalah metadata yang Anda tentukan.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InternalServiceError

Pengecualian ini dilemparkan ketika kesalahan terjadi dalam AWS Transfer Family layanan.

Kode Status HTTP: 500

InvalidNextTokenException

NextTokenParameter yang dilewatkan tidak valid.

Kode Status HTTP: 400

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.

Kode Status HTTP: 500

Contoh

Contoh

Contoh berikut mencantumkan tag untuk sumber daya dengan ARN yang Anda tentukan.

Permintaan Sampel

{ "Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef" }

Contoh

Contoh ini menggambarkan salah satu penggunaan. ListTagsForResource

Contoh Respons

{ "Tags": [ { "Key": "Name", "Value": "MyServer" } ] }

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: