Disks - Get

Servicio:

Compute

Versión de la API:

2023-10-02

Obtiene información sobre un disco.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/disks/{diskName}?api-version=2023-10-02

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
diskName	path	True	string	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.
resourceGroupName	path	True	string	Nombre del grupo de recursos.
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version	query	True	string	Versión de api de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	Disk	Aceptar

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Get information about a managed disk.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk?api-version=2023-10-02

Java

/**
 * Samples for Disks GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.
     * json
     */
    /**
     * Sample code: Get information about a managed disk.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getInformationAboutAManagedDisk(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDisks().getByResourceGroupWithResponse("myResourceGroup",
            "myManagedDisk", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/81a4ee5a83ae38620c0e1404793caffe005d26e4/specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
func ExampleDisksClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewDisksClient().Get(ctx, "myResourceGroup", "myManagedDisk", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Disk = armcompute.Disk{
	// 	Name: to.Ptr("myManagedDisk"),
	// 	Type: to.Ptr("Microsoft.Compute/disks"),
	// 	ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"department": to.Ptr("Development"),
	// 		"project": to.Ptr("ManagedDisks"),
	// 	},
	// 	ManagedBy: to.Ptr("/subscriptions/123caaa-123v-v211-a49f-f88ccac5bf88/resourceGroups/ResourceGroupName/providers/Microsoft.Compute/virtualMachines/TestVM414689371c88843d65ec"),
	// 	Properties: &armcompute.DiskProperties{
	// 		LastOwnershipUpdateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2016-12-28T04:41:35.079Z"); return t}()),
	// 		CreationData: &armcompute.CreationData{
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionFromImage),
	// 			ImageReference: &armcompute.ImageDiskReference{
	// 				ID: to.Ptr("/Subscriptions/{subscription-id}/Providers/Microsoft.Compute/Locations/westus/Publishers/test_test_pmc2pc1/ArtifactTypes/VMImage/Offers/marketplace_vm_test/Skus/test_sku/Versions/1.0.0"),
	// 			},
	// 		},
	// 		DiskSizeGB: to.Ptr[int32](10),
	// 		Encryption: &armcompute.Encryption{
	// 			Type: to.Ptr(armcompute.EncryptionTypeEncryptionAtRestWithPlatformKey),
	// 		},
	// 		EncryptionSettingsCollection: &armcompute.EncryptionSettingsCollection{
	// 			Enabled: to.Ptr(true),
	// 			EncryptionSettings: []*armcompute.EncryptionSettingsElement{
	// 				{
	// 					DiskEncryptionKey: &armcompute.KeyVaultAndSecretReference{
	// 						SecretURL: to.Ptr("https://myvmvault.vault-int.azure-int.net/secrets/{secret}"),
	// 						SourceVault: &armcompute.SourceVault{
	// 							ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"),
	// 						},
	// 					},
	// 					KeyEncryptionKey: &armcompute.KeyVaultAndKeyReference{
	// 						KeyURL: to.Ptr("https://myvmvault.vault-int.azure-int.net/keys/{key}"),
	// 						SourceVault: &armcompute.SourceVault{
	// 							ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"),
	// 						},
	// 					},
	// 			}},
	// 		},
	// 		HyperVGeneration: to.Ptr(armcompute.HyperVGenerationV1),
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		PurchasePlan: &armcompute.DiskPurchasePlan{
	// 			Name: to.Ptr("test_sku"),
	// 			Product: to.Ptr("marketplace_vm_test"),
	// 			Publisher: to.Ptr("test_test_pmc2pc1"),
	// 		},
	// 		SecurityProfile: &armcompute.DiskSecurityProfile{
	// 			SecurityType: to.Ptr(armcompute.DiskSecurityTypesTrustedLaunch),
	// 		},
	// 		SupportedCapabilities: &armcompute.SupportedCapabilities{
	// 			AcceleratedNetwork: to.Ptr(true),
	// 		},
	// 		SupportsHibernation: to.Ptr(true),
	// 		TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2016-12-28T04:41:35.079Z"); return t}()),
	// 	},
	// 	SKU: &armcompute.DiskSKU{
	// 		Name: to.Ptr(armcompute.DiskStorageAccountTypesStandardLRS),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets information about a disk.
 *
 * @summary Gets information about a disk.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
 */
