Udostępnij za pośrednictwem


Path - Update

Dołączanie danych | Opróżnianie danych | Ustawianie właściwości | Ustawianie Access Control
Przekazuje dane, które mają być dołączane do pliku, opróżnia (zapisy) wcześniej przekazane dane do pliku, ustawia właściwości pliku lub katalogu lub ustawia kontrolę dostępu dla pliku lub katalogu. Dane można dołączać tylko do pliku. Współbieżne operacje zapisu w tym samym pliku przy użyciu wielu klientów nie są obsługiwane. 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.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&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 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.

action
query True

PathUpdateAction

Akcja musi być "dołączana", aby przekazać dane do pliku, "flush" w celu opróżnienia wcześniej przekazanych danych do pliku, "setProperties", aby ustawić właściwości pliku lub katalogu lub "setAccessControl", aby ustawić właściciela, grupę, uprawnienia lub listę kontroli dostępu dla pliku lub katalogu lub "setAccessControlRecursive", aby ustawić listę kontroli dostępu dla katalogu rekursywnie. Należy pamiętać, że hierarchiczna przestrzeń nazw musi być włączona dla konta w celu korzystania z kontroli dostępu. Należy również pamiętać, że lista Access Control (ACL) zawiera uprawnienia właściciela, grupy będącej właścicielem i innych, dzięki czemu nagłówki żądań x-ms-ms-acl wzajemnie się wykluczają.

close
query

boolean

Zdarzenia usługi Azure Storage umożliwiają aplikacjom odbieranie powiadomień po zmianie plików. Po włączeniu zdarzeń usługi Azure Storage jest zgłaszane zdarzenie zmiany pliku. To zdarzenie ma właściwość wskazującą, czy jest to ostateczna zmiana, aby odróżnić różnicę między pośrednim opróżnianiem strumienia plików a ostatecznym zamknięciem strumienia plików. Parametr zamykania zapytania jest prawidłowy tylko wtedy, gdy akcja jest "opróżniona", a powiadomienia o zmianie są włączone. Jeśli wartość close ma wartość "true", a operacja opróżniania zakończy się pomyślnie, usługa zgłasza powiadomienie o zmianie pliku z właściwością wskazującą, że jest to ostateczna aktualizacja (strumień plików został zamknięty). Jeśli zostanie zgłoszone powiadomienie o zmianie "false" wskazujące, że plik uległ zmianie. Wartością domyślną jest false. Ten parametr zapytania jest ustawiony na wartość true przez sterownik ABFS usługi Hadoop, aby wskazać, że strumień plików został zamknięty.

continuation
query

string

Opcjonalne i prawidłowe tylko dla operacji "setAccessControlRecursive". Liczba ścieżek przetworzonych przy każdym wywołaniu jest ograniczona. Jeśli liczba ścieżek do przetworzenia przekracza ten limit, token kontynuacji jest zwracany w nagłówku odpowiedzi x-ms-continuation. Gdy token kontynuacji jest zwracany w odpowiedzi, musi być zakodowany procentowo i określony w kolejnym wywołaniu operacji setAccessControlRecursive.

flush
query

boolean

Prawidłowe tylko w przypadku wywołań dołączania. Ten parametr umożliwia funkcji wywołującej opróżnianie podczas wywołania dołączania. Wartość domyślna to "false", jeśli "true" dane zostaną opróżnione za pomocą wywołania dołączania. Należy pamiętać, że w przypadku używania funkcji flush=true następujące nagłówki nie są obsługiwane — "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Aby ustawić te nagłówki podczas opróżniania, użyj akcji=flush

forceFlag
query

boolean

Opcjonalne i prawidłowe tylko dla operacji "setAccessControlRecursive". Jeśli jest to operacja "false" zakończy się szybko po napotkaniu błędów użytkownika (4XX). Jeśli "true" interfejs API zignoruje błędy użytkownika i przejdzie do operacji na innych podrzędnych jednostkach katalogu. Szczegółowy stan błędów użytkownika zostanie zwrócony w odpowiedzi dla dowolnego scenariusza. Token kontynuacji zostanie zwrócony tylko wtedy, gdy wartość forceFlag ma wartość "true" w przypadku błędów użytkownika. Wartość domyślna dla forceFlag ma wartość false.

