Filesystem - Get Properties

Pobierz właściwości systemu plików.
Wszystkie właściwości systemu plików zdefiniowane przez użytkownika i systemowe są określone w nagłówkach odpowiedzi.

HEAD https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem
HEAD https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem&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. Wartość musi zaczynać się i kończyć literą lub cyfrą i może zawierać tylko litery, cyfry i znak kreski (-). Kolejne łączniki nie są dozwolone. Wszystkie litery muszą być małymi literami. Wartość musi mieć od 3 do 63 znaków.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

resource
query True

Wartość musi być "system plików" dla wszystkich operacji systemu plików.

timeout
query
  • integer
int32

Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się po otrzymaniu żą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ó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.

Odpowiedzi

Name Type Description
200 OK

Ok

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-properties: string
  • x-ms-namespace-enabled: string
Other Status Codes

Wystąpił błąd. Poniżej przedstawiono możliwe stany HTTP, kod i ciągi komunikatów:

  • 400 Bad Request, ContentLengthMustBeZero, "The Content-Length request header must be zero" (Nagłówek żądania Content-Length musi mieć wartość 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".
  • 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, "Jeden z parametrów zapytania określonych w żądaniu URI jest poza dozwolonym zakresem".
  • 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 ma autoryzacji do wykonania tej operacji".
  • 403 Forbidden, InsufficientAccountPermissions, "Konto, do którego uzyskiwany jest 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, 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, "The specified filesystem already exists".
  • 409 Conflict, FilesystemBeingDeleted, "Określony system plików jest usuwany".
  • 409 Conflict, InvalidDestinationPath, "Istnieje określona ścieżka lub element ścieżki, 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, "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

DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

FilesystemResourceType

Wartość musi być "system plików" dla wszystkich operacji systemu plików.

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.

FilesystemResourceType

Wartość musi być "system plików" dla wszystkich operacji systemu plików.

Name Type Description
filesystem
  • string