Tworzenie udziału
Operacja Create Share
tworzy nowy udział 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 udostępniane przez dostawcę zasobów usługi Azure Storage (Microsoft.Storage). Aby dowiedzieć się więcej na temat programowej interakcji z FileShare
zasobami przy użyciu dostawcy zasobów usługi Azure Storage, zobacz Operacje na udziałach plików.
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ępne |
---|---|
Blok komunikatów serwera (SMB) | |
Sieciowy system plików (NFS) |
Żądanie
Żądanie można skonstruować Create Share
, jak pokazano tutaj. Zalecamy korzystanie z 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 Nazwy 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 |
Opcjonalny. 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 Przechowywanie wersji dla usług Azure Storage. |
x-ms-meta-name:value |
Opcjonalny. Para name-value do skojarzenia z udziałem jako metadanymi. Nazwy metadanych muszą być zgodne z regułami nazewnictwa identyfikatorów języka C#. |
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 warstw udziału plików, zobacz Azure Files warstwy magazynowania. |
x-ms-enabled-protocols: <SMB \| NFS> |
Opcjonalny. 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> |
Opcjonalny. 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 od uid/gid 0 do anonimowego identyfikatora uid/gid.- AllSquash : mapuj wszystkie identyfikatory uid i gids na użytkownika anonimowego. |
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. |
Treść żądania
Brak.
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=
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Pomyślna operacja zwraca kod stanu 201 (Utworzony).
Aby uzyskać więcej informacji, zobacz Status and error codes (Kody stanu i 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 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 dokumentem 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 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 Azure Files wersję, 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 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 jest obecny w odpowiedzi. |
Treść odpowiedzi
Brak.
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 skojarzone 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.