az storage blob

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ère le stockage d’objets pour les données non structurées (objets blob).

Spécifiez l’un des paramètres d’authentification suivants pour vos commandes : --auth-mode, --account-key, --connection-string, --sas-token. Vous pouvez également utiliser des variables d’environnement correspondantes pour stocker vos informations d’identification d’authentification, par exemple AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING et AZURE_STORAGE_SAS_TOKEN.

Commandes

Nom Description Type Statut
az storage blob access

Gère les propriétés de contrôle d’accès d’un objet blob quand l’espace de noms hiérarchique est activé.

Extension Préversion et dépréciation
az storage blob access set

Définissez les propriétés du contrôle d’accès d’un objet blob.

Extension Préversion et dépréciation
az storage blob access show

Afficher les propriétés du contrôle d’accès d’un objet blob.

Extension Préversion et dépréciation
az storage blob access update

Mettez à jour les propriétés du contrôle d’accès d’un objet blob.

Extension Préversion et dépréciation
az storage blob copy

Gère les opérations de copie d’objets blob. Permet az storage blob show de case activée l’état des objets blob.

Cœur et extension GA
az storage blob copy cancel

Abandonner une opération de copie en cours.

Core GA
az storage blob copy start

Copiez un objet blob de manière asynchrone. Permet az storage blob show de case activée l’état des objets blob.

Core GA
az storage blob copy start (storage-blob-preview extension)

Démarrez un travail d’objet blob de copie.

Extension GA
az storage blob copy start-batch

Copiez plusieurs objets blob dans un conteneur d’objets blob. Permet az storage blob show de case activée l’état des objets blob.

Core GA
az storage blob delete

Marquez un objet blob ou instantané pour suppression.

Core GA
az storage blob delete (storage-blob-preview extension)

Marquez un objet blob ou instantané pour suppression.

Extension GA
az storage blob delete-batch

Supprimez les objets blob d’un conteneur d’objets blob de manière récursive.

Core GA
az storage blob directory

Gérer les répertoires d’objets blob dans le conteneur de compte de stockage.

Extension Préversion et dépréciation
az storage blob directory access

Gère les propriétés de contrôle d’accès d’un répertoire quand l’espace de noms hiérarchique est activé.

Extension Préversion et dépréciation
az storage blob directory access set

Définissez les propriétés du contrôle d’accès d’un répertoire.

Extension Préversion et dépréciation
az storage blob directory access show

Afficher les propriétés du contrôle d’accès d’un répertoire.

Extension Préversion et dépréciation
az storage blob directory access update

Mettez à jour les propriétés du contrôle d’accès d’un répertoire.

Extension Préversion et dépréciation
az storage blob directory create

Créez un répertoire d’objets blob de stockage dans un conteneur de stockage.

Extension Préversion et dépréciation
az storage blob directory delete

Supprimez un répertoire d’objets blob de stockage dans un conteneur de stockage.

Extension Préversion et dépréciation
az storage blob directory download

Téléchargez des objets blob dans un chemin d’accès de fichier local.

Extension Préversion et dépréciation
az storage blob directory exists

Vérifiez l’existence d’un répertoire d’objets blob dans un conteneur de stockage.

Extension Préversion et dépréciation
az storage blob directory list

Répertorier les objets blob et les sous-répertoires d’objets blob dans un répertoire de stockage.

Extension Préversion et dépréciation
az storage blob directory metadata

Gère les métadonnées de répertoire.

Extension Préversion et dépréciation
az storage blob directory metadata show

Affichez toutes les métadonnées définies par l’utilisateur pour le répertoire d’objets blob spécifié.

Extension Préversion et dépréciation
az storage blob directory metadata update

Définissez les métadonnées définies par l’utilisateur pour le répertoire d’objets blob spécifié en tant que paires nom-valeur.

Extension Préversion et dépréciation
az storage blob directory move

Déplacez un répertoire de stockage vers un autre répertoire d’objets blob de stockage dans un conteneur de stockage.

Extension Préversion et dépréciation
az storage blob directory show

Afficher les propriétés d’un répertoire d’objets blob de stockage dans un conteneur de stockage.

Extension Préversion et dépréciation
az storage blob directory upload

Chargez des objets blob ou des sous-répertoires dans un répertoire d’objets blob de stockage.

Extension Préversion et dépréciation
az storage blob download

Téléchargez un objet blob sur un chemin d’accès au fichier.

Core GA
az storage blob download-batch

Téléchargez des objets blob à partir d’un conteneur d’objets blob de manière récursive.

Core GA
az storage blob exists

Recherchez l’existence d’un objet blob dans un conteneur.

Core GA
az storage blob filter

Répertorier les objets blob sur tous les conteneurs dont les balises correspondent à une expression de recherche donnée.

Extension Aperçu
az storage blob generate-sas

Générez une signature d’accès partagé pour l’objet blob.

Core GA
az storage blob generate-sas (storage-blob-preview extension)

Générez une signature d’accès partagé pour l’objet blob.

Extension GA
az storage blob immutability-policy

Gérer la stratégie d’immuabilité d’objet blob.

Core GA
az storage blob immutability-policy delete

Supprimez la stratégie d’immuabilité de l’objet blob.

Core GA
az storage blob immutability-policy set

Définissez la stratégie d’immuabilité de l’objet blob.

Core GA
az storage blob incremental-copy

Gère les opérations de copie incrémentielle d’objets blob.

Core GA
az storage blob incremental-copy cancel

Abandonne une opération de copy_blob en attente et laisse un objet blob de destination avec une longueur nulle et des métadonnées complètes.

Core GA
az storage blob incremental-copy start

Copie une copie incrémentielle d’un objet blob de façon asynchrone.

Core GA
az storage blob lease

Gère les baux d’objets blob de stockage.

Core GA
az storage blob lease acquire

Demandez un nouveau bail.

Core GA
az storage blob lease break

Arrêtez le bail, si le conteneur ou l’objet blob a un bail actif.

Core GA
az storage blob lease change

Modifiez l’ID de bail d’un bail actif.

Core GA
az storage blob lease release

Relâchez le bail.

Core GA
az storage blob lease renew

Renouvelez le bail.

Core GA
az storage blob list

Répertorier les objets blob dans un conteneur donné.

Core GA
az storage blob metadata

Gère les métadonnées d’objets blob.

Core GA
az storage blob metadata show

Retourne toutes les métadonnées définies par l’utilisateur pour l’objet blob ou instantané spécifiés.

Core GA
az storage blob metadata update

Définit les métadonnées définies par l’utilisateur pour l’objet blob sous la forme d’une ou plusieurs paires nom-valeur.

Core GA
az storage blob move

Déplacez un objet blob dans un conteneur de stockage.

Extension Préversion et dépréciation
az storage blob query

Permettre aux utilisateurs de sélectionner/projeter sur des données d’objets blob ou d’objets blob instantané en fournissant des expressions de requête simples.

Core Aperçu
az storage blob restore

Restaurez des objets blob dans les plages d’objets blob spécifiées.

Core GA
az storage blob rewrite

