Ripristinare il backup di database SQL Server in macchine virtuali di Azure con API REST

Questo articolo spiega come ripristinare un database SQL Server in una VM Azure da un punto di ripristino creato da Backup di Azure utilizzando l'API RcEST.

Al termine di questo articolo si apprenderà come eseguire le operazioni seguenti usando l'API REST:

  • Visualizzare i punti di ripristino per un database SQL sottoposto a backup.
  • Eseguire le query sui punti di ripristino dello snapshot e gli intervalli di ripristino temporizzato per istanze e database SQL.
  • Recupera i database e i percorsi delle directory dati inclusi in un punto di recupero.
  • Ripristinare un database SQL completo.

Per visualizzare gli scenari di backup e ripristino attualmente supportati, vedere la matrice di supporto. Per domande comuni, vedere le domande frequenti.

Prerequisiti

Si presuppone che sia disponibile un database SQL di cui è stato eseguito il backup per il ripristino. Se non ne è disponibile uno, vedere Istanza protetta di SQL Server nelle macchine virtuali di Azure usando l'API REST per procedere alla sua creazione.

Per questo articolo, saranno necessarie le risorse seguenti:

  • Insieme di credenziali di Servizi di ripristino: SQLServer2012
  • Gruppo di risorse: SQLServerSelfHost
  • SQL Server: sqlserver-0
  • Database SQL: msdb

Ripristino area primaria

Per attivare un normale processo di ripristino nell'area primaria, vedere le sezioni seguenti. Per il ripristino tra aree, vedere la sezione Ripristino tra aree.

Recuperare ContainerName e ProtectedItemName

Per la maggior parte delle chiamate API correlate al ripristino, è necessario passare valori per i parametri URI {containerName} e {protectedItemName}. Usare l'attributo ID nel corpo della risposta dell'operazione GET backupprotectableitems per recuperare i valori per tali parametri. Nell'esempio, l'ID del database che si vuole proteggere è:

/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/sqldatabase;mssqlserver;msdb

I valori si traducono nel modo seguente:

  • {containername}: VMAppContainer; Compute; SQLServerPMDemo; sqlserver-0
  • {protectedItemName}: sqldatabase; mssqlserver; msdb

Recuperare i punti di ripristino per il backup del database SQL

Per ripristinare qualsiasi database di cui è stato eseguito il backup:

  1. Selezionare un punto di ripristino per eseguire l'operazione di ripristino.

  2. Elencare i punti di ripristino disponibili di un elemento di backup usando la chiamata API REST per l’Elenco dei punti di ripristino. Si tratta di una semplice operazione GET con tutti i valori pertinenti.

    GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints?api-version=2016-12-01
    

    Impostare i valori URI come segue:

    • {fabricName}: Azure
    • {vaultName}: SQLServer2012
    • {containerName}: VMAppContainer; Compute; SQLServerPMDemo; sqlserver-0
    • {protectedItemName}: sqldatabase; mssqlserver; msdb
    • {resourceGroupName}: SQLServerSelfHost

    L'URI GET ha tutti i parametri obbligatori. Non è necessario alcun corpo della richiesta aggiuntivo.

    GET "https://management.azure.com/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.RecoveryServices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/sqldatabase;mssqlserver;msdb/recoveryPoints?api-version=2016-12-01"
    

Risposta di esempio per recuperare i punti di ripristino

Dopo aver inviato l'URI GET, viene restituita una risposta 200:

HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: fab6cc6f-db1e-4ac1-acac-fc82ebdb1fdb
x-ms-client-request-id: 6fb93717-2876-47df-b01f-d53af5f08785; 6fb93717-2876-47df-b01f-d53af5f08785
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14999
x-ms-correlation-request-id: fab6cc6f-db1e-4ac1-acac-fc82ebdb1fdb
x-ms-routing-request-id: SOUTHINDIA:20180604T061127Z:fab6cc6f-db1e-4ac1-acac-fc82ebdb1fdb
Cache-Control: no-cache
Date: Mon, 04 Jun 2018 06:11:26 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/55515936059579",
      "name": "55515936059579",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2018-06-01T22:15:12Z",
        "type": "Full"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/62043109781074",
      "name": "62043109781074",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2018-05-31T22:15:08Z",
        "type": "Full"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/69710749096214",
      "name": "69710749096214",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2018-05-30T22:15:09Z",
        "type": "Full"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/55459165802209",
      "name": "55459165802209",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2018-05-29T22:15:15Z",
        "type": "Full"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/56798287946753",
      "name": "56798287946753",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2018-05-28T13:18:15Z",
        "type": "Full"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/DefaultRangeRecoveryPoint",
      "name": "DefaultRangeRecoveryPoint",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLPointInTimeRecoveryPoint",
        "timeRanges": [
          {
            "startTime": "2018-05-28T11:03:34Z",
            "endTime": "2018-06-02T00:02:31Z"
          }
        ],
        "type": "Log"
      }
    }
  ]
}

