Démarrage rapide : Créer, télécharger et lister des objets blob avec Azure CLIQuickstart: Create, download, and list blobs with Azure CLI

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.The Azure CLI is Azure's command-line experience for managing Azure resources. Vous pouvez l’utiliser dans votre navigateur avec Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. Vous pouvez également l’installer sur Windows, Linux ou MacOS, et l’exécuter à partir de la ligne de commande.You can also install it on macOS, Linux, or Windows and run it from the command line. Dans ce guide de démarrage rapide, vous apprenez à utiliser Azure CLI pour charger et télécharger des données vers et à partir du stockage Blob Azure.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Notes

Les fonctionnalités décrites dans cet article sont désormais disponibles pour les comptes dotés d'un espace de noms hiérarchique.The features described in this article are now available to accounts that have a hierarchical namespace. Pour savoir quelles sont les limitations, consultez l’article Fonctionnalités de stockage blob disponibles dans Azure Data Lake Storage Gen2.To review limitations, see the Blob storage features available in Azure Data Lake Storage Gen2 article.

PrérequisPrerequisites

Pour accéder à Stockage Azure, vous avez besoin d’un abonnement Azure.To access Azure Storage, you'll need an Azure subscription. Si vous n’avez pas d’abonnement, vous pouvez créer un compte gratuit avant de commencer.If you don't already have a subscription, create a free account before you begin.

Tous les accès à Stockage Azure se font via un compte de stockage.All access to Azure Storage takes place through a storage account. 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.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Pour obtenir de l’aide sur la création d’un compte de stockage, consultez Créer un compte de stockage.For help creating a storage account, see Create a storage account.

Préparation de votre environnement pour Azure CLIPrepare your environment for the Azure CLI

  • Utilisez l’environnement Bash dans Azure Cloud Shell.Use the Bash environment in Azure Cloud Shell.

    Lancer Cloud Shell dans une nouvelle fenêtreLaunch Cloud Shell in a new window

  • Si vous préférez, installez l’interface Azure CLI pour exécuter les commandes de référence de l’interface de ligne de commande.If you prefer, install the Azure CLI to run CLI reference commands.

    • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login.If you're using a local installation, sign in to the Azure CLI by using the az login command. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal.To finish the authentication process, follow the steps displayed in your terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.For additional sign-in options, see Sign in with the Azure CLI.

    • Lorsque vous y êtes invité, installez les extensions Azure CLI lors de la première utilisation.When you're prompted, install Azure CLI extensions on first use. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.For more information about extensions, see Use extensions with the Azure CLI.

    • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées.Run az version to find the version and dependent libraries that are installed. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.To upgrade to the latest version, run az upgrade.

  • Cet article nécessite la version 2.0.46 ou ultérieure de l’interface Azure CLI.This article requires version 2.0.46 or later of the Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.If using Azure Cloud Shell, the latest version is already installed.

Autoriser l’accès au stockage BlobAuthorize access to Blob storage

Vous pouvez autoriser l’accès au stockage Blob à partir d’Azure CLI avec des informations d’identification Azure AD ou en utilisant la clé d’accès au compte de stockage.You can authorize access to Blob storage from the Azure CLI either with Azure AD credentials or by using the storage account access key. Il est recommandé d’utiliser des informations d’identification Azure AD.Using Azure AD credentials is recommended. Cet article explique comment autoriser les opérations de stockage Blob en utilisant Azure AD.This article shows how to authorize Blob storage operations using Azure AD.

Les commandes Azure CLI pour les opérations de données sur le stockage Blob prennent en charge le paramètre --auth-mode, qui vous permet de spécifier la façon dont une opération donnée est autorisée.Azure CLI commands for data operations against Blob storage support the --auth-mode parameter, which enables you to specify how to authorize a given operation. Définissez le paramètre --auth-mode sur login pour autoriser les informations d’identification Azure AD.Set the --auth-mode parameter to login to authorize with Azure AD credentials. Pour plus d’informations, consultez Autoriser l’accès aux données d’objet blob et de file d’attente avec Azure CLI.For more information, see Authorize access to blob or queue data with Azure CLI.

Seules les opérations sur les données de stockage Blob prennent en charge le paramètre --auth-mode.Only Blob storage data operations support the --auth-mode parameter. Les opérations de gestion, comme la création d’un groupe de ressources ou d’un compte de stockage, utilisent automatiquement des informations d’identification Azure AD pour l’autorisation.Management operations, such as creating a resource group or storage account, automatically use Azure AD credentials for authorization.

Créer un groupe de ressourcesCreate a resource group

Créez un groupe de ressources Azure avec la commande az group create.Create an Azure resource group with the az group create command. Un groupe de ressources est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.A resource group is a logical container into which Azure resources are deployed and managed.

N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az group create \
    --name <resource-group> \
    --location <location>

Créez un compte de stockage.Create a storage account

Créez un compte de stockage à usage général avec la commande az storage account create.Create a general-purpose storage account with the az storage account create command. Le compte de stockage à usage général peut être utilisé pour les quatre services : objets blob, fichiers, tables et files d’attente.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az storage account create \
    --name <storage-account> \
    --resource-group <resource-group> \
    --location <location> \
    --sku Standard_ZRS \
    --encryption-services blob

Créez un conteneur.Create a container

Les objets blob sont toujours chargés dans un conteneur.Blobs are always uploaded into a container. Vous pouvez organiser des groupes d’objets blob dans des conteneurs de la même façon que vous organisez vos fichiers dans les dossiers de l’ordinateur.You can organize groups of blobs in containers similar to the way you organize your files on your computer in folders. Créez un conteneur pour stocker des objets blob avec la commande az storage container create.Create a container for storing blobs with the az storage container create command.