Créez un objet blob de blocs dans lequel le contenu de l’objet blob est lu à partir d’une URL donnée.

Core Aperçu
az storage blob service-properties

Gère les propriétés du service d’objets blob de stockage.

Cœur et extension GA
az storage blob service-properties delete-policy

Gère les propriétés du service de stratégie de suppression d’objets blob de stockage.

Core GA
az storage blob service-properties delete-policy show

Afficher la stratégie de suppression d’objets blob de stockage.

Core GA
az storage blob service-properties delete-policy update

Mettez à jour la stratégie de suppression d’objets blob de stockage.

Core GA
az storage blob service-properties show

Obtient les propriétés du service Blob d’un compte de stockage, notamment Stockage Azure Analytics.

Core GA
az storage blob service-properties update

Mettez à jour les propriétés du service d’objets blob de stockage.

Core GA
az storage blob service-properties update (storage-blob-preview extension)

Mettez à jour les propriétés du service d’objets blob de stockage.

Extension GA
az storage blob set-legal-hold

Définissez la conservation légale de l’objet blob.

Core GA
az storage blob set-tier

Définissez les niveaux de bloc ou de page sur l’objet blob.

Core GA
az storage blob set-tier (storage-blob-preview extension)

Définissez les niveaux de bloc ou de page sur l’objet blob.

Extension GA
az storage blob show

Obtenez les détails d’un objet blob.

Core GA
az storage blob show (storage-blob-preview extension)

Obtenez les détails d’un objet blob.

Extension GA
az storage blob snapshot

Crée une instantané de l’objet blob.

Core GA
az storage blob sync

Synchronisez les objets blob de manière récursive avec un conteneur d’objets blob de stockage.

Core Aperçu
az storage blob tag

Gérer les balises d’objet blob.

Extension Aperçu
az storage blob tag list

Obtenez des balises sur un objet blob ou une version d’objet blob spécifique, ou instantané.

Extension Aperçu
az storage blob tag set

Définissez des balises sur un objet blob ou une version d’objet blob spécifique, mais pas instantané.

Extension Aperçu
az storage blob undelete

Restaurez l’objet blob supprimé de manière réversible ou instantané.

Core GA
az storage blob update

Définit les propriétés système de l'objet blob.

Core GA
az storage blob upload

Chargez un fichier dans un objet blob de stockage.

Core GA
az storage blob upload-batch

Chargez des fichiers à partir d’un répertoire local vers un conteneur d’objets blob.

Core GA
az storage blob url

Créez l’URL pour accéder à un objet blob.

Core GA

az storage blob delete

Marquez un objet blob ou instantané pour suppression.

L’objet blob est marqué pour la suppression ultérieure pendant le garbage collection. Pour supprimer un objet blob, toutes ses instantané doivent également être supprimées. Les deux peuvent être supprimés en même temps.

az storage blob delete [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]

Exemples

Supprimer un objet blob.

az storage blob delete -c mycontainer -n MyBlob

Supprimez un objet blob à l’aide des informations d’identification de connexion.

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--delete-snapshots

Obligatoire si l’objet blob a associé des instantané. Les valeurs sont les suivantes : « uniquement » : supprime uniquement les objets blob instantané s. « include » : supprime l’objet blob avec toutes les instantané.

valeurs acceptées: include, only
--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--name -n

Nom de l’objet blob.

--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

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’il est présent, spécifie l’objet blob instantané à supprimer.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--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 blob delete (storage-blob-preview extension)

Marquez un objet blob ou instantané pour suppression.

L’objet blob est marqué pour la suppression ultérieure pendant le garbage collection. Pour supprimer un objet blob, toutes ses instantané doivent également être supprimées. Les deux peuvent être supprimés en même temps.

az storage blob delete [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]
                       [--version-id]

Exemples

Supprimer un objet blob.

az storage blob delete -c mycontainer -n MyBlob

Supprimez un objet blob à l’aide des informations d’identification de connexion.

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--delete-snapshots

Obligatoire si l’objet blob a associé des instantané. « only » : supprime uniquement les objets blob instantané s. « include » : supprime l’objet blob avec toutes les instantané.

valeurs acceptées: include, only
--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--name -n

Nom de l’objet blob.

--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

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’il est présent, spécifie l’objet blob instantané à récupérer.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--timeout

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

--version-id

ID de version d’objet blob facultatif. Ce paramètre est uniquement destiné au compte activé pour le contrôle de version.

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 blob delete-batch

Supprimez les objets blob d’un conteneur d’objets blob de manière récursive.

az storage blob delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--delete-snapshots {include, only}]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

Exemples

Supprimez tous les objets blob se terminant par « .py » dans un conteneur qui n’ont pas été modifiés pendant 10 jours.

date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern "*.py" --if-unmodified-since $date --auth-mode login

Supprimez tous les objets blob d’un répertoire nommé « dir » dans un conteneur nommé « mycontainer ».

az storage blob delete-batch -s mycontainer --pattern "dir/*"

Supprimez les objets blob au format « cli-2018-xx-xx.txt » ou « cli-2019-xx-xx.txt » dans un conteneur.

az storage blob delete-batch -s mycontainer --pattern "cli-201[89]-??-??.txt"

Supprimez tous les objets blob au format « cli-201x-xx-xx.txt », sauf cli-2018-xx-xx.txt » et « cli-2019-xx-xx.txt » dans un conteneur.

az storage blob delete-batch -s mycontainer --pattern "cli-201[!89]-??-??.txt"

Paramètres obligatoires

--source -s

Conteneur d’objets blob à partir duquel les fichiers seront supprimés.

La source peut être l’URL du conteneur ou le nom du conteneur. Lorsque la source est l’URL du conteneur, le nom du compte de stockage est analysé à partir de l’URL.

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
--blob-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.

--connection-string

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

--delete-snapshots

Obligatoire si l’objet blob a associé des instantané.

valeurs acceptées: include, only
--dryrun

Affichez le résumé des opérations à effectuer au lieu de supprimer réellement le ou les fichiers.

S’il est spécifié, il ignore tous les arguments de condition préalable qui incluent --if-modified-since et --if-unmodified-since. Par conséquent, le ou les fichiers seront supprimés avec la commande sans --dryrun peut être différent de la liste des résultats avec l’indicateur --dryrun activé.

valeur par défaut: False
--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (*).

Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère wild carte (*) pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

ID de bail actif pour l’objet blob.

--pattern

Modèle utilisé pour le globbing de fichiers ou d’objets blob dans la source. Les modèles pris en charge sont « * », « ? », « [seq] » et « [ !seq] ». Pour plus d’informations, reportez-vous à https://docs.python.org/3.7/library/fnmatch.html.

Lorsque vous utilisez '*' dans --pattern, il correspond à n’importe quel caractère, y compris le séparateur de répertoires '/'. Vous pouvez également essayer la commande « az storage remove » avec --include et --exclude avec azure cli >= 2.0.70 pour correspondre à plusieurs modèles.

--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 blob download

Téléchargez un objet blob sur un chemin d’accès au fichier.