Il punto di ripristino viene identificato con il campo {name} nella risposta precedente.

Eseguire le query su snapshot e punti di ripristino in streaming

Per istanze SQL e database protetti da snapshot, usa la versione API 2024-01-31-preview per le seguenti query dei punti di ripristino. Sostituisci i segnaposto URI con i dettagli del vault e i nomi del contenitore e dell'elemento protetto restituiti da listing protected items. Codificare l'URL nell'espressione di filtro quando si invia la richiesta.

Da usare restorePointQueryType per selezionare i tipi di punti di recupero:

Value Punti di ripristino restituiti
FullDifferentialAndSnapshot Punti di recupero completi, differenziali e snapshot per un database.
Snapshot Punti di recupero istantaneo per un database o un'istanza.
FullAndDifferential Streaming dei punti di ripristino completi e differenziali per un database.
Log Intervalli di tempo di recupero dei log per un database.

Elenca i punti di recupero completo, differenziale e snapshot

Usa il nome dell'elemento protetto nel database, ad esempio SQLDataBase;mssqlserver;testdb:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'FullDifferentialAndSnapshot'

Elenca i punti di ripristino snapshot

Per un database, usa il nome dell'elemento protetto del database:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'Snapshot'

Per un'istanza, usare il nome dell'elemento protetto dell'istanza, ad esempio SQLInstance;mssqlserver:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{instanceProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'Snapshot'

Elenca i punti di recupero completo e differenziale per streaming

È anche possibile specificare una finestra temporale e includere i punti di ripristino eliminati temporaneamente:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=startDate eq '2024-02-15 05:12:12 PM' and endDate eq '2024-02-22 05:12:12 PM' and restorePointQueryType eq 'FullAndDifferential' and includeSoftDeletedRP eq 'true'

Sostituisci le date di esempio con la finestra temporale richiesta. L'array value contiene punti di recupero con proprietà come recoveryPointTimeInUTC, type, e recoveryPointTierDetails. Le informazioni sulla conservazione possono comparire in recoveryPointProperties, inclusi expiryTime, ruleName, e isSoftDeleted.

Eseguire query sugli intervalli di ripristino dei log per il ripristino temporizzato

Per elencare i range di recupero dei log per un database, utilizzare la seguente richiesta:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'Log'

La risposta include un DefaultRangeRecoveryPoint oggetto. Il seguente esempio mostra campi di risposta selezionati:

{
  "value": [
    {
      "name": "DefaultRangeRecoveryPoint",
      "properties": {
        "objectType": "AzureWorkloadSQLPointInTimeRecoveryPoint",
        "timeRanges": [
          {
            "startTime": "2024-02-07T17:12:13.2853054Z",
            "endTime": "2024-02-22T15:30:13Z"
          }
        ],
        "type": "Log"
      }
    }
  ]
}

Seleziona un'ora di ripristino all'interno degli intervalli restituiti.

Consulta i range di log del database per modalità di recupero

Per il recupero basato su streaming, specifica recoveryMode eq 'WorkloadRecovery':

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'Log' and recoveryMode eq 'WorkloadRecovery'

Per il recupero basato su snapshot, specificare recoveryMode eq 'SnapshotAttachAndRecover':

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'Log' and recoveryMode eq 'SnapshotAttachAndRecover'

Entrambe le query restituiscono il formato di risposta a intervallo di recupero di log mostrato in precedenza.

Consulta i range di log del database per un ripristino di un'istanza

Per il ripristino temporizzato dell'istanza, selezionare prima un punto di ripristino dello snapshot dell'istanza e recuperare i database inclusi. Per ogni database incluso, consulta i suoi intervalli di log con i dettagli selezionati dello snapshot di base:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2024-01-31-preview&$filter=restorePointQueryType eq 'Log' and recoveryMode eq 'SnapshotAttachAndRecover' and baseSnapshotRPId eq '{baseSnapshotRPId}' and baseRPDatasourceId eq '{baseRPDatasourceId}'
  • {baseSnapshotRPId}: il name del punto di ripristino dello snapshot dell'istanza selezionata.
  • {baseRPDatasourceId}: il protectedItemDataSourceId dell'elemento protetto dell'istanza, non l'ID dell'origine dati del database figlio.
  • {databaseProtectedItemName}: il nome dell'elemento protetto del database figlio interrogato.

Ottenere database e percorsi del disco in uno snapshot di istanza

Recuperare il punto di ripristino selezionato dell'istanza per recuperare i database e i percorsi dei dischi inclusi. Usa gli stessi metadati quando prepari un ripristino snapshot dell'istanza o un ripristino puntuale dell'istanza:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{instanceProtectedItemName}/recoveryPoints/{snapshotRecoveryPointId}?api-version=2024-01-31-preview

{snapshotRecoveryPointId} è il name del punto di ripristino. Il seguente esempio mostra campi di risposta selezionati:

