Aracılığıyla paylaş

Paylaşım Özelliklerini Alma

  • Makale

Get Share Properties isteği, belirtilen paylaşım veya paylaşım anlık görüntüsünün özelliklerini 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ı - Getkullanmanızı öneririz.

Depolama kaynağı sağlayıcısını kullanarak FileShare kaynaklarıyla program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. FileShares'te İşlemler.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü Mevcut
SMB Evet
NFS Evet

İstek

Get Share Properties isteği aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.

Yöntem İstek URI'si HTTP sürümü
GET/HEAD https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
GET/HEAD https://myaccount.file.core.windows.net/myshare?restype=share&sharesnapshot=<DateTime> HTTP/1.1

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

Yol bileşeni Açıklama
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 Opsiyonel. Sürüm 2017-04-17 ve üzeri. sharesnapshot parametresi, mevcut olduğunda özellikleri almak için sorguya alınacak paylaşım anlık görüntüsünü belirten opak bir tarih/saat değeridir.
timeout Opsiyonel. 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

Gerekli ve isteğe bağlı üst bilgiler aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
Date veya x-ms-date Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri 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 Opsiyonel. 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. azure dosyalarıizleme .
x-ms-lease-id:<ID> Opsiyonel. 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

Hiç kimse.

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 durum kodunu döndürür (Tamam).

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 bilgilerHTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Açıklama
Last-Modified Paylaşımın en son değiştirildiği tarihi ve saati döndürür. Tarih biçimi RFC 1123'e uyar. Daha fazla bilgi için bkz.Üst Bilgilerde Date-Time Değerlerinin Gösterimi . 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ştirme zamanını etkilemez.
x-ms-meta-name:value Paylaşımın kullanıcı tanımlı meta verilerini 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şlem sorunlarını giderme.
x-ms-version İsteği yürütmek için kullanılan Azure Dosyalar sürümü.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-share-quota Sürüm 2015-02-21 ve üzeri. Geçerli paylaşım kotasını gibibayt cinsinden (GiB) döndürür.
x-ms-share-provisioned-iops Sürüm 2019-07-07 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür (FileStorage depolama hesabı türündeki dosya paylaşımları). Premium paylaşım için sağlanan saniye başına giriş/çıkış işlemlerinin (IOPS) sayısını döndürür.
x-ms-share-provisioned-ingress-mbps Sürüm 2019-07-07 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür (FileStorage depolama hesabı türündeki dosya paylaşımları). Premium paylaşım için sağlanan girişi saniye başına mebibayt cinsinden (MiB/sn) döndürür.
x-ms-share-provisioned-egress-mbps Sürüm 2019-07-07 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür (FileStorage depolama hesabı türündeki dosya paylaşımları). Premium paylaşım için sağlanan çıkışı MiB/sn olarak döndürür.
x-ms-share-provisioned-bandwidth-mibps Sürüm 2021-02-12 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür (FileStorage depolama hesabı türündeki dosya paylaşımları). Premium paylaşım için sağlandığı gibi MiB/sn cinsinden birleşik (giriş + çıkış) bant genişliğini döndürür.
x-ms-share-next-allowed-quota-downgrade-time Sürüm 2019-07-07 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür (FileStorage depolama hesabı türündeki dosya paylaşımları). Premium dosya paylaşımı kotasının ne zaman azaltılmasına izin verildiğini belirten tarih/saat değeri. Tarih biçimi RFC 1123'e uyar.
x-ms-access-tier Sürüm 2019-12-12 ve üzeri. Paylaşımın geçerli erişim katmanını döndürür. Genel amaçlı sürüm 2 (GPv2) depolama hesaplarında, TransationOptimized paylaşımın varsayılan katmanıdır. FileStorage depolama hesabı türlerinde, Premium paylaşımın varsayılan katmanıdır.
x-ms-access-tier-change-time Sürüm 2019-12-12 ve üzeri. Paylaşımdaki erişim katmanının en son değiştirildiği tarih ve saati döndürür.
x-ms-access-tier-transition-state Sürüm 2019-12-12 ve üzeri. Paylaşım katman geçişinden geçiyorsa, bu üst bilgi geçiş yaptığı katmanı gösterir.
x-ms-lease-duration:<fixed,infinite> Sürüm 2020-02-10 ve üzeri. Bir paylaşımdaki kiralamanın sonsuz mu yoksa sabit bir süre mi olduğunu belirtir.
x-ms-lease-state: <available;leased;expired;breaking;broken> Sürüm 2020-02-10 ve üzeri. Bir paylaşım kiralandığında, bu üst bilgi paylaşımın kiralama durumunu belirtir.
x-ms-lease-status: <locked;unlocked> Sürüm 2020-02-10 ve üzeri. Bir paylaşım kiralandığında, bu üst bilgi paylaşımın kira durumunu belirtir.
x-ms-enabled-protocols: <SMB;NFS> 2019-07-07 ve üzeri sürümler için geçerli paylaşım özellikli protokolleri döndürür.