az storage blob download [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--end-range]
                         [--file]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--max-connections]
                         [--name]
                         [--no-progress]
                         [--open-mode]
                         [--overwrite {false, true}]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--tags-condition]
                         [--timeout]
                         [--validate-content]
                         [--version-id]

Exemples

Téléchargez un objet blob.

az storage blob download -f /path/to/file -c mycontainer -n MyBlob

Téléchargez un contenu d’objet blob sur stdout(prise en charge du canal).

az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--end-range

Fin de la plage d’octets à utiliser pour télécharger une section de l’objet blob. Si end_range est donné, start_range doit être fourni. Les start_range et end_range params sont inclusifs. Par exemple : start_range=0, end_range=511 télécharge les 512 premiers octets d’objet blob.

--file -f

Chemin d’accès du fichier à écrire. S’il n’est pas spécifié, stdout est utilisé et max_connections est défini sur 1.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--max-connections

Nombre de connexions parallèles avec lesquelles télécharger.

valeur par défaut: 2
--name -n

Nom de l’objet blob.

--no-progress

Incluez cet indicateur pour désactiver le rapport de progression pour la commande.

valeur par défaut: False
--open-mode

Mode à utiliser lors de l’ouverture du fichier. Notez que la spécification de l’ajout uniquement open_mode empêche le téléchargement parallèle. Par conséquent, max_connections devez avoir la valeur 1 si cette open_mode est utilisée.

valeur par défaut: wb
--overwrite

Remplacez un fichier existant lorsqu’il est spécifié. La valeur par défaut est true.

valeurs acceptées: false, true
valeur par défaut: True
--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

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’il est présent, spécifie l’objet blob instantané à récupérer.

--start-range

Début de la plage d’octets à utiliser pour télécharger une section de l’objet blob. Si aucune end_range n’est donnée, tous les octets après le start_range seront téléchargés. Les start_range et end_range params sont inclusifs. Par exemple : start_range=0, end_range=511 télécharge les 512 premiers octets d’objet blob.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--timeout

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

--validate-content

Si la valeur est true, calcule un hachage MD5 pour chaque segment de l’objet blob. Le service de stockage case activée le hachage du contenu arrivé avec le hachage envoyé. Cela est principalement utile pour la détection de bitflips sur le câble si l’utilisation de http au lieu de https, comme https (valeur par défaut), est déjà validé. Notez que ce hachage MD5 n’est pas stocké avec l’objet blob. Notez également qu’en cas d’activation, l’algorithme mémoire efficace ne sera pas utilisé, car le calcul du hachage MD5 nécessite la mise en mémoire tampon des blocs entiers, et cela permet de vaincre l’objectif de l’algorithme mémoire efficace.

valeur par défaut: False
--version-id

ID de version d’objet blob facultatif. Ce paramètre est uniquement destiné au compte activé pour le contrôle de version.

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 blob download-batch

Téléchargez des objets blob à partir d’un conteneur d’objets blob de manière récursive.

az storage blob download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--overwrite {false, true}]
                               [--pattern]
                               [--sas-token]

Exemples

Téléchargez tous les objets blob qui se terminent par .py

az storage blob download-batch -d . --pattern "*.py" -s mycontainer --account-name mystorageaccount --account-key 00000000

Téléchargez tous les objets blob dans un répertoire nommé « dir » à partir du conteneur nommé « mycontainer ».

az storage blob download-batch -d . -s mycontainer --pattern "dir/*"

Téléchargez tous les objets blob au format « cli-2018-xx-xx.txt » ou « cli-2019-xx-xx.txt » dans le conteneur vers le chemin actuel.

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[89]-??-??.txt"

Téléchargez tous les objets blob au format « cli-201x-xx-xx.txt », sauf cli-2018-xx-xx.txt » et « cli-2019-xx-xx.txt » dans le conteneur vers le chemin actuel.

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[!89]-??-??.txt"

Paramètres obligatoires

--destination -d

Dossier de destination existant pour cette opération de téléchargement.

--source -s

Conteneur d’objets blob à partir duquel les fichiers seront téléchargés.

La source peut être l’URL du conteneur ou le nom du conteneur. Lorsque la source est l’URL du conteneur, le nom du compte de stockage est analysé à partir de l’URL.

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
--blob-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.

--connection-string

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

--dryrun

Affichez le résumé des opérations à effectuer au lieu de télécharger le ou les fichiers.

valeur par défaut: False
--max-connections

Nombre de connexions parallèles avec lesquelles télécharger.

valeur par défaut: 2
--no-progress

Incluez cet indicateur pour désactiver le rapport de progression pour la commande.

valeur par défaut: False
--overwrite

Remplacez un fichier existant lorsqu’il est spécifié. La valeur par défaut est False.

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

Modèle utilisé pour le globbing de fichiers ou d’objets blob dans la source. Les modèles pris en charge sont « * », « ? », « [seq] » et « [ !seq] ». Pour plus d’informations, reportez-vous à https://docs.python.org/3.7/library/fnmatch.html.

Lorsque vous utilisez '*' dans --pattern, il correspond à n’importe quel caractère, y compris le séparateur de répertoires '/'.

--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.

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 blob exists

Recherchez l’existence d’un objet blob dans un conteneur.

az storage blob exists [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

Exemples

Recherchez l’existence d’un objet blob dans un conteneur. (généré automatiquement)

az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

--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

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’elle est présente, spécifie la instantané.

--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 blob filter

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les objets blob sur tous les conteneurs dont les balises correspondent à une expression de recherche donnée.

az storage blob filter --tag-filter
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--connection-string]
                       [--container-name]
                       [--sas-token]

Paramètres obligatoires

--tag-filter

Expression permettant de rechercher des objets blob dont les balises correspondent à la condition spécifiée. par exemple « "yourtagname"='firsttag' et « yourtagname2"='secondtag' ».

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
--blob-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.

--connection-string

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

--container-name -c

Utilisé lorsque vous souhaitez répertorier les objets blob sous un conteneur spécifié.

--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.

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 blob generate-sas

Générez une signature d’accès partagé pour l’objet blob.

az storage blob generate-sas [--account-key]
                             [--account-name]
                             [--as-user]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--blob-url]
                             [--cache-control]
                             [--connection-string]
                             [--container-name]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--encryption-scope]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--name]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--timeout]

Exemples

Générez un jeton sas pour un objet blob avec des autorisations en lecture seule.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

Générez un jeton sas pour un objet blob avec une plage d’adresses IP spécifiée.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Générez une signature d’accès partagé pour l’objet blob. (généré automatiquement)

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

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.

--as-user

Indique que cette commande retourne la signature SAP avec la clé de délégation d’utilisateur. Le paramètre d’expiration et la connexion en mode « --auth-mode » sont requis si cet argument est spécifié.

valeur par défaut: False
--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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--cache-control

Valeur d’en-tête de réponse pour Cache-Control lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

--connection-string

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

--container-name -c

Nom du conteneur.

--content-disposition

Valeur d’en-tête de réponse pour Content-Disposition lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

--content-encoding

