Filesystem - List

Lista systemów plików
Lista 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 punktu końcowego usługi Azure Data Lake Storage.

resource
query True

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

continuation
query
  • string

Liczba systemów plików zwracanych przy każdym wywołaniu jest ograniczona. Jeśli liczba systemów plików do zwrotu przekracza ten limit, token kontynuacji jest zwracany w nagłówku odpowiedzi x-ms-kontynuacji. Gdy token kontynuacji jest zwracany w odpowiedzi, musi być określony w kolejnym wywołaniu operacji listy, aby kontynuować wyświetlanie listy systemów plików.

maxResults
query
  • integer
int32

Wartość opcjonalna określająca maksymalną liczbę elementów do zwrócenia. Jeśli pominięto lub więcej niż 5000, odpowiedź będzie zawierać maksymalnie 5000 elementów.

prefix
query
  • string

Filtruje wyniki do systemów plików w określonym prefiksie.

timeout
query
  • integer
int32

Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się, gdy żądanie jest odbierane 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

UUID rejestrowane w dziennikach analizy do 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 podczas korzystania z autoryzacji klucza udostępnionego.

x-ms-version
  • string

Określa wersję protokołu REST używanego do przetwarzania żądania. Jest to wymagane podczas korzystania z autoryzacji klucza udostępnionego.

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
Other Status Codes

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

  • 400 Bad Request, ContentLengthMustBeZero, "Nagłówek żądania długości zawartości musi wynosić zero."
  • 400 Bad Request, InvalidAuthenticationInfo, "Informacje o uwierzytelnianiu nie są podane w poprawnym formacie. Sprawdź wartość nagłówka Autoryzacja."
  • 400 Bad Request, InvalidFlushPosition, "Przekazane dane nie są ciągłe lub wartość parametru kwerendy pozycji nie jest równa długości pliku po dołączeniu przekazanych danych."
  • 400 Bad Request, InvalidHeaderValue, "Wartość jednego z nagłówków HTTP nie jest w poprawnym formacie."
  • 400 Bad Request, InvalidHttpVerb, "Określony zlecenie HTTP jest nieprawidłowy — nie jest rozpoznawany przez serwer."
  • 400 Bad Request, InvalidInput, "Jedno z danych wejściowych żądania jest nieprawidłowe."
  • 400 Bad Request, InvalidPropertyName, "Nazwa właściwości nie może być pusta."
  • 400 Bad Request, InvalidPropertyName, "Nazwa właściwości zawiera nieprawidłowe znaki."
  • 400 Bad Request, InvalidQueryParameterValue, "Wartość dla jednego z parametrów kwerendy określonych w identyfikatorze URI żądania jest nieprawidłowa."
  • 400 Bad Request, InvalidResourceName, "Określona nazwa zasobu zawiera nieprawidłowe znaki."
  • 400 Bad Request, InvalidSourceUri, "Źródłowy identyfikator URI jest nieprawidłowy."
  • 400 Bad Request, InvalidUri, "Identyfikator URI żądania jest nieprawidłowy."
  • 400 Bad Request, MissingRequiredHeader, "Nagłówek HTTP, który jest obowiązkowy dla tego żądania, nie jest określony."
  • 400 Bad Request, MissingRequiredQueryParameter, "Parametr zapytania, który jest obowiązkowy dla tego żądania, nie jest określony."
  • 400 Złe żądanie, MultipleConditionHeadersNotSupportowane, "Wiele nagłówków warunek nie są obsługiwane."
  • 400 Bad Request, OutOfRangeInput, "Jedno z danych wejściowych żądania jest poza zakresem."
  • 400 Bad Request, OutOfRangeQueryParameterValue, "Jeden z parametrów kwerendy określonych w identyfikatorze URI żądania jest poza dopuszczalnym zakresem."
  • 400 Bad Request, UnsupportedHeader, "Jeden z nagłówków określonych w żądaniu nie jest obsługiwany."
  • 400 Bad Request, UnsupportedQueryParameter, "Jeden z parametrów kwerendy określonych w identyfikatorze URI żądania nie jest obsługiwany."
  • 400 Bad Request, UnsupportedRestVersion, "Określona wersja reszta jest nieobsługiwała."
  • 403 Zabronione, AccountIsDisabled, "Określone konto jest wyłączone."
  • 403 Zabronione, AuthorizationFailure, "To żądanie nie jest upoważnione do wykonania tej operacji."
  • 403 Zabronione, InsufficientAccountPermissions, "Konto, do które 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 Nie znaleziono, SourcePathNotFound, "Ścieżka źródłowa dla operacji zmiany nazwy nie istnieje."
  • 405 Metoda niedozwolona, nieobsługiwyhttpVerb, "Zasób nie obsługuje określonego zlecenia HTTP."
  • 409 Konflikt, DestinationPathIsBeingDeleted, "Określona ścieżka docelowa jest oznaczona do usunięcia."
  • 409 Konflikt, DirectoryNotEmpty, "Wartość parametru kwerendy cyklicznej musi być prawdziwa, aby usunąć niepusty katalog."
  • 409 Konflikt, FilesystemAlreadyExists, "Określony system plików już istnieje."
  • 409 Konflikt, FilesystemBeingDeleted, "Określony system plików jest usuwany."
  • 409 Konflikt, InvalidDestinationPath, "Określona ścieżka lub element ścieżki istnieje, a jej typ zasobu jest nieprawidłowy dla tej operacji." * Konflikt, InvalidFlushOperation, "Zasób został utworzony lub zmodyfikowany przez interfejs API usługi blob i nie mogą być zapisywane przez interfejs API usługi przechowywania danych Lake."
  • 409 Konflikt, 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 Konflikt, InvalidSourceOrDestinationResourceType, "Typ zasobu źródłowego i docelowego musi być identyczny."
  • 409 Konflikt, LeaseAlreadyPresent, "Jest już obecny dzierżawy."
  • 409 Konflikt, LeaseIdMismatchWithLeaseOperation, "Określony identyfikator dzierżawy nie odpowiada identyfikatorowi dzierżawy zasobu z określoną operacją dzierżawy."
  • 409 Konflikt, LeaseIsAlreadyBroken, "Dzierżawa została już złamana i nie może być ponownie przerwana."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeAcquired, "Identyfikator dzierżawy dopasowane, ale dzierżawa jest obecnie w stanie złamania i nie mogą być nabyte, dopóki nie zostanie złamany."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeChanged, "Identyfikator dzierżawy dopasowane, ale dzierżawa jest obecnie w stanie złamania i nie można zmienić."
  • 409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "Identyfikator dzierżawy dopasowane, ale dzierżawa została złamana jawnie i nie można odnowić."
  • 409 Konflikt, LeaseNameMismatch, "Określona nazwa dzierżawy nie pasuje do istniejącej nazwy dzierżawy."
  • 409 Konflikt, LeaseNotPresentWithLeaseOperation, "Identyfikator dzierżawy nie jest obecny z określoną operacją dzierżawy."
  • 409 Konflikt, PathAlreadyExists, "Określona ścieżka już istnieje."
  • 409 Konflikt, PathConflict, "Określona ścieżka lub element ścieżki istnieje, a jej typ zasobu jest nieprawidłowy dla tej operacji."
  • 409 Konflikt, SourcePathIsBeingDeleted, "Określona ścieżka źródłowa jest oznaczona do usunięcia."
  • 409 Konflikt, ResourceTypeMismatch, "Typ zasobu określony w żądaniu nie jest zgodny z typem 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 Warunek wstępny nie powiódł się, LeaseIdMismatch, "Określony identyfikator dzierżawy nie odpowiadał identyfikatorowi 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 powiódł się, LeaseNotPresent, "Obecnie nie ma dzierżawy zasobu."
  • 412 Warunek wstępny nie powiódł się, LeaseLost, "Określono identyfikator dzierżawy, ale dzierżawa zasobu wygasła."
  • 412 Warunek wstępny nie powiódł się, SourceConditionNotMet, "Warunek źródła określony przy użyciu nagłówków warunkowych HTTP nie jest spełniony."
  • 413 Żądaj jednostki zbyt duże, RequestBodyTooLarge, "Treść żądania jest zbyt duży i przekracza maksymalny dopuszczalny limit."
  • 416 Żądany zakres nie jest sycony, 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ę złożenia wniosku."
  • 500 Wewnętrzny błąd serwera, OperationTimedOut, "Nie można ukończyć operacji w dozwolonym czasie."
  • 503 Usługa niedostępna, ServerBusy, "Wyjście 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ę złożenia wniosku."

Headers

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

Definicje

AccountResourceType

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

DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

Filesystem
FilesystemList

AccountResourceType

Wartość musi być "konto" 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