async function getInformationAboutAManagedDisk() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const diskName = "myManagedDisk";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.disks.get(resourceGroupName, diskName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
// this example is just showing the usage of "Disks_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedDiskResource created on azure
// for more information of creating ManagedDiskResource, please refer to the document of ManagedDiskResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string diskName = "myManagedDisk";
ResourceIdentifier managedDiskResourceId = ManagedDiskResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, diskName);
ManagedDiskResource managedDisk = client.GetManagedDiskResource(managedDiskResourceId);

// invoke the operation
ManagedDiskResource result = await managedDisk.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedDiskData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "managedBy": "/subscriptions/123caaa-123v-v211-a49f-f88ccac5bf88/resourceGroups/ResourceGroupName/providers/Microsoft.Compute/virtualMachines/TestVM414689371c88843d65ec",
  "sku": {
    "name": "Standard_LRS"
  },
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "test_sku",
      "publisher": "test_test_pmc2pc1",
      "product": "marketplace_vm_test"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "supportsHibernation": true,
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscription-id}/Providers/Microsoft.Compute/Locations/westus/Publishers/test_test_pmc2pc1/ArtifactTypes/VMImage/Offers/marketplace_vm_test/Skus/test_sku/Versions/1.0.0"
      }
    },
    "diskSizeGB": 10,
    "encryptionSettingsCollection": {
      "enabled": true,
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "sourceVault": {
              "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"
            },
            "secretUrl": "https://myvmvault.vault-int.azure-int.net/secrets/{secret}"
          },
          "keyEncryptionKey": {
            "sourceVault": {
              "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"
            },
            "keyUrl": "https://myvmvault.vault-int.azure-int.net/keys/{key}"
          }
        }
      ]
    },
    "encryption": {
      "type": "EncryptionAtRestWithPlatformKey"
    },
    "LastOwnershipUpdateTime": "2016-12-28T04:41:35.079872+00:00",
    "timeCreated": "2016-12-28T04:41:35.079872+00:00",
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Compute/disks",
  "location": "westus",
  "tags": {
    "department": "Development",
    "project": "ManagedDisks"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk",
  "name": "myManagedDisk"
}

Definiciones

Nombre	Description
Architecture	Arquitectura de CPU compatible con un disco del sistema operativo.
CreationData	Datos usados al crear un disco.
DataAccessAuthMode	Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.
Disk	Recurso de disco.
DiskCreateOption	Esto enumera los posibles orígenes de la creación de un disco.
DiskSecurityProfile	Contiene la información relacionada con la seguridad del recurso.
DiskSecurityTypes	Especifica el SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.
DiskSku	Nombre de SKU de discos. Puede ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.
DiskState	Esto enumera el estado posible del disco.
DiskStorageAccountTypes	Nombre de la SKU.
Encryption	Configuración de cifrado en reposo para el disco o la instantánea
EncryptionSettingsCollection	Configuración de cifrado para disco o instantánea
EncryptionSettingsElement	Configuración de cifrado para un volumen de disco.
EncryptionType	Tipo de clave que se usa para cifrar los datos del disco.
ExtendedLocation	Tipo complejo de la ubicación extendida.
ExtendedLocationTypes	Tipo de la ubicación extendida.
HyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.
ImageDiskReference	Imagen de origen que se usa para crear el disco.
KeyVaultAndKeyReference	Key Vault dirección URL de la clave y el identificador del almacén de KeK, KeK es opcional y, cuando se proporciona, se usa para desencapsular encryptionKey.
KeyVaultAndSecretReference	Key Vault identificador de almacén y dirección URL del secreto de la clave de cifrado
NetworkAccessPolicy	Directiva para acceder al disco a través de la red.
OperatingSystemTypes	Tipo de sistema operativo.
PropertyUpdatesInProgress	Propiedades del disco para el que está pendiente la actualización.
ProvisionedBandwidthCopyOption	Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.
PublicNetworkAccess	Directiva para controlar la exportación en el disco.
PurchasePlan	Se usa para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.
ShareInfoElement
SourceVault	El identificador del almacén es un identificador de recurso de Azure Resource Manager con el formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Lista de funcionalidades admitidas que se conservan en el recurso de disco para el uso de la máquina virtual.

