Inicio rápido: Creación, descarga y enumeración de blobs mediante la CLI de AzureQuickstart: Create, download, and list blobs with Azure CLI

La CLI de Azure es la forma de usar la línea de comandos de Azure para administrar los recursos de Azure.The Azure CLI is Azure's command-line experience for managing Azure resources. Puede utilizarlo en el explorador con Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. También puede instalarla en macOS, Linux o Windows y ejecutarla desde la línea de comandos.You can also install it on macOS, Linux, or Windows and run it from the command line. En esta guía de inicio rápido aprenderá a usar la CLI de Azure para cargar y descargar datos en Azure Blob Storage y desde este.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Nota

Las características que se describen en este artículo ya están disponibles para las cuentas que tienen un espacio de nombres jerárquico.The features described in this article are now available to accounts that have a hierarchical namespace. Para revisar las limitaciones, consulte el artículo Características de Blob Storage disponibles en Azure Data Lake Storage Gen2.To review limitations, see the Blob storage features available in Azure Data Lake Storage Gen2 article.

Requisitos previosPrerequisites

Para acceder a Azure Storage, necesitará una suscripción de Azure.To access Azure Storage, you'll need an Azure subscription. Si todavía no tiene una suscripción, cree una cuenta gratuita antes de empezar.If you don't already have a subscription, create a free account before you begin.

Todo el acceso a Azure Storage tiene lugar mediante una cuenta de almacenamiento.All access to Azure Storage takes place through a storage account. En este inicio rápido, cree una cuenta de almacenamiento con Azure Portal, Azure PowerShell o la CLI de Azure.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Si necesita ayuda para crear una cuenta de almacenamiento, consulte Creación de una cuenta de almacenamiento.For help creating a storage account, see Create a storage account.

Preparación del entorno para la CLI de AzurePrepare your environment for the Azure CLI

  • Use el entorno de Bash en Azure Cloud Shell.Use the Bash environment in Azure Cloud Shell.

    Iniciar Cloud Shell en una nueva ventanaLaunch Cloud Shell in a new window

  • Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.If you prefer, install the Azure CLI to run CLI reference commands.

    • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login.If you're using a local installation, sign in to the Azure CLI by using the az login command. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación.To finish the authentication process, follow the steps displayed in your terminal. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.For additional sign-in options, see Sign in with the Azure CLI.

    • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use.When you're prompted, install Azure CLI extensions on first use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.For more information about extensions, see Use extensions with the Azure CLI.

    • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas.Run az version to find the version and dependent libraries that are installed. Para realizar la actualización a la versión más reciente, ejecute az upgrade.To upgrade to the latest version, run az upgrade.

  • En este artículo se necesita la versión 2.0.46 de la CLI de Azure, o cualquier versión posterior.This article requires version 2.0.46 or later of the Azure CLI. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.If using Azure Cloud Shell, the latest version is already installed.

Autorización del acceso al almacenamiento de blobsAuthorize access to Blob storage

Puede autorizar el acceso al almacenamiento de blobs desde la CLI de Azure con las credenciales de Azure AD o con la clave de acceso de la cuenta de almacenamiento.You can authorize access to Blob storage from the Azure CLI either with Azure AD credentials or by using the storage account access key. Se recomienda usar las credenciales de Azure AD.Using Azure AD credentials is recommended. En este artículo se muestra cómo autorizar las operaciones de almacenamiento de blobs mediante Azure AD.This article shows how to authorize Blob storage operations using Azure AD.

Los comandos de la CLI de Azure para operaciones de datos en el almacenamiento de blobs admiten el parámetro --auth-mode, que permite especificar cómo se autoriza una operación determinada.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. Establezca el parámetro --auth-mode en login para autorizar con las credenciales de Azure AD.Set the --auth-mode parameter to login to authorize with Azure AD credentials. Para más información, consulte el artículo en el que se explica cómo autorizar el acceso a los datos de blobs o colas con la CLI de Azure.For more information, see Authorize access to blob or queue data with Azure CLI.

Solo las operaciones de datos de almacenamiento de blobs admiten el parámetro --auth-mode.Only Blob storage data operations support the --auth-mode parameter. Las operaciones de administración, como la creación de un grupo de recursos o una cuenta de almacenamiento, usan automáticamente las credenciales de Azure AD para la autorización.Management operations, such as creating a resource group or storage account, automatically use Azure AD credentials for authorization.

Crear un grupo de recursosCreate a resource group

Cree un grupo de recursos de Azure con el comando az group create.Create an Azure resource group with the az group create command. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran los recursos de Azure.A resource group is a logical container into which Azure resources are deployed and managed.

No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:Remember to replace placeholder values in angle brackets with your own values:

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

Crear una cuenta de almacenamientoCreate a storage account

Las cuentas de almacenamiento de uso general se crean con el comando az storage account create.Create a general-purpose storage account with the az storage account create command. Las cuentas de almacenamiento de uso general se pueden para los cuatro servicios: blobs, archivos, tablas y colas.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores: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

Crear un contenedorCreate a container

