Filesystem - List

Wyświetl listę systemów plików i ich właściwości na danym koncie.

GET https://{accountName}.{dnsSuffix}/?resource=account
GET https://{accountName}.{dnsSuffix}/?resource=account&prefix={prefix}&continuation={continuation}&maxResults={maxResults}&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.

resource
query True

Wartość musi być "kontem" dla wszystkich operacji konta.

continuation
query
  • string

Liczba systemów plików zwracanych przy każdym wywołaniu jest ograniczona. Jeśli liczba zwracanych systemów plików przekracza ten limit, token kontynuacji jest zwracany w nagłówku odpowiedzi x-ms-continuation. Gdy w odpowiedzi zostanie zwrócony token kontynuacji, należy go określić w kolejnym wywołaniu operacji listy, aby kontynuować wyświetlanie listy systemów plików.

maxResults
query
  • integer
int32

Opcjonalna wartość określająca maksymalną liczbę elementów do zwrócenia. W przypadku pominięcia lub większego niż 5000 odpowiedź będzie zawierać maksymalnie 5000 elementów.

prefix
query
  • string

Filtruje wyniki do systemów plików w ramach określonego prefiksu.

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

OK

Headers

  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Type: string
  • x-ms-default-encryption-scope: string
  • x-ms-deny-encryption-scope-override: boolean
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

AccountResourceType

Wartość musi być "kontem" dla wszystkich operacji konta.

DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

Filesystem
FilesystemList

AccountResourceType

Wartość musi być "kontem" dla wszystkich operacji konta.

Name Type Description
account
  • 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.

Filesystem

Name Type Description
eTag
  • string
lastModified
  • string
name
  • string

FilesystemList

Name Type Description
filesystems