az disk

  • Referencia

Administración de Azure Managed Disks.

Azure Virtual Machines usa discos como un lugar para almacenar un sistema operativo, aplicaciones y datos. Todas las máquinas virtuales de Azure tienen al menos dos discos: un disco del sistema operativo y un disco temporal. El disco del sistema operativo se crea a partir de una imagen y el disco del sistema operativo y la imagen son discos duros en realidad virtuales (VHD) almacenados en una cuenta de almacenamiento de Azure. Las máquinas virtuales también pueden tener uno o más discos de datos que también se almacenan en discos duros virtuales. Los discos de datos no administrados de Azure tienen un tamaño máximo de 4095 GB. Para usar discos de más de 4095 GB, use Azure Managed Disks.

Comandos

Nombre Description Tipo Estado
az disk create

Cree un disco administrado.

 Principal GA
az disk delete

Elimine un disco administrado.

 Principal GA
az disk grant-access

Conceda a un recurso acceso a un disco administrado.

 Principal GA
az disk list

Enumeración de discos administrados.

 Principal GA
az disk revoke-access

Revocar el acceso de lectura de un recurso a un disco administrado.

 Principal GA
az disk show

Obtenga información sobre un disco.

 Principal GA
az disk update

Actualice un disco administrado.

 Principal GA
az disk wait

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

 Principal GA

az disk create

Cree un disco administrado.

az disk create --name
               --resource-group
               [--accelerated-network {false, true}]
               [--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-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]

Ejemplos

Cree un disco administrado mediante la importación desde un URI de blob.

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

Cree un disco administrado vacío.

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

Cree un disco administrado vacío con la expansión habilitada.

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

Cree un disco administrado copiando un disco o una instantánea existentes.

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

Creación de un disco en una zona de disponibilidad en la región de "Este de EE. UU. 2"

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

Cree un disco a partir de la imagen.

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

Creación de un disco a partir del disco del sistema operativo de una versión de imagen de la galería de proceso

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

Creación de un disco a partir del disco del sistema operativo de la versión más reciente en una imagen de la galería de procesos

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

Creación de un disco a partir del disco del sistema operativo de una versión de imagen de la galería compartida

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

Creación de un disco desde el disco del sistema operativo de una versión de imagen de la galería de comunidad

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

Creación de un disco a partir del disco de datos de una imagen de la galería

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

Cree un disco con el número total de IOPS y la limitación de rendimiento 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

Cree un disco y especifique el número máximo de máquinas virtuales que se pueden conectar al disco al mismo tiempo.

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

Cree un disco y asócielo a un recurso de acceso a disco.

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

Cree un disco a partir del URI del blob para el VHD de estado de invitado de máquina virtual.

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

Cree un disco estándar para cargar blobs.

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

Cree un disco del sistema operativo para cargarlo junto con el estado de invitado de la máquina virtual.

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

Parámetros requeridos

--name -n

Nombre del disco administrado.

--resource-group -g

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

Parámetros opcionales

--accelerated-network
Vista previa

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

valores aceptados: false, true
--architecture

Arquitectura de CPU.

valores aceptados: Arm64, x64
--data-access-auth-mode

Especifique el modo de autenticación al exportar o cargar en un disco o instantánea.

valores aceptados: AzureActiveDirectory, None
--disk-access

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

--disk-encryption-set

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

--disk-iops-read-only

Número total de IOPS que se permitirán en todas las máquinas virtuales que montan el disco compartido como ReadOnly. Una operación puede transferir entre 4 000 y 256 000 bytes.

--disk-iops-read-write

Número de IOPS permitidos para este disco. Solo se puede establecer para discos UltraSSD. Una operación puede transferir entre 4 000 y 256 000 bytes.

--disk-mbps-read-only

Rendimiento total (MBps) que se permitirá en todas las máquinas virtuales que montan el disco compartido como ReadOnly. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.

--disk-mbps-read-write

Ancho de banda permitido para este disco. Solo se puede establecer para discos UltraSSD. MBps significa millones de bytes por segundo con notación ISO de potencias de 10.

--edge-zone

Nombre de la zona perimetral.

--enable-bursting

Habilite la expansión a petición más allá del destino de rendimiento aprovisionado del disco. La expansión a petición está deshabilitada de forma predeterminada y no se aplica a los discos Ultra.

