az storage file metadata

  • Référence

Remarque

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. En savoir plus sur les extensions.

Gérer les métadonnées de fichier.

Commandes

Nom Description Type Statut
az storage file metadata show

Retourne toutes les métadonnées définies par l’utilisateur pour le fichier.

 Core GA
az storage file metadata show (storage-preview extension)

Retourne toutes les métadonnées définies par l’utilisateur pour le fichier.

 Extension Aperçu
az storage file metadata update

Mettez à jour les métadonnées du fichier.

 Core GA
az storage file metadata update (storage-preview extension)

Mettez à jour les métadonnées du fichier.

 Extension Aperçu

az storage file metadata show

Modifier

Retourne toutes les métadonnées définies par l’utilisateur pour le fichier.

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]

Exemples

Afficher les métadonnées du fichier

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

Paramètres obligatoires

--path -p

Chemin d’accès au fichier dans le partage de fichiers.

--share-name -s

Nom du partage de fichiers.

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

Nom du compte de stockage. Variable d’environnement associée : AZURE_STORAGE_ACCOUNT. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Si aucune d’elles n’est présente, la commande tente d’interroger la clé du compte de stockage à l’aide du compte Azure authentifié. Si un grand nombre de commandes de stockage sont exécutées, le quota d’API peut être atteint.

--auth-mode

Mode dans lequel exécuter la commande. Le mode « connexion » utilise directement vos informations d’identification de connexion pour l’authentification. Le mode « clé » hérité tente d’interroger une clé de compte si aucun paramètre d’authentification pour le compte n’est fourni. Variable d’environnement : AZURE_STORAGE_AUTH_MODE.

valeurs acceptées: key, login
--backup-intent --enable-file-backup-request-intent

Paramètre obligatoire à utiliser avec l’authentification OAuth (Azure AD) pour les fichiers. Cela contournera toute autorisation de niveau fichier/répertoire case activée s et autorisera l’accès, en fonction des actions de données autorisées, même s’il existe des listes de contrôle d’accès en place pour ces fichiers/répertoires.

valeur par défaut: False
--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si la valeur est true, le point de fin est supprimé de l’URI cible. Valeur par défaut False.

valeurs acceptées: false, true
valeur par défaut: False
--file-endpoint

Stockage point de terminaison du service de données. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Vous pouvez trouver chaque point de terminaison principal de service avec az storage account show. Variable d’environnement : AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--snapshot

Chaîne qui représente la version instantané, le cas échéant.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage file metadata show (storage-preview extension)

Préversion

Le groupe de commandes « az storage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Retourne toutes les métadonnées définies par l’utilisateur pour le fichier.

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]

Exemples

Afficher les métadonnées du fichier

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

Paramètres obligatoires

--path -p

Chemin d’accès au fichier dans le partage de fichiers.

--share-name -s

Nom du partage de fichiers.

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

Nom du compte de stockage. Variable d’environnement associée : AZURE_STORAGE_ACCOUNT. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Si aucune d’elles n’est présente, la commande tente d’interroger la clé du compte de stockage à l’aide du compte Azure authentifié. Si un grand nombre de commandes de stockage sont exécutées, le quota d’API peut être atteint.

--auth-mode

Mode dans lequel exécuter la commande. Le mode « connexion » utilise directement vos informations d’identification de connexion pour l’authentification. Le mode « clé » hérité tente d’interroger une clé de compte si aucun paramètre d’authentification pour le compte n’est fourni. Variable d’environnement : AZURE_STORAGE_AUTH_MODE.

valeurs acceptées: key, login
--backup-intent --enable-file-backup-request-intent

Paramètre obligatoire à utiliser avec l’authentification OAuth (Azure AD) pour les fichiers. Cela contournera toute autorisation de niveau fichier/répertoire case activée s et autorisera l’accès, en fonction des actions de données autorisées, même s’il existe des listes de contrôle d’accès en place pour ces fichiers/répertoires.

