Backup Instances - Trigger Restore

Attiva il ripristino per un backupInstance

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/restore?api-version=2021-01-01

Parametri dell'URI

Name In Required Type Description
backupInstanceName
path True
  • string

Nome dell'istanza di backup

resourceGroupName
path True
  • string

Nome del gruppo di risorse in cui è presente l'insieme di credenziali di backup.

subscriptionId
path True
  • string

ID sottoscrizione.

vaultName
path True
  • string

Nome dell'insieme di credenziali di backup.

api-version
query True
  • string

Versione dell'API client.

Corpo della richiesta

Il corpo della richiesta può essere uno dei seguenti:

Name Description
AzureBackupRecoveryPointBasedRestoreRequest

Richiesta di ripristino basato su Backup di Azure

AzureBackupRecoveryTimeBasedRestoreRequest

Richiesta di ripristino basato su AzureBackupPointTime

AzureBackupRestoreWithRehydrationRequest

Ripristino di AzureBackup con richiesta di riattivazione

AzureBackupRecoveryPointBasedRestoreRequest

Richiesta di ripristino basato su Backup di Azure

Name Required Type Description
objectType True string:
recoveryPointId True
  • string
restoreTargetInfo True RestoreTargetInfoBase:

Ottiene o imposta le informazioni di destinazione di ripristino.

sourceDataStoreType True

Ottiene o imposta il tipo dell'archivio dati di origine.

AzureBackupRecoveryTimeBasedRestoreRequest

Richiesta di ripristino basato su AzureBackupPointTime

Name Required Type Description
objectType True string:
recoveryPointTime True
  • string

Il tempo di ripristino nel formato ISO 8601 - 2020-08-14T17:30:00.000000000Z.

restoreTargetInfo True RestoreTargetInfoBase:

Ottiene o imposta le informazioni di destinazione di ripristino.

sourceDataStoreType True

Ottiene o imposta il tipo dell'archivio dati di origine.

AzureBackupRestoreWithRehydrationRequest

Ripristino di AzureBackup con richiesta di riattivazione

Name Required Type Description
objectType True string:
recoveryPointId True
  • string
rehydrationPriority True

Priorità da usare per la reidratazione. Valori elevati o standard

rehydrationRetentionDuration True
  • string

Durata di conservazione nel formato ISO 8601, ad esempio P10D.

restoreTargetInfo True RestoreTargetInfoBase:

Ottiene o imposta le informazioni di destinazione di ripristino.

sourceDataStoreType True

Ottiene o imposta il tipo dell'archivio dati di origine.

Risposte

Name Type Description
200 OK

Contiene informazioni aggiuntive come ID processo

202 Accepted

L'operazione verrà completata in modo asincrono.

Headers

  • Location: string
  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

Risposta di errore che descrive perché 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

Name Description
user_impersonation rappresentare l'account utente.

Esempio

Trigger Restore
Trigger Restore As Files
Trigger Restore With Rehydration

Trigger Restore

Sample Request

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/restore?api-version=2021-01-01

{
  "objectType": "AzureBackupRecoveryPointBasedRestoreRequest",
  "recoveryPointId": "hardcodedRP",
  "sourceDataStoreType": "VaultStore",
  "restoreTargetInfo": {
    "objectType": "RestoreTargetInfo",
    "recoveryOption": "FailIfExists",
    "datasourceSetInfo": {
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "OssDB"
    },
    "datasourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "OssDB"
    },
    "restoreLocation": "southeastasia"
  }
}

Sample Response

Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupInstances/harshitbi1/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2021-01-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2021-01-01
Retry-After: 60
{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae"
}

Trigger Restore As Files

Sample Request

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault1/backupInstances/testInstance1/restore?api-version=2021-01-01

{
  "objectType": "AzureBackupRecoveryPointBasedRestoreRequest",
  "recoveryPointId": "hardcodedRP",
  "sourceDataStoreType": "VaultStore",
  "restoreTargetInfo": {
    "targetDetails": {
      "url": "https://teststorage.blob.core.windows.net/restoretest",
      "filePrefix": "restoredblob",
      "restoreTargetLocationType": "AzureBlobs"
    },
    "restoreLocation": "southeastasia",
    "recoveryOption": "FailIfExists",
    "objectType": "RestoreFilesTargetInfo"
  }
}

Sample Response

Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupInstances/testInstance1/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2021-01-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2021-01-01
Retry-After: 60
{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae"
}

Trigger Restore With Rehydration

