Restaurar um contêiner ou banco de dados excluído para a mesma conta do Azure Cosmos DB

APLICA-SE AO: NoSQL MongoDB Gremlin Table

O mesmo recurso de restauração de conta pontual do Azure Cosmos DB ajuda você a se recuperar de uma exclusão acidental de um contêiner ou banco de dados. Esse recurso restaura o banco de dados ou contêiner excluído em uma mesma conta existente em qualquer região em que os backups existam. O modo de backup contínuo permite restaurar qualquer momento dos últimos 30 dias.

Pré-requisitos

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
• Uma conta do Azure Cosmos DB. Você pode escolher uma das seguintes opções para uma conta do Azure Cosmos DB:
  • Use uma conta existente do Azure Cosmos DB.
  • Crie uma nova conta do Azure Cosmos DB em sua assinatura do Azure.
  • Crie uma conta gratuita do Azure Cosmos DB e experimente sem compromisso.

Restaurar um contêiner ou banco de dados excluído

Use o portal do Azure, a CLI do Azure, o Azure PowerShell ou um modelo de Azure Resource Manager para restaurar um contêiner ou banco de dados excluído em uma mesma conta existente.

Portal do Azure

Use o portal do Azure para restaurar um contêiner ou banco de dados excluído. Contêineres filho também são restaurados.

1. Acesse o portal do Azure.

2. Acesse sua conta do Azure Cosmos DB e depois abra a página Recuperação pontual.

   Observação

   A página Restaurar no portal do Azure só será preenchida se você tiver a permissão Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read. Para saber mais sobre essa permissão, confira Permissões de backup e restauração.

3. Selecione a guia Restaurar na mesma conta.

   

4. No campo Banco de dados, insira uma consulta de pesquisa para filtrar o feed de eventos com base em eventos de exclusão pertinentes de um contêiner ou um banco de dados.

   

5. Em seguida, especifique os valores Início e Fim a fim de criar um período de tempo a ser usado na filtragem dos eventos de exclusão.

   

   Observação

   O filtro Início é limitado a, no máximo, 30 dias antes da data atual.

6. Selecione Atualizar para atualizar a lista de eventos com base nos diferentes tipos de recurso com seus filtros aplicados.

7. Verifique a hora e depois selecione Restaurar para iniciar a restauração do recurso selecionado que foi excluído previamente.

   

   Importante

   Não mais do que três operações de restauração podem estar ativas simultaneamente na mesma conta. A exclusão da conta de origem durante o andamento de uma operação de restauração pode resultar na falha da operação de restauração.

   Observação

   O feed de eventos exibe os recursos como Não restaurável. O feed fornece mais informações do motivo pelo qual o recurso não pode ser restaurado. Na maioria dos casos, você deve restaurar o banco de dados pai antes de restaurar qualquer um dos contêineres filho do banco de dados.

8. Depois de iniciar uma operação de restauração, acompanhe a operação na área de notificações do portal do Azure. A notificação fornece o status do recurso que está sendo restaurado. Enquanto a restauração estiver em andamento, o status do contêiner será Criando. Após a conclusão da operação de restauração, o status mudará para Online.

CLI do Azure

Use a CLI do Azure para restaurar um contêiner ou banco de dados excluído. Contêineres filho também são restaurados.

Importante

A CLI do Azure versão 2.58.0 ou posterior é necessária para acessar o comando de restauração na conta.

1. Recupere uma lista de todas as contas de banco de dados ativas e excluídas restauráveis usando az cosmosdb restorable-database-account list:

   az cosmosdb restorable-database-account list \
       --account-name <name-of-account>
   

   [
     {
       "accountName": "deleted-account-1",
       "apiType": "Sql",
       "creationTime": "2020-08-02T22:23:00.095870+00:00",
       "deletionTime": "2020-08-02T22:26:13.483175+00:00",
       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234",
       "location": "West US",
       "name": "abcd1234-d1c0-4645-a699-abcd1234",
       "restorableLocations": [
         {
           "locationName": "West US"
         },
         {
           "locationName": "East US"
         }
       ]
     }
   ]
   

