Path - Get Properties
Pobieranie właściwości | Uzyskiwanie stanu | Uzyskiwanie listy kontroli dostępu | Sprawdzanie dostępu
Polecenie Pobierz właściwości zwraca wszystkie właściwości zdefiniowane przez system i użytkownika dla ścieżki. Polecenie Pobierz stan zwraca wszystkie właściwości zdefiniowane przez system dla ścieżki. Polecenie Pobierz listę kontroli dostępu zwraca listę kontroli dostępu dla ścieżki. 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.
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta usługi Azure Storage. |
dns
|
path | True |
string |
Sufiks DNS dla punktu końcowego usługi Azure Data Lake Storage. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Identyfikator systemu plików. |
path
|
path | True |
string |
Ścieżka pliku lub katalogu. |
action
|
query |
Opcjonalny. Jeśli wartość to "getStatus", zwracane są tylko właściwości zdefiniowane przez system dla ścieżki. Jeśli wartość to "getAccessControl", lista kontroli dostępu jest zwracana w nagłówkach odpowiedzi (hierarchiczna przestrzeń nazw musi być włączona dla konta), w przeciwnym razie zwracane są właściwości. |
||
fs
|
query |
string |
Wymagane tylko dla akcji sprawdzania dostępu. Prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. Operacja systemu plików odczytu/zapisu/wykonywania w postaci ciągu, pasujący wzorzec wyrażeń regularnych "[rwx-]{3}" |
|
timeout
|
query |
integer (int32) minimum: 1 |
Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się od momentu odebrania żądania przez usługę. Jeśli wartość limitu czasu upłynie przed zakończeniem operacji, operacja zakończy się niepowodzeniem. |
|
upn
|
query |
boolean |
Opcjonalny. Prawidłowe tylko wtedy, gdy dla konta jest włączona hierarchiczna przestrzeń nazw. Jeśli wartość "true", wartości tożsamości użytkownika zwrócone w nagłówkach odpowiedzi x-ms-owner, x-ms-group i x-ms-acl zostaną przekształcone z identyfikatorów obiektów usługi Azure Active Directory na główne nazwy użytkowników. Jeśli wartość "false" zostanie zwrócona jako identyfikatory obiektów usługi Azure Active Directory. Wartość domyślna to false. Należy pamiętać, że identyfikatory obiektów grup i aplikacji nie są tłumaczone, ponieważ nie mają unikatowych przyjaznych nazw. |
Nagłówek żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Opcjonalny. Jeśli ten nagłówek zostanie określony, operacja zostanie wykonana tylko wtedy, gdy zostaną spełnione oba z następujących warunków: i) dzierżawa ścieżki jest obecnie aktywna i ii) identyfikator dzierżawy określony w żądaniu pasuje do tej ścieżki. |
|
If-Match |
string |
Opcjonalny. Wartość 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ść wieloznaczny ("*"). 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-encryption-key |
string |
Opcjonalny. Klucz szyfrowania AES-256 zakodowany w formacie Base64. |
|
x-ms-encryption-key-sha256 |
string |
Opcjonalny. Skrót SHA256 zakodowany w formacie Base64 klucza szyfrowania. |
|
x-ms-encryption-algorithm: AES256 |
string |
Opcjonalny. Określa algorytm do użycia na potrzeby szyfrowania. Wartość tego nagłówka musi być AES256. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Identyfikator UUID zarejestrowany w dziennikach analizy na potrzeby rozwiązywania problemów i korelacji. |
|
x-ms-date |
string |
Określa uniwersalny czas koordynowany (UTC) dla żądania. 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
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Zwraca wszystkie właściwości pliku lub katalogu. Nagłówki
|
|
Other Status Codes |
Wystąpił błąd. Poniżej wymieniono możliwe stany HTTP, kod i ciągi komunikatów:
Nagłówki
|
Definicje
Nazwa | Opis |
---|---|
Data |
|
Error |
Obiekt odpowiedzi na błąd usługi. |
Path |
Opcjonalny. Jeśli wartość to "getStatus", zwracane są tylko właściwości zdefiniowane przez system dla ścieżki. Jeśli wartość to "getAccessControl", lista kontroli dostępu jest zwracana w nagłówkach odpowiedzi (hierarchiczna przestrzeń nazw musi być włączona dla konta), w przeciwnym razie zwracane są właściwości. |
DataLakeStorageError
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt odpowiedzi na błąd usługi. |
Error
Obiekt odpowiedzi na błąd usługi.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu usługi. |
message |
string |
Komunikat o błędzie usługi. |
PathGetPropertiesAction
Opcjonalny. Jeśli wartość to "getStatus", zwracane są tylko właściwości zdefiniowane przez system dla ścieżki. Jeśli wartość to "getAccessControl", lista kontroli dostępu jest zwracana w nagłówkach odpowiedzi (hierarchiczna przestrzeń nazw musi być włączona dla konta), w przeciwnym razie zwracane są właściwości.
Wartość | Opis |
---|---|
checkAccess | |
getAccessControl | |
getStatus |