Filesystem - List

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 dla Azure Data Lake Storage końcowego.

resource
query True

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

continuation
query
  • string

Liczba systemów plików zwracanych przy każdym wywołaniach jest ograniczona. Jeśli liczba zwracanych systemów plików przekracza ten limit, w nagłówku odpowiedzi x-ms-continuation jest zwracany token kontynuacji. Gdy token kontynuacji jest zwracany w odpowiedzi, należy go określić w kolejnym wywołaniach 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. Jeśli wartość zostanie pominięta lub większa 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ę, 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

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

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ż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, "One of the headers specified in the request is not supported".
  • 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, "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 pasuje do typu zasobu".
  • 412 Niepowodzenie warunku wstępnego, 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, "Serwer napotkał błąd wewnętrzny. Ponów próbę żądania".
  • 500 Internal Server Error, OperationTimedOut, "The operation could not be completed within the permitted time".
  • 503 Service Unavailable, ServerBusy, "Egress is over the account limit" (Ruch wychodzący przekracza limit konta).
  • 503 Usługa niedostępna, ServerBusy, "Ruch przychodzący przekracza limit konta".
  • 503 Service Unavailable,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

AccountResourceType

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

DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

Filesystem
FilesystemList

AccountResourceType

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