Architecture

Arquitectura de CPU compatible con un disco del sistema operativo.

Nombre	Tipo	Description
Arm64	string
x64	string

CreationData

Datos usados al crear un disco.

Nombre	Tipo	Description
createOption	DiskCreateOption	Esto enumera los posibles orígenes de la creación de un disco.
elasticSanResourceId	string	Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador de ARM de la instantánea de volumen elástico de origen san.
galleryImageReference	ImageDiskReference	Obligatorio si se crea desde una imagen de la galería. Id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de imagen de galley compartida desde la que se va a crear un disco.
imageReference	ImageDiskReference	Información de origen del disco para imágenes PIR o de usuario.
logicalSectorSize	integer	Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 y 4096. El valor predeterminado es 4096.
performancePlus	boolean	Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado, consulte aquí en el destino de rendimiento correspondiente. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.
securityDataUri	string	Si createOption es ImportSecure, este es el URI de un blob que se va a importar en el estado de invitado de la máquina virtual.
sourceResourceId	string	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.
sourceUniqueId	string	Si se establece este campo, este es el identificador único que identifica el origen de este recurso.
sourceUri	string	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.
storageAccountId	string	Obligatorio si createOption es Import. El identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como disco.
uploadSizeBytes	integer	Si createOption es Upload, este es el tamaño del contenido de la carga, incluido el pie de página del disco duro virtual. Este valor debe estar entre 20972032 (20 MiB + 512 bytes para el pie de página de VHD) y 35183298347520 bytes (32 TiB + 512 bytes para el pie de página VHD).

DataAccessAuthMode

Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.

Nombre	Tipo	Description
AzureActiveDirectory	string	Cuando se usa la dirección URL de exportación o carga, el sistema comprueba si el usuario tiene una identidad en Azure Active Directory y posee los permisos necesarios para exportar o cargar los datos. Consulte aka.ms/DisksAzureADAuth.
None	string	No se realizaría ninguna autenticación adicional al acceder a la dirección URL de exportación o carga.

Disk