valeur par défaut: False
--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si la valeur est true, le point de fin est supprimé de l’URI cible. Valeur par défaut False.

valeurs acceptées: false, true
valeur par défaut: False
--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--snapshot

Chaîne qui représente la version instantané, le cas échéant.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage file metadata update

Modifier

Mettez à jour les métadonnées du fichier.

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]

Exemples

Mettre à jour les métadonnées du fichier

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

Paramètres obligatoires

--path -p

Chemin d’accès au fichier dans le partage de fichiers.

--share-name -s

Nom du partage de fichiers.

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

Nom du compte de stockage. Variable d’environnement associée : AZURE_STORAGE_ACCOUNT. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Si aucune d’elles n’est présente, la commande tente d’interroger la clé du compte de stockage à l’aide du compte Azure authentifié. Si un grand nombre de commandes de stockage sont exécutées, le quota d’API peut être atteint.

--auth-mode

Mode dans lequel exécuter la commande. Le mode « connexion » utilise directement vos informations d’identification de connexion pour l’authentification. Le mode « clé » hérité tente d’interroger une clé de compte si aucun paramètre d’authentification pour le compte n’est fourni. Variable d’environnement : AZURE_STORAGE_AUTH_MODE.

valeurs acceptées: key, login
--backup-intent --enable-file-backup-request-intent

Paramètre obligatoire à utiliser avec l’authentification OAuth (Azure AD) pour les fichiers. Cela contournera toute autorisation de niveau fichier/répertoire case activée s et autorisera l’accès, en fonction des actions de données autorisées, même s’il existe des listes de contrôle d’accès en place pour ces fichiers/répertoires.

valeur par défaut: False
--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si la valeur est true, le point de fin est supprimé de l’URI cible. Valeur par défaut False.

valeurs acceptées: false, true
valeur par défaut: False
--file-endpoint

Stockage point de terminaison du service de données. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Vous pouvez trouver chaque point de terminaison principal de service avec az storage account show. Variable d’environnement : AZURE_STORAGE_SERVICE_ENDPOINT.

--metadata

Métadonnées dans les paires clé=valeur séparées par l’espace. Cela remplace toutes les métadonnées existantes.

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage file metadata update (storage-preview extension)

Préversion

Le groupe de commandes « az storage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour les métadonnées du fichier.

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]

Exemples

Mettre à jour les métadonnées du fichier

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

Paramètres obligatoires

--path -p

Chemin d’accès au fichier dans le partage de fichiers.

--share-name -s

Nom du partage de fichiers.

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

Nom du compte de stockage. Variable d’environnement associée : AZURE_STORAGE_ACCOUNT. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Si aucune d’elles n’est présente, la commande tente d’interroger la clé du compte de stockage à l’aide du compte Azure authentifié. Si un grand nombre de commandes de stockage sont exécutées, le quota d’API peut être atteint.

--auth-mode

Mode dans lequel exécuter la commande. Le mode « connexion » utilise directement vos informations d’identification de connexion pour l’authentification. Le mode « clé » hérité tente d’interroger une clé de compte si aucun paramètre d’authentification pour le compte n’est fourni. Variable d’environnement : AZURE_STORAGE_AUTH_MODE.

valeurs acceptées: key, login
--backup-intent --enable-file-backup-request-intent

Paramètre obligatoire à utiliser avec l’authentification OAuth (Azure AD) pour les fichiers. Cela contournera toute autorisation de niveau fichier/répertoire case activée s et autorisera l’accès, en fonction des actions de données autorisées, même s’il existe des listes de contrôle d’accès en place pour ces fichiers/répertoires.

valeur par défaut: False
--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si la valeur est true, le point de fin est supprimé de l’URI cible. Valeur par défaut False.

valeurs acceptées: false, true
valeur par défaut: False
--metadata

Métadonnées dans les paires clé=valeur séparées par l’espace. Cela remplace toutes les métadonnées existantes.

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.