az storage blob

Referencia

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar el almacenamiento de objetos para datos no estructurados (blobs).

Especifique uno de los siguientes parámetros de autenticación para los comandos: --auth-mode, --account-key, --connection-string, --sas-token. También puede usar las variables de entorno correspondientes para almacenar las credenciales de autenticación, por ejemplo, AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING y AZURE_STORAGE_SAS_TOKEN.

Comandos

Nombre	Description	Tipo	Estado
az storage blob access	Administrar las propiedades de control de acceso de un blob cuando el espacio de nombres jerárquico está habilitado.	Extensión	En desuso
az storage blob access set	Establezca las propiedades de control de acceso de un blob.	Extensión	En desuso
az storage blob access show	Mostrar las propiedades del control de acceso de un blob.	Extensión	En desuso
az storage blob access update	Actualice las propiedades del control de acceso de un blob.	Extensión	En desuso
az storage blob copy	Administrar operaciones de copia de blobs. Use `az storage blob show` para comprobar el estado de los blobs.	Núcleo y extensión	GA
az storage blob copy cancel	Anule una operación de copia en curso.	Core	GA
az storage blob copy start	Copie un blob de forma asincrónica. Use `az storage blob show` para comprobar el estado de los blobs.	Core	GA
az storage blob copy start (storage-blob-preview extensión)	Inicie un trabajo de copia de blobs.	Extensión	GA
az storage blob copy start-batch	Copie varios blobs en un contenedor de blobs. Use `az storage blob show` para comprobar el estado de los blobs.	Core	GA
az storage blob delete	Marque un blob o una instantánea para su eliminación.	Core	GA
az storage blob delete (storage-blob-preview extensión)	Marque un blob o una instantánea para su eliminación.	Extensión	GA
az storage blob delete-batch	Elimine blobs de un contenedor de blobs de forma recursiva.	Core	GA
az storage blob directory	Administrar directorios de blobs en el contenedor de cuentas de almacenamiento.	Extensión	En desuso
az storage blob directory access	Administrar las propiedades de control de acceso de un directorio cuando el espacio de nombres jerárquico está habilitado.	Extensión	Versión preliminar y en desuso
az storage blob directory access set	Establezca las propiedades del control de acceso de un directorio.	Extensión	Versión preliminar y en desuso
az storage blob directory access show	Muestra las propiedades del control de acceso de un directorio.	Extensión	Versión preliminar y en desuso
az storage blob directory access update	Actualice las propiedades del control de acceso de un directorio.	Extensión	Versión preliminar y en desuso
az storage blob directory create	Cree un directorio de blobs de almacenamiento en un contenedor de almacenamiento.	Extensión	En desuso
az storage blob directory delete	Elimine un directorio de blobs de almacenamiento en un contenedor de almacenamiento.	Extensión	En desuso
az storage blob directory download	Descargue blobs en una ruta de acceso de archivo local.	Extensión	En desuso
az storage blob directory exists	Compruebe la existencia de un directorio de blobs en un contenedor de almacenamiento.	Extensión	En desuso
az storage blob directory list	Enumeración de blobs y subdirectorios de blobs en un directorio de almacenamiento.	Extensión	En desuso
az storage blob directory metadata	Administrar metadatos de directorio.	Extensión	En desuso
az storage blob directory metadata show	Mostrar todos los metadatos definidos por el usuario para el directorio de blobs especificado.	Extensión	En desuso
az storage blob directory metadata update	Establezca los metadatos definidos por el usuario para el directorio de blobs especificado como uno o varios pares de nombre-valor.	Extensión	En desuso
az storage blob directory move	Mueva un directorio de almacenamiento a otro directorio de blobs de almacenamiento en un contenedor de almacenamiento.	Extensión	En desuso
az storage blob directory show	Mostrar las propiedades de un directorio de blobs de almacenamiento en un contenedor de almacenamiento.	Extensión	En desuso
az storage blob directory upload	Cargue blobs o subdirectorios en un directorio de blobs de almacenamiento.	Extensión	En desuso
az storage blob download	Descargue un blob en una ruta de acceso de archivo.	Core	GA
az storage blob download-batch	Descargue blobs desde un contenedor de blobs de forma recursiva.	Core	GA
az storage blob exists	Compruebe la existencia de un blob en un contenedor.	Core	GA
az storage blob filter	Enumere los blobs en todos los contenedores cuyas etiquetas coincidan con una expresión de búsqueda determinada.	Extensión	Vista previa
az storage blob generate-sas	Genere una firma de acceso compartido para el blob.	Core	GA
az storage blob generate-sas (storage-blob-preview extensión)	Genere una firma de acceso compartido para el blob.	Extensión	GA
az storage blob immutability-policy	Administrar la directiva de inmutabilidad de blobs.	Core	GA
az storage blob immutability-policy delete	Elimine la directiva de inmutabilidad del blob.	Core	GA
az storage blob immutability-policy set	Establezca la directiva de inmutabilidad del blob.	Core	GA
az storage blob incremental-copy	Administrar operaciones de copia incremental de blobs.	Core	GA
az storage blob incremental-copy cancel	Anula una operación de copy_blob pendiente y deja un blob de destino con una longitud cero y metadatos completos.	Core	GA
az storage blob incremental-copy start	Copia una copia incremental de un blob de forma asincrónica.	Core	GA
az storage blob lease	Administrar concesiones de blobs de almacenamiento.	Core	GA
az storage blob lease acquire	Solicita una nueva concesión.	Core	GA
az storage blob lease break	Interrumpa la concesión, si el contenedor o blob tiene una concesión activa.	Core	GA
az storage blob lease change	Cambie el identificador de concesión de una concesión activa.	Core	GA
az storage blob lease release	Libere la concesión.	Core	GA
az storage blob lease renew	Renueve la concesión.	Core	GA
az storage blob list	Enumeración de blobs en un contenedor determinado.	Core	GA
az storage blob metadata	Administrar metadatos de blobs.	Core	GA
az storage blob metadata show	Devuelve todos los metadatos definidos por el usuario para el blob o la instantánea especificados.	Core	GA
az storage blob metadata update	Establece los metadatos definidos por el usuario para el blob como uno o varios pares de nombre-valor.	Core	GA
az storage blob move	Mover un blob en un contenedor de almacenamiento.	Extensión	Versión preliminar y en desuso
az storage blob query	Permitir a los usuarios seleccionar o proyectar datos de instantáneas de blobs o blobs proporcionando expresiones de consulta sencillas.	Core	Vista previa
az storage blob restore	Restaure los blobs en los intervalos de blobs especificados.	Core	GA
az storage blob rewrite	Cree un nuevo blob en bloques donde el contenido del blob se lea desde una dirección URL determinada.	Core	Vista previa
az storage blob service-properties	Administrar las propiedades del servicio Storage Blob.	Núcleo y extensión	GA
az storage blob service-properties delete-policy	Administrar las propiedades de la política de eliminación del servicio Storage Blob.	Core	GA
az storage blob service-properties delete-policy show	Mostrar la directiva de eliminación de blobs de almacenamiento.	Core	GA
az storage blob service-properties delete-policy update	Actualice la directiva de eliminación de blobs de almacenamiento.	Core	GA
az storage blob service-properties show	Obtiene las propiedades del servicio Blob de una cuenta de almacenamiento, incluido Azure Storage Analytics.	Core	GA
az storage blob service-properties update	Administra las propiedades del servicio Storage Blob.	Core	GA
az storage blob service-properties update (storage-blob-preview extensión)	Administra las propiedades del servicio Storage Blob.	Extensión	GA
az storage blob set-legal-hold	Establezca la suspensión legal del blob.	Core	GA
az storage blob set-tier	Establezca los niveles de bloque o página en el blob.	Core	GA
az storage blob set-tier (storage-blob-preview extensión)	Establezca los niveles de bloque o página en el blob.	Extensión	GA
az storage blob show	Obtenga los detalles de un blob.	Core	GA
az storage blob show (storage-blob-preview extensión)	Obtenga los detalles de un blob.	Extensión	GA
az storage blob snapshot	Crea una instantánea del blob.	Core	GA
az storage blob sync	Sincronizar blobs de forma recursiva con un contenedor de blobs de almacenamiento.	Core	Vista previa
az storage blob tag	Administrar etiquetas de blob.	Extensión	Vista previa
az storage blob tag list	Obtiene etiquetas en un blob o en una versión de blob específica o en una instantánea.	Extensión	Vista previa
az storage blob tag set	Establezca etiquetas en un blob o una versión específica del blob, pero no en la instantánea.	Extensión	Vista previa
az storage blob undelete	Restaure el blob o la instantánea eliminados temporalmente.	Core	GA
az storage blob update	Establece las propiedades del sistema en el blob.	Core	GA
az storage blob upload	Cargue un archivo en un blob de almacenamiento.	Core	GA
az storage blob upload-batch	Cargue archivos de un directorio local en un contenedor de blobs.	Core	GA
az storage blob url	Cree la dirección URL para acceder a un blob.	Core	GA

