Disks - Get

Referência

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

Name	Em	Necessário	Tipo	Description
diskName	path	True	string	O nome do disco gerido que está a ser criado. O nome não pode ser alterado após a criação do disco. Os carateres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 carateres.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API de Cliente.

Respostas

Name	Tipo	Description
200 OK	Disk	OK

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Get information about a managed disk.

Pedido de amostra

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

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://video2.skills-academy.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 da amostra

Código de estado:: 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

Name	Description
Architecture	Arquitetura da CPU suportada por um disco do SO.
CreationData	Dados utilizados ao criar um disco.
DataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar para um disco ou instantâneo.
Disk	Recurso de disco.
DiskCreateOption	Isto enumera as possíveis origens da criação de um disco.
DiskSecurityProfile	Contém as informações relacionadas com a segurança do recurso.
DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável apenas a discos de SO.
DiskSku	O nome do SKU dos discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.
DiskState	Isto enumera o estado possível do disco.
DiskStorageAccountTypes	O nome do SKU.
Encryption	Definições de encriptação inativa para o disco ou instantâneo
EncryptionSettingsCollection	Definições de encriptação para o disco ou instantâneo
EncryptionSettingsElement	Definições de encriptação para um volume de disco.
EncryptionType	O tipo de chave utilizado para encriptar os dados do disco.
ExtendedLocation	O tipo complexo da localização expandida.
ExtendedLocationTypes	O tipo de localização expandida.
HyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO.
ImageDiskReference	A imagem de origem utilizada para criar o disco.
KeyVaultAndKeyReference	Key Vault Url de Chave e ID do cofre do KeK, o KeK é opcional e, quando fornecido, é utilizado para desembrulhar a encriptaçãoKey
KeyVaultAndSecretReference	Key Vault url secreto e id do cofre da chave de encriptação
NetworkAccessPolicy	Política para aceder ao disco através da rede.
OperatingSystemTypes	O tipo de Sistema Operativo.
PropertyUpdatesInProgress	Propriedades do disco para o qual a atualização está pendente.
ProvisionedBandwidthCopyOption	Se este campo estiver definido num instantâneo e createOption for CopyStart, o instantâneo será copiado a uma velocidade mais rápida.
PublicNetworkAccess	Política para controlar a exportação no disco.
PurchasePlan	Utilizado para estabelecer o contexto de compra de qualquer artefacto de terceiros através do MarketPlace.
ShareInfoElement
SourceVault	O ID do cofre é um ID de Recurso do Azure Resource Manager no formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Lista de capacidades suportadas mantidas no recurso de disco para utilização da VM.

Architecture

Arquitetura da CPU suportada por um disco do SO.

Name	Tipo	Description
Arm64	string
x64	string

CreationData

Dados utilizados ao criar um disco.

Name	Tipo	Description
createOption	DiskCreateOption	Isto enumera as possíveis origens da criação de um disco.
elasticSanResourceId	string	Necessário se createOption for CopyFromSanSnapshot. Este é o ID arm do instantâneo elástico san volume de origem.
galleryImageReference	ImageDiskReference	Necessário se criar a partir de uma Imagem da Galeria. O id/sharedGalleryImageId/communityGalleryImageId da ImageDiskReference será o ID do ARM da versão da imagem de cozinha partilhada a partir da qual criar um disco.
imageReference	ImageDiskReference	Informações de origem do disco para imagens PIR ou de utilizador.
logicalSectorSize	integer	Tamanho do setor lógico em bytes para discos Ultra. Os valores suportados são 512 ad 4096. 4096 é a predefinição.
performancePlus	boolean	Defina este sinalizador como verdadeiro para obter um aumento no destino de desempenho do disco implementado. Veja aqui o respetivo destino de desempenho. Este sinalizador só pode ser definido no tempo de criação do disco e não pode ser desativado depois de ativado.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	Se este campo estiver definido num instantâneo e createOption for CopyStart, o instantâneo será copiado a uma velocidade mais rápida.
securityDataUri	string	Se createOption for ImportSecure, este é o URI de um blob a ser importado para o estado de convidado da VM.
sourceResourceId	string	Se createOption for Copiar, este é o ID do ARM do instantâneo ou disco de origem.
sourceUniqueId	string	Se este campo estiver definido, este é o ID exclusivo que identifica a origem deste recurso.
sourceUri	string	Se createOption for Importar, este é o URI de um blob a ser importado para um disco gerido.
storageAccountId	string	Necessário se createOption for Importar. O identificador Resource Manager do Azure da conta de armazenamento que contém o blob a importar como um disco.
uploadSizeBytes	integer	Se createOption for Upload, este é o tamanho do conteúdo do carregamento, incluindo o rodapé VHD. Este valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 Bytes TiB + 512 para o rodapé VHD).

