Kapsayıcı Oluşturma

  • Makale

İşlem, Create Container belirtilen hesap altında yeni bir kapsayıcı oluşturur. Aynı ada sahip kapsayıcı zaten varsa işlem başarısız olur.

Kapsayıcı kaynağı, bu kapsayıcının meta verilerini ve özelliklerini içerir. Kapsayıcıdaki blobların listesini içermez.

İstek

İsteği burada gösterildiği gibi oluşturabilirsiniz Create Container . HTTPS kullanmanızı öneririz. Kapsayıcınızın adı yalnızca küçük harf karakterler içerebilir ve bu adlandırma kurallarına uyması gerekir. URL'de myaccount değerini depolama hesabınızın adıyla değiştirin.

Yöntem İstek URI'si HTTP sürümü
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Öykünülmüş depolama hizmeti isteği

Öykünülmüş depolama hizmetine yönelik bir istekte bulunurken öykünücü konak adını ve Blob Depolama bağlantı noktasını olarak 127.0.0.1:10000ve ardından öykünülen depolama hesabı adını belirtin.

Yöntem İstek URI'si HTTP sürümü
PUT http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

Daha fazla bilgi için bkz. Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz.

Parametre Açıklama
timeout İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
Date veya x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) saatini belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-meta-name:value İsteğe bağlı. Kapsayıcıyla meta veri olarak ilişkilendirilecek bir ad-değer çifti. Not: 2009-09-19 sürümünden itibaren meta veri adları C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
x-ms-blob-public-access İsteğe bağlı. Kapsayıcıdaki verilere genel olarak erişilip erişilemeyeceğini ve erişim düzeyini belirtir. Olası değerler şunlardır:

- container: Kapsayıcı ve blob verileri için tam genel okuma erişimini belirtir. İstemciler anonim istek yoluyla kapsayıcı içindeki blobları numaralandırabilir, ancak depolama hesabı içindeki kapsayıcıları numaralandıramaz.
- blob: Bloblar için genel okuma erişimini belirtir. Bu kapsayıcıdaki blob verileri anonim istekle okunabilir ancak kapsayıcı verileri kullanılamaz. İstemciler anonim istek aracılığıyla kapsayıcı içindeki blobları numaralandıramaz.

Bu üst bilgi isteğe dahil değilse, kapsayıcı verileri hesap sahibine özeldir.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Blob Depolama.

İstek üst bilgileri (şifreleme kapsamları)

2019-02-02 sürümünden itibaren, bir kapsayıcıda varsayılan şifreleme kapsamını ayarlamak için istekte aşağıdaki üst bilgileri belirtebilirsiniz. Bir şifreleme kapsamı ayarlarsanız, kapsayıcıya yüklenen tüm blobları şifrelemek için otomatik olarak kullanılır.

İstek üst bilgisi Açıklama
x-ms-default-encryption-scope Gereklidir. Kapsayıcıda varsayılan olarak ayarlanacağı şifreleme kapsamı.
x-ms-deny-encryption-scope-override Gereklidir. Değerler veya falseşeklindedirtrue. Bu üst bilgiyi bu kapsayıcıya true yüklenen her blob için varsayılan şifreleme kapsamının kullanıldığından emin olmak için ayarlayın. Bu üst bilgi olduğunda false, istemci varsayılan kapsam dışında bir şifreleme kapsamına sahip bir blobu karşıya yükleyebilir.

İstek gövdesi

Yok.

Örnek istek

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=

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 201 (Oluşturuldu) durum kodunu döndürür.

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı, aşağıdaki tabloda açıklanan üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Description
ETag Kapsayıcı için ETag. İstek sürümü 2011-08-18 veya üzeriyse, ETag değeri tırnak içine alınır.
Last-Modified Kapsayıcının en son değiştirildiği tarih ve saati döndürür. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz . Üst bilgilerde tarih/saat değerlerinin gösterimi.

Kapsayıcıyı veya kapsayıcının özelliklerini ya da meta verilerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Bloblardaki işlemler kapsayıcının son değiştirme zamanını etkilemez.
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar. İstekle ilgili sorunları gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme
x-ms-version İsteği yürütmek için kullanılan Blob Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 veya sonraki bir sürüme yapılan istekler için döndürülür.
Date Hizmet tarafından oluşturulan UTC tarih/saat değeri, yanıtın başlatıldığı saati gösterir.
x-ms-client-request-id İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa üst bilginin değerine x-ms-client-request-id eşittir ve değer 1024'ten fazla görünür ASCII karakteri içermez. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta üst bilgi bulunmaz.

Yanıt gövdesi

Yok.

Örnek yanıt

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

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Create Container verebilirsiniz.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra ID kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra ID kullanılmasını destekler. Microsoft Entra ID ile Azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra ID kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz. Microsoft Entra ID kullanarak bloblara erişimi yetkilendirme.

İzinler

Aşağıda, Microsoft Entra kullanıcı, grup, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Create Container için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

Kapsayıcılar depolama hesabının hemen içinde oluşturulur. Bir kapsayıcıyı başka bir kapsayıcının içine yerleştirmek mümkün değildir.

İsteğe bağlı olarak, depolama hesabınız için varsayılan veya kök kapsayıcı oluşturabilirsiniz. Kök kapsayıcı, kapsayıcı adına başvurmadan depolama hesabı hiyerarşisinin en üst düzeyinden bir bloba başvurmayı mümkün kılar.

Kök kapsayıcıyı depolama hesabınıza eklemek için adlı $rootbir kapsayıcı oluşturun. İsteği aşağıdaki gibi oluşturun:

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=

İstekte bir veya daha fazla meta veri üst bilgisi ekleyerek kapsayıcıyı oluştururken meta verileri belirtebilirsiniz. Meta veri üst bilgisinin biçimi şeklindedir x-ms-meta-name:value.

Çağrıldığında Create Container aynı ada sahip bir kapsayıcı siliniyorsa, sunucu 409 (Çakışma) durum kodunu döndürür ve kapsayıcının silindiğini belirten ek hata bilgileri sağlar.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Create Container faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Kapsayıcı Oluşturma Premium blok blobu
Standart genel amaçlı v2
Standart genel amaçlı v1		 Kapsayıcı işlemlerini listeleme ve İçerik Oluşturucu

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.

Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Blob Depolama hata kodları
Ad ve başvuru kapsayıcıları, bloblar ve meta veriler
Blob kaynakları için özellikleri ve meta verileri ayarlama ve alma
Kapsayıcı ACL'lerini ayarlama