{
  "name": "2265756871711897922",
  "properties": {
    "objectType": "AzureWorkloadSQLRecoveryPoint",
    "extendedInfo": {
      "dataDirectoryTimeInUTC": "2024-03-13T08:03:25Z",
      "dataDirectoryPaths": [
        {
          "type": "DiskDrives",
          "path": "F:\\"
        },
        {
          "type": "DiskDrives",
          "path": "G:\\"
        }
      ],
      "includedDatabases": [
        {
          "datasourceId": "2265838378698362078",
          "datasourceName": "MSSQLSERVER;user1"
        }
      ],
      "snapshotRecoveryPointInfo": {}
    },
    "recoveryPointTimeInUTC": "2024-03-13T08:03:25Z",
    "type": "SnapshotFull",
    "recoveryPointTierDetails": [
      {
        "type": "InstantRP",
        "status": "Valid"
      }
    ]
  }
}

extendedInfo.includedDatabases identifica i database catturati nell'istantanea selezionata. extendedInfo.dataDirectoryPaths identifica i percorsi del disco disponibili per la configurazione avanzata di ripristino.

Ottieni i percorsi del database per la configurazione avanzata di ripristino

Per un punto di recupero streaming o snapshot di database, recupera i dettagli del punto di recupero:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints/{recoveryPointId}?api-version=2023-02-01

Controllare properties.extendedInfo.dataDirectoryPaths per i percorsi dei dati e dei file di log e i nomi logici. Ad esempio:

{
  "dataDirectoryTimeInUTC": "2024-03-04T18:03:35Z",
  "dataDirectoryPaths": [
    {
      "type": "Data",
      "path": "F:\\DATA\\TestDB1.mdf",
      "logicalName": "TestDB1"
    },
    {
      "type": "Log",
      "path": "F:\\LOG\\TestDB1_log.ldf",
      "logicalName": "TestDB1_log"
    }
  ],
  "snapshotRecoveryPointInfo": {}
}

Per il ripristino puntuale del database, richiedi informazioni estese quando elenchi i range di recupero dei log. Il seguente esempio utilizza il recupero basato su snapshot:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{databaseProtectedItemName}/recoveryPoints?api-version=2023-02-01&$filter=startDate eq '2024-02-06 07:50:56 AM' and endDate eq '2024-03-07 07:23:05 AM' and extendedInfo eq 'true' and restorePointQueryType eq 'Log' and recoveryMode eq 'SnapshotAttachAndRecover'

Sostituisci le date di esempio con la finestra di query richiesta. La risposta contiene gli intervalli di ripristino del log e properties.extendedInfo, inclusi dataDirectoryTimeInUTC, dataDirectoryPaths e snapshotRecoveryPointInfo.

Le query precedenti recuperano i punti di recupero e ripristinano i metadati della configurazione. La sezione seguente descrive la richiesta di ripristino del database in streaming esistente.

Ripristino del database tramite API REST

L'attivazione del ripristino è una richiesta POST. Per eseguire questa operazione, usare l’API REST dell’Attivazione trigger.

POST https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}/restore?api-version=2019-05-13

I valori {containerName} e {protectedItemName} sono impostati qui e recoveryPointID è il campo {name} del punto di ripristino indicato in precedenza.

POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0/protectedItems/sqldatabase;mssqlserver;msdb/recoveryPoints/56798287946753/restore?api-version=2019-05-13'

Creare il corpo della richiesta

Esempio di corpo della richiesta per ripristinare un database nella stessa directory di dati

Il corpo della richiesta seguente definisce le proprietà necessarie per attivare il ripristino del database SQL alla stessa directory di dati.

{
   "properties":{
        "objectType":"AzureWorkloadSQLRestoreRequest",
        "shouldUseAlternateTargetLocation":false,
        "isNonRecoverable":false,
        "targetInfo":{"ContainerName": "compute;SQLServerPMDemo;sqlserver-0", "DatabaseName" : "SQLINSTANCE/msdb"},
        "alternateDirectoryPaths":null,
        "isFallbackOnDefaultDirectoryEnabled":true,
        "recoveryType":"AlternateLocation",
        "sourceResourceId":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerPMDemo/providers/Azure/virtualmachines/compute;SQLServerPMDemo;sqlserver-0"       
    }
}
Esempio di corpo della richiesta per ripristinare un database in una directory alternativa di dati

Il corpo della richiesta seguente definisce le proprietà necessarie per attivare il ripristino del database SQL alla stessa directory di dati.

{
    "properties":{ 
        "objectType":"AzureWorkloadSQLRestoreRequest",
        "shouldUseAlternateTargetLocation":true,
        "isNonRecoverable":false,
        "targetInfo":
        {
            "overwriteOption":"Overwrite","containerName":"compute;oneboxrg;oneboxvm","databaseName":"SQLINSTANCE/msdb"},
            "alternateDirectoryPaths":[{"mappingType":"Log","sourcePath":"C:\\SQLfiles\\Default.ldf","targetPath":"C:\\SQLFiles\\Temp.ldf"}],
            "recoveryType":"AlternateLocation",
            "sourceResourceId":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerPMDemo/providers/Azure/virtualmachines/compute;SQLServerPMDemo;sqlserver-0"
        }
    }
}

