Udostępnij za pośrednictwem

Path - Create

  • Odwołanie
Usługa:
Storage Services
Wersja interfejsu API:
2023-08-03

Tworzenie pliku | Tworzenie katalogu | Zmienianie nazwy pliku | Zmienianie nazwy 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 jest uszkodzona. Należy pamiętać, że zmiana nazwy pliku lub katalogu w kontenerze z wymuszonymi zasadami szyfrowania kontenerów nie jest dozwolona, chyba że kontener źródłowy ma również wymuszone zasady szyfrowania kontenera, które są zgodne. 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 obiekt docelowy już istnieje, użyj żądania warunkowego z poleceniem If-None-Match: "*".

PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
Z parametrami opcjonalnymi: 
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
 path True

string

Nazwa konta usługi Azure Storage.
dnsSuffix
 path True

string

Sufiks DNS dla punktu końcowego usługi Azure Data Lake Storage.
filesystem
 path True

string

Identyfikator systemu plików.

Wzorzec wyrażenia regularnego: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

Ścieżka pliku lub katalogu.
continuation
 query

string

Fakultatywny. Podczas zmieniania nazwy katalogu liczba ścieżek, które są zmieniane przy użyciu każdego wywołania, jest ograniczona. Jeśli liczba ścieżek do zmiany nazwy przekracza ten limit, token kontynuacji zostanie zwrócony w tym nagłówku odpowiedzi. Gdy w odpowiedzi zostanie zwrócony token kontynuacji, należy go określić w kolejnym wywołaniu operacji zmiany nazwy, aby kontynuować zmianę nazwy katalogu.
mode
 query

PathRenameMode

Fakultatywny. 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".
resource
 query

PathResourceType

Wymagane tylko w przypadku tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog".
timeout
 query

integer

int32

Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się od momentu odebrania żą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"

Nazwa Wymagane Typ Opis
Cache-Control

string

Fakultatywny. 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

string

Fakultatywny. 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

string

Fakultatywny. Określa język naturalny używany przez zamierzonych odbiorców dla pliku.
Content-Disposition

string

Fakultatywny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Disposition" dla operacji "Odczyt pliku".
x-ms-cache-control

string

Fakultatywny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Cache-Control" dla operacji "Odczyt pliku".
x-ms-content-type

string

Fakultatywny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Type" dla operacji "Odczyt pliku".
x-ms-content-encoding

string

Fakultatywny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Encoding" dla operacji "Odczyt pliku".
x-ms-content-language

string

Fakultatywny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Language" dla operacji "Odczyt pliku".
x-ms-content-disposition

string

Fakultatywny. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Disposition" dla operacji "Odczyt pliku".
x-ms-rename-source

string

Opcjonalna nazwa 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 sygnatury dostępu współdzielonego. 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

string

Fakultatywny. Identyfikator dzierżawy dla ścieżki określonej w identyfikatorze URI. Ścieżka do zastąpienia musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny.

Wzorzec wyrażenia regularnego: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-source-lease-id

string

Opcjonalnie 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.

Wzorzec wyrażenia regularnego: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-properties

string

Fakultatywny. Właściwości zdefiniowane przez użytkownika, które mają być przechowywane w pliku lub katalogu, w formacie rozdzielanej przecinkami listy par 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

string

Opcjonalne i prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. 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ą zarówno symboliczne (rwxrw-rw-) i 4-cyfrowe notacje ósemkowe (np. 0766). Bit lepki jest również obsługiwany i w notacji symbolicznej, reprezentowany 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 niezwiązany odpowiednio (np. rwxrw-rw- z lepki bit jest reprezentowany jako rwxrw-rwT. Rwxrw-rwx z lepki bit jest reprezentowany jako rwxrw-rwt), brak t lub T wskazuje lepki bit nie ustawiono. W 4-cyfrowej notacji ósemkowej jest reprezentowana przez 1 cyfrę (np. 1766 reprezentuje rwxrw-rw- z lepkim bitem i 0766 reprezentuje rwxrw-rw- bez lepki bit). Nieprawidłowy w połączeniu z x-ms-acl.
x-ms-umask

string

Opcjonalne i prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. Podczas tworzenia pliku lub katalogu, a folder nadrzędny nie ma domyślnej listy ACL, maska umask ogranicza uprawnienia do utworzenia pliku lub katalogu. Wynikowe uprawnienie jest podane przez p & ^u, gdzie p jest uprawnieniem i jest maską umask. Jeśli na przykład wartość p to 0777 i masz 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

string

Opcjonalne i prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. Ustawia właściciela pliku lub katalogu.
x-ms-group

string

