İkili Büyük Nesne Anlık Görüntüsünü Alma

  • Makale

İşlem, Snapshot Blob bir blobun salt okunur anlık görüntüsünü oluşturur.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Snapshot Blob . HTTPS önerilir. 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=snapshot HTTP/1.1

Öykünmüş depolama hizmeti URI'si

Öykünülen depolama hizmetine yönelik istekte bulunulduğunda öykünücü ana bilgisayar adını ve Azure Blob Depolama bağlantı noktasını olarak 127.0.0.1:10000belirtin ve ardından öykünülen hesap adını belirtin:

PUT yöntemi istek URI'si HTTP sürümü
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=snapshot 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 parametreyi 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

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 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 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. 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ı. Blobla ilişkilendirilmiş kullanıcı tanımlı, ad-değer çiftini belirtir. Herhangi bir ad-değer çifti belirtmezseniz, işlem temel blob meta verilerini anlık görüntüye kopyalar. Bir veya daha fazla ad-değer çifti belirtirseniz, anlık görüntü belirtilen meta verilerle oluşturulur ve meta veriler temel blobdan kopyalanır.

Sürüm 2009-09-19'la başlayarak meta veri adlarının C# tanımlayıcıları için adlandırma kurallarına uyması gerektiğini unutmayın. Daha fazla bilgi için bkz. Kapsayıcıları, blobları ve meta verileri adlandırma ve başvurma .
If-Modified-Since İsteğe bağlı. Bir DateTime değer. Blobun yalnızca belirtilen tarih/saatten sonra değiştirilmiş olması durumunda anlık görüntüsünü almak için bu koşullu üst bilgiyi belirtin. Temel blob değiştirilmediyse, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
If-Unmodified-Since İsteğe bağlı. Bir DateTime değer. Blobun anlık görüntüsünü almak için, yalnızca belirtilen tarih/saatten bu yana değiştirilmemişse bu koşullu üst bilgiyi belirtin. Temel blob değiştirildiyse, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
If-Match İsteğe bağlı. Bir ETag değer. ETag Yalnızca değeri belirtilen değerle eşleşiyorsa ETag blobun anlık görüntüsünü almak için bu koşullu üst bilgi için bir değer belirtin. Değerler eşleşmiyorsa, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
If-None-Match İsteğe bağlı. Bir ETag değer.

ETag Yalnızca değeri belirtilen değerle eşleşmiyorsa blobun ETag anlık görüntüsünü almak için bu koşullu üst bilgi için bir değer belirtin. Değerler aynıysa, Blob Depolama 412 (Önkoşul Başarısız) durum kodunu döndürür.
x-ms-encryption-scope İsteğe bağlı. İstek içeriğini şifrelemek için kullanılacak şifreleme kapsamını gösterir. Bu üst bilgi 2019-02-02 ve sonraki sürümlerde desteklenir.
x-ms-lease-id:<ID> İsteğe bağlı. Bu üst bilgiyi belirtirseniz, işlem yalnızca aşağıdaki koşulların her ikisi de karşılandığında gerçekleştirilir:

- Blob'un kirası şu anda etkin.
- İstekte belirtilen kira kimliği blobunkiyle eşleşir.

Bu üst bilgi belirtilirse ve bu koşullardan biri karşılanmazsa istek başarısız olur. İşlem Snapshot Blob 412 durum koduyla başarısız oluyor (Önkoşul Başarısız oldu).
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.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında, işlemi çalıştırmak için koşullu üst bilgilerin kullanımını da destekler. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek üst bilgileri (müşteri tarafından sağlanan şifreleme anahtarları)

2019-02-02 sürümünden başlayarak, müşteri tarafından sağlanan bir anahtarla bir blobu şifreleme isteğinde aşağıdaki üst bilgileri belirtebilirsiniz. Müşteri tarafından sağlanan anahtarla (ve ilgili üst bilgi kümesiyle) şifreleme isteğe bağlıdır. Blob daha önce müşteri tarafından sağlanan bir anahtarla şifrelendiyse, okuma işleminin başarıyla tamamlanması için bu üst bilgilerin isteğe eklenmesi gerekir.

