Paylaşımı Geri Yükle
İşlem, Restore Share daha önce geçici olarak silinmiş bir paylaşımı geri yükler (veya siler). Bu API tam olarak desteklenir, ancak eski bir yönetim API'sidir. Bunun yerine, depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanan Dosya Paylaşımları - Geri Yükleme'yi kullanın. Depolama kaynak sağlayıcısını kullanarak kaynaklarla FileShare program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. FileShares İşlemleri.
Paylaşım tüm verileri, meta verileri ve anlık görüntüleriyle birlikte geri yüklenir. Paylaşım kaynağı, paylaşımın meta verilerini ve özelliklerini içerir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Kullanılabilir |
|---|---|
| SMB |  |
| NFS |  |
İstek
İsteği aşağıdaki gibi oluşturabilirsiniz Restore Share . HTTPS önerilir.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
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ı. |
restoredShareName |
Geri yüklenen paylaşım için kullanılacak ad. Bu ada sahip bir paylaşım zaten varsa, işlem başarısız olur. |
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ı. Zaman aşımı 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. 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ı. |
x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) saatini 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-deleted-share-name |
Gereklidir. Geri yüklenecek geçici olarak silinen dosya paylaşımını tanımlar. Bu değer değeriyle restoredShareNameeşleşmelidir. |
x-ms-deleted-share-version |
Gereklidir. Geçici olarak silinen dosya paylaşımını sürümüne göre benzersiz olarak tanımlar. |
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. |
İstek gövdesi
Yok.
Örnek istek
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1
Request Headers:
x-ms-version: 2019-12-12
x-ms-deleted-share-name: myshare
x-ms-deleted-share-version: 01D2AC0C18EDFE36
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. Hedef dosya paylaşımı adı geçerli bir silinmemiş dosya paylaşımı tarafından kullanılıyorsa, istek 409 (Çakışma) ile başarısız olur. Kaynak dosya paylaşımı geçici olarak silinmediyse, zaten geri yüklenmişse veya kaynak dosya paylaşımı bekletme süresini geçmiş ve süresi dolmuşsa, istek 404 (Bulunamadı) ile başarısız olur.
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 |
Alıntılar halinde paylaşımın sürümünü temsil eden bir değer içerir. |
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ı veya özelliklerini ya da meta verilerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Dosyalardaki işlemler paylaşımın son değiştirme 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 çalıştırmak için kullanılan Azure Dosyalar 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. |
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 mevcutsa değerinin değerine x-ms-client-request-id headereşittir. Değer en fazla 1.024 görünür ASCII karakterdir. x-ms-client-request-id header isteğinde yoksa yanıtta bulunmaz. |
Yanıt gövdesi
Yok.
Örnek yanıt
Response Status:
HTTP/1.1 201 Created
Response Headers:
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000
x-ms-version: 2019-12-12
Content-Length: 0
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Yetkilendirme
Depolama hesabı sahibi bu işlemi çağırabilir. Ayrıca, geçerli hesap paylaşılan erişim imzası belirteçleri olan kullanıcılar bu işlemi çağırabilir. Belirtecin bu işlemi yetkilendirmek için kapsayıcı kaynağı için yazma izinleri içermesi gerekir.
Açıklamalar
Bir paylaşımı farklı bir ada geri yükleyemezsiniz. Bir paylaşımı geri yüklerken, aynı ada sahip başka bir paylaşım varsa, işlem 409 (Çakışma) durum koduyla başarısız olur. Geçici olarak silinen paylaşımın silinmeden önce aynı ada sahip paylaşımın silinmesi gerekir.
Bir paylaşım silindiğinde, aynı ada sahip bir paylaşım en az 30 saniye boyunca geri yüklenemez. Paylaşım silinirken, aynı ada sahip bir paylaşımı geri yükleme girişimleri 409 (Çakışma) durum koduyla başarısız olur. Hizmet, paylaşımın silindiğini belirten ek hata bilgileri döndürür.