Condividi tramite


Item Level Recovery Connections - Provision

Effettua il provisioning di uno script che richiama una connessione iSCSI ai dati di backup. L'esecuzione di questo script apre uno strumento di esplorazione file che visualizza tutti i file e le cartelle recuperabili. Si tratta di un'operazione asincrona. Per conoscere lo stato del provisioning, chiamare l'API 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=2024-10-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
containerName
path True

string

Nome del contenitore associato agli elementi di cui è stato eseguito il backup.

fabricName
path True

string

Nome dell'infrastruttura associato agli elementi di cui è stato eseguito il backup.

protectedItemName
path True

string

Nome dell'elemento di cui eseguire il backup i cui file/cartelle devono essere ripristinati.

recoveryPointId
path True

string

ID del punto di ripristino che rappresenta i dati di cui è stato eseguito il backup. Verrà effettuato il provisioning della connessione iSCSI per i dati di cui è stato eseguito il backup.

resourceGroupName
path True

string

Nome del gruppo di risorse in cui è presente l'insieme di credenziali dei servizi di ripristino.

subscriptionId
path True

string

ID sottoscrizione.

vaultName
path True

string

Nome dell'insieme di credenziali di Servizi di ripristino.

api-version
query True

string

Versione dell'API client.

Corpo della richiesta

Nome Tipo Descrizione
eTag

string

ETag facoltativo.

location

string

Percorso della risorsa.

properties ILRRequest:

Proprietà ILRRequestResource

tags

object

Tag di risorsa.

Risposte

Nome Tipo Descrizione
202 Accepted

Accettato

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

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente.

Esempio

Provision Instant Item Level Recovery for Azure Vm

Esempio di richiesta

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=2024-10-01

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AzureFileShareProvisionILRRequest

Aggiornare l'URI dello snapshot con il nome descrittivo corretto della condivisione file di Azure di origine.

CloudError

Risposta di errore del servizio Istanza contenitore.

CloudErrorBody

Risposta di errore del servizio Istanza contenitore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

IaasVMILRRegistrationRequest

Ripristinare file/cartelle da una copia di backup della macchina virtuale IaaS.

ILRRequestResource

Parametri per il provisioning dell'API ILR.

AzureFileShareProvisionILRRequest

Aggiornare l'URI dello snapshot con il nome descrittivo corretto della condivisione file di Azure di origine.

Nome Tipo Descrizione
objectType string:

AzureFileShareProvisionILRRequest

Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.

recoveryPointId

string

ID punto di ripristino.

sourceResourceId

string

ID ARM dell'account di archiviazione di origine

CloudError

Risposta di errore del servizio Istanza contenitore.

Nome Tipo Descrizione
error

CloudErrorBody

Oggetto error.

CloudErrorBody

Risposta di errore del servizio Istanza contenitore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

IaasVMILRRegistrationRequest

Ripristinare file/cartelle da una copia di backup della macchina virtuale IaaS.

Nome Tipo Descrizione
initiatorName

string

Nome iniziatore iSCSI.

objectType string:

IaasVMILRRegistrationRequest

Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.

recoveryPointId

string

ID della copia di backup della macchina virtuale IaaS da cui devono essere ripristinati i file o le cartelle.

renewExistingRegistration

boolean

Se rinnovare la registrazione esistente con il server iSCSI.

virtualMachineId

string

ID ARM completo della macchina virtuale i cui file/cartelle devono essere ripristinati.

ILRRequestResource

Parametri per il provisioning dell'API ILR.

Nome Tipo Descrizione
eTag

string

ETag facoltativo.

id

string

L'ID risorsa rappresenta il percorso completo della risorsa.

location

string

Percorso della risorsa.

name

string

Nome della risorsa associato alla risorsa.

properties ILRRequest:

Proprietà ILRRequestResource

tags

object

Tag di risorsa.

type

string

Tipo di risorsa rappresenta il percorso completo del modulo Spazio dei nomi/ResourceType/ResourceType/...