Inicio rápido: Creación, descarga y enumeración de blobs con la CLI de Azure

La CLI de Azure es la forma de usar la línea de comandos de Azure para administrar los recursos de Azure. Puede utilizarlo en el explorador con Azure Cloud Shell. También puede instalarla en macOS, Linux o Windows y ejecutarla desde la línea de comandos. En este inicio rápido, aprenderá a usar la CLI de Azure para cargar y descargar datos hacia y desde Azure Blob Storage.

Prerrequisitos

Para acceder a Azure Storage, necesitará una suscripción de Azure. Si todavía no tiene una suscripción, cree una cuenta gratuita antes de empezar.

Todo el acceso a Azure Storage tiene lugar mediante una cuenta de almacenamiento. En este inicio rápido, cree una cuenta de almacenamiento con Azure Portal, Azure PowerShell o la CLI de Azure. Si necesita ayuda para crear una cuenta de almacenamiento, consulte Creación de una cuenta de almacenamiento.

Preparación del entorno para la CLI de Azure

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.

  

• Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.

  • Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.

  • Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

• En este artículo se requiere la versión 2.0.46 o posterior de la CLI de Azure. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.

Autorización del acceso a Blob Storage

Puede autorizar el acceso a Blob Storage desde la CLI de Azure con credenciales de Microsoft Entra o mediante la clave de acceso de la cuenta de almacenamiento. Se recomienda usar las credenciales de Microsoft Entra. En este artículo se muestra cómo autorizar las operaciones de Blob Storage mediante el identificador de Microsoft Entra.

Los comandos de la CLI de Azure para las operaciones de datos en Blob Storage admiten el --auth-mode parámetro , lo que permite especificar cómo autorizar una operación determinada. Establezca el --auth-mode parámetro en login para autorizar con las credenciales de Microsoft Entra. 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.

Solo las operaciones de datos de Blob Storage admiten el --auth-mode parámetro . 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 Microsoft Entra para la autorización.

Para empezar, inicie sesión en su cuenta de Azure con el az login.

az login

Creación de un grupo de recursos

Cree un grupo de recursos de Azure con el comando az group create. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran los recursos de Azure.

No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

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

Crear una cuenta de almacenamiento

Cree una cuenta de almacenamiento de uso general con el comando az storage account create . La cuenta de almacenamiento de uso general se puede usar para los cuatro servicios: blobs, archivos, tablas y colas.

No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

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

Creación de un contenedor

Los blobs siempre se cargan en un contenedor. Puede organizar grupos de blobs en contenedores similares a la forma en que organiza los archivos en el equipo en carpetas. Cree un contenedor para almacenar blobs con el comando az storage container create.

En el ejemplo siguiente, se usa la cuenta de Microsoft Entra para autorizar la operación de creación del contenedor. Antes de crear el contenedor, asigne el rol Colaborador de datos de Storage Blob a sí mismo. Incluso si es el propietario de la cuenta, necesita permisos explícitos para realizar operaciones de datos en la cuenta de almacenamiento. Para más información sobre cómo asignar roles de Azure, consulte Asignación de un rol de Azure para el acceso a datos de blobs.

No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

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

Importante

Las asignaciones de roles de Azure pueden tardar unos minutos en propagarse.

También puede usar la clave de la cuenta de almacenamiento para autorizar la operación para crear el contenedor. Para más información sobre cómo autorizar operaciones de datos con la CLI de Azure, consulte Autorización del acceso a datos de blobs o colas con la CLI de Azure.

Carga de un blob

Blob Storage admite blobs en bloques, blobs en anexos y blobs en páginas. En los ejemplos de esta guía de inicio rápido se muestra cómo trabajar con blobs en bloques.

En primer lugar, cree un archivo para cargarlo en un blob en bloques. Si usa Azure Cloud Shell, use el siguiente comando para crear un archivo:

vi helloworld

Cuando se abra el archivo, presione Insertar. Escriba Hola mundo y presione Esc. A continuación, escriba :x y presione Entrar.

En este ejemplo, cargará un blob en el contenedor que creó en el último paso mediante el comando az storage blob upload . No es necesario especificar una ruta de acceso de archivo desde que se creó el archivo en el directorio raíz. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file myFile.txt \
    --auth-mode login

Esta operación crea el blob si aún no existe y lo sobrescribe si ya existe. Cargue tantos archivos como desee antes de continuar.

Al cargar un blob mediante la CLI de Azure, emite las respectivas llamadas a la API REST a través de protocolos http y https.

Para cargar varios archivos al mismo tiempo, puede usar el comando az storage blob upload-batch .

Enumerar los blobs de un contenedor

Enumere los blobs del contenedor con el comando az storage blob list . No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

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

Descargar un blob

Use el comando az storage blob download para descargar el blob que cargó anteriormente. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

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

Transferencia de datos con AzCopy

La utilidad de línea de comandos AzCopy ofrece transferencia de datos de alto rendimiento y scriptable para Azure Storage. Puede usar AzCopy para transferir datos hacia y desde Blob Storage y Azure Files. Para más información sobre AzCopy v10, la versión más reciente de AzCopy, consulte Introducción a AzCopy. Para más información sobre el uso de AzCopy v10 con Blob Storage, consulte Transferencia de datos con AzCopy y Blob Storage.

En el ejemplo siguiente se usa AzCopy para cargar un archivo local en un blob. Recuerde reemplazar los valores de ejemplo por sus propios valores:

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

Limpieza de recursos

Si desea eliminar los recursos que creó como parte de este inicio rápido, incluida la cuenta de almacenamiento, elimine el grupo de recursos mediante el comando az group delete . No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

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

Pasos siguientes

En este inicio rápido, ha aprendido a transferir archivos entre un sistema de archivos local y un contenedor en Azure Blob Storage. Para más información sobre cómo trabajar con Blob Storage mediante la CLI de Azure, seleccione una opción a continuación.

Administración de blobs en bloques con la CLI de Azure

Ejemplos de la CLI de Azure para Blob Storage