maxRecords
query

integer

int32

Opcjonalne i prawidłowe tylko dla operacji "setAccessControlRecursive". Określa maksymalną liczbę plików lub katalogów, na których zostanie zastosowana zmiana listy ACL. Jeśli pominięto lub większą niż 2000, żądanie przetworzy maksymalnie 2000 elementów

mode
query

string

Opcjonalny. Prawidłowe i wymagane dla operacji "setAccessControlRecursive". Tryb "set" ustawia prawa kontroli dostępu POSIX dla plików i katalogów, "modify" modyfikuje co najmniej jeden prawa kontroli dostępu POSIX, które istnieją wcześniej w plikach i katalogach, "usuń" usuwa co najmniej jedno prawa kontroli dostępu POSIX, które były obecne wcześniej w plikach i katalogach

position
query

integer

int64

Ten parametr umożliwia obiektowi wywołującym równoległe przekazywanie danych i kontrolowanie kolejności dołączania ich do pliku. Jest to wymagane podczas przekazywania danych do pliku i opróżniania wcześniej przekazanych danych do pliku. Wartość musi być pozycją, w której dane mają być dołączane. Przekazane dane nie są natychmiast opróżniane ani zapisywane w pliku. Aby opróżnić, wcześniej przekazane dane muszą być ciągłe, parametr position musi być określony i równy długości pliku po zapisaniu wszystkich danych i nie może istnieć treść jednostki żądania dołączona do żądania.

retainUncommittedData
query

boolean

Prawidłowe tylko dla operacji opróżniania. Jeśli wartość "true", niezatwierdzone dane są zachowywane po zakończeniu operacji opróżniania; w przeciwnym razie niezatwierdzone dane są usuwane po operacji opróżniania. Wartością domyślną jest false. Dane z przesunięciem mniejszym niż określona pozycja są zapisywane w pliku po pomyślnym opróżnieniu, ale ten opcjonalny parametr umożliwia zachowanie danych po ustawieniu opróżnienia dla przyszłej operacji opróżniania.

timeout
query

integer

int32

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", "text/plain"

Nazwa Wymagane Typ Opis
Content-Length

integer

int64

Wymagane dla parametrów "Append Data" i "Flush Data" (Opróżnianie danych). Musi mieć wartość 0 dla elementu "Flush Data" (Opróżnianie danych). Musi być długością zawartości żądania w bajtach dla funkcji "Dołącz dane".

Content-MD5

string

Opcjonalny. Skrót MD5 zawartości żądania. Ten nagłówek jest prawidłowy w operacjach "Append" i "Flush". Ten skrót służy do weryfikowania integralności zawartości żądania podczas transportu. Po określeniu tego nagłówka usługa magazynu porównuje skrót zawartości, która dotarła z tą wartością nagłówka. Jeśli dwa skróty nie są zgodne, operacja zakończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie). Należy pamiętać, że ten skrót MD5 nie jest przechowywany w pliku . Ten nagłówek jest skojarzony z zawartością żądania, a nie z przechowywaną zawartością samego pliku.

x-ms-lease-id

string

Identyfikator dzierżawy należy określić, jeśli istnieje aktywna dzierżawa. Nieprawidłowy dla operacji "setAccessControlRecursive".

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

x-ms-cache-control

string

Opcjonalne i prawidłowe tylko dla operacji opróżniania i ustawiania właściwości. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Cache-Control" dla operacji "Odczyt pliku".

x-ms-content-type

string

Opcjonalne i prawidłowe tylko dla operacji opróżniania i ustawiania właściwości. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Type" dla operacji "Odczyt pliku".

x-ms-content-disposition

string

Opcjonalne i prawidłowe tylko dla operacji opróżniania i ustawiania właściwości. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Disposition" dla operacji "Odczyt pliku".

x-ms-content-encoding

string

