Path - Update

Czy ta strona jest pomocna?

Czy chcesz coś dodać do tej opinii?

Opinia zostanie wysłana do firmy Microsoft: po naciśnięciu przycisku Prześlij opinia zostanie użyta do ulepszania produktów i usług firmy Microsoft. Zasady ochrony prywatności.

Service:

Storage Services

API Version:

2021-04-10

Dołączanie | Opróżnij | Ustawianie właściwości | Ustaw Access Control
Przesyła dane, które mają zostać dołączone do pliku, opróżnia (zapisuje) 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}

With optional parameters:

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&timeout={timeout}

Parametry identyfikatora URI

Name	In	Required	Type	Description
accountName	path	True	string	Nazwa konta Storage Azure.
dnsSuffix	path	True	string	Sufiks DNS dla punktu końcowego usługi Azure Data Lake Storage końcowego.
filesystem	path	True	string	Identyfikator systemu plików. Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path	path	True	string	Ścieżka pliku lub katalogu.
action	query	True	PathUpdateAction	Akcją musi być "dołączenie", aby przekazać dane, które mają zostać dołączone do pliku, "opróżnienie" w celu opróżnienia wcześniej przekazanych danych do pliku, "setProperties" w celu ustawienia 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 rekursywnie ustawić listę kontroli dostępu dla katalogu. Należy pamiętać, że dla konta musi być włączona opcja Hierarchiczna przestrzeń nazw, aby można było korzystać z kontroli dostępu. Należy również zauważyć, że lista Access Control (ACL) zawiera uprawnienia właściciela, grupy właścicieli i innych, dlatego nagłówki żądań x-ms-permissions i x-ms-acl wzajemnie się wykluczają.
close	query		boolean	Usługa Azure Storage Events umożliwia aplikacjom odbieranie powiadomień po zmianie plików. Gdy usługa Azure Storage Events jest włączona, jest wywoływane zdarzenie zmiany pliku. To zdarzenie ma właściwość wskazującą, czy jest to ostatnia zmiana rozróżniania różnicy między pośrednim opróżnianiem do strumienia plików a końcowym zamknięciem strumienia plików. Parametr zamknij zapytanie jest prawidłowy tylko wtedy, gdy akcja jest "opróżnienie" i powiadomienia o zmianie są włączone. Jeśli wartość zamknięcia to "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 ostatnia aktualizacja (strumień plików został zamknięty). Jeśli zostanie podniesione powiadomienie o zmianie "false" wskazujące, że plik został zmieniony. Wartością domyślną jest false. Ten parametr zapytania jest ustawiany 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 użyciu każdego wywołania 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 w procentach i określony w kolejnym wywołaniach operacji setAccessControlRecursive.
forceFlag	query		boolean	Opcjonalne i prawidłowe tylko dla operacji "setAccessControlRecursive". Jeśli jest to operacja "false", operacja zakończy się szybko po napotkaniu błędów użytkownika (4XX). Jeśli wartość "true" interfejs API zignoruje błędy użytkownika i przejdzie do operacji na innych jednostkach podrzędnych katalogu. Szczegółowy stan błędów użytkownika zostanie zwrócony w odpowiedzi dla każdego ze scenariuszy. Token kontynuacji będzie zwracany tylko wtedy, gdy forceFlag ma wartość "true" w przypadku błędów użytkownika. Wartość domyślna dla forceFlag to false.
maxRecords	query		integer int32	Opcjonalne i prawidłowe tylko dla operacji "setAccessControlRecursive". Określa maksymalną liczbę plików lub katalogów, do których zostanie zastosowana zmiana listy ACL. W przypadku pominięcia lub większej niż 2000 żądanie będzie przetwarzać maksymalnie 2000 elementów
mode	query		string	Opcjonalny. Prawidłowe i wymagane dla operacji "setAccessControlRecursive". Tryb "set" ustawia prawa kontroli dostępu POSIX do plików i katalogów, "modyfikuj" modyfikuje co najmniej jedno prawo kontroli dostępu POSIX, które już istnieją w plikach i katalogach, "remove" usuwa co najmniej jedno prawo kontroli dostępu POSIX, które były obecne wcześniej w plikach i katalogach
position	query		integer int64	Ten parametr umożliwia wywołującym przekazywanie danych równolegle i sterowanie kolejnością, w jakiej są dołączane do pliku. Jest to wymagane w przypadku przekazywania danych do pliku i opróżniania wcześniej przekazanych danych do pliku. Wartość musi być położeniem, w którym mają zostać dołączone dane. 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 nagraniu wszystkich danych i nie może zawierać treści jednostki żądania dołączonej do żądania.
retainUncommittedData	query		boolean	Prawidłowe tylko w przypadku operacji opróżniwania. W przypadku wartości "true" niezatwierdzone dane są zachowywane po zakończeniu operacji opróżnień; W przeciwnym razie niezatwierdzone dane zostaną usunięte po operacji opróżninia. Wartością domyślną jest false. Dane przy przesunięciach mniejszej niż określona pozycja są zapisywane w pliku, gdy opróżnienie zakończy się pomyślnie, ale ten opcjonalny parametr umożliwia zachowywanie danych po pozycji opróżnienia dla przyszłej operacji opróżnienia.
timeout	query		integer int32	Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się, gdy żądanie zostanie odebrane 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"