Sample Request

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/restore?api-version=2021-01-01

{
  "objectType": "AzureBackupRestoreWithRehydrationRequest",
  "recoveryPointId": "hardcodedRP",
  "rehydrationRetentionDuration": "7D",
  "rehydrationPriority": "High",
  "sourceDataStoreType": "VaultStore",
  "restoreTargetInfo": {
    "objectType": "RestoreTargetInfo",
    "recoveryOption": "FailIfExists",
    "datasourceSetInfo": {
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "OssDB"
    },
    "datasourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "OssDB"
    },
    "restoreLocation": "southeastasia"
  }
}

Sample Response

Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupInstances/harshitbi1/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2021-01-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2021-01-01
Retry-After: 60
{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae"
}

Definizioni

AzureBackupRecoveryPointBasedRestoreRequest

AzureBackupRecoveryPointBasedRestoreRequest

AzureBackupRecoveryTimeBasedRestoreRequest

AzureBackupRecoveryTimeBasedRestoreRequest

AzureBackupRestoreWithRehydrationRequest

AzureBackupRestoreWithRehydrationRequest

CloudError

CloudError

Datasource

Origine dati

DatasourceSet

DatasourceSet

Error

Risposta all'errore di gestione delle risorse.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ItemLevelRestoreTargetInfo

Ripristinare le informazioni di destinazione per l'operazione di ripristino a livello di elemento

OperationJobExtendedInfo

OperationJobExtendedInfo

RangeBasedItemLevelRestoreCriteria

Informazioni di destinazione a livello di elemento per l'operazione di ripristino

RecoveryOption

Opzione di ripristino

RehydrationPriority

Priorità da usare per la reidratazione. Valori elevati o standard

RestoreFilesTargetInfo

Classe incapsulando il ripristino come parametri di destinazione dei file

RestoreTargetInfo

Classe incapsulando i parametri di destinazione del ripristino

RestoreTargetLocationType

Indica il percorso di destinazione in cui verranno ripristinati i dati, il valore stringa per l'enumerazione {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType}

SourceDataStoreType

Ottiene o imposta il tipo dell'archivio dati di origine.

TargetDetails

Dettagli della classe incapsulando i dettagli di destinazione, usati in cui la destinazione non è un'origine dati

AzureBackupRecoveryPointBasedRestoreRequest

AzureBackupRecoveryPointBasedRestoreRequest

Name Type Description
objectType string:
recoveryPointId
  • string
restoreTargetInfo RestoreTargetInfoBase:

Ottiene o imposta le informazioni di destinazione di ripristino.

sourceDataStoreType

Ottiene o imposta il tipo dell'archivio dati di origine.

AzureBackupRecoveryTimeBasedRestoreRequest

AzureBackupRecoveryTimeBasedRestoreRequest

Name Type Description
objectType string:
recoveryPointTime
  • string

Il tempo di ripristino nel formato ISO 8601 - 2020-08-14T17:30:00.000000000Z.

restoreTargetInfo RestoreTargetInfoBase:

Ottiene o imposta le informazioni di destinazione di ripristino.

sourceDataStoreType

Ottiene o imposta il tipo dell'archivio dati di origine.

AzureBackupRestoreWithRehydrationRequest

AzureBackupRestoreWithRehydrationRequest

Name Type Description
objectType string:
recoveryPointId
  • string
rehydrationPriority

Priorità da usare per la reidratazione. Valori elevati o standard

rehydrationRetentionDuration
  • string

Durata di conservazione nel formato ISO 8601, ad esempio P10D.

restoreTargetInfo RestoreTargetInfoBase:

Ottiene o imposta le informazioni di destinazione di ripristino.

sourceDataStoreType

Ottiene o imposta il tipo dell'archivio dati di origine.

CloudError

CloudError

Name Type Description
error

Risposta all'errore di gestione delle risorse.

Datasource

Origine dati

Name Type Description
datasourceType
  • string

DatasourceType della risorsa.

objectType
  • string

Tipo di oggetto Datasource utilizzato per inizializzare il tipo ereditato corretto

resourceID
  • string

ID arm completo della risorsa. Per le risorse di Azure, questo è l'ID arm. Per le risorse non di Azure, questo sarà l'ID creato dal servizio di backup tramite Fabric/Vault.

resourceLocation
  • string

Posizione dell'origine dati.

resourceName
  • string

Identificatore univoco della risorsa nel contesto di padre.

resourceType
  • string

Tipo di risorsa dell'origine dati.

resourceUri
  • string