2. Use az cosmosdb sql restorable-database list para listar todas as versões restauráveis de bancos de dados de contas ativas:

   az cosmosdb sql restorable-database list \
       --instance-id <instance-id-of-account> \
       --location <location>
   

   Observação

   A listagem de todos os eventos de exclusão de bancos de dados restauráveis permite escolher o banco de dados correto em um cenário em que o horário real da criação é desconhecido. Se o feed de eventos contiver o tipo de operação Excluir na sua resposta, ele será um banco de dados excluído e poderá ser restaurado na mesma conta. O carimbo de data/hora da restauração pode ser definido como qualquer carimbo de data/hora antes do carimbo de data/hora de exclusão e dentro do período de retenção.

3. Use az cosmosdb sql restorable-container list para listar todas as versões de contêineres restauráveis em um banco de dados específico:

   az cosmosdb sql restorable-container list \
       --instance-id <instance-id-of-account> \
       --database-rid <owner-resource-id-of-database> \
       --location <location>
   

   Observação

   A listagem de todos os eventos de exclusão de bancos de dados restauráveis permite escolher o contêiner correto em um cenário em que o horário real da criação é desconhecido. Se o feed de eventos contiver o tipo de operação Excluir na sua resposta, ele será um contêiner excluído e poderá ser restaurado na mesma conta. O carimbo de data/hora da restauração pode ser definido como qualquer carimbo de data/hora antes do carimbo de data/hora de exclusão e dentro do período de retenção.

4. Inicie uma operação de restauração para um banco de dados excluído usando restauração do banco de dados sql do az cosmosdb. O carimbo de data/hora de restauração é opcional, se não for fornecido que a última instância excluída do banco de dados seja restaurada.

   az cosmosdb sql database restore \
        --resource-group <resource-group-name> \ 
        --account-name <account-name> \  
        --name <database-name> \
        --restore-timestamp <timestamp> \
        --disable-ttl True
   

5. Inicie uma operação de restauração para um contêiner excluído usando restauração de contêiner sql do az cosmosdb. O carimbo de data/hora de restauração é opcional, se não for fornecido que a última instância excluída do contêiner seja restaurada.

   az cosmosdb sql container restore \
        --resource-group <resource-group-name> \ 
        --account-name <account-name> \  
        --database-name <database-name> \
        --name <container-name> \
        --restore-timestamp <timestamp> \
        --disable-ttl True
   
   

1. Recupere uma lista de todas as contas de banco de dados ativas e excluídas restauráveis usando az cosmosdb restorable-database-account list:

   az cosmosdb restorable-database-account list \
       --account-name <name-of-account>
   

   [
     {
       "accountName": "deleted-account-1",
       "apiType": "Sql",
       "creationTime": "2020-08-02T22:23:00.095870+00:00",
       "deletionTime": "2020-08-02T22:26:13.483175+00:00",
       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234",
       "location": "West US",
       "name": "abcd1234-d1c0-4645-a699-abcd1234",
       "restorableLocations": [
         {
           "locationName": "West US"
         },
         {
           "locationName": "East US"
         }
       ]
     }
   ]
   

2. Use az cosmosdb mongodb restorable-database list para listar todas as versões restauráveis de bancos de dados de contas ativas:

   az cosmosdb mongodb restorable-database list \
       --instance-id <instance-id-of-account> \
       --location <location>
   

3. Use az cosmosdb mongodb restorable-collection list para listar todas as versões de coleções restauráveis em um banco de dados específico:

   az cosmosdb mongodb restorable-collection list \
       --instance-id <instance-id-of-account> \
       --database-rid <owner-resource-id-of-database> \
       --location <location>
   

4. Inicie uma operação de restauração para um banco de dados excluído usando restauração do banco de dados mongodb do az cosmosdb. O carimbo de data/hora de restauração será opcional, se não tiver fornecido a última instância excluída do banco de dados for restaurada.

   az cosmosdb mongodb database restore \
        --resource-group <resource-group-name> \ 
        --account-name <account-name> \  
        --name <database-name> \
        --restore-timestamp <timestamp>
        --disable-ttl True
   

5. Inicie uma operação de restauração para uma coleção excluída usando restauração da coleção do mongodb do az cosmosdb, o carimbo de data/hora de restauração será opcional, se não for fornecida a última instância excluída da coleção for restaurada.

   az cosmosdb mongodb collection restore \
        --resource-group <resource-group-name> \ 
        --account-name <account-name> \   
        --database-name <database-name> \
        --name <container-name> \
        --restore-timestamp <timestamp> \
        --disable-ttl True
   

1. Recupere uma lista de todas as contas de banco de dados ativas e excluídas restauráveis usando az cosmosdb restorable-database-account list:

   az cosmosdb restorable-database-account list \
       --account-name <name-of-account>
   

   [
     {
       "accountName": "deleted-account-1",
       "apiType": "Sql",
       "creationTime": "2020-08-02T22:23:00.095870+00:00",
       "deletionTime": "2020-08-02T22:26:13.483175+00:00",
       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234",
       "location": "West US",
       "name": "abcd1234-d1c0-4645-a699-abcd1234",
       "restorableLocations": [
         {
           "locationName": "West US"
         },
         {
           "locationName": "East US"
         }
       ]
     }
   ]
   

2. Use az cosmosdb gremlin restorable-database list para listar todas as versões restauráveis de bancos de dados de contas ativas:

   az cosmosdb gremlin restorable-database list \
       --instance-id <instance-id-of-account> \
       --location <location>
   

3. Use az cosmosdb gremlin restorable-graph list para listar todas as versões de gráficos restauráveis em um banco de dados específico:

   az cosmosdb gremlin restorable-graph list \
       --instance-id <instance-id-of-account> \
       --database-rid <owner-resource-id-of-database> \
       --location <location>
   

4. Inicie uma operação de restauração para um banco de dados excluído usando restauração do banco de dados gremlin do az cosmosdb. O carimbo de data/hora de restauração é opcional, se não for fornecido que a última instância excluída do banco de dados seja restaurada.

   az cosmosdb gremlin database restore \
       --resource-group <resource-group-name> \ 
       --account-name <account-name> \  
       --name <database-name> \ 
       --restore-timestamp <timestamp> \
       --disable-ttl True
   

5. Inicie uma operação de restauração para um grafo excluído usando restauração do grafo gremlin do az cosmosdb. O carimbo de data/hora de restauração será opcional, se não for fornecida a última instância excluída do grafo for restaurada.

   az cosmosdb gremlin graph restore \
       --resource-group <resource-group-name> \ 
       --account-name <account-name> \  
       --database-name <database-name> \ 
       --name <graph-name> \ 
       --restore-timestamp <timestamp> \
       --disable-ttl True
   

1. Recupere uma lista de todas as contas de banco de dados ativas e excluídas restauráveis usando az cosmosdb restorable-database-account list:

   az cosmosdb restorable-database-account list \
       --account-name <name-of-account>
   

   [
     {
       "accountName": "deleted-account-1",
       "apiType": "Sql",
       "creationTime": "2020-08-02T22:23:00.095870+00:00",
       "deletionTime": "2020-08-02T22:26:13.483175+00:00",
       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234",
       "location": "West US",
       "name": "abcd1234-d1c0-4645-a699-abcd1234",
       "restorableLocations": [
         {
           "locationName": "West US"
         },
         {
           "locationName": "East US"
         }
       ]
     }
   ]
   

2. Use az cosmosdb table restorable-table list para listar todas as versões restauráveis de tabelas de contas ativas:

   az cosmosdb table restorable-table list \
       --instance-id <instance-id-of-account> \
       --location <location>
   

3. Inicie uma operação de restauração para uma tabela excluída usando restauração da tabela do az cosmosdb. O carimbo de data/hora de restauração será opcional, se não for fornecida a última instância excluída da tabela for restaurada.

   az cosmosdb table restore \
        --resource-group <resource-group-name> \
        --account-name <account-name> \
        --table-name <table-name> \
        --restore-timestamp <timestamp> \
        --disable-ttl True
   

PowerShell do Azure

Use o Azure PowerShell para restaurar um contêiner ou banco de dados excluído. Contêineres e bancos de dados filho também são restaurados.

Importante

O módulo Az.Cosmos DB para o Azure PowerShell versão 1.14.1 ou posterior é necessário para acessar os cmdlets de restauração na conta.

1. Recupere uma lista de todas as contas de banco de dados restauráveis ativas e excluídas usando o cmdlet [Get-AzCosmosDBRestorableDatabaseAccount](/powershell/module/az.cosmosdb/get-azCosmos DBrestorabledatabaseaccount):

   Get-AzCosmosDBRestorableDatabaseAccount
   

   Id                        : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234
   DatabaseAccountInstanceId : abcd1234-d1c0-4645-a699-abcd1234
   Location                  : West US
   DatabaseAccountName       : deleted-account-1
   CreationTime              : 8/2/2020 10:23:00 PM
   DeletionTime              : 8/2/2020 10:26:13 PM
   ApiType                   : Sql
   RestorableLocations       : {West US, East US}
   

   Observação

   A conta tem os campos de CreationTime ou DeletionTime. Esses campos também existem para regiões. Essas horas permitem que escolher a região certa e um intervalo de tempo válido para usar na hora de restaurar um recurso.

2. Use o cmdlet Get-AzCosmosDBSqlRestorableDatabase para listar todas as versões restauráveis de bancos de dados de contas ativas:

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       Location = "<location>"
   }
   Get-AzCosmosDBSqlRestorableDatabase @parameters
   

   Observação

   A listagem de todos os eventos de exclusão de bancos de dados restauráveis permite que você escolha o banco de dados correto em um cenário em que o horário real da criação é desconhecido. Se o feed de eventos contiver o tipo de operação Excluir na sua resposta, ele será um banco de dados excluído e poderá ser restaurado na mesma conta. O carimbo de data/hora de restauração pode ser definido como qualquer carimbo de data/hora antes do carimbo de data/hora de exclusão e dentro da janela de retenção.

3. Use o cmdlet Get-AzCosmosDBSqlRestorableContainer para listar todas as versões de contêineres restauráveis em um banco de dados específico:

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       DatabaseRId = "<owner-resource-id-of-database>"
       Location = "<location>"
   }
   Get-AzCosmosDBSqlRestorableContainer @parameters    
   

   Observação

   A listagem de todos os eventos de exclusão de bancos de dados restauráveis permite que você escolha o contêiner correto em um cenário em que o horário real da criação é desconhecido. Se o feed de eventos contiver o tipo de operação Excluir na sua resposta, ele será um contêiner excluído e poderá ser restaurado na mesma conta. O carimbo de data/hora de restauração pode ser definido como qualquer carimbo de data/hora antes do carimbo de data/hora de exclusão e dentro da janela de retenção.

4. Inicie uma operação de restauração para um banco de dados excluído usando o cmdlet Restore-AzCosmos DBSqlDatabase. O carimbo de data/hora de restauração é opcional. Na ausência desse carimbo de data/hora, a última instância excluída do banco de dados é restaurada.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       Name = "<database-name>"
       RestoreTimestampInUtc = "<timestamp>"
   }
   Restore-AzCosmos DBSqlDatabase @parameters
   

5. Inicie uma operação de restauração para um contêiner excluído usando o cmdlet Restore-AzCosmos DBSqlContainer. O carimbo de data/hora de restauração é opcional. Na ausência desse carimbo de data/hora, a última instância excluída do contêiner é restaurada.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       DatabaseName = "<database-name>"
       Name = "<container-name>"
       RestoreTimestampInUtc = "<timestamp>"
       DisableTtl= $true
   }
   Restore-AzCosmos DBSqlContainer @parameters 
   

1. Recupere uma lista de todas as contas de banco de dados ativas e excluídas restauráveis usando o cmdlet Get-AzCosmosDBRestorableDatabaseAccount:

   Get-AzCosmosDBRestorableDatabaseAccount
   

   Id                        : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234
   DatabaseAccountInstanceId : abcd1234-d1c0-4645-a699-abcd1234
   Location                  : West US
   DatabaseAccountName       : deleted-account-1
   CreationTime              : 8/2/2020 10:23:00 PM
   DeletionTime              : 8/2/2020 10:26:13 PM
   ApiType                   : Sql
   RestorableLocations       : {West US, East US}
   

   Observação

   A conta tem os campos de CreationTime ou DeletionTime. Esses campos também existem para regiões. Essas horas permitem que escolher a região certa e um intervalo de tempo válido para usar na hora de restaurar um recurso.

2. Use Get-AzCosmosDBMongoDBRestorableDatabase para listar todas as versões restauráveis de bancos de dados para contas ativas:

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       Location = "<location>"
   }
   Get-AzCosmosDBMongoDBRestorableDatabase @parameters
   

3. Use o cmdlet Get-AzCosmosDBMongoDBRestorableCollection para listar todas as versões de coleções restauráveis em um banco de dados específico. O carimbo de data/hora de restauração é opcional. Na ausência dessa última instância excluída do carimbo de data/hora da coleção, é restaurada.

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       DatabaseRId = "<owner-resource-id-of-database>"
       Location = "<location>"
   }
   Get-AzCosmosDBMongoDBRestorableCollection @parameters      
   

4. Inicie uma operação de restauração para um banco de dados excluído usando o cmdlet Restore-AzCosmos DBMongoDBDatabase:

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       Name = "<database-name>"
       RestoreTimestampInUtc = "<timestamp>"
       DisableTtl=$true 
   }
   Restore-AzCosmos DBMongoDBDatabase @parameters 
   

5. Inicie uma operação de restauração para uma coleção excluída usando o cmdlet Restore-AzCosmos DBMongoDBCollection. O carimbo de data/hora de restauração é opcional, se não for fornecida a última instância excluída da coleção será restaurada.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       DatabaseName = "<database-name>"
       Name = "<collection-name>"
       RestoreTimestampInUtc = "<timestamp>"
       DisableTtl=$true 
   }
   Restore-AzCosmos DBMongoDBCollection @parameters   
   

1. Recupere uma lista de todas as contas de banco de dados ativas e excluídas restauráveis usando o cmdlet Get-AzCosmosDBRestorableDatabaseAccount:

   Get-AzCosmosDBRestorableDatabaseAccount
   

   Id                        : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234
   DatabaseAccountInstanceId : abcd1234-d1c0-4645-a699-abcd1234
   Location                  : West US
   DatabaseAccountName       : deleted-account-1
   CreationTime              : 8/2/2020 10:23:00 PM
   DeletionTime              : 8/2/2020 10:26:13 PM
   ApiType                   : Sql
   RestorableLocations       : {West US, East US}
   

   Observação

   A conta tem os campos de CreationTime ou DeletionTime. Esses campos também existem para regiões. Essas horas permitem que escolher a região certa e um intervalo de tempo válido para usar na hora de restaurar um recurso.

2. Use o cmdlet Get-AzCosmosDBGremlinRestorableDatabase para listar todas as versões restauráveis de bancos de dados para contas ativas:

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       Location = "<location>"
   }
   Get-AzCosmosDBGremlinRestorableDatabase @parameters
   

3. Use o cmdlet Get-AzCosmosDBGremlinRestorableGraph para listar todas as versões de grafos restauráveis que estão em um banco de dados específico:

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       DatabaseRId = "<owner-resource-id-of-database>"
       Location = "<location>"
   }
   Get-AzCosmosDBGremlinRestorableGraph @parameters      
   

4. Inicie uma operação de restauração para um banco de dados excluído usando o cmdlet Restore-AzCosmos DBGremlinDatabase, o carimbo de data/hora de restauração será opcional, se não for fornecido que a última instância excluída do banco de dados seja restaurada.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       Name = "<database-name>"
       RestoreTimestampInUtc = "<timestamp>"
       DisableTtl=$true 
   }
   Restore-AzCosmos DBGremlinDatabase @parameters
   

