Ustawianie metadanych katalogu

Artykuł
03/29/2023

Operacja Set Directory Metadata ustawia metadane zdefiniowane przez użytkownika dla określonego katalogu. Ta operacja jest dostępna w wersji 2015-02-21 lub nowszej.

Dostępność protokołu

Włączony protokół udziału plików	Dostępne
SMB
NFS

Żądanie

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
PUT	`https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& comp=metadata`	HTTP/1.1

Zastąp składniki ścieżki, które są wyświetlane w identyfikatorze URI żądania własnym, w następujący sposób:

Składnik ścieżki	Opis
`myaccount`	Nazwa konta magazynu.
`myshare`	Nazwa udziału plików.
`myparentdirectorypath`	Opcjonalny. Ścieżka do katalogu nadrzędnego.
`mydirectory`	Nazwa katalogu.

Aby uzyskać informacje na temat ograniczeń nazewnictwa ścieżek, zobacz Nazwy i udziały referencyjne, katalogi, pliki i metadane.

Parametry identyfikatora URI

W identyfikatorze URI żądania można określić następujące dodatkowe parametry:

Parametr	Opis
`timeout`	Opcjonalny. Parametr jest wyrażony `timeout` w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi plików.

Nagłówki żądań

Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:

Nagłówek żądania	Opis
`Authorization`	Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
`Date` lub `x-ms-date`	Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
`x-ms-version`	Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Ta operacja jest dostępna tylko w wersji 2015-02-21 lub nowszej. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage.
`x-ms-meta-name:value`	Opcjonalny. Ustawia parę name-value dla katalogu. Każde wywołanie tej operacji zastępuje wszystkie istniejące metadane dołączone do katalogu. Aby usunąć wszystkie metadane z katalogu, wywołaj tę operację bez nagłówków metadanych. Nazwy metadanych muszą być zgodne z regułami nazewnictwa identyfikatorów języka C#.
`x-ms-client-request-id`	Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitorowanie Azure Files.
`x-ms-file-request-intent`	Wymagane, jeśli `Authorization` nagłówek określa token OAuth. Akceptowalna wartość to `backup`. Ten nagłówek określa, czy `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` element lub `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` ma zostać przyznany, jeśli są one uwzględnione w zasadach RBAC przypisanych do tożsamości, która jest autoryzowana przy użyciu nagłówka `Authorization` . Dostępne dla wersji 2022-11-02 lub nowszej.
`x-ms-allow-trailing-dot: { <Boolean> }`	Opcjonalny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w adresie URL żądania powinna zostać przycięta, czy nie. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 200 (OK).

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź zawiera również dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
`ETag`	Zawiera wartość reprezentującą wersję katalogu. Wartość jest ujęta w znaki cudzysłowu.
`x-ms-request-id`	Unikatowo identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
`x-ms-version`	Wskazuje wersję usługi plików, która została użyta do wykonania żądania.
`Date` lub `x-ms-date`	Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
`x-ms-request-server-encrypted: true/false`	Wersja 2017-04-17 lub nowsza. Wartość tego nagłówka jest ustawiana na `true` wartość , jeśli zawartość żądania została pomyślnie zaszyfrowana przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na `false`.
`x-ms-client-request-id`	Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości `x-ms-client-request-id` nagłówka, jeśli jest obecna w żądaniu, a wartość zawiera nie więcej niż 1024 widoczne znaki ASCII. `x-ms-client-request-id` Jeśli nagłówek nie znajduje się w żądaniu, nie będzie on obecny w odpowiedzi.

Treść odpowiedzi