Valeur d’en-tête de réponse pour Content-Encoding lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

--content-language

Valeur d’en-tête de réponse pour Content-Language lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

--content-type

Valeur d’en-tête de réponse pour Content-Type lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

--encryption-scope

Étendue de chiffrement prédéfinie utilisée pour chiffrer les données sur le service.

--expiry

Spécifie la datetime UTC (Y-m-d’T’H :M’Z') à laquelle la SAP devient non valide. N’utilisez pas si une stratégie d’accès stockée est référencée avec --policy-name qui spécifie cette valeur.

--full-uri

Indique que cette commande retourne l’URI d’objet blob complet et le jeton de signature d’accès partagé.

valeur par défaut: False
--https-only

Autorisez uniquement les demandes effectuées avec le protocole HTTPS. En cas d’omission, les requêtes du protocole HTTP et HTTPS sont autorisées.

--ip

Spécifie l’adresse IP ou la plage d’adresses IP à partir de laquelle accepter les demandes. Prend uniquement en charge les adresses de style IPv4.

--name -n

Nom de l’objet blob.

--permissions

Autorisations accordées par la SAP. Valeurs autorisées : (a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete. N’utilisez pas si une stratégie d’accès stockée est référencée avec --id qui spécifie cette valeur. Peut être combiné.

--policy-name

Nom d’une stratégie d’accès stockée dans la liste de contrôle d’accès du conteneur.

--snapshot

ID de instantané d’objet blob facultatif. Valeur DateTime opaque qui, lorsqu’elle est présente, spécifie l’objet blob instantané d’accorder l’autorisation.

--start

Spécifie la datetime UTC (Y-m-d’T’H :M’Z') à laquelle la SAP devient valide. N’utilisez pas si une stratégie d’accès stockée est référencée avec --policy-name qui spécifie cette valeur. La valeur par défaut est l’heure de la requête.

--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 blob generate-sas (storage-blob-preview extension)

Générez une signature d’accès partagé pour l’objet blob.

az storage blob generate-sas --container-name
                             --name
                             [--account-key]
                             [--account-name]
                             [--as-user]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--version-id]

Exemples

Générez un jeton sas pour un objet blob avec des autorisations en lecture seule.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

Générez un jeton sas pour un objet blob avec une plage d’adresses IP spécifiée.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Générez une signature d’accès partagé pour l’objet blob. (généré automatiquement)

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

Paramètres obligatoires

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

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.

--as-user

Indique que cette commande retourne la signature SAP avec la clé de délégation d’utilisateur. Le paramètre d’expiration et la connexion en mode « --auth-mode » sont requis si cet argument est spécifié.

valeur par défaut: False
--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
--blob-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.

--cache-control

Valeur d’en-tête de réponse pour Cache-Control lorsque la ressource accède à cette signature d’accès partagé.

--connection-string

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

--content-disposition

Valeur d’en-tête de réponse pour Content-Disposition lorsque la ressource accède à cette signature d’accès partagé.

--content-encoding

Valeur d’en-tête de réponse pour Content-Encoding lorsque la ressource accède à cette signature d’accès partagé.

--content-language

Valeur d’en-tête de réponse pour Content-Language lorsque la ressource accède à cette signature d’accès partagé.

--content-type

Valeur d’en-tête de réponse pour Content-Type lorsque la ressource accède à cette signature d’accès partagé.

--expiry

Spécifie la datetime UTC (Y-m-d’T’H :M’Z') à laquelle la SAP devient non valide. N’utilisez pas si une stratégie d’accès stockée est référencée avec --id qui spécifie cette valeur.

--full-uri

Indiquez que cette commande retourne l’URI d’objet blob complet et le jeton de signature d’accès partagé.

valeur par défaut: False
--https-only

Autorisez uniquement les demandes effectuées avec le protocole HTTPS. En cas d’omission, les requêtes du protocole HTTP et HTTPS sont autorisées.

--ip

Spécifiez une adresse IP ou une plage d’adresses IP à partir de laquelle accepter les demandes. Si l’adresse IP à partir de laquelle la requête provient ne correspond pas à l’adresse IP ou à la plage d’adresses spécifiée sur le jeton SAP, la demande n’est pas authentifiée. Par exemple, la spécification d’ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 sur la SAP limite la demande à ces adresses IP.

--permissions

Autorisations accordées par la SAP. Valeurs autorisées : (a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (m)ove (p)ermanent_delete (r)ead (s)et_immutability_policy (t)ag (w)rite. N’utilisez pas si une stratégie d’accès stockée est référencée avec --policy-name qui spécifie cette valeur. Peut être combiné.

--policy-name

Nom d’une stratégie d’accès stockée dans la liste de contrôle d’accès du conteneur.

--snapshot

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’il est présent, spécifie l’objet blob instantané à récupérer.

--start

Spécifie la datetime UTC (Y-m-d’T’H :M’Z') à laquelle la SAP devient valide. N’utilisez pas si une stratégie d’accès stockée est référencée avec --id qui spécifie cette valeur. La valeur par défaut est l’heure de la requête.

--version-id
Préversion

ID de version d’objet blob facultatif. Ce paramètre est uniquement destiné au compte activé pour le contrôle de version.

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 blob list

Répertorier les objets blob dans un conteneur donné.

az storage blob list --container-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--connection-string]
                     [--delimiter]
                     [--include]
                     [--marker]
                     [--num-results]
                     [--prefix]
                     [--sas-token]
                     [--show-next-marker]
                     [--timeout]

Exemples

Répertorier tous les objets blob de stockage dans un conteneur dont les noms commencent par « foo » ; correspond aux noms tels que « foo », « foobar » et « foo/bar ».

az storage blob list -c mycontainer --prefix foo

Paramètres obligatoires

--container-name -c

Nom du conteneur.

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
--blob-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.

--connection-string

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

--delimiter

Lorsque la requête inclut ce paramètre, l’opération retourne un élément BlobPrefix dans la liste des résultats qui agit comme un espace réservé pour tous les objets blob dont les noms commencent par la même sous-chaîne jusqu’à l’apparence du caractère délimiteur. Le délimiteur peut être un caractère unique ou une chaîne.

--include

Spécifiez un ou plusieurs jeux de données supplémentaires à inclure dans la réponse. Les options incluent : (c)opy, (d)eleted, (m)etadata, (s)napshots, (v)ersions, (t)ags, (i)mmutabilitypolicy, (l)egalhold, (d)eletedwithversions. Peut être combiné.

--marker

Valeur de chaîne qui identifie la partie de la liste des conteneurs à retourner avec l’opération de référencement suivante. L’opération retourne la valeur NextMarker dans le corps de la réponse si l’opération de référencement n’a pas renvoyé tous les conteneurs restants à répertorier avec la page active. Si spécifié, ce générateur commence à retourner les résultats à partir du point où le générateur précédent s’est arrêté.

--num-results

Spécifiez le nombre maximal à retourner. Si la demande ne spécifie pas num_results ou spécifie une valeur supérieure à 5 000, le serveur retourne jusqu’à 5 000 éléments. Notez que si l’opération de référencement dépasse une limite de partition, le service retourne un jeton de continuation pour récupérer le reste des résultats. Indiquez « * » pour retourner tout.

valeur par défaut: 5000
--prefix

Filtrez les résultats pour retourner uniquement les objets blob dont le nom commence par le préfixe spécifié.

--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.

--show-next-marker

Affichez nextMarker dans le résultat lorsqu’il est spécifié.

--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 blob move

Préversion Déprécié

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

Cette commande a été déconseillée et sera supprimée dans la prochaine version. Utilisez plutôt « az storage fs file move ». Pour plus d’informations, consultez https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

Déplacez un objet blob dans un conteneur de stockage.

az storage blob move --container-name
                     --destination-blob
                     --source-blob
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--lease-id]
                     [--sas-token]
                     [--source-if-match]
                     [--source-if-modified-since]
                     [--source-if-none-match]
                     [--source-if-unmodified-since]
                     [--source-lease-id]
                     [--timeout]

Exemples

Déplacez un objet blob dans un conteneur de stockage.

az storage blob move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount

Paramètres obligatoires

--container-name -c

Nom du conteneur.

--destination-blob -d

Nom de l’objet blob de destination. Il doit s’agir d’un chemin absolu sous le conteneur. par exemple« topdir1/dirbar ».

--source-blob -s

Nom de l’objet blob source. Il doit s’agir d’un chemin absolu sous le conteneur. par exemple,'topdir1/dirsubfoo'.

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
--connection-string

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

--lease-id

facultatif. ID de bail pour la new_path. Le new_path doit avoir un bail actif et l’ID de bail doit correspondre.

--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.

--source-if-match

facultatif. Valeur ETag. Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si l’ETag de la source correspond à la valeur spécifiée.

--source-if-modified-since

facultatif. Valeur de date et d’heure. Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si la source a été modifiée depuis la date et l’heure spécifiées.

--source-if-none-match

facultatif. Valeur ETag ou valeur générique spéciale carte (« * »). Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si l’ETag de la source ne correspond pas à la valeur spécifiée.

--source-if-unmodified-since

facultatif. Valeur de date et d’heure. Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si la source n’a pas été modifiée depuis la date et l’heure spécifiées.

--source-lease-id

facultatif. ID de bail de la source_path. Le source_path doit avoir un bail actif et l’ID de bail doit correspondre.

--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 blob query

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Permettre aux utilisateurs de sélectionner/projeter sur des données d’objets blob ou d’objets blob instantané en fournissant des expressions de requête simples.

az storage blob query --query-expression
                      [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--blob-endpoint]
                      [--blob-url]
                      [--connection-string]
                      [--container-name]
                      [--if-match]
                      [--if-modified-since]
                      [--if-none-match]
                      [--if-unmodified-since]
                      [--in-column-separator]
                      [--in-escape-char]
                      [--in-has-header]
                      [--in-line-separator]
                      [--in-quote-char]
                      [--in-record-separator]
                      [--input-format {csv, json}]
                      [--lease-id]
                      [--name]
                      [--out-column-separator]
                      [--out-escape-char]
                      [--out-has-header]
                      [--out-line-separator]
                      [--out-quote-char]
                      [--out-record-separator]
                      [--output-format {csv, json}]
                      [--result-file]
                      [--sas-token]
                      [--tags-condition]
                      [--timeout]

Exemples

Permettre aux utilisateurs de sélectionner/projeter sur l’objet blob en fournissant des expressions de requête simples.

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage"

Permettre aux utilisateurs de sélectionner/projeter sur l’objet blob en fournissant des expressions de requête simples et en les enregistrer dans le fichier cible.

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage" --result-file result.csv

Paramètres obligatoires

--query-expression

Expression de requête dans SQL. La taille maximale de l’expression de requête est 256KiB. Pour plus d’informations sur la syntaxe d’expression, consultez https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--in-column-separator

Chaîne utilisée pour séparer les colonnes.

valeur par défaut: ,
--in-escape-char

Chaîne utilisée comme caractère d’échappement. Valeur par défaut vide.

--in-has-header

Indique si les données d’objet blob incluent des en-têtes dans la première ligne. La valeur par défaut est False, ce qui signifie que les données seront retournées inclus dans la première ligne. Si la valeur est True, les données sont retournées exclusives à la première ligne.

valeur par défaut: False
--in-line-separator

Chaîne utilisée pour séparer les enregistrements.

valeur par défaut:
--in-quote-char

Chaîne utilisée pour citer un champ spécifique.

valeur par défaut: "
--in-record-separator

Chaîne utilisée pour séparer les enregistrements.

valeur par défaut:
--input-format

Type de sérialisation des données actuellement stockées dans l’objet blob. La valeur par défaut consiste à traiter les données d’objet blob comme des données CSV mises en forme dans le dialecte par défaut. Les données d’objet blob sont reformatées en fonction de ce profil lorsque le format d’objet blob est spécifié. Si vous choisissez json, spécifiez Output Json Text Configuration Arguments en conséquence ; Si vous choisissez csv, spécifiez Output Delimited Text Configuration Arguments.

valeurs acceptées: csv, json
--lease-id

Obligatoire si l’objet blob a un bail actif.

--name -n

Nom de l’objet blob.

--out-column-separator

Chaîne utilisée pour séparer les colonnes.

valeur par défaut: ,
--out-escape-char

Chaîne utilisée comme caractère d’échappement. Valeur par défaut vide.

--out-has-header

Indique si les données d’objet blob incluent des en-têtes dans la première ligne. La valeur par défaut est False, ce qui signifie que les données seront retournées inclus dans la première ligne. Si la valeur est True, les données sont retournées exclusives à la première ligne.

valeur par défaut: False
--out-line-separator

Chaîne utilisée pour séparer les enregistrements.

valeur par défaut:
--out-quote-char

Chaîne utilisée pour citer un champ spécifique.

valeur par défaut: "
--out-record-separator

Chaîne utilisée pour séparer les enregistrements.

valeur par défaut:
--output-format

Type de sérialisation de sortie pour le flux de données. Par défaut, les données sont retournées, car elles sont représentées dans l’objet blob. En fournissant un format de sortie, les données d’objet blob seront reformatées en fonction de ce profil. Si vous choisissez json, spécifiez Output Json Text Configuration Arguments en conséquence ; Si vous choisissez csv, spécifiez Output Delimited Text Configuration Arguments.

valeurs acceptées: csv, json
--result-file

Spécifiez le chemin d’accès du fichier pour enregistrer le résultat.

--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.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--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 blob restore

Restaurez des objets blob dans les plages d’objets blob spécifiées.

az storage blob restore --account-name
                        --time-to-restore
                        [--blob-range]
                        [--no-wait]
                        [--resource-group]

Exemples

Restaurez des objets blob dans deux plages d’objets blob spécifiées. Par exemple, (container1/blob1, container2/blob2) et (container2/blob3.). container2/blob4).

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4

Restaurez des objets blob dans les plages d’objets blob spécifiées de début à la fin du compte.

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""

Restaurez des objets blob dans la plage d’objets blob spécifiée.

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2

Restaurez des objets blob dans la plage d’objets blob spécifiée sans attendre et interroger l’état de restauration des objets blob avec « az storage account show ».

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait

Paramètres obligatoires

--account-name -n

nom du compte de stockage.

--time-to-restore -t

Restaurez l’objet blob à l’heure spécifiée, qui doit être utc datetime in (Y-m-d’T’H :M :S’Z').

Paramètres facultatifs

--blob-range -r

Plages d’objets blob à restaurer. Vous devez spécifier start_range et end_range pour chaque plage d’objets blob, par exemple -r blob1 blob2. Remarque : Vide signifie que le compte commence comme valeur de plage de début et signifie que la fin du compte pour la plage de fin.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 blob rewrite

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créez un objet blob de blocs dans lequel le contenu de l’objet blob est lu à partir d’une URL donnée.

Le contenu d’un objet blob existant est remplacé par le nouvel objet blob.

az storage blob rewrite --container-name
                        --name
                        --source-uri
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--encryption-scope]
                        [--if-match]
                        [--if-modified-since]
                        [--if-none-match]
                        [--if-unmodified-since]
                        [--lease-id]
                        [--sas-token]
                        [--tags-condition]
                        [--tier {Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
                        [--timeout]

Exemples

Mettez à jour l’étendue du chiffrement pour l’objet blob existant.

az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Paramètres obligatoires

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

--source-uri -u

URL de jusqu’à 2 Ko de longueur qui spécifie un fichier ou un objet blob. La valeur doit être encodée en URL, car elle apparaît dans un URI de requête. Si la source se trouve dans un autre compte, la source doit être publique ou doit être authentifiée via une signature d’accès partagé. Si la source est publique, aucune authentification n’est requise.

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
--blob-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.

--connection-string

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

--encryption-scope

Étendue de chiffrement prédéfinie utilisée pour chiffrer les données sur le service. Une étendue de chiffrement peut être créée à l’aide de l’API gestion et référencée ici par nom. Si une étendue de chiffrement par défaut a été définie sur le conteneur, cette valeur le remplace si l’étendue au niveau du conteneur est configurée pour autoriser les remplacements. Sinon, une erreur est déclenchée.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif. La valeur peut être un objet BlobLeaseClient ou l’ID de bail sous forme de chaîne.

--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.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--tier

Valeur de niveau d’objet blob standard pour définir l’objet blob. Pour cette version de la bibliothèque, cela s’applique uniquement aux objets blob de blocs sur les comptes de stockage standard.

valeurs acceptées: Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80
--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.

Définissez la conservation légale de l’objet blob.

az storage blob set-legal-hold --container-name
                               --legal-hold {false, true}
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

Configurez la conservation légale des objets blob.

az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Effacer la conservation légale de l’objet blob.

az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
--container-name -c

Nom du conteneur.

--legal-hold

Spécifié si une conservation légale doit être définie sur l’objet blob.

valeurs acceptées: false, true
--name -n

Nom de l’objet blob.

--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
--blob-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.

--connection-string

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

--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 blob set-tier

Définissez les niveaux de bloc ou de page sur l’objet blob.

Pour l’objet blob de blocs, cette commande prend uniquement en charge l’objet blob de blocs sur les comptes de stockage standard. Pour l’objet blob de pages, cette commande prend uniquement en charge les objets blob de pages sur les comptes Premium.

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--timeout]
                         [--type {block, page}]

Exemples

Définissez les niveaux de bloc ou de page sur l’objet blob. (généré automatiquement)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

Paramètres obligatoires

--tier

Valeur de niveau sur laquelle définir l’objet blob.

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

--rehydrate-priority -r
Préversion

Indiquez la priorité avec laquelle réhydrater un objet blob archivé. La priorité ne peut être définie qu’une seule fois sur un objet blob, la valeur par défaut est Standard.

valeurs acceptées: High, Standard
--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

Le paramètre de délai d’expiration est exprimé en secondes. Cette méthode peut effectuer plusieurs appels au service Azure et le délai d’expiration s’applique à chaque appel individuellement.

--type -t

Type d’objet blob.

valeurs acceptées: block, page
valeur par défaut: block
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 blob set-tier (storage-blob-preview extension)

Définissez les niveaux de bloc ou de page sur l’objet blob.

Pour l’objet blob de blocs, cette commande prend uniquement en charge l’objet blob de blocs sur les comptes de stockage standard. Pour l’objet blob de pages, cette commande prend uniquement en charge les objets blob de pages sur les comptes Premium.

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]
                         [--type {block, page}]
                         [--version-id]

Exemples

Définissez les niveaux de bloc ou de page sur l’objet blob. (généré automatiquement)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

Paramètres obligatoires

--tier

Valeur de niveau sur laquelle définir l’objet blob.

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

--rehydrate-priority -r
Préversion

Indiquez la priorité avec laquelle réhydrater un objet blob archivé.

valeurs acceptées: High, Standard
--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.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--timeout

Le paramètre de délai d’expiration est exprimé en secondes. Cette méthode peut effectuer plusieurs appels au service Azure et le délai d’expiration s’applique à chaque appel individuellement.

--type -t

Type d’objet blob.

valeurs acceptées: block, page
valeur par défaut: block
--version-id

ID de version d’objet blob facultatif. Ce paramètre est uniquement destiné au compte activé pour le contrôle de version.

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 blob show

Obtenez les détails d’un objet blob.

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]

Exemples

Afficher toutes les propriétés d’un objet blob.

az storage blob show -c mycontainer -n MyBlob

Obtenir les détails d’un objet blob (généré automatiquement)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--name -n

Nom de l’objet blob.

--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

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’il est présent, spécifie l’objet blob instantané à récupérer.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--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 blob show (storage-blob-preview extension)

Obtenez les détails d’un objet blob.

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]
                     [--version-id]

