Disks - Get

Serviço:: Compute

Versão da API:: 2023-10-02

Obtém informações sobre um disco.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
diskName	path	True	string	O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é criado. Os caracteres com suporte para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 caracteres.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Respostas

Nome	Tipo	Description
200 OK	Disk	OKEY

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Get information about a managed disk.

Solicitação de exemplo

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


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

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python disk_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.disks.get(
        resource_group_name="myResourceGroup",
        disk_name="myManagedDisk",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
if __name__ == "__main__":
    main()

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

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

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

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

Resposta de exemplo

Código de status:: 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"
}

Definições

Nome	Description
Architecture	Arquitetura de CPU compatível com um disco do sistema operacional.
CreationData	Dados usados ao criar um disco.
DataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.
Disk	Recurso de disco.
DiskCreateOption	Isso enumera as possíveis fontes da criação de um disco.
DiskSecurityProfile	Contém as informações relacionadas à segurança do recurso.
DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.
DiskSku	O nome do sku de discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.
DiskState	Isso enumera o estado possível do disco.
DiskStorageAccountTypes	O nome do sku.
Encryption	Criptografia em configurações de repouso para disco ou instantâneo
EncryptionSettingsCollection	Configurações de criptografia para disco ou instantâneo
EncryptionSettingsElement	Configurações de criptografia para um volume de disco.
EncryptionType	O tipo de chave usado para criptografar os dados do disco.
ExtendedLocation	O tipo complexo do local estendido.
ExtendedLocationTypes	O tipo do local estendido.
HyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.
ImageDiskReference	A imagem de origem usada para criar o disco.
KeyVaultAndKeyReference	A URL da Chave do Key Vault e a ID do cofre da KeK, KeK são opcionais e, quando fornecidas, são usadas para desembrulhar a encryptionKey
KeyVaultAndSecretReference	Url secreta do Key Vault e id do cofre da chave de criptografia
NetworkAccessPolicy	Política para acessar o disco por meio da rede.
OperatingSystemTypes	O tipo de sistema operacional.
PropertyUpdatesInProgress	Propriedades do disco para o qual a atualização está pendente.
ProvisionedBandwidthCopyOption	Se esse campo for definido em um instantâneo e createOption for CopyStart, o instantâneo será copiado em uma velocidade mais rápida.
PublicNetworkAccess	Política para controlar a exportação no disco.
PurchasePlan	Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.
ShareInfoElement
SourceVault	A ID do cofre é uma ID de recurso do Azure Resource Manager no formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Lista de recursos com suporte persistente no recurso de disco para uso de VM.

Architecture

Enumeração

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

Valor	Description
x64
Arm64

CreationData

Objeto

Dados usados ao criar um disco.

Nome	Tipo	Description
createOption	DiskCreateOption	Isso enumera as possíveis fontes da criação de um disco.
elasticSanResourceId	string	Obrigatório se createOption for CopyFromSanSnapshot. Essa é a ID do ARM do instantâneo de volume san elástico de origem.
galleryImageReference	ImageDiskReference	Necessário se for criado a partir de uma Imagem da Galeria. A id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será a ID do ARM da versão de imagem de galeria compartilhada da qual criar um disco.
imageReference	ImageDiskReference	Informações de origem do disco para pir ou imagens de usuário.
logicalSectorSize	integer (int32)	Tamanho do setor lógico em bytes para discos Ultra. Os valores com suporte são 512 ad 4096. 4096 é o padrão.
performancePlus	boolean	Defina esse sinalizador como true para obter um aumento no destino de desempenho do disco implantado, consulte aqui no respectivo destino de desempenho. Esse sinalizador só pode ser definido na hora de criação do disco e não pode ser desabilitado depois de habilitado.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	Se esse campo for definido em um instantâneo e createOption for CopyStart, o instantâneo será copiado em uma velocidade mais rápida.
securityDataUri	string	Se createOption for ImportSecure, esse será o URI de um blob a ser importado para o estado convidado da VM.
sourceResourceId	string	Se createOption for Copy, essa será a ID do ARM do instantâneo ou disco de origem.
sourceUniqueId	string	Se esse campo for definido, essa será a ID exclusiva que identifica a origem desse recurso.
sourceUri	string	Se createOption for Import, esse será o URI de um blob a ser importado para um disco gerenciado.
storageAccountId	string	Necessário se createOption for Import. O identificador do Azure Resource Manager da conta de armazenamento que contém o blob a ser importado como um disco.
uploadSizeBytes	integer (int64)	Se createOption for Upload, esse será o tamanho do conteúdo do upload, incluindo o rodapé do VHD. Esse valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 TiB + 512 bytes para o rodapé VHD).