DataAccessAuthMode

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

Name	Tipo	Description
AzureActiveDirectory	string	Quando o URL de exportação/carregamento é utilizado, o sistema verifica se o utilizador tem uma identidade no Azure Active Directory e tem as permissões necessárias para exportar/carregar os dados. Veja aka.ms/DisksAzureADAuth.
None	string	Não seria efetuada qualquer autenticação adicional ao aceder ao URL de exportação/carregamento.

Disk

Recurso de disco.

Name	Tipo	Description
extendedLocation	ExtendedLocation	A localização expandida onde o disco será criado. Não é possível alterar a localização expandida.
id	string	ID do Recurso
location	string	Localização do recurso
managedBy	string	Um URI relativo que contém o ID da VM que tem o disco anexado.
managedByExtended	string[]	Lista de URIs relativos que contêm os IDs das VMs que têm o disco anexado. maxShares deve ser definido como um valor maior do que um para discos para permitir anexá-los a várias VMs.
name	string	Nome do recurso
properties.LastOwnershipUpdateTime	string	A hora UTC em que o estado de propriedade do disco foi alterado pela última vez, ou seja, a hora da última anexação ou desanexação do disco de uma VM ou a hora em que a VM à qual o disco foi anexado foi desalocada ou iniciada.
properties.burstingEnabled	boolean	Defina como verdadeiro para ativar a expansão para além do destino de desempenho aprovisionado do disco. A expansão está desativada por predefinição. Não se aplica a discos Ultra.
properties.burstingEnabledTime	string	Hora mais recente em que a expansão foi ativada pela última vez num disco.
properties.completionPercent	number	Percentagem concluída para a cópia em segundo plano quando um recurso é criado através da operação CopyStart.
properties.creationData	CreationData	Informações de origem do disco. CreationData information cannot be changed after the disk has been created.
properties.dataAccessAuthMode	DataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar para um disco ou instantâneo.
properties.diskAccessId	string	ID arm do recurso DiskAccess para utilizar pontos finais privados em discos.
properties.diskIOPSReadOnly	integer	O número total de IOPS que será permitido em todas as VMs que montam o disco partilhado como ReadOnly. Uma operação pode ser transferida entre 4k e 256 k bytes.
properties.diskIOPSReadWrite	integer	O número de IOPS permitido para este disco; apenas settable para discos UltraSSD. Uma operação pode ser transferida entre 4k e 256 k bytes.
properties.diskMBpsReadOnly	integer	O débito total (MBps) que será permitido em todas as VMs que montam o disco partilhado como ReadOnly. MBps significa milhões de bytes por segundo - MB aqui utiliza a notação ISO, de potências de 10.
properties.diskMBpsReadWrite	integer	A largura de banda permitida para este disco; apenas settable para discos UltraSSD. MBps significa milhões de bytes por segundo - MB aqui utiliza a notação ISO, de potências de 10.
properties.diskSizeBytes	integer	O tamanho do disco em bytes. Este campo é só de leitura.
properties.diskSizeGB	integer	Se creationData.createOption for Vazio, este campo é obrigatório e indica o tamanho do disco a criar. Se este campo estiver presente para atualizações ou criação com outras opções, indica um redimensionamento. Os redimensionamentos só são permitidos se o disco não estiver anexado a uma VM em execução e apenas pode aumentar o tamanho do disco.
properties.diskState	DiskState	O estado do disco.
properties.encryption	Encryption	A propriedade encriptação pode ser utilizada para encriptar dados inativos com chaves geridas pelo cliente ou chaves geridas pela plataforma.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	A coleção de definições de encriptação utilizada para o Azure Disk Encryption pode conter várias definições de encriptação por disco ou instantâneo.
properties.hyperVGeneration	HyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO.
properties.maxShares	integer	O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. Valor maior do que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.
properties.networkAccessPolicy	NetworkAccessPolicy	Política para aceder ao disco através da rede.
properties.optimizedForFrequentAttach	boolean	Definir esta propriedade como verdadeira melhora a fiabilidade e o desempenho dos discos de dados que são frequentemente (mais de 5 vezes por dia) ao desanexar de uma máquina virtual e anexar a outra. Esta propriedade não deve ser definida para discos que não são desanexados e anexados frequentemente, pois faz com que os discos não fiquem alinhados com o domínio de falha da máquina virtual.
properties.osType	OperatingSystemTypes	O tipo de Sistema Operativo.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Propriedades do disco para o qual a atualização está pendente.
properties.provisioningState	string	O estado de aprovisionamento do 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 a partir da qual o disco do SO foi criado. Por exemplo- {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Contém as informações relacionadas com a 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 do que um para discos para permitir anexá-los a várias VMs.
properties.supportedCapabilities	SupportedCapabilities	Lista de capacidades suportadas para a imagem a partir da qual o disco do SO foi criado.
properties.supportsHibernation	boolean	Indica que o SO num disco suporta hibernação.
properties.tier	string	Escalão 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	A hora em que o disco foi criado.
properties.uniqueId	string	Guid exclusivo que identifica o recurso.
sku	DiskSku	O nome do SKU dos 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 zona lógica para Disco.

DiskCreateOption

Isto enumera as possíveis origens da criação de um disco.

Name	Tipo	Description
Attach	string	O disco será anexado a uma VM.
Copy	string	Crie um novo disco ou instantâneo ao copiar de um disco ou instantâneo especificado pelo sourceResourceId especificado.
CopyFromSanSnapshot	string	Criar um novo disco ao exportar a partir de um instantâneo de volume san elástico
CopyStart	string	Crie um novo disco com um processo de cópia profunda, em que a criação do recurso é considerada concluída apenas depois de todos os dados terem sido copiados da origem.
Empty	string	Crie um disco de dados vazio de um tamanho fornecido por diskSizeGB.
FromImage	string	Crie um novo disco a partir de uma imagem de plataforma especificada pela imagem especificadaReferência ou galeriaImageReference.
Import	string	Crie um disco ao importar a partir de um blob especificado por um sourceUri numa conta de armazenamento especificada por storageAccountId.
ImportSecure	string	Semelhante à opção Importar criação. Crie uma nova VM de Iniciação Fidedigna ou um disco suportado por VM Confidencial ao importar blob adicional para o estado de convidado da VM especificado por securityDataUri na conta de armazenamento especificada por storageAccountId
Restore	string	Crie um novo disco ao copiar a partir de um ponto de recuperação de cópia de segurança.
Upload	string	Crie um novo disco ao obter um token de escrita e utilizá-lo para carregar diretamente o conteúdo do disco.
UploadPreparedSecure	string	Semelhante à opção Carregar criação. Criar uma nova VM de Iniciação Fidedigna ou um disco suportado pela VM Confidencial e carregar com o token de escrita no estado de convidado do disco e da VM

DiskSecurityProfile

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

Name	Tipo	Description
secureVMDiskEncryptionSetId	string	ResourceId do conjunto de encriptação de discos associado ao disco suportado pela VM Confidencial encriptado com a chave gerida pelo cliente
securityType	DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável apenas a discos de SO.

DiskSecurityTypes

Especifica o SecurityType da VM. Aplicável apenas a discos de SO.

Name	Tipo	Description
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Indica o disco da VM Confidencial com o disco do SO e o estado de convidado da VM encriptados com uma chave gerida pelo cliente
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Indica o disco da VM Confidencial com o disco do SO e o estado de convidado da VM encriptados com uma chave gerida pela plataforma
ConfidentialVM_NonPersistedTPM	string	Indica o disco de VM Confidencial com um vTPM efémero. O estado do vTPM não é mantido nos reinícios da VM.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Indica o disco da VM Confidencial com apenas o estado de convidado da VM encriptado
TrustedLaunch	string	A Iniciação Fidedigna fornece funcionalidades de segurança, como o arranque seguro e o Módulo de Plataforma Fidedigna virtual (vTPM)

DiskSku

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

Name	Tipo	Description
name	DiskStorageAccountTypes	O nome do SKU.
tier	string	O escalão de SKU.

DiskState

Isto enumera o estado possível do disco.

Name	Tipo	Description
ActiveSAS	string	O disco tem atualmente um Uri de SAS Ativo associado ao mesmo.
ActiveSASFrozen	string	O disco está ligado a uma VM em estado de hibernação e tem um URI de SAS ativo associado.
ActiveUpload	string	É criado um disco para carregamento e foi emitido um token de escrita para o carregamento para o mesmo.
Attached	string	O disco está atualmente anexado a uma VM em execução.
Frozen	string	O disco está ligado a uma VM que está em estado de hibernação.
ReadyToUpload	string	Um disco está pronto para ser criado através do carregamento ao pedir um token de escrita.
Reserved	string	O disco está anexado a uma VM parada desalocada.
Unattached	string	O disco não está a ser utilizado e pode ser anexado a uma VM.

DiskStorageAccountTypes

O nome do SKU.

Name	Tipo	Description
PremiumV2_LRS	string	Armazenamento SSD v2 localmente redundante Premium. Melhor para cargas de trabalho sensíveis ao desempenho e produção que exigem consistentemente baixa latência e IOPS e débito elevados.
Premium_LRS	string	Armazenamento localmente redundante SSD Premium. Melhor para cargas de trabalho sensíveis à produção e ao desempenho.
Premium_ZRS	string	Armazenamento com redundância entre zonas SSD Premium. Melhor para as cargas de trabalho de produção que precisam de resiliência de armazenamento contra falhas de zona.
StandardSSD_LRS	string	Armazenamento localmente redundante SSD Standard. Ideal para servidores Web, aplicações empresariais levemente utilizadas e desenvolvimento/teste.
StandardSSD_ZRS	string	Armazenamento com redundância entre zonas SSD Standard. Melhor para servidores Web, aplicações empresariais levemente utilizadas e desenvolvimento/teste que precisam de resiliência de armazenamento contra falhas de zona.
Standard_LRS	string	Armazenamento hdd localmente redundante standard. Melhor para acesso de cópia de segurança, não crítico e pouco frequente.
UltraSSD_LRS	string	Armazenamento ultra SSD localmente redundante. Ideal para cargas de trabalho intensivas de E/S, como SAP HANA, bases de dados de escalão superior (por exemplo, SQL, Oracle) e outras cargas de trabalho de transação intensiva.

Encryption

Definições de encriptação inativa para o disco ou instantâneo

Name	Tipo	Description
diskEncryptionSetId	string	ResourceId do conjunto de encriptação de discos a utilizar para ativar a encriptação inativa.
type	EncryptionType	O tipo de chave utilizado para encriptar os dados do disco.

EncryptionSettingsCollection

Definições de encriptação para o disco ou instantâneo

Name	Tipo	Description
enabled	boolean	Defina este sinalizador como verdadeiro e forneça DiskEncryptionKey e keyEncryptionKey opcional para ativar a encriptação. Defina este sinalizador como falso e remova DiskEncryptionKey e KeyEncryptionKey para desativar a encriptação. Se EncryptionSettings for nulo no objeto de pedido, as definições existentes permanecem inalteradas.
encryptionSettings	EncryptionSettingsElement[]	Uma coleção de definições de encriptação, uma para cada volume de disco.
encryptionSettingsVersion	string	Descreve que tipo de encriptação é utilizada para os discos. Uma vez definido este campo, não pode ser substituído. "1.0" corresponde ao Azure Disk Encryption com a aplicação AAD.'1.1' corresponde ao Azure Disk Encryption.

EncryptionSettingsElement

Definições de encriptação para um volume de disco.

Name	Tipo	Description
diskEncryptionKey	KeyVaultAndSecretReference	Key Vault o URL secreto e o ID do cofre da chave de encriptação do disco
keyEncryptionKey	KeyVaultAndKeyReference	Key Vault o URL da chave e o ID do cofre da chave de encriptação. KeyEncryptionKey é opcional e, quando fornecido, é utilizado para desembrulhar a chave de encriptação do disco.

EncryptionType

O tipo de chave utilizado para encriptar os dados do disco.

Name	Tipo	Description
EncryptionAtRestWithCustomerKey	string	O disco é encriptado inativo com a chave gerida pelo cliente que pode ser alterada e revogada por um cliente.
EncryptionAtRestWithPlatformAndCustomerKeys	string	O disco é encriptado inativo com 2 camadas de encriptação. Uma das chaves é Gerida pelo cliente e a outra é Gerida pela plataforma.
EncryptionAtRestWithPlatformKey	string	O disco é encriptado inativo com a chave gerida pela plataforma. É o tipo de encriptação predefinido. Este não é um tipo de encriptação válido para conjuntos de encriptação de discos.

ExtendedLocation

O tipo complexo da localização expandida.

Name	Tipo	Description
name	string	O nome da localização expandida.
type	ExtendedLocationTypes	O tipo de localização expandida.

ExtendedLocationTypes

O tipo de localização expandida.

Name	Tipo	Description
EdgeZone	string

HyperVGeneration

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

Name	Tipo	Description
V1	string
V2	string

ImageDiskReference

A imagem de origem utilizada para criar o disco.

Name	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 Imagem de Plataforma, uma imagem de utilizador ou uma referência de imagem da Galeria de Computação do Azure.
lun	integer	Se o disco for criado a partir do disco de dados de uma imagem, este é um índice que indica qual dos discos de dados na imagem utilizar. Para os discos do SO, este campo é nulo.
sharedGalleryImageId	string	Um URI relativo que contém uma referência de imagem da Galeria de Computação do Azure partilhada diretamente.

KeyVaultAndKeyReference

Key Vault Url de Chave e ID do cofre do KeK, o KeK é opcional e, quando fornecido, é utilizado para desembrulhar a encriptaçãoKey

Name	Tipo	Description
keyUrl	string	Url a apontar para uma chave ou segredo no KeyVault
sourceVault	SourceVault	ID de recurso do KeyVault que contém a chave ou segredo

KeyVaultAndSecretReference

Key Vault url secreto e id do cofre da chave de encriptação

Name	Tipo	Description
secretUrl	string	Url a apontar para uma chave ou segredo no KeyVault
sourceVault	SourceVault	ID de recurso do KeyVault que contém a chave ou segredo

NetworkAccessPolicy

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

Name	Tipo	Description
AllowAll	string	O disco pode ser exportado ou carregado para a partir de qualquer rede.
AllowPrivate	string	O disco pode ser exportado ou carregado para com os pontos finais privados de um recurso DiskAccess.
DenyAll	string	Não é possível exportar o disco.

OperatingSystemTypes

O tipo de Sistema Operativo.

Name	Tipo	Description
Linux	string
Windows	string

PropertyUpdatesInProgress

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

Name	Tipo	Description
targetTier	string	O escalão de desempenho de destino do disco se estiver em curso uma operação de alteração de escalão.

ProvisionedBandwidthCopyOption

Se este campo estiver definido num instantâneo e createOption for CopyStart, o instantâneo será copiado a uma velocidade mais rápida.

Name	Tipo	Description
Enhanced	string
None	string

PublicNetworkAccess

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

Name	Tipo	Description
Disabled	string	Não pode aceder publicamente aos dados subjacentes do disco na Internet, mesmo quando NetworkAccessPolicy está definido como PermitirTodos. Só pode aceder aos dados através do URI de SAS a partir da sua VNET do Azure fidedigna quando NetworkAccessPolicy estiver definido como AllowPrivate.
Enabled	string	Pode gerar um URI de SAS para aceder publicamente aos dados subjacentes do disco na Internet quando NetworkAccessPolicy estiver definido como AllowAll. Só pode aceder aos dados através do URI de SAS a partir da sua VNET do Azure fidedigna quando NetworkAccessPolicy estiver definido como AllowPrivate.

PurchasePlan

Utilizado para estabelecer o contexto de compra de qualquer artefacto de terceiros através do MarketPlace.

Name	Tipo	Description
name	string	O ID do plano.
product	string	Especifica o produto da imagem a partir do marketplace. Este é o mesmo valor que a Oferta no elemento imageReference.
promotionCode	string	O Código de Promoção da Oferta.
publisher	string	O ID do editor.

ShareInfoElement

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

SourceVault

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

Name	Tipo	Description
id	string	ID do Recurso

SupportedCapabilities

Lista de capacidades suportadas mantidas no recurso de disco para utilização da VM.

Name	Tipo	Description
acceleratedNetwork	boolean	Verdadeiro se a imagem a partir da qual o disco do SO é criado suportar redes aceleradas.
architecture	Architecture	Arquitetura da CPU suportada por um disco do SO.
diskControllerTypes	string	Os controladores de disco suportados por um disco do SO. Se definido, pode ser SCSI ou SCSI, NVME ou NVME, SCSI.

Partilhar via

Disks - Get

Parâmetros do URI

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Get information about a managed disk.

Pedido de amostra

Resposta da amostra

Definições

Architecture

CreationData

DataAccessAuthMode

Disk

DiskCreateOption

DiskSecurityProfile

DiskSecurityTypes

DiskSku

DiskState

DiskStorageAccountTypes

Encryption

EncryptionSettingsCollection

EncryptionSettingsElement

EncryptionType

ExtendedLocation

ExtendedLocationTypes

HyperVGeneration

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

NetworkAccessPolicy

OperatingSystemTypes

PropertyUpdatesInProgress

ProvisionedBandwidthCopyOption

PublicNetworkAccess

PurchasePlan

ShareInfoElement

SourceVault

SupportedCapabilities

Recursos adicionais