Udostępnij za pośrednictwem

az storage file metadata

Note

Ta grupa poleceń zawiera polecenia zdefiniowane w obu Azure CLI i 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

Edytuj

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

Parametry wymagane

--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 co najmniej jeden może być wymagany 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łaściwość 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 Azure. Jeśli zostanie wykonana duża liczba komend magazynowania, limit API może zostać osiągnięty.

Właściwość 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łaściwość Wartość
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.

Właściwość Wartość
Domyślna wartość: False
--connection-string

Connection string konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

Właściwość 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łaściwość Wartość
Domyślna wartość: False
Dopuszczalne 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łaściwość 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łaściwość 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: 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

Parametry wymagane

--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 co najmniej jeden może być wymagany 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łaściwość 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 Azure. Jeśli zostanie wykonana duża liczba komend magazynowania, limit API może zostać osiągnięty.

Właściwość 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łaściwość Wartość
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.

Właściwość Wartość
Domyślna wartość: False
--connection-string

Connection string konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

Właściwość 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łaściwość Wartość
Domyślna wartość: False
Dopuszczalne 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łaściwość 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False

az storage file metadata update

Edytuj

Aktualizowanie metadanych pliku.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany 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łaściwość 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 Azure. Jeśli zostanie wykonana duża liczba komend magazynowania, limit API może zostać osiągnięty.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy 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łaściwość Wartość
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.

Właściwość Wartość
Domyślna wartość: False
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--connection-string

Connection string konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

Właściwość 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łaściwość Wartość
Domyślna wartość: False
Dopuszczalne 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łaściwość 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łaściwość 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False

az storage file metadata update (storage-preview rozszerzenie)

Aktualizowanie metadanych pliku.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany 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łaściwość 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 Azure. Jeśli zostanie wykonana duża liczba komend magazynowania, limit API może zostać osiągnięty.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy 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łaściwość Wartość
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.

Właściwość Wartość
Domyślna wartość: False
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--connection-string

Connection string konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

Właściwość 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łaściwość Wartość
Domyślna wartość: False
Dopuszczalne 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łaściwość 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False