Dela via

Item Level Recovery Connections - Provision

Tjänst:
Recovery Services - Backup
API-version:
2025-08-01

Etablerar ett skript som anropar en iSCSI-anslutning till säkerhetskopierade data. Om du kör det här skriptet öppnas en utforskare som visar alla återställningsbara filer och mappar. Det här är en asynkron åtgärd. Om du vill veta status för etablering anropar du API:et GetProtectedItemOperationResult.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}/provisionInstantItemRecovery?api-version=2025-08-01

URI-parametrar

Name I Obligatorisk Typ Description
containerName
 path True

string

Namnet på den container vars information måste hämtas.
fabricName
 path True

string

Namnet på BackupFabricResource
protectedItemName
 path True

string

Säkerhetskopierat objektnamn vars information ska hämtas.
recoveryPointId
 path True

string

RecoveryPointID representerar de säkerhetskopierade data som ska hämtas.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId
 path True

string

minLength: 1

ID för målprenumerationen.
vaultName
 path True

string

Namnet på VaultResource
api-version
 query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
eTag

string

Valfri ETag.
location

string

Resursplats.
properties ILRRequest:

ILRRequestResource-egenskaper
tags

object

Resursetiketter.

Svar

Name Typ Description
202 Accepted

Begäran har godkänts för bearbetning, men bearbetningen har ännu inte slutförts.
Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Provision Instant Item Level Recovery for Azure Vm

Exempelbegäran

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/protectedItems/vm;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/recoveryPoints/1/provisionInstantItemRecovery?api-version=2025-08-01

{
  "properties": {
    "initiatorName": "Hello World",
    "objectType": "IaasVMILRRegistrationRequest",
    "recoveryPointId": "38823086363464",
    "renewExistingRegistration": true,
    "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/pysdktestrg/providers/Microsoft.Compute/virtualMachines/pysdktestv2vm1"
  }
}

Exempelsvar

Statuskod:
202 
Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/protectedItems/vm;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/protectedItems/vm;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

Definitioner

Name Description
AzureFileShareProvisionILRRequest

Uppdatera ögonblicksbild-Uri med rätt eget namn på azure-källfilresursen.
createdByType

Den typ av identitet som skapade resursen.
ErrorDetail

Felinformationsklass som kapslar in kod, meddelande och rekommendationer.
ErrorResponse

Felsvar
IaasVMILRRegistrationRequest

Återställa filer/mappar från en säkerhetskopia av den virtuella IaaS-datorn.
ILRRequestResource

Parametrar för att etablera ILR API.
systemData

Metadata som rör skapande och senaste ändring av resursen.

AzureFileShareProvisionILRRequest

Objekt

Uppdatera ögonblicksbild-Uri med rätt eget namn på azure-källfilresursen.

Name Typ Description
objectType string:

AzureFileShareProvisionILRRequest

Den här egenskapen används som diskriminerande för att bestämma de specifika typerna i den polymorfa typkedjan.
recoveryPointId

string

Återställningspunkt-ID.
sourceResourceId

string

ARM-ID för källlagringskonto

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

ErrorDetail

Objekt

Felinformationsklass som kapslar in kod, meddelande och rekommendationer.

Name Typ Description
code

string

Felkod.
message

string

Felmeddelande som är relaterat till koden.
recommendations

string[]

Lista över rekommendationssträngar.

ErrorResponse

Objekt

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

IaasVMILRRegistrationRequest

Objekt

Återställa filer/mappar från en säkerhetskopia av den virtuella IaaS-datorn.

Name Typ Description
initiatorName

string

iSCSI-initierarnamn.
objectType string:

IaasVMILRRegistrationRequest

Den här egenskapen används som diskriminerande för att bestämma de specifika typerna i den polymorfa typkedjan.
recoveryPointId

string

ID för säkerhetskopian av den virtuella IaaS-datorn där filerna/mapparna måste återställas.
renewExistingRegistration

boolean

Om du vill förnya befintlig registrering med iSCSI-servern.
virtualMachineId

string

Fullständigt kvalificerat ARM-ID för den virtuella datorn vars filer/mappar måste återställas.

ILRRequestResource

Objekt

Parametrar för att etablera ILR API.

Name Typ Description
eTag

string

Valfri ETag.
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Resursplats.
name

string

Namnet på resursen
properties ILRRequest:

ILRRequestResource-egenskaper
systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags

object

Resursetiketter.
type

string

Resurstypen. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).
createdBy

string

Identiteten som skapade resursen.
createdByType

createdByType

Den typ av identitet som skapade resursen.
lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy

string

Identiteten som senast ändrade resursen.
lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.