Compartilhar via

az disk

Gerenciar Azure Managed Disks.

As Máquinas Virtuais do Azure usam discos como um local para armazenar um sistema operacional, aplicativos e dados. Todas as máquinas virtuais do Azure têm pelo menos dois discos: um disco do sistema operacional e um disco temporário. O disco do sistema operacional é criado a partir de uma imagem e o disco do sistema operacional e a imagem são, na verdade, VHDs (discos rígidos virtuais) armazenados em uma conta de armazenamento do Azure. As máquinas virtuais também podem ter um ou mais discos de dados, que também são armazenados como VHDs. Os Discos de Dados Não Gerenciados do Azure têm um tamanho máximo de 4095 GB. Para usar discos maiores que 4095 GB, use o Azure Managed Disks.

Comandos

Nome Description Tipo Status
az disk config

Gerenciar configuração de disco.

 Core GA
az disk config update

Atualizar configuração de disco.

 Core GA
az disk create

Crie um disco gerenciado.

 Core GA
az disk delete

Excluir um disco gerenciado.

 Core GA
az disk grant-access

Conceda a um recurso acesso a um disco gerenciado.

 Core GA
az disk list

Listar discos gerenciados.

 Core GA
az disk revoke-access

Revogar o acesso de leitura de um recurso a um disco gerenciado.

 Core GA
az disk show

Obtenha informações sobre um disco.

 Core GA
az disk update

Atualize um disco gerenciado.

 Core GA
az disk wait

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

 Core GA

az disk create

Crie um disco gerenciado.

