Tworzenie udziału

Operacja Create Share tworzy nowy udział usługi Azure Files w ramach określonego konta. Mimo że ten interfejs API jest w pełni obsługiwany, jest to starszy interfejs API zarządzania. Zalecamy zamiast tego użycie udziałów plików — tworzenie, które jest udostępniane przez dostawcę zasobów usługi Azure Storage (Microsoft.Storage). Aby dowiedzieć się więcej o programowej interakcji z zasobami FileShare przy użyciu dostawcy zasobów usługi Azure Storage, zobacz Operations on FileShares.

Jeśli udział o tej samej nazwie już istnieje, operacja zakończy się niepowodzeniem. Zasób udziału zawiera metadane i właściwości dla tego udziału. Nie zawiera listy plików zawartych w udziale.

Dostępność protokołu

Włączony protokół udziału plików	Dostępny
Blok komunikatów serwera (SMB)
System plików sieciowych (NFS)

Prosić

Możesz skonstruować żądanie Create Share, jak pokazano tutaj. Zalecamy używanie protokołu HTTPS.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
PUT	https://myaccount.file.core.windows.net/myshare?restype=share	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. Nazwa może zawierać tylko małe litery.

Aby uzyskać więcej informacji na temat ograniczeń nazewnictwa ścieżek, zobacz Nazwa i udziały referencyjne, katalogi, pliki i metadane.

Parametry identyfikatora URI

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

Parametr	Opis
timeout	Fakultatywny. Parametr limitu czasu jest wyrażony 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 czas uniwersalny 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 Versioning for Azure Storage services.
x-ms-meta-name:value	Fakultatywny. Para name-value do skojarzenia z udziałem jako metadanymi. Nazwy metadanych muszą być zgodne z regułami nazewnictwa dla identyfikatorów języka C# .
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 warstw udziału plików, zobacz warstwy magazynowania usługi Azure Files.
x-ms-enabled-protocols: <SMB \| NFS>	Fakultatywny. Obsługiwane w wersji 2019-07-07 lub nowszej. Określa włączone protokoły w udziale. Jeśli nie zostaną określone, wartość domyślna to SMB. - SMB: dostęp do udziału można uzyskać za pomocą protokołu SMBv3.0, SMBv2.1 i REST. - NFS: dostęp do udziału można uzyskać za pomocą systemu plików NFSv4.1. Dla tej opcji jest wymagane konto w warstwie Premium.
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash>	Fakultatywny. Tylko system plików NFS. Obsługiwane w wersji 2019-07-07 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. - NoRootSquash: Wyłącz root squashing. - RootSquash: Mapuj żądania z uid/gid 0 do anonimowego uid/gid. - AllSquash: mapuj wszystkie identyfikatory uid i gids na anonimowego użytkownika.
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. Jeśli nie zostanie określony, wartość domyślna to true.
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 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 Files.
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ść umożliwia płatne wzrosty. Jeśli właściwość nie zostanie określona, wartość domyślna to false.
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. 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.
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. 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.

Treść żądania

Żaden.

Przykładowe żądanie

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
x-ms-meta-Name: StorageSample  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Odpowiedź

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

Kod stanu

Pomyślna operacja zwraca kod stanu 201 (Utworzono).

Aby uzyskać więcej informacji, zobacz Kody stanu i 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
ETag	Zawiera wartość reprezentującą wersję udziału ujętą w cudzysłów.
Last-Modified	Zwraca datę i godzinę ostatniej modyfikacji udziału. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentowanie wartości daty/godziny w nagłówkach. Każda operacja modyfikując udział lub jego właściwości lub metadane aktualizuje czas ostatniej modyfikacji. Operacje na plikach nie mają wpływu na czas ostatniej modyfikacji udziału.
x-ms-request-id	Unikatowo identyfikuje żądanie i można go 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, która została użyta do wykonania żądania.
Date	Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
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 znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. Jeśli nagłówek x-ms-client-request-id nie znajduje się w żądaniu, nie jest obecny w odpowiedzi.

Treść odpowiedzi

Żaden.

Przykładowa odpowiedź

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: <date>  
x-ms-version: 2020-02-10  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Uwagi

Udziały są tworzone natychmiast na koncie magazynu. Nie można zagnieżdżać jednego udziału w innym.

Metadane udziału można określić podczas jego tworzenia, dołączając co najmniej jeden nagłówek metadanych do żądania. Format nagłówka metadanych to x-ms-meta-name:value.

Jeśli udział o tej samej nazwie jest usuwany podczas wywoływania Create Share, serwer zwraca kod stanu 409 (konflikt), a dodatkowe informacje o błędzie wskazują, że udział jest usuwany.

Możesz użyć limitu przydziału rozmiaru udziału, aby ograniczyć rozmiar plików przechowywanych w udziale. Limit przydziału nie ogranicza rozmiaru migawek. Obciążenie związane z plikami i używane do obliczania rozmiaru rozliczeniowego konta magazynu nie jest uwzględniane w ramach limitu przydziału.

Gdy suma rozmiarów plików w udziale przekracza limit przydziału ustawiony w udziale, próba zwiększenia rozmiaru pliku zakończy się niepowodzeniem, a utworzenie nowych plików niepustych (za pośrednictwem interfejsu REST) zakończy się niepowodzeniem. Nadal będzie można tworzyć puste pliki.

Zmiana lub ustawienie limitu przydziału nie ma wpływu na rozliczenia. Nadal są naliczane opłaty za rozmiar plików oraz obciążenie.

Zobacz też

operacje w udziałach usługi Azure Files