DataAccessAuthMode

Enumeração

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

Valor	Description
AzureActiveDirectory	Quando a URL de exportação/upload é usada, o sistema verifica se o usuário tem uma identidade no Azure Active Directory e tem permissões necessárias para exportar/carregar os dados. Consulte aka.ms/DisksAzureADAuth.
None	Nenhuma autenticação adicional seria executada ao acessar a URL de exportação/upload.

Disk

Objeto

Recurso de disco.

Nome	Tipo	Description
extendedLocation	ExtendedLocation	O local estendido onde o disco será criado. O local estendido não pode ser alterado.
id	string	ID do recurso
location	string	Local do recurso
managedBy	string	Um URI relativo que contém a ID da VM que tem o disco anexado.
managedByExtended	string[]	Lista de URIs relativas que contêm as IDs das VMs que têm o disco anexado. maxShares deve ser definido como um valor maior que um para discos para permitir anexá-los a várias VMs.
name	string	Nome do recurso
properties.LastOwnershipUpdateTime	string (date-time)	A hora UTC em que o estado de propriedade do disco foi alterado pela última vez, ou seja, a hora em que o disco foi anexado ou desanexado pela última vez de uma VM ou a hora em que a VM à qual o disco foi anexado foi desalocada ou iniciada.
properties.burstingEnabled	boolean	Defina como true para habilitar a intermitência além do destino de desempenho provisionado do disco. O estouro está desabilitado por padrão. Não se aplica a discos Ultra.
properties.burstingEnabledTime	string (date-time)	Última vez em que o estouro foi habilitado pela última vez em um disco.
properties.completionPercent	number	Porcentagem concluída para a cópia em segundo plano quando um recurso é criado por meio da operação CopyStart.
properties.creationData	CreationData	Informações de origem do disco. As informações de CreationData não podem ser alteradas após a criação do disco.
properties.dataAccessAuthMode	DataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.
properties.diskAccessId	string	ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.
properties.diskIOPSReadOnly	integer (int64)	O número total de IOPS que serão permitidos em todas as VMs que montam o disco compartilhado como ReadOnly. Uma operação pode ser transferida entre 4k e 256 mil bytes.
properties.diskIOPSReadWrite	integer (int64)	O número de IOPS permitido para este disco; somente configurável para discos UltraSSD. Uma operação pode ser transferida entre 4k e 256 mil bytes.
properties.diskMBpsReadOnly	integer (int64)	A taxa de transferência total (MBps) que será permitida em todas as VMs que montam o disco compartilhado como ReadOnly. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.
properties.diskMBpsReadWrite	integer (int64)	A largura de banda permitida para este disco; somente configurável para discos UltraSSD. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.
properties.diskSizeBytes	integer (int64)	O tamanho do disco em bytes. Este campo é somente leitura.
properties.diskSizeGB	integer (int32)	Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do disco a ser criado. Se esse campo estiver presente para atualizações ou criação com outras opções, ele indicará um redimensionamento. Os redimensionamentos só serão permitidos se o disco não estiver anexado a uma VM em execução e só puderem aumentar o tamanho do disco.
properties.diskState	DiskState	O estado do disco.
properties.encryption	Encryption	A propriedade de criptografia pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	A coleção de configurações de criptografia usada para o Azure Disk Encryption pode conter várias configurações de criptografia por disco ou instantâneo.
properties.hyperVGeneration	HyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.
properties.maxShares	integer (int32)	O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. Valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.
properties.networkAccessPolicy	NetworkAccessPolicy	Política para acessar o disco por meio da rede.
properties.optimizedForFrequentAttach	boolean	Definir essa propriedade como true melhora a confiabilidade e o desempenho de discos de dados que são frequentemente (mais de 5 vezes por dia) desanexados de uma máquina virtual e anexados a outra. Essa propriedade não deve ser definida para discos que não são desanexados e anexados com frequência, pois faz com que os discos não se alinhem com o domínio de falha da máquina virtual.
properties.osType	OperatingSystemTypes	O tipo de sistema operacional.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Propriedades do disco para o qual a atualização está pendente.
properties.provisioningState	string	O estado de provisionamento de disco.
properties.publicNetworkAccess	PublicNetworkAccess	Política para controlar a exportação no disco.
properties.purchasePlan	PurchasePlan	Informações do plano de compra para a imagem da qual o disco do sistema operacional foi criado. Por exemplo: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Contém as informações relacionadas à segurança do recurso.
properties.shareInfo	ShareInfoElement[]	Detalhes da lista de todas as VMs que têm o disco anexado. maxShares deve ser definido como um valor maior que um para discos para permitir anexá-los a várias VMs.
properties.supportedCapabilities	SupportedCapabilities	Lista de recursos com suporte para a imagem da qual o disco do sistema operacional foi criado.
properties.supportsHibernation	boolean	Indica que o sistema operacional em um disco dá suporte à hibernação.
properties.tier	string	Camada de desempenho do disco (por exemplo, P4, S10), conforme descrito aqui: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Não se aplica a discos Ultra.
properties.timeCreated	string (date-time)	A hora em que o disco foi criado.
properties.uniqueId	string	Guid exclusivo identificando o recurso.
sku	DiskSku	O nome do sku de discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.
tags	object	Etiquetas de recursos
type	string	Tipo de recurso
zones	string[]	A lista de zonas lógicas para Disco.