az storage blob delete

Editar

Marque un blob o una instantánea para su eliminación.

El blob se marca para su eliminación posterior durante la recolección de elementos no utilizados. Para eliminar un blob, todas sus instantáneas también deben eliminarse. Ambos se pueden quitar al mismo tiempo.

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]

Ejemplos

Eliminar un blob.

az storage blob delete -c mycontainer -n MyBlob

Elimine un blob mediante credenciales de inicio de sesión.

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

Valores aceptados: key, login

--blob-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Dirección URL completa del punto de conexión al blob, incluido el token de SAS y la instantánea si se usan. Esto podría ser el punto de conexión principal o el punto de conexión secundario en función del actual location_mode.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--delete-snapshots

Obligatorio si el blob tiene instantáneas asociadas. Los valores incluyen: "only": elimina solo las instantáneas de blobs. "include": elimina el blob junto con todas las instantáneas.

Valores aceptados: include, only

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a eliminar.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob delete (storage-blob-preview extensión)

Marque un blob o una instantánea para su eliminación.

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]

Ejemplos

Eliminar un blob.

az storage blob delete -c mycontainer -n MyBlob

Elimine un blob mediante credenciales de inicio de sesión.

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--delete-snapshots

Obligatorio si el blob tiene instantáneas asociadas. "only": elimina solo las instantáneas de blobs. "include": elimina el blob junto con todas las instantáneas.

Valores aceptados: include, only

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--version-id

Un identificador de versión de blob opcional. Este parámetro solo es para la cuenta habilitada para el control de versiones.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob delete-batch

Editar

Elimine blobs de un contenedor de blobs de forma recursiva.

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]

Ejemplos