Exemples

Afficher toutes les propriétés d’un objet blob.

az storage blob show -c mycontainer -n MyBlob

Obtenir les détails d’un objet blob (généré automatiquement)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--name -n

Nom de l’objet blob.

--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

Le paramètre instantané est une valeur DateTime opaque qui, lorsqu’il est présent, spécifie l’objet blob instantané à récupérer.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--timeout

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

--version-id
Préversion

ID de version d’objet blob facultatif. Ce paramètre est uniquement destiné au compte activé pour le contrôle de version.

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 blob snapshot

Crée une instantané de l’objet blob.

Un instantané est une version en lecture seule d'un objet blob capturé à un instant donné. Il peut être lu, copié ou supprimé, mais pas modifié. Les instantanés sont une façon de sauvegarder un objet blob à un instant T. Une instantané d’un objet blob porte le même nom que l’objet blob de base à partir duquel le instantané est pris, avec une valeur DateTime ajoutée pour indiquer l’heure à laquelle la instantané a été prise.

az storage blob snapshot [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--metadata]
                         [--name]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--metadata

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

--name -n

Nom de l’objet blob.

--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.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--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 blob sync

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Synchronisez les objets blob de manière récursive avec un conteneur d’objets blob de stockage.

az storage blob sync --container
                     --source
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]
                     [<EXTRA_OPTIONS>]

Exemples

Synchronisez un objet blob unique sur un conteneur.

az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob

Synchronisez un répertoire avec un conteneur.

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"

Synchronisez un répertoire sur un conteneur avec les options azcopy pass-through (dans ce cas, limiter la bande de chargement à 20 Mo it/s).

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory" -- --cap-mbps=20

Paramètres obligatoires

--container -c

Conteneur de destination de synchronisation.

--source -s

Chemin d’accès du fichier source à partir duquel synchroniser.

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.

--connection-string

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

--delete-destination

Définit s’il faut supprimer des fichiers supplémentaires de la destination qui ne sont pas présents à la source. Valeurs possibles : true, false ou prompt. Si la valeur est définie sur prompt, l’utilisateur est invité à répondre à une question avant de planifier la suppression des fichiers et des objets blob.

valeurs acceptées: false, prompt, true
valeur par défaut: true
--destination -d

Chemin d’accès de destination qui sera ajouté au nom de l’objet blob.

--exclude-path

Excluez ces chemins d’accès. Cette option ne prend pas en charge les caractères génériques (*). Vérifie le préfixe du chemin d’accès relatif. Par exemple : myFolder;myFolder/subDirName/file.pdf.

--exclude-pattern

Excluez ces fichiers où le nom correspond à la liste de modèles. Par exemple : .jpg;.pdf;exactName. Cette option prend en charge les caractères génériques (*).