DiskCreateOption

Enumeração

Isso enumera as possíveis fontes da criação de um disco.

Valor	Description
Empty	Crie um disco de dados vazio de um tamanho dado pelo diskSizeGB.
Attach	O disco será anexado a uma VM.
FromImage	Crie um novo disco a partir de uma imagem de plataforma especificada pela imageReference ou galleryImageReference fornecida.
Import	Crie um disco importando de um blob especificado por um sourceUri em uma conta de armazenamento especificada por storageAccountId.
Copy	Crie um novo disco ou instantâneo copiando de um disco ou instantâneo especificado pelo sourceResourceId especificado.
Restore	Crie um novo disco copiando de um ponto de recuperação de backup.
Upload	Crie um novo disco obtendo um token de gravação e usando-o para carregar diretamente o conteúdo do disco.
CopyStart	Crie um novo disco usando um processo de cópia profunda, em que a criação do recurso é considerada concluída somente depois que todos os dados tiverem sido copiados da origem.
ImportSecure	Semelhante à opção Importar criação. Criar uma nova VM de Inicialização Confiável ou disco com suporte de VM confidencial importando blob adicional para o estado de convidado da VM especificado por securityDataUri na conta de armazenamento especificada por storageAccountId
UploadPreparedSecure	Semelhante à opção Carregar criar. Criar uma nova VM de Inicialização Confiável ou disco com suporte para VM confidencial e carregar usando o token de gravação no estado de convidado do disco e da VM
CopyFromSanSnapshot	Criar um novo disco exportando do instantâneo de volume san elástico

DiskSecurityProfile

Objeto

Contém as informações relacionadas à segurança do recurso.

Nome	Tipo	Description
secureVMDiskEncryptionSetId	string	ResourceId do conjunto de criptografia de disco associado ao disco com suporte de VM confidencial criptografado com chave gerenciada pelo cliente
securityType	DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

DiskSecurityTypes

Enumeração

Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

Valor	Description
TrustedLaunch	O Trusted Launch fornece recursos de segurança, como inicialização segura e vTPM (Virtual Trusted Platform Module)
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Indica disco de VM confidencial com apenas o estado convidado da VM criptografado
ConfidentialVM_DiskEncryptedWithPlatformKey	Indica o disco de VM confidencial com o disco do sistema operacional e o estado convidado da VM criptografados com uma chave gerenciada da plataforma
ConfidentialVM_DiskEncryptedWithCustomerKey	Indica o disco de VM confidencial com o disco do sistema operacional e o estado de convidado da VM criptografados com uma chave gerenciada pelo cliente
ConfidentialVM_NonPersistedTPM	Indica disco de VM confidencial com um vTPM efêmero. O estado do vTPM não é mantido entre reinicializações de VM.

DiskSku

Objeto

O nome do sku de discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.

Nome	Tipo	Description
name	DiskStorageAccountTypes	O nome do sku.
tier	string	A camada de sku.

DiskState

