Kapsayıcıyı Geri Yükle

Makale
02/03/2024

İşlem, Restore Container geçici olarak silinen bir kapsayıcının içeriğini ve özelliklerini belirtilen bir kapsayıcıya geri yükler. İşlem Restore Container , sürüm ve sonraki sürümlerde 2019-12-12 kullanılabilir.

İstek

Paylaşılan anahtar, hesap paylaşılan erişim imzası yetkilendirmesi veya rol tabanlı erişim denetimi kullanılarak yetkilendirilmiş geçerli bir istek kullanarak isteği oluşturabilirsiniz Restore Container .

Yöntem	İstek URI'si	HTTP sürümü
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete`	HTTP/1.1
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete&sv=validsastoken`	HTTP/1.1

URI parametreleri

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

Parametre	Açıklama
`restype`	Gereklidir. `restype` Parametre değeri olmalıdır`container`.
`comp`	Gereklidir. `comp` Parametre değeri olmalıdır`undelete`.
`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

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadı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 isteklerini yetkilendirme.
`Date or x-ms-date`	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
`x-ms-version`	Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Bu işlem için sürümün veya üzeri olması `2018-03-28` gerekir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-client-request-id`	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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.
`x-ms-deleted-container-name`	Gereklidir. Geri yüklenmesi gereken geçici olarak silinen kapsayıcıyı benzersiz olarak tanımlamak için bu üst bilgiyi kullanırsınız.
`x-ms-deleted-container-version`	Gereklidir. Geri yüklenmesi gereken geçici olarak silinen kapsayıcıyı benzersiz olarak tanımlamak için bu üst bilgiyi kullanırsınız. İşlemin sorgu parametresinde `includeList Containers` değeri belirterek `deleted` bu değeri elde edebilirsiniz. Daha fazla bilgi için bkz. Kapsayıcıları Listeleme.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi 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 ü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
`x-ms-request-id`	Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
`x-ms-version`	Sürüm 2009-09-19 ve üzeri. İsteği çalıştırmak için kullanılan Azure Blob Depolama sürümünü gösterir.
`Date`	Yanıtın başlatıldığı saati gösteren utc tarih/saat değeri. Hizmet bu değeri oluşturur.
`Content-Length`	İstek gövdesinin uzunluğu. Bu işlem için içerik uzunluğu her zaman sıfırdır.

Yanıt gövdesi

Yok.

Örnek yanıt

Response Status:  
HTTP/1.1 201 OK  
  
Response Headers:  
Date: Mon, 15 Jun 2020 12:43:08 GMT  
x-ms-version: 2019-12-12  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemini çağırırken yetkilendirme gereklidir. İşlemi aşağıdaki bölümlerde açıklandığı gibi yetkilendirilebilirsiniz Restore Container .

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 güvenlik sorumlusuna izinler verilmektedir. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. Güvenlik sorumlusunun kimliği, OAuth 2.0 belirtecini döndürmek için Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob Depolama'ya 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

Microsoft Entra kullanıcı, grup veya hizmet sorumlusunun işlemi çağırması Restore Container ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü için aşağıdaki RBAC eylemleri gereklidir:

Azure RBAC eylemi: Microsoft.Storage/storageAccounts/blobServices/containers/write
En az ayrıcalıklı yerleşik rol: Depolama Blob Verileri Katkıda Bulunanı

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

Paylaşılan erişim imzası (SAS), depolama hesabındaki kaynaklara güvenli temsilci erişimi sağlar. SAS ile istemcinin verilere nasıl erişebileceği üzerinde ayrıntılı denetime sahipsiniz. İstemcinin erişebileceği kaynağı, bu kaynaklara hangi izinlere sahip olduğunu ve SAS'nin ne kadar süre geçerli olduğunu belirtebilirsiniz.

İşlem, Restore Container hesap SAS'sini kullanarak yetkilendirmeyi destekler.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hesap SAS belirtecine izin verilmez. Daha fazla bilgi edinmek için bkz. Paylaşılan Anahtara izin vermemeyenin SAS belirteçlerini nasıl etkilediğini anlama.

Hesap SAS'i

Bir hesap SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hesap SAS ise bir veya daha fazla depolama hizmetindeki kaynaklara erişim atar. Bir hizmet veya kullanıcı temsilcisi SAS aracılığıyla kullanılabilen tüm işlemler, hesap SAS'sı aracılığıyla da kullanılabilir.

Aşağıdaki tabloda, erişime ne zaman temsilci seçileceğini belirtmek için imzalı kaynak türü ve imzalı izinler gösterilir:

İşlem	İmzalı hizmet	İmzalı kaynak türü	İmzalı izin
Kapsayıcıyı Geri Yükle	Blob (b)	Kapsayıcı (c)	Yazma (w)

Hesap SAS'i hakkında daha fazla bilgi edinmek için bkz. Hesap SAS'ı oluşturma.

Açıklamalar

Depolama Kaynak Sağlayıcısı'nı kullanarak hesapta kapsayıcı silme bekletme ilkesini ayarlayabilirsiniz.
Belirtilen kapsayıcı, işlem gerçekleştirilirken Restore Container mevcut olmamalıdır.
Belirtilen kapsayıcı varsa, Restore Container işlem 409 (Çakışma) ile başarısız olur.
Geçici olarak silinen kapsayıcı yoksa, işlemin Restore Container kaynağı olarak zaten kullanılmışsa veya saklama günlerini aştıysa, işlem 409 (Çakışma) ile başarısız olur.

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 Restore Container faturalama kategorisi gösterilmektedir:

İşlem	Depolama hesabı türü	Faturalama kategorisi
Kapsayıcıyı Geri Yükle	Premium blok blobu Standart genel amaçlı v2 Standart genel amaçlı v1	Kapsayıcı işlemlerini listeleme ve oluşturma

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