Anlık Görüntü Paylaşımı

2017-04-17 sürümünden Snapshot Share itibaren işlem, paylaşımın salt okunur bir anlık görüntüsünü oluşturur.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü	Kullanılabilir	Durum
SMB		GA
NFS		GA

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Snapshot Share . HTTPS önerilir.

Yöntem	İstek URI'si	HTTP sürümü
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot	HTTP/1.1

İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:

Yol bileşeni	Description
myaccount	Depolama hesabınızın adı.
myshare	Dosya paylaşımınızın adı.

Yol adlandırma kısıtlamalarıyla ilgili ayrıntılar için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma.

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. Azure Dosyalar 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 veya x-ms-date	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) saatini 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. 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ı. Paylaşım anlık görüntüsüyle ilişkili kullanıcı tanımlı, ad-değer çiftini belirtir. Herhangi bir ad-değer çifti belirtmezseniz, işlem temel paylaşım meta verilerini anlık görüntüye kopyalar. Bir veya daha fazla ad-değer çifti belirtirseniz, paylaşım anlık görüntüsü belirtilen meta verilerle oluşturulur. Bu durumda meta veriler temel paylaşımdan kopyalanır. Meta veri adları , C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
x-ms-client-request-id	İsteğe bağlı. Günlüğe kaydetme yapılandırılırken 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.

İstek gövdesi

Yok.

Örnek istek

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1

Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 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 ü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	Paylaşım anlık görüntüsünün sürümünü tırnak içinde temsil eden bir değer içerir. Paylaşım anlık görüntüsü değiştirilemez, bu nedenle ETag belirli bir paylaşım anlık görüntüsünün hiçbir zaman değişmemesi. Ancak, istekle Snapshot Share birlikte yeni meta veriler sağladıysanız, ETag paylaşım anlık görüntüsü temel paylaşımınkinden farklıdır. İstekle herhangi bir meta veri belirtmediyseniz, ETag paylaşım anlık görüntüsünün değeri, paylaşım anlık görüntüsü alındığı sırada temel paylaşımınkiyle aynıdır.
Last-Modified	Paylaşımın son değiştirildiği tarih ve saati döndürür. Daha fazla bilgi için bkz . Üst bilgilerde tarih-saat değerlerinin gösterimi. Paylaşım anlık görüntüsü değiştirilemez, bu nedenle belirli bir paylaşım anlık görüntüsünün son değiştirilme zamanı hiçbir zaman değişmez. Ancak, istekle Snapshot Share birlikte yeni meta veriler sağladıysanız, paylaşım anlık görüntüsünün son değiştirme zamanı temel paylaşımınkinden farklıdır. İstekle herhangi bir meta veri belirtmediyseniz, paylaşım anlık görüntüsünün son değiştirme zamanı, paylaşım anlık görüntüsünün alındığı zamandaki temel paylaşımınkiyle aynıdır.
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 Azure Dosyalar sürümünü gösterir.
Date veya x-ms-date	Yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. Hizmet bu değeri oluşturur.
x-ms-snapshot	DateTime Paylaşım anlık görüntüsünü benzersiz olarak tanımlayan bir değer. Paylaşım anlık görüntüsüne erişmek için sonraki isteklerde bu üst bilginin değerini kullanabilirsiniz. Bu değer donuk.
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.

Örnek yanıt

Response Status:
HTTP/1.1 201 Created

Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Yetkilendirme

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Paylaşım anlık görüntüleri, paylaşımların salt okunur sürümlerini sağlar. Paylaşım anlık görüntüsünü oluşturduktan sonra değiştiremezsiniz. Paylaşım anlık görüntüsü, paylaşımdaki tüm dosyaların tutarlı bir yedeğini oluşturmak için kullanışlı bir yol sağlar.

İşlemi her çağırdığınızda Snapshot Share , paylaşım anlık görüntüsünü temel paylaşımına göre tanımlayan benzersiz DateTime bir değere sahip yeni bir paylaşım anlık görüntüsü oluşturulur. Paylaşım anlık görüntüsünde ve içeriğinde daha fazla işlem gerçekleştirmek için bu DateTime değeri kullanabilirsiniz. Bu DateTime değeri opak olarak değerlendirmelisiniz.

değeri, DateTime istek URI'sinde paylaşım anlık görüntüsünü tanımlar. Örneğin, temel paylaşımdaki bir dosya ve anlık görüntüleri aşağıdaki örneklere benzer URI'lere sahiptir:

• Paylaşımdaki dosya: http://myaccount.file.core.windows.net/myshare/myfile
• Paylaşım anlık görüntüsündeki dosya: http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Paylaşım, 200 paylaşım anlık görüntüsünün oluşturulmasını destekleyebilir. 200'den fazla paylaşım anlık görüntüsü oluşturmayı denerseniz, hizmet hata kodu 409 (Çakışma) döndürür. Önceki Snapshot Share bir işlem devam ederken paylaşım anlık görüntüsü oluşturmayı denerseniz, hizmet 409 (Çakışma) hata kodunu da döndürür.

Mevcut paylaşım anlık görüntülerinin üzerine hiçbir zaman yazılmaz. Bunlar açıkça silinmelidir. Paylaşım anlık görüntülerini açıkça silmek için Paylaşımı Sil'i çağırın x-ms-include-snapshots ve sorgu parametresiyle sharesnapshot birlikte üst bilgiyi uygun değere ayarlayın.