Risposta

L'attivazione di un’operazione di ripristino è un'operazione asincrona. L'operazione consente di creare un'altra operazione che deve essere registrata separatamente.

L'operazione restituisce due risposte: 202 (Accettata) quando viene creata un'altra operazione e 200 (OK) quando tale operazione è completata.

Esempio di risposta
Status Code:
OK

Headers:
Pragma                        : no-cache
Cache-Control                 : no-cache
Server                        : Microsoft-IIS/10.0,Microsoft-IIS/10.0
X-Content-Type-Options        : nosniff
x-ms-request-id               : f17973f5-c788-482f-8aad-6bb50e647a2e
x-ms-client-request-id        : b0356a0e-c68d-4ac2-a53f-4f546685146d,b0356a0e-c68d-4ac2-a53f-4f546685146d
X-Powered-By                  : ASP.NET
Strict-Transport-Security     : max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-resource-requests: 149
x-ms-correlation-request-id   : f17973f5-c788-482f-8aad-6bb50e647a2e
x-ms-routing-request-id       : SOUTHINDIA:20210801T104711Z:f17973f5-c788-482f-8aad-6bb50e647a2e
Date                          : Sun, 01 Aug 2021 10:47:11 GMT

{
    "id":"/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupJobs/0bda1a53-73fa-427e-9a1c-72a2016adee3",
    "name": "0bda1a53-73fa-427e-9a1c-72a2016adee3",
    "type": "Microsoft.RecoveryServices/vaults/backupJobs",
    "properties": {
    "jobType": "AzureWorkloadJob",
    "actionsInfo": [
      1
    ],
    "workloadType": "SQLDataBase",
    "duration": "PT1.6543659S",
    "extendedInfo": {
      "tasksList": [
        {
          "taskId": "Transfer data from vault",
          "status": "InProgress"
        }
      ],
      "propertyBag": {
        "Job Type": "Recovery to the original database"
      }
    },
    "isUserTriggered": true,
    "entityFriendlyName": "msdb [sqlserver-0]",
    "backupManagementType": "AzureWorkload",
    "operation": "Restore",
    "status": "InProgress",
    "startTime": "2021-08-01T10:47:09.5865449Z",
    "activityId": "b0356a0e-c68d-4ac2-a53f-4f546685146d"
  }
}

Ripristino tra aree

Se è stato abilitato il ripristino tra aree, i punti di ripristino verranno replicati anche nell'area secondaria abbinata. È quindi possibile recuperare i punti di ripristino e attivare il ripristino in un computer presente in tale area abbinata. Con il normale ripristino, il computer di destinazione deve essere registrato nell'insieme di credenziali di destinazione nell'area secondaria. I passaggi seguenti descrivono il processo end-to-end:

  1. Recuperare gli elementi di backup che vengono replicati nell'area secondaria.

    Per l'esempio seguente, è necessario disporre di:

    • Un contenitore: VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0
    • Elemento protetto: sqldatabase; mssqlserver; msdb) per il database che deve essere ripristinato, usando i passaggi indicati in precedenza in questo documento.
  2. Recuperare i punti di ripristino (distinti e/o log) che vengono replicati nell'area secondaria.

  3. Scegliere un server di destinazione che è registrato in un insieme di credenziali all'interno dell'area associata secondaria.

  4. Attivare il ripristino in tale server e tenerne traccia usando JobId.

Nota

L'obiettivo del punto di ripristino per i dati di backup da rendere disponibili nell'area secondaria è 12 ore. Pertanto, quando si attiva CRR, l'RPO per l'area secondaria è di 12 ore e la durata della frequenza del log (che può essere impostata su un minimo di 15 minuti).

Recuperare punti di ripristino distinti dall'area secondaria

Usare l'API Elencare i punti di recupero per recuperare l'elenco dei punti di ripristino disponibili per il database nell'area secondaria. Nell'esempio seguente viene applicato un filtro facoltativo per recuperare i punti di recupero completi e differenziali in un determinato intervallo di tempo.

GET "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/recoveryPoints/?$filter=startDate eq'2021-07-25 08:41:32 AM' and endDate eq '2021-08-01 08:41:45 AM' and restorePointQueryType eq 'FullAndDifferential' and extendedInfo eq 'True'&api-version=2018-12-20"

Risposta di esempio per recuperare i punti di ripristino

Headers:
Pragma                        : no-cache
X-Content-Type-Options        : nosniff
x-ms-request-id               : 66b3fbb4-e38a-4a4b-98c7-56db66ab52e6
x-ms-client-request-id        : 35eb7834-8b5c-4a2c-adda-eee2ed02eb08,35eb7834-8b5c-4a2c-adda-eee2ed02eb08
Strict-Transport-Security     : max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-resource-requests: 149
x-ms-correlation-request-id   : 66b3fbb4-e38a-4a4b-98c7-56db66ab52e6
x-ms-routing-request-id       : SOUTHINDIA:20210801T102906Z:66b3fbb4-e38a-4a4b-98c7-56db66ab52e6
Cache-Control                 : no-cache
Date                          : Sun, 01 Aug 2021 10:29:06 GMT
Server                        : Microsoft-IIS/10.0
X-Powered-By                  : ASP.NET

Body:
{
  "value": [
    {
      "id":
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/RecoveryPoints/932604119111216382",
      "name": "932604119111216382",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2021-07-31T16:33:48Z",
        "type": "Full"
      }
    },
    {
      "id":
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupFabrics/Azure/protectionContainers/VMAppContainer;compute;SQLServerPMDemo;sqlserver-0/protectedItems/SQLDataBase;mssqlserver;msdb/RecoveryPoints/932599942005436803",
      "name": "932599942005436803",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "AzureWorkloadSQLRecoveryPoint",
        "recoveryPointTimeInUTC": "2021-07-30T16:33:49Z",
        "type": "Full"
      }
    },
.....

Il punto di ripristino viene identificato con il campo {name} nella risposta precedente.

Ottenere il token di accesso