5. Inicie uma operação de restauração para um grafo excluído usando o cmdlet Restore-AzCosmos DBGremlinGraph, o carimbo de data/hora de restauração será opcional, se não for fornecido que a última instância excluída do grafo seja restaurada.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       DatabaseName = "<database-name>"
       Name = "<graph-name>"
       RestoreTimestampInUtc = "<timestamp>"
       DisableTtl=$true 
   }
   Restore-AzCosmos DBGremlinGraph @parameters 
   

1. Recupere uma lista de todas as contas de banco de dados restauráveis ativas e excluídas usando o cmdlet [Get-AzCosmosDBRestorableDatabaseAccount](/powershell/module/az.cosmosdb/get-azCosmos DBrestorabledatabaseaccount):

   Get-AzCosmosDBRestorableDatabaseAccount
   

   Id                        : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234
   DatabaseAccountInstanceId : abcd1234-d1c0-4645-a699-abcd1234
   Location                  : West US
   DatabaseAccountName       : deleted-account-1
   CreationTime              : 8/2/2020 10:23:00 PM
   DeletionTime              : 8/2/2020 10:26:13 PM
   ApiType                   : Sql
   RestorableLocations       : {West US, East US}
   

   Observação

   A conta tem os campos de CreationTime ou DeletionTime. Esses campos também existem para regiões. Essas horas permitem que escolher a região certa e um intervalo de tempo válido para usar na hora de restaurar um recurso.

2. Use o cmdlet [Get-AzCosmosDBTableRestorableTable](/powershell/module/az.cosmosdb/get-azCosmos DBtablerestorabletable) para listar todas as versões restauráveis de tabelas para contas dinâmicas:

   $parameters = @{
       DatabaseAccountInstanceId = "<instance-id-of-account>"
       Location = "<location>"
   }
   Get-AzCosmosDBTableRestorableTable @parameters
   

3. Inicie uma operação de restauração para uma tabela excluída usando o cmdlet Restore-AzCosmos DBTable, o carimbo de data/hora de restauração será opcional, se não for fornecido que a última instância excluída da tabela seja restaurada.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       AccountName = "<account-name>"
       Name = "<table-name>"
       RestoreTimestampInUtc = "<timestamp>"
       DisableTtl=$true 
   }
   Restore-AzCosmos DBTable @parameters
   

Modelo do Azure Resource Manager

Você pode restaurar contêineres e bancos de dados excluídos usando um modelo do Azure Resource Manager.

1. Crie ou localize um recurso do Azure Cosmos DB em seu modelo. Aqui está um exemplo genérico de um recurso:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "resources": [
       {
         "name": "msdocs-example-arm",
         "type": "Microsoft.DocumentDB/databaseAccounts",
         "apiVersion": "2022-02-15-preview",
         "location": "West US",
         "properties": {
           "locations": [
             {
               "locationName": "West US"
             }
           ],
           "backupPolicy": {
             "type": "Continuous"
           },
           "databaseAccountOfferType": "Standard"
         }
       }
     ]
   }    
   

2. Para atualizar o recurso do Azure Cosmos DB em seu modelo:

   • Defina properties.createMode como restore.
   • Defina um objeto properties.restoreParameters.
   • Defina properties.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
   • Defina properties.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

   {
     "properties": {
       "name": "<name-of-database-or-container>",
       "restoreParameters": {
         "restoreSource": "<source-account-instance-id>",
         "restoreTimestampInUtc": "<timestamp>",
         "restoreWithTtlDisabled": "true" 
       },
       "createMode": "Restore"
     }
   }
   

Para restaurar um contêiner sql, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/databasename>/<containername>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome do contêiner.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources":[{
            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
            "apiVersion": "2023-11-15",
            "name": "<accountname>/<databasename>/<containername>",
            "properties": {
                "resource": {
                    "id": "<containername>",
                    "restoreParameters": {
                        "restoreSource": "/subscriptions/<subscriptionid>/providers/Microsoft.DocumentDB/locations/<lowercaselocationwithoutspace>/restorableDatabaseAccounts/<databaseaccountinstanceId>",
                        "restoreTimestampInUtc": "<restore timestamp is utc iso format>"
                    },
                    "createMode": "Restore"
                }
            }
        }
    ]
}

