Paylaşım Meta Verilerini Alma
İşlem, Get Share Metadata
Azure dosya paylaşımı veya paylaşım anlık görüntüsü için kullanıcı tanımlı tüm meta verileri döndürür.
Bu API tam olarak destekleniyor olsa da, eski bir yönetim API'sidir. Bu nedenle, bunun yerine depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanan Dosya Paylaşımları - Al'ı kullanmanızı öneririz.
Depolama kaynağı sağlayıcısını kullanarak kaynaklarla FileShare
program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. Azure dosya paylaşımlarında işlemler.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
İstek Get Share Metadata
aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata&sharesnapshot=<DateTime> |
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 bilgi için bkz . Ad ve başvuru paylaşımları, dizinler, dosyalar ve meta veriler.
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:
Parametre | Açıklama |
---|---|
sharesnapshot |
İsteğe bağlı. Sürüm 2017-04-17 ve üzeri.
sharesnapshot parametresi, mevcut olduğunda meta verileri almak için sorguya alınacak paylaşım anlık görüntüsünü belirten opak bir tarih/saat değeridir |
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
İ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) biçimini 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-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ı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 Dosyalar. |
x-ms-lease-id:<ID> |
İsteğe bağlı. Sürüm 2020-02-10 ve üzeri. Üst bilgi belirtilirse, işlem yalnızca dosya paylaşımının kirası şu anda etkinse ve istekte belirtilen kira kimliği dosya paylaşımının kira kimliğiyle eşleşiyorsa gerçekleştirilir. Eşleşme yoksa işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu). |
İstek gövdesi
Yok.
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 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 |
---|---|
Last-Modified |
Paylaşımın en son değiştirildiği tarih 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. Paylaşımı veya özelliklerini 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ştirilme zamanını etkilemez. |
x-ms-meta-name:value |
Paylaşım için kullanıcı tanımlı meta veriler içeren bir dizi ad-değer çifti. |
ETag |
İşlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Değer tırnak içine alınır. |
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını 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 Azure Dosyalar sürümünü gösterir. |
Date veya x-ms-date |
Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. |
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 ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. İ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 200 OK
Response Headers:
Transfer-Encoding: chunked
x-ms-meta-name: somemetadata
Date: Mon, 27 Jan 2014 22:49:18 GMT
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: Mon, 27 Jan 2014 22:48:29 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Bu işlem yalnızca paylaşımda kullanıcı tanımlı meta verileri döndürür. Sistem özelliklerini de döndürmek için Paylaşım Özelliklerini Al'ı çağırabilirsiniz.