Hapus Tanda Dari Vault (POST tags remove)

Operasi ini menghapus satu tanda atau lebih dari serangkaian tanda yang dilampirkan ke vault. Untuk informasi selengkapnya tentang tanda, lihat Menandai Sumber Daya Amazon S3 Glacier.

Operasi ini bersifat idempoten. Operasi akan berhasil, meskipun tidak ada tanda yang dilampirkan ke vault.

Sintaks Permintaan

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

POST /AccountId/vaults/vaultName/tags?operation=remove HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
{
   "TagKeys": [
      "string",
      "string"
   ]
}

catatan

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

Parameter Permintaan

Nama	Deskripsi	Wajib
operation=remove	Parameter string kueri tunggal operation dengan nilai remove untuk membedakannya dari Menambahkan Tanda ke Vault (POST tag add).	Ya

Header Permintaan

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Header Permintaan Umum.

Isi Permintaan

Isi permintaan berisi bidang JSON berikut.

TagKeys

Daftar kunci tanda. Setiap tanda yang sesuai dihapus dari vault.

Tipe: Array string

Batasan panjang: Minimum 1 item dalam daftar. Maksimum 10 item dalam daftar.

Diperlukan: Ya

Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 No Content dengan isi HTTP kosong.

Sintaksis

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

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh Permintaan

Contoh berikut mengirimkan permintaan HTTP POST untuk menghapus tanda yang ditentukan.

POST /-/vaults/examplevault/tags?operation=remove HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01
			
{
   "TagsKeys": [
      "examplekey1",
      "examplekey2"
   ]        
}

Contoh Respons

Jika permintaan berhasil, Amazon S3 Glacier (S3 Glacier) mengembalikan HTTP 204 No Content seperti yang ditampilkan dalam contoh berikut.

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

Bagian Terkait

• Menambahkan Tanda ke Vault (POST tag add)

• Mencantumkan Tanda untuk Vault (GET tags)

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu dari SDK Amazon spesifik bahasa, lihat berikut ini:

• AWS Command Line Interface