L’exemple suivant utilise votre compte Azure AD pour autoriser l’opération à créer le conteneur.The following example uses your Azure AD account to authorize the operation to create the container. Avant de créer le conteneur, attribuez-vous le rôle Contributeur aux données Blob du stockage.Before you create the container, assign the Storage Blob Data Contributor role to yourself. 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.Even if you are the account owner, you need explicit permissions to perform data operations against the storage account. Pour plus d’informations sur l’attribution de rôles Azure, consultez Utiliser Azure CLI pour attribuer un rôle Azure pour l’accès.For more information about assigning Azure roles, see Use Azure CLI to assign an Azure role for access.

N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az ad signed-in-user show --query objectId -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

La propagation des attributions de rôles Azure peut prendre plusieurs minutes.Azure role assignments may take a few minutes to propagate.

Vous pouvez également utiliser la clé de compte de stockage pour autoriser l’opération de création du conteneur.You can also use the storage account key to authorize the operation to create the container. Pour plus d’informations sur l’autorisation d’opérations de données avec Azure CLI, consultez Autoriser l’accès aux données d’objet blob et de file d’attente avec Azure CLI.For more information about authorizing data operations with Azure CLI, see Authorize access to blob or queue data with Azure CLI.

Charger un objet blobUpload a blob

Stockage Blob prend en charge les objets blob de blocs, d’ajout et de pages.Blob storage supports block blobs, append blobs, and page blobs. Les exemples de ce guide de démarrage rapide montrent comment utiliser des objets blob de blocs.The examples in this quickstart show how to work with block blobs.

Commencez par créer un fichier à charger dans un objet blob de blocs.First, create a file to upload to a block blob. Si vous utilisez Azure Cloud Shell, utilisez la commande suivante pour créer un fichier :If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

Lorsque le fichier s’ouvre, appuyez sur Insérer.When the file opens, press insert. Entrez Hello world, puis appuyez sur Échap. Entrez ensuite :x, puis appuyez sur Entrée.Type Hello world, then press Esc. Next, type :x, then press Enter.

Dans cet exemple, vous chargez un objet blob dans le conteneur que vous avez créé à la dernière étape avec la commande az storage blob upload.In this example, you upload a blob to the container you created in the last step using the az storage blob upload command. Il n’est pas nécessaire de spécifier le chemin du fichier, car celui-ci a été créé dans le répertoire racine.It's not necessary to specify a file path since the file was created at the root directory. N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name helloworld \
    --file helloworld \
    --auth-mode login

Cette opération crée l’objet blob s’il n’existe pas déjà, et le remplace s’il existe.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Chargez autant de fichiers que vous le souhaitez avant de continuer.Upload as many files as you like before continuing.

Pour charger plusieurs fichiers à la fois, vous pouvez utiliser la commande az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Créer la liste des objets blob d’un conteneurList the blobs in a container

Listez les objets blob d’un conteneur avec la commande az storage blob list.List the blobs in the container with the az storage blob list command. N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az storage blob list \
    --account-name <storage-account> \
    --container-name <container> \
    --output table \
    --auth-mode login

Télécharger un objet blobDownload a blob

Utilisez la commande az storage blob download pour télécharger l’objet blob chargé au préalable.Use the az storage blob download command to download the blob you uploaded earlier. N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az storage blob download \
    --account-name <storage-account> \
    --container-name <container> \
    --name helloworld \
    --file ~/destination/path/for/file \
    --auth-mode login

Transfert de données avec AzCopyData transfer with AzCopy

L’utilitaire en ligne de commande AzCopy assure un transfert de données hautement performant et scriptable pour Stockage Azure.The AzCopy command-line utility offers high-performance, scriptable data transfer for Azure Storage. Vous pouvez utiliser AzCopy pour transférer des données depuis et vers le stockage Blob et Azure Files.You can use AzCopy to transfer data to and from Blob storage and Azure Files. Pour plus d’informations sur AzCopy v10, la dernière version d’AzCopy, consultez Bien démarrer avec AzCopy.For more information about AzCopy v10, the latest version of AzCopy, see Get started with AzCopy. Pour plus d’informations sur l’utilisation d’AzCopy v10 avec le stockage Blob, consultez Transférer des données avec AzCopy et le stockage Blob.To learn about using AzCopy v10 with Blob storage, see Transfer data with AzCopy and Blob storage.

L’exemple suivant utilise AzCopy pour charger un fichier local dans un objet blob.The following example uses AzCopy to upload a local file to a blob. Pensez à remplacer les valeurs de l’exemple par vos propres valeurs :Remember to replace the sample values with your own values:

azcopy login
azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

Nettoyer les ressourcesClean up resources

Si vous voulez supprimer les ressources que vous avez créées dans le cadre de ce guide de démarrage rapide, notamment le compte de stockage, supprimez le groupe de ressources à l’aide de la commande az group delete.If you want to delete the resources you created as part of this quickstart, including the storage account, delete the resource group by using the az group delete command. N’oubliez pas de remplacer les valeurs d’espace réservé entre crochets par vos propres valeurs :Remember to replace placeholder values in angle brackets with your own values:

az group delete \
    --name <resource-group> \
    --no-wait

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez appris à transférer des fichiers entre un système de fichiers local et un conteneur du stockage Blob Azure.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Pour en savoir plus sur l’utilisation du Stockage Blob à l’aide d’Azure CLI, explorez les exemples Azure CLI afin de découvrir le Stockage Blob.To learn more about working with Blob storage by using Azure CLI, explore Azure CLI samples for Blob storage.