Para restaurar um banco de dados sql, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/databasename>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome do banco de dados.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "resources": [ 
        { 
            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases", 
            "apiVersion": "2023-11-15", 
            "name": "<account name>/<database name>", 
            "properties": { 
                "resource": { 
                    "id": "<database name>", 
                    "restoreParameters": { 
                        "restoreSource": "/subscriptions/<subscriptionId>/providers/Microsoft.DocumentDB/locations/<location>/restorableDatabaseAccounts/<databaseaccountinstanceid>", 
                        "restoreTimestampInUtc": "restore timestamp" 
                    }, 
                    "createMode": "Restore" 
                } 
            } 
        } 
    ] 
}

{
  "properties": {
    "name": "<name-of-database-or-collection>",
    "restoreParameters": {
      "restoreSource": "<source-account-instance-id>",
      "restoreTimestampInUtc": "<timestamp>",
      "restoreWithTtlDisabled": "true" 
    },
    "createMode": "Restore"
    }
}

Para restaurar uma coleção mongo, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/databasename>/<collectionname>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome da coleção.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "resources": [ 
        { 
            "type": "Microsoft.DocumentDB/databaseAccounts/ mongoDBDatabases/collections", 
            "apiVersion": "2023-11-15", 
            "name": "<accountname>/<databasename>/<collectionname>", 
            "properties": { 
                "resource": { 
                    "id": "<collectionname>", 
                    "restoreParameters": { 
                        "restoreSource": "/subscriptions/<subscriptionid>/providers/Microsoft.DocumentDB/locations/<lowercaselocationwithoutspace>/restorableDatabaseAccounts/<databaseaccountinstanceId>", 
                        "restoreTimestampInUtc": "<restore timestamp is utc iso format>" 
                    }, 
                    "createMode": "Restore" 
                } 
            } 
        } 
    ] 
} 

Para restaurar um banco de dados mongo, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/databasename>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome do banco de dados.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "resources": [ 
        { 
            "type": "Microsoft.DocumentDB/databaseAccounts/mongoDBDatabases", 
            "apiVersion": "2023-11-15", 
            "name": "<account name>/<database name>", 
            "properties": { 
                "resource": { 
                    "id": "<database name>", 
                    "restoreParameters": { 
                        "restoreSource": "/subscriptions/<subscriptionId>/providers/Microsoft.DocumentDB/locations/<location>/restorableDatabaseAccounts/<databaseaccountinstanceid>", 
                        "restoreTimestampInUtc": "restore timestamp" 
                    }, 
                    "createMode": "Restore" 
                } 
            } 
        } 
    ] 
} 

{
  "properties": {
    "name": "<name-of-database-or-graph>",
    "restoreParameters": {
      "restoreSource": "<source-account-instance-id>",
      "restoreTimestampInUtc": "<timestamp>",
      "restoreWithTtlDisabled": "true" 
      },
    "createMode": "Restore"
    }
}

Para restaurar um grafo gremlin, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/databasename>/<graphname>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome do grafo.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "resources": [ 
        { 
            "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/graphs", 
            "apiVersion": "2023-11-15", 
            "name": "<accountname>/<databasename>/<graphname>", 
            "properties": { 
                "resource": { 
                    "id": "<graphname>", 
                    "restoreParameters": { 
                        "restoreSource": "/subscriptions/<subscriptionid>/providers/Microsoft.DocumentDB/locations/<lowercaselocationwithoutspace>/restorableDatabaseAccounts/<databaseaccountinstanceId>", 
                        "restoreTimestampInUtc": "<restore timestamp is utc iso format>" 
                    }, 
                    "createMode": "Restore" 
                } 
            } 
        } 
    ] 
} 

