az storage blob copy
Note
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 operaciones de copia de blobs. Use az storage blob show para comprobar el estado de los blobs.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| 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 |
Core | GA |
| az storage blob copy start (storage-blob-preview extensión) |
Inicie un trabajo de copia de blobs. |
Extension | GA |
| az storage blob copy start-batch |
Copie varios blobs en un contenedor de blobs. Use |
Core | GA |
az storage blob copy cancel
Anule una operación de copia en curso.
Esto dejará un blob de destino con longitud cero y metadatos completos. Esto generará un error si la operación de copia ya ha finalizado.
az storage blob copy cancel --copy-id
--destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--lease-id]
[--sas-token]
[--timeout]
Parámetros requeridos
Operación de copia que se va a anular. Puede ser una cadena de identificador o una instancia de BlobProperties.
Nombre del blob de destino. Si existe, se sobrescribirá.
Nombre del contenedor.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Clave de 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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | key, login |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Obligatorio si el blob de destino tiene una concesión infinita activa.
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az storage blob copy start
Copie un blob de forma asincrónica. Use az storage blob show para comprobar el estado de los blobs.
az storage blob copy start --destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-if-match]
[--destination-if-modified-since]
[--destination-if-none-match]
[--destination-if-unmodified-since]
[--destination-lease-id]
[--destination-tags-condition]
[--metadata]
[--rehydrate-priority]
[--requires-sync {false, true}]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-container]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--source-path]
[--source-sas]
[--source-share]
[--source-snapshot]
[--source-tags-condition]
[--source-uri]
[--tags]
[--tier]
[--timeout]
Ejemplos
Copie un blob de forma asincrónica. Use "az storage blob show" para comprobar el estado de los blobs.
az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos
Copie un blob de forma asincrónica. Use "az storage blob show" para comprobar el estado de los blobs.
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos
Copia de una versión específica del blob
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://my-account.blob.core.windows.net/my-container/my-blob?versionId=2022-03-21T18:28:44.4431011Z --auth-mode login
Parámetros requeridos
Nombre del blob de destino. Si existe, se sobrescribirá.
Nombre del contenedor.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Clave de 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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | key, login |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Define el tipo de blob en el destino. El valor de "Detect" determina el tipo basado en el tipo de blob de origen.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | AppendBlob, BlockBlob, Detect, PageBlob |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino se ha modificado desde la fecha y hora especificadas. Si el blob de destino no se ha modificado, Blob service devuelve el código de estado 412 (error de condición previa).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
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 producirá un error en la operación si existe.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino no se ha modificado desde la fecha y hora especificadas. Si se ha modificado el blob de destino, Blob service devuelve el código de estado 412 (error de condición previa).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
El identificador de concesión especificado para este encabezado debe coincidir con el identificador de concesión del blob de destino. Si la solicitud no incluye el identificador de concesión o no es válido, se produce un error en la operación con el código de estado 412 (error de condición previa).
Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Metadatos en forma de pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.
Indique la prioridad con la que rehidratar un blob archivado.
Exija que el servicio no devuelva una respuesta hasta que se complete la copia.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Clave de la cuenta de almacenamiento del blob de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre de la cuenta de almacenamiento del blob de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre del blob de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre del contenedor de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen se ha modificado desde la fecha y hora especificadas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
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 producirá un error en la operación si existe.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen no se ha modificado desde la fecha y hora especificadas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
Especifique esto para realizar la operación Copiar blob solo si el identificador de concesión dado coincide con el identificador de concesión activo del blob de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Ruta de acceso del archivo de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Firma de acceso compartido para la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre del recurso compartido de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Instantánea de blob para la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Dirección URL de hasta 2 KB de longitud que especifica un archivo o blob de Azure. 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. Ejemplos: https://myaccount.blob.core.windows.net/mycontainer/myblob, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
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.
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az storage blob copy start (storage-blob-preview extensión)
Inicie un trabajo de copia de blobs.
az storage blob copy start --destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-if-match]
[--destination-if-modified-since]
[--destination-if-none-match]
[--destination-if-unmodified-since]
[--destination-lease-id]
[--destination-tags-condition]
[--metadata]
[--rehydrate-priority]
[--requires-sync {false, true}]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-container]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--source-path]
[--source-sas]
[--source-share]
[--source-snapshot]
[--source-tags-condition]
[--source-uri]
[--tags]
[--tier]
[--timeout]
Ejemplos
Copie un blob de forma asincrónica. Use "az storage blob show" para comprobar el estado de los blobs.
az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos
Copie un blob de forma asincrónica. Use "az storage blob show" para comprobar el estado de los blobs.
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos
Parámetros requeridos
Nombre del blob de destino. Si existe, se sobrescribirá.
Nombre del contenedor.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Clave de cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | key, login |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Define el tipo de blob en el destino. El valor de "Detect" determina el tipo basado en el tipo de blob de origen.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | AppendBlob, BlockBlob, Detect, PageBlob |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino se ha modificado desde la fecha y hora especificadas. Si el blob de destino no se ha modificado, Blob service devuelve el código de estado 412 (error de condición previa).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
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 producirá un error en la operación si existe.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino no se ha modificado desde la fecha y hora especificadas. Si se ha modificado el blob de destino, Blob service devuelve el código de estado 412 (error de condición previa).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
El identificador de concesión especificado para este encabezado debe coincidir con el identificador de concesión del blob de estination. Si la solicitud no incluye el identificador de concesión o no es válido, se produce un error en la operación con el código de estado 412 (error de condición previa).
Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Metadatos en forma de pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.
Indique la prioridad con la que rehidratar un blob archivado.
Exija que el servicio no devuelva una respuesta hasta que se complete la copia.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Clave de la cuenta de almacenamiento del blob de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre de la cuenta de almacenamiento del blob de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre del blob de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre del contenedor de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen se ha modificado desde la fecha y hora especificadas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
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 producirá un error en la operación si existe.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
Valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen no se ha modificado desde la fecha y hora especificadas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Pre-condition Arguments |
Especifique esto para realizar la operación Copiar blob solo si el identificador de concesión dado coincide con el identificador de concesión activo del blob de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Ruta de acceso del archivo de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Firma de acceso compartido para la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Nombre del recurso compartido de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Instantánea de blob para la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Precondition Arguments |
Dirección URL de hasta 2 KB de longitud que especifica un archivo o blob de Azure. 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. Ejemplos: https://myaccount.blob.core.windows.net/mycontainer/myblob, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Las etiquetas distinguen mayúsculas de minúsculas. El conjunto de etiquetas puede contener como máximo 10 etiquetas. Las claves de etiqueta deben tener entre 1 y 128 caracteres y los valores de etiqueta deben tener entre 0 y 256 caracteres. Los caracteres válidos de clave y valor incluyen: letras minúsculas y mayúsculas, dígitos (0-9), espacio ( ), más (+), menos (-), punto (.), solidus (/), dos puntos (:), iguales (=), subrayado (_).
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.
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
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.
az storage blob copy start-batch [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-container]
[--destination-path]
[--dryrun]
[--pattern]
[--rehydrate-priority]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-container]
[--source-sas]
[--source-share]
[--source-uri]
[--tier]
Ejemplos
Copie varios blobs en un contenedor de blobs. Use "az storage blob show" para comprobar el estado de los blobs. (autogenerated)
az storage blob copy start-batch --account-key 00000000 --account-name MyAccount --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-container MySourceContainer
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Clave de 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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
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.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | key, login |
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Define el tipo de blob en el destino. El valor de "Detect" determina el tipo basado en el tipo de blob de origen.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | AppendBlob, BlockBlob, Detect, PageBlob |
El contenedor de blobs en el que se copiarán los archivos o blobs de origen seleccionados.
Ruta de acceso de destino que se anteponerá al nombre del blob.
Enumere los archivos o blobs que se van a cargar. No se producirá ninguna transferencia de datos real.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
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/library/fnmatch.html.
Al usar '*' en --pattern, coincidirá con cualquier carácter, incluido el separador de directorios '/'.
Indique la prioridad con la que rehidratar un blob archivado.
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.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Storage Account Arguments |
Clave de cuenta de la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
La cuenta de almacenamiento de origen desde la que se copian los archivos o blobs en el destino. Si se omite, se usa la cuenta de destino.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Contenedor de origen desde el que se copian los blobs.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Firma de acceso compartido para la cuenta de almacenamiento de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Recurso compartido de origen desde el que se copian los archivos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
Un URI que especifica un recurso compartido de archivos o un contenedor de blobs desde el que se copian los archivos o blobs.
Si el origen está en otra cuenta, el origen debe ser público o autenticarse mediante una firma de acceso compartido.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Copy Source Arguments |
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.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |