Path - Update

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 Specifying Conditional Headers for Blob Service Operations(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}&timeout={timeout}

Parametry identyfikatora URI

Name In Required Type Description
accountName
path True
  • string

Nazwa konta usługi Azure Storage.

dnsSuffix
path True
  • string

Sufiks DNS dla 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

Akcja musi być "dołączana", aby przekazać dane, które mają zostać dołączone do pliku, "flush" 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 albo "setAccessControlRecursive", aby rekursywnie ustawić listę kontroli dostępu dla katalogu. Pamiętaj, ż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 Access Control List (ACL) zawiera uprawnienia właściciela, grupy właściciel i innych, więc nagłówki żądań x-ms-permissions i x-ms-acl wzajemnie się wykluczają.

close
query
  • boolean

Zdarzenia usługi Azure Storage umożliwiają aplikacjom odbieranie powiadomień o zmianie plików. Gdy zdarzenia usługi Azure Storage są włączone, 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 zapytania zamykania 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 przetwarzanych za pomocą 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 wartość 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. Jeśli wartość zostanie pominięta lub większa 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 są usuwane 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 powiedzie się, ale ten opcjonalny parametr umożliwia zachowywanie danych po pozycji opróżnienia na przyszłość 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 być długością 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). 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".

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 "Opróżnij i ustaw 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 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 ponownie jawnie ustawiona dla tego pliku.

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, jeśli nagłówek zostanie pominięty. 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 operacji setAccessControl. Ustawia właściciela pliku lub katalogu.

x-ms-group
  • string

Opcjonalne i prawidłowe tylko dla operacji setAccessControl. Ustawia grupę, która jest 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ś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łowa 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 i 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 grupie właścicielom lub nazwanej grupie, "maskowanie" ogranicza prawa przyznawane 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, zapisu i wykonywania właścicielowi pliku oraz , prawo do odczytu do grupy, która jest właścicielem, i nic john.doe@contoso 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 liście kontroli dostępu określonej : " 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" właściwości setAccessControlRecursive muszą zawierać uprawnienia w ramach 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 specjalna wartość 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 opcji Dołącz dane i Ustaw 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 opcji Dołącz dane i Ustaw 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-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żywanego 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

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

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, "Podany identyfikator dzierżawy nie jest zgodne z identyfikatorem dzierżawy zasobu z określoną operacją dzierżawy".
  • 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 ConditionNotMet, 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 żądanie".
  • 500 Internal Server Error, OperationTimedOut, "Nie można ukończyć operacji w dozwolonym czasie".
  • 503 Service Unavailable (Usługa niedostępna), ServerBusy, "Egress is over the account limit" (Ruch wychodzący przekracza limit konta).
  • 503 Service Unavailable (Usługa niedostępna), ServerBusy, "Ingress is over the account limit" (Ruch przychodzący przekracza limit konta).
  • 503 Service Unavailable (Niedostępna usługa), ServerBusy, "Operations per second is over the account limit" (Operacje na sekundę są powyżej limitu konta).
  • 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

Akcja musi być "dołączana", aby przekazać dane, które mają zostać dołączone do pliku, "flush" 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 albo "setAccessControlRecursive", aby rekursywnie ustawić listę kontroli dostępu dla katalogu. Pamiętaj, ż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 Access Control List (ACL) zawiera uprawnienia właściciela, grupy właściciel i innych, więc 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

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

Akcja musi być "dołączana", aby przekazać dane, które mają zostać dołączone do pliku, "flush" 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 albo "setAccessControlRecursive", aby rekursywnie ustawić listę kontroli dostępu dla katalogu. Pamiętaj, ż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 Access Control List (ACL) zawiera uprawnienia właściciela, grupy właściciel i innych, więc 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
failureCount
  • integer
filesSuccessful
  • integer