az disk create --name
               --resource-group
               [--accelerated-network {false, true}]
               [--action-on-disk-delay {AutomaticReattach}]
               [--architecture {Arm64, x64}]
               [--data-access-auth-mode {AzureActiveDirectory, None}]
               [--disk-access]
               [--disk-encryption-set]
               [--disk-iops-read-only]
               [--disk-iops-read-write]
               [--disk-mbps-read-only]
               [--disk-mbps-read-write]
               [--edge-zone]
               [--enable-bursting {false, true}]
               [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
               [--gallery-image-reference]
               [--gallery-image-reference-lun]
               [--hyper-v-generation {V1, V2}]
               [--image-reference]
               [--image-reference-lun]
               [--location]
               [--logical-sector-size]
               [--max-shares]
               [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
               [--no-wait]
               [--optimized-for-frequent-attach {false, true}]
               [--os-type {Linux, Windows}]
               [--performance-plus {false, true}]
               [--public-network-access {Disabled, Enabled}]
               [--secure-vm-disk-encryption-set]
               [--security-data-uri]
               [--security-metadata-uri]
               [--security-option --supported-security-option {TrustedLaunchAndConfidentialVMSupported, TrustedLaunchSupported}]
               [--security-type {ConfidentialVM_DiskEncryptedWithCustomerKey, ConfidentialVM_DiskEncryptedWithPlatformKey, ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey, Standard, TrustedLaunch}]
               [--size-gb]
               [--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--source]
               [--source-storage-account-id]
               [--support-hibernation {false, true}]
               [--tags]
               [--tier]
               [--upload-size-bytes]
               [--upload-type {Upload, UploadWithSecurityData}]
               [--zone]

Exemplos

Crie um disco gerenciado importando de um uri de blob.

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

Crie um disco gerenciado vazio.

az disk create -g MyResourceGroup -n MyDisk --size-gb 10

Crie um disco gerenciado vazio com a intermitência habilitada.

az disk create -g MyResourceGroup -n MyDisk --size-gb 1024 --location centraluseuap --enable-bursting

Crie um disco gerenciado copiando um disco ou instantâneo existente.

az disk create -g MyResourceGroup -n MyDisk2 --source MyDisk

Criar um disco em uma zona de disponibilidade na região de "Leste dos EUA 2"

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --location eastus2 --zone 1

Crie um disco com base na imagem.

az disk create -g MyResourceGroup -n MyDisk --image-reference Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest

Criar um disco do disco do sistema operacional de uma versão de imagem da galeria de computação

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0

Criar um disco do disco do sistema operacional da versão mais recente em uma imagem da galeria de computação

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage

Criar um disco do disco do sistema operacional de uma versão de imagem da galeria compartilhada

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /SharedGalleries/sharedGalleryUniqueName/Images/imageName/Versions/1.0.0

Criar um disco a partir do disco do sistema operacional de uma versão de imagem da galeria da comunidade

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /CommunityGalleries/communityGalleryPublicGalleryName/Images/imageName/Versions/1.0.0

Criar um disco a partir do Disco de Dados de uma imagem da galeria

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0 --gallery-image-reference-lun 0

Crie um disco com o número total de IOPS e a limitação total da taxa de transferência (MBps).

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --sku UltraSSD_LRS --disk-iops-read-only 200 --disk-mbps-read-only 30

Crie um disco e especifique o número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo.

az disk create -g MyResourceGroup -n MyDisk --size-gb 256 --max-shares 2 -l centraluseuap

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

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

Crie um disco a partir do URI do blob para VHD de estado convidado da VM.

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --security-data-uri GuestStateDiskVhdUri --security-type TrustedLaunch --hyper-v-generation V2

Crie um disco padrão para carregar blobs.

az disk create -g MyResourceGroup -n MyDisk --upload-size-bytes 20972032 --upload-type Upload

Crie um disco do sistema operacional para carregar junto com o estado convidado da VM.

az disk create -g MyResourceGroup -n MyDisk --upload-size-bytes 20972032 --upload-type UploadWithSecurityData --security-type TrustedLaunch --hyper-v-generation V2

Parâmetros Exigidos

--name -n

O nome do disco gerenciado.

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valores aceitos: false, true
--action-on-disk-delay

Determine como lidar com discos com E/S lenta.

Propriedade Valor
Valores aceitos: AutomaticReattach
--architecture

Arquitetura da CPU.

Propriedade Valor
Valores aceitos: Arm64, x64
--data-access-auth-mode

Especifique o modo de autenticação ao exportar ou carregar em um disco ou instantâneo.

Propriedade Valor
Valores aceitos: AzureActiveDirectory, None
--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.

--disk-iops-read-only

O número total de IOPS que serão permitidos em todas as VMs que montam o disco compartilhado como ReadOnly. Uma operação pode ser transferida entre 4k e 256 mil bytes.

--disk-iops-read-write

O número de IOPS permitido para esse disco. Somente configurável para discos UltraSSD. Uma operação pode ser transferida entre 4k e 256 mil bytes.

--disk-mbps-read-only

A taxa de transferência total (MBps) que será permitida em todas as VMs que montam o disco compartilhado como ReadOnly. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.

--disk-mbps-read-write

A largura de banda permitida para esse disco. Somente configurável para discos UltraSSD. MBps significa milhões de bytes por segundo com notação ISO de poderes de 10.

--edge-zone

O nome da zona de borda.

--enable-bursting

Habilite a intermitência sob demanda além da meta de desempenho provisionada do disco. O estouro sob demanda é desabilitado por padrão e não se aplica a discos Ultra.

Propriedade Valor
Valores aceitos: false, true
--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.

Propriedade Valor
Valores aceitos: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--gallery-image-reference

ID da versão de imagem da Galeria de Computação, Compartilhada ou Comunidade da qual criar um disco. Para obter detalhes sobre o formato válido, consulte o exemplo de ajuda.

--gallery-image-reference-lun

Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem será usado. Para discos do sistema operacional, esse campo é nulo.

--hyper-v-generation

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

Propriedade Valor
Valores aceitos: V1, V2
--image-reference

ID ou URN (publisher:offer:sku:version) da imagem da qual criar um disco.

--image-reference-lun

Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem será usado. Para discos do sistema operacional, esse campo é nulo.

--location -l

Location. 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.

--logical-sector-size

Tamanho do setor lógico em bytes para discos Ultra. Os valores com suporte são 512 ad 4096. 4096 é o padrão.

--max-shares

O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. Valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.

--network-access-policy

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

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

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

Propriedade Valor
Valor padrão: False
--optimized-for-frequent-attach

Definir essa propriedade como true melhora a confiabilidade e o desempenho de discos de dados que são frequentemente (mais de 5 vezes por dia) desanexados de uma máquina virtual e anexados a outra. Essa propriedade não deve ser definida para discos que não são desanexados e anexados com frequência, pois faz com que os discos não se alinhem com o domínio de falha da máquina virtual.

Propriedade Valor
Valores aceitos: false, true
--os-type

O tipo de sistema operacional do disco.

Propriedade Valor
Valores aceitos: Linux, Windows
--performance-plus

Defina esse sinalizador como true para obter um aumento no destino de desempenho do disco implantado. Esse sinalizador só pode ser definido na hora de criação do disco e não pode ser desabilitado depois de habilitado.

Propriedade Valor
Valores aceitos: false, true
--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.

Propriedade Valor
Valores aceitos: Disabled, Enabled
--secure-vm-disk-encryption-set

Nome ou ID do conjunto de criptografia de disco criado com o tipo de criptografia ConfidentialVmEncryptedWithCustomerKey.

--security-data-uri

Especifique o URI de blob do VHD a ser importado para o estado convidado da VM.

--security-metadata-uri

Especifique o URI do blob a ser importado para metadados de VM para VM Confidencial.

--security-option --supported-security-option

Consulte a funcionalidade de segurança do disco com suporte para criar uma VM confidencial ou inicialização confiável.

Propriedade Valor
Valores aceitos: TrustedLaunchAndConfidentialVMSupported, TrustedLaunchSupported
--security-type

O tipo de segurança da VM. Aplicável somente para discos do sistema operacional.

Propriedade Valor
Valores aceitos: ConfidentialVM_DiskEncryptedWithCustomerKey, ConfidentialVM_DiskEncryptedWithPlatformKey, ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey, Standard, TrustedLaunch
--size-gb -z

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

--sku

SKU de armazenamento subjacente.

Propriedade Valor
Valor padrão: Premium_LRS
Valores aceitos: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_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.

--support-hibernation

Indique que o sistema operacional em um disco dá suporte à hibernação.

Propriedade Valor
Valores aceitos: false, true
--tags

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

--tier

Camada de desempenho do disco (por exemplo, P4, S10), conforme descrito aqui: https://azure.microsoft.com/pricing/details/managed-disks/. Não se aplica a discos Ultra.

--upload-size-bytes

O tamanho (em bytes) do conteúdo do upload, incluindo o rodapé VHD. Valor mínimo: 20972032. Valor máximo: 35183298347520. Esse parâmetro será necessário se --upload-type for especificado.

--upload-type

Crie o disco para o cenário de upload. 'Upload' é apenas para upload de disco Standard. 'UploadWithSecurityData' é para upload do disco do sistema operacional junto com o estado de convidado da VM. Observe que 'UploadWithSecurityData' não é válido para upload de disco de dados, ele só deve ser usado para upload do disco do sistema operacional no momento.

Propriedade Valor
Valores aceitos: Upload, UploadWithSecurityData
--zone

Zona de disponibilidade na qual provisionar o recurso.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az disk delete

Excluir um disco gerenciado.

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

Exemplos

Excluir um disco gerenciado.

az disk delete --name MyManagedDisk --resource-group MyResourceGroup

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é 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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az disk grant-access

Conceda a um recurso acesso a um disco gerenciado.

az disk grant-access --duration-in-seconds
                     [--access --access-level {None, Read, Write}]
                     [--disk-name --name]
                     [--ids]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--resource-group]
                     [--secure-vm-guest-state-sas {0, 1, f, false, n, no, t, true, y, yes}]
                     [--subscription]

Exemplos

Conceda a um recurso acesso de leitura a um disco gerenciado.

az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyManagedDisk --resource-group MyResourceGroup

Conceder a um recurso acesso de leitura a um disco para gerar SAS de acesso e SAS de acesso a dados de segurança

az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyDisk --resource-group MyResourceGroup --secure-vm-guest-state-sas

Parâmetros Exigidos

--duration-in-seconds

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

Propriedade Valor
Grupo de parâmetros: GrantAccessData Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--access --access-level

Nível de acesso.

Propriedade Valor
Grupo de parâmetros: GrantAccessData Arguments
Valor padrão: Read
Valores aceitos: None, Read, Write
--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é 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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--secure-vm-guest-state-sas -s

Obtenha SAS no disco gerenciado com o estado de convidado da VM. Ele será usado por padrão quando a opção de criação de disco for "secureOSUpload".

Propriedade Valor
Grupo de parâmetros: GrantAccessData Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az disk list

Listar discos gerenciados.

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

Parâmetros Exigidos

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

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

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az disk revoke-access

Revogar o acesso de leitura de um recurso a um disco gerenciado.

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

Exemplos

Revogar o acesso de leitura de um recurso a um disco gerenciado.

az disk revoke-access --ids $id

Revogar o acesso de leitura de um recurso a um disco gerenciado.

az disk revoke-access --name MyManagedDisk --resource-group MyResourceGroup

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é 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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az disk show

Obtenha informações sobre um disco.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é 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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az disk update

Atualize um disco gerenciado.

az disk update [--accelerated-network {0, 1, f, false, n, no, t, true, y, yes}]
               [--action-on-disk-delay {AutomaticReattach, None}]
               [--add]
               [--architecture {Arm64, x64}]
               [--bursting-enabled --enable-bursting {0, 1, f, false, n, no, t, true, y, yes}]
               [--data-access-auth-mode {AzureActiveDirectory, None}]
               [--disk-access]
               [--disk-encryption-set]
               [--disk-iops-read-only]
               [--disk-iops-read-write]
               [--disk-mbps-read-only]
               [--disk-mbps-read-write]
               [--disk-name --name]
               [--disk-size-gb --size-gb]
               [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
               [--ids]
               [--max-shares]
               [--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]
               [--security-option --supported-security-option {TrustedLaunchAndConfidentialVMSupported, TrustedLaunchSupported}]
               [--set]
               [--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--subscription]

Exemplos

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

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

Atualize um disco gerenciado.

az disk update --name MyManagedDisk --resource-group MyResourceGroup --size-gb 20

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Grupo de parâmetros: SupportedCapabilities Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--action-on-disk-delay

Determine como lidar com discos com E/S lenta.

Propriedade Valor
Grupo de parâmetros: AvailabilityPolicy Arguments
Valores aceitos: AutomaticReattach, None
--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>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--architecture

Arquitetura de CPU compatível com um disco do sistema operacional.

Propriedade Valor
Grupo de parâmetros: SupportedCapabilities Arguments
Valores aceitos: Arm64, x64
--bursting-enabled --enable-bursting

Habilite a intermitência sob demanda além da meta de desempenho provisionada do disco. O estouro sob demanda é desabilitado por padrão e não se aplica a discos Ultra.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--data-access-auth-mode

Especifique o modo de autenticação ao exportar ou carregar em um disco ou instantâneo.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: AzureActiveDirectory, None
--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.

--disk-iops-read-only

O número total de IOPS que serão permitidos em todas as VMs que montam o disco compartilhado como ReadOnly. Uma operação pode ser transferida entre 4k e 256 mil bytes.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--disk-iops-read-write

O número de IOPS permitido para este disco; somente configurável para discos UltraSSD. Uma operação pode ser transferida entre 4k e 256 mil bytes.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--disk-mbps-read-only

A taxa de transferência total (MBps) que será permitida em todas as VMs que montam o disco compartilhado como ReadOnly. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--disk-mbps-read-write

A largura de banda permitida para este disco; somente configurável para discos UltraSSD. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é 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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--disk-size-gb --size-gb -z

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--encryption-type

Tipo de criptografia.

Propriedade Valor
Grupo de parâmetros: Encryption Arguments
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.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--max-shares

O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. Valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--network-access-policy

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: AllowAll, AllowPrivate, DenyAll
--no-wait

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

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Disabled, Enabled
--remove

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--security-option --supported-security-option

Consulte a funcionalidade de segurança do disco com suporte para criar uma VM confidencial ou inicialização confiável.

Propriedade Valor
Grupo de parâmetros: SupportedCapabilities Arguments
Valores aceitos: TrustedLaunchAndConfidentialVMSupported, TrustedLaunchSupported
--set

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--sku

SKU de armazenamento subjacente.

Propriedade Valor
Valores aceitos: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az disk wait

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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
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'].

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é 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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False