Path - Get Properties
Pobieranie właściwości | Uzyskiwanie stanu | Pobieranie listy Access Control | 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ę Access Control 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 Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Identyfikator systemu plików. Wzorzec wyrażenia regularnego: |
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 do sprawdzania akcji dostępu. Prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Operacja systemu plików odczytu/zapisu/wykonywania w postaci ciągu, dopasowywanie wzorca regex "[rwx-]{3}" |
|
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. |
|
upn
|
query |
boolean |
Opcjonalny. Prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. 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 grupy i aplikacji nie są tłumaczone, ponieważ nie mają unikatowych przyjaznych nazw. |
Nagłówek żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
x-ms-lease-id |
string |
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 jest zgodny z tą ścieżką. Wzorzec wyrażenia regularnego: |
|
If-Match |
string |
Opcjonalny. Wartość elementu 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ść symbolu wieloznakowego ("*"). 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 |
Identyfikator UUID zarejestrowany w dziennikach analizy na potrzeby rozwiązywania problemów i korelacji. Wzorzec wyrażenia regularnego: |
|
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
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.
Nazwa | Typ | Opis |
---|---|---|
checkAccess |
string |
|
getAccessControl |
string |
|
getStatus |
string |