Enumeração

Isso enumera o estado possível do disco.

Valor	Description
Unattached	O disco não está sendo usado e pode ser anexado a uma VM.
Attached	No momento, o disco está anexado a uma VM em execução.
Reserved	O disco é anexado a uma VM desalocada interrompida.
Frozen	O disco é anexado a uma VM que está em estado hibernado.
ActiveSAS	No momento, o disco tem um Uri de SAS ativo associado a ele.
ActiveSASFrozen	O disco é anexado a uma VM em estado hibernado e tem um URI DE SAS ativo associado a ele.
ReadyToUpload	Um disco está pronto para ser criado pelo upload solicitando um token de gravação.
ActiveUpload	Um disco é criado para upload e um token de gravação foi emitido para carregar nele.

DiskStorageAccountTypes

Enumeração

O nome do sku.

Valor	Description
Standard_LRS	Armazenamento com redundância local do HDD padrão. Melhor para backup, acesso não crítico e pouco frequente.
Premium_LRS	Armazenamento com redundância local do SSD Premium. Melhor para cargas de trabalho sensíveis à produção e ao desempenho.
StandardSSD_LRS	Armazenamento com redundância local do SSD Padrão. Melhor para servidores Web, aplicativos empresariais levemente usados e desenvolvimento/teste.
UltraSSD_LRS	Armazenamento com redundância local do Ultra SSD. Melhor para cargas de trabalho com uso intensivo de E/S, como SAP HANA, bancos de dados de camada superior (por exemplo, SQL, Oracle) e outras cargas de trabalho pesadas para transações.
Premium_ZRS	Armazenamento com redundância de zona SSD Premium. Melhor para as cargas de trabalho de produção que precisam de resiliência de armazenamento em relação a falhas de zona.
StandardSSD_ZRS	Armazenamento com redundância de zona SSD padrão. Melhor para servidores Web, aplicativos empresariais pouco usados e desenvolvimento/teste que precisam de resiliência de armazenamento contra falhas de zona.
PremiumV2_LRS	Armazenamento com redundância local do SSD premium v2. Melhor para cargas de trabalho de produção e sensíveis ao desempenho que exigem consistentemente baixa latência e alta IOPS e taxa de transferência.

Encryption

Objeto

Criptografia em configurações de repouso para disco ou instantâneo

Nome	Tipo	Description
diskEncryptionSetId	string	ResourceId do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.
type	EncryptionType	O tipo de chave usado para criptografar os dados do disco.

EncryptionSettingsCollection

Objeto

Configurações de criptografia para disco ou instantâneo

Nome	Tipo	Description
enabled	boolean	Defina esse sinalizador como true e forneça DiskEncryptionKey e KeyEncryptionKey opcional para habilitar a criptografia. Defina esse sinalizador como false e remova DiskEncryptionKey e KeyEncryptionKey para desabilitar a criptografia. Se EncryptionSettings for nulo no objeto de solicitação, as configurações existentes permanecerão inalteradas.
encryptionSettings	EncryptionSettingsElement[]	Uma coleção de configurações de criptografia, uma para cada volume de disco.
encryptionSettingsVersion	string	Descreve que tipo de criptografia é usado para os discos. Depois que esse campo for definido, ele não poderá ser substituído. '1.0' corresponde ao Azure Disk Encryption com o aplicativo AAD.'1.1' corresponde ao Azure Disk Encryption.

EncryptionSettingsElement

Objeto

Configurações de criptografia para um volume de disco.

Nome	Tipo	Description
diskEncryptionKey	KeyVaultAndSecretReference	Url secreta do Key Vault e id do cofre da chave de criptografia de disco
keyEncryptionKey	KeyVaultAndKeyReference	Url da Chave do Key Vault e id do cofre da chave de criptografia de chave. KeyEncryptionKey é opcional e quando fornecido é usado para desembrulhar a chave de criptografia de disco.

EncryptionType

Enumeração

O tipo de chave usado para criptografar os dados do disco.

Valor	Description
EncryptionAtRestWithPlatformKey	O disco é criptografado em repouso com a chave gerenciada da plataforma. É o tipo de criptografia padrão. Esse não é um tipo de criptografia válido para conjuntos de criptografia de disco.
EncryptionAtRestWithCustomerKey	O disco é criptografado em repouso com a chave gerenciada pelo cliente que pode ser alterada e revogada por um cliente.
EncryptionAtRestWithPlatformAndCustomerKeys	O disco é criptografado em repouso com duas camadas de criptografia. Uma das chaves é gerenciada pelo cliente e a outra chave é gerenciada pela plataforma.