valores aceptados: false, true
--encryption-type

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

valores aceptados: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--gallery-image-reference

Identificador de la versión de imagen Compute, Shared o Community Gallery desde la que se va a crear un disco. Para obtener más información sobre el formato válido, consulte el ejemplo de ayuda.

--gallery-image-reference-lun

Si el disco se crea a partir del disco de datos de una imagen, se trata de un índice que indica cuáles de los discos de datos de la imagen se van a usar. En el caso de los discos del sistema operativo, este campo es NULL.

--hyper-v-generation

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

valores aceptados: V1, V2
--image-reference

Identificador o URN (publisher:offer:sku:version) de la imagen desde la que se va a crear un disco.

--image-reference-lun

Si el disco se crea a partir del disco de datos de una imagen, se trata de un índice que indica cuáles de los discos de datos de la imagen se van a usar. En el caso de los discos del sistema operativo, este campo es NULL.

--location -l

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

--logical-sector-size

Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 y 4096. El valor predeterminado es 4096.

--max-shares

Número máximo de máquinas virtuales que se pueden conectar al disco al mismo tiempo. El valor mayor que uno indica un disco que se puede montar en varias máquinas virtuales al mismo tiempo.

--network-access-policy

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

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

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

valor predeterminado: False
--optimized-for-frequent-attach

Establecer esta propiedad en true mejora la confiabilidad y el rendimiento de los discos de datos que suelen (más de 5 veces al día) desasociados de una máquina virtual y conectadas a otra. Esta propiedad no debe establecerse para los discos que no están desasociados y conectados con frecuencia, ya que hace que los discos no se alineen con el dominio de error de la máquina virtual.

valores aceptados: false, true
--os-type

El tipo de sistema operativo del disco.

valores aceptados: Linux, Windows
--performance-plus

Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.

valores aceptados: false, true
--public-network-access
Vista previa

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

valores aceptados: Disabled, Enabled
--secure-vm-disk-encryption-set

Nombre o identificador del conjunto de cifrado de disco creado con el tipo de cifrado ConfidentialVmEncryptedWithCustomerKey.

--security-data-uri

Especifique el URI del blob del disco duro virtual que se va a importar en el estado de invitado de la máquina virtual.

--security-type

Tipo de seguridad de la máquina virtual. Solo se aplica a los discos del sistema operativo.

valores aceptados: ConfidentialVM_DiskEncryptedWithCustomerKey, ConfidentialVM_DiskEncryptedWithPlatformKey, ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey, Standard, TrustedLaunch
--size-gb -z

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

--sku

SKU de almacenamiento subyacente.

valores aceptados: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
valor predeterminado: Premium_LRS
--source

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

--source-storage-account-id

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

--support-hibernation

Indique que el sistema operativo de un disco admite la hibernación.

valores aceptados: false, true
--tags

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

--tier

Nivel de rendimiento del disco (por ejemplo, P4, S10) como se describe aquí: https://azure.microsoft.com/pricing/details/managed-disks/. No se aplica a discos Ultra.

--upload-size-bytes

Tamaño (en bytes) del contenido de la carga, incluido el pie de página del disco duro virtual. Valor mínimo: 20972032. Valor máximo: 35183298347520. Este parámetro es necesario si se especifica --upload-type.

--upload-type

Cree el disco para el escenario de carga. "Cargar" es solo para la carga de disco estándar. "UploadWithSecurityData" es para la carga del disco del sistema operativo junto con el estado de invitado de la máquina virtual. Tenga en cuenta que "UploadWithSecurityData" no es válido para la carga del disco de datos, solo se usará para la carga del disco del sistema operativo en la actualidad.

valores aceptados: Upload, UploadWithSecurityData
--zone

Zona de disponibilidad en la que se va a aprovisionar el recurso.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk delete

Elimine un disco administrado.

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

Ejemplos

Elimine un disco administrado.

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

Parámetros opcionales

--disk-name --name -n

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

--ids

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

--no-wait

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

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

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

--subscription

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

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk grant-access

Conceda a un recurso acceso a un disco administrado.

az disk grant-access --duration-in-seconds
                     [--access-level {Read, Write}]
                     [--ids]
                     [--name]
                     [--resource-group]
                     [--secure-vm-guest-state-sas]
                     [--subscription]

Ejemplos

Conceda a un recurso acceso de lectura a un disco administrado. (generado automáticamente)

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

Concesión de acceso de lectura de recursos a un disco para generar acceso saS y acceso a datos de seguridad SAS

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

Parámetros requeridos

--duration-in-seconds

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

Parámetros opcionales

--access-level

Nivel de acceso.

valores aceptados: Read, Write
valor predeterminado: Read
--ids

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

--name -n

Nombre del disco administrado.

--resource-group -g

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

--secure-vm-guest-state-sas -s

Obtenga SAS en el disco administrado con el estado de invitado de la máquina virtual. Se usará de forma predeterminada cuando la opción de creación del disco sea "secureOSUpload".

--subscription

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk list

Enumeración de discos administrados.

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

Parámetros opcionales

--max-items

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

--next-token

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

--resource-group -g

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk revoke-access

Revocar el acceso de lectura de un recurso a un disco administrado.

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

Ejemplos

Revocar el acceso de lectura de un recurso a un disco administrado.

az disk revoke-access --ids $id

Revocar el acceso de lectura de un recurso a un disco administrado.

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

Parámetros opcionales

--disk-name --name -n

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

--ids

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

--no-wait

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

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

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

--subscription

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk show

Obtenga información sobre un disco.

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

Parámetros opcionales

--disk-name --name -n

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

--ids

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

--resource-group -g

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

--subscription

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk update

Actualice un disco administrado.

az disk update [--accelerated-network {false, true}]
               [--add]
               [--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]
               [--enable-bursting {false, true}]
               [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
               [--force-string]
               [--ids]
               [--max-shares]
               [--name]
               [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
               [--no-wait]
               [--public-network-access {Disabled, Enabled}]
               [--remove]
               [--resource-group]
               [--set]
               [--size-gb]
               [--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--subscription]

Ejemplos

Actualice un disco administrado y asócielo a un recurso de acceso a disco.

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

Actualice un disco administrado. (generado automáticamente)

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

Parámetros opcionales

--accelerated-network
Vista previa

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

valores aceptados: false, true
--add

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

valor predeterminado: []
--architecture

Arquitectura de CPU.

valores aceptados: Arm64, x64
--data-access-auth-mode

Especifique el modo de autenticación al exportar o cargar en un disco o instantánea.

valores aceptados: AzureActiveDirectory, None
--disk-access

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

--disk-encryption-set

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

--disk-iops-read-only

Número total de IOPS que se permitirán en todas las máquinas virtuales que montan el disco compartido como ReadOnly. Una operación puede transferir entre 4 000 y 256 000 bytes.

--disk-iops-read-write

Número de IOPS permitidos para este disco. Solo se puede establecer para discos UltraSSD. Una operación puede transferir entre 4 000 y 256 000 bytes.

--disk-mbps-read-only

Rendimiento total (MBps) que se permitirá en todas las máquinas virtuales que montan el disco compartido como ReadOnly. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.

--disk-mbps-read-write

Ancho de banda permitido para este disco. Solo se puede establecer para discos UltraSSD. MBps significa millones de bytes por segundo con notación ISO de potencias de 10.

--enable-bursting

Habilite la expansión a petición más allá del destino de rendimiento aprovisionado del disco. La expansión a petición está deshabilitada de forma predeterminada y no se aplica a los discos Ultra.

valores aceptados: false, true
--encryption-type

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

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

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

valor predeterminado: False
--ids

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

--max-shares

Número máximo de máquinas virtuales que se pueden conectar al disco al mismo tiempo. El valor mayor que uno indica un disco que se puede montar en varias máquinas virtuales al mismo tiempo.

--name -n

Nombre del disco administrado.

--network-access-policy

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

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

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

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

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

valores aceptados: Disabled, Enabled
--remove

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

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

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

--set

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

valor predeterminado: []
--size-gb -z

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

--sku

SKU de almacenamiento subyacente.

valores aceptados: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--subscription

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az disk wait

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

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

Parámetros opcionales

--created

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

valor predeterminado: False
--custom

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

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--disk-name --name -n

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

--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--ids

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

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--resource-group -g

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

--subscription

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

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

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

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.