Opcjonalne i prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. Ustawia grupę będącą właścicielem pliku lub katalogu.
x-ms-acl

string

Opcjonalne i prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. 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 należącej do grupy 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 jest pomijany dla wpisów typu "maska" i "inne". Identyfikator użytkownika lub grupy jest również pomijany dla właściciela i grupy właściciela. Pole uprawnień jest sekwencją 3-znakową, 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 nie udzielono dostępu, znak "-" jest używany do oznaczania, że uprawnienie zostało odrzucone. Na przykład następująca lista ACL przyznaje prawa do odczytu, zapisu i wykonywania do właściciela pliku i john.doe@contoso, prawa do odczytu do grupy właściciela i nic dla wszystkich innych: "user::rwx,user:john.doe@contoso:rwx,group::r--,ther::---,mask=rwx". Nieprawidłowa w połączeniu z uprawnieniami x-ms..
x-ms-proposed-lease-id

string

Fakultatywny. 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.

Wzorzec wyrażenia regularnego: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-expiry-option

string

Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta i 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żącego czasu. 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 tak, aby nigdy nie wygasał, czas wygaśnięcia nie musi być określony za pomocą tej opcji.
x-ms-expiry-time

string

Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta i 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

string

Fakultatywny. 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

string

Fakultatywny. Wartość elementu ETag lub specjalna wartość wieloznaczny ("*"). 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

string

Fakultatywny. 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

string

Fakultatywny. 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

string

Fakultatywny. 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

string

Fakultatywny. Wartość elementu 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

string

Fakultatywny. 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

string

Fakultatywny. 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

string

Fakultatywny. Klucz szyfrowania AES-256 zakodowany w formacie Base64.
x-ms-encryption-key-sha256

string

Fakultatywny. Skrót SHA256 zakodowany w formacie Base64 klucza szyfrowania.
x-ms-encryption-algorithm: AES256

string

Fakultatywny. Określa algorytm do użycia na potrzeby szyfrowania. Wartość tego nagłówka musi być AES256.
x-ms-encryption-context

string

Fakultatywny. Wartość domyślna to "Empty" (Pusty). Jeśli wartość zostanie ustawiona, ustawi metadane obiektu blob/systemu plików. Maksymalna długość— 1024. Prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw.
x-ms-client-transaction-id

string

Fakultatywny. Wartość domyślna to "Empty" (Pusty). Jeśli wartość zostanie ustawiona, ustawi metadane obiektu blob podczas tworzenia lub zmieniania nazwy pliku. Jeśli limit czasu żądania dla klienta, tę wartość można pobrać przy użyciu wywołania Pobierz właściwości, aby potwierdzić, czy upłynął limit czasu żądania zakończył się powodzeniem, czy nie na końcu usługi. Maksymalna długość — 36. Prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw.
x-ms-client-request-id

string

Identyfikator UUID zarejestrowany w dziennikach analizy na potrzeby rozwiązywania problemów i korelacji.

Wzorzec wyrażenia regularnego: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

Określa uniwersalny czas koordynowany (UTC) dla żądania. Jest to wymagane w przypadku korzystania z autoryzacji klucza współużytkowanego.
x-ms-version

string

Określa wersję protokołu REST używanego do przetwarzania żądania. Jest to wymagane w przypadku korzystania z autoryzacji klucza współużytkowanego.

Odpowiedzi

Nazwa Typ Opis
201 Created

Plik lub katalog został utworzony.

Nagłówki

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Length: integer
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
Other Status Codes

DataLakeStorageError