ExtendedLocation

Objeto

O tipo complexo do local estendido.

Nome	Tipo	Description
name	string	O nome do local estendido.
type	ExtendedLocationTypes	O tipo do local estendido.

ExtendedLocationTypes

Enumeração

O tipo do local estendido.

Valor	Description
EdgeZone

HyperVGeneration

Enumeração

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

Valor	Description
V1
V2

ImageDiskReference

Objeto

A imagem de origem usada para criar o disco.

Nome	Tipo	Description
communityGalleryImageId	string	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.
id	string	Um uri relativo que contém um Repositório de Imagens de Plataforma, uma imagem de usuário ou uma referência de imagem da Galeria de Computação do Azure.
lun	integer (int32)	Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem será usado. Para discos do sistema operacional, esse campo é nulo.
sharedGalleryImageId	string	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure compartilhada direta.

KeyVaultAndKeyReference

Objeto

A URL da Chave do Key Vault e a ID do cofre da KeK, KeK são opcionais e, quando fornecidas, são usadas para desembrulhar a encryptionKey

Nome	Tipo	Description
keyUrl	string	Url apontando para uma chave ou segredo no KeyVault
sourceVault	SourceVault	ID do recurso do KeyVault que contém a chave ou o segredo

KeyVaultAndSecretReference

Objeto

Url secreta do Key Vault e id do cofre da chave de criptografia

Nome	Tipo	Description
secretUrl	string	Url apontando para uma chave ou segredo no KeyVault
sourceVault	SourceVault	ID do recurso do KeyVault que contém a chave ou o segredo

NetworkAccessPolicy

Enumeração

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

Valor	Description
AllowAll	O disco pode ser exportado ou carregado de qualquer rede.
AllowPrivate	O disco pode ser exportado ou carregado para usar os pontos de extremidade privados de um recurso DiskAccess.
DenyAll	O disco não pode ser exportado.

OperatingSystemTypes

Enumeração

O tipo de sistema operacional.

Valor	Description
Windows
Linux

PropertyUpdatesInProgress

Objeto

Propriedades do disco para o qual a atualização está pendente.

Nome	Tipo	Description
targetTier	string	A camada de desempenho de destino do disco se uma operação de alteração de camada estiver em andamento.

ProvisionedBandwidthCopyOption

Enumeração

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

Valor	Description
None
Enhanced

PublicNetworkAccess

Enumeração

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

Valor	Description
Enabled	Você pode gerar um URI SAS para acessar os dados subjacentes do disco publicamente na Internet quando NetworkAccessPolicy estiver definido como AllowAll. Você pode acessar os dados por meio do URI sas somente da sua VNET confiável do Azure quando NetworkAccessPolicy estiver definido como AllowPrivate.
Disabled	Você não pode acessar os dados subjacentes do disco publicamente na Internet, mesmo quando NetworkAccessPolicy está definido como AllowAll. Você pode acessar os dados por meio do URI sas somente da sua VNET confiável do Azure quando NetworkAccessPolicy estiver definido como AllowPrivate.

PurchasePlan

Objeto

Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.

Nome	Tipo	Description
name	string	A ID do plano.
product	string	Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference.
promotionCode	string	O código de promoção da oferta.
publisher	string	A ID do editor.

ShareInfoElement

Objeto

Nome	Tipo	Description
vmUri	string	Um URI relativo que contém a ID da VM que tem o disco anexado.

SourceVault

Objeto

A ID do cofre é uma ID de recurso do Azure Resource Manager no formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Nome	Tipo	Description
id	string	ID do recurso

SupportedCapabilities

Objeto

Lista de recursos com suporte persistente no recurso de disco para uso de VM.

Nome	Tipo	Description
acceleratedNetwork	boolean	True se a imagem da qual o disco do sistema operacional é criado dá suporte à rede acelerada.
architecture	Architecture	Arquitetura de CPU compatível com um disco do sistema operacional.
diskControllerTypes	string	Os controladores de disco compatíveis com um disco do sistema operacional. Se ele puder ser SCSI ou SCSI, NVME ou NVME, SCSI.