Uri della risorsa.

DatasourceSet

DatasourceSet

Name Type Description
datasourceType
  • string

DatasourceType della risorsa.

objectType
  • string

Tipo di oggetto Datasource utilizzato per inizializzare il tipo ereditato corretto

resourceID
  • string

ID arm completo della risorsa. Per le risorse di Azure, questo è l'ID arm. Per le risorse non di Azure, questo sarà l'ID creato dal servizio di backup tramite Fabric/Vault.

resourceLocation
  • string

Posizione dell'origine dati.

resourceName
  • string

Identificatore univoco della risorsa nel contesto di padre.

resourceType
  • string

Tipo di risorsa dell'origine dati.

resourceUri
  • string

Uri della risorsa.

Error

Risposta all'errore di gestione delle risorse.

Name Type Description
additionalInfo

Informazioni aggiuntive sull'errore.

code
  • string

Codice di errore.

details

Dettagli dell'errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Name Type Description
info
  • object

Informazioni aggiuntive.

type
  • string

Tipo di informazioni aggiuntive.

ItemLevelRestoreTargetInfo

Ripristinare le informazioni di destinazione per l'operazione di ripristino a livello di elemento

Name Type Description
datasourceInfo

Origine dati
Informazioni di DS di destinazione

datasourceSetInfo

DatasourceSet
Informazioni sul set DS di destinazione

objectType string:

Tipo di oggetto Datasource utilizzato per inizializzare il tipo ereditato corretto

recoveryOption

Opzione di ripristino

restoreCriteria ItemLevelRestoreCriteria[]:

Criteri di ripristino

restoreLocation
  • string

Area di ripristino di destinazione

OperationJobExtendedInfo

OperationJobExtendedInfo

Name Type Description
jobId
  • string

ID arm del processo creato per questa operazione.

objectType
  • string

Questa proprietà verrà usata come discriminazione per decidere i tipi specifici nella catena polimorfica di tipi.

RangeBasedItemLevelRestoreCriteria

Informazioni di destinazione a livello di elemento per l'operazione di ripristino

Name Type Description
maxMatchingValue
  • string

valore massimo per la corrispondenza del prefisso di intervallo

minMatchingValue
  • string

valore minimo per la corrispondenza del prefisso di intervallo

objectType string:

Tipo dell'oggetto specifico : usato per la deserializzazione

RecoveryOption

Opzione di ripristino

Name Type Description
FailIfExists
  • string

RehydrationPriority

Priorità da usare per la reidratazione. Valori elevati o standard

Name Type Description
High
  • string
Invalid
  • string
Standard
  • string

RestoreFilesTargetInfo

Classe incapsulando il ripristino come parametri di destinazione dei file

Name Type Description
objectType string:

Tipo di oggetto Datasource utilizzato per inizializzare il tipo ereditato corretto

recoveryOption

Opzione di ripristino

restoreLocation
  • string

Area di ripristino di destinazione

targetDetails

Destinazione dell'operazione RestoreAsFiles, quando la destinazione non è un'origine dati

RestoreTargetInfo

Classe incapsulando i parametri di destinazione del ripristino

Name Type Description
datasourceInfo

Origine dati
Informazioni di DS di destinazione

datasourceSetInfo

DatasourceSet
Informazioni sul set DS di destinazione

objectType string:

Tipo di oggetto Datasource utilizzato per inizializzare il tipo ereditato corretto

recoveryOption

Opzione di ripristino

restoreLocation
  • string

Area di ripristino di destinazione

RestoreTargetLocationType

Indica il percorso di destinazione in cui verranno ripristinati i dati, il valore stringa per l'enumerazione {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType}

Name Type Description
AzureBlobs
  • string
AzureFiles
  • string
Invalid
  • string

SourceDataStoreType

Ottiene o imposta il tipo dell'archivio dati di origine.

Name Type Description
ArchiveStore
  • string
SnapshotStore
  • string
VaultStore
  • string

TargetDetails

Dettagli della classe incapsulando i dettagli di destinazione, usati in cui la destinazione non è un'origine dati

Name Type Description
filePrefix
  • string

L'operazione di ripristino può creare più file all'interno del percorso indicato dall'URL Seguente sarà il prefisso comune per tutti questi file

restoreTargetLocationType

Indica il percorso di destinazione in cui verranno ripristinati i dati, il valore stringa per l'enumerazione {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType}

url
  • string

Url che indica la destinazione di ripristino. Può puntare al contenitore/condivisione file e così via