Elimine todos los blobs que terminan con ".py" en un contenedor que no se haya modificado durante 10 días.

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

Elimine todos los blobs de un directorio denominado "dir" en un contenedor denominado "mycontainer".

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

Elimine los blobs con el formato "cli-2018-xx-xx.txt" o "cli-2019-xx-xx.txt" en un contenedor.

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

Elimine todos los blobs con el formato "cli-201x-xx-xx.txt", excepto cli-2018-xx-xx.txt" y "cli-2019-xx-xx.txt" en un contenedor.

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

Parámetros requeridos

--source -s

El contenedor de blobs desde donde se eliminarán los archivos.

El origen puede ser la dirección URL del contenedor o el nombre del contenedor. Cuando el origen es la dirección URL del contenedor, el nombre de la cuenta de almacenamiento se analizará desde la dirección URL.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--delete-snapshots

Obligatorio si el blob tiene instantáneas asociadas.

Valores aceptados: include, only

--dryrun

Mostrar el resumen de las operaciones que se van a realizar en lugar de eliminar realmente los archivos.

Si se especifica esto, omitirá todos los argumentos de condición previa que incluyen --if-modified-since y --if-unmodified-since. Por lo tanto, los archivos se eliminarán con el comando sin --dryrun puede ser diferente de la lista de resultados con la marca --dryrun activada.

Valor predeterminado: False

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (*).

Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín (*) para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Identificador de concesión activo para el blob.

--pattern

Patrón usado para archivos o blobs en el origen. Los patrones admitidos son '*', '?', '[seq]' y '[!seq]'. Para obtener más información, consulte https://docs.python.org/3.7/library/fnmatch.html.

Al usar '*' en --pattern, coincidirá con cualquier carácter, incluido el separador de directorios '/'. También puede probar el comando "az storage remove" con --include y --exclude con la cli >de Azure = 2.0.70 para que coincida con varios patrones.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob download

Editar

Descargue un blob en una ruta de acceso de archivo.

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]

Ejemplos

Descargue un blob.

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

Descargue un contenido de blob en stdout(pipe support).

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--end-range

Fin del intervalo de bytes que se va a usar para descargar una sección del blob. Si se proporciona end_range, se debe proporcionar start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes de blob.

--file -f

Ruta de acceso del archivo en la que se va a escribir. Si no se especifica, se usará stdout y max_connections se establecerá en 1.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--max-connections

Número de conexiones paralelas con las que se va a descargar.

Valor predeterminado: 2

--name -n

Nombre del blob.

--no-progress

Incluya esta marca para deshabilitar los informes de progreso del comando.

Valor predeterminado: False

--open-mode

Modo que se va a usar al abrir el archivo. Tenga en cuenta que especificar append only open_mode impide la descarga en paralelo. Por lo tanto, max_connections debe establecerse en 1 si se usa este open_mode.

Valor predeterminado: wb

--overwrite

Sobrescriba un archivo existente cuando se especifica. El valor predeterminado es true.

Valores aceptados: false, true

Valor predeterminado: True

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.

--start-range

Inicio del intervalo de bytes que se va a usar para descargar una sección del blob. Si no se da ningún end_range, se descargarán todos los bytes después del start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes de blob.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--validate-content

Si es true, calcula un hash MD5 para cada fragmento del blob. El servicio de almacenamiento comprueba el hash del contenido que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si usa http en lugar de https, como https (valor predeterminado), ya se validará. Tenga en cuenta que este hash MD5 no se almacena con el blob. Tenga en cuenta también que, si está habilitado, el algoritmo eficaz para memoria no se usará porque calcular el hash MD5 requiere almacenar en búfer bloques completos y, al hacerlo, se anula el propósito del algoritmo eficiente en memoria.

Valor predeterminado: False

--version-id

Un identificador de versión de blob opcional. Este parámetro solo es para la cuenta habilitada para el control de versiones.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob download-batch

Editar

Descargue blobs desde un contenedor de blobs de forma recursiva.

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]

Ejemplos

Descarga de todos los blobs que terminan con .py

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

Descargue todos los blobs en un directorio denominado "dir" del contenedor denominado "mycontainer".

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

Descargue todos los blobs con el formato "cli-2018-xx-xx.txt" o "cli-2019-xx-xx.txt" en el contenedor a la ruta de acceso actual.

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

Descargue todos los blobs con el formato "cli-201x-xx-xx.txt", excepto cli-2018-xx-xx.txt" y "cli-2019-xx-xx.txt" en el contenedor a la ruta de acceso actual.

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

Parámetros requeridos

--destination -d

Carpeta de destino existente para esta operación de descarga.

--source -s

El contenedor de blobs desde donde se descargarán los archivos.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--dryrun

Muestra el resumen de las operaciones que se van a realizar en lugar de descargar realmente los archivos.

Valor predeterminado: False

--max-connections

Número de conexiones paralelas con las que se va a descargar.

Valor predeterminado: 2

--no-progress

Incluya esta marca para deshabilitar los informes de progreso del comando.

Valor predeterminado: False

--overwrite

Sobrescriba un archivo existente cuando se especifica. El valor predeterminado es Falso.

Valores aceptados: false, true

Valor predeterminado: False

--pattern

Patrón usado para archivos o blobs en el origen. Los patrones admitidos son '*', '?', '[seq]' y '[!seq]'. Para obtener más información, consulte https://docs.python.org/3.7/library/fnmatch.html.

Al usar '*' en --pattern, coincidirá con cualquier carácter, incluido el separador de directorios '/'.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob exists

Editar

Compruebe la existencia de un blob en un contenedor.

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]

Ejemplos

Compruebe la existencia de un blob en un contenedor. (generado automáticamente)

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob filter

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere los blobs en todos los contenedores cuyas etiquetas coincidan con una expresión de búsqueda determinada.

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

Parámetros requeridos

--tag-filter

Expresión para buscar blobs cuyas etiquetas coincidan con la condición especificada. P. ej. ""yourtagname"='firsttag' y "yourtagname2"='secondtag'".

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Se usa cuando desea enumerar blobs en un contenedor especificado.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob generate-sas

Editar

Genere una firma de acceso compartido para el 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]

Ejemplos

Genere un token sas para un blob con permisos de solo lectura.

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

Genere un token sas para un blob con el intervalo ip especificado.

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

Genere una firma de acceso compartido para el blob. (generado automáticamente)

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--as-user

Indica que este comando devuelve la SAS firmada con la clave de delegación de usuarios. El parámetro de expiración y el inicio de sesión "--auth-mode" son necesarios si se especifica este argumento.

Valor predeterminado: False

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--cache-control

Valor de encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--content-disposition

Valor de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.

--content-encoding

Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.

--content-language

Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.

--content-type

Valor de encabezado de respuesta para Content-Type cuando se accede a un recurso mediante esta firma de acceso compartido.

--encryption-scope

Ámbito de cifrado predefinido que se usa para cifrar los datos en el servicio.

--expiry

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS deja de ser válida. No use si se hace referencia a una directiva de acceso almacenada con --policy-name que especifica este valor.

--full-uri

Indica que este comando devuelve el URI de blob completo y el token de firma de acceso compartido.

Valor predeterminado: False

--https-only

Solo permite solicitudes realizadas con el protocolo HTTPS. Si se omite, se permiten las solicitudes del protocolo HTTP y HTTPS.

--ip

Especifica la dirección IP o el intervalo de direcciones IP desde las que se van a aceptar solicitudes. Solo admite direcciones de estilo IPv4.

--name -n

Nombre del blob.

--permissions

Permisos que concede la SAS. Valores permitidos: (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. No use si se hace referencia a una directiva de acceso almacenada con --id que especifica este valor. Se puede combinar.

--policy-name

Nombre de una directiva de acceso almacenada dentro de la ACL del contenedor.

--snapshot

Un identificador de instantánea de blob opcional. Valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a conceder permiso.

--start

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS se vuelve válida. No use si se hace referencia a una directiva de acceso almacenada con --policy-name que especifica este valor. El valor predeterminado es la hora de la solicitud.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob generate-sas (storage-blob-preview extensión)

Genere una firma de acceso compartido para el 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]

Ejemplos

Genere un token sas para un blob con permisos de solo lectura.

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

Genere un token sas para un blob con el intervalo ip especificado.

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

Genere una firma de acceso compartido para el blob. (generado automáticamente)

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

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--as-user

Valor predeterminado: False

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--cache-control

Valor de encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--content-disposition

Valor de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.

--content-encoding

Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.

--content-language

Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.

--content-type

Valor de encabezado de respuesta para Content-Type cuando se accede al recurso mediante esta firma de acceso compartido.

--expiry

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS deja de ser válida. No use si se hace referencia a una directiva de acceso almacenada con --id que especifica este valor.

--full-uri

Indique que este comando devuelve el URI de blob completo y el token de firma de acceso compartido.

Valor predeterminado: False

--https-only

Solo permite solicitudes realizadas con el protocolo HTTPS. Si se omite, se permiten las solicitudes del protocolo HTTP y HTTPS.

--ip

Especifique una dirección IP o un intervalo de direcciones IP desde las que aceptar solicitudes. Si la dirección IP desde la que se origina la solicitud no coincide con la dirección IP o el intervalo de direcciones especificado en el token de SAS, la solicitud no se autentica. Por ejemplo, especificar ip=168.1.5.65 o ip=168.1.5.60-168.1.5.70 en la SAS restringe la solicitud a esas direcciones IP.

--permissions

Permisos que concede la SAS. Valores permitidos: (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. No use si se hace referencia a una directiva de acceso almacenada con --policy-name que especifica este valor. Se puede combinar.

--policy-name

Nombre de una directiva de acceso almacenada dentro de la ACL del contenedor.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.

--start

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS se vuelve válida. No use si se hace referencia a una directiva de acceso almacenada con --id que especifica este valor. El valor predeterminado es la hora de la solicitud.

--version-id

Vista previa

Un identificador de versión de blob opcional. Este parámetro solo es para la cuenta habilitada para el control de versiones.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob list

Editar

Enumeración de blobs en un contenedor determinado.

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]

Ejemplos

Enumere todos los blobs de almacenamiento de un contenedor cuyos nombres comiencen por "foo"; coincidirá con nombres como "foo", "foobar" y "foo/bar".

az storage blob list -c mycontainer --prefix foo

Parámetros requeridos

--container-name -c

El nombre del contenedor.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--delimiter

Cuando la solicitud incluye este parámetro, la operación devuelve un elemento BlobPrefix en la lista de resultados que actúa como marcador de posición para todos los blobs cuyos nombres comienzan con la misma subcadena hasta la apariencia del carácter delimitador. El delimitador puede ser un solo carácter o una cadena.

--include

Especifique uno o varios conjuntos de datos adicionales que se van a incluir en la respuesta. Las opciones incluyen: (c)opy, (d)eleted, (m)etadata, (s)napshots, (v)ersions, (t)ags, (i)mmutabilitypolicy, (l)egalhold, (d)eletedwithversions. Se puede combinar.

--marker

Valor de cadena que identifica la parte de la lista de contenedores que se va a devolver con la siguiente operación de lista. La operación devuelve el valor NextMarker dentro del cuerpo de la respuesta si la operación de lista no devolvió todos los contenedores restantes para que se muestren con la página actual. Si se especifica, este generador comenzará a devolver resultados desde el punto en el que se detuvo el generador anterior.

--num-results

Especifique el número máximo que se va a devolver. Si la solicitud no especifica num_results o especifica un valor mayor que 5000, el servidor devolverá hasta 5000 elementos. Tenga en cuenta que si la operación de lista cruza un límite de partición, el servicio devolverá un token de continuación para recuperar el resto de los resultados. Proporcione "*" para devolver todo.

Valor predeterminado: 5000

--prefix

Filtre los resultados para devolver solo blobs cuyo nombre comienza con el prefijo especificado.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

Muestra nextMarker en el resultado cuando se especifica.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob move

Vista previa Obsoleto

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Este comando está en desuso y se quitará en futuras versiones. En su lugar, use "az storage fs file move". Para más información, vaya a https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

Mover un blob en un contenedor de almacenamiento.

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]

Ejemplos

Mover un blob en un contenedor de almacenamiento.

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

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--destination-blob -d

Nombre del blob de destino. Debe ser una ruta de acceso absoluta en el contenedor. Por ejemplo, 'topdir1/dirbar'.

--source-blob -s

Nombre del blob de origen. Debe ser una ruta de acceso absoluta en el contenedor. Por ejemplo, 'topdir1/dirsubfoo'.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

Opcional. Identificador de concesión del new_path. El new_path debe tener una concesión activa y el identificador de concesión debe coincidir.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--source-if-match

Opcional. Valor ETag. Especifique este encabezado para realizar la operación de cambio de nombre solo si la ETag del origen coincide con el valor especificado.

--source-if-modified-since

Opcional. Un valor de fecha y hora. Especifique este encabezado para realizar la operación de cambio de nombre solo si el origen se ha modificado desde la fecha y hora especificadas.

--source-if-none-match

Opcional. Valor ETag o el carácter comodín especial ("*"). Especifique este encabezado para realizar la operación de cambio de nombre solo si la ETag del origen no coincide con el valor especificado.

--source-if-unmodified-since

Opcional. Un valor de fecha y hora. Especifique este encabezado para realizar la operación de cambio de nombre solo si el origen no se ha modificado desde la fecha y hora especificadas.

--source-lease-id

Opcional. Identificador de concesión del source_path. El source_path debe tener una concesión activa y el identificador de concesión debe coincidir.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob query

Editar

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Permitir a los usuarios seleccionar o proyectar datos de instantáneas de blobs o blobs proporcionando expresiones de consulta sencillas.

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]

Ejemplos

Habilite a los usuarios seleccionar o proyectar en blob proporcionando expresiones de consulta sencillas.

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

Habilite a los usuarios seleccionar o proyectar en blob proporcionando expresiones de consulta simples y guardar en el archivo de destino.

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

Parámetros requeridos

--query-expression

Expresión de consulta en SQL. El tamaño máximo de la expresión de consulta es 256KiB. Para obtener más información sobre la sintaxis de la expresión, consulte https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--in-column-separator

Cadena que se usa para separar columnas.

Valor predeterminado: ,

--in-escape-char

Cadena usada como carácter de escape. El valor predeterminado es vacío.

--in-has-header

Si los datos del blob incluyen encabezados en la primera línea. El valor predeterminado es False, lo que significa que los datos se devolverán incluidos en la primera línea. Si se establece en True, los datos se devolverán exclusivos de la primera línea.

Valor predeterminado: False

--in-line-separator

Cadena que se usa para separar los registros.

Valor predeterminado:

--in-quote-char

Cadena que se usa para citar un campo específico.

Valor predeterminado: "

--in-record-separator

Cadena que se usa para separar los registros.

Valor predeterminado:

--input-format

Tipo de serialización de los datos almacenados actualmente en el blob. El valor predeterminado es tratar los datos del blob como datos CSV con formato en el dialecto predeterminado. Los datos del blob se volverán a formatear según ese perfil cuando se especifique el formato de blob. Si elige json, especifique Output Json Text Configuration Arguments en consecuencia; Si elige csv, especifique Output Delimited Text Configuration Arguments.

Valores aceptados: csv, json

--lease-id

Obligatorio si el blob tiene una concesión activa.

--name -n

Nombre del blob.

--out-column-separator

Cadena que se usa para separar columnas.

Valor predeterminado: ,

--out-escape-char

Cadena usada como carácter de escape. El valor predeterminado es vacío.

--out-has-header

Valor predeterminado: False

--out-line-separator

Cadena que se usa para separar los registros.

Valor predeterminado:

--out-quote-char

Cadena que se usa para citar un campo específico.

Valor predeterminado: "

--out-record-separator

Cadena que se usa para separar los registros.

Valor predeterminado:

--output-format