İstek üst bilgisi Açıklama
x-ms-encryption-key Gereklidir. Base64 kodlu AES-256 şifreleme anahtarı.
x-ms-encryption-key-sha256 Gereklidir. Şifreleme anahtarının Base64 kodlamalı SHA256 karması.
x-ms-encryption-algorithm: AES256 Gereklidir. Şifreleme için kullanılacak algoritmayı belirtir. Bu üst bilginin değeri olmalıdır AES256.

İ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.

Syntax Description
x-ms-snapshot: <DateTime> Anlık görüntüyü benzersiz olarak tanımlayan bir DateTime değer döndürür. Bu üst bilginin değeri anlık görüntü sürümünü gösterir ve bunu anlık görüntüye erişmek için sonraki isteklerde kullanabilirsiniz. Bu değerin donuk olduğunu unutmayın.
ETag Anlık ETag görüntü. İstek sürümü 2011-08-18 veya üzeriyse, ETag değer tırnak içinde olacaktır. Anlık görüntünün yazılamayacağı için ETag belirli bir anlık görüntünün hiçbir zaman değişmediğini unutmayın. Bununla birlikte, ETag istekle birlikte yeni meta veriler sağlanırsa anlık görüntü temel blobunkinden Snaphot Blob farklı olacaktır. İstekle hiçbir meta veri belirtilmezse anlık görüntünün görüntüsü, ETag anlık görüntünün alındığı anda temel blobunkiyle aynı olur.
Last-Modified Anlık görüntünün son değiştirilme zamanı. Daha fazla bilgi için bkz . Üst bilgilerde tarih-saat değerlerinin gösterimi.

Anlık görüntünün yazılamayacağına dikkat edin, bu nedenle belirli bir anlık görüntünün son değiştirme zamanı hiçbir zaman değişmez. Ancak, istekle birlikte yeni meta veriler sağlanırsa anlık görüntünün son değiştirme zamanı temel blobunkinden Snaphot Blob farklı olacaktır. İstekle hiçbir meta veri belirtilmezse anlık görüntünün son değiştirme zamanı, anlık görüntünün alındığı zamandaki temel blobla aynı olur.
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 çalıştırmak için kullanılan Blob Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
Date Yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. Hizmet bu değeri oluşturur.
x-ms-request-server-encrypted: true/false Sürüm 2019-02-02 veya üzeri. İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse, bu üst bilginin değeri olarak ayarlanır true. Aksi takdirde, değer olarak falseayarlanır.
x-ms-encryption-key-sha256 Sürüm 2019-02-02 veya üzeri. İstek şifreleme için müşteri tarafından sağlanan bir anahtar kullandıysa döndürülür. İstemci, sağlanan anahtarı kullanarak isteğin içeriğinin başarıyla şifrelenmesini sağlayabilir.
x-ms-encryption-scope Sürüm 2019-02-02 veya üzeri. İstek bir şifreleme kapsamı kullandıysa döndürülür. İstemci, şifreleme kapsamı kullanılarak isteğin içeriğinin başarıyla şifrelenmesini sağlayabilir.
x-ms-version-id: <DateTime> Sürüm 2019-12-12 ve üzeri. Blobu benzersiz olarak tanımlayan opak DateTime bir değer döndürür. Bu üst bilginin değeri blobun sürümünü gösterir ve bloba erişmek için sonraki isteklerde bunu kullanabilirsiniz.
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. Değer en fazla 1.024 görünür ASCII karakterdir. İstekte x-ms-client-request-id üst bilgi yoksa yanıtta bulunmaz.

Yanıt gövdesi

Yok.

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 Snapshot Blob 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ı Snapshot Blob 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

Anlık görüntüler blobların salt okunur sürümlerini sağlar. Anlık görüntüyü oluşturduktan sonra okuyabilir, kopyalayabilir veya silebilirsiniz ancak değiştiremezsiniz.

Anlık görüntü, blob verilerini yedeklemek için kullanışlı bir yol sağlar. Bir blobu önceki bir sürüme geri yüklemek için, temel blobu anlık görüntüsüyle birlikte üzerine yazmak için Blobu Kopyala'yı çağırarak anlık görüntü kullanabilirsiniz.

Anlık görüntü oluşturduğunuzda, Blob Depolama anlık görüntüyü temel blobuyla ilgili olarak benzersiz olarak tanımlayan bir DateTime değer döndürür. Anlık görüntüde başka işlemler gerçekleştirmek için bu değeri kullanabilirsiniz. Bu DateTime değeri donuk olarak değerlendirmelisiniz.

değeri, DateTime URI'de anlık görüntüyü tanımlar. Örneğin, bir temel blob ve anlık görüntüleri aşağıdakine benzer URI'lere sahiptir:

  • Temel blob: http://myaccount.blob.core.windows.net/mycontainer/myblob

  • An -lık görüntü: http://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

İşlemi her çağırdığınızda Snapshot Blob benzersiz DateTime bir değerle yeni bir anlık görüntü oluşturduğunuzu unutmayın. Blob, istediğiniz sayıda anlık görüntüyü destekleyebilir. Mevcut anlık görüntülerin üzerine hiçbir zaman yazılmaz. Delete Blob'u çağırarak ve üst bilgiyi uygun değere ayarlayarak x-ms-include-snapshots bunları açıkça silebilirsiniz.

başarılı çağrısı Snapshot Blob yanıt üst bilgisinde x-ms-snapshot bir DateTime değer döndürür. Daha sonra bu DateTime değeri kullanarak belirli bir anlık görüntü sürümünde okuma, silme veya kopyalama işlemleri gerçekleştirebilirsiniz. Blob adından sonra belirterek ?snapshot=<DateTime> anlık görüntü için geçerli olan herhangi bir Blob Depolama işlemini çağırabilirsiniz.

Bir blobun anlık görüntüsünü oluşturduğunuzda, aşağıdaki sistem özellikleri anlık görüntüye aynı değerlerle kopyalanır:

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-Length

  • Cache-Control

  • Content-MD5

  • x-ms-blob-sequence-number (yalnızca sayfa blobları için)

  • x-ms-blob-committed-block-count (yalnızca ekleme blobları için)

  • x-ms-copy-id (sürüm 2012-02-12 ve üzeri)

  • x-ms-copy-status (sürüm 2012-02-12 ve üzeri)

  • x-ms-copy-source (sürüm 2012-02-12 ve üzeri)

  • x-ms-copy-progress (sürüm 2012-02-12 ve üzeri)

  • x-ms-copy-completion-time (sürüm 2012-02-12 ve üzeri)

  • x-ms-copy-status-description (sürüm 2012-02-12 ve üzeri)

Blob bir blok blobuysa, temel blob'un kaydedilmiş blok listesi de anlık görüntüye kopyalanır. Kaydedilmemiş bloklar kopyalanmamıştır.

Anlık görüntü blobu, anlık görüntü alınırken her zaman temel blobla aynı boyuttadır. Anlık görüntü blobunun Content-Length üst bilgisinin değeri, temel blobla aynı olacaktır.

İstekte üst bilgiyi belirterek x-ms-meta-name:value anlık görüntü için bir veya daha fazla yeni meta veri değeri belirtebilirsiniz. Bu üst bilgi belirtilmezse, temel blobla ilişkili meta veriler anlık görüntüye kopyalanır.

Temel blob ile ilişkili tüm etiketler anlık görüntüye kopyalanır. Anlık görüntü için yeni etiket değerleri ayarlamak mümkün değildir.

Blobun anlık görüntüsünü almak için istekte koşullu üst bilgiler belirtebilirsiniz ancak bir koşul karşılanırsa. Belirtilen koşul karşılanmazsa anlık görüntü oluşturulmaz. Hizmet 412 durum kodunu (Önkoşul Başarısız Oldu) ve karşılanmamış koşulla ilgili ek hata bilgilerini döndürür.

Temel blobun etkin bir kirası varsa, aşağıdaki koşullardan biri istek için geçerli olduğu sürece blobun anlık görüntüsünü alabilirsiniz:

  • Koşullu x-ms-lease-id üst bilgi belirtilir ve temel blob için etkin kira kimliği isteğe eklenir. Bu koşul, anlık görüntünün yalnızca kira etkinse ve belirtilen kira kimliği blobla ilişkilendirilmiş olanla eşleşiyorsa oluşturulduğunu belirtir.

  • Üst x-ms-lease-id bilgi hiç belirtilmez, bu durumda özel kullanımda yazma kirası yoksayılır.

