ListTagsForResource - AWS Transfer Family
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanContohLihat Juga

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 JSON format.

Arn

Meminta tag yang terkait dengan Amazon Resource Name (ARN) tertentu. An ARN adalah pengenal untuk AWS sumber daya tertentu, seperti server, pengguna, atau peran.

Tipe: 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.

Tipe: 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.

Data berikut dikembalikan dalam JSON format oleh layanan.

Arn

Yang ARN Anda tentukan untuk daftar tag.

Tipe: 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.

Tipe: 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.

HTTPKode Status: 500

InvalidNextTokenException

NextTokenParameter yang dilewatkan tidak valid.

HTTPKode Status: 400

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

HTTPKode Status: 400

ServiceUnavailableException

Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.

HTTPKode Status: 500

Contoh

Contoh

Contoh berikut mencantumkan tag untuk sumber daya dengan yang ARN 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 ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: