Membatalkan penghapusan Blob

Artikel
07/26/2022
3 menit untuk membaca

Operasi memulihkan Undelete Blob konten dan metadata blob yang dihapus sementara dan rekam jepret yang dihapus sementara terkait.

Batal hapus Blob hanya didukung pada versi 2017-07-29 atau yang lebih baru.

Minta

Permintaan Undelete Blob dapat dibuat sebagai berikut. HTTPS disarankan. Ganti myaccount dengan nama akun penyimpanan Anda:

URI Permintaan Metode PUT	Versi HTTP
`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=undelete`	HTTP/1.1

URI Layanan Storage Emulasi

Saat membuat permintaan terhadap layanan penyimpanan yang ditimulasi, tentukan nama host emulator dan port layanan Blob sebagai 127.0.0.1:10000, diikuti dengan nama akun penyimpanan yang ditimulasikan:

URI Permintaan Metode PUT	Versi HTTP
`http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=undelete`	HTTP/1.1

Untuk informasi selengkapnya, lihat Menggunakan Emulator Azure Storage untuk Pengembangan dan Pengujian.

Parameter URI

Parameter tambahan berikut dapat ditentukan pada URI permintaan.

Parameter	Deskripsi
`timeout`	Opsional. Parameter `timeout` dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur Batas Waktu untuk Operasi Blob Service.

Header Permintaan (Semua Jenis Blob)

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional untuk semua jenis blob.

Header Permintaan	Deskripsi
`Authorization`	Wajib diisi. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`Date` atau `x-ms-date`	Wajib diisi. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`x-ms-version`	Diperlukan untuk semua permintaan yang diotorisasi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
`x-ms-undelete-source`	Opsional. Versi 2020-08-04 dan yang lebih baru. Hanya untuk akun dengan akun yang diaktifkan Namespace Hierarkis. Jalur blob yang dihapus sementara untuk membatalkan penghapusan. Formatnya adalah `blobPath?deletionid=<id>`. Nama akun dan kontainer tidak disertakan dalam jalur. `DeletionId` adalah pengidentifikasi unik dari blob yang dihapus sementara. Ini dapat diambil dengan mencantumkan blob yang dihapus sementara dengan Daftar Blob REST API untuk akun yang diaktifkan Namespace Hierarkis. Jalur harus dikodekan persen.
`x-ms-client-request-id`	Opsional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 KiB yang dicatat dalam log analitik saat pengelogan analitik penyimpanan diaktifkan. Menggunakan header ini sangat direkomendasikan untuk mengkorelasi aktivitas sisi klien dengan permintaan yang diterima oleh server. Untuk informasi selengkapnya, lihat Tentang Storage Analytics Logging dan Azure Logging: Menggunakan Log untuk Melacak Permintaan Storage.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode Status

Operasi yang berhasil mengembalikan kode status 200 (OK).

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Sintaks	Deskripsi
`x-ms-request-id`	Header ini secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Pemecahan Masalah Operasi API.
`x-ms-version`	Menunjukkan versi blob service yang digunakan untuk menjalankan permintaan.
`Date`	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu dimulainya respons.
`x-ms-client-request-id`	Header ini dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai `x-ms-client-request-id` header jika ada dalam permintaan dan nilainya paling banyak 1024 karakter ASCII yang terlihat. `x-ms-client-request-id` Jika header tidak ada dalam permintaan, header ini tidak akan ada dalam respons.

Isi Respons

Tidak ada.

Authorization

Undelete Blob Operasi dapat dipanggil oleh pemilik akun, oleh siapa pun dengan Tanda Tangan Akses Bersama yang memiliki izin untuk menulis ke blob ini atau kontainernya, atau oleh prinsip keamanan yang diberi peran dengan tindakan.Microsoft.Storage/storageAccounts/blobServices/containers/write

Keterangan

Saat blob yang dihapus sementara tidak dihapus, blob dan rekam jepret terkait tersedia untuk operasi menggunakan API lain. Membatalkan penghapusan permintaan ke blob, membatalkan penghapusan blob yang dihapus sementara dan rekam jepret yang dihapus sementara terkait. Mencoba membatalkan penghapusan blob yang tidak dihapus sementara atau memiliki rekam jepret yang dihapus sementara akan berhasil tanpa perubahan apa pun.

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Status dan Kode Kesalahan Hapus Blob