Los blobs siempre se cargan en un contenedor.Blobs are always uploaded into a container. Puede organizar los grupos de blobs en contenedores de una forma similar a la que organiza los archivos en carpetas en el equipo.You can organize groups of blobs in containers similar to the way you organize your files on your computer in folders. Cree un contenedor para almacenar blobs con el comando az storage container create.Create a container for storing blobs with the az storage container create command.

En el ejemplo siguiente se usa la cuenta de Azure AD para autorizar la operación de creación del contenedor.The following example uses your Azure AD account to authorize the operation to create the container. Antes de crear el contenedor, asígnese a sí mismo el rol Colaborador de datos de Storage Blob.Before you create the container, assign the Storage Blob Data Contributor role to yourself. Aunque sea el propietario de la cuenta, necesita permisos explícitos para realizar operaciones de datos en la cuenta de almacenamiento.Even if you are the account owner, you need explicit permissions to perform data operations against the storage account. Para más información sobre la asignación de roles de Azure, consulte Uso de la CLI de Azure para asignar un rol de Azure para el acceso.For more information about assigning Azure roles, see Use Azure CLI to assign an Azure role for access.

No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores: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

Importante

La propagación de las asignaciones de roles de Azure pueden tardar unos minutos.Azure role assignments may take a few minutes to propagate.

También puede usar la clave de la cuenta de almacenamiento para autorizar a la operación de creación del contenedor.You can also use the storage account key to authorize the operation to create the container. Para obtener más información sobre la autorización de operaciones de datos con la CLI de Azure, consulte Autorización del acceso a los datos de blobs o colas con la CLI de Azure.For more information about authorizing data operations with Azure CLI, see Authorize access to blob or queue data with Azure CLI.

Carga de un blobUpload a blob

Blob Storage admite blobs en bloques, blobs en anexos y blobs en páginas.Blob storage supports block blobs, append blobs, and page blobs. Los ejemplos en esta guía de inicio rápido muestran cómo trabajar con blobs en bloques.The examples in this quickstart show how to work with block blobs.

En primer lugar, cree un archivo para cargarlo en un blob en bloques.First, create a file to upload to a block blob. Si está utilizando Azure Cloud Shell, use el siguiente comando para crear un archivo:If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

Cuando se abra el archivo, presione Insertar.When the file opens, press insert. Escriba Hello World y, a continuación, presione Esc. Después, escriba :x y, a continuación, presione Entrar.Type Hello world, then press Esc. Next, type :x, then press Enter.

En este ejemplo, se carga un blob en el contenedor que se creó en el último paso con el comando 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. No es necesario especificar una ruta de acceso de archivo, ya que el archivo se creó en el directorio raíz.It's not necessary to specify a file path since the file was created at the root directory. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores: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

Esta operación crea el blob si todavía no existe y lo sobrescribe si ya existe.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Cargue tantos archivos como desee antes de continuar.Upload as many files as you like before continuing.

Para cargar varios archivos al mismo tiempo, puede usar el comando az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Enumerar los blobs de un contenedorList the blobs in a container

Enumere los blobs del contenedor con el comando az storage blob list.List the blobs in the container with the az storage blob list command. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores: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

Descarga de un blobDownload a blob

Use el comando az storage blob download para descargar el blob que cargó anteriormente.Use the az storage blob download command to download the blob you uploaded earlier. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores: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

Transferencia de datos con AzCopyData transfer with AzCopy

La utilidad de línea de comandos AzCopy ofrece transferencia de datos de alto rendimiento mediante scripts para Azure Storage.The AzCopy command-line utility offers high-performance, scriptable data transfer for Azure Storage. Puede utilizar AzCopy para transferir datos a y desde Blob Storage y Azure Files.You can use AzCopy to transfer data to and from Blob storage and Azure Files. Para más información sobre AzCopy v10, la versión más reciente de AzCopy, consulte Introducción a AzCopy.For more information about AzCopy v10, the latest version of AzCopy, see Get started with AzCopy. Para más información acerca del uso de AzCopy v10 con el almacenamiento de blobs, consulte Transferencia de datos con AzCopy y Blob Storage.To learn about using AzCopy v10 with Blob storage, see Transfer data with AzCopy and Blob storage.

En el ejemplo siguiente se usa AzCopy para cargar un archivo local en un blob.The following example uses AzCopy to upload a local file to a blob. No olvide reemplazar los valores de ejemplo por sus propios valores: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'

Limpieza de recursosClean up resources

Si desea eliminar los recursos que ha creado en este, lo que incluye la cuenta de almacenamiento, elimine el grupo de recursos mediante el comando 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. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:Remember to replace placeholder values in angle brackets with your own values:

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

Pasos siguientesNext steps

En esta guía de inicio rápido, aprendió a transferir archivos entre un sistema de archivos local y un contenedor en Azure Blob Storage.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Para más información sobre cómo trabajar con Blob Storage mediante la CLI de Azure, explore los ejemplos de la CLI de Azure para Blob Storage.To learn more about working with Blob storage by using Azure CLI, explore Azure CLI samples for Blob storage.