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 użycie zamiast tego operacji Udziały plików — aktualizowanie udostępnianych przez dostawcę zasobów magazynu (Microsoft.Storage). Aby dowiedzieć się więcej o programowej interakcji z zasobami FileShare 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ępny |
|---|---|
| SMB |
|
| NFS |
|
Prosić
Żądanie Set Share Properties można skonstruować w następujący sposób. Zalecamy użycie protokołu HTTPS. Zastąp wartość 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 |
Fakultatywny. Wyrażone w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi 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 uniwersalny czas koordynowany (UTC) dla żądania. 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 dla usług Azure Storage. |
x-ms-share-quota |
Fakultatywny. Obsługiwane w wersji 2015-02-21 lub nowszej. Określa maksymalny rozmiar udziału w gibibajtach (GiB). |
x-ms-access-tier |
Fakultatywny. Obsługiwane w wersji 2019-12-12 lub nowszej. Określa warstwę dostępu udziału. Prawidłowe wartości to TransactionOptimized, Hoti Cool. Aby uzyskać szczegółowe informacje na temat obsługi warstw udziału plików, zobacz warstwy magazynowania usługi Azure Files. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Fakultatywny. Obsługiwane w wersji 2020-02-10 lub nowszej. Określa zachowanie root squashing w udziale po włączeniu systemu plików NFS.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Fakultatywny. Obsługiwane w wersji 2024-08-04 lub nowszej. Określa, czy katalog wirtualny migawki powinien być dostępny w katalogu głównym punktu instalacji udziału, gdy system plików NFS jest włączony. |
x-ms-client-request-id |
Fakultatywny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach analizy 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 Monitor 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 nie jest prawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego). 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 (Niepowodzenie warunku wstępnego). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Fakultatywny. Obsługiwane w wersji 2024-11-04 lub nowszej. Dozwolone tylko dla udziałów plików w warstwie Premium (udziały plików w ramach typu konta magazynu FileStorage). Ta właściwość może służyć do włączania lub wyłączania płatnych wzrostów. Jeśli właściwość nie zostanie określona, udział zachowa stan włączenia płatnej serii. |
x-ms-share-paid-bursting-max-iops |
Fakultatywny. Obsługiwane w wersji 2024-11-04 lub nowszej. Dozwolone tylko dla udziałów plików w warstwie Premium. Liczba całkowita reprezentująca maksymalną płatną operację wejścia/wyjścia na sekundę (IOPS) dozwoloną dla udziału. Jeśli płatne skalowanie nie jest jeszcze włączone w udziale: zachowanie jest identyczne z nagłówka x-ms-share-paid-bursting-max-iops w sekcji Tworzenie udziału. Wartość domyślna, jeśli nie jest określona, to maksymalna dozwolona liczba operacji we/wy na sekundę dla udziału. Jeśli ten nagłówek jest ustawiony, x-ms-share-paid-bursting-enabled musi być również ustawiona na wartość true.Jeśli płatne skalowanie jest już włączone w udziale: x-ms-share-paid-bursting-max-iops można użyć do zaktualizowania maksymalnej liczby płatnych operacji we/wy na sekundę dla udziału.
x-ms-share-paid-bursting-enabled nie trzeba ustawiać w tym przypadku. Jeśli x-ms-share-paid-bursting-enabled jest ustawiona na wartość true, ale x-ms-share-paid-bursting-max-iops nie jest ustawiona, maksymalna liczba operacji we/wy na sekundę w ramach płatnej liczby operacji we/wy na sekundę pozostanie niezmieniona. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Fakultatywny. Obsługiwane w wersji 2024-11-04 lub nowszej. Dozwolone tylko dla udziałów plików w warstwie Premium. Liczba całkowita reprezentująca maksymalną płatną liczbę bitów mebibajtów na sekundę (MiB/s) dozwoloną dla udziału. Jeśli płatne skalowanie nie jest jeszcze włączone w udziale: zachowanie jest identyczne z nagłówka x-ms-share-paid-bursting-max-bandwidth-mibps w sekcji Tworzenie udziału. Wartość domyślna, jeśli nie zostanie określona, jest maksymalną dozwoloną wartością MiB/s dla udziału. Jeśli ten nagłówek jest ustawiony, x-ms-share-paid-bursting-enabled musi być również ustawiona na wartość true.Jeśli płatne skalowanie jest już włączone w udziale: x-ms-share-paid-bursting-max-bandwidth-mibps można użyć do zaktualizowania maksymalnej płatnej serii miB/s dla udziału.
x-ms-share-paid-bursting-enabled nie trzeba ustawiać w tym przypadku. Jeśli x-ms-share-paid-bursting-enabled jest ustawiona na wartość true, ale x-ms-share-paid-bursting-max-bandwidth-mibps nie jest ustawiona, maksymalna płatna przepustowość z szybkością pozostanie niezmieniona. |
Treść żądania
Żaden.
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
Odpowiedź
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 Stan i kody błędów.
Nagłówki odpowiedzi
Odpowiedź dla tej operacji zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki 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 mają wpływu na czas ostatniej modyfikacji udziału. |
ETag |
Zawiera wartość reprezentującą wersję udziału jako ciąg cytowany. |
x-ms-request-id |
Jednoznacznie identyfikuje żądanie, które zostało wykonane. 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ę usługi Azure Files używaną do wykonania żądania. |
Date lub x-ms-date |
Wartość daty/godziny UTC wskazująca godzinę, o 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 odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id, jeśli jest obecna w żądaniu, a wartość wynosi najwyżej 1024 widoczne znaki ASCII. Jeśli nagłówek x-ms-client-request-id nie znajduje się w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi. |
Treść odpowiedzi
Żaden.
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 Create Share.
Jeśli ustawisz przydział udziału na mniejszy niż rozmiar danych w udziale, operacja powiedzie się. 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 migawki udziału zakończy się niepowodzeniem z kodem stanu 400 (InvalidQueryParameterValue).
Jeśli ustawisz nagłówek x-ms-enable-snapshot-virtual-directory-access dla udziałów NFS, zainstaluj ponownie udział, aby obserwować zaktualizowane zachowanie.