Compartilhar via

az snapshot

  • Referência

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

Comandos

Nome Description Tipo Status
az snapshot create

Crie 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 instantâneo.

 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 instantâneo.

 Núcleo GA
az snapshot show

Obtenha informações sobre um instantâneo.

 Núcleo GA
az snapshot update

Atualize 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

Crie 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 instantâneo copiando um disco existente no mesmo grupo de recursos.

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

Crie um instantâneo 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 instantâneo e associe-o a um recurso de acesso a 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 Discos Gerenciados ou Instantâneos para habilitar a rede acelerada se a imagem de disco do sistema operacional der suporte.

Valores aceitos: false, true
--architecture

Arquitetura da CPU.

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

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

Valores aceitos: Enhanced, None
--copy-start

Crie um 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

Essa é a ID do ARM do instantâneo de 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 instantâneo para carregar blobs posteriormente por meio de comandos de armazenamento. Execute "az snapshot grant-access --access-level Write" para recuperar o token SAS do instantâneo.

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

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

Valores aceitos: V1, V2
--incremental

Se um instantâneo é incremental. Instantâneos incrementais no mesmo disco ocupam menos espaço do que instantâneos completos e podem ser diferenciados.

Valores aceitos: false, true
--location -l

Localização. 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 especificado, o local será automaticamente definido como o mesmo que o grupo de recursos.

--network-access-policy

Política para acessar o disco por meio da rede.

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

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

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

Os clientes podem definir em Discos Gerenciados ou Instantâneos para controlar a política de exportação no disco.

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

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

--sku
Valores aceitos: Premium_LRS, Standard_LRS, Standard_ZRS
Valor padrão: Standard_LRS
--source

Origem para criar o disco/instantâneo, incluindo uri de blob não gerenciado, id de disco gerenciado ou nome ou id ou nome do instantâneo.

--source-storage-account-id

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

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 de recurso'.

--name --snapshot-name -n

O nome do instantâneo que está sendo criado. O nome não pode ser alterado depois que o instantâneo é criado. Os caracteres com suporte 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 prolongada.

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az snapshot grant-access

Conceda acesso de leitura a um instantâneo.

az snapshot grant-access --duration-in-seconds
                         [--access {Read, Write}]
                         [--file-format {VHD, VHDX}]
                         [--ids]
                         [--name]
                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--resource-group]
                         [--subscription]

Exemplos

Conceda acesso de leitura a um instantâneo.

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 --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 de recurso'.

--name --snapshot-name -n

O nome do instantâneo que está sendo criado. O nome não pode ser alterado depois que o instantâneo é criado. Os caracteres com suporte 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 prolongada.

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 em --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az snapshot revoke-access

Revogar o acesso a um instantâneo.

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 instantâneo.

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 de recurso'.

--name --snapshot-name -n

O nome do instantâneo.

--no-wait

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

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az snapshot show

Obtenha informações sobre um instantâneo.

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 de recurso'.

--name --snapshot-name -n

O nome do instantâneo que está sendo criado. O nome não pode ser alterado depois que o instantâneo é criado. Os caracteres com suporte 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az snapshot update

Atualize um instantâneo.

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

Exemplos

Atualize um instantâneo 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

Atualize um instantâneo.

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

Parâmetros Opcionais

--accelerated-network
Versão Prévia

Os clientes podem definir em Discos Gerenciados ou Instantâneos para habilitar a rede acelerada se a imagem de disco do sistema operacional der suporte.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--add

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

--architecture

Arquitetura da 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.

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

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

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--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 de recurso'.

--name --snapshot-name -n

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

--network-access-policy

Política para acessar o disco por meio da rede.

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

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

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--public-network-access
Versão Prévia

Política para controlar a exportação no disco.

Valores aceitos: Disabled, Enabled
--remove

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

--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 ser definido. Exemplo: --set property1.property2=<value>.

--sku

O nome do 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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é ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição atenda 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 de 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 instantâneo é criado. Os caracteres com suporte 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.