Udostępnij przez

az storage file metadata

Note

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.

 Core ogólna dostępność
az storage file metadata show (storage-preview rozszerzenie)

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

 Extension ogólna dostępność
az storage file metadata update

Aktualizowanie metadanych pliku.

 Core ogólna dostępność
az storage file metadata update (storage-preview rozszerzenie)

Aktualizowanie metadanych pliku.

 Extension ogólna dostępność

az storage file metadata show

Redagować

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 --enable-file-backup-request-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

Wymagane parametry

--path -p

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

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--account-key

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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.

Własność Wartość
Akceptowane 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.

Własność Wartość
Wartość domyślna: False
--connection-string

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--disallow-trailing-dot

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

Własność Wartość
Wartość domyślna: False
Akceptowane wartości: false, true
--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.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--snapshot

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

--timeout

Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Własność Wartość
Wartość domyślna: False
--help -h

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

--only-show-errors

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

Własność Wartość
Wartość domyślna: False
--output -o

Format danych wyjściowych.

Własność Wartość
Wartość domyślna: json
Akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Własność Wartość
Wartość domyślna: False

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 --enable-file-backup-request-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

Wymagane parametry

--path -p

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

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--account-key

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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.

Własność Wartość
Akceptowane 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.

Własność Wartość
Wartość domyślna: False
--connection-string

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--disallow-trailing-dot

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

Własność Wartość
Wartość domyślna: False
Akceptowane wartości: false, true
--sas-token

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--snapshot

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

--timeout

Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Własność Wartość
Wartość domyślna: False
--help -h

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

--only-show-errors

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

Własność Wartość
Wartość domyślna: False
--output -o

Format danych wyjściowych.

Własność Wartość
Wartość domyślna: json
Akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Własność Wartość
Wartość domyślna: False

az storage file metadata update

Redagować

Aktualizowanie metadanych pliku.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent --enable-file-backup-request-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

Wymagane parametry

--path -p

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

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--account-key

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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.

Własność Wartość
Akceptowane 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.

Własność Wartość
Wartość domyślna: False
--connection-string

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--disallow-trailing-dot

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

Własność Wartość
Wartość domyślna: False
Akceptowane wartości: false, true
--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.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--metadata

Metadane w formacie klucz=wartość, rozdzielone 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.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--timeout

Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Własność Wartość
Wartość domyślna: False
--help -h

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

--only-show-errors

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

Własność Wartość
Wartość domyślna: False
--output -o

Format danych wyjściowych.

Własność Wartość
Wartość domyślna: json
Akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Własność Wartość
Wartość domyślna: False

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 --enable-file-backup-request-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

Wymagane parametry

--path -p

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

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--account-key

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--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.

Własność Wartość
Akceptowane 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.

Własność Wartość
Wartość domyślna: False
--connection-string

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

Własność Wartość
Grupa parametrów: Storage Account Arguments
--disallow-trailing-dot

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

Własność Wartość
Wartość domyślna: False
Akceptowane wartości: false, true
--metadata

Metadane w formacie klucz=wartość, rozdzielone 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 przechowywania. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

Własność Wartość
Grupa parametrów: Storage Account Arguments
--timeout

Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Własność Wartość
Wartość domyślna: False
--help -h

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

--only-show-errors

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

Własność Wartość
Wartość domyślna: False
--output -o

Format danych wyjściowych.

Własność Wartość
Wartość domyślna: json
Akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Własność Wartość
Wartość domyślna: False