Disk Restore Point - List By Restore Point

Service:

Compute

API Version:

2023-10-02

Elenchi diskRestorePoints in un vmRestorePoint.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}/restorePoints/{vmRestorePointName}/diskRestorePoints?api-version=2023-10-02

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse.
restorePointCollectionName	path	True	string	Nome della raccolta di punti di ripristino a cui appartiene il punto di ripristino del disco.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
vmRestorePointName	path	True	string	Nome del punto di ripristino della macchina virtuale a cui appartiene il punto di ripristino del disco.
api-version	query	True	string	Versione api client.

Risposte

Nome	Tipo	Descrizione
200 OK	DiskRestorePointList	OK
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get an incremental disk restorePoint resource.

Sample Request

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints?api-version=2023-10-02

Java

/**
 * Samples for DiskRestorePoint ListByRestorePoint.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/
     * diskRestorePointExamples/DiskRestorePoint_ListByVmRestorePoint.json
     */
    /**
     * Sample code: Get an incremental disk restorePoint resource.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAnIncrementalDiskRestorePointResource(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDiskRestorePoints().listByRestorePoint("myResourceGroup",
            "rpc", "vmrp", 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/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e4009d2f8d3bf0271757e522c7d1c1997e193d44/specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskRestorePointExamples/DiskRestorePoint_ListByVmRestorePoint.json
func ExampleDiskRestorePointClient_NewListByRestorePointPager() {
	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)
	}
	pager := clientFactory.NewDiskRestorePointClient().NewListByRestorePointPager("myResourceGroup", "rpc", "vmrp", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.DiskRestorePointList = armcompute.DiskRestorePointList{
		// 	Value: []*armcompute.DiskRestorePoint{
		// 		{
		// 			Name: to.Ptr("TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745"),
		// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745"),
		// 			Properties: &armcompute.DiskRestorePointProperties{
		// 				FamilyID: to.Ptr("996bf3ce-b6ff-4e86-9db6-dc27ea06cea5"),
		// 				HyperVGeneration: to.Ptr(armcompute.HyperVGenerationV1),
		// 				NetworkAccessPolicy: to.Ptr(armcompute.NetworkAccessPolicyAllowAll),
		// 				OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
		// 				PublicNetworkAccess: to.Ptr(armcompute.PublicNetworkAccessDisabled),
		// 				SourceResourceID: to.Ptr("/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0"),
		// 				SourceUniqueID: to.Ptr("48e058b1-7eea-4968-b532-10a8a1130c13"),
		// 				TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-09-16T04:41:35.079Z"); return t}()),
		// 			},
		// 	}},
		// }
	}
}

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 Lists diskRestorePoints under a vmRestorePoint.
 *
 * @summary Lists diskRestorePoints under a vmRestorePoint.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskRestorePointExamples/DiskRestorePoint_ListByVmRestorePoint.json
 */
async function getAnIncrementalDiskRestorePointResource() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "rpc";
  const vmRestorePointName = "vmrp";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.diskRestorePointOperations.listByRestorePoint(
    resourceGroupName,
    restorePointCollectionName,
    vmRestorePointName,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

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 System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskRestorePointExamples/DiskRestorePoint_ListByVmRestorePoint.json
// this example is just showing the usage of "DiskRestorePoint_ListByRestorePoint" 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 RestorePointResource created on azure
// for more information of creating RestorePointResource, please refer to the document of RestorePointResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string restorePointGroupName = "rpc";
string vmRestorePointName = "vmrp";
ResourceIdentifier restorePointResourceId = RestorePointResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, restorePointGroupName, vmRestorePointName);
RestorePointResource restorePoint = client.GetRestorePointResource(restorePointResourceId);

// get the collection of this DiskRestorePointResource
DiskRestorePointCollection collection = restorePoint.GetDiskRestorePoints();

