Path - Create
Tworzenie pliku | Tworzenie katalogu | Zmień nazwę pliku | Zmień nazwę katalogu
Utwórz lub zmień nazwę pliku lub katalogu. Domyślnie miejsce docelowe jest zastępowane, a jeśli miejsce docelowe już istnieje i ma dzierżawę, dzierżawa zostanie przerwana. Ta operacja obsługuje warunkowe żądania HTTP. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Service. Aby zakończyć się niepowodzeniem, jeśli miejsce docelowe już istnieje, użyj żądania warunkowego z parametrem If-None-Match: "*".
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
Parametry identyfikatora URI
Name | In | Required | Type | Description |
---|---|---|---|---|
account
|
path | True |
|
Nazwa konta usługi Azure Storage. |
dns
|
path | True |
|
Sufiks DNS dla punktu końcowego Azure Data Lake Storage. |
filesystem
|
path | True |
|
Identyfikator systemu plików. Regex pattern: |
path
|
path | True |
|
Ścieżka pliku lub katalogu. |
continuation
|
query |
|
Opcjonalny. Podczas zmieniania nazwy katalogu liczba ścieżek, które są zmieniane wraz z każdym wywołaniem, jest ograniczona. Jeśli liczba ścieżek do zmiany nazwy przekracza ten limit, token kontynuacji jest zwracany w tym nagłówku odpowiedzi. Gdy token kontynuacji jest zwracany w odpowiedzi, musi zostać określony w kolejnym wywołaniu operacji zmiany nazwy, aby kontynuować zmianę nazwy katalogu. |
|
mode
|
query |
Opcjonalny. Prawidłowe tylko wtedy, gdy jest włączona przestrzeń nazw. Ten parametr określa zachowanie operacji zmiany nazwy. Wartość musi być "starsza" lub "posix", a wartością domyślną będzie "posix". |
||
resource
|
query |
Wymagane tylko w przypadku tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog". |
||
timeout
|
query |
|
Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się po odebraniu żądania przez usługę. Jeśli wartość limitu czasu upłynie przed zakończeniem operacji, operacja zakończy się niepowodzeniem. |
Nagłówek żądania
Media Types: "application/octet-stream"
Name | Required | Type | Description |
---|---|---|---|
Cache-Control |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Cache-Control" dla operacji "Odczyt pliku" dla operacji "Odczyt pliku". |
|
Content-Encoding |
|
Opcjonalny. Określa, które kodowania zawartości zostały zastosowane do pliku. Ta wartość jest zwracana do klienta po wykonaniu operacji "Odczyt pliku". |
|
Content-Language |
|
Opcjonalny. Określa język naturalny używany przez odbiorców przeznaczonych dla pliku. |
|
Content-Disposition |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Disposition" dla operacji "Odczyt pliku". |
|
x-ms-cache-control |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Cache-Control" dla operacji "Odczyt pliku". |
|
x-ms-content-type |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Type" dla operacji "Odczyt pliku". |
|
x-ms-content-encoding |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Kodowanie zawartości" dla operacji "Odczyt pliku". |
|
x-ms-content-language |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Language" dla operacji "Odczyt pliku". |
|
x-ms-content-disposition |
|
Opcjonalny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Disposition" dla operacji "Odczyt pliku". |
|
x-ms-rename-source |
|
Nazwa opcjonalnego pliku lub katalogu, który ma zostać zmieniony. Wartość musi mieć następujący format: "/{filesystem}/{path}" lub "/{filesystem}/{path}?sastoken" podczas korzystania z tokenu SAS. Jeśli określono wartość "x-ms-properties", właściwości zastąpią istniejące właściwości; w przeciwnym razie istniejące właściwości zostaną zachowane. Ta wartość musi być ciągiem zakodowanym w procentach adresu URL. Pamiętaj, że ciąg może zawierać tylko znaki ASCII w zestawie znaków ISO-8859-1. |
|
x-ms-lease-id |
|
Opcjonalny. Identyfikator dzierżawy ścieżki określonej w identyfikatorze URI. Ścieżka do zastąpienia musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny. Regex pattern: |
|
x-ms-source-lease-id |
|
Opcjonalne w przypadku operacji zmiany nazwy. Identyfikator dzierżawy dla ścieżki źródłowej. Ścieżka źródłowa musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny. Regex pattern: |
|
x-ms-properties |
|
Opcjonalny. Właściwości zdefiniowane przez użytkownika, które mają być przechowywane z plikiem lub katalogiem, w formacie rozdzielanej przecinkami pary nazw i wartości "n1=v1, n2=v2...", gdzie każda wartość jest ciągiem zakodowanym w formacie base64. Pamiętaj, że ciąg może zawierać tylko znaki ASCII w zestawie znaków ISO-8859-1. |
|
x-ms-permissions |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Ustawia uprawnienia dostępu POSIX dla właściciela pliku, grupy właścicieli plików i innych. Każda klasa może otrzymać uprawnienie do odczytu (4), zapisu (2) lub wykonywania (1). Obsługiwane są notacje symboliczne (rwxrw-rw-) i 4-cyfrowe notacje ósemkowej (np. 0766). Bit sticky jest również obsługiwany i w notacji symbolicznej, jego reprezentowane przez literę t lub T w końcowym miejscu znaku w zależności od tego, czy bit wykonywania dla innej kategorii jest ustawiony lub niezbiorny odpowiednio (np. rwxrw-rw- z lepki bit jest reprezentowany jako rwxrw-rwT. Rwxrw-rwx z sticky bit jest reprezentowany jako rwxrw-rwt), brak t lub T wskazuje sticky bit nie jest ustawiony. W 4-cyfrowej notacji ósemkowej, jej reprezentacja przez 1 cyfrę (np. 1766 reprezentuje rwxrw-rw- z lepkim bitem i 0766 reprezentuje rwxrw-rw- bez sticky bit). Nieprawidłowy w połączeniu z x-ms-acl. |
|
x-ms-umask |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Podczas tworzenia pliku lub katalogu i folder nadrzędny nie ma domyślnej listy ACL, maska umask ogranicza uprawnienia pliku lub katalogu do utworzenia. Wynikowe uprawnienie jest podane przez użytkownika p & ^u, gdzie p jest uprawnieniem i jest maską umask. Jeśli na przykład wartość p to 0777 i wartość 0057, wynikowe uprawnienie to 0720. Domyślne uprawnienie to 0777 dla katalogu i 0666 dla pliku. Domyślna maska umask to 0027. Maska umask musi być określona w 4-cyfrowej notacji ósemkowej (np. 0766). |
|
x-ms-owner |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Ustawia właściciela pliku lub katalogu. |
|
x-ms-group |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Ustawia grupę będącą właścicielem pliku lub katalogu. |
|
x-ms-acl |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Ustawia prawa kontroli dostępu POSIX dla plików i katalogów. Każdy wpis kontroli dostępu (ACE) składa się z zakresu, typu, identyfikatora użytkownika lub grupy i uprawnień w formacie "[scope:][type]:[id]:[permissions]". Zakres musi być "domyślny", aby wskazać, że ACE należy do domyślnej listy ACL katalogu; w przeciwnym razie zakres jest niejawny, a ACE należy do listy ACL dostępu. Istnieją cztery typy ACE: "użytkownik" przyznaje prawa właścicielowi lub nazwanemu użytkownikowi, "grupa" przyznaje prawa do grupy właścicieli lub nazwanej grupy, "maska" ogranicza prawa przyznane nazwanym użytkownikom i członkom grup, a "inne" przyznaje prawa wszystkim użytkownikom, którzy nie znaleźli się w żadnym z innych wpisów. Identyfikator użytkownika lub grupy zostanie pominięty dla wpisów typu "maska" i "inne". Identyfikator użytkownika lub grupy jest również pomijany dla właściciela i grupy będącą właścicielem. Pole uprawnień jest 3-znakową sekwencją, w której pierwszy znak to "r", aby udzielić dostępu do odczytu, drugi znak to "w", aby udzielić dostępu do zapisu, a trzeci znak to "x", aby udzielić uprawnień do wykonywania. Jeśli dostęp nie zostanie udzielony, znak "-" jest używany do oznaczania, że uprawnienie zostanie odrzucone. Na przykład następująca lista ACL przyznaje prawa do odczytu, zapisu i wykonywania właścicielowi pliku i john.doe@contoso, prawo do odczytu do grupy właścicieli i nic dla wszystkich innych: "user::rwx,user:john.doe@contoso:rwx,group::r--,ther:::---,mask=rwx". Nieprawidłowy w połączeniu z uprawnieniami x-ms. |
|
x-ms-proposed-lease-id |
|
Opcjonalny. Określ proponowany identyfikator dzierżawy, jeśli chcesz uzyskać dzierżawę podczas tworzenia pliku lub katalogu. Dzierżawa zostanie uzyskana przy użyciu tego identyfikatora dzierżawy, jeśli tworzenie zakończy się pomyślnie. Regex pattern: |
|
x-ms-expiry-option |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta i jest obsługiwana tylko w plikach. Określ jedną z następujących opcji wygaśnięcia, jeśli chcesz ustawić czas wygaśnięcia pliku podczas tworzenia. "RelativeToNow" Ustaw wygaśnięcie względem bieżącej godziny. Użytkownik przekaże liczbę milisekund, które upłynęły od teraz. "Bezwzględny" czas bezwzględny w formacie RFC 1123. "Neverexpire" Ustaw plik, aby nigdy nie wygasał, czas wygaśnięcia nie musi być określony za pomocą tej opcji. |
|
x-ms-expiry-time |
|
Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta i jest obsługiwana tylko w plikach. Określ czas wygaśnięcia pliku. Podane jako RFC 1123 ciąg czasu HTTP lub liczba milisekund zgodnie z opcją wygaśnięcia. |
|
If-Match |
|
Opcjonalny. Wartość elementu ETag. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością. Element ETag musi być określony w cudzysłowie. |
|
If-None-Match |
|
Opcjonalny. Wartość elementu ETag lub specjalna wartość symbolu wieloznakowego ("*"). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Element ETag musi być określony w cudzysłowie. |
|
If-Modified-Since |
|
Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonej daty i godziny. |
|
If-Unmodified-Since |
|
Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty i godziny. |
|
x-ms-source-if-match |
|
Opcjonalny. Wartość elementu ETag. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy element ETag źródła jest zgodny z określoną wartością. Element ETag musi być określony w cudzysłowie. |
|
x-ms-source-if-none-match |
|
Opcjonalny. Wartość ETag lub specjalna wartość wieloznaczny ("*"). Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy element ETag źródła nie jest zgodny z określoną wartością. Element ETag musi być określony w cudzysłowie. |
|
x-ms-source-if-modified-since |
|
Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy źródło zostało zmodyfikowane od określonej daty i godziny. |
|
x-ms-source-if-unmodified-since |
|
Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy źródło nie zostało zmodyfikowane od określonej daty i godziny. |
|
x-ms-encryption-key |
|
Opcjonalny. Klucz szyfrowania AES-256 zakodowany w formacie Base64. |
|
x-ms-encryption-key-sha256 |
|
Opcjonalny. Skrót SHA256 zakodowany w formacie Base64 klucza szyfrowania. |
|
x-ms-encryption-algorithm: AES256 |
|
Opcjonalny. Określa algorytm do użycia do szyfrowania. Wartość tego nagłówka musi być AES256. |
|
x-ms-encryption-context |
|
Opcjonalny. Wartość domyślna to "Empty" (Puste). Jeśli wartość zostanie ustawiona, ustawi metadane obiektu blob/systemu plików. Maksymalna długość— 1024. Prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. |
|
x-ms-client-request-id |
|
Identyfikator UUID zarejestrowany w dziennikach analizy na potrzeby rozwiązywania problemów i korelacji. Regex pattern: |
|
x-ms-date |
|
Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Jest to wymagane w przypadku korzystania z autoryzacji klucza współdzielonego. |
|
x-ms-version |
|
Określa wersję protokołu REST używanego do przetwarzania żądania. Jest to wymagane w przypadku korzystania z autoryzacji klucza współdzielonego. |
Odpowiedzi
Name | Type | Description |
---|---|---|
201 Created |
Plik lub katalog został utworzony. Headers
|
|
Other Status Codes |
Wystąpił błąd. Poniżej wymieniono możliwy stan HTTP, kod i ciągi komunikatów:
Headers
|
Definicje
Data |
|
Error |
Obiekt odpowiedzi na błąd usługi. |
Path |
Opcjonalny. Prawidłowe tylko wtedy, gdy przestrzeń nazw jest włączona. Ten parametr określa zachowanie operacji zmiany nazwy. Wartość musi być "starsza" lub "posix", a wartością domyślną będzie "posix". |
Path |
Wymagane tylko w przypadku tworzenia pliku i tworzenia katalogu. Wartość musi mieć wartość "file" lub "directory". |
DataLakeStorageError
Name | Type | Description |
---|---|---|
error |
Obiekt odpowiedzi na błąd usługi. |
Error
Obiekt odpowiedzi na błąd usługi.
Name | Type | Description |
---|---|---|
code |
|
Kod błędu usługi. |
message |
|
Komunikat o błędzie usługi. |
PathRenameMode
Opcjonalny. Prawidłowe tylko wtedy, gdy przestrzeń nazw jest włączona. Ten parametr określa zachowanie operacji zmiany nazwy. Wartość musi być "starsza" lub "posix", a wartością domyślną będzie "posix".
Name | Type | Description |
---|---|---|
legacy |
|
|
posix |
|
PathResourceType
Wymagane tylko w przypadku tworzenia pliku i tworzenia katalogu. Wartość musi mieć wartość "file" lub "directory".
Name | Type | Description |
---|---|---|
directory |
|
|
file |
|