Aracılığıyla paylaş

Kapsayıcı Oluştur

İş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 harfli 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 İstenilen URI 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 bulunduğunuzda, öykünücü ana bilgisayar adını ve Blob Depolama bağlantı noktasını ve ardından öykünülen depolama hesabı adını olarak 127.0.0.1:10000belirtin.

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

Daha fazla bilgi için bkz.

URI parametreleri

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

Parametre Description
timeout Optional. Parametre timeout saniye cinsinden ifade edilir. Daha fazla bilgi için bkz.

İstek başlıkları

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

İstek başlığı Description
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz.
Date veya x-ms-date Gerekli. İstek için Eşgüdümlü Evrensel Saat (UTC) saatini belirtir. Daha fazla bilgi için bkz.
x-ms-version Tüm yetkili talepler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz.
x-ms-meta-name:value Optional. Kapsayıcıyla meta veri olarak ilişkilendirilecek bir ad-değer çifti. Not: Sürüm 2009-09-19 itibarıyla meta veri adlarının C# tanımlayıcıları için adlandırma kurallarına uyması gerekir.
x-ms-blob-public-access Optional. 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 aracılığıyla 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 istek aracılığıyla 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 Optional. Günlük kaydı yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinliklerini sunucunun aldığı isteklerle ilişkilendirmek için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz.

İstek üst bilgileri (şifreleme kapsamları)

Sürüm 2019-02-02 itibarıyla, kapsayıcıda varsayılan şifreleme kapsamı 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 başlığı Description
x-ms-default-encryption-scope Gerekli. Kapsayıcıda varsayılan olarak ayarlanacak şifreleme kapsamı.
x-ms-deny-encryption-scope-override Gerekli. Değerler true veya false. Bu üst bilginin ayarlanması, true bu kapsayıcıya yüklenen her blobun varsayılan şifreleme kapsamını kullanmasını sağlar. Bu üst bilgi olduğunda false, istemci varsayılan kapsam dışında bir şifreleme kapsamına sahip bir blobu karşıya yükleyebilir.

Önemli

Kapsayıcı olarak trueayarlandıysax-ms-deny-encryption-scope-override, şifreleme kapsamı veya müşteri tarafından sağlanan şifreleme anahtarları olmayan bloblarda bu kapsayıcı içinde güncelleştirmelere izin verilmez. Bu bloblar okunabilir durumda kalır ve kullanıcılar güncelleştirmeleri gerçekleştirmek için blobları kapsayıcıdan şifreleme kapsamı geçersiz kılma ilkesi olmayan bir bloba taşıyabilir.

İstek içeriği

Yok.

Numune isteği

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 başlıkları

Bu işlemin yanıtı, aşağıdaki tabloda açıklanan üst bilgileri içerir. Yanıt, ek standart HTTP başlıkları da içerebilir. Tüm standart başlıklar 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şaretleri 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 uygundur. Daha fazla bilgi için bkz: Başlıklarda tarih/saat değerlerinin gösterimi.

Kapsayıcıyı veya özelliklerini ya da meta verilerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Bloblar üzerindeki işlemler kapsayıcının son değiştirilme 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 sürümlere karşı yapılan istekler için döndürülür.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-client-request-id İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. Bu başlığın değeri, istekte mevcutsa başlığın değerine x-ms-client-request-id eşittir ve değer 1024'ten fazla görünür ASCII karakteri içermiyor. x-ms-client-request-id Üst bilgi istekte yoksa, üst bilgi yanıtta mevcut olmaz.

Yanıtın içeriği

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

Authorization

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

Önemli

Microsoft, Azure Depolama isteklerini yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanılmasını önerir. Microsoft Entra ID, Shared Key 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 bir güvenlik sorumlusuna izin vermek için Azure rol tabanlı erişim denetimini (Azure RBAC) kullanabilirsiniz. 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. Daha sonra belirteç, 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.

Permissions

Bir Microsoft Entra kullanıcısının, grubunun, yönetilen kimliğinin veya hizmet sorumlusunun işlemi çağırması için gereken RBAC eylemi Create Container ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü aşağıda listelenmiştir:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz.

Açıklamalar

Kapsayıcılar depolama hesabının içinde hemen oluşturulur. Bir kapsayıcıyı diğerinin 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=

Kapsayıcıyı oluştururken isteğe bir veya daha fazla meta veri üst bilgisi ekleyerek meta verileri belirtebilirsiniz. Meta veri başlığının biçimi şöyledir 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 gösteren ek hata bilgileri sağlar.

Billing

Fiyatlandırma istekleri, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından Blob Depolama API'lerini kullanan istemcilerden kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk ettirir. İşlem türü, hesabın nasıl ücretlendirileceğini 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:

Operation Depolama hesabı türü Faturalama kategorisi
Kapsayıcı Oluştur Premium blok blobu
Standart Genel Amaçlı Versiyon 2
Standart genel amaçlı v1		 Listeleme ve Konteyner Oluşturma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz.

Ayrıca bakınız

Azure Depolama isteklerini yetkilendirme
Durum ve hata kodları
Blob Depolama hata kodları
Kapsayıcıları, blobları ve meta verileri adlandırma ve başvuru
Blob kaynakları için özellikleri ve meta verileri ayarlama ve alma
Kapsayıcı ACL'sini Ayarla

  • Last updated on