**Halaman ini hanya untuk pelanggan lama layanan Amazon Glacier menggunakan Vaults dan REST API asli dari 2012.**

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas [penyimpanan Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan [Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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

# Menambahkan Tanda ke Vault (POST tag add)
<a name="api-AddTagsToVault"></a>

Operasi ini menambahkan tanda tertentu ke vault. Setiap tanda terdiri dari kunci dan nilai. Setiap vault dapat memiliki hingga 50 tanda. Jika permintaan Anda akan menyebabkan batas tanda untuk vault terlampaui, operasi melempar kesalahan `LimitExceededException`.

Jika tanda sudah ada di vault di bawah kunci tertentu, nilai kunci yang ada akan ditimpa. Untuk informasi selengkapnya tentang tanda, lihat [Menandai Sumber Daya Amazon Glacier](tagging.md).

## Sintaks Permintaan
<a name="api-AddTagsToVault-requestSyntax"></a>

Untuk menambahkan tag ke vault, kirim permintaan HTTP POST ke tag URI seperti yang ditunjukkan dalam contoh sintaks berikut.

```
 1. POST /AccountId/vaults/vaultName/tags?operation=add HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.    "Tags": 
10.       {
11.          "string": "string",
12.          "string": "string"
13.       }        
14. }
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '`-`' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

## Parameter Permintaan
<a name="api-AddTagsToVault-requestParameters"></a>


|  Nama  |  Deskripsi  |  Wajib  | 
| --- | --- | --- | 
|  operation=add  |  Parameter string kueri tunggal `operation` dengan nilai `add` untuk membedakannya dari [Hapus Tanda Dari Vault (POST tags remove)](api-RemoveTagsFromVault.md).  |  Ya  | 

### Header Permintaan
<a name="api-AddTagsToVault-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

### Isi Permintaan
<a name="api-AddTagsToVault-requests-elements"></a>

Isi permintaan berisi bidang JSON berikut.

 

**Tag**  
Tanda untuk ditambahkan ke vault. Setiap tanda terdiri dari kunci dan nilai. Nilai bisa string kosong.  
 *Tipe:* Peta String ke String   
 *Panjang batasan:* Panjang minimum 1. Panjang maksimum 10.  
 *Wajib*: Ya 

## Respons
<a name="api-AddTagsToVault-responses"></a>

Jika permintaan operasi berhasil, layanan mengembalikan respons `204 No Content` HTTP.

### Sintaksis
<a name="api-AddTagsToVault-response-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Header Respons
<a name="api-AddTagsToVault-responses-headers"></a>

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).

### Isi Respons
<a name="api-AddTagsToVault-responses-elements"></a>

Operasi ini tidak mengembalikan isi respons.

### Kesalahan
<a name="api-AddTagsToVault-responses-errors"></a>

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)

## Contoh
<a name="api-AddTagsToVault-examples"></a>

### Contoh Permintaan
<a name="api-AddTagsToVault-example-request"></a>

Contoh berikut mengirimkan permintaan HTTP POST dengan tanda untuk ditambahkan ke vault.

```
 1. POST /-/vaults/examplevault/tags?operation=add HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 5. Content-Length: length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Tags": 
10.     {
11.        "examplekey1": "examplevalue1",
12.        "examplekey2": "examplevalue2"
13.     }        
14. }
```

### Contoh Respons
<a name="api-AddTagsToVault-example-response"></a>

Jika permintaan berhasil Amazon Glacier mengembalikan seperti `HTTP 204 No Content` yang ditunjukkan pada contoh berikut.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## Bagian Terkait
<a name="related-sections-AddTagsToVault"></a>

 
+ [Mencantumkan Tanda untuk Vault (GET tags)](api-ListTagsForVault.md)

 
+ [Hapus Tanda Dari Vault (POST tags remove)](api-RemoveTagsFromVault.md)

## Lihat Juga
<a name="api-AddTagsToVault-SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu Amazon khusus bahasa SDKs, lihat berikut ini:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/add-tags-to-vault.html)