Compartir a través de

az snapshot

  • Referencia

Administrar copias en un momento dado de discos administrados, blobs nativos u otras instantáneas.

Comandos

Nombre Description Tipo Estado
az snapshot create

Cree una instantánea.

 Core GA
az snapshot delete

Elimina una instantánea.

 Core GA
az snapshot grant-access

Conceda acceso de lectura a una instantánea.

 Core GA
az snapshot list

Enumera las instantáneas en un grupo de recursos.

 Core GA
az snapshot revoke-access

Revocar el acceso a una instantánea.

 Core GA
az snapshot show

Obtenga información sobre una instantánea.

 Core GA
az snapshot update

Actualice una instantánea.

 Core GA
az snapshot wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Core GA

az snapshot create

Cree una instantánea.

az snapshot create --name
                   --resource-group
                   [--accelerated-network {false, true}]
                   [--architecture {Arm64, x64}]
                   [--bandwidth-copy-speed {Enhanced, None}]
                   [--copy-start {false, true}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--edge-zone]
                   [--elastic-san-id]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--for-upload {false, true}]
                   [--hyper-v-generation {V1, V2}]
                   [--incremental {false, true}]
                   [--location]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait]
                   [--public-network-access {Disabled, Enabled}]
                   [--size-gb]
                   [--sku {Premium_LRS, Standard_LRS, Standard_ZRS}]
                   [--source]
                   [--source-storage-account-id]
                   [--tags]

Ejemplos

Cree una instantánea mediante la importación desde un URI de blob.

az snapshot create -g MyResourceGroup -n MySnapshot --source https://vhd1234.blob.core.windows.net/vhds/osdisk1234.vhd

Cree una instantánea vacía.

az snapshot create -g MyResourceGroup -n MySnapshot --size-gb 10

Cree una instantánea copiando un disco existente en el mismo grupo de recursos.

az snapshot create -g MyResourceGroup -n MySnapshot2 --source MyDisk

Cree una instantánea a partir de un disco existente en otro grupo de recursos.

az snapshot create -g MyResourceGroup -n MySnapshot2 --source "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Compute/disks/MyDisk"

Cree una instantánea y asóciela a un recurso de acceso a disco.

az snapshot create -g MyResourceGroup -n MySnapshot --size-gb 10 --network-access-policy AllowPrivate --disk-access MyDiskAccessID

Parámetros requeridos

--name -n

Nombre de la instantánea.

--resource-group -g

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

Parámetros opcionales

--accelerated-network
Vista previa

Los clientes pueden establecer en Managed Disks o Instantáneas para habilitar las redes aceleradas si la imagen del disco del sistema operativo admite.

Valores aceptados: false, true
--architecture

Arquitectura de CPU.

Valores aceptados: Arm64, x64
--bandwidth-copy-speed

Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.

Valores aceptados: Enhanced, None
--copy-start

Cree una instantánea mediante un proceso de copia profunda, donde la creación de recursos se considera completada solo después de que se hayan copiado todos los datos del origen.

Valores aceptados: false, true
--disk-access

Nombre o identificador del recurso de acceso al disco para usar puntos de conexión privados en discos.

--disk-encryption-set

Nombre o identificador del conjunto de cifrado de disco que se usa para cifrar el disco.

--edge-zone

Nombre de la zona perimetral.

--elastic-san-id --elastic-san-resource-id

Este es el identificador de ARM de la instantánea de volumen elástica de origen san.

--encryption-type

Tipo de cifrado. EncryptionAtRestWithPlatformKey: el disco se cifra con la clave administrada XStore en reposo. Es el tipo de cifrado predeterminado. EncryptionAtRestWithCustomerKey: el disco se cifra con la clave administrada por el cliente en reposo.

Valores aceptados: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

Cree la instantánea para cargar blobs más adelante mediante comandos de almacenamiento. Ejecute "az snapshot grant-access --access-level Write" para recuperar el token de SAS de la instantánea.

Valores aceptados: false, true
--hyper-v-generation

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.

Valores aceptados: V1, V2
--incremental

Si una instantánea es incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden diffed.

Valores aceptados: false, true
--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>. Si no se especifica la ubicación y no se especifica ninguna ubicación predeterminada, la ubicación se establecerá automáticamente igual que el grupo de recursos.

--network-access-policy

Directiva para acceder al disco a través de la red.

Valores aceptados: AllowAll, AllowPrivate, DenyAll
--no-wait

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

Valor predeterminado: False
--public-network-access
Vista previa

Los clientes pueden establecer en Managed Disks o Instantáneas para controlar la directiva de exportación en el disco.

Valores aceptados: Disabled, Enabled
--size-gb -z

Tamaño en GB. Tamaño máximo: 4095 GB (determinados discos en versión preliminar pueden ser mayores).

--sku
Valores aceptados: Premium_LRS, Standard_LRS, Standard_ZRS
Valor predeterminado: Standard_LRS
--source

Origen a partir del que se crea el disco o la instantánea, incluido el URI del blob no administrado, el identificador o el nombre del disco administrado, o el identificador o el nombre de la instantánea.

--source-storage-account-id

