Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
L’interface de ligne de commande Azure (Azure CLI) est l’expérience de ligne de commande d’Azure pour gérer les ressources Azure. Vous pouvez l’utiliser dans votre navigateur avec Azure Cloud Shell. Vous pouvez également l’installer sur Windows, Linux ou MacOS, et l’exécuter à partir de la ligne de commande. Dans ce guide de démarrage rapide, vous allez apprendre à utiliser Azure CLI pour charger et télécharger des données vers et à partir du stockage Blob Azure.
Prerequisites
Pour accéder à Stockage Azure, vous avez besoin d’un abonnement Azure. Si vous n’avez pas d’abonnement, vous pouvez créer un compte gratuit avant de commencer.
Tous les accès à Stockage Azure se font via un compte de stockage. Pour ce guide de démarrage rapide, créez un compte de stockage à l’aide du portail Azure, d’Azure PowerShell ou de l’interface Azure CLI. Pour obtenir de l’aide sur la création d’un compte de stockage, consultez Créer un compte de stockage.
Préparation de votre environnement pour Azure CLI
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.
Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Comment exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
- Cet article nécessite la version 2.0.46 ou ultérieure d’Azure CLI. Si vous utilisez Azure Cloud Shell, la dernière version est déjà installée.
Autoriser l’accès au stockage Blob
Vous pouvez autoriser l’accès au stockage Blob depuis l’interface de ligne de commande Azure, soit avec les informations d’identification Microsoft Entra, soit à l’aide de la clé d’accès du compte de stockage. L’utilisation des informations d’identification Microsoft Entra est recommandée. Cet article explique comment autoriser les opérations de stockage Blob en utilisant Microsoft Entra ID.
Les commandes Azure CLI pour les opérations de données sur le stockage Blob prennent en charge le --auth-mode paramètre, ce qui vous permet de spécifier comment autoriser une opération donnée. Définissez le paramètre --auth-mode sur login pour autoriser avec les informations d’identification Microsoft Entra. Pour plus d’informations, consultez Autoriser l’accès aux données d’objet blob et de file d’attente avec Azure CLI.
Seules les opérations de données de stockage Blob prennent en charge le --auth-mode paramètre. Les opérations de gestion, telles que la création d’un groupe de ressources ou d’un compte de stockage, utilisent automatiquement les informations d’identification Microsoft Entra pour l’autorisation.
Pour commencer, connectez-vous à votre compte Azure à l'aide de az login.
az login
Créer un groupe de ressources
Créez un groupe de ressources Azure avec la commande az group create. Un groupe de ressources est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.
N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az group create \
--name <resource-group> \
--location <location>
Créez un compte de stockage.
Créez un compte de stockage à usage général avec la commande az storage account create . Le compte de stockage à usage général peut être utilisé pour les quatre services : objets blob, fichiers, tables et files d’attente.
N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Créer un conteneur
Les objets blob sont toujours chargés dans un conteneur. Vous pouvez organiser des groupes d’objets blob dans des conteneurs similaires à la façon dont vous organisez vos fichiers sur votre ordinateur dans des dossiers. Créez un conteneur pour stocker des objets blob avec la commande az storage container create.
L’exemple suivant utilise votre compte Microsoft Entra pour autoriser l’opération à créer le conteneur. Avant de créer le conteneur, attribuez le rôle Contributeur aux données blob de stockage à vous-même. Même si vous êtes le propriétaire du compte, vous avez besoin d’autorisations explicites pour effectuer des opérations de données sur le compte de stockage. Pour plus d’informations sur l’attribution de rôles Azure, consultez Affecter un rôle Azure pour accéder aux données d’objet blob.
N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az ad signed-in-user show --query id -o tsv | az role assignment create \
--role "Storage Blob Data Contributor" \
--assignee @- \
--scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>"
az storage container create \
--account-name <storage-account> \
--name <container> \
--auth-mode login
Important
Les attributions de rôles Azure peuvent prendre quelques minutes pour se propager.
Vous pouvez également utiliser la clé de compte de stockage pour autoriser l’opération à créer le conteneur. Pour plus d’informations sur l’autorisation des opérations de données avec Azure CLI, consultez Autoriser l’accès aux données d’objet blob ou de file d’attente avec Azure CLI.
Téléverser un blob
Stockage Blob prend en charge les objets blob de blocs, d’ajout et de pages. Les exemples de ce guide de démarrage rapide montrent comment utiliser des objets blob de blocs.
Tout d'abord, créez un fichier à téléverser dans un blob de blocs. Si vous utilisez Azure Cloud Shell, utilisez la commande suivante pour créer un fichier :
vi helloworld
Lorsque le fichier s’ouvre, appuyez sur Insertion. Tapez Hello world, puis appuyez sur Échap. Ensuite, tapez :x, puis appuyez sur Entrée.
Dans cet exemple, vous chargez un objet blob dans le conteneur que vous avez créé à la dernière étape à l’aide de la commande az storage blob upload . Il n’est pas nécessaire de spécifier un chemin d’accès de fichier depuis la création du fichier dans le répertoire racine. N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Cette opération crée l’objet blob s’il n’existe pas déjà, et le remplace s’il existe. Chargez autant de fichiers que vous le souhaitez avant de continuer.
Lorsque vous chargez un objet blob à l’aide d’Azure CLI, il émet des appels d’API REST respectifs via des protocoles http et https.
Pour charger plusieurs fichiers en même temps, vous pouvez utiliser la commande az storage blob upload-batch .
Créer la liste des objets blob d’un conteneur
Répertoriez les objets blob dans le conteneur avec la commande az storage blob list . N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Télécharger un blob
Utilisez la commande az storage blob download pour télécharger l’objet blob que vous avez téléchargé précédemment. N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
Transfert de données avec AzCopy
L’utilitaire en ligne de commande AzCopy offre un transfert de données hautes performances et scriptable pour stockage Azure. Vous pouvez utiliser AzCopy pour transférer des données vers et depuis le stockage Blob et Azure Files. Pour plus d’informations sur AzCopy v10, la dernière version d’AzCopy, consultez Prise en main d’AzCopy. Pour en savoir plus sur l’utilisation d’AzCopy v10 avec stockage d’objets blob, consultez Transférer des données avec AzCopy et le stockage d’objets blob.
L’exemple suivant utilise AzCopy pour charger un fichier local dans un objet blob. N’oubliez pas de remplacer les exemples de valeurs par vos propres valeurs :
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Nettoyer les ressources
Si vous souhaitez supprimer les ressources que vous avez créées dans le cadre de ce guide de démarrage rapide, y compris le compte de stockage, supprimez le groupe de ressources à l’aide de la commande az group delete . N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :
az group delete \
--name <resource-group> \
--no-wait
Étapes suivantes
Dans ce guide de démarrage rapide, vous avez appris à transférer des fichiers entre un système de fichiers local et un conteneur dans le stockage Blob Azure. Pour en savoir plus sur l’utilisation du stockage Blob à l’aide d’Azure CLI, sélectionnez une option ci-dessous.