Wystąpił błąd. Poniżej wymieniono możliwe stany HTTP, kod i ciągi komunikatów:

  • 400 Nieprawidłowe żądanie, ContentLengthMustBeZero, "Nagłówek żądania Content-Length musi mieć wartość zero".
  • 400 Nieprawidłowe żądanie, InvalidAuthenticationInfo, "Informacje o uwierzytelnianiu nie są podane w poprawnym formacie. Sprawdź wartość nagłówka autoryzacji".
  • 400 Nieprawidłowe żądanie, InvalidFlushPosition, "Przekazane dane nie są ciągłe lub wartość parametru zapytania pozycji nie jest równa długości pliku po dołączeniu przekazanych danych".
  • 400 Nieprawidłowe żądanie, InvalidHeaderValue, "Wartość jednego z nagłówków HTTP nie jest prawidłowa".
  • 400 Nieprawidłowe żądanie, InvalidHttpVerb, "Określony czasownik HTTP jest nieprawidłowy — nie jest rozpoznawany przez serwer".
  • 400 Nieprawidłowe żądanie, InvalidInput, "Jeden z danych wejściowych żądania jest nieprawidłowy".
  • 400 Nieprawidłowe żądanie, InvalidPropertyName, "Nazwa właściwości nie może być pusta".
  • 400 Nieprawidłowe żądanie, InvalidPropertyName, "Nazwa właściwości zawiera nieprawidłowe znaki".
  • 400 Nieprawidłowe żądanie, InvalidQueryParameterValue, "Wartość dla jednego z parametrów zapytania określonych w identyfikatorze URI żądania jest nieprawidłowa".
  • 400 Nieprawidłowe żądanie, InvalidResourceName, "Określona nazwa zasobu zawiera nieprawidłowe znaki".
  • 400 Nieprawidłowe żądanie, InvalidSourceUri, "Źródłowy identyfikator URI jest nieprawidłowy".
  • 400 Nieprawidłowe żądanie, InvalidUri, "Identyfikator URI żądania jest nieprawidłowy".
  • 400 Nieprawidłowe żądanie, MissingRequiredHeader, "Nie określono nagłówka HTTP, który jest obowiązkowy dla tego żądania".
  • 400 Nieprawidłowe żądanie, MissingRequiredQueryParameter, "Nie określono parametru zapytania, który jest obowiązkowy dla tego żądania".
  • 400 Nieprawidłowe żądanie, MultipleConditionHeadersNotSupported, "Wiele nagłówków warunku nie jest obsługiwanych".
  • 400 Nieprawidłowe żądanie, OutOfRangeInput, "Jeden z danych wejściowych żądania jest poza zakresem."
  • 400 Nieprawidłowe żądanie, OutOfRangeQueryParameterValue, "Jeden z parametrów zapytania określonych w identyfikatorze URI żądania jest poza dopuszczalnym zakresem".
  • 400 Nieprawidłowe żądanie, NieobsługiwaneHeader, "Jeden z nagłówków określonych w żądaniu nie jest obsługiwany".
  • 400 Nieprawidłowe żądanie, NieobsługiwaneQueryParameter, "Jeden z parametrów zapytania określonych w identyfikatorze URI żądania nie jest obsługiwany".
  • 400 Nieprawidłowe żądanie, NieobsługiwaneRestVersion, "Określona wersja REST jest nieobsługiwana".
  • 403 Zabronione, AccountIsDisabled, "Określone konto jest wyłączone".
  • 403 Zabronione, AuthorizationFailure, "To żądanie nie jest autoryzowane do wykonania tej operacji."
  • 403 Zabronione, InsufficientAccountPermissions: "Dostęp do konta nie ma wystarczających uprawnień do wykonania tej operacji".
  • 404 Nie znaleziono, FilesystemNotFound, "Określony system plików nie istnieje".
  • 404 Nie znaleziono, PathNotFound, "Określona ścieżka nie istnieje".
  • 404 Nie znaleziono, RenameDestinationParentPathNotFound, "Katalog nadrzędny ścieżki docelowej nie istnieje".
  • 404 Nie znaleziono, ResourceNotFound, "Określony zasób nie istnieje".
  • 404 Nie znaleziono, SourcePathNotFound, "Ścieżka źródłowa operacji zmiany nazwy nie istnieje".
  • 405, Metoda Niedozwolona, NieobsługiwanaHttpVerb, "Zasób nie obsługuje określonego czasownika HTTP".
  • Konflikt 409, DestinationPathIsBeingDeleted, "Określona ścieżka docelowa jest oznaczona do usunięcia."
  • 409 Conflict, DirectoryNotEmpty, "Wartość parametru zapytania cyklicznego musi być prawdziwa, aby usunąć niepusty katalog".
  • 409 Conflict, FilesystemAlreadyExists, "Określony system plików już istnieje."
  • 409 Conflict, FilesystemBeingDeleted, "Określony system plików jest usuwany."
  • 409 Conflict, InvalidDestinationPath, "Określona ścieżka lub element ścieżki, istnieje, a jego typ zasobu jest nieprawidłowy dla tej operacji." * 409 Konflikt, InvalidFlushOperation, "Zasób został utworzony lub zmodyfikowany przez interfejs API usługi Blob Service i nie może być zapisany przez interfejs API usługi Data Lake Storage."
  • 409 Konflikt, InvalidRenameSourcePath, "Katalog źródłowy nie może być taki sam jak katalog docelowy, ani nie może być podkatalogem katalogu źródłowego."
  • Konflikt 409, InvalidSourceOrDestinationResourceType, "Typ zasobu źródłowego i docelowego musi być identyczny".
  • 409 Konflikt, LeaseAlreadyPresent, "Istnieje już dzierżawa".
  • 409 Konflikt, LeaseIdMismatchWithLeaseOperation, "Określony identyfikator dzierżawy nie był zgodny z identyfikatorem dzierżawy zasobu z określoną operacją dzierżawy.
  • 409 Konflikt, LeaseIsAlreadyBroken, "Dzierżawa została już przerwana i nie można go złamać ponownie."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeAcquired: "Identyfikator dzierżawy jest zgodny, ale dzierżawa jest obecnie w stanie przerwania i nie można jej uzyskać, dopóki nie zostanie przerwana".
  • 409 Konflikt, LeaseIsBreakingAndCannotBeChanged, "Identyfikator dzierżawy jest zgodny, ale dzierżawa jest obecnie w stanie przerwania i nie można jej zmienić".
  • 409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "Identyfikator dzierżawy został dopasowany, ale dzierżawa została jawnie przerwana i nie można jej odnowić".
  • 409 Konflikt, LeaseNameMismatch, "Określona nazwa dzierżawy nie jest zgodna z istniejącą nazwą dzierżawy".
  • Konflikt 409, LeaseNotPresentWithLeaseOperation, "Identyfikator dzierżawy nie jest obecny w określonej operacji dzierżawy".
  • 409 Konflikt, PathAlreadyExists, "Określona ścieżka już istnieje".
  • 409 Konflikt, PathConflict, "Określona ścieżka lub element ścieżki istnieje, a jego typ zasobu jest nieprawidłowy dla tej operacji".
  • 409 Conflict, SourcePathIsBeingDeleted, "Określona ścieżka źródłowa jest oznaczona do usunięcia."
  • 409 Konflikt, ResourceTypeMismatch, "Typ zasobu określony w żądaniu nie jest zgodny z typem zasobu.
  • 412 Warunek wstępny nie powiodł się, ConditionNotMet, "Warunek określony przy użyciu nagłówków warunkowych HTTP nie jest spełniony."
  • 412 Warunek wstępny nie powiodło się, LeaseIdMismatch, "Określony identyfikator dzierżawy nie był zgodny z identyfikatorem dzierżawy zasobu."
  • 412 Warunek wstępny nie powiodło się, LeaseIdMissing: "Obecnie istnieje dzierżawa zasobu i nie określono identyfikatora dzierżawy w żądaniu."
  • 412 Warunek wstępny nie powiodło się, DzierżawaNotPresent: "Obecnie nie ma dzierżawy zasobu".
  • 412 Warunek wstępny nie powiódł się, LeaseLost, "Określono identyfikator dzierżawy, ale dzierżawa zasobu wygasła".
  • 412 Warunek wstępny nie powiodł się, SourceConditionNotMet, "Warunek źródłowy określony przy użyciu nagłówków warunkowych HTTP nie jest spełniony."
  • 413 Request Entity Too Large (Zbyt duża jednostka żądania, RequestBodyTooLarge), "Treść żądania jest zbyt duża i przekracza maksymalny dopuszczalny limit".
  • 416 Żądany zakres nie jest satisfiable, InvalidRange, "Określony zakres jest nieprawidłowy dla bieżącego rozmiaru zasobu."
  • 500 Wewnętrzny błąd serwera, InternalError, "Serwer napotkał błąd wewnętrzny. Ponów próbę żądania".
  • 500 Wewnętrzny błąd serwera, OperationTimedOut, "Nie można ukończyć operacji w dozwolonym czasie".
  • 503 Usługa niedostępna, ServerBusy, "Ruch wychodzący przekracza limit konta".
  • 503 Usługa niedostępna, ServerBusy, "Ruch przychodzący przekracza limit konta".
  • 503 Usługa niedostępna, ServerBusy, "Operacje na sekundę przekracza limit konta".
  • 503 Usługa niedostępna, ServerBusy, "Serwer nie może obecnie odbierać żądań. Ponów próbę żądania".

Nagłówki

  • x-ms-request-id: string
  • x-ms-version: string

Definicje

Nazwa Opis
DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.
PathRenameMode

Fakultatywny. 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".
PathResourceType

Wymagane tylko w przypadku tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog".

DataLakeStorageError

Nazwa Typ Opis
error

Error

Obiekt odpowiedzi na błąd usługi.

Error

Obiekt odpowiedzi na błąd usługi.

Nazwa Typ Opis
code

string

Kod błędu usługi.
message

string

Komunikat o błędzie usługi.

PathRenameMode

Fakultatywny. 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".

Nazwa Typ Opis
legacy

string

posix

string

PathResourceType

Wymagane tylko w przypadku tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog".

Nazwa Typ Opis
directory

string

file

string