Mendapatkan Properti Kontainer
Operasi mengembalikan Get Container Properties semua metadata dan properti sistem yang ditentukan pengguna untuk kontainer yang ditentukan. Data yang dikembalikan tidak menyertakan daftar blob kontainer.
Minta
Permintaan Get Container Properties dapat dibuat sebagai berikut. HTTPS disarankan. Ganti myaccount dengan nama akun penyimpanan Anda:
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
GET/HEAD |
https://myaccount.blob.core.windows.net/mycontainer?restype=container |
HTTP/1.1 |
URI layanan penyimpanan yang ditimulasikan
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:
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
GET/HEAD |
http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container |
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. |
Judul Permintaan
Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.
| Header Permintaan | Deskripsi |
|---|---|
Authorization |
Wajib diisi. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
Date or x-ms-date |
Wajib diisi. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
x-ms-lease-id: <ID> |
Opsional, versi 2012-02-12 dan yang lebih baru. Jika ditentukan, Get Container Properties hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini. Jika tidak ada sewa aktif atau ID tidak cocok, 412 (Precondition Failed) dikembalikan. |
| x-ms-version | Diperlukan untuk semua permintaan resmi, opsional untuk permintaan anonim. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage. |
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.
| Header respons | Deskripsi |
|---|---|
x-ms-meta-name:value |
Mengembalikan string yang berisi pasangan nama/nilai yang terkait dengan kontainer sebagai metadata. |
ETag |
Tag entitas untuk kontainer. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag akan berada dalam tanda kutip. |
Last-Modified |
Mengembalikan tanggal dan waktu kontainer terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Representasi Nilai Date-Time di Header. Setiap operasi yang memodifikasi kontainer atau properti atau metadatanya memperbarui waktu modifikasi terakhir. Operasi pada blob tidak memengaruhi waktu terakhir kontainer yang dimodifikasi. |
x-ms-lease-status: <locked | unlocked> |
Versi 2012-02-12 dan yang lebih baru. Status sewa kontainer. |
x-ms-lease-state: <available | leased | expired | breaking | broken> |
Versi 2012-02-12 dan yang lebih baru. Status sewa kontainer. |
x-ms-lease-duration: <infinite | fixed > |
Versi 2012-02-12 dan yang lebih baru, hanya ketika kontainer disewakan. Menentukan apakah sewa pada kontainer memiliki durasi tak terbatas atau tetap. |
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 |
Versi 2009-09-19 dan yang lebih baru. Menunjukkan versi blob service yang digunakan untuk menjalankan permintaan. Juga dikembalikan untuk permintaan anonim tanpa versi yang ditentukan jika kontainer ditandai untuk akses publik menggunakan blob service versi 2009-09-19. |
Date |
Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu dimulainya respons. |
x-ms-blob-public-access |
Versi 2016-05-31 dan yang lebih baru Menunjukkan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses. Nilai yang mungkin termasuk: kontainer: Menunjukkan akses baca publik penuh untuk data kontainer dan blob. Klien dapat menghitung blob dalam kontainer berdasarkan permintaan anonim, tetapi tidak dapat menghitung kontainer dalam akun penyimpanan. blob: Menunjukkan akses baca publik untuk blob. Data blob dalam kontainer ini dapat dibaca melalui permintaan anonim, tetapi data kontainer tidak tersedia. Klien tidak dapat menghitung blob dalam kontainer melalui permintaan anonim. Jika header ini tidak dikembalikan dalam respons, kontainer bersifat privat kepada pemilik akun. |
x-ms-has-immutability-policy |
Versi 2017-11-09 dan yang lebih baru. Menunjukkan apakah kontainer memiliki kebijakan yang tidak dapat diubah yang ditetapkan di dalamnya. Nilai adalah true jika ada kumpulan kebijakan, false jika tidak. |
x-ms-has-legal-hold |
Versi 2017-11-09 dan yang lebih baru. Menunjukkan apakah kontainer memiliki penahanan legal. Nilainya adalah true jika ada satu atau beberapa penahanan legal, false jika tidak. |
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.
Respons Sampel
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
x-ms-meta-Name: StorageSample
Date: Sun, 25 Sep 2016 12:43:08 GMT
ETag: "0x8CAFB82EFF70C46"
Last-Modified: Sun, 25 Sep 2016 10:42:18 GMT
x-ms-version: 2016-05-31
x-ms-blob-public-access: blob
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
Authorization
Jika daftar kontrol akses kontainer (ACL) diatur untuk mengizinkan akses anonim ke kontainer, klien apa pun dapat memanggil operasi ini. Jika kontainer bersifat privat, operasi ini dapat dilakukan oleh pemilik akun.
Keterangan
Tidak ada.