az storage file metadata

  • Reference

Poznámka:

Tato skupina příkazů obsahuje příkazy, které jsou definované v Azure CLI i alespoň v jednom rozšíření. Nainstalujte každé rozšíření, abyste mohli využívat své rozšířené funkce. Přečtěte si další informace o rozšířeních.

Správa metadat souborů

Příkazy

Name Description Typ Stav
az storage file metadata show

Vrátí všechna uživatelsky definovaná metadata souboru.

 Základ GA
az storage file metadata show (storage-preview přípona)

Vrátí všechna uživatelsky definovaná metadata souboru.

 Rozšíření Preview
az storage file metadata update

Aktualizujte metadata souboru.

 Základ GA
az storage file metadata update (storage-preview přípona)

Aktualizujte metadata souboru.

 Rozšíření Preview

az storage file metadata show

Upravit

Vrátí všechna uživatelsky definovaná metadata souboru.

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]

Příklady

Zobrazit metadata pro soubor

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

Povinné parametry

--path -p

Cesta k souboru ve sdílené složce.

--share-name -s

Název sdílené složky.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

přijímané hodnoty: key, login
--backup-intent --enable-file-backup-request-intent

Povinný parametr pro použití s ověřováním OAuth (Azure AD) pro soubory. Tím se obejdou kontroly oprávnění na úrovni souborů nebo adresářů a povolí přístup na základě povolených datových akcí, a to i v případě, že jsou pro tyto soubory nebo adresáře zavedeny seznamy ACL.

výchozí hodnota: False
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Pokud je hodnota true, koncové tečky se oříznou z cílového identifikátoru URI. Výchozí hodnota je False.

přijímané hodnoty: false, true
výchozí hodnota: False
--file-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Řetězec, který představuje verzi snímku, pokud je k dispozici.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage file metadata show (storage-preview přípona)

Preview

Skupina příkazů az storage je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Vrátí všechna uživatelsky definovaná metadata souboru.

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]

Příklady

Zobrazit metadata pro soubor

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

Povinné parametry

--path -p

Cesta k souboru ve sdílené složce.

--share-name -s

Název sdílené složky.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

přijímané hodnoty: key, login
--backup-intent --enable-file-backup-request-intent

Povinný parametr pro použití s ověřováním OAuth (Azure AD) pro soubory. Tím se obejdou kontroly oprávnění na úrovni souborů nebo adresářů a povolí přístup na základě povolených datových akcí, a to i v případě, že jsou pro tyto soubory nebo adresáře zavedeny seznamy ACL.

výchozí hodnota: False
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Pokud je hodnota true, koncové tečky se oříznou z cílového identifikátoru URI. Výchozí hodnota je False.

přijímané hodnoty: false, true
výchozí hodnota: False
--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Řetězec, který představuje verzi snímku, pokud je k dispozici.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage file metadata update

Upravit

Aktualizujte metadata souboru.

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]

Příklady

Aktualizace metadat pro soubor

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

Povinné parametry

--path -p

Cesta k souboru ve sdílené složce.

--share-name -s

Název sdílené složky.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

přijímané hodnoty: key, login
--backup-intent --enable-file-backup-request-intent

Povinný parametr pro použití s ověřováním OAuth (Azure AD) pro soubory. Tím se obejdou kontroly oprávnění na úrovni souborů nebo adresářů a povolí přístup na základě povolených datových akcí, a to i v případě, že jsou pro tyto soubory nebo adresáře zavedeny seznamy ACL.

výchozí hodnota: False
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Pokud je hodnota true, koncové tečky se oříznou z cílového identifikátoru URI. Výchozí hodnota je False.

přijímané hodnoty: false, true
výchozí hodnota: False
--file-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--metadata

Metadata ve dvojicích key=value oddělených mezerami Tím se přepíše všechna existující metadata.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage file metadata update (storage-preview přípona)

Preview

Skupina příkazů az storage je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte metadata souboru.

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]

Příklady

Aktualizace metadat pro soubor

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

Povinné parametry

--path -p

Cesta k souboru ve sdílené složce.

--share-name -s

Název sdílené složky.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

přijímané hodnoty: key, login
--backup-intent --enable-file-backup-request-intent

Povinný parametr pro použití s ověřováním OAuth (Azure AD) pro soubory. Tím se obejdou kontroly oprávnění na úrovni souborů nebo adresářů a povolí přístup na základě povolených datových akcí, a to i v případě, že jsou pro tyto soubory nebo adresáře zavedeny seznamy ACL.

výchozí hodnota: False
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Pokud je hodnota true, koncové tečky se oříznou z cílového identifikátoru URI. Výchozí hodnota je False.

přijímané hodnoty: false, true
výchozí hodnota: False
--metadata

Metadata ve dvojicích key=value oddělených mezerami Tím se přepíše všechna existující metadata.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.