Para restaurar um banco de dados gremlin, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/databasename>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome do banco de dados.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "resources": [ 
        { 
            "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases", 
            "apiVersion": "2023-11-15", 
            "name": "<account name>/<database name>", 
            "properties": { 
                "resource": { 
                    "id": "<database name>", 
                    "restoreParameters": { 
                        "restoreSource": "/subscriptions/<subscriptionId>/providers/Microsoft.DocumentDB/locations/<location>/restorableDatabaseAccounts/<databaseaccountinstanceid>", 
                        "restoreTimestampInUtc": "restore timestamp" 
                    }, 
                    "createMode": "Restore" 
                } 
            } 
        } 
    ] 
} 

{
  "properties": {
  "name": "<name-of-table>",
  "restoreParameters": {
    "restoreSource": "<source-account-instance-id>",
    "restoreTimestampInUtc": "<timestamp>", 
    "restoreWithTtlDisabled": "true" 
    },
    "createMode": "Restore"
    }
}

Para restaurar uma tabela, atualize o seguinte modelo da seguinte maneira:

• Definir resources.name como <accountname>/tablename>
• Defina resources.properties.resource.createMode para restaurar.
• Defina resources.properties.resource.restoreParameters.id nome da tabela.
• Defina resources.properties.resource.restoreParameters.restoreTimestampInUtc como um carimbo de data/hora UTC.
• Defina resources.properties.resource.restoreParameters.restoreSource como o identificador de instância da conta que é a origem da operação de restauração.

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "resources": [ 
        { 
            "type": "Microsoft.DocumentDB/databaseAccounts/tables", 
            "apiVersion": "2023-11-15", 
            "name": "<account name>/<table name>", 
            "properties": { 
                "resource": { 
                    "id": "<table name>", 
                    "restoreParameters": { 
                        "restoreSource": "/subscriptions/<subscriptionId>/providers/Microsoft.DocumentDB/locations/<location>/restorableDatabaseAccounts/<databaseaccountinstanceid>", 
                        "restoreTimestampInUtc": "restore timestamp" 
                    }, 
                    "createMode": "Restore" 
                } 
            } 
        } 
    ] 
} 

Observação

Use az cosmosdb restorable-database-account list para recuperar uma lista de identificadores de instância de todas as contas de banco de dados ativas e excluídas restauráveis.

1. Implante o modelo usando az deployment group create:

   az deployment group create \
       --resource-group <resource-group-name> \
       --template-file <template-filename>
   

Acompanhar o status de uma operação de restauração

Quando uma recuperação pontual é disparada para um contêiner ou banco de dados excluído, a operação é identificada como uma operação de restauração InAccount do recurso.

Portal do Azure

Para obter uma lista das operações de restauração de um recurso específico, filtre o log de atividades da conta usando o filtro de pesquisa InAccount Restore Deleted e um filtro de hora. A lista retornada inclui o campo UserPrincipalName, que identifica o usuário que iniciou a operação de restauração. Para obter mais informações sobre como acessar os logs de atividade, confira Auditoria de ações de recuperação pontual.

CLI do Azure

Atualmente, para obter o log de atividades da conta, você deve usar o portal do Azure. Use o filtro de pesquisa InAccount Restore Deleted e um filtro de tempo.

PowerShell do Azure

Atualmente, para obter o log de atividades da conta, você deve usar o portal do Azure. Use o filtro de pesquisa InAccount Restore Deleted e um filtro de tempo.

Modelo do Azure Resource Manager

Atualmente, para obter o log de atividades da conta, você deve usar o portal do Azure. Use o filtro de pesquisa InAccount Restore Deleted e um filtro de tempo.

Próximas etapas

• Habilite o backup contínuo usando o portal do Azure, o Azure PowerShell, a CLI do Azure ou o Azure Resource Manager.
• Saiba como migrar uma conta de backup periódico para uma de backup contínuo.
• Analise o modelo de recursos do modo de backup contínuo.
• Gerencie as permissões necessárias para restaurar os dados usando o modo de backup contínuo.