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 JSON format.
- Arn
-
Amazon Resource Name (ARN) 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
- Tags
-
Pasangan nilai kunci yang ditetapkan untuk ARNs 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 HTTP tubuh 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.
HTTPKode Status: 500
- InvalidRequestException
-
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
HTTPKode Status: 400
- ResourceNotFoundException
-
Pengecualian ini dilemparkan ketika sumber daya tidak ditemukan oleh layanan AWS Transfer Family.
HTTPKode Status: 400
- ServiceUnavailableException
-
Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.
HTTPKode Status: 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 ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