Tipo de serialización de salida para el flujo de datos. De forma predeterminada, los datos se devolverán tal y como se representa en el blob. Al proporcionar un formato de salida, los datos del blob se volverán a formatear según ese perfil. Si elige json, especifique Output Json Text Configuration Arguments en consecuencia; Si elige csv, especifique Output Delimited Text Configuration Arguments.

Valores aceptados: csv, json

--result-file

Especifique la ruta de acceso del archivo para guardar el resultado.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob restore

Editar

Restaure los blobs en los intervalos de blobs especificados.

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

Ejemplos

Restaure blobs en dos intervalos de blobs especificados. Por ejemplo, (container1/blob1, container2/blob2) y (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

Restaure blobs en los intervalos de blobs especificados desde el inicio de la cuenta hasta el final de la cuenta.

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

Restaure blobs en el intervalo de blobs especificado.

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

Restaure blobs en el intervalo de blobs especificado sin esperar y consulte el estado de restauración de blobs con "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

Parámetros requeridos

--account-name -n

El nombre de la cuenta de almacenamiento.

--time-to-restore -t

Restaure el blob a la hora especificada, que debe ser utc datetime en (Y-m-d'T'H:M:S'Z').

Parámetros opcionales

--blob-range -r

Intervalos de blobs que se van a restaurar. Debe especificar dos valores para especificar start_range y end_range para cada intervalo de blobs, por ejemplo, -r blob1 blob2. Nota: Vacío significa que la cuenta se inicia como valor de intervalo de inicio y significa fin de cuenta para el intervalo final.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob rewrite

Editar

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un nuevo blob en bloques donde el contenido del blob se lea desde una dirección URL determinada.

El contenido de un blob existente se sobrescribe con el nuevo 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]

Ejemplos

Actualice el ámbito de cifrado del blob existente.

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

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

--source-uri -u

Dirección URL de hasta 2 KB de longitud que especifica un archivo o un blob. El valor debe estar codificado con dirección URL, ya que aparecería en un URI de solicitud. Si el origen está en otra cuenta, el origen debe ser público o debe autenticarse a través de una firma de acceso compartido. Si el origen es público, no se requiere autenticación.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--encryption-scope

Ámbito de cifrado predefinido que se usa para cifrar los datos en el servicio. Se puede crear un ámbito de cifrado mediante la API de administración y hacer referencia aquí por su nombre. Si se ha definido un ámbito de cifrado predeterminado en el contenedor, este valor lo invalidará si el ámbito de nivel de contenedor está configurado para permitir invalidaciones. De lo contrario, se generará un error.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa. El valor puede ser un objeto BlobLeaseClient o el identificador de concesión como una cadena.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--tier

Valor de nivel de blob estándar en el que establecer el blob. Para esta versión de la biblioteca, solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.

Valores aceptados: Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob set-legal-hold

Editar

Establezca la suspensión legal del 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]

Ejemplos

Configure la suspensión legal del blob.

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

Borre la suspensión legal del blob.

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

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--legal-hold

Se especifica si se debe establecer una suspensión legal en el blob.

Valores aceptados: false, true

--name -n

Nombre del blob.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob set-tier

Editar

Establezca los niveles de bloque o página en el blob.

En el caso del blob en bloques, este comando solo admite blob en bloques en cuentas de almacenamiento estándar. En el caso del blob en páginas, este comando solo admite blobs en páginas en cuentas 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}]

Ejemplos

Establezca los niveles de bloque o página en el blob. (generado automáticamente)

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

Parámetros requeridos

--tier

Valor de nivel en el que se va a establecer el blob.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

--rehydrate-priority -r

Vista previa

Indique la prioridad con la que rehidratar un blob archivado. La prioridad se puede establecer en un blob solo una vez, el valor predeterminado es Estándar.

Valores aceptados: High, Standard

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

El parámetro timeout se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.

--type -t

Tipo de blob.

Valores aceptados: block, page

Valor predeterminado: block

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob set-tier (storage-blob-preview extensión)

Establezca los niveles de bloque o página en el blob.

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]

Ejemplos

Establezca los niveles de bloque o página en el blob. (generado automáticamente)

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

Parámetros requeridos

--tier

Valor de nivel en el que se va a establecer el blob.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

--rehydrate-priority -r

Vista previa

Indique la prioridad con la que rehidratar un blob archivado.

Valores aceptados: High, Standard

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

El parámetro timeout se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.

--type -t

Tipo de blob.

Valores aceptados: block, page

Valor predeterminado: block

--version-id

Un identificador de versión de blob opcional. Este parámetro solo es para la cuenta habilitada para el control de versiones.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob show

Editar

Obtenga los detalles de un 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]

Ejemplos

Mostrar todas las propiedades de un blob.

az storage blob show -c mycontainer -n MyBlob

Obtención de los detalles de un blob (generado automáticamente)

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob show (storage-blob-preview extensión)

Obtenga los detalles de un 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]

Ejemplos

Mostrar todas las propiedades de un blob.

az storage blob show -c mycontainer -n MyBlob

Obtención de los detalles de un blob (generado automáticamente)

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--version-id

Vista previa

Un identificador de versión de blob opcional. Este parámetro solo es para la cuenta habilitada para el control de versiones.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob snapshot

Editar

Crea una instantánea del blob.

