Paylaşım Özelliklerini Ayarla

İşlem, Set Share Properties belirtilen Azure dosya paylaşımının özelliklerini ayarlar. Bu işlem tam olarak destekleniyor olsa da, eski bir yönetim işlemidir. Bunun yerine depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanan Dosya Paylaşımları - Güncelleştirme işlemini kullanmanızı öneririz. 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. Dosya Paylaşımı kaynaklarındaki İşlemler.

Protokol kullanılabilirliği

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

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Set Share Properties . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin.

Yöntem	İstek URI'si	HTTP sürümü
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties	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 parametreleri belirtebilirsiniz:

Parametre	Açıklama
timeout	İsteğe bağlı. 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) biçimini 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-share-quota	İsteğe bağlı. 2015-02-21 ve sonraki sürümlerde desteklenir. Paylaşımın en büyük boyutunu , gibibayt (GiB) cinsinden belirtir.
x-ms-access-tier	İsteğe bağlı. 2019-12-12 ve sonraki sürümlerde desteklenir. Paylaşımın erişim katmanını belirtir. Geçerli değerler , Hotve CooldeğerleridirTransactionOptimized. Dosya paylaşımı katmanlama hakkında ayrıntılı bilgi için bkz. Azure Dosyalar depolama katmanları
x-ms-root-squash: <NoRootSquash | RootSquash | AllSquash>	İsteğe bağlı. 2020-02-10 ve sonraki sürümlerde desteklenir. NFS etkinleştirildiğinde paylaşımdaki kök sıkıştırma davranışını belirtir. Belirtilmezse, varsayılan değer olur NoRootSquash. NoRootSquash: Kök sıkıştırmayı kapatın. RootSquash: UID/GID 0'dan gelen istekleri anonim UID/GID ile eşleyin. AllSquash: Tüm UID'leri ve GID'leri anonim kullanıcıyla eşleyin.
x-ms-client-request-id	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında Depolama Analizi günlüklerine 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. İzleme Azure Blob Depolama.
x-ms-lease-id:<ID>	Hedef dosya paylaşımı etkin bir kiraya sahipse gereklidir. Sürüm 2020-02-10 ve üzeri için kullanılabilir. İstek kira kimliğini içermiyorsa veya geçerli değilse işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu). Bu üst bilgi belirtilirse ve hedef dosya paylaşımı şu anda etkin bir kiraya sahip değilse, işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu).

İstek gövdesi

Yok.

Örnek istek

PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=  
x-ms-share-quota: 55  
x-ms-root-squash: RootSquash

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 200 (Tamam) 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
Last-Modified	Paylaşımın son değiştirildiği tarihi 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ğ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.
ETag	Alıntılanmış dize olarak paylaşımın sürümünü temsil eden bir değer içerir.
x-ms-request-id	Yapılan isteği benzersiz olarak tanımlar. İsteğin sorunlarını gidermek için de kullanabilirsiniz. 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	Hizmetin yanıtı gönderdiği saati gösteren utc tarih/saat değeri.
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 ve değer en fazla 1.024 görünür ASCII karakteriyse üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi mevcut olmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

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

Açıklamalar

Paylaşım kotasını ayarlama hakkında daha fazla bilgi için bkz. Paylaşım Oluşturma.

Paylaşım kotasını paylaşımdaki verilerin boyutundan küçük olacak şekilde ayarlarsanız işlem başarılı olur. Ancak, paylaşımdaki veri miktarı kotanın altına düşürülene kadar paylaşıma daha fazla veri ekleyemezsiniz. Dosyaları silerek veya sıkıştırarak veri miktarını azaltabilirsiniz.

Set Share Properties paylaşım anlık görüntüsü için desteklenmez. Paylaşım anlık görüntüsünde bu işlemi gerçekleştirme girişimi 400 (InvalidQueryParameterValue) durum koduyla başarısız olur.

Ayrıca bkz.

FileShare kaynaklarındaki işlemler (Azure Dosyalar)