az snapshot

  • Referência

Gerencia cópias pontuais de discos gerenciados, blobs nativos ou outros instantâneos.

Comandos

Nome Description Tipo Status
az snapshot create

Criar um instantâneo.

 Núcleo GA
az snapshot delete

Excluir um instantâneo.

 Núcleo GA
az snapshot grant-access

Conceda acesso de leitura a um snapshot.

 Núcleo GA
az snapshot list

Listar instantâneos em um grupo de recursos.

 Núcleo GA
az snapshot revoke-access

Revogar o acesso a um snapshot.

 Núcleo GA
az snapshot show

Obtenha informações sobre um snapshot.

 Núcleo GA
az snapshot update

Atualizar um instantâneo.

 Núcleo GA
az snapshot wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Núcleo GA

az snapshot create

Criar um instantâneo.

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]

Exemplos

Crie um instantâneo importando de um uri de blob.

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

Crie um instantâneo vazio.

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

Crie um snapshot copiando um disco existente no mesmo grupo de recursos.

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

Crie um snapshot de um disco existente em outro grupo de recursos.

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

Crie um snapshot e associe-o a um recurso de acesso ao disco.

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

Parâmetros Exigidos

--name -n

O nome do instantâneo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--accelerated-network
Versão Prévia

Os clientes podem definir em Managed Disks ou Snapshots para habilitar a rede acelerada se a imagem de disco do sistema operacional suportar.

valores aceitos: false, true
--architecture

Arquitetura de CPU.

valores aceitos: Arm64, x64
--bandwidth-copy-speed

Se esse campo estiver definido em um snapshot e createOption for CopyStart, o snapshot será copiado em uma velocidade mais rápida.

valores aceitos: Enhanced, None
--copy-start

Crie instantâneo usando um processo de cópia profunda, em que a criação do recurso é considerada concluída somente depois que todos os dados tiverem sido copiados da origem.

valores aceitos: false, true
--disk-access

Nome ou ID do recurso de acesso ao disco para usar pontos de extremidade privados em discos.

--disk-encryption-set

Nome ou ID do conjunto de criptografia de disco usado para criptografar o disco.

--edge-zone

O nome da zona de borda.

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

Esta é a ID ARM do snapshot do volume san elástico de origem.

--encryption-type

Tipo de criptografia. EncryptionAtRestWithPlatformKey: O disco é criptografado com a chave gerenciada XStore em repouso. É o tipo de criptografia padrão. EncryptionAtRestWithCustomerKey: O disco é criptografado com a chave gerenciada pelo cliente em repouso.

valores aceitos: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

Crie o snapshot para carregar blobs posteriormente por meio de comandos de armazenamento. Execute "az snapshot grant-access --access-level Write" para recuperar o token SAS do snapshot.

valores aceitos: false, true
--hyper-v-generation

A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do sistema operacional.

valores aceitos: V1, V2
--incremental

Se um snapshot é incremental. Os snapshots incrementais no mesmo disco ocupam menos espaço do que os snapshots completos e podem ser diferentes.

valores aceitos: false, true
--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>. Se o local não for especificado e nenhum local padrão for especificado, o local será definido automaticamente como o mesmo que o grupo de recursos.

--network-access-policy

Política de acesso ao disco via rede.

valores aceitos: AllowAll, AllowPrivate, DenyAll
--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--public-network-access
Versão Prévia

Os clientes podem definir em Managed Disks ou Snapshots para controlar a política de exportação no disco.

valores aceitos: Disabled, Enabled
--size-gb -z

Tamanho em GB. Tamanho máximo: 4095 GB (alguns discos de visualização podem ser maiores).

--sku
valores aceitos: Premium_LRS, Standard_LRS, Standard_ZRS
valor padrão: Standard_LRS
--source

Origem a partir da qual criar o disco/snapshot, incluindo uri de blob não gerenciado, ID ou nome do disco gerenciado ou ID ou nome do snapshot.

--source-storage-account-id

Usado quando o blob de origem está em uma assinatura diferente.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot delete

Excluir um instantâneo.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name --snapshot-name -n

O nome do instantâneo que está sendo criado. O nome não pode ser alterado depois que o snapshot é criado. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

--no-wait

Não aguarde a conclusão da operação de execução longa.

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

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot grant-access

Conceda acesso de leitura a um snapshot.

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

Exemplos

Conceda acesso de leitura a um snapshot. (gerado automaticamente)

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

Conceda acesso de leitura a um instantâneo com a especificação do formato de arquivo.

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

Parâmetros Exigidos

--duration-in-seconds

Duração do tempo em segundos até que o acesso SAS expire.

Parâmetros Opcionais

--access-level

Nível de acesso.

valores aceitos: Read, Write
valor padrão: Read
--file-format

Usado para especificar o formato de arquivo ao fazer solicitação de SAS em um instantâneo de formato de arquivo VHDX.

valores aceitos: VHD, VHDX
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome do instantâneo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot list

Listar instantâneos em um grupo de recursos.

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

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot revoke-access

Revogar o acesso a um snapshot.

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

Exemplos

Revogar o acesso de leitura a um snapshot.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name --snapshot-name -n

O nome do instantâneo.

--no-wait

Não aguarde a conclusão da operação de execução longa.

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

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot show

Obtenha informações sobre um snapshot.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name --snapshot-name -n

O nome do instantâneo que está sendo criado. O nome não pode ser alterado depois que o snapshot é criado. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot update

Atualizar um instantâneo.

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]

Exemplos

Atualize um snapshot e associe-o a um recurso de acesso ao disco.

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

Atualizar um instantâneo. (gerado automaticamente)

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

Parâmetros Opcionais

--accelerated-network
Versão Prévia

Os clientes podem definir em Managed Disks ou Snapshots para habilitar a rede acelerada se a imagem de disco do sistema operacional suportar.

valores aceitos: false, true
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

valor padrão: []
--architecture

Arquitetura de CPU.

valores aceitos: Arm64, x64
--disk-access

Nome ou ID do recurso de acesso ao disco para usar pontos de extremidade privados em discos.

--disk-encryption-set

Nome ou ID do conjunto de criptografia de disco usado para criptografar o disco.

--encryption-type

Tipo de criptografia. EncryptionAtRestWithPlatformKey: O disco é criptografado com a chave gerenciada XStore em repouso. É o tipo de criptografia padrão. EncryptionAtRestWithCustomerKey: O disco é criptografado com a chave gerenciada pelo cliente em repouso.

valores aceitos: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.

valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome do instantâneo.

--network-access-policy

Política de acesso ao disco via rede.

valores aceitos: AllowAll, AllowPrivate, DenyAll
--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--public-network-access
Versão Prévia

Os clientes podem definir em Managed Disks ou Snapshots para controlar a política de exportação no disco.

valores aceitos: Disabled, Enabled
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

valor padrão: []
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>.

valor padrão: []
--sku
valores aceitos: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az snapshot wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

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

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--name --snapshot-name -n

O nome do instantâneo que está sendo criado. O nome não pode ser alterado depois que o snapshot é criado. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.