Recurso de disco.

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	Ubicación extendida donde se creará el disco. No se puede cambiar la ubicación extendida.
id	string	Id. de recurso
location	string	Ubicación de los recursos
managedBy	string	Un URI relativo que contiene el identificador de la máquina virtual que tiene el disco conectado.
managedByExtended	string[]	Lista de URI relativos que contienen los identificadores de las máquinas virtuales que tienen el disco conectado. maxShares debe establecerse en un valor mayor que uno para que los discos puedan asociarlos a varias máquinas virtuales.
name	string	Nombre del recurso
properties.LastOwnershipUpdateTime	string	La hora UTC en la que se cambió por última vez el estado de propiedad del disco, es decir, la hora en que se adjuntó o desasoció por última vez el disco de una máquina virtual o la hora en que se desasignó o inició la máquina virtual a la que se adjuntó el disco.
properties.burstingEnabled	boolean	Establézcalo en true para habilitar la expansión más allá del destino de rendimiento aprovisionado del disco. La expansión está deshabilitada de manera predeterminada. No se aplica a los discos Ultra.
properties.burstingEnabledTime	string	Hora más reciente en la que la expansión se habilitó por última vez en un disco.
properties.completionPercent	number	Porcentaje completado para la copia en segundo plano cuando se crea un recurso mediante la operación CopyStart.
properties.creationData	CreationData	Información de origen del disco. La información de CreationData no se puede cambiar una vez creado el disco.
properties.dataAccessAuthMode	DataAccessAuthMode	Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.
properties.diskAccessId	string	Identificador de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.
properties.diskIOPSReadOnly	integer	Número total de IOPS que se permitirán en todas las máquinas virtuales que monten el disco compartido como ReadOnly. Una operación puede transferir entre 4k y 256k bytes.
properties.diskIOPSReadWrite	integer	Número de IOPS permitidos para este disco; solo se puede establecer para discos UltraSSD. Una operación puede transferir entre 4k y 256k bytes.
properties.diskMBpsReadOnly	integer	Rendimiento total (MBps) que se permitirá en todas las máquinas virtuales que monten el disco compartido como ReadOnly. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.
properties.diskMBpsReadWrite	integer	Ancho de banda permitido para este disco; solo se puede establecer para discos UltraSSD. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.
properties.diskSizeBytes	integer	Tamaño del disco en bytes. Este campo es de solo lectura.
properties.diskSizeGB	integer	Si creationData.createOption es Empty, este campo es obligatorio e indica el tamaño del disco que se va a crear. Si este campo está presente para las actualizaciones o la creación con otras opciones, indica un cambio de tamaño. Solo se permiten cambios de tamaño si el disco no está conectado a una máquina virtual en ejecución y solo puede aumentar el tamaño del disco.
properties.diskState	DiskState	Estado del disco.
properties.encryption	Encryption	La propiedad de cifrado se puede usar para cifrar los datos en reposo con claves administradas por el cliente o claves administradas por la plataforma.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	La recopilación de configuración de cifrado usada para Azure Disk Encryption puede contener varias opciones de cifrado por disco o instantánea.
properties.hyperVGeneration	HyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.
properties.maxShares	integer	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.
properties.networkAccessPolicy	NetworkAccessPolicy	Directiva para acceder al disco a través de la red.
properties.optimizedForFrequentAttach	boolean	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 conectados a otro. 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.
properties.osType	OperatingSystemTypes	Tipo de sistema operativo.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Propiedades del disco para el que está pendiente la actualización.
properties.provisioningState	string	Estado de aprovisionamiento de disco.
properties.publicNetworkAccess	PublicNetworkAccess	Directiva para controlar la exportación en el disco.
properties.purchasePlan	PurchasePlan	Información del plan de compra para la imagen desde la que se creó el disco del sistema operativo. Por ejemplo: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Contiene la información relacionada con la seguridad del recurso.
properties.shareInfo	ShareInfoElement[]	Detalles de la lista de todas las máquinas virtuales que tienen el disco conectado. maxShares debe establecerse en un valor mayor que uno para que los discos puedan asociarlos a varias máquinas virtuales.
properties.supportedCapabilities	SupportedCapabilities	Lista de funcionalidades admitidas para la imagen desde la que se creó el disco del sistema operativo.
properties.supportsHibernation	boolean	Indica que el sistema operativo de un disco admite hibernación.
properties.tier	string	Nivel de rendimiento del disco (por ejemplo, P4, S10) como se describe aquí: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. No se aplica a los discos Ultra.
properties.timeCreated	string	Hora a la que se creó el disco.
properties.uniqueId	string	Guid único que identifica el recurso.
sku	DiskSku	Nombre de SKU de discos. Puede ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.
tags	object	Etiquetas del recurso
type	string	Tipo de recurso
zones	string[]	Lista de zonas lógicas para Disco.

DiskCreateOption

Esto enumera los posibles orígenes de la creación de un disco.

