Udostępnij za pośrednictwem


az storage file metadata

Uwaga

Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.

Zarządzanie metadanymi plików.

Polecenia

Nazwa Opis Typ Stan
az storage file metadata show

Zwróć wszystkie metadane zdefiniowane przez użytkownika dla pliku.

Podstawowe funkcje Ogólna dostępność
az storage file metadata show (storage-preview rozszerzenie)

Zwróć wszystkie metadane zdefiniowane przez użytkownika dla pliku.

Numer wewnętrzny Ogólna dostępność
az storage file metadata update

Aktualizowanie metadanych pliku.

Podstawowe funkcje Ogólna dostępność
az storage file metadata update (storage-preview rozszerzenie)

Aktualizowanie metadanych pliku.

Numer wewnętrzny Ogólna dostępność

az storage file metadata show

Zwróć wszystkie metadane zdefiniowane przez użytkownika dla pliku.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Przykłady

Pokaż metadane dla pliku

az storage file metadata show -s MyShare --path /path/to/file

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

Dopuszczalne wartości: key, login
--backup-intent --enable-file-backup-request-intent

Wymagany parametr do użycia z uwierzytelnianiem OAuth (Azure AD) dla plików. Spowoduje to obejście wszystkich kontroli uprawnień na poziomie pliku/katalogu i zezwolenie na dostęp na podstawie dozwolonych akcji danych, nawet jeśli istnieją listy ACL dla tych plików/katalogów.

Domyślna wartość: False
--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Jeśli wartość true, końcowa kropka zostanie przycięta z docelowego identyfikatora URI. Wartość domyślna to False.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--file-endpoint

Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma to zastosowanie.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az storage file metadata show (storage-preview rozszerzenie)

Zwróć wszystkie metadane zdefiniowane przez użytkownika dla pliku.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Przykłady

Pokaż metadane dla pliku

az storage file metadata show -s MyShare --path /path/to/file

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

Dopuszczalne wartości: key, login
--backup-intent --enable-file-backup-request-intent

Wymagany parametr do użycia z uwierzytelnianiem OAuth (Azure AD) dla plików. Spowoduje to obejście wszystkich kontroli uprawnień na poziomie pliku/katalogu i zezwolenie na dostęp na podstawie dozwolonych akcji danych, nawet jeśli istnieją listy ACL dla tych plików/katalogów.

Domyślna wartość: False
--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Jeśli wartość true, końcowa kropka zostanie przycięta z docelowego identyfikatora URI. Wartość domyślna to False.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma to zastosowanie.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az storage file metadata update

Aktualizowanie metadanych pliku.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Przykłady

Aktualizowanie metadanych pliku

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

Dopuszczalne wartości: key, login
--backup-intent --enable-file-backup-request-intent

Wymagany parametr do użycia z uwierzytelnianiem OAuth (Azure AD) dla plików. Spowoduje to obejście wszystkich kontroli uprawnień na poziomie pliku/katalogu i zezwolenie na dostęp na podstawie dozwolonych akcji danych, nawet jeśli istnieją listy ACL dla tych plików/katalogów.

Domyślna wartość: False
--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Jeśli wartość true, końcowa kropka zostanie przycięta z docelowego identyfikatora URI. Wartość domyślna to False.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--file-endpoint

Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.

--metadata

Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az storage file metadata update (storage-preview rozszerzenie)

Aktualizowanie metadanych pliku.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Przykłady

Aktualizowanie metadanych pliku

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

Dopuszczalne wartości: key, login
--backup-intent --enable-file-backup-request-intent

Wymagany parametr do użycia z uwierzytelnianiem OAuth (Azure AD) dla plików. Spowoduje to obejście wszystkich kontroli uprawnień na poziomie pliku/katalogu i zezwolenie na dostęp na podstawie dozwolonych akcji danych, nawet jeśli istnieją listy ACL dla tych plików/katalogów.

Domyślna wartość: False
--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Jeśli wartość true, końcowa kropka zostanie przycięta z docelowego identyfikatora URI. Wartość domyślna to False.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--metadata

Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.