Aracılığıyla paylaş

Kapsayıcıyı Geri Yükle

  • Makale

İş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ırcontainer.
comp Gereklidir. comp Parametre değeri olmalıdırundelete.
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'ya istekleri 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'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. 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 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.
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 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 ü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 .

Ö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 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, yönetilen kimlik 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 kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

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 İçerik Oluşturucu

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