Nombre	Tipo	Description
Attach	string	El disco se conectará a una máquina virtual.
Copy	string	Cree un nuevo disco o una instantánea copiando desde un disco o una instantánea especificados por el sourceResourceId especificado.
CopyFromSanSnapshot	string	Creación de un disco mediante la exportación desde una instantánea de volumen elástica san
CopyStart	string	Cree un nuevo disco mediante un proceso de copia en profundidad, donde la creación de recursos se considera completa solo después de que se hayan copiado todos los datos del origen.
Empty	string	Cree un disco de datos vacío de un tamaño determinado por diskSizeGB.
FromImage	string	Cree un nuevo disco a partir de una imagen de plataforma especificada por la imagen especificada por imageReference o galleryImageReference.
Import	string	Cree un disco importando desde un blob especificado por un sourceUri en una cuenta de almacenamiento especificada por storageAccountId.
ImportSecure	string	Similar a la opción Importar creación. Cree una nueva máquina virtual de inicio seguro o un disco compatible con la máquina virtual confidencial importando blob adicional para el estado de invitado de la máquina virtual especificado por securityDataUri en la cuenta de almacenamiento especificada por storageAccountId.
Restore	string	Cree un nuevo disco copiando desde un punto de recuperación de copia de seguridad.
Upload	string	Cree un disco mediante la obtención de un token de escritura y su uso para cargar directamente el contenido del disco.
UploadPreparedSecure	string	Similar a la opción Cargar creación. Cree una nueva máquina virtual de inicio seguro o un disco compatible con la máquina virtual confidencial y cargue mediante el token de escritura en el disco y el estado de invitado de la máquina virtual.

DiskSecurityProfile

Contiene la información relacionada con la seguridad del recurso.

Nombre	Tipo	Description
secureVMDiskEncryptionSetId	string	ResourceId del conjunto de cifrado de disco asociado al disco compatible con la máquina virtual confidencial cifrado con la clave administrada por el cliente
securityType	DiskSecurityTypes	Especifica el SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.

DiskSecurityTypes

Especifica el SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.

Nombre	Tipo	Description
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Indica el disco de máquina virtual confidencial con el disco del sistema operativo y el estado de invitado de la máquina virtual cifrados con una clave administrada por el cliente.
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Indica el disco de máquina virtual confidencial con el disco del sistema operativo y el estado de invitado de la máquina virtual cifrados con una clave administrada por la plataforma.
ConfidentialVM_NonPersistedTPM	string	Indica el disco de máquina virtual confidencial con un vTPM efímero. El estado de vTPM no se conserva en los reinicios de la máquina virtual.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Indica el disco de máquina virtual confidencial con solo el estado de invitado de la máquina virtual cifrado.
TrustedLaunch	string	Inicio seguro proporciona características de seguridad como el arranque seguro y el módulo virtual de plataforma segura (vTPM)

DiskSku

Nombre de SKU de discos. Puede ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.

Nombre	Tipo	Description
name	DiskStorageAccountTypes	Nombre de la SKU.
tier	string	Nivel de SKU.

DiskState

Esto enumera el estado posible del disco.

Nombre	Tipo	Description
ActiveSAS	string	El disco tiene actualmente un URI de SAS activo asociado.
ActiveSASFrozen	string	El disco está conectado a una máquina virtual en estado de hibernación y tiene asociado un URI de SAS activo.
ActiveUpload	string	Se crea un disco para la carga y se ha emitido un token de escritura para cargarlo.
Attached	string	El disco está conectado actualmente a una máquina virtual en ejecución.
Frozen	string	El disco está conectado a una máquina virtual que está en estado hibernado.
ReadyToUpload	string	Un disco está listo para crearse mediante la carga solicitando un token de escritura.
Reserved	string	El disco está conectado a una máquina virtual desasignada detenida.
Unattached	string	El disco no se usa y se puede conectar a una máquina virtual.

DiskStorageAccountTypes

Nombre de la SKU.