Opcjonalne i prawidłowe tylko dla operacji opróżniania i ustawiania właściwości. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Kodowanie zawartości" dla operacji "Odczyt pliku".

x-ms-content-language

string

Opcjonalne i prawidłowe tylko dla operacji opróżniania i ustawiania właściwości. Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Language" dla operacji "Odczyt pliku".

x-ms-content-md5

string

Opcjonalne i prawidłowe tylko dla operacji "Opróżnianie i ustawianie właściwości". Usługa przechowuje tę wartość i uwzględnia ją w nagłówku odpowiedzi "Content-Md5" dla operacji "Odczyt i pobierz właściwości". Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji "Odczyt i Pobierz właściwości" nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na ten plik ponownie.

x-ms-properties

string

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. Prawidłowa tylko dla operacji setProperties. Jeśli plik lub katalog istnieje, wszystkie właściwości, które nie znajdują się na liście, zostaną usunięte. Wszystkie właściwości zostaną usunięte, jeśli nagłówek zostanie pominięty. Aby scalić nowe i istniejące właściwości, najpierw pobierz wszystkie istniejące właściwości i bieżący tag E-Tag, a następnie utwórz żądanie warunkowe z tagiem E-Tag i dołącz wartości dla wszystkich właściwości.

x-ms-owner

string

Opcjonalne i prawidłowe tylko dla operacji setAccessControl. Ustawia właściciela pliku lub katalogu.

x-ms-group

string

Opcjonalne i prawidłowe tylko dla operacji setAccessControl. Ustawia grupę będącą właścicielem pliku lub katalogu.

x-ms-permissions

string

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-acl

string

Opcjonalne i prawidłowe tylko dla setAccessControl i setAccessControlRecursive operacji. Wymagane dla operacji setAccessControlRecursive. Ustawia prawa kontroli dostępu POSIX dla plików i katalogów. Wartość jest rozdzielaną przecinkami listą wpisów kontroli dostępu, które w pełni zastępują istniejącą listę kontroli dostępu (ACL) w przypadku ustawieniaAccessControl i "set" trybu setAccessControlRecursive. Tryb "modify" setAccessControlRecursive aktualizuje istniejące listy ACLS. 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ń to 3-znakowa sekwencja, 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. Tryb "remove" setAccessControlRecursive usuwa istniejące listy ACL i nie powinien zawierać uprawnień na liście kontroli dostępu określonej: "user:john.doe@contoso:, mask:". Tryb "set" setAccessControlRecursive ustawia listy ACL zastępujące wstępnie istniejące listy ACL zakresu określonego i musi zawierać wszystkie trzy — właściciel grupy, grupy będącej właścicielem i inne informacje, jeśli zakres dostępu jest ustawiany lub jeśli którykolwiek z użytkowników będących właścicielami, grupy będącej właścicielem lub innych jest ustawiany w zakresie domyślnym. Tryby "set" i "modify" setAccessControlRecursive muszą zawierać uprawnienia w ramach listy kontroli dostępu.

If-Match

string

Opcjonalne w przypadku opróżniania danych, Ustaw Access Control i Ustaw właściwości, ale są nieprawidłowe dla funkcji Dołącz dane i Ustaw Access Control cykliczne. 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

Opcjonalne w przypadku opróżniania danych, Ustaw Access Control i Ustaw właściwości, ale są nieprawidłowe dla funkcji Dołącz dane i Ustaw Access Control cykliczne. 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

string

Opcjonalnie dla funkcji Opróżnij dane i ustaw właściwości, ale są nieprawidłowe w przypadku dołączania danych i zestawu Access Control cykliczne. 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

Opcjonalnie dla funkcji Opróżnij dane i ustaw właściwości, ale są nieprawidłowe w przypadku dołączania danych i zestawu Access Control cykliczne. 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-encryption-key

string

Opcjonalny. Klucz szyfrowania AES-256 zakodowany w formacie Base64.

x-ms-encryption-key-sha256

string

Opcjonalny. Skrót SHA256 zakodowany w formacie Base64 klucza szyfrowania.

x-ms-encryption-algorithm: AES256