Name	Required	Type	Description
Content-Length		integer int64	Wymagane dla "Dołącz dane" i "Opróżnij dane". Musi mieć 0 dla ciągu "Flush Data" (Opróżnij dane). Musi to być długość zawartości żądania w bajtach dla "Dołączanie danych".
Content-MD5		string	Opcjonalny. Skrót MD5 zawartości żądania. Ten nagłówek jest prawidłowy dla operacji "Dołącz" i "Opróżnij". Ten skrót służy do weryfikowania integralności zawartości żądania podczas transportu. Gdy ten nagłówek jest określony, usługa magazynu porównuje skrót zawartości, która dotarła z tą wartością nagłówka. Jeśli te dwa skróty nie są zgodne, operacja nie powiedzie się z kodem błędu 400 (Złe żądanie). Pamiętaj, że ten skrót MD5 nie jest przechowywany razem z plikiem . 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". Regex pattern: ^[{(]?[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 ustawienia 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 ustawienia 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 ustawienia 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 ustawienia 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 ustawienia 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 "Flush and Set Properties". 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 wyczyszona dla pliku. Kolejne wywołania właściwości "Odczyt i Pobierz właściwości" nie będą zwracać tej właściwości, chyba że zostanie ona jawnie ustawiona dla tego pliku ponownie.
x-ms-properties		string	Opcjonalny. 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. Należy pamiętać, ż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 są usuwane w przypadku pominięcia nagłówka. Aby scalić nowe i istniejące właściwości, należy najpierw pobrać wszystkie istniejące właściwości i bieżący tag E, a następnie wykonać żądanie warunkowe za pomocą tagu E-Tag i uwzględnić wartości wszystkich właściwości.
x-ms-owner		string	Opcjonalne i prawidłowe tylko dla setAccessControl operacji. Ustawia właściciela pliku lub katalogu.
x-ms-group		string	Opcjonalne i prawidłowe tylko dla setAccessControl operacji. Ustawia grupę, która jest właścicielem pliku lub katalogu.
x-ms-permissions		string	Opcjonalne i prawidłowe tylko wtedy, gdy dla konta jest włączona opcja Hierarchiczna przestrzeń nazw. Ustawia uprawnienia dostępu POSIX dla właściciela pliku, grupy właściciela pliku i innych. Każdej klasie można przyznać uprawnienia do odczytu, zapisu lub wykonywania. Bit sticky jest również obsługiwany. Obsługiwane są zarówno notacja symboliczna (rwxrw-rw-), jak i 4-cyfrowa notacja ósemkowa (np. 0766). Nieprawidłowy w połączeniu z x-ms-acl.
x-ms-acl		string	Opcjonalne i prawidłowe tylko dla setAccessControl i setAccessControlRecursive operacji. Wymagany dla operacji setAccessControlRecursive. Ustawia prawa kontroli dostępu POSIX do plików i katalogów. Wartość jest rozdzielaną przecinkami listą wpisów kontroli dostępu, która w pełni zastępuje istniejącą listę kontroli dostępu (ACL) w przypadku setAccessControl i "set" trybu setAccessControlRecursive. Tryb "modify" zestawAccessControlRecursive 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 "[zakres:][typ]:[id]:[uprawnienia]". Zakres musi być "domyślny", aby wskazać ACE należy do domyślnej listy ACL dla 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 jako właściciel lub nazwanej grupy, "maska" ogranicza prawa przyznane nazwanych użytkownikom i członkom grup, a "inne" przyznaje prawa wszystkim użytkownikom, których nie znaleziono w żadnym z innych wpisów. Identyfikator użytkownika lub grupy jest pomijany dla wpisów typu "mask" i "other". Identyfikator użytkownika lub grupy jest również pomijany dla właściciela i grupy właścicielem. Pole uprawnień to 3-znakowa sekwencja, w której pierwszy znak to "r" w celu udzielenia dostępu do odczytu, drugi znak to "w", aby udzielić dostępu do zapisu, a trzeci znak to "x", aby przyznać uprawnienia do wykonywania. Jeśli dostęp nie zostanie udzielony, znak "-" oznacza, że uprawnienie zostanie odrzucone. Na przykład następująca listy ACL przyznaje prawa do odczytu, john.doe@contosozapisu i wykonywania właścicielowi pliku i , prawa do odczytu do grupy, która jest właścicielem, i nic innym: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Nieprawidłowa w połączeniu z x-ms-permissions. Tryb "remove" funkcji setAccessControlRecursive usuwa istniejące listy ACL i nie powinien zawierać uprawnień na określonej liście kontroli dostępu: "user:john.doe@contoso:, mask:". Tryb "set" setAccessControlRecursive ustawia ACL zastępujące istniejące wcześniej acl ACL określonego zakresu i musi zawierać wszystkie trzy — użytkownika będącą właścicielem, grupy będącą właścicielem i inne informacje, jeśli zakres dostępu jest ustawiany lub jeśli użytkownik jest właścicielem, grupa będąca właścicielem lub inne jest ustawiony w zakresie domyślnym. Tryby "set" i "modify" funkcji setAccessControlRecursive muszą zawierać uprawnienia jako część listy kontroli dostępu.
If-Match		string	Opcjonalne w przypadku opróżnianych danych, Access Control ustaw właściwości i ustaw właściwości, ale są nieprawidłowe dla dołączania danych i Access Control cykliczne. Wartość ETag. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy tag ETag zasobu jest taki, jak określona wartość. Tag ETag musi być określony w cudzysłowie.
If-None-Match		string	Opcjonalne w przypadku opróżnianych danych, Access Control ustaw właściwości i ustaw właściwości, ale są nieprawidłowe dla dołączania danych i Access Control cykliczne. Wartość ETag lub wartość specjalnego symbolu wieloznacznego ("*"). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy tag ETag zasobu nie pasuje do określonej wartości. Tag ETag musi być określony w cudzysłowie.
If-Modified-Since		string	Opcjonalne w przypadku opróżnianych danych i właściwości zestawu, ale nieprawidłowe dla dołączania danych i 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 czasu.
If-Unmodified-Since		string	Opcjonalne w przypadku opróżnianych danych i właściwości zestawu, ale nieprawidłowe dla dołączania danych i 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 czasu.
x-ms-encryption-key		string	Opcjonalny. Klucz szyfrowania AES-256 zakodowany w formacie Base64.
x-ms-encryption-key-sha256		string	Opcjonalny. Skrót SHA256 klucza szyfrowania zakodowany w formacie Base64.
x-ms-encryption-algorithm: AES256		string	Opcjonalny. Określa algorytm, który ma być używany do szyfrowania. Wartość tego nagłówka musi być AES256.
x-ms-encryption-context		string	Opcjonalny. Wartość domyślna to "Empty". Jeśli wartość jest ustawiona, ustawi metadane obiektu blob/systemu plików. Maksymalna długość — 1024
x-ms-client-request-id		string	Identyfikator UUID zarejestrowany w dziennikach analizy na potrzeby rozwiązywania problemów i korelacji. Regex pattern: ^[{(]?[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ólnego.
x-ms-version		string	Określa wersję protokołu REST używaną do przetwarzania żądania. Jest to wymagane w przypadku korzystania z autoryzacji klucza wspólnego.

Treść żądania

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

Name	Type	Description
requestBody	object	Prawidłowy tylko dla operacji dołączania. Dane, które mają zostać przekazane i dołączone do pliku.

Odpowiedzi

Name	Type	Description
200 OK	SetAccessControlRecursiveResponse	Dane zostały 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 parametru "SetAccessControlRecursive" Headers 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
202 Accepted		Przekazane dane zostały zaakceptowane. Headers Content-MD5: string Date: string x-ms-request-id: string x-ms-version: string
Other Status Codes	DataLakeStorageError	Wystąpił błąd. Poniżej wymieniono możliwe stany HTTP, kod i ciągi komunikatów: 400 Bad Request, ContentLengthMustBeZero, "The Content-Length request header must be zero". 400 Nieprawidłowe żądanie, InvalidAuthenticationInfo, "Informacje o uwierzytelnianiu nie są podane w poprawnym formacie. Sprawdź wartość nagłówka Autoryzacja". 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łączyć przekazane dane". 400 Bad Request, InvalidHeaderValue, "The value for one of the HTTP headers is not in the correct format". 400 Nieprawidłowe żądanie, InvalidHttpVerb, "Określony czasownik HTTP jest nieprawidłowy — nie jest rozpoznawany przez serwer". 400 Nieprawidłowe żądanie, InvalidInput, "Jedno z danych wejściowych żądania jest nieprawidłowe". 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ść 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 Bad Request, MissingRequiredHeader, "An HTTP header that's mandatory for this request is not specified". 400 Bad Request, MissingRequiredQueryParameter, "A query parameter that's mandatory for this request is not specified". 400 Bad Request, MultipleConditionHeadersNotSupported, "Multiple condition headers are not supported" (Wiele nagłówków warunku nie jest obsługiwanych). 400 Bad Request, OutOfRangeInput, "One of the request inputs is out of range" (Jedno z danych wejściowych żądania jest poza zakresem). 400 Bad Request, OutOfRangeQueryParameterValue, "One of the query parameters specified in the request URI is outside the dozwolony zakres". 400 Bad Request, UnsupportedHeader, "Jeden z nagłówków określonych w żądaniu nie jest obsługiwany". 400 Bad Request, UnsupportedQueryParameter, "One of the query parameters specified in the request URI is not supported". 400 Bad Request, UnsupportedRestVersion, "The specified Rest Version is Unsupported". 403 Zabronione, AccountIsDisabled, "Określone konto jest wyłączone". 403 Zabronione, AuthorizationFailure, "To żądanie nie jest autoryzowane do wykonania tej operacji". 403 Zabronione, InsufficientAccountPermissions, "Konto, do którego uzyskuje się dostęp, 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 Not Found, SourcePathNotFound, "The source path for a rename operation does not exist". 405 Method Not Allowed, UnsupportedHttpVerb, "The resource doesn't support the specified HTTP verb". 409 Conflict, DestinationPathIsBeingDeleted, "Określona ścieżka docelowa jest oznaczona do usunięcia". 409 Conflict, DirectoryNotEmpty, "Wartość parametru zapytania cyklicznego musi mieć wartość true, 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 Conflict, InvalidFlushOperation, "Zasób został utworzony lub zmodyfikowany przez interfejs API usługi Blob Service i nie może zostać zapisany w usłudze Data Lake Storage Service API". 409 Conflict, InvalidRenameSourcePath, "Katalog źródłowy nie może być taki sam jak katalog docelowy ani nie może być podkatalogiem katalogu źródłowego". 409 Conflict, InvalidSourceOrDestinationResourceType, "Typ zasobu źródłowego i docelowego musi być identyczny". 409 Conflict, LeaseAlreadyPresent, "There is already a lease present". 409 Conflict, LeaseIdMismatchWithLeaseOperation, "The lease ID specified did not match the lease ID for the resource with the specified lease operation". 409 Conflict, LeaseIsAlreadyBroken, "Dzierżawa została już uszkodzona i nie może zostać ponownie przerwana". 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "The lease ID matched, but the lease is currently in breaking state and cannot be acquired until it is broken". 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "The lease ID matched, but the lease is currently in breaking state and cannot be changed". 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "The lease ID matched, but the lease has been broken explicitly and cannot be renewed". 409 Conflict, LeaseNameMismatch, "Określona nazwa dzierżawy nie jest dopasowana do istniejącej nazwy dzierżawy". 409 Conflict, LeaseNotPresentWithLeaseOperation, "The lease ID is not present with the specified lease operation". 409 Conflict, PathAlreadyExists, "Określona ścieżka już istnieje". 409 Conflict, PathConflict, "Istnieje określona ścieżka lub element ścieżki, 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 Conflict, ResourceTypeMismatch, "Typ zasobu określony w żądaniu nie pasuje do typu zasobu". 412 Warunek wstępny nie powiódł się, ConditionNotMet, "Warunek określony przy użyciu nagłówków warunkowych HTTP nie jest spełniony". 412 Niepowodzenie warunku wstępnego, LeaseIdMismatch, "Określony identyfikator dzierżawy nie jest zgodne z identyfikatorem dzierżawy zasobu". 412 Niepowodzenie warunku wstępnego, LeaseIdMissing, "Obecnie istnieje dzierżawa zasobu i w żądaniu nie określono identyfikatora dzierżawy". 412 Niepowodzenie warunku wstępnego, LeaseNotPresent, "Obecnie nie ma dzierżawy zasobu". 412 Niepowodzenie warunku wstępnego, LeaseLost, "Określono identyfikator dzierżawy, ale dzierżawa zasobu wygasła". 412 Niepowodzenie warunku wstępnego, 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 dozwolony limit". 416 Requested Range Not Satisfiable,InvalidRange, "The range specified is invalid for the current size of the resource" (Określony zakres jest nieprawidłowy dla bieżącego rozmiaru zasobu). 500 Internal Server Error, InternalError, "The server encountered an internal error. Ponów próbę żądania". 500 Internal Server Error, OperationTimedOut, "Nie można ukończyć operacji w dozwolonym czasie". 503 Service Unavailable ,ServerBusy, "Egress is over the account limit". 503 Service Unavailable (Usługa niedostępna), ServerBusy, "Ingress is over the account limit" (Ruch przychodzący przekracza limit konta). 503 Service Unavailable ,ServerBusy, "Operations per second is over the account limit". 503 Service Unavailable,ServerBusy, "Serwer nie może obecnie odbierać żądań. Ponów próbę żądania". Headers x-ms-request-id: string x-ms-version: string

Definicje

AclFailedEntryList
DataLakeStorageError
Error	Obiekt odpowiedzi na błąd usługi.
PathUpdateAction	Akcją musi być "dołączenie", aby przekazać dane, które mają zostać dołączone do pliku, "opróżnienie" w celu opróżnienia wcześniej przekazanych danych do pliku, "setProperties" w celu ustawienia 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 rekursywnie ustawić listę kontroli dostępu dla katalogu. Należy pamiętać, że dla konta musi być włączona opcja Hierarchiczna przestrzeń nazw, aby można było korzystać z kontroli dostępu. Należy również zauważyć, że lista Access Control (ACL) zawiera uprawnienia właściciela, grupy właścicieli i innych, dlatego nagłówki żądań x-ms-permissions i x-ms-acl wzajemnie się wykluczają.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name	Type	Description
errorMessage	string
name	string
type	string

DataLakeStorageError

Name	Type	Description
error	Error	Obiekt odpowiedzi na błąd usługi.

Error

Obiekt odpowiedzi na błąd usługi.

Name	Type	Description
code	string	Kod błędu usługi.
message	string	Komunikat o błędzie usługi.

PathUpdateAction

Akcją musi być "dołączenie", aby przekazać dane, które mają zostać dołączone do pliku, "opróżnienie" w celu opróżnienia wcześniej przekazanych danych do pliku, "setProperties" w celu ustawienia 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 rekursywnie ustawić listę kontroli dostępu dla katalogu. Należy pamiętać, że dla konta musi być włączona opcja Hierarchiczna przestrzeń nazw, aby można było korzystać z kontroli dostępu. Należy również zauważyć, że lista Access Control (ACL) zawiera uprawnienia właściciela, grupy właścicieli i innych, dlatego nagłówki żądań x-ms-permissions i x-ms-acl wzajemnie się wykluczają.

Name	Type	Description
append	string
flush	string
setAccessControl	string
setAccessControlRecursive	string
setProperties	string

SetAccessControlRecursiveResponse

Name	Type	Description
directoriesSuccessful	integer
failedEntries	AclFailedEntryList[]
failureCount	integer
filesSuccessful	integer