Una instantánea es una versión de solo lectura de un blob que se ha realizado en un momento dado. Se puede leer, copiar o eliminar, pero no modificar. Las instantáneas le ofrecen una oportunidad de realizar una copia de seguridad de un blob en el momento en que éste aparezca. Una instantánea de un blob tiene el mismo nombre que el blob base desde el que se toma la instantánea, con un valor DateTime anexado para indicar la hora en la que se tomó la instantánea.

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]

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--metadata

Metadatos en pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob sync

Editar

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Sincronizar blobs de forma recursiva con un contenedor de blobs de almacenamiento.

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

Ejemplos

Sincronice un único blob en un contenedor.

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

Sincronice un directorio en un contenedor.

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

Sincronice un directorio a un contenedor con opciones de azcopy de paso a través (en este caso, limitando la banda de carga con 20 MBit/s).

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

Parámetros requeridos

--container -c

Contenedor de destino de sincronización.

--source -s

Ruta de acceso del archivo de origen desde la que se va a sincronizar.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--delete-destination

Define si se van a eliminar archivos adicionales del destino que no están presentes en el origen. Se puede establecer en true, false o prompt. Si se establece en prompt, se le formulará al usuario una pregunta antes de programar archivos y blobs para su eliminación.

Valores aceptados: false, prompt, true

Valor predeterminado: true

--destination -d

Ruta de acceso de destino que se anteponerá al nombre del blob.

--exclude-path

Excluya estas rutas de acceso. Esta opción no permite caracteres comodín (*). Comprueba el prefijo de ruta de acceso relativa. Por ejemplo: myFolder;myFolder/subDirName/file.pdf.

--exclude-pattern

Excluya estos archivos en los que el nombre coincida con la lista de patrones. Por ejemplo: .jpg; .pdf; exactName. Esta opción admite caracteres comodín (*).

--include-pattern

Incluya solo estos archivos en los que el nombre coincida con la lista de patrones. Por ejemplo: .jpg; .pdf; exactName. Esta opción admite caracteres comodín (*).

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

<EXTRA_OPTIONS>

Habilitación de características

Otras opciones que se pasarán a azcopy tal cual. Coloque todas las opciones adicionales después de .--

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob undelete

Editar

Restaure el blob o la instantánea eliminados temporalmente.

La operación solo se realizará correctamente si se usa en el número de días especificado establecido en la directiva de retención de eliminación. Si se intenta recuperar un blob o una instantánea que no se elimina temporalmente, se realizará correctamente sin ningún cambio.

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

Ejemplos

Recuperar un blob.

az storage blob undelete -c mycontainer -n MyBlob

Recuperar un blob mediante credenciales de inicio de sesión.

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob update

Editar

Establece las propiedades del sistema en el blob.

Si se establece una propiedad para la content_settings, se invalidarán todas las propiedades.

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]

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--clear-content-settings

Si se establece esta marca, si alguna o varias de las siguientes propiedades (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-md5, --content-type) se establecen, todas estas propiedades se establecen juntas. Si no se proporciona un valor para una propiedad determinada cuando se establece al menos una de las propiedades enumeradas a continuación, esa propiedad se borrará.

Valores aceptados: false, true

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

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

Cadena de control de caché.

--content-disposition

Transmite información adicional sobre cómo procesar la carga de respuesta y también se puede usar para adjuntar metadatos adicionales.

--content-encoding

Tipo de codificación de contenido.

--content-language

Idioma del contenido.

--content-md5

Hash MD5 del contenido.

--content-type

Tipo MIME de contenido.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob upload

Editar

Cargue un archivo en un blob de almacenamiento.

Cree un blob a partir de una ruta de acceso de archivo o actualice el contenido de un blob existente con notificaciones automáticas de fragmentación y progreso.

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]

Ejemplos

Cargue en un blob.

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

Cargue en un blob con la dirección URL de Sas de 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

Cargue un archivo en un blob de almacenamiento. (generado automáticamente)

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

Cargue una cadena en un blob.

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

Cargar en una canalización.

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

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--blob-url

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

El nombre del contenedor.

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

Cadena de control de caché.

--content-disposition

Transmite información adicional sobre cómo procesar la carga de respuesta y también se puede usar para adjuntar metadatos adicionales.

--content-encoding

Tipo de codificación de contenido.

--content-language

Idioma del contenido.

--content-md5

Hash MD5 del contenido.

--content-type

Tipo MIME de contenido.

--data

Vista previa

Datos del blob que se van a cargar.

--encryption-scope

Ámbito de cifrado predefinido que se usa para cifrar los datos en el servicio.

--file -f

Ruta de acceso del archivo que se va a cargar como contenido del blob.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Obligatorio si el blob tiene una concesión activa.

--length

Vista previa

Número de bytes que se van a leer de la secuencia. Esto es opcional, pero debe proporcionarse para obtener un rendimiento óptimo. Cooperar con --data.

--max-connections

Número máximo de conexiones paralelas que se usarán cuando el tamaño del blob supera los 64 MB.

Valor predeterminado: 2

--maxsize-condition

Longitud máxima en bytes permitida para un blob en anexos.

--metadata

Metadatos en pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.

--name -n

Nombre del blob.

--no-progress

Incluya esta marca para deshabilitar los informes de progreso del comando.

Valor predeterminado: False

--overwrite

Si el blob que se va a cargar debe sobrescribir los datos actuales. Si es True, la operación de carga de blobs sobrescribirá los datos existentes. Si se establece en False, se producirá un error en la operación con ResourceExistsError. La excepción a lo anterior es con los tipos de blob Append: si se establece en False y los datos ya existen, no se generará un error y los datos se anexarán al blob existente. Si se establece overwrite=True, se eliminará el blob en anexos existente y se creará uno nuevo. El valor predeterminado es False.

