A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://learn.microsoft.com/en-us/rest/api/backup/recovery-points/get below:

Recovery Points - Get - REST API (Azure Recovery Services - Backup)

Recovery Points - Get

Provides the information of the backed up data identified using RecoveryPointID. This is an asynchronous operation. To know the status of the operation, call the GetProtectedItemOperationResult API.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}?api-version=2025-02-01
URI Parameters Name In Required Type Description

containerName

path True

string

Container name associated with backed up item.

fabricName

path True

string

Fabric name associated with backed up item.

protectedItemName

path True

string

Backed up item name whose backup data needs to be fetched.

recoveryPointId

path True

string

RecoveryPointID represents the backed up data to be fetched.

resourceGroupName

path True

string

The name of the resource group where the recovery services vault is present.

subscriptionId

path True

string

The subscription Id.

vaultName

path True

string

The name of the recovery services vault.

api-version

query True

string

Client Api Version.

Responses Security azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes Name Description user_impersonation impersonate your user account. Examples Get Azure Vm Recovery Point Details Sample request
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/26083826328862?api-version=2025-02-01

/**
 * Samples for RecoveryPoints Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2025-02-01/examples/
     * AzureIaasVm/RecoveryPoints_Get.json
     */
    /**
     * Sample code: Get Azure Vm Recovery Point Details.
     * 
     * @param manager Entry point to RecoveryServicesBackupManager.
     */
    public static void getAzureVmRecoveryPointDetails(
        com.azure.resourcemanager.recoveryservicesbackup.RecoveryServicesBackupManager manager) {
        manager.recoveryPoints().getWithResponse("rshvault", "rshhtestmdvmrg", "Azure",
            "IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall",
            "VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall", "26083826328862", 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.recoveryservicesbackup.activestamp import RecoveryServicesBackupClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-recoveryservicesbackup
# USAGE
    python recovery_points_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 = RecoveryServicesBackupClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.recovery_points.get(
        vault_name="rshvault",
        resource_group_name="rshhtestmdvmrg",
        fabric_name="Azure",
        container_name="IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall",
        protected_item_name="VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall",
        recovery_point_id="26083826328862",
    )
    print(response)


# x-ms-original-file: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2025-02-01/examples/AzureIaasVm/RecoveryPoints_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 armrecoveryservicesbackup_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/recoveryservices/armrecoveryservicesbackup/v4"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/148c3b0b44f7789ced94859992493fafd0072f83/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2025-02-01/examples/AzureIaasVm/RecoveryPoints_Get.json
func ExampleRecoveryPointsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicesbackup.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewRecoveryPointsClient().Get(ctx, "rshvault", "rshhtestmdvmrg", "Azure", "IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall", "VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall", "26083826328862", 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.RecoveryPointResource = armrecoveryservicesbackup.RecoveryPointResource{
	// 	Name: to.Ptr("26083826328862"),
	// 	Type: to.Ptr("Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/26083826328862"),
	// 	Properties: &armrecoveryservicesbackup.IaasVMRecoveryPoint{
	// 		ObjectType: to.Ptr("IaasVMRecoveryPoint"),
	// 		IsInstantIlrSessionActive: to.Ptr(false),
	// 		IsManagedVirtualMachine: to.Ptr(true),
	// 		IsPrivateAccessEnabledOnAnyDisk: to.Ptr(true),
	// 		IsSourceVMEncrypted: to.Ptr(false),
	// 		OriginalStorageAccountOption: to.Ptr(false),
	// 		RecoveryPointAdditionalInfo: to.Ptr(""),
	// 		RecoveryPointMoveReadinessInfo: map[string]*armrecoveryservicesbackup.RecoveryPointMoveReadinessInfo{
	// 			"ArchivedRP": &armrecoveryservicesbackup.RecoveryPointMoveReadinessInfo{
	// 				IsReadyForMove: to.Ptr(true),
	// 			},
	// 		},
	// 		RecoveryPointTierDetails: []*armrecoveryservicesbackup.RecoveryPointTierInformationV2{
	// 			{
	// 				Type: to.Ptr(armrecoveryservicesbackup.RecoveryPointTierTypeHardenedRP),
	// 				Status: to.Ptr(armrecoveryservicesbackup.RecoveryPointTierStatusValid),
	// 		}},
	// 		RecoveryPointTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-11-22T22:32:46.608Z"); return t}()),
	// 		RecoveryPointType: to.Ptr("CrashConsistent"),
	// 		SourceVMStorageType: to.Ptr("NormalStorage"),
	// 		VirtualMachineSize: to.Ptr("Standard_D1"),
	// 		Zones: []*string{
	// 			to.Ptr("1")},
	// 		},
	// 	}
}

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

const { RecoveryServicesBackupClient } = require("@azure/arm-recoveryservicesbackup");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Provides the information of the backed up data identified using RecoveryPointID. This is an asynchronous operation.
To know the status of the operation, call the GetProtectedItemOperationResult API.
 *
 * @summary Provides the information of the backed up data identified using RecoveryPointID. This is an asynchronous operation.
To know the status of the operation, call the GetProtectedItemOperationResult API.
 * x-ms-original-file: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2025-02-01/examples/AzureIaasVm/RecoveryPoints_Get.json
 */
async function getAzureVMRecoveryPointDetails() {
  const subscriptionId =
    process.env["RECOVERYSERVICESBACKUP_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const vaultName = "rshvault";
  const resourceGroupName =
    process.env["RECOVERYSERVICESBACKUP_RESOURCE_GROUP"] || "rshhtestmdvmrg";
  const fabricName = "Azure";
  const containerName = "IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall";
  const protectedItemName = "VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall";
  const recoveryPointId = "26083826328862";
  const credential = new DefaultAzureCredential();
  const client = new RecoveryServicesBackupClient(credential, subscriptionId);
  const result = await client.recoveryPoints.get(
    vaultName,
    resourceGroupName,
    fabricName,
    containerName,
    protectedItemName,
    recoveryPointId,
  );
  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 System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.RecoveryServicesBackup.Models;
using Azure.ResourceManager.RecoveryServicesBackup;

// Generated from example definition: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2025-02-01/examples/AzureIaasVm/RecoveryPoints_Get.json
// this example is just showing the usage of "RecoveryPoints_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 BackupRecoveryPointResource created on azure
// for more information of creating BackupRecoveryPointResource, please refer to the document of BackupRecoveryPointResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "rshhtestmdvmrg";
string vaultName = "rshvault";
string fabricName = "Azure";
string containerName = "IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall";
string protectedItemName = "VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall";
string recoveryPointId = "26083826328862";
ResourceIdentifier backupRecoveryPointResourceId = BackupRecoveryPointResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vaultName, fabricName, containerName, protectedItemName, recoveryPointId);
BackupRecoveryPointResource backupRecoveryPoint = client.GetBackupRecoveryPointResource(backupRecoveryPointResourceId);

// invoke the operation
BackupRecoveryPointResource result = await backupRecoveryPoint.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
BackupRecoveryPointData 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

Sample response
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/26083826328862",
  "name": "26083826328862",
  "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
  "properties": {
    "objectType": "IaasVMRecoveryPoint",
    "recoveryPointType": "CrashConsistent",
    "recoveryPointTime": "2017-11-22T22:32:46.6088472Z",
    "recoveryPointAdditionalInfo": "",
    "sourceVMStorageType": "NormalStorage",
    "isSourceVMEncrypted": false,
    "isInstantIlrSessionActive": false,
    "recoveryPointTierDetails": [
      {
        "type": "HardenedRP",
        "status": "Valid"
      }
    ],
    "recoveryPointMoveReadinessInfo": {
      "ArchivedRP": {
        "isReadyForMove": true
      }
    },
    "isManagedVirtualMachine": true,
    "virtualMachineSize": "Standard_D1",
    "originalStorageAccountOption": false,
    "zones": [
      "1"
    ],
    "isPrivateAccessEnabledOnAnyDisk": true
  }
}
Definitions

Object

Azure File Share workload specific backup copy.

Name Type Description fileShareSnapshotUri

string

Contains Url to the snapshot of fileshare, if applicable

objectType string:

AzureFileShareRecoveryPoint

This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.

recoveryPointProperties

RecoveryPointProperties

Properties of Recovery Point

recoveryPointSizeInGB

integer (int32)

Contains recovery point size

recoveryPointTierDetails

RecoveryPointTierInformation[]

Recovery point tier information.

recoveryPointTime

string (date-time)

Time at which this backup copy was created.

recoveryPointType

string

Type of the backup copy. Specifies whether it is a crash consistent backup or app consistent.

AzureWorkloadPointInTimeRecoveryPoint

Object

Recovery point specific to PointInTime

AzureWorkloadRecoveryPoint

Object

Workload specific recovery point, specifically encapsulates full/diff recovery point

AzureWorkloadSAPAsePointInTimeRecoveryPoint

Object

Recovery point specific to PointInTime in SAPAse

AzureWorkloadSAPAseRecoveryPoint

Object

SAPAse specific recoverypoint, specifically encapsulates full/diff recoverypoints

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Object

Recovery point specific to PointInTime in SAPHana

AzureWorkloadSAPHanaRecoveryPoint

Object

SAPHana specific recoverypoint, specifically encapsulates full/diff recoverypoints

AzureWorkloadSQLPointInTimeRecoveryPoint

Object

Recovery point specific to PointInTime

AzureWorkloadSQLRecoveryPoint

Object

SQL specific recoverypoint, specifically encapsulates full/diff recoverypoint along with extended info

Name Type Description extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Extended Info that provides data directory details. Will be populated in two cases: When a specific recovery point is accessed using GetRecoveryPoint Or when ListRecoveryPoints is called for Log RP only with ExtendedInfo query filter

objectType string:

AzureWorkloadSQLRecoveryPoint

This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Eligibility of RP to be moved to another tier

recoveryPointProperties

RecoveryPointProperties

Properties of Recovery Point

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Recovery point tier information.

recoveryPointTimeInUTC

string (date-time)

UTC time at which recovery point was created

type

RestorePointType

Type of restore point

AzureWorkloadSQLRecoveryPointExtendedInfo

Object

Extended info class details

Name Type Description dataDirectoryPaths

SQLDataDirectory[]

List of data directory paths during restore operation.

dataDirectoryTimeInUTC

string (date-time)

UTC time at which data directory info was captured

BEKDetails

Object

BEK is bitlocker encryption key.

Name Type Description secretData

string

BEK data.

secretUrl

string

Secret is BEK.

secretVaultId

string

ID of the Key Vault where this Secret is stored.

CloudError

Object

An error response from the Container Instance service.

CloudErrorBody

Object

An error response from the Container Instance service.

Name Type Description additionalInfo

ErrorAdditionalInfo[]

The error additional info.

code

string

An identifier for the error. Codes are invariant and are intended to be consumed programmatically.

details

CloudErrorBody[]

A list of additional details about the error.

message

string

A message describing the error, intended to be suitable for display in a user interface.

target

string

The target of the particular error. For example, the name of the property in error.

DiskInformation

Object

Disk information

Name Type Description lun

integer (int32)

name

string

ErrorAdditionalInfo

Object

The resource management error additional info.

Name Type Description info

object

The additional info.

type

string

The additional info type.

ExtendedLocation

Object

The extended location of Recovery point where VM was present.

Name Type Description name

string

Name of the extended location.

type

string

Type of the extended location. Possible values include: 'EdgeZone'

GenericRecoveryPoint

Object

Generic backup copy.

Name Type Description friendlyName

string

Friendly name of the backup copy.

objectType string:

GenericRecoveryPoint

This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.

recoveryPointAdditionalInfo

string

Additional information associated with this backup copy.

recoveryPointProperties

RecoveryPointProperties

Properties of Recovery Point

recoveryPointTime

string (date-time)

Time at which this backup copy was created.

recoveryPointType

string

Type of the backup copy.

IaasVMRecoveryPoint

Object

IaaS VM workload specific backup copy.

Name Type Description extendedLocation

ExtendedLocation

Extended location of the VM recovery point, should be null if VM is in public cloud

isInstantIlrSessionActive

boolean

Is the session to recover items from this backup copy still active.

isManagedVirtualMachine

boolean

Whether VM is with Managed Disks

isPrivateAccessEnabledOnAnyDisk

boolean

This flag denotes if any of the disks in the VM are using Private access network setting

isSourceVMEncrypted

boolean

Identifies whether the VM was encrypted when the backup copy is created.

keyAndSecret

KeyAndSecretDetails

Required details for recovering an encrypted VM. Applicable only when IsSourceVMEncrypted is true.

objectType string:

IaasVMRecoveryPoint

This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.

originalStorageAccountOption

boolean

Original Storage Account Option

osType

string

OS type

recoveryPointAdditionalInfo

string

Additional information associated with this backup copy.

recoveryPointDiskConfiguration

RecoveryPointDiskConfiguration

Disk configuration

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Eligibility of RP to be moved to another tier

recoveryPointProperties

RecoveryPointProperties

Properties of Recovery Point

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Recovery point tier information.

recoveryPointTime

string (date-time)

Time at which this backup copy was created.

recoveryPointType

string

Type of the backup copy.

securityType

string

Security Type of the Disk

sourceVMStorageType

string

Storage type of the VM whose backup copy is created.

virtualMachineSize

string

Virtual Machine Size

zones

string[]

Identifies the zone of the VM at the time of backup. Applicable only for zone-pinned Vms

KEKDetails

Object

KEK is encryption key for BEK.

Name Type Description keyBackupData

string

KEK data.

keyUrl

string

Key is KEK.

keyVaultId

string

Key Vault ID where this Key is stored.

KeyAndSecretDetails

Object

BEK is bitlocker key. KEK is encryption key for BEK If the VM was encrypted then we will store following details :

  1. Secret(BEK) - Url + Backup Data + vaultId.
  2. Key(KEK) - Url + Backup Data + vaultId.
  3. EncryptionMechanism BEK and KEK can potentially have different vault ids.
Name Type Description bekDetails

BEKDetails

BEK is bitlocker encryption key.

encryptionMechanism

string

Encryption mechanism: None/ SinglePass/ DoublePass

kekDetails

KEKDetails

KEK is encryption key for BEK.

PointInTimeRange

Object

Provides details for log ranges

Name Type Description endTime

string (date-time)

End time of the time range for log recovery.

startTime

string (date-time)

Start time of the time range for log recovery.

RecoveryPointDiskConfiguration

Object

Disk configuration

Name Type Description excludedDiskList

DiskInformation[]

Information of disks excluded from backup

includedDiskList

DiskInformation[]

Information of disks included in backup

numberOfDisksAttachedToVm

integer (int32)

Number of disks attached to the VM

numberOfDisksIncludedInBackup

integer (int32)

Number of disks included in backup

RecoveryPointMoveReadinessInfo

Object

Name Type Description additionalInfo

string

isReadyForMove

boolean

RecoveryPointProperties

Object

Properties of Recovery Point

Name Type Description expiryTime

string

Expiry time of Recovery Point in UTC.

isSoftDeleted

boolean

Bool to indicate whether RP is in soft delete state or not

ruleName

string

Rule name tagged on Recovery Point that governs life cycle

RecoveryPointResource

Object

Base class for backup copies. Workload-specific backup copies are derived from this class.

RecoveryPointTierInformation

Object

Recovery point tier information.

RecoveryPointTierInformationV2

Object

RecoveryPoint Tier Information V2

RecoveryPointTierStatus

Enumeration

Recovery point tier status.

Value Description Invalid Valid Disabled Deleted Rehydrated RecoveryPointTierType

Enumeration

Recovery point tier type.

Value Description Invalid InstantRP HardenedRP ArchivedRP RestorePointType

Enumeration

Type of restore point

Value Description Invalid Full Log Differential Incremental SnapshotFull SnapshotCopyOnlyFull SQLDataDirectory

Object

SQLDataDirectory info

Name Type Description logicalName

string

Logical name of the file

path

string

File path

type

SQLDataDirectoryType

Type of data directory mapping

SQLDataDirectoryType

Enumeration

Type of data directory mapping

Value Description Invalid Data Log

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4