Per eseguire il ripristino tra aree, è necessario un token di accesso per abilitare la comunicazione corretta tra i servizi di Backup di Azure. Per ottenere un token di accesso, seguire questa procedura:

  1. Usare l'API Proprietà di Microsoft Entra per recuperare le proprietà di Microsoft Entra per l'area secondaria (westus nell'esempio seguente):

    GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/westus/backupAadProperties?api-version=2018-12-20
    

    La risposta restituita è del formato seguente:

    {
      "properties": {
        "tenantId": "00000000-0000-0000-0000-000000000000",
        "audience": "https://RecoveryServices/IaasCoord/aadmgmt/wus",
        "servicePrincipalObjectId": "00000000-0000-0000-0000-000000000000"
      }
    }
    
  2. Usare l'API Ottieni token di accesso per ottenere un token di accesso finalizzato ad abilitare la comunicazione tra i servizi di Backup di Azure.

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

    Per il corpo della richiesta, incollare il contenuto della risposta restituita dall'API Proprietà Microsoft Entra nel passaggio precedente.

    Il formato restituito dalla risposta è il seguente:

    {
      "protectableObjectUniqueName": "MSSQLSERVER/model",
        "protectableObjectFriendlyName": "msdb",
        "protectableObjectWorkloadType": "SQL",
        "protectableObjectProtectionState": "Protected",
        "protectableObjectContainerHostOsName": "sqlserver-0",
        "protectableObjectParentLogicalContainerName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerPMDemo/providers/Microsoft.Compute/virtualMachines/sqlserver-0",
        "containerId": "0000000",
        "policyName": "HourlyLogBackup",
        "policyId": "00000000-0000-0000-0000-000000000000",
        "objectType": "WorkloadCrrAccessToken",
        "accessTokenString": "<access-token-string>",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "resourceGroupName": "SQLServerSelfHost",
        "resourceName": "SQLServer2012",
        "resourceId": "0000000000000000000",
        "protectionContainerId": 0000000,
        "recoveryPointId": "932603497994988273",
        "recoveryPointTime": "7/31/2021 4:33:17 PM",
        "containerName": "Compute;SQLServerPMDemo;sqlserver-0",
        "containerType": "VMAppContainer",
        "backupManagementType": "AzureWorkload",
        "datasourceType": "SQLDataBase",
        "datasourceName": "msdb",
        "datasourceId": "932350676859704517",
        "datasourceContainerName": "Compute;SQLServerPMDemo;sqlserver-0",
        "coordinatorServiceStampId": "00000000-0000-0000-0000-000000000000",
        "coordinatorServiceStampUri": "https://pod01-wbcm1.eus.backup.windowsazure.com",
        "protectionServiceStampId": "00000000-0000-0000-0000-000000000000",
        "protectionServiceStampUri": "https://pod01-prot1j-int.eus.backup.windowsazure.com",
        "rpOriginalSAOption": false,
        "rpIsManagedVirtualMachine": false,
        "bMSActiveRegion": "EastUS"
    }
    

Ripristinare i dischi nell'area secondaria

Usare l'API trigger di ripristino tra aree per ripristinare un elemento nell'area secondaria.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{azureRegion}/backupCrossRegionRestore?api-version=2018-12-20

Il corpo della richiesta deve avere due parti:

  1. crossRegionRestoreAccessDetails: incollare il blocco proprietà della risposta alla richiesta dell'API Ottieni token di accesso eseguita nel passaggio precedente per compilare questo segmento del corpo della richiesta.

  2. restoreRequest: per riempire il segmento restoreRequest del corpo della richiesta, è necessario passare i dettagli del contenitore (registrato a un insieme di credenziali nell'area secondaria) in cui deve essere ripristinato il database, insieme al nome in cui deve essere archiviato il database ripristinato. Per eseguire il ripristino di un backup completo nell'area secondaria, specificare AlternateLocation come tipologia di recupero.

Il corpo della richiesta di esempio per ripristinare i dischi di una macchina virtuale nell'area secondaria è il seguente:

  {
  "crossRegionRestoreAccessDetails": {
	      "protectableObjectUniqueName": "MSSQLSERVER/model",
        "protectableObjectFriendlyName": "msdb",
        "protectableObjectWorkloadType": "SQL",
        "protectableObjectProtectionState": "Protected",
        "protectableObjectContainerHostOsName": "sqlserver-0",
        "protectableObjectParentLogicalContainerName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLServerPMDemo/providers/Microsoft.Compute/virtualMachines/sqlserver-0",
        "containerId": "0000000",
        "policyName": "HourlyLogBackup",
        "policyId": "00000000-0000-0000-0000-000000000000",
        "objectType": "WorkloadCrrAccessToken",
        "accessTokenString": "<access-token-string>",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "resourceGroupName": "SQLServerSelfHost",
        "resourceName": "SQLServer2012",
        "resourceId": "0000000000000000000",
        "protectionContainerId": 0000000,
        "recoveryPointId": "932603497994988273",
        "recoveryPointTime": "7/31/2021 4:33:17 PM",
        "containerName": "Compute;SQLServerPMDemo;sqlserver-0",
        "containerType": "VMAppContainer",
        "backupManagementType": "AzureWorkload",
        "datasourceType": "SQLDataBase",
        "datasourceName": "msdb",
        "datasourceId": "932350676859704517",
        "datasourceContainerName": "Compute;SQLServerPMDemo;sqlserver-0",
        "coordinatorServiceStampId": "00000000-0000-0000-0000-000000000000",
        "coordinatorServiceStampUri": "https://pod01-wbcm1.eus.backup.windowsazure.com",
        "protectionServiceStampId": "00000000-0000-0000-0000-000000000000",
        "protectionServiceStampUri": "https://pod01-prot1j-int.eus.backup.windowsazure.com",
        "rpOriginalSAOption": false,
        "rpIsManagedVirtualMachine": false,
        "bMSActiveRegion": "EastUS"
    },
    "restoreRequest": {
        "objectType": "AzureWorkloadSQLRestoreRequest",
        "shouldUseAlternateTargetLocation": true,
        "isNonRecoverable": false,
        "alternateDirectoryPaths": [],
        "recoveryType": "AlternateLocation",
        "sourceResourceId":"/subscriptions/600000000-0000-0000-0000-000000000000/resourceGroups/SQLServerPMDemo/providers/Microsoft.Compute/virtualMachines/sqlserver-0",
        "targetInfo": {
            "overwriteOption": "FailOnConflict",
          "containerId":"/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RestoreRG/providers/Microsoft.RecoveryServices/vaults/wusRestoreVault/backupFabrics/Azure/protectionContainers/vmappcontainer;compute;restorerg;wusrestorevm",
          "databaseName": "MSSQLSERVER/msdb_restored_8_1_2021_1758"
        }
      }
  }

Eseguire un ripristino interregionale point-in-time per un'istanza SQL protetta da una policy snapshot

Usare questo flusso per ripristinare i database inclusi in uno snapshot di istanza SQL e applicare i backup del log fino a un punto temporale comune nell'area secondaria.

Importante

Il momento selezionato deve essere coperto dall'intervallo di log di ogni database che si vuole recuperare dallo snapshot dell'istanza. Richiedi il token di accesso per l'elemento protetto dell'istanza SQL e il punto di recupero dello snapshot concreto selezionato.

Scopri lo snapshot dell'istanza e i range di log

  1. Elenca i punti di recupero per l'oggetto protetto dall'istanza SQL.

    GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLInstance%3Bmssqlserver/recoveryPoints?api-version=2023-01-15
    

    Seleziona un punto di recupero la cui risposta contenga tutti i seguenti valori:

    • properties.type è SnapshotFull.
    • properties.crossRegionRestoreState è Supported.
    • properties.recoveryPointTierDetails contiene una HardenedRP voce il cui stato è Valid.
  2. Ottenere il punto di ripristino selezionato per recuperarne le informazioni estese autorevoli.

    GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLInstance%3Bmssqlserver/recoveryPoints/{instanceSnapshotRecoveryPointId}?api-version=2023-01-15
    

    Usare properties.extendedInfo.includedDatabases per identificare i database figli inclusi nello snapshot. La risposta contiene anche i percorsi del disco sorgente e i metadati snapshot necessari per il ripristino.

  3. Recupera l'elemento protetto dell'istanza SQL e salvalo properties.protectedItemDataSourceId.

    GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLInstance%3Bmssqlserver?api-version=2023-01-15
    
  4. Per ogni database incluso, elencare l'intervallo di log associato allo snapshot dell'istanza selezionata.

    GET "https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLDataBase%3Bmssqlserver%3B{databaseName}/recoveryPoints?api-version=2023-01-15&$filter=restorePointQueryType eq 'Log' and recoveryMode eq 'SnapshotAttachAndRecover' and baseSnapshotRPId eq '{instanceSnapshotRecoveryPointId}' and baseRPDatasourceId eq '{instanceProtectedItemDataSourceId}'"
    

    La risposta contiene un DefaultRangeRecoveryPoint. Scegliere un UTC pointInTime che rientri in properties.timeRanges restituito per ogni database ripristinato.

Ottieni il token di accesso per lo snapshot dell'istanza

Recupera le proprietà Microsoft Entra per la regione secondaria.

GET "https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{secondaryRegion}/backupAadProperties?api-version=2023-01-15&$filter=backupManagementType eq 'AzureWorkload'"

Passare l'oggetto restituito properties nel corpo della richiesta quando si richiede un token di accesso per l'istanza SQL e il punto di ripristino dello snapshot selezionato.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLInstance%3Bmssqlserver/recoveryPoints/{instanceSnapshotRecoveryPointId}/accessToken?api-version=2023-01-15
{
  "properties": {
    "tenantId": "<tenant-id>",
    "audience": "<audience-returned-by-the-service>",
    "servicePrincipalObjectId": "<service-principal-object-id>",
    "identityVersion": 1
  }
}

Attivare il ripristino temporizzato dell'istanza SQL

Uso di AzureWorkloadSQLPointInTimeRestoreRequest con SnapshotAttachAndRecover. Copiare l'oggetto completo properties dalla risposta del access-token in crossRegionRestoreAccessDetails.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{secondaryRegion}/backupCrossRegionRestore?api-version=2023-01-15
{
  "crossRegionRestoreAccessDetails": {
    "objectType": "WorkloadCrrAccessToken",
    "accessTokenString": "<access-token-string>",
    "recoveryPointId": "<instance-snapshot-recovery-point-id>",
    "datasourceType": "SQLInstance",
    "datasourceName": "mssqlserver"
  },
  "restoreRequest": {
    "objectType": "AzureWorkloadSQLPointInTimeRestoreRequest",
    "shouldUseAlternateTargetLocation": true,
    "recoveryMode": "SnapshotAttachAndRecover",
    "isNonRecoverable": false,
    "recoveryType": "AlternateLocation",
    "sourceResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{sourceVmResourceGroup}/providers/Microsoft.Compute/virtualMachines/{sourceVmName}",
    "targetVirtualMachineId": "/subscriptions/{subscriptionId}/resourceGroups/{targetVmResourceGroup}/providers/Microsoft.Compute/virtualMachines/{targetVmName}",
    "targetResourceGroupName": "{targetVmResourceGroup}",
    "pointInTime": "2026-08-09T17:18:23.500Z",
    "alternateDirectoryPaths": [
      {
        "mappingType": "DiskDrives",
        "sourcePath": "F:\\",
        "targetPath": "J:\\"
      },
      {
        "mappingType": "DiskDrives",
        "sourcePath": "G:\\",
        "targetPath": "K:\\"
      }
    ],
    "targetInfo": {
      "containerId": "/subscriptions/{subscriptionId}/resourceGroups/{targetVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{targetVaultName}/backupFabrics/Azure/protectionContainers/{targetContainerName}",
      "overwriteOption": "FailOnConflict",
      "databaseName": "MSSQLSERVER/*_{databaseNameSuffix}"
    },
    "userAssignedManagedIdentityDetails": {
      "identityArmId": "/subscriptions/{subscriptionId}/resourceGroups/{identityResourceGroup}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}",
      "userAssignedIdentityProperties": {
        "clientId": "<managed-identity-client-id>",
        "principalId": "<managed-identity-principal-id>"
      }
    }
  }
}

L'oggetto abbreviato crossRegionRestoreAccessDetails sopra mostra i campi che identificano lo scenario di istanza. Nella richiesta vera e propria, copia ogni proprietà restituita dall'API di access-token, inclusa tokenExtendedInformation quando è presente.

Esegui il ripristino dei log cross-region per un database figlio protetto da una policy snapshot

Usare questo flusso per ripristinare un database figlio a un punto temporale selezionato quando il database è protetto come parte di un criterio di snapshot dell'istanza SQL.

Importante

Per un ripristino del log del database figlio, richiedere il token di accesso sull'elemento protetto figlio SQLDataBase e DefaultRangeRecoveryPoint. Non richiedere il token sul punto di recupero dell'istanza SQL principale.

Scopri l'intervallo di log del database figlio

Elencare i punti di ripristino dei log per l'elemento protetto del database secondario.

GET "https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLDataBase%3Bmssqlserver%3B{databaseName}/recoveryPoints?api-version=2023-01-15&$filter=restorePointQueryType eq 'Log'"

La risposta contiene un DefaultRangeRecoveryPoint con uno o più intervalli UTC:

{
  "value": [
    {
      "name": "DefaultRangeRecoveryPoint",
      "properties": {
        "objectType": "AzureWorkloadSQLPointInTimeRecoveryPoint",
        "timeRanges": [
          {
            "startTime": "2026-07-26T19:25:29.9811766Z",
            "endTime": "2026-08-10T18:31:23Z"
          }
        ],
        "type": "Log"
      }
    }
  ]
}

Scegli un'ora UTC pointInTime all'interno di uno degli intervalli restituiti.

Ottieni il token di accesso per l'intervallo di log del database figlio

Recupera le proprietà Microsoft Entra per la regione secondaria usando il filtro di carico di lavoro Azure mostrato nella sezione istanza SQL. Passa l'oggetto restituito properties quando richiedi il token di accesso al database figlio.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{sourceVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{sourceVaultName}/backupFabrics/Azure/protectionContainers/{sourceContainerName}/protectedItems/SQLDataBase%3Bmssqlserver%3B{databaseName}/recoveryPoints/DefaultRangeRecoveryPoint/accessToken?api-version=2023-01-15

Le proprietà del token di accesso restituite identificano il database figlio selezionato con valori quali:

{
  "properties": {
    "protectableObjectUniqueName": "MSSQLSERVER/{databaseName}",
    "protectableObjectFriendlyName": "{databaseName}",
    "objectType": "WorkloadCrrAccessToken",
    "accessTokenString": "<access-token-string>",
    "recoveryPointId": "DefaultRangeRecoveryPoint",
    "datasourceType": "SQLDataBase",
    "datasourceName": "{databaseName}"
  }
}

Attiva il ripristino del log del database figlio

Uso di AzureWorkloadSQLPointInTimeRestoreRequest con SnapshotAttachAndRecover. Il nome del database target deve utilizzare il formato del percorso logico MSSQLSERVER/{targetDatabaseName}.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{secondaryRegion}/backupCrossRegionRestore?api-version=2023-01-15
{
  "crossRegionRestoreAccessDetails": {
    "objectType": "WorkloadCrrAccessToken",
    "accessTokenString": "<access-token-string>",
    "recoveryPointId": "DefaultRangeRecoveryPoint",
    "datasourceType": "SQLDataBase",
    "datasourceName": "{databaseName}"
  },
  "restoreRequest": {
    "objectType": "AzureWorkloadSQLPointInTimeRestoreRequest",
    "shouldUseAlternateTargetLocation": true,
    "recoveryMode": "SnapshotAttachAndRecover",
    "isNonRecoverable": false,
    "recoveryType": "AlternateLocation",
    "sourceResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{sourceVmResourceGroup}/providers/Microsoft.Compute/virtualMachines/{sourceVmName}",
    "targetVirtualMachineId": "/subscriptions/{subscriptionId}/resourceGroups/{targetVmResourceGroup}/providers/Microsoft.Compute/virtualMachines/{targetVmName}",
    "targetResourceGroupName": "{targetVmResourceGroup}",
    "pointInTime": "2026-08-03T06:58:26Z",
    "alternateDirectoryPaths": [
      {
        "mappingType": "DiskDrives",
        "sourcePath": "F:\\",
        "targetPath": "J:\\"
      },
      {
        "mappingType": "DiskDrives",
        "sourcePath": "G:\\",
        "targetPath": "K:\\"
      }
    ],
    "targetInfo": {
      "containerId": "/subscriptions/{subscriptionId}/resourceGroups/{targetVaultResourceGroup}/providers/Microsoft.RecoveryServices/vaults/{targetVaultName}/backupFabrics/Azure/protectionContainers/{targetContainerName}",
      "overwriteOption": "FailOnConflict",
      "databaseName": "MSSQLSERVER/{targetDatabaseName}"
    },
    "userAssignedManagedIdentityDetails": {
      "identityArmId": "/subscriptions/{subscriptionId}/resourceGroups/{identityResourceGroup}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}",
      "userAssignedIdentityProperties": {
        "clientId": "<managed-identity-client-id>",
        "principalId": "<managed-identity-principal-id>"
      }
    }
  }
}

Come per la richiesta dell'istanza, copiare l'oggetto access-token properties completo in crossRegionRestoreAccessDetails. Tratta accessTokenString e tokenExtendedInformation come segreti e non scriverli nei log né includerli negli artefatti condivisi.

In entrambi gli scenari puntuali, il trigger è asincrono. Seguire le intestazioni di risposta Azure-AsyncOperation, Location e Retry-After e verificare lo stato terminale del processo dell'insieme di credenziali di Servizi di ripristino risultante prima di considerare il ripristino riuscito.

Passaggi successivi

Gestire i database di SQL Server in macchine virtuali di Azure con il portale di Azure, l'interfaccia della riga di comando di Azure, l'API REST.

Per altre informazioni sulle API REST di Backup di Azure, vedere i documenti seguenti: