Paylaşım Meta Verilerini Ayarla
İşlem, Set Share Metadata
belirtilen paylaşım için bir veya daha fazla kullanıcı tanımlı ad/değer çifti 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 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. Dosya Paylaşımı kaynaklarında işlemler.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
İsteği aşağıdaki gibi oluşturursunuz Set Share Metadata
. 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=metadata |
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ıyla ilgili ayrıntılar 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'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-meta-name:value |
İsteğe bağlı. Paylaşımın meta verilerini içerecek bir ad/değer çifti sağlar. Bu işleme yapılan her çağrı, paylaşıma eklenen tüm mevcut meta verilerin yerini alır. Paylaşımdaki tüm meta verileri kaldırmak için, meta veri üst bilgileri olmadan bu işlemi çağırın. 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ılırken Depolama Analizi günlüklerine 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 Blob Depolama. |
x-ms-lease-id:<ID> |
Hedef dosya paylaşımının etkin bir kirası varsa 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ının etkin kiralaması yoksa 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=metadata HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 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 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ğ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ştirilme zamanını etkilemez. |
ETag |
Paylaşımın sürümünü tırnak işaretleri içinde temsil eden bir değer içerir. |
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar. İstekle ilgili sorunları gidermek için bunu 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 |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa 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
Çağrısı Set Share Metadata
, paylaşımla ilişkili tüm mevcut meta verilerin üzerine yazar. Tek bir ad/değer çiftini değiştirmek mümkün değildir.
Paylaşım Oluşturma işleminin bir parçası olarak, paylaşımın oluşturulduğu sırada meta verileri de ayarlayabilirsiniz.
Çağrısı Set Share Metadata
, paylaşımın ETag
ve Last-Modified-Time
özelliklerini güncelleştirir.
Set Share Metadata
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. İşlemin bir parçası Snapshot Share
olarak, paylaşım anlık görüntüsünün oluşturulduğu sırada meta verileri ayarlayabilirsiniz.