Nombre	Tipo	Description
PremiumV2_LRS	string	Almacenamiento con redundancia local de SSD Prémium v2. Lo mejor para cargas de trabajo sensibles al rendimiento y producción que requieren de forma coherente una latencia baja y un alto rendimiento y IOPS.
Premium_LRS	string	Almacenamiento con redundancia local de SSD prémium. Recomendado para las cargas de trabajo de producción y que requieren un alto rendimiento.
Premium_ZRS	string	Almacenamiento con redundancia de zona SSD Premium. Mejor para las cargas de trabajo de producción que necesitan resistencia de almacenamiento frente a errores de zona.
StandardSSD_LRS	string	Almacenamiento con redundancia local de SSD estándar. Recomendado para servidores web, aplicaciones empresariales que se usan poco y para el desarrollo/pruebas.
StandardSSD_ZRS	string	Almacenamiento con redundancia de zona SSD estándar. Lo mejor para los servidores web, aplicaciones empresariales poco usadas y desarrollo/pruebas que necesitan resistencia de almacenamiento frente a errores de zona.
Standard_LRS	string	Almacenamiento con redundancia local de HDD estándar. Recomendado para el acceso poco frecuente, no crítico y para copias de seguridad.
UltraSSD_LRS	string	Almacenamiento con redundancia local ultra SSD. Es mejor para cargas de trabajo intensivas de E/S, como SAP HANA, bases de datos de nivel superior (por ejemplo, SQL, Oracle) y otras cargas de trabajo con muchas transacciones.

Encryption

Configuración de cifrado en reposo para el disco o la instantánea

Nombre	Tipo	Description
diskEncryptionSetId	string	ResourceId del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.
type	EncryptionType	Tipo de clave que se usa para cifrar los datos del disco.

EncryptionSettingsCollection

Configuración de cifrado para disco o instantánea

Nombre	Tipo	Description
enabled	boolean	Establezca esta marca en true y proporcione DiskEncryptionKey y keyEncryptionKey opcional para habilitar el cifrado. Establezca esta marca en false y quite DiskEncryptionKey y KeyEncryptionKey para deshabilitar el cifrado. Si EncryptionSettings es null en el objeto de solicitud, la configuración existente permanece sin cambios.
encryptionSettings	EncryptionSettingsElement[]	Colección de configuraciones de cifrado, una para cada volumen de disco.
encryptionSettingsVersion	string	Describe qué tipo de cifrado se usa para los discos. Una vez establecido este campo, no se puede sobrescribir. "1.0" corresponde a Azure Disk Encryption con la aplicación de AAD.'1.1' corresponde a Azure Disk Encryption.

EncryptionSettingsElement

Configuración de cifrado para un volumen de disco.

Nombre	Tipo	Description
diskEncryptionKey	KeyVaultAndSecretReference	Key Vault dirección URL secreta y el identificador del almacén de la clave de cifrado de disco
keyEncryptionKey	KeyVaultAndKeyReference	Key Vault la dirección URL de la clave y el identificador del almacén de la clave de cifrado de claves. KeyEncryptionKey es opcional y cuando se proporciona se usa para desencapsular la clave de cifrado de disco.

EncryptionType

Tipo de clave que se usa para cifrar los datos del disco.

Nombre	Tipo	Description
EncryptionAtRestWithCustomerKey	string	El disco se cifra en reposo con la clave administrada por el cliente que un cliente puede cambiar y revocar.
EncryptionAtRestWithPlatformAndCustomerKeys	string	El disco se cifra en reposo con 2 capas de cifrado. Una de las claves es Customer managed (Administrada por el cliente) y la otra clave es Platform managed (Administrada por la plataforma).
EncryptionAtRestWithPlatformKey	string	El disco se cifra en reposo con la clave administrada por la plataforma. Es el tipo de cifrado predeterminado. Este no es un tipo de cifrado válido para los conjuntos de cifrado de disco.

ExtendedLocation

Tipo complejo de la ubicación extendida.

Nombre	Tipo	Description
name	string	Nombre de la ubicación extendida.
type	ExtendedLocationTypes	Tipo de la ubicación extendida.

ExtendedLocationTypes

