TagResource - AWS Transfer Family

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

TagResource

Melampirkan pasangan kunci-nilai ke sumber daya, seperti yang diidentifikasi oleh Amazon Resource Name (ARN). Sumber daya adalah pengguna, server, peran, dan entitas lainnya.

Tidak ada jawaban yang dikembalikan dari panggilan ini.

Sintaksis Permintaan

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

Parameter Permintaan

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

Permintaan menerima data berikut dalam format JSON.

Arn

Nama Sumber Daya Amazon (ARN) 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

Tags

Pasangan nilai kunci yang ditetapkan ke ARN yang dapat Anda gunakan untuk mengelompokkan dan mencari sumber daya berdasarkan jenis. Anda dapat melampirkan metadata ini ke sumber daya (server, pengguna, alur kerja, dan sebagainya) untuk tujuan apa pun.

Tipe: Array objek Tag

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

Diperlukan: Ya

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

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

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

Kode Status HTTP: 400

ResourceNotFoundException

Pengecualian ini dilemparkan ketika sumber daya tidak ditemukan oleh layanan AWS Transfer Family.

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.

Kode Status HTTP: 500

Contoh

Contoh

Contoh berikut menambahkan tag ke server berkemampuan protokol transfer file.

Permintaan Sampel

{ "Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef", "Tags": [ { "Key": "Group", "Value": "Europe" } ] }

Contoh

Contoh ini menggambarkan salah satu penggunaan. TagResource

Contoh Respons

HTTP 200 response with an empty HTTP body.

Lihat Juga

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