az storage file metadata

Note

このコマンド グループには、Azure CLI と少なくとも 1 つの拡張機能の両方で定義されているコマンドがあります。 各拡張機能をインストールして、拡張機能を活用します。 拡張機能の詳細をご覧ください。

ファイル メタデータを管理します。

コマンド

名前	説明	型	状態
az storage file metadata show	ファイルのすべてのユーザー定義メタデータを返します。	コア	GA
az storage file metadata show (storage-preview 拡張機能)	ファイルのすべてのユーザー定義メタデータを返します。	拡張子	GA
az storage file metadata update	ファイル メタデータを更新します。	コア	GA
az storage file metadata update (storage-preview 拡張機能)	ファイル メタデータを更新します。	拡張子	GA

az storage file metadata show

ファイルのすべてのユーザー定義メタデータを返します。

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]

例

ファイルのメタデータを表示する

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

必須のパラメーター

--path -p

ファイル共有内のファイルへのパス。

--share-name -s

ファイル共有名。

省略可能のパラメーター

--account-key

ストレージ アカウント キー。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは認証された Azure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

指定可能な値: key, login

--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False

--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true

規定値: False

--file-endpoint

ストレージ データ サービス エンドポイント。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 各サービス プライマリ エンドポイントは、 az storage account showを使用して検索できます。 環境変数: AZURE_STORAGE_SERVICE_ENDPOINT。

--sas-token

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--snapshot

スナップショットのバージョンを表す文字列 (該当する場合)。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage file metadata show (storage-preview 拡張機能)

ファイルのすべてのユーザー定義メタデータを返します。

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]

例

ファイルのメタデータを表示する

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

必須のパラメーター

--path -p

ファイル共有内のファイルへのパス。

--share-name -s

ファイル共有名。

省略可能のパラメーター

--account-key

ストレージ アカウント キー。 ストレージ アカウント名と組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは認証された Azure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

指定可能な値: key, login

--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False

--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true

規定値: False

--sas-token

Shared Access Signature (SAS)。 ストレージ アカウント名と組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--snapshot

スナップショットのバージョンを表す文字列 (該当する場合)。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage file metadata update

ファイル メタデータを更新します。

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]

例

ファイルのメタデータを更新する

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

必須のパラメーター

--path -p

ファイル共有内のファイルへのパス。

--share-name -s

ファイル共有名。

省略可能のパラメーター

--account-key

ストレージ アカウント キー。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは認証された Azure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

指定可能な値: key, login

--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False

--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true

規定値: False

--file-endpoint

ストレージ データ サービス エンドポイント。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 各サービス プライマリ エンドポイントは、 az storage account showを使用して検索できます。 環境変数: AZURE_STORAGE_SERVICE_ENDPOINT。

--metadata

スペース区切りのキーと値のペアのメタデータ。 これにより、既存のメタデータが上書きされます。

--sas-token

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage file metadata update (storage-preview 拡張機能)

ファイル メタデータを更新します。

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]

例

ファイルのメタデータを更新する

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

必須のパラメーター

--path -p

ファイル共有内のファイルへのパス。

--share-name -s

ファイル共有名。

省略可能のパラメーター

--account-key

ストレージ アカウント キー。 ストレージ アカウント名と組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは認証された Azure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

指定可能な値: key, login

--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False

--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true

規定値: False

--metadata

スペース区切りのキーと値のペアのメタデータ。 これにより、既存のメタデータが上書きされます。

--sas-token

Shared Access Signature (SAS)。 ストレージ アカウント名と組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。