--include-pattern

Incluez uniquement ces fichiers où le nom correspond à la liste des modèles. Par exemple : .jpg;.pdf;exactName. Cette option prend en charge les caractères génériques (*).

--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.

<EXTRA_OPTIONS>
Expérimental

Autres options qui seront transmises à azcopy comme c’est le cas. Veuillez placer toutes les options supplémentaires après un --.

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 blob undelete

Restaurez l’objet blob supprimé de manière réversible ou instantané.

L’opération réussit uniquement si elle est utilisée dans le nombre de jours spécifié défini dans la stratégie de rétention de suppression. Toute tentative de suppression réversible d’un objet blob ou d’un instantané qui n’est pas supprimé de manière réversible réussit sans aucune modification.

az storage blob undelete [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--sas-token]
                         [--timeout]

Exemples

Annuler la suppression d’un objet blob.

az storage blob undelete -c mycontainer -n MyBlob

Annulez la suppression d’un objet blob à l’aide des informations d’identification de connexion.

az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

--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 blob update

Définit les propriétés système de l'objet blob.

Si une propriété est définie pour le content_settings, toutes les propriétés sont remplacées.

az storage blob update --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--tags-condition]
                       [--timeout]

Paramètres obligatoires

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

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
--blob-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.

--clear-content-settings

Si cet indicateur est défini, si une ou plusieurs des propriétés suivantes (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-language, --content-md5, --content-type) sont définies, toutes ces propriétés sont définies ensemble. Si une valeur n’est pas fournie pour une propriété donnée lorsque au moins une des propriétés répertoriées ci-dessous est définie, cette propriété sera effacée.

valeurs acceptées: false, true
--connection-string

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

--content-cache --content-cache-control

Chaîne de contrôle du cache.

--content-disposition

Transmet des informations supplémentaires sur la façon de traiter la charge utile de réponse et peut également être utilisée pour attacher des métadonnées supplémentaires.

--content-encoding

Type d’encodage de contenu.

--content-language

Langue du contenu.

--content-md5

Hachage MD5 du contenu.

--content-type

Type MIME de contenu.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--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.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--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 blob upload

Chargez un fichier dans un objet blob de stockage.

Créez un objet blob à partir d’un chemin d’accès de fichier ou mettant à jour le contenu d’un objet blob existant avec des notifications automatiques de segmentation et de progression.

az storage blob upload [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--data]
                       [--encryption-scope]
                       [--file]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--length]
                       [--max-connections]
                       [--maxsize-condition]
                       [--metadata]
                       [--name]
                       [--no-progress]
                       [--overwrite {false, true}]
                       [--sas-token]
                       [--socket-timeout]
                       [--tags]
                       [--tags-condition]
                       [--tier]
                       [--timeout]
                       [--type {append, block, page}]
                       [--validate-content]

Exemples

Chargez sur un objet blob.

az storage blob upload -f /path/to/file -c mycontainer -n MyBlob

Chargez sur un objet blob avec l’URL sas d’objet blob.

az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted

Chargez un fichier dans un objet blob de stockage. (généré automatiquement)

az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob

Chargez une chaîne dans un objet blob.

az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Chargez-le vers un canal de passage.

echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

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
--blob-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.

--blob-url

URL de point de terminaison complète vers l’objet blob, y compris le jeton SAP et instantané si elle est utilisée. Il peut s’agir du point de terminaison principal ou du point de terminaison secondaire en fonction du point de terminaison actuel location_mode.

--connection-string

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

--container-name -c

Nom du conteneur.

--content-cache --content-cache-control

Chaîne de contrôle du cache.

--content-disposition

Transmet des informations supplémentaires sur la façon de traiter la charge utile de réponse et peut également être utilisée pour attacher des métadonnées supplémentaires.

--content-encoding

Type d’encodage de contenu.

--content-language

Langue du contenu.

--content-md5

Hachage MD5 du contenu.

--content-type

Type MIME de contenu.

--data
Préversion

Données d’objet blob à charger.

--encryption-scope

Étendue de chiffrement prédéfinie utilisée pour chiffrer les données sur le service.

--file -f

Chemin d’accès du fichier à charger en tant que contenu d’objet blob.

--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère générique carte () pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

Obligatoire si l’objet blob a un bail actif.

--length
Préversion

Nombre d’octets à lire à partir du flux. Cela est facultatif, mais doit être fourni pour des performances optimales. Collaborez avec --data.

--max-connections

Nombre maximal de connexions parallèles à utiliser lorsque la taille de l’objet blob dépasse 64 Mo.

valeur par défaut: 2
--maxsize-condition

Longueur maximale en octets autorisée pour un objet blob d’ajout.

--metadata

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

--name -n

Nom de l’objet blob.

--no-progress

Incluez cet indicateur pour désactiver le rapport de progression pour la commande.

valeur par défaut: False
--overwrite

Indique si l’objet blob à charger doit remplacer les données actuelles. Si la valeur est True, l’opération de chargement d’objets blob remplace les données existantes. Si la valeur est False, l’opération échoue avec ResourceExistsError. L’exception à ce qui précède concerne les types d’objets blob Append : si la valeur est False et que les données existent déjà, une erreur n’est pas générée et les données sont ajoutées à l’objet blob existant. Si vous définissez overwrite=True, l’objet blob d’ajout existant est supprimé et un nouvel objet blob créé. Valeur par défaut False.

valeurs acceptées: false, true
--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.

--socket-timeout

Délai d’expiration du socket(ss), utilisé par le service pour réglementer le flux de données.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--tier