Se usa cuando el blob de origen está en una suscripción diferente.

--tags

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

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 snapshot delete

Elimina una instantánea.

az snapshot delete [--ids]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--resource-group]
                   [--subscription]

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --snapshot-name -n

Nombre de la instantánea que se va a crear. El nombre no se puede cambiar después de crear la instantánea. Los caracteres admitidos para el nombre son a-z, A-Z, 0-9, _ y -. La longitud máxima del nombre es de 80 caracteres.

--no-wait

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

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

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 snapshot grant-access

Conceda acceso de lectura a una instantánea.

az snapshot grant-access --duration-in-seconds
                         [--access-level {Read, Write}]
                         [--file-format {VHD, VHDX}]
                         [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

Ejemplos

Conceda acceso de lectura a una instantánea. (generado automáticamente)

az snapshot grant-access --duration-in-seconds 3600 --name MySnapshot --resource-group MyResourceGroup

Conceda acceso de lectura a una instantánea con la especificación del formato de archivo.

az snapshot grant-access --duration-in-seconds 3600 --name MySnapshot --resource-group MyResourceGroup --file-format VHDX

Parámetros requeridos

--duration-in-seconds

Duración del tiempo en segundos hasta que expire el acceso SAS.

Parámetros opcionales

--access-level

Nivel de acceso.

Valores aceptados: Read, Write
Valor predeterminado: Read
--file-format

Se usa para especificar el formato de archivo al realizar la solicitud de SAS en una instantánea de formato de archivo VHDX.

Valores aceptados: VHD, VHDX
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la instantánea.

--resource-group -g

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

--subscription

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

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 snapshot list

Enumera las instantáneas en un grupo de recursos.

az snapshot list [--max-items]
                 [--next-token]
                 [--resource-group]

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--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 snapshot revoke-access

Revocar el acceso a una instantánea.

az snapshot revoke-access [--ids]
                          [--name]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                          [--resource-group]
                          [--subscription]

Ejemplos

Revocar el acceso de lectura a una instantánea.

az snapshot revoke-access --name MySnapshot --resource-group MyResourceGroup

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --snapshot-name -n

Nombre de la instantánea.

--no-wait

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

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

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 snapshot show

Obtenga información sobre una instantánea.

az snapshot show [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --snapshot-name -n

Nombre de la instantánea que se va a crear. El nombre no se puede cambiar después de crear la instantánea. Los caracteres admitidos para el nombre son a-z, A-Z, 0-9, _ y -. La longitud máxima del nombre es de 80 caracteres.

--resource-group -g

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

--subscription

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

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 snapshot update

Actualice una instantánea.

az snapshot update [--accelerated-network {false, true}]
                   [--add]
                   [--architecture {Arm64, x64}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--force-string]
                   [--ids]
                   [--name]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait]
                   [--public-network-access {Disabled, Enabled}]
                   [--remove]
                   [--resource-group]
                   [--set]
                   [--sku {Premium_LRS, Standard_LRS, Standard_ZRS}]
                   [--subscription]

Ejemplos

Actualice una instantánea y asóciela a un recurso de acceso al disco.

az snapshot update --name MySnapshot --resource-group MyResourceGroup --network-access-policy AllowPrivate --disk-access MyDiskAccessID

Actualice una instantánea. (generado automáticamente)

az snapshot update --name MySnapshot --resource-group MyResourceGroup --subscription MySubscription

Parámetros opcionales

--accelerated-network
Vista previa

Los clientes pueden establecer en Managed Disks o Instantáneas para habilitar las redes aceleradas si la imagen del disco del sistema operativo admite.

Valores aceptados: false, true
--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Valor predeterminado: []
--architecture

Arquitectura de CPU.

Valores aceptados: Arm64, x64
--disk-access

Nombre o identificador del recurso de acceso al disco para usar puntos de conexión privados en discos.

--disk-encryption-set

Nombre o identificador del conjunto de cifrado de disco que se usa para cifrar el disco.

--encryption-type

Tipo de cifrado. EncryptionAtRestWithPlatformKey: el disco se cifra con la clave administrada XStore en reposo. Es el tipo de cifrado predeterminado. EncryptionAtRestWithCustomerKey: el disco se cifra con la clave administrada por el cliente en reposo.

Valores aceptados: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la instantánea.

--network-access-policy

Directiva para acceder al disco a través de la red.

Valores aceptados: AllowAll, AllowPrivate, DenyAll
--no-wait

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

Valor predeterminado: False
--public-network-access
Vista previa

Los clientes pueden establecer en Managed Disks o Instantáneas para controlar la directiva de exportación en el disco.

Valores aceptados: Disabled, Enabled
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []
--resource-group -g

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

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []
--sku
Valores aceptados: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

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

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 snapshot wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az snapshot wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name]
                 [--resource-group]
                 [--subscription]
                 [--timeout]
                 [--updated]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name --snapshot-name -n

Nombre de la instantánea que se va a crear. El nombre no se puede cambiar después de crear la instantánea. Los caracteres admitidos para el nombre son a-z, A-Z, 0-9, _ y -. La longitud máxima del nombre es de 80 caracteres.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

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.