Tipo de la ubicación extendida.

Nombre	Tipo	Description
EdgeZone	string

HyperVGeneration

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

Nombre	Tipo	Description
V1	string
V2	string

ImageDiskReference

Imagen de origen que se usa para crear el disco.

Nombre	Tipo	Description
communityGalleryImageId	string	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.
id	string	Un URI relativo que contiene un repositorio de imágenes de plataforma, una imagen de usuario o una referencia de imagen de Azure Compute Gallery.
lun	integer	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.
sharedGalleryImageId	string	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery compartida directa.

KeyVaultAndKeyReference

Key Vault dirección URL de la clave y el identificador del almacén de KeK, KeK es opcional y, cuando se proporciona, se usa para desencapsular encryptionKey.

Nombre	Tipo	Description
keyUrl	string	Dirección URL que apunta a una clave o un secreto en KeyVault
sourceVault	SourceVault	Identificador de recurso del almacén de claves que contiene la clave o el secreto

KeyVaultAndSecretReference

Key Vault identificador de almacén y dirección URL del secreto de la clave de cifrado

Nombre	Tipo	Description
secretUrl	string	Dirección URL que apunta a una clave o un secreto en KeyVault
sourceVault	SourceVault	Identificador de recurso del almacén de claves que contiene la clave o el secreto

NetworkAccessPolicy

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

Nombre	Tipo	Description
AllowAll	string	El disco se puede exportar o cargar desde cualquier red.
AllowPrivate	string	El disco se puede exportar o cargar en mediante los puntos de conexión privados de un recurso DiskAccess.
DenyAll	string	No se puede exportar el disco.

OperatingSystemTypes

Tipo de sistema operativo.

Nombre	Tipo	Description
Linux	string
Windows	string

PropertyUpdatesInProgress

Propiedades del disco para el que está pendiente la actualización.

Nombre	Tipo	Description
targetTier	string	Nivel de rendimiento de destino del disco si hay una operación de cambio de nivel en curso.

ProvisionedBandwidthCopyOption

Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.

Nombre	Tipo	Description
Enhanced	string
None	string

PublicNetworkAccess

Directiva para controlar la exportación en el disco.

Nombre	Tipo	Description
Disabled	string	No se puede acceder a los datos subyacentes del disco públicamente en Internet, incluso cuando NetworkAccessPolicy está establecido en AllowAll. Puede acceder a los datos a través del URI de SAS solo desde la red virtual de Azure de confianza cuando NetworkAccessPolicy está establecido en AllowPrivate.
Enabled	string	Puede generar un URI de SAS para acceder a los datos subyacentes del disco públicamente en Internet cuando NetworkAccessPolicy está establecido en AllowAll. Puede acceder a los datos a través del URI de SAS solo desde la red virtual de Azure de confianza cuando NetworkAccessPolicy está establecido en AllowPrivate.

PurchasePlan

Se usa para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.

Nombre	Tipo	Description
name	string	Identificador del plan.
product	string	Especifica el producto de la imagen de Marketplace. Este es el mismo valor que Offer en el elemento imageReference.
promotionCode	string	El código de promoción de la oferta.
publisher	string	Identificador del publicador.

ShareInfoElement

Nombre	Tipo	Description
vmUri	string	Un URI relativo que contiene el identificador de la máquina virtual que tiene el disco conectado.

SourceVault

El identificador del almacén es un identificador de recurso de Azure Resource Manager con el formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Nombre	Tipo	Description
id	string	Id. de recurso

SupportedCapabilities

Lista de funcionalidades admitidas que se conservan en el recurso de disco para el uso de la máquina virtual.

Nombre	Tipo	Description
acceleratedNetwork	boolean	True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.
architecture	Architecture	Arquitectura de CPU compatible con un disco del sistema operativo.
diskControllerTypes	string	Controladores de disco que admite un disco del sistema operativo. Si se establece, puede ser SCSI o SCSI, NVME o NVME, SCSI.