Valeur de niveau sur laquelle définir l’objet blob. Pour l’objet blob de pages, le niveau correspond à la taille de l’objet blob et au nombre d’E/S par seconde autorisées. Les valeurs possibles sont P10, P15, P20, P30, P4, P40, P50, P6, P60, P60, P70, P80 et cela s’applique uniquement aux objets blob de pages sur les comptes de stockage Premium ; Pour l’objet blob de blocs, les valeurs possibles sont Archive, Froid, Froid et Chaud. Cela s’applique uniquement aux objets blob de blocs sur les comptes de stockage standard.

--timeout

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

--type -t

Valeur par défaut « page » pour les fichiers *.vhd ou « block » sinon.

valeurs acceptées: append, block, page
--validate-content

Spécifiez qu’un hachage MD5 doit être calculé pour chaque segment de l’objet blob et vérifié par le service lorsque le bloc est arrivé.

valeur par défaut: False
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 blob upload-batch

Chargez des fichiers à partir d’un répertoire local vers un conteneur d’objets blob.

az storage blob upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--max-connections]
                             [--maxsize-condition]
                             [--metadata]
                             [--no-progress]
                             [--overwrite {false, true}]
                             [--pattern]
                             [--sas-token]
                             [--tags]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

Exemples

Chargez tous les fichiers qui se terminent par .py sauf si l’objet blob existe et a été modifié depuis la date donnée.

az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern "*.py" --if-unmodified-since 2018-08-27T20:51Z

Chargez tous les fichiers du répertoire de chemin d’accès local vers un conteneur nommé « mycontainer ».

az storage blob upload-batch -d mycontainer -s <path-to-directory>

Chargez tous les fichiers au format « cli-2018-xx-xx.txt » ou « cli-2019-xx-xx.txt » dans le répertoire de chemin d’accès local.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[89]-??-??.txt"

Chargez tous les fichiers au format « cli-201x-xx-xx.txt », sauf cli-2018-xx-xx.txt » et « cli-2019-xx-xx.txt » dans un conteneur.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[!89]-??-??.txt"

Paramètres obligatoires

--destination -d

Conteneur d’objets blob dans lequel les fichiers seront chargés.

La destination peut être l’URL du conteneur ou le nom du conteneur. Lorsque la destination est l’URL du conteneur, le nom du compte de stockage est analysé à partir de l’URL.

--source -s

Répertoire où se trouvent les fichiers à charger.

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
--blob-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.

--connection-string

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

--content-cache --content-cache-control

Chaîne de contrôle du cache.

--content-disposition

Transmet des informations supplémentaires sur la façon de traiter la charge utile de réponse et peut également être utilisée pour attacher des métadonnées supplémentaires.

--content-encoding

Type d’encodage de contenu.

--content-language

Langue du contenu.

--content-md5

Hachage MD5 du contenu.

--content-type

Type MIME de contenu.

--destination-path

Chemin d’accès de destination qui sera ajouté au nom de l’objet blob.

--dryrun

Affichez le résumé des opérations à effectuer au lieu de charger réellement le ou les fichiers.

valeur par défaut: False
--if-match

Valeur ETag, ou caractère générique carte (*). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée.

--if-modified-since

Commencez uniquement si la datetime UTC fournie est modifiée (Y-m-d’T’H :M’Z').

--if-none-match

Valeur ETag, ou caractère générique carte (*).

Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. Spécifiez le caractère wild carte (*) pour effectuer l’opération uniquement si la ressource n’existe pas et échouez l’opération si elle existe.

--if-unmodified-since

Commencez uniquement s’il n’est pas modifié depuis le datetime UTC fourni (Y-m-d’T’H :M’Z').

--lease-id

ID de bail actif pour l’objet blob.

--max-connections

Nombre maximal de connexions parallèles à utiliser lorsque la taille de l’objet blob dépasse 64 Mo.

valeur par défaut: 2
--maxsize-condition

Longueur maximale en octets autorisée pour un objet blob d’ajout.

--metadata

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

--no-progress

Incluez cet indicateur pour désactiver le rapport de progression pour la commande.

valeur par défaut: False
--overwrite

Indique si l’objet blob à charger doit remplacer les données actuelles. Si la valeur est True, l’opération de chargement d’objets blob remplace les données existantes. Si la valeur est False, l’opération échoue avec ResourceExistsError. L’exception à ce qui précède concerne les types d’objets blob Append : si la valeur est False et que les données existent déjà, une erreur n’est pas générée et les données sont ajoutées à l’objet blob existant. Si vous définissez overwrite=True, l’objet blob d’ajout existant est supprimé et un nouvel objet blob créé. Valeur par défaut False.

valeurs acceptées: false, true
--pattern

Modèle utilisé pour le globbing de fichiers ou d’objets blob dans la source. Les modèles pris en charge sont « * », « ? », « [seq] » et « [ !seq] ». Pour plus d’informations, reportez-vous à https://docs.python.org/3.7/library/fnmatch.html.

Lorsque vous utilisez '*' dans --pattern, il correspond à n’importe quel caractère, y compris le séparateur de répertoires '/'.

--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.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--tags-condition

Spécifiez une clause SQL where sur les balises d’objet blob pour fonctionner uniquement sur les objets blob avec une valeur correspondante.

--tier

Valeur de niveau sur laquelle définir l’objet blob. Pour l’objet blob de pages, le niveau correspond à la taille de l’objet blob et au nombre d’E/S par seconde autorisées. Les valeurs possibles sont P10, P15, P20, P30, P4, P40, P50, P6, P60, P60, P70, P80 et cela s’applique uniquement aux objets blob de pages sur les comptes de stockage Premium ; Pour l’objet blob de blocs, les valeurs possibles sont Archive, Froid, Froid et Chaud. Cela s’applique uniquement aux objets blob de blocs sur les comptes de stockage standard.

--timeout

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

--type -t

La valeur par défaut est « page » pour les fichiers *.vhd ou « block » sinon. Le paramètre remplace les types d’objets blob pour chaque fichier.

valeurs acceptées: append, block, page
--validate-content

Spécifie qu’un hachage MD5 doit être calculé pour chaque segment de l’objet blob et vérifié par le service lorsque le bloc est arrivé.

valeur par défaut: False
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 blob url

Créez l’URL pour accéder à un objet blob.

az storage blob url --container-name
                    --name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--blob-endpoint]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]
                    [--snapshot]

Exemples

Créer l’URL pour accéder à un objet blob (généré automatiquement)

az storage blob url --connection-string $connectionString --container-name container1 --name blob1

Créer l’URL pour accéder à un objet blob (généré automatiquement)

az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1

Paramètres obligatoires

--container-name -c

Nom du conteneur.

--name -n

Nom de l’objet blob.

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
--blob-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.

--connection-string

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

--protocol

Protocole à utiliser.

valeurs acceptées: http, https
valeur par défaut: https
--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

Valeur de chaîne qui identifie de manière unique le instantané. La valeur de ce paramètre de requête indique la version instantané.

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.