// invoke the operation and iterate over the result
await foreach (DiskRestorePointResource item in collection.GetAllAsync())
{
    // the variable item 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
    DiskRestorePointData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
      "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
      "properties": {
        "timeCreated": "2020-09-16T04:41:35.079872+00:00",
        "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
        "osType": "Windows",
        "hyperVGeneration": "V1",
        "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
        "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
        "networkAccessPolicy": "AllowAll",
        "publicNetworkAccess": "Disabled"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
ApiError	Errore dell'API.
ApiErrorBase	Base degli errori api.
Architecture	Architettura della CPU supportata da un disco del sistema operativo.
CloudError	Risposta di errore dal servizio di calcolo.
DiskRestorePoint	Proprietà del punto di ripristino del disco
DiskRestorePointList	Risposta dell'operazione Elenca i punti di ripristino del disco.
DiskSecurityProfile	Contiene le informazioni relative alla sicurezza per la risorsa.
DiskSecurityTypes	Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.
Encryption	Impostazioni di crittografia dei dati inattivi per disco o snapshot
EncryptionType	Tipo di chiave utilizzata per crittografare i dati del disco.
HyperVGeneration	Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.
InnerError	Dettagli dell'errore interno.
NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
OperatingSystemTypes	Tipo di sistema operativo.
PublicNetworkAccess	Criteri per il controllo dell'esportazione sul disco.
PurchasePlan	Usato per stabilire il contesto di acquisto di qualsiasi elemento di terze parti tramite MarketPlace.
SupportedCapabilities	Elenco delle funzionalità supportate rese persistenti nella risorsa disco per l'uso della macchina virtuale.

ApiError

Errore dell'API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore dell'API
innererror	InnerError	Errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

Architecture

Architettura della CPU supportata da un disco del sistema operativo.

Nome	Tipo	Descrizione
Arm64	string
x64	string

CloudError

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore dell'API.

DiskRestorePoint

Proprietà del punto di ripristino del disco

Nome	Tipo	Descrizione
id	string	ID risorsa
name	string	Nome risorsa
properties.completionPercent	number	Percentuale di completamento per la copia in background del punto di ripristino del disco quando la risorsa di origine proviene da un'area diversa.
properties.diskAccessId	string	ID ARM della risorsa DiskAccess per l'uso di endpoint privati nei dischi.
properties.encryption	Encryption	La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma.
properties.familyId	string	ID della famiglia MIS dello snapshot di backup
properties.hyperVGeneration	HyperVGeneration	Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.
properties.networkAccessPolicy	NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
properties.osType	OperatingSystemTypes	Tipo di sistema operativo.
properties.publicNetworkAccess	PublicNetworkAccess	Criteri per il controllo dell'esportazione sul disco.
properties.purchasePlan	PurchasePlan	Informazioni sul piano di acquisto per l'immagine da cui è stato creato il disco del sistema operativo.
properties.replicationState	string	Stato di replica del punto di ripristino del disco quando la risorsa di origine proviene da un'area diversa.
properties.securityProfile	DiskSecurityProfile	Contiene le informazioni relative alla sicurezza per la risorsa.
properties.sourceResourceId	string	ID arm del disco di origine o del punto di ripristino del disco di origine.
properties.sourceResourceLocation	string	Posizione del disco di origine o del punto di ripristino del disco di origine quando la risorsa di origine proviene da un'area diversa.
properties.sourceUniqueId	string	ID incarnazione univoco del disco di origine
properties.supportedCapabilities	SupportedCapabilities	Elenco delle funzionalità supportate per l'immagine da cui è stato creato il disco del sistema operativo.
properties.supportsHibernation	boolean	Indica che il sistema operativo in un disco supporta l'ibernazione.
properties.timeCreated	string	Timestamp della creazione di restorePoint
type	string	Tipo di risorsa

DiskRestorePointList

Risposta dell'operazione Elenca i punti di ripristino del disco.

Nome	Tipo	Descrizione
nextLink	string	URI per recuperare la pagina successiva dei punti di ripristino del disco. Chiamare ListNext() per recuperare la pagina successiva dei punti di ripristino del disco.
value	DiskRestorePoint[]	Elenco dei punti di ripristino del disco.

DiskSecurityProfile

Contiene le informazioni relative alla sicurezza per la risorsa.

Nome	Tipo	Descrizione
secureVMDiskEncryptionSetId	string	ResourceId del set di crittografia del disco associato alla macchina virtuale riservata supportata crittografata con la chiave gestita dal cliente
securityType	DiskSecurityTypes	Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

DiskSecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

Nome	Tipo	Descrizione
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Indica il disco di macchina virtuale riservato con disco del sistema operativo e lo stato guest della macchina virtuale crittografato con una chiave gestita dal cliente
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Indica il disco di macchina virtuale riservato con disco del sistema operativo e lo stato guest della macchina virtuale crittografato con una chiave gestita dalla piattaforma
ConfidentialVM_NonPersistedTPM	string	Indica un disco di macchina virtuale riservato con vTPM temporaneo. Lo stato di vTPM non viene salvato in modo permanente tra i riavvii della macchina virtuale.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Indica il disco di macchina virtuale riservato con solo lo stato guest della macchina virtuale crittografato
TrustedLaunch	string	L'avvio attendibile offre funzionalità di sicurezza, ad esempio l'avvio protetto e il virtual Trusted Platform Module (vTPM)

Encryption

Impostazioni di crittografia dei dati inattivi per disco o snapshot

Nome	Tipo	Descrizione
diskEncryptionSetId	string	ResourceId del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi.
type	EncryptionType	Tipo di chiave utilizzata per crittografare i dati del disco.

EncryptionType

Tipo di chiave utilizzata per crittografare i dati del disco.

Nome	Tipo	Descrizione
EncryptionAtRestWithCustomerKey	string	Il disco viene crittografato inattivo con la chiave gestita dal cliente che può essere modificata e revocata da un cliente.
EncryptionAtRestWithPlatformAndCustomerKeys	string	Il disco viene crittografato inattivo con 2 livelli di crittografia. Una delle chiavi è Gestita dal cliente e l'altra è gestita dalla piattaforma.
EncryptionAtRestWithPlatformKey	string	Il disco viene crittografato inattivo con la chiave gestita dalla piattaforma. È il tipo di crittografia predefinito. Questo tipo di crittografia non è valido per i set di crittografia del disco.

HyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

Nome	Tipo	Descrizione
V1	string
V2	string

InnerError

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump delle eccezioni.
exceptiontype	string	Tipo di eccezione.

NetworkAccessPolicy

Criteri per l'accesso al disco tramite rete.

Nome	Tipo	Descrizione
AllowAll	string	Il disco può essere esportato o caricato da qualsiasi rete.
AllowPrivate	string	Il disco può essere esportato o caricato in usando gli endpoint privati di una risorsa DiskAccess.
DenyAll	string	Impossibile esportare il disco.

OperatingSystemTypes

Tipo di sistema operativo.

Nome	Tipo	Descrizione
Linux	string
Windows	string

PublicNetworkAccess

Criteri per il controllo dell'esportazione sul disco.

Nome	Tipo	Descrizione
Disabled	string	Non è possibile accedere ai dati sottostanti del disco pubblicamente su Internet anche quando NetworkAccessPolicy è impostato su AllowAll. È possibile accedere ai dati tramite l'URI di firma di accesso condiviso solo dalla rete virtuale di Azure attendibile quando NetworkAccessPolicy è impostato su AllowPrivate.
Enabled	string	È possibile generare un URI di firma di accesso condiviso per accedere ai dati sottostanti del disco pubblicamente su Internet quando NetworkAccessPolicy è impostato su AllowAll. È possibile accedere ai dati tramite l'URI di firma di accesso condiviso solo dalla rete virtuale di Azure attendibile quando NetworkAccessPolicy è impostato su AllowPrivate.

PurchasePlan

Usato per stabilire il contesto di acquisto di qualsiasi elemento di terze parti tramite MarketPlace.

Nome	Tipo	Descrizione
name	string	ID piano.
product	string	Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference.
promotionCode	string	Codice promozionale dell'offerta.
publisher	string	ID editore.

SupportedCapabilities

Elenco delle funzionalità supportate rese persistenti nella risorsa disco per l'uso della macchina virtuale.

Nome	Tipo	Descrizione
acceleratedNetwork	boolean	True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata.
architecture	Architecture	Architettura della CPU supportata da un disco del sistema operativo.
diskControllerTypes	string	Controller del disco supportati da un disco del sistema operativo. Se impostato può essere SCSI o SCSI, NVME o NVME, SCSI.