Aggiornare la ridondanza periodica dell'archiviazione di backup per Azure Cosmos DB

SI APPLICA A: NoSQL MongoDB Cassandra Gremlin Tabella

Per impostazione predefinita, Azure Cosmos DB archivia i dati di backup in modalità periodica in archiviazione BLOB con ridondanza geografica replicata in un'area associata. È possibile eseguire l'override della ridondanza predefinita dell'archiviazione di backup. Questo articolo descrive come aggiornare la ridondanza dell'archiviazione di backup usando l'interfaccia della riga di comando di Azure e PowerShell. Inoltre mostra come configurare criteri di Azure per gli account, per applicare la ridondanza di archiviazione necessaria.

Prerequisiti

• Un account Azure Cosmos DB esistente.
  • Se si ha una sottoscrizione di Azure, creare un nuovo account.
  • Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
  • In alternativa, è possibile provare azure Cosmos DB gratuitamente prima di eseguire il commit.

Aggiornare la ridondanza di archiviazione

Usare la procedura seguente per aggiornare la ridondanza dell'archiviazione di backup.

Azure portal

1. Accedere al portale di Azure e passare all'account Azure Cosmos DB.

2. Aprire il riquadro Backup e ripristino, aggiornare la ridondanza dell'archiviazione di backup e selezionare Submit. Il completamento dell'operazione richiede alcuni minuti.

   

Interfaccia della riga di comando di Azure

1. Assicurarsi di avere la versione più recente dell'interfaccia della riga di comando di Azure o una versione successiva o uguale a 2.30.0. Se è installata l’estensione cosmosdb-preview, assicurarsi di rimuoverla.

2. Usare il comando az cosmosdb locations show per ottenere le opzioni di ridondanza di backup disponibili nelle aree in cui è presente l'account.

   az cosmosdb locations show \
         --location <region-name>
   

   L'output deve includere lo standard JSON simile a questo esempio:

   {
     "id": "subscriptionId/<Subscription_ID>/providers/Microsoft.DocumentDB/locations/eastus/",
     "name": "East US",
     "properties": {
       "backupStorageRedundancies": [
         "Geo",
         "Zone",
         "Local"
       ],
       "isResidencyRestricted": false,
       "supportsAvailabilityZone": true
     },
     "type": "Microsoft.DocumentDB/locations"
   }
   

   Nota

   Il comando precedente mostra un elenco delle ridondanze di backup disponibili nell'area specifica. I valori supportati vengono visualizzati nella proprietà backupStorageRedundancies. Ad esempio, alcune aree possono supportare fino a tre opzioni di ridondanza: Posizione geografica, Zona e Locale. Altre aree possono supportare un subset di queste opzioni. Prima dell'aggiornamento, scegliere l'opzione di ridondanza dell'archiviazione di backup supportata in tutte le aree usate dall'account Azure Cosmos DB.

3. Usare il comando az cosmosdb update con l'opzione di ridondanza di backup scelta per aggiornare la ridondanza del backup in un account esistente.

   az cosmosdb update \
       --resource-group <resource-group-name> \
       --name <account_name> \
       --backup-redundancy Zone
   

4. In alternativa, usare il comando az cosmosdb create per creare un nuovo account con l'opzione di ridondanza di backup scelta.

   az cosmosdb create \
       --resource-group <resource-group-name> \
       --name <account-name> \
       --backup-redundancy Geo \
       --locations regionName=<azure-region>
   

Azure PowerShell

1. Installare la versione più recente di Azure PowerShell o una versione successiva o uguale a 1.4.0.

   $parameters = @{
       Name = "Az.CosmosDB"
       RequiredVersion = "1.4.0"
   }
   Install-Module @parameters
   

2. Usare il cmdlet Get-AzCosmosDBLocation per ottenere le opzioni di ridondanza del backup disponibili nelle aree in cui è presente l'account.

   $parameters = @{
       Location = "<azure-region>"
   }
   (Get-AzCosmosDBLocation @parameters).Properties
   

   L'output deve includere contenuto simile all'esempio seguente:

   SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
   ------------------------ --------------------- -------------------------
                       True                 False {Geo, Zone, Local}
   

   Nota

   Il comando precedente mostra un elenco delle ridondanze di backup disponibili nell'area specifica. I valori supportati vengono visualizzati nella proprietà BackupStorageRedundancies. Ad esempio, alcune aree possono supportare fino a tre opzioni di ridondanza: Posizione geografica, Zona e Locale. Altre aree possono supportare un subset di queste opzioni. Prima dell'aggiornamento, scegliere l'opzione di ridondanza dell'archiviazione di backup supportata in tutte le aree usate dall'account Azure Cosmos DB.

3. Usare il cmdlet Update-AzCosmosDBAccount con l'opzione di ridondanza di backup scelta per aggiornare la ridondanza del backup in un account esistente:

   $parameters = @{
       ResourceGroupName "<resource-group-name>"
       Name = "<account-name>"
       BackupStorageRedundancy = "Zone"
   }
   Update-AzCosmosDBAccount @parameters
   

4. In alternativa, usare il cmdlet New-AzCosmosDBAccount per creare un nuovo account con l'opzione di ridondanza di backup scelta:

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       Location = "<azure-region>"
       BackupPolicyType = "Periodic"
       BackupStorageRedundancy = "Geo"
   }
   New-AzCosmosDBAccount @parameters
   

Aggiungere Criteri di Azure per la ridondanza dell'archiviazione di backup

Criteri di Azure consente di imporre standard aziendali e di valutare la conformità su larga scala. Per altre informazioni, vedere Informazioni su Criteri di Azure.

L'esempio seguente mostra come aggiungere criteri di Azure per gli account Azure Cosmos DB per convalidare (usando audit) la ridondanza del backup configurata in Local.

"parameters": {},
"policyRule": {
  "if": {
    "allOf": [
      {
        "field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
        "match": "Local"
      }
    ]
  },
  "then": {
    "effect": "audit"
  }
}

Passaggi successivi

Modificare l'intervallo di backup e il periodo di conservazione