Valores aceptados: false, true

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--socket-timeout

Tiempo de espera de socket (ss), usado por el servicio para regular el flujo de datos.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--tier

Valor de nivel en el que se va a establecer el blob. En el caso del blob en páginas, el nivel se correlaciona con el tamaño del blob y el número de IOPS permitidos. Los valores posibles son P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 y esto solo se aplica a blobs en páginas en cuentas de premium storage; En el caso del blob en bloques, los valores posibles son Archive, Cold, Cool y Hot. Esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--type -t

El valor predeterminado es "page" para los archivos *.vhd o "block" de lo contrario.

Valores aceptados: append, block, page

--validate-content

Especifique que se calculará un hash MD5 para cada fragmento del blob y comprobará el servicio cuando haya llegado el fragmento.

Valor predeterminado: False

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob upload-batch

Editar

Cargue archivos de un directorio local en un contenedor de blobs.

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]

Ejemplos

Cargue todos los archivos que terminan con .py a menos que el blob exista y se haya modificado desde la fecha especificada.

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

Cargue todos los archivos desde el directorio de ruta de acceso local a un contenedor denominado "mycontainer".

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

Cargue todos los archivos con el formato "cli-2018-xx-xx.txt" o "cli-2019-xx-xx.txt" en el directorio de ruta de acceso local.

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

Cargue todos los archivos con el formato "cli-201x-xx-xx.txt", excepto cli-2018-xx-xx.txt" y "cli-2019-xx-xx.txt" en un contenedor.

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

Parámetros requeridos

--destination -d

Contenedor de blobs donde se cargarán los archivos.

El destino puede ser la dirección URL del contenedor o el nombre del contenedor. Cuando el destino es la dirección URL del contenedor, el nombre de la cuenta de almacenamiento se analizará desde la dirección URL.

--source -s

Directorio donde se encuentran los archivos que se van a cargar.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

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

Cadena de control de caché.

--content-disposition

Transmite información adicional sobre cómo procesar la carga de respuesta y también se puede usar para adjuntar metadatos adicionales.

--content-encoding

Tipo de codificación de contenido.

--content-language

Idioma del contenido.

--content-md5

Hash MD5 del contenido.

--content-type

Tipo MIME de contenido.

--destination-path

Ruta de acceso de destino que se anteponerá al nombre del blob.

--dryrun

Mostrar el resumen de las operaciones que se van a realizar en lugar de cargar realmente los archivos.

Valor predeterminado: False

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (*).

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-id

Identificador de concesión activo para el blob.

--max-connections

Número máximo de conexiones paralelas que se usarán cuando el tamaño del blob supera los 64 MB.

Valor predeterminado: 2

--maxsize-condition

Longitud máxima en bytes permitida para un blob en anexos.

--metadata

Metadatos en pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.

--no-progress

Incluya esta marca para deshabilitar los informes de progreso del comando.

Valor predeterminado: False

--overwrite

Valores aceptados: false, true

--pattern

Patrón usado para archivos o blobs en el origen. Los patrones admitidos son '*', '?', '[seq]' y '[!seq]'. Para obtener más información, consulte https://docs.python.org/3.7/library/fnmatch.html.

Al usar '*' en --pattern, coincidirá con cualquier carácter, incluido el separador de directorios '/'.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--tier

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--type -t

El valor predeterminado es "page" para los archivos *.vhd o "block" de lo contrario. La configuración invalidará los tipos de blob para cada archivo.

Valores aceptados: append, block, page

--validate-content

Especifica que se calculará un hash MD5 para cada fragmento del blob y lo comprobará el servicio cuando haya llegado el fragmento.

Valor predeterminado: False

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage blob url

Editar

Cree la dirección URL para acceder a un 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]

Ejemplos

Creación de la dirección URL para acceder a un blob (generado automáticamente)

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

Creación de la dirección URL para acceder a un blob (generado automáticamente)

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

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--name -n

Nombre del blob.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceptados: key, login

--blob-endpoint

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--protocol

Protocolo que se va a usar.

Valores aceptados: http, https

Valor predeterminado: https

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Valor de cadena que identifica de forma única la instantánea. El valor de este parámetro de consulta indica la versión de instantánea.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

Compartir a través de

az storage blob

Comandos

az storage blob delete

Ejemplos

Parámetros opcionales

az storage blob delete (storage-blob-preview extensión)

Ejemplos

Parámetros opcionales

az storage blob delete-batch

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob download

Ejemplos

Parámetros opcionales

az storage blob download-batch

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob exists

Ejemplos

Parámetros opcionales

az storage blob filter

Parámetros requeridos

Parámetros opcionales

az storage blob generate-sas

Ejemplos

Parámetros opcionales

az storage blob generate-sas (storage-blob-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob list

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob move

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob query

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob restore

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob rewrite

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob set-legal-hold

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob set-tier

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob set-tier (storage-blob-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob show

Ejemplos

Parámetros opcionales

az storage blob show (storage-blob-preview extensión)

Ejemplos

Parámetros opcionales

az storage blob snapshot

Parámetros opcionales

az storage blob sync

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage blob undelete

Ejemplos

Parámetros opcionales