string

Opcjonalny. Określa algorytm do użycia na potrzeby szyfrowania. Wartość tego nagłówka musi być AES256.

x-ms-lease-action True

PathLeaseAction

Począwszy od wersji 2020-08-04 w operacjach dołączania i opróżniania. Funkcja Append obsługuje akcję "acquire", "auto-renew" i "acquire-release". Jeśli "nabędzie" dzierżawę. Jeśli opcja "automatyczne odnawianie" zostanie odnowiona dzierżawa. Jeśli element "acquire-release" zostanie uzyskany & ukończy operację & zwolni dzierżawę po zakończeniu operacji. Akcja "Wydanie" jest obsługiwana tylko w operacji opróżniania. Jeśli wartość "true", zwolni dzierżawę pliku przy użyciu informacji o identyfikatorze dzierżawy z nagłówka x-ms-lease-id.

x-ms-lease-duration

integer

int32

Czas trwania dzierżawy jest wymagany do uzyskania dzierżawy i określa czas trwania dzierżawy w sekundach. Czas trwania dzierżawy musi wynosić od 15 do 60 sekund lub -1 w przypadku nieskończonej dzierżawy.

x-ms-proposed-lease-id

string

Wymagane, gdy akcja "x-ms-lease-action" to "acquire" lub "change". Dzierżawa zostanie przejęta przy użyciu tego identyfikatora dzierżawy, jeśli operacja zakończy się pomyślnie.

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

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 dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Jest to wymagane w przypadku korzystania z autoryzacji klucza współdzielonego.

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ółdzielonego.

Treść żądania

Media Types: "application/octet-stream", "text/plain"

Nazwa Typ Opis
requestBody

object

Prawidłowe tylko w przypadku operacji dołączania. Dane, które mają zostać przekazane i dołączone do pliku.

Odpowiedzi

Nazwa Typ Opis
200 OK

SetAccessControlRecursiveResponse

Dane zostały pomyślnie opróżnione (zapisane) do pliku lub właściwości zostały ustawione pomyślnie. Treść odpowiedzi jest opcjonalna i jest prawidłowa tylko dla polecenia "SetAccessControlRecursive"

Nagłówki

  • Date: string
  • ETag: string
  • Last-Modified: string
  • Accept-Ranges: string
  • Cache-Control: string
  • Content-Disposition: string
  • Content-Encoding: string
  • Content-Language: string
  • Content-Length: integer
  • Content-Range: string
  • Content-Type: string
  • Content-MD5: string
  • x-ms-properties: string
  • x-ms-continuation: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
  • x-ms-lease-renewed: boolean
202 Accepted

Przekazane dane zostały zaakceptowane.

Nagłówki

  • Content-MD5: string
  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-renewed: boolean
Other Status Codes

