Disk Restore Point - List By Restore Point

Service:

Compute

API Version:

2023-10-02

Listy diskRestorePoints w obszarze vmRestorePoint.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów.
restorePointCollectionName	path	True	string	Nazwa kolekcji punktów przywracania, do których należy punkt przywracania dysku.
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
vmRestorePointName	path	True	string	Nazwa punktu przywracania maszyny wirtualnej, do którego należy punkt przywracania dysku.
api-version	query	True	string	Wersja interfejsu API klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DiskRestorePointList	OK
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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"
      }
    }
  ]
}

Definicje

Nazwa	Opis
ApiError	Błąd interfejsu API.
ApiErrorBase	Baza błędów interfejsu API.
Architecture	Architektura procesora CPU obsługiwana przez dysk systemu operacyjnego.
CloudError	Odpowiedź na błąd z usługi Compute.
DiskRestorePoint	Właściwości punktu przywracania dysku
DiskRestorePointList	Odpowiedź operacji Wyświetlanie listy punktów przywracania dysku.
DiskSecurityProfile	Zawiera informacje dotyczące zabezpieczeń dla zasobu.
DiskSecurityTypes	Określa typ zabezpieczeń maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.
Encryption	Szyfrowanie w spoczynku ustawień dysku lub migawki
EncryptionType	Typ klucza używanego do szyfrowania danych dysku.
HyperVGeneration	Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.
InnerError	Szczegóły błędu wewnętrznego.
NetworkAccessPolicy	Zasady uzyskiwania dostępu do dysku za pośrednictwem sieci.
OperatingSystemTypes	Typ systemu operacyjnego.
PublicNetworkAccess	Zasady kontrolowania eksportu na dysku.
PurchasePlan	Służy do ustanawiania kontekstu zakupu dowolnego artefaktu innej firmy za pośrednictwem platformy MarketPlace.
SupportedCapabilities	Lista obsługiwanych funkcji utrwalone w zasobie dysku do użycia przez maszynę wirtualną.

ApiError

Błąd interfejsu API.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	ApiErrorBase[]	Szczegóły błędu interfejsu API
innererror	InnerError	Wewnętrzny błąd interfejsu API
message	string	Komunikat o błędzie.
target	string	Element docelowy określonego błędu.

ApiErrorBase

Baza błędów interfejsu API.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy określonego błędu.

Architecture

Architektura procesora CPU obsługiwana przez dysk systemu operacyjnego.

Nazwa	Typ	Opis
Arm64	string
x64	string

CloudError

Odpowiedź na błąd z usługi Compute.

Nazwa	Typ	Opis
error	ApiError	Błąd interfejsu API.

DiskRestorePoint

Właściwości punktu przywracania dysku

Nazwa	Typ	Opis
id	string	Identyfikator zasobu
name	string	Nazwa zasobu
properties.completionPercent	number	Procent wykonania kopii w tle punktu przywracania dysku, gdy zasób źródłowy pochodzi z innego regionu.
properties.diskAccessId	string	Identyfikator usługi ARM zasobu DiskAccess na potrzeby używania prywatnych punktów końcowych na dyskach.
properties.encryption	Encryption	Właściwość szyfrowania może służyć do szyfrowania danych magazynowanych przy użyciu kluczy zarządzanych przez klienta lub kluczy zarządzanych przez platformę.
properties.familyId	string	identyfikator rodziny MIS migawki zapasowej
properties.hyperVGeneration	HyperVGeneration	Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.
properties.networkAccessPolicy	NetworkAccessPolicy	Zasady uzyskiwania dostępu do dysku za pośrednictwem sieci.
properties.osType	OperatingSystemTypes	Typ systemu operacyjnego.
properties.publicNetworkAccess	PublicNetworkAccess	Zasady kontrolowania eksportu na dysku.
properties.purchasePlan	PurchasePlan	Informacje o planie zakupu obrazu, z którego utworzono dysk systemu operacyjnego.
properties.replicationState	string	Stan replikacji punktu przywracania dysku, gdy zasób źródłowy pochodzi z innego regionu.
properties.securityProfile	DiskSecurityProfile	Zawiera informacje dotyczące zabezpieczeń dla zasobu.
properties.sourceResourceId	string	identyfikator arm dysku źródłowego lub punktu przywracania dysku źródłowego.
properties.sourceResourceLocation	string	Lokalizacja dysku źródłowego lub punktu przywracania dysku źródłowego, gdy zasób źródłowy pochodzi z innego regionu.
properties.sourceUniqueId	string	unikatowy identyfikator wcielenia dysku źródłowego
properties.supportedCapabilities	SupportedCapabilities	Lista obsługiwanych możliwości obrazu, z którego utworzono dysk systemu operacyjnego.
properties.supportsHibernation	boolean	Wskazuje system operacyjny na dysku obsługuje hibernacji.
properties.timeCreated	string	Sygnatura czasowa tworzenia programu RestorePoint
type	string	Typ zasobu

DiskRestorePointList

Odpowiedź operacji Wyświetlanie listy punktów przywracania dysku.

Nazwa	Typ	Opis
nextLink	string	Identyfikator URI do pobrania następnej strony punktów przywracania dysku. Wywołaj metodę ListNext(), aby pobrać następną stronę punktów przywracania dysku.
value	DiskRestorePoint[]	Lista punktów przywracania dysku.

DiskSecurityProfile

Zawiera informacje dotyczące zabezpieczeń dla zasobu.

