Blob Süre Sonunu Ayarla

  • Makale

İşlem, Set Blob Expiry mevcut blob üzerinde bir sona erme tarihi ayarlar. Bu işleme yalnızca hiyerarşik ad alanı etkin hesaplarda izin verilir. Hizmet sürümü 2020-02-10 ve üzeri için geçerlidir.

İstek

İstek Set Blob Expiry aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

PUT yöntemi istek URI'si HTTP sürümü
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=expiry HTTP/1.1

Öykünülmüş Depolama Hizmeti URI'si

Öykünülen depolama hizmetine karşı istekte bulunulduğunda ö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:

PUT yöntemi istek URI'si HTTP sürümü
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=expiry 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. Kimlik doğrulama düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için kimlik doğrulaması .
Date veya 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 hizmetleri için kimlik doğrulaması.
x-ms-version Kimliği doğrulanmış tüm 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-lease-id:<ID> Blob etkin bir kiraya sahipse gereklidir. Etkin kiralaması olan bir blobda bu işlemi gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin.
x-ms-expiry-option Gereklidir. İsteğin sona erme tarihi seçeneğini belirtmek için bkz . ExpirationyOption.
x-ms-expiry-time İsteğe bağlı. Dosyanın süresinin dolmak üzere ayarlandığı saat. Süre sonu tarihi biçimi'ne x-ms-expiry-optiongöre değişir. Daha fazla bilgi için bkz . ExpiryOption.
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.

Süre SonuSeçenek

Aşağıdaki değerleri üst x-ms-expiry-option bilgi olarak gönderebilirsiniz. Bu üst bilgi büyük/küçük harfe duyarlı değildir.

Süre sonu seçeneği Description
RelativeToCreation Süre sonu tarihini dosya oluşturma zamanına göre ayarlar. x-ms-expiry-time oluşturma zamanından itibaren geçmesi gereken milisaniye sayısı olarak belirtilmelidir.
RelativeToNow Son kullanma tarihini geçerli saate göre ayarlar. x-ms-expiry-time şu anda geçmesi gereken milisaniye sayısı olarak belirtilmelidir.
Absolute x-ms-expiry-time rfc 1123 biçiminde mutlak saat olarak belirtilmelidir.
NeverExpire Dosyanın süresi hiçbir zaman dolmeyecek şekilde ayarlar veya geçerli son kullanma tarihini kaldırır. x-ms-expiry-time belirtilmemiş olmalıdır.

İstek gövdesi

Bu isteğin istek gövdesi boş.

Örnek istek

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=expiry HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: Sun, 25 Sep 2020 14:37:35 GMT
x-ms-expiry-option: RelativeTonow
x-ms-expiry-time: 30000  
Authorization: SharedKey myaccount:J4ma1VuFnlJ7yfk/Gu1GxzbfdJloYmBPWlfhZ/xn7GI=

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 200 (Tamam) durum kodunu döndürür.

Durum kodları hakkında daha fazla 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
ETag Dosyanın sürümünü temsil eden bir değer içerir. Değer tırnak içine alınır.
Last-Modified Dizinin en son değiştirildiği tarihi 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ğerlerini temsil edin. Dizini veya özelliklerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Dosyalardaki işlemler dizinin son değiştirilme zamanını etkilemez.
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 İsteği yürütmek için kullanılan Blob Depolama sürümünü gösterir.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.

Örnek yanıt

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sun, 25 Sep 2011 23:47:09 GMT  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Yetkilendirme

Azure Depolama'da herhangi bir veri erişimi işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Set Blob Expiry 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ı Set Blob Expiry 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

Blobda sona erme tarihi ayarlama semantiği aşağıdaki gibidir:

  • Set Expiry dizinde değil, yalnızca bir dosyada ayarlanabilir.
  • Set Expiry expiryTime ile geçmişte bir'e izin verilmez.
  • ExpiryTime değeriyle expiryOptionNeverbelirtilemiyor.

Not

Süresi dolmuş bir dosya blob geçici silme özelliği kullanılarak geri yüklenemez. Hesap için geçici silmeyi etkinleştirmiş olsanız bile süresi dolan bir dosya, süresi dolduğunda geçici olarak silinen bloba dönüşmüyor. Yalnızca silinen dosyalar geçici olarak silinen dosyalara dönüşebilir.

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 Set Blob Expiry faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blob Süre Sonunu Ayarla Premium blok blobu
Standart genel amaçlı v2		 Diğer işlemler
Blob Süre Sonunu Ayarla Standart genel amaçlı v1 Yazma işlemleri

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

Ayrıca bkz.