DataLakeStorageError

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

  • 400 Nieprawidłowe żądanie, ContentLengthMustBeZero, "Nagłówek żądania Content-Length musi być zerowy".
  • 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 w poprawnym formacie".
  • 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, "Identyfikator URI źródła 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 Method Not Allowed( UnsupportedHttpVerb) "Zasób nie obsługuje określonego czasownika HTTP".
  • 409 Konflikt, DestinationPathIsBeingDeleted: "Określona ścieżka docelowa jest oznaczona jako usunięta".
  • 409 Konflikt, DirectoryNotEmpty, "Wartość parametru zapytania cyklicznego musi być prawdziwa, aby usunąć niepusty katalog".
  • 409 Konflikt, FilesystemAlreadyExists, "Określony system plików już istnieje"."
  • 409 Konflikt, System plikówBeingDeleted: "Określony system plików jest usuwany".
  • 409 Konflikt, 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żna go zapisać za pomocą interfejsu 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 jest 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 jej ponownie złamać".
  • 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 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".
  • 409 Konflikt, 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 Konflikt, SourcePathIsBeingDeleted: "Określona ścieżka źródłowa jest oznaczona jako usunięta".
  • 409 Konflikt, ResourceTypeMismatch, "Typ zasobu określony w żądaniu nie odpowiada typowi zasobu".
  • 412 Warunek nie powiodło się, WarunekNotMet, "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ę, LeaseNotPresent: "Obecnie nie ma dzierżawy zasobu".
  • 412 Warunek wstępny nie powiodło się, LeaseLost, "Określono identyfikator dzierżawy, ale dzierżawa zasobu wygasła".
  • 412 Warunek wstępny nie powiodło 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( 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
AclFailedEntryList
DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

PathLeaseAction

Począwszy od wersji 2020-08-04 operacji dołączania i opróżniania. Dołączanie obsługuje akcję "acquire", "auto-renew" i "acquire-release". W przypadku "nabycia" nabytej dzierżawy. W przypadku automatycznego odnawiania dzierżawy zostanie odnowiona. Jeśli "acquire-release" uzyska & ukończy operację, & zwolni dzierżawę po zakończeniu operacji. Akcja "Zwolnij" jest obsługiwana tylko w operacji opróżniania. W przypadku wartości "true" dzierżawa pliku zostanie zwolnina przy użyciu informacji o identyfikatorze dzierżawy z nagłówka x-ms-lease-id.

PathUpdateAction

Akcja musi mieć wartość "append", aby przekazać dane, które mają zostać dołączone do pliku, "flush", aby opróżnić wcześniej przekazane dane do pliku, "setProperties", aby ustawić właściwości pliku lub katalogu lub "setAccessControl", aby ustawić właściciela, grupę, uprawnienia lub listę kontroli dostępu dla pliku lub katalogu lub "setAccessControlRecursive", aby ustawić listę kontroli dostępu dla katalogu rekursywnie. Należy pamiętać, że hierarchiczna przestrzeń nazw musi być włączona dla konta w celu korzystania z kontroli dostępu. Należy również pamiętać, że lista Access Control (ACL) zawiera uprawnienia właściciela, grupy będącej właścicielem i innych, więc nagłówki żądań x-ms-ms-acl wzajemnie się wykluczają.

SetAccessControlRecursiveResponse

AclFailedEntryList

Nazwa Typ Opis
errorMessage

string

name

string

type

string

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.

PathLeaseAction

Począwszy od wersji 2020-08-04 operacji dołączania i opróżniania. Dołączanie obsługuje akcję "acquire", "auto-renew" i "acquire-release". W przypadku "nabycia" nabytej dzierżawy. W przypadku automatycznego odnawiania dzierżawy zostanie odnowiona. Jeśli "acquire-release" uzyska & ukończy operację, & zwolni dzierżawę po zakończeniu operacji. Akcja "Zwolnij" jest obsługiwana tylko w operacji opróżniania. W przypadku wartości "true" dzierżawa pliku zostanie zwolnina przy użyciu informacji o identyfikatorze dzierżawy z nagłówka x-ms-lease-id.

Nazwa Typ Opis
acquire

string

acquire-release

string

auto-renew

string

release

string

PathUpdateAction

Akcja musi mieć wartość "append", aby przekazać dane, które mają zostać dołączone do pliku, "flush", aby opróżnić wcześniej przekazane dane do pliku, "setProperties", aby ustawić właściwości pliku lub katalogu lub "setAccessControl", aby ustawić właściciela, grupę, uprawnienia lub listę kontroli dostępu dla pliku lub katalogu lub "setAccessControlRecursive", aby ustawić listę kontroli dostępu dla katalogu rekursywnie. Należy pamiętać, że hierarchiczna przestrzeń nazw musi być włączona dla konta w celu korzystania z kontroli dostępu. Należy również pamiętać, że lista Access Control (ACL) zawiera uprawnienia właściciela, grupy będącej właścicielem i innych, więc nagłówki żądań x-ms-ms-acl wzajemnie się wykluczają.

Nazwa Typ Opis
append

string

flush

string

setAccessControl

string

setAccessControlRecursive

string

setProperties

string

SetAccessControlRecursiveResponse

Nazwa Typ Opis
directoriesSuccessful

integer

failedEntries

AclFailedEntryList[]

failureCount

integer

filesSuccessful

integer