Buat Kontainer

Operasi Create Container membuat kontainer baru di bawah akun yang ditentukan. Jika kontainer dengan nama yang sama sudah ada, operasi akan gagal.

Sumber daya kontainer mencakup metadata dan properti untuk kontainer tersebut. Ini tidak menyertakan daftar blob dalam kontainer.

Minta

Anda dapat membuat permintaan seperti yang Create Container ditunjukkan di sini. Kami menyarankan agar Anda menggunakan HTTPS. Nilai mycontainer Anda hanya dapat menyertakan karakter huruf kecil. Di URL, ganti myaccount dengan nama akun penyimpanan Anda.

Metode	Meminta URI	Versi HTTP
PUT	https://myaccount.blob.core.windows.net/mycontainer?restype=container	HTTP/1.1

Permintaan layanan penyimpanan yang ditimulasikan

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

Metode	Meminta URI	Versi HTTP
PUT	http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container	HTTP/1.1

Untuk informasi selengkapnya, lihat Gunakan emulator Azurite untuk pengembangan Microsoft Azure Storage lokal.

Parameter URI

Anda dapat menentukan parameter tambahan berikut pada URI permintaan.

Parameter	Deskripsi
timeout	Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi blob Storage.

Header permintaan

Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:

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 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-meta-name:value	Opsional. Pasangan nama-nilai untuk dikaitkan dengan kontainer sebagai metadata. Catatan: Pada versi 2009-09-19, nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C#.
x-ms-blob-public-access	Opsional. Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses. Nilai yang mungkin termasuk: - container: Menentukan akses baca publik penuh untuk data kontainer dan blob. Klien dapat menghitung blob dalam kontainer melalui permintaan anonim, tetapi mereka tidak dapat menghitung kontainer dalam akun penyimpanan. - blob: Menentukan 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 disertakan dalam permintaan, data kontainer bersifat pribadi bagi pemilik akun.
x-ms-client-request-id	Opsional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log Azure Monitor saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. Untuk informasi selengkapnya, lihat Memantau Azure Blob Storage.

Header permintaan (cakupan enkripsi)

Pada versi 2019-02-02, Anda dapat menentukan header berikut pada permintaan untuk mengatur cakupan enkripsi default pada kontainer. Jika Anda mengatur cakupan enkripsi, cakupan enkripsi secara otomatis digunakan untuk mengenkripsi semua blob yang diunggah ke kontainer.

Header permintaan	Deskripsi
x-ms-default-encryption-scope	Wajib diisi. Cakupan enkripsi untuk diatur sebagai default pada kontainer.
x-ms-deny-encryption-scope-override	Wajib diisi. Nilai adalah true atau false. Mengatur header ini untuk true memastikan bahwa setiap blob yang diunggah ke kontainer ini menggunakan cakupan enkripsi default. Ketika header ini adalah false, klien dapat mengunggah blob dengan cakupan enkripsi selain cakupan default.

Bodi permintaan

Tidak ada.

Contoh permintaan

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT  
x-ms-meta-Name: StorageSample  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 201 (Dibuat).

Untuk informasi tentang kode status, lihat Kode status dan kesalahan.

Header respons

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

Header respons	Deskripsi
ETag	ETag untuk kontainer. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag diapit dalam tanda kutip.
Last-Modified	Mengembalikan tanggal dan waktu saat kontainer terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Representasi nilai tanggal/waktu 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-request-id	Secara unik mengidentifikasi permintaan yang dibuat. Anda dapat menggunakannya untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API
x-ms-version	Menunjukkan versi Storage Blob yang digunakan untuk menjalankan permintaan. Header ini dikembalikan untuk permintaan yang dibuat terhadap versi 2009-09-19 atau yang lebih baru.
Date	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu dimulainya respons.
x-ms-client-request-id	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 berisi tidak lebih dari 1024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header tidak akan ada dalam respons.

Isi Respons

Tidak ada.

Respons sampel

Response status:  
HTTP/1.1 201 Created  
  
Response headers:  
Transfer-Encoding: chunked  
Date: Sun, 25 Sep 2011 23:00:12 GMT  
ETag: “0x8CB14C3E29B7E82”  
Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  

Authorization

Hanya pemilik akun yang dapat memanggil operasi ini.

Keterangan

Kontainer dibuat segera di dalam akun penyimpanan. Tidak dimungkinkan untuk menumpuk satu kontainer dalam kontainer lain.

Anda dapat secara opsional membuat kontainer default atau root untuk akun penyimpanan Anda. Kontainer akar memungkinkan untuk mereferensikan blob dari tingkat atas hierarki akun penyimpanan, tanpa mereferensikan nama kontainer.

Untuk menambahkan kontainer akar ke akun penyimpanan Anda, buat kontainer bernama $root. Buat permintaan sebagai berikut:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT  
x-ms-meta-Name: StorageSample  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Anda dapat menentukan metadata untuk kontainer saat membuatnya dengan menyertakan satu atau beberapa header metadata pada permintaan. Format untuk header metadata adalah x-ms-meta-name:value.

Jika kontainer dengan nama yang sama sedang dihapus saat Create Container dipanggil, server mengembalikan kode status 409 (Konflik), dan menyediakan informasi kesalahan tambahan yang menunjukkan bahwa kontainer sedang dihapus.

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Status dan kode galat
Kode kesalahan Storage blob
Kontainer nama dan referensi, blob, dan metadata
Mengatur dan mengambil properti dan metadata untuk sumber daya blob
Mengatur ACL Kontainer