Partilhar via

az disk

Gerencie os Discos Gerenciados do Azure.

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 tanto o disco do sistema operacional quanto 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 Geridos do Azure têm um tamanho máximo de 4095 GB. Para usar discos maiores que 4095 GB, use os Discos Gerenciados do Azure.

Comandos

Name Description Tipo Status
az disk config

Gerencie a configuração do disco.

 Core disponibilidade geral
az disk config update

Atualize a configuração do disco.

 Core disponibilidade geral
az disk create

Crie um disco gerenciado.

 Core disponibilidade geral
az disk delete

Exclua um disco gerenciado.

 Core disponibilidade geral
az disk grant-access

Conceda acesso a um recurso a um disco gerenciado.

 Core disponibilidade geral
az disk list

Listar discos gerenciados.

 Core disponibilidade geral
az disk revoke-access

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

 Core disponibilidade geral
az disk show

Obtenha informações sobre um disco.

 Core disponibilidade geral
az disk update

Atualize um disco gerenciado.

 Core disponibilidade geral
az disk wait

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

 Core disponibilidade geral

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

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 a partir da imagem.

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

Criar um disco a partir do disco do SO 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 a partir do disco do SO da versão mais recente numa 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 a partir do disco do SO de uma versão de imagem de galeria partilhada

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 SO de uma versão da 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 de 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 limitação de taxa de transferência total (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 conectadas 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 ao 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 de 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 do 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 Obrigatórios

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accelerated-network
Pré-visualizar

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

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

Determine como lidar com discos com E/S lenta.

Propriedade Valor
Valores aceites: AutomaticReattach
--architecture

Arquitetura de CPU.

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

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

Propriedade Valor
Valores aceites: 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 permitidas em todas as VMs que montam o disco compartilhado como Somente Leitura. Uma operação pode transferir entre 4k e 256k bytes.

--disk-iops-read-write

O número de IOPS permitido para este disco. Apenas configurável para discos UltraSSD. Uma operação pode transferir entre 4k e 256k 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 Somente leitura. 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 este disco. Apenas configurável para discos UltraSSD. MBps significa milhões de bytes por segundo com notação ISO de potências de 10.

--edge-zone

O nome da zona de borda.

--enable-bursting

Habilite o bursting sob demanda além do destino de desempenho provisionado do disco. O bursting sob demanda é desativado por padrão e não se aplica a discos Ultra.

Propriedade Valor
Valores aceites: false, true
--encryption-type

Tipo de encriptação. 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 aceites: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--gallery-image-reference

ID da versão da imagem Compute, Shared ou Community Gallery a partir 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, este é um índice que indica qual dos discos de dados na imagem deve ser usado. Para discos do SO, este campo é null.

--hyper-v-generation

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.

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

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

--image-reference-lun

Se o disco for criado a partir do disco de dados de uma imagem, este é um índice que indica qual dos discos de dados na imagem deve ser usado. Para discos do SO, este campo é null.

--___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 for especificado, o local será automaticamente definido como igual ao grupo de recursos.

--logical-sector-size

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

--max-shares

O número máximo de VMs que podem ser conectadas 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 aceder ao disco através da rede.

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

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: 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) separados de uma máquina virtual e conectados a outra. Essa propriedade não deve ser definida para discos que não são desanexados e anexados com freqüência, pois faz com que os discos não se alinhem com o domínio de falha da máquina virtual.

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

O tipo de sistema operacional do disco.

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

Defina esse sinalizador como true para obter um aumento no destino de desempenho do disco implantado. Este sinalizador só pode ser definido no tempo de criação do disco e não pode ser desativado depois de ativado.

Propriedade Valor
Valores aceites: false, true
--public-network-access
Pré-visualizar

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

Propriedade Valor
Valores aceites: 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 de blob a ser importado para metadados de VM para VM confidencial.

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

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

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

O tipo de segurança da VM. Aplicável apenas a discos do SO.

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

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

--sku

SKU de armazenamento subjacente.

Propriedade Valor
Default value: Premium_LRS
Valores aceites: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--source

Origem a partir da qual criar o disco/instantâneo, 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.

--support-hibernation

Indique que o SO num disco suporta a hibernação.

Propriedade Valor
Valores aceites: false, true
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags 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 carregamento, incluindo o rodapé VHD. Valor mínimo: 20972032. Valor máximo: 35183298347520. Este parâmetro é necessário se --upload-type for especificado.

--upload-type

Crie o disco para o cenário de carregamento. 'Upload' é apenas para upload de disco padrão. 'UploadWithSecurityData' destina-se ao carregamento do disco do SO juntamente com o estado convidado da VM. Por favor, note que o 'UploadWithSecurityData' não é válido para upload de disco de dados, ele só deve ser usado para upload de disco do sistema operacional no momento.

Propriedade Valor
Valores aceites: Upload, UploadWithSecurityData
--zone

Zona de disponibilidade na qual provisionar o recurso.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az disk delete

Exclua 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

Exclua um disco gerenciado.

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado após a criação do disco. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valores aceites: 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
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az disk grant-access

Conceda acesso a um recurso 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 acesso SAS e acesso a dados de segurança SAS

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

Parâmetros Obrigatórios

--duration-in-seconds

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

Propriedade Valor
Parameter group: GrantAccessData Arguments

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--access --access-level

Nível de acesso.

Propriedade Valor
Parameter group: GrantAccessData Arguments
Default value: Read
Valores aceites: None, Read, Write
--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado após a criação do disco. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valores aceites: 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
Parameter group: Resource Id Arguments
--secure-vm-guest-state-sas -s

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

Propriedade Valor
Parameter group: GrantAccessData Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az disk list

Listar discos gerenciados.

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

Parâmetros Obrigatórios

--resource-group -g

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group: Pagination Arguments
--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Propriedade Valor
Parameter group: Pagination Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado após a criação do disco. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valores aceites: 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
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az disk show

Obtenha informações sobre um disco.

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado após a criação do disco. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: 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
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accelerated-network
Pré-visualizar

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

Propriedade Valor
Parameter group: SupportedCapabilities Arguments
Valores aceites: 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
Parameter group: AvailabilityPolicy Arguments
Valores aceites: 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
Parameter group: Generic Update Arguments
--architecture

Arquitetura de CPU suportada por um disco do sistema operacional.

Propriedade Valor
Parameter group: SupportedCapabilities Arguments
Valores aceites: Arm64, x64
--bursting-enabled --enable-bursting

Habilite o bursting sob demanda além do destino de desempenho provisionado do disco. O bursting sob demanda é desativado por padrão e não se aplica a discos Ultra.

Propriedade Valor
Parameter group: Properties Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--data-access-auth-mode

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

Propriedade Valor
Parameter group: Properties Arguments
Valores aceites: 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 permitidas em todas as VMs que montam o disco compartilhado como Somente Leitura. Uma operação pode transferir entre 4k e 256k bytes.

Propriedade Valor
Parameter group: Properties Arguments
--disk-iops-read-write

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

Propriedade Valor
Parameter group: 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 Somente leitura. MBps significa milhões de bytes por segundo - MB aqui usa a notação ISO, de potências de 10.

Propriedade Valor
Parameter group: Properties Arguments
--disk-mbps-read-write

A largura de banda permitida para este disco; apenas 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
Parameter group: Properties Arguments
--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado após a criação do disco. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

Propriedade Valor
Parameter group: Resource Id Arguments
--disk-size-gb --size-gb -z

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

Propriedade Valor
Parameter group: Properties Arguments
--encryption-type

Tipo de encriptação.

Propriedade Valor
Parameter group: Encryption Arguments
Valores aceites: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

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

Propriedade Valor
Parameter group: Generic Update Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: Resource Id Arguments
--max-shares

O número máximo de VMs que podem ser conectadas 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
Parameter group: Properties Arguments
--network-access-policy

Política para aceder ao disco através da rede.

Propriedade Valor
Parameter group: Properties Arguments
Valores aceites: AllowAll, AllowPrivate, DenyAll
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--public-network-access
Pré-visualizar

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

Propriedade Valor
Parameter group: Properties Arguments
Valores aceites: Disabled, Enabled
--remove

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

Propriedade Valor
Parameter group: 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
Parameter group: Resource Id Arguments
--security-option --supported-security-option

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

Propriedade Valor
Parameter group: SupportedCapabilities Arguments
Valores aceites: TrustedLaunchAndConfidentialVMSupported, TrustedLaunchSupported
--set

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

Propriedade Valor
Parameter group: Generic Update Arguments
--sku

SKU de armazenamento subjacente.

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

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
--custom

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

Propriedade Valor
Parameter group: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
--disk-name --name -n

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado após a criação do disco. Os caracteres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.

Propriedade Valor
Parameter group: Resource Id Arguments
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: Resource Id Arguments
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: 30
--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: 3600
--updated

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

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False