Anlık Görüntü Paylaşımı
2017-04-17 sürümünden Snapshot Share
itibaren işlem, paylaşımın salt okunur 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ı hakkında ayrıntılı bilgi 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 isteklerini 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 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ı. 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ıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırına sahip 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. Azure Blob Depolama'yı izleme. |
İ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 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 |
---|---|
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ü, 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 tarihi 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ştirme zamanı hiçbir zaman değişmez. Ancak, istekle birlikte Snapshot Share 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ığı sırada 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 opaktır. |
x-ms-client-request-id |
İsteklerin ve karşılık gelen yanıtların sorunlarını 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.
x-ms-client-request-id Üst bilgi istekte 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 başka işlemler gerçekleştirmek için bu DateTime
değeri kullanabilirsiniz. Bu DateTime
değeri donuk 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şturmaya çalışırsanız, 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 üst bilgiyi sorgu parametresiyle sharesnapshot
birlikte uygun değere ayarlayın.
NFS paylaşım anlık görüntülerini, genellikle paylaşım bağlama noktasının kökünde bulunan anlık görüntü sanal dizinini (.snapshot) kullanarak bir NFS istemcisinde görüntüleyebilirsiniz.
Paylaşım Özelliklerini Ayarla API'sinde x-ms-enable-snapshot-virtual-directory-access
üst bilgi false olarak ayarlanarak bu dizine erişim devre dışı bırakılabilir. Bu üst bilgiyi paylaşım oluşturma sırasında Paylaşım Oluştur işleminin bir parçası olarak da ayarlayabilirsiniz.