- SMB: Paylaşıma SMBv3.0, SMBv2.1 ve REST tarafından erişilebilir.
- NFS: Paylaşıma NFSv4.1 tarafından erişilebilir.
x-ms-root-squash: <NoRootSquash;RootSquash;AllSquash> Sürüm 2019-07-07 ve üzeri için geçerli paylaşım kök sıkıştırma davranışını döndürür. Yalnızca NFS.

- NoRootSquash: Kök sıkıştırma kapalı.
- RootSquash: UID/GID 0'dan gelen istekler anonim UID/GID ile eşlenir.
- AllSquash: Tüm UID'ler ve GID'ler anonim kullanıcıyla eşlenir.

Bu üst bilgi anlık görüntüler için değil yalnızca paylaşımlar için döndürülür.
x-ms-enable-snapshot-virtual-directory-access: <true;false> Sürüm 2024-08-04 ve daha yeni. NFS etkinleştirildiğinde paylaşım bağlama noktasının kökünde anlık görüntü sanal dizinine erişilip erişilemeyeceğini belirtir.

Bu üst bilgi anlık görüntüler için değil yalnızca paylaşımlar için döndürülür.
x-ms-client-request-id İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa yanıtta bulunmaz.
x-ms-share-paid-bursting-enabled: <true;false> Sürüm 2024-11-04 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür (FileStorage depolama hesabı türündeki dosya paylaşımları). Ücretli seri serinin etkinleştirilip etkinleştirilmediğini belirtir.

Bu üst bilgi anlık görüntüler için değil yalnızca paylaşımlar için döndürülür.
x-ms-share-paid-bursting-max-iops Sürüm 2024-11-04 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür. Paylaşım için izin verilen en yüksek ücretli seri IOPS sayısını döndürür. Yalnızca x-ms-share-paid-bursting-enabled doğruysa döndürülür.

Bu üst bilgi anlık görüntüler için değil yalnızca paylaşımlar için döndürülür.
x-ms-share-paid-bursting-max-bandwidth-mibps Sürüm 2024-11-04 ve üzeri. Yalnızca premium dosya paylaşımları için döndürülür. Paylaşım için izin verilen maksimum ücretli ani artış MiB/sn değerini döndürür. Yalnızca x-ms-share-paid-bursting-enabled doğruysa döndürülür.

Bu üst bilgi anlık görüntüler için değil yalnızca paylaşımlar için döndürülür.

Yanıt gövdesi

Hiç kimse.

Örnek yanıt

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-meta-name: some_metadata  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-share-quota: 1024
x-ms-access-tier: Premium
x-ms-version: 2020-02-10  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

İzin

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

Açıklamalar

Hiç kimse.

Ayrıca bkz.

Azure dosya paylaşımlarında İşlemleri