Nazwa	Typ	Opis
secureVMDiskEncryptionSetId	string	ResourceId zestawu szyfrowania dysku skojarzonego z poufnym dyskiem obsługiwanym przez maszynę wirtualną zaszyfrowaną przy użyciu klucza zarządzanego przez klienta
securityType	DiskSecurityTypes	Określa typ zabezpieczeń maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.

DiskSecurityTypes

Określa typ zabezpieczeń maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.

Nazwa	Typ	Opis
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Wskazuje poufny dysk maszyny wirtualnej z dyskiem systemu operacyjnego i stanem gościa maszyny wirtualnej zaszyfrowanym przy użyciu klucza zarządzanego przez klienta
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Wskazuje poufny dysk maszyny wirtualnej z dyskiem systemu operacyjnego i stanem gościa maszyny wirtualnej zaszyfrowanym przy użyciu klucza zarządzanego platformy
ConfidentialVM_NonPersistedTPM	string	Wskazuje poufny dysk maszyny wirtualnej z efemerycznym modułem vTPM. Stan vTPM nie jest utrwalany w przypadku ponownych uruchomień maszyny wirtualnej.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Wskazuje poufny dysk maszyny wirtualnej z zaszyfrowanym tylko stanem gościa maszyny wirtualnej
TrustedLaunch	string	Zaufane uruchamianie zapewnia funkcje zabezpieczeń, takie jak bezpieczny rozruch i wirtualny moduł Trusted Platform Module (vTPM)

Encryption

Szyfrowanie w spoczynku ustawień dysku lub migawki

Nazwa	Typ	Opis
diskEncryptionSetId	string	ResourceId zestawu szyfrowania dysków do użycia do włączania szyfrowania danych magazynowanych.
type	EncryptionType	Typ klucza używanego do szyfrowania danych dysku.

EncryptionType

Typ klucza używanego do szyfrowania danych dysku.

Nazwa	Typ	Opis
EncryptionAtRestWithCustomerKey	string	Dysk jest szyfrowany w spoczynku przy użyciu klucza zarządzanego przez klienta, który można zmienić i odwołać przez klienta.
EncryptionAtRestWithPlatformAndCustomerKeys	string	Dysk jest szyfrowany w spoczynku z 2 warstwami szyfrowania. Jednym z kluczy jest zarządzany przez klienta, a drugi to Platforma zarządzana.
EncryptionAtRestWithPlatformKey	string	Dysk jest szyfrowany podczas magazynowania przy użyciu klucza zarządzanego platformy. Jest to domyślny typ szyfrowania. Nie jest to prawidłowy typ szyfrowania dla zestawów szyfrowania dysków.

HyperVGeneration

Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.

Nazwa	Typ	Opis
V1	string
V2	string

InnerError

Szczegóły błędu wewnętrznego.

Nazwa	Typ	Opis
errordetail	string	Wewnętrzny komunikat o błędzie lub zrzut wyjątku.
exceptiontype	string	Typ wyjątku.

NetworkAccessPolicy

Zasady uzyskiwania dostępu do dysku za pośrednictwem sieci.

Nazwa	Typ	Opis
AllowAll	string	Dysk można wyeksportować lub przekazać do dowolnej sieci.
AllowPrivate	string	Dysk można wyeksportować lub przekazać do programu przy użyciu prywatnych punktów końcowych zasobu DiskAccess.
DenyAll	string	Nie można wyeksportować dysku.

OperatingSystemTypes

Typ systemu operacyjnego.

Nazwa	Typ	Opis
Linux	string
Windows	string

PublicNetworkAccess

Zasady kontrolowania eksportu na dysku.

Nazwa	Typ	Opis
Disabled	string	Nie można uzyskać dostępu do danych bazowych dysku publicznie w Internecie nawet wtedy, gdy parametr NetworkAccessPolicy ma ustawioną wartość AllowAll. Dostęp do danych można uzyskać za pośrednictwem identyfikatora URI sygnatury dostępu współdzielonego tylko z zaufanej sieci wirtualnej platformy Azure, gdy parametr NetworkAccessPolicy jest ustawiony na Wartość AllowPrivate.
Enabled	string	Możesz wygenerować identyfikator URI sygnatury dostępu współdzielonego, aby uzyskać dostęp do danych źródłowych dysku publicznie w Internecie, gdy parametr NetworkAccessPolicy ma ustawioną wartość AllowAll. Dostęp do danych można uzyskać za pośrednictwem identyfikatora URI sygnatury dostępu współdzielonego tylko z zaufanej sieci wirtualnej platformy Azure, gdy parametr NetworkAccessPolicy jest ustawiony na Wartość AllowPrivate.

PurchasePlan

Służy do ustanawiania kontekstu zakupu dowolnego artefaktu innej firmy za pośrednictwem platformy MarketPlace.

Nazwa	Typ	Opis
name	string	Identyfikator planu.
product	string	Określa produkt obrazu z platformy handlowej. Jest to taka sama wartość jak offer w elemencie imageReference.
promotionCode	string	Kod promocji oferty.
publisher	string	Identyfikator wydawcy.

SupportedCapabilities

Lista obsługiwanych funkcji utrwalone w zasobie dysku do użycia przez maszynę wirtualną.

Nazwa	Typ	Opis
acceleratedNetwork	boolean	Prawda, jeśli obraz, z którego jest tworzony dysk systemu operacyjnego, obsługuje przyspieszoną sieć.
architecture	Architecture	Architektura procesora CPU obsługiwana przez dysk systemu operacyjnego.
diskControllerTypes	string	Kontrolery dysków obsługiwane przez dysk systemu operacyjnego. W przypadku ustawienia może to być SCSI lub SCSI, NVME lub NVME, SCSI.