Dizin Meta Verilerini Ayarla

Makale
03/29/2023

İşlem, Set Directory Metadata belirtilen dizin için kullanıcı tanımlı meta verileri ayarlar. Bu işlem 2015-02-21 ve sonraki sürümlerde kullanılabilir.

Protokol kullanılabilirliği

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

İstek

Yöntem	İstek URI'si	HTTP sürümü
PUT	`https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& 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ı.
`myparentdirectorypath`	İsteğe bağlı. Üst dizinin yolu.
`mydirectory`	Dizinin 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 parametreleri belirtebilirsiniz:

Parametre	Açıklama
`timeout`	İsteğe bağlı. `timeout` parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Dosya hizmeti işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştı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. Bu işlem yalnızca 2015-02-21 ve sonraki sürümlerde kullanılabilir. 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ı. Dizin için bir ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, dizinine eklenmiş olan tüm meta verilerin yerini alır. Dizindeki 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ı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-file-request-intent`	Üst bilgi bir OAuth belirteci belirtiyorsa `Authorization` gereklidir. Kabul edilebilir değer: `backup`. Bu üst bilgi, üst bilgi kullanılarak yetkilendirilmiş kimliğe atanan RBAC ilkesine dahil edildiyse veya `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` izni verilmesi `Authorization` gerektiğini belirtir`Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action`. Sürüm 2022-11-02 ve üzeri için kullanılabilir.
`x-ms-allow-trailing-dot: { <Boolean> }`	İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma.

İ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 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 ayrıca ek standart HTTP üst bilgileri içerir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Description
`ETag`	Dizinin sürümünü temsil eden 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 Dosya hizmeti 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-request-server-encrypted: true/false`	Sürüm 2017-04-17 ve üzeri. İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse bu üst bilginin değeri olarak ayarlanır `true` . Aksi takdirde, değer olarak `false`ayarlanır.
`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