Path - Delete

Usuwanie | plików Usuń katalog
Usuń plik lub katalog. 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.

DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&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 punktu końcowego Azure Data Lake Storage.

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.

continuation
query
  • string

Opcjonalny. Podczas usuwania katalogu liczba ścieżek, które są usuwane z każdym wywołaniem, jest ograniczona. Jeśli liczba ścieżek do usunięcia przekroczy 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 usuwania, aby kontynuować usuwanie katalogu.

recursive
query
  • boolean

Wymagane i prawidłowe tylko wtedy, gdy zasób jest katalogiem. Jeśli wartość "true", wszystkie ścieżki poniżej katalogu zostaną usunięte. Jeśli wartość "false" i katalog nie jest pusty, wystąpi błąd.

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

Name Required Type Description
x-ms-lease-id
  • string

Identyfikator dzierżawy należy określić, jeśli istnieje aktywna dzierżawa.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

If-Match
  • string

Opcjonalny. Wartość elementu ETag. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością. Element ETag musi być określony w cudzysłowie.

If-None-Match
  • string

Opcjonalny. Wartość elementu ETag lub specjalna wartość symbolu wieloznakowego ("*"). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Element ETag musi być określony w cudzysłowie.

If-Modified-Since
  • string

Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonej daty i godziny.

If-Unmodified-Since
  • string

Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty i godziny.

x-ms-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ół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

Name Type Description
200 OK

Plik został usunięty.

Headers

  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
Other Status Codes

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 o długości zawartości 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 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ść 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".
  • Metoda 405 Niedozwolona, NieobsługiwanaHttpVerb, "Zasób nie obsługuje określonego zlecenia HTTP".
  • 409 Conflict, 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 Konflikt, System plikówAlreadyExists, "Określony system plików już istnieje."
  • 409 Konflikt, System plikówBeingDeleted: "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 Conflict, 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 Conflict, LeaseIdMismatchWithLeaseOperation, "Określony identyfikator dzierżawy nie pasuje do identyfikatora 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 został dopasowany, 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 został dopasowany, 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 przerwana jawnie i nie można jej odnowić".
  • 409 Conflict, LeaseNameMismatch, "Określona nazwa dzierżawy nie jest zgodna z istniejącą nazwą dzierżawy".
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "Identyfikator dzierżawy nie jest obecny w określonej operacji dzierżawy."
  • 409 Konflikt, PathAlreadyExists, "Określona ścieżka już istnieje".
  • 409 Conflict, 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 Conflict, ResourceTypeMismatch, "Typ zasobu określony w żądaniu nie jest zgodny z typem zasobu."
  • 412 Warunek wstępny niepowodzenie, 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 pasuje do identyfikatora 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 Niepowodzenie warunku wstępnego, 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 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 dopuszczalny limit".
  • 416 Żądany zakres nie jest satysfiable, 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, "Egress 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".

Headers

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

Definicje

DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

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.