Ustawianie właściwości udziału
Operacja Set Share Properties
ustawia właściwości określonego udziału plików platformy Azure. Mimo że ta operacja jest w pełni obsługiwana, jest to starsza operacja zarządzania. Zalecamy zamiast tego użycie operacji Udziały plików — aktualizacja dostarczona przez dostawcę zasobów magazynu (Microsoft.Storage). Aby dowiedzieć się więcej o programowej interakcji z FileShare
zasobami przy użyciu dostawcy zasobów magazynu, zobacz Operacje na zasobach udziałów plików.
Dostępność protokołu
Włączony protokół udziału plików | Dostępne |
---|---|
SMB | |
NFS |
Żądanie
Żądanie można skonstruować Set Share Properties
w następujący sposób. Zalecamy użycie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu.
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Zastąp składniki ścieżki wyświetlane we własnym identyfikatorze URI żądania, w następujący sposób:
Składnik ścieżki | Opis |
---|---|
myaccount |
Nazwa konta magazynu. |
myshare |
Nazwa udziału plików. |
Aby uzyskać szczegółowe informacje na temat ograniczeń nazewnictwa ścieżek, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.
Parametry identyfikatora URI
W identyfikatorze URI żądania można określić następujące dodatkowe parametry:
Parametr | Opis |
---|---|
timeout |
Opcjonalny. Wyrażone w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji Azure Files. |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań:
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. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage. |
x-ms-share-quota |
Opcjonalny. Obsługiwane w wersji 2015-02-21 lub nowszej. Określa maksymalny rozmiar udziału w gibibajtach (GiB). |
x-ms-access-tier |
Opcjonalny. Obsługiwane w wersji 2019-12-12 lub nowszej. Określa warstwę dostępu udziału. Prawidłowe wartości to TransactionOptimized , Hot i Cool . Aby uzyskać szczegółowe informacje na temat obsługi warstw udziału plików, zobacz Azure Files warstwy magazynowania |
x-ms-root-squash: <NoRootSquash | RootSquash | AllSquash> |
Opcjonalny. Obsługiwane w wersji 2020-02-10 lub nowszej. Określa zachowanie root squashing w udziale po włączeniu systemu plików NFS. Jeśli nie zostanie określony, wartość domyślna to NoRootSquash .
|
x-ms-client-request-id |
Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach analityka magazynu 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 Blob Storage. |
x-ms-lease-id:<ID> |
Wymagane, jeśli docelowy udział plików ma aktywną dzierżawę. Dostępne dla wersji 2020-02-10 lub nowszej. Jeśli żądanie nie zawiera identyfikatora dzierżawy lub jest nieprawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się). Jeśli ten nagłówek jest określony, a docelowy udział plików nie ma obecnie aktywnej dzierżawy, operacja kończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się). |
Treść żądania
Brak.
Przykładowe żądanie
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
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).
Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.
Nagłówek odpowiedzi | Opis |
---|---|
Last-Modified |
Zwraca datę i godzinę ostatniej modyfikacji udziału. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach. Każda operacja modyfikując udział lub jego właściwości aktualizuje czas ostatniej modyfikacji. Operacje na plikach nie wpływają na czas ostatniej modyfikacji udziału. |
ETag |
Zawiera wartość reprezentującą wersję udziału jako ciąg cytowany. |
x-ms-request-id |
Jednoznacznie identyfikuje wykonane żądanie. Można go również 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ę Azure Files, która jest używana do wykonania żądania. |
Date lub x-ms-date |
Wartość daty/godziny UTC wskazująca godzinę, w której usługa wysłała odpowiedź. |
x-ms-client-request-id |
Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli znajduje się w żądaniu, a wartość wynosi co najwyżej 1024 widoczne znaki ASCII. x-ms-client-request-id Jeśli nagłówek nie istnieje w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi. |
Treść odpowiedzi
Brak.
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Uwagi
Aby uzyskać więcej informacji na temat ustawiania limitu przydziału udziału, zobacz Tworzenie udziału.
Jeśli ustawisz, że przydział udziału będzie mniejszy niż rozmiar danych w udziale, operacja zakończy się pomyślnie. Jednak nie będzie można dodać większej ilości danych do udziału, dopóki ilość danych w udziale nie zostanie zmniejszona poniżej limitu przydziału. Ilość danych można zmniejszyć, usuwając lub kompresując pliki.
Set Share Properties
nie jest obsługiwana w przypadku migawki udziału. Próba wykonania tej operacji na migawce udziału zakończy się niepowodzeniem z kodem stanu 400 (InvalidQueryParameterValue).