Temel blobla ilişkili bir kiranın anlık görüntüye kopyalandığını unutmayın. Anlık görüntüler kiralanamaz.

Blobu Kopyala işlemini kullanarak bir temel blob kopyaladığınızda , temel blobun anlık görüntüleri hedef bloba kopyalanır. Bir hedef bloba kopya yazıldığında, hedef blobla ilişkili tüm anlık görüntüler adının altında olduğu gibi kalır.

Blobun önceki bir sürümünü geri yüklemek için bir anlık görüntü blobunu temel blobu üzerinden kopyalayabilirsiniz. Anlık görüntü kalır, ancak hem okunabilen hem de yazılabilir bir kopya ile temel blob'un üzerine yazılır.

Not

Anlık görüntünün tanıtılması, depolama kaynakları için ek ücret ödemez. Bunun nedeni blokların veya sayfaların anlık görüntü ile temel blob arasında paylaştırılmış olmasıdır.

REST 2019-12-12 sürümünden başlayarak anlık görüntüde blob katmanı ayarlayabilirsiniz. Bir katman kök blobda ayarlanırsa, tüm anlık görüntüler temel blobdan katmanı devralır. Arşivlenmiş blobda anlık görüntü alma işlemi başarısız olur. Bir nesnedeki katmanı açıkça ayarlamak, nesnenin tam boyutu için faturalamayla sonuçlanıyor. Katman kümesine sahip bir blobun anlık görüntüsünü almak, kök blobun ve anlık görüntünün tam kopya faturalaması ile sonuçlanacak. Blok blobu düzeyinde katmanlama hakkında ayrıntılı bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.

Azure Premium Depolama hesapları ile standart depolama hesapları arasında anlık görüntüler açısından birkaç fark vardır:

  • bir Premium Depolama hesabındaki sayfa blobu başına anlık görüntü sayısı 100 ile sınırlıdır. Bu sınır aşılırsa, Snapshot Blob işlem hata kodu 409 (Anlık Görüntü Sayısı Aşıldı) döndürür.

  • Bir Premium Depolama hesabındaki sayfa blobunun anlık görüntüsünü on dakikada bir alabilirsiniz. Bu hız aşılırsa, Snapshot Blob işlem hata kodu 409 (Anlık Görüntü İşlem Hızı Aşıldı) döndürür.

  • Blob Al'ı kullanarak bir Premium Depolama hesabındaki sayfa blobunun anlık görüntüsünü okuyamazsınız. Bu durumda, hizmet hata kodu 400 (Geçersiz İşlem) döndürür. Ancak, anlık görüntüde Blob Özelliklerini Al ve Blob Meta Verilerini Al'ı çağırabilirsiniz.

    Anlık görüntüyü okumak için Blobu Kopyala işlemini kullanarak hesaptaki başka bir sayfa blobuna anlık görüntü kopyalayabilirsiniz. Kopyalama işleminin hedef blobu mevcut anlık görüntülere sahip olmamalıdır. Hedef blobda anlık görüntüler varsa hata Copy Blob kodu 409 (SnapshotsPresent) döndürür.

Daha fazla bilgi için bkz. Azure Premium Depolama ile Blob Depolama işlemlerini kullanma.

Sürüm oluşturma etkinleştirildiğinde blobun anlık görüntüsünü oluşturmak da yeni bir sürüm oluşturur ve temel blobun önceki sürümünü kaydeder. parametresi blobun x-ms-version-id yeni sürümü için opak DateTime bir değer döndürür.

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

İşlem Depolama hesabı türü Faturalama kategorisi
İkili Büyük Nesne Anlık Görüntüsünü Alma Premium blok blobu
Standart genel amaçlı v2
Standart genel amaçlı v1		 Okuma işlemleri

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

Ayrıca bkz.

Blobun anlık görüntüsünü oluşturma

Azure Depolama'ya yönelik istekleri yetkilendirme

Durum ve hata kodları

Blob Depolama hata kodları