Mettre à jour la redondance du stockage de sauvegarde périodique pour Azure Cosmos DB

S’APPLIQUE À : NoSQL MongoDB Cassandra Gremlin Table

Les données de sauvegarde en mode période Azure Cosmos DB sont répliquées de différentes façons. Si la région primaire prend en charge les régions jumelées alors, par défaut, Azure Cosmos DB stocke les données de sauvegarde en mode périodique dans un stockage blob géo-redondant qui est répliqué dans la région jumelée. Vous pouvez remplacer la redondance du stockage de sauvegarde par défaut. Sinon, si vous utilisez une région non jumelée, vous devez choisir explicitement la redondance du stockage de sauvegarde. Cet article explique comment mettre à jour la redondance du stockage de sauvegarde à l’aide d’Azure CLI et de PowerShell. Il montre également comment configurer une stratégie Azure sur vos comptes pour appliquer la redondance de stockage requise.

Prérequis

• Compte Azure Cosmos DB existant.
  • Si vous n’avez pas d’abonnement Azure, créez-en un.
  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
  • Vous pouvez également essayer Azure Cosmos DB gratuitement avant de vous engager.

Mettre à jour la redondance du stockage

Procédez comme suit pour mettre à jour la redondance du stockage de sauvegarde.

Azure portal

1. Connectez-vous au portail Azure et accédez à votre compte Azure Cosmos DB.

2. Ouvrez le volet Sauvegarde et restauration, mettez à jour la redondance du stockage de sauvegarde et sélectionnez Envoyer. L’exécution de cette opération prend quelques minutes.

   

Azure CLI

1. Veillez à disposer de la version la plus récente d’Azure CLI, de la version 2.30.0 ou d’une version ultérieure. Si l’extension « cosmosdb-preview » est installée, assurez-vous de la supprimer.

2. Exécutez la commande az cosmosdb locations show pour obtenir les options de redondance de sauvegarde disponibles dans les régions où votre compte existe.

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

   La sortie doit inclure du code JSON similaire à celui de l’exemple suivant  :

   {
     "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"
   }
   

   Notes

   La commande précédente affiche une liste des redondances de sauvegarde disponibles dans la région spécifique. Les valeurs prise en charge sont affichées dans la propriété backupStorageRedundancies. Par exemple, certaines régions peuvent prendre en charge jusqu’à trois options de redondance : Emplacement géographique, Zone et Local. D’autres régions peuvent prendre en charge un sous-ensemble de ces options. Avant de procéder à la mise à jour, choisissez l’option de redondance du stockage de sauvegarde qui est prise en charge dans toutes les régions que votre compte Azure Cosmos DB utilise.

3. Exécutez la commande az cosmosdb update avec l’option de redondance de sauvegarde choisie pour mettre à jour la redondance de sauvegarde sur un compte existant.

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

4. Vous pouvez également utiliser la commande az cosmosdb create pour créer un compte avec l’option de redondance de sauvegarde choisie.

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

Azure PowerShell

1. Installez la version la plus récente d’Azure PowerShell ou installez la version 1.4.0 ou une version ultérieure.

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

2. Exécutez l’applet de commande Get-AzCosmosDBLocation pour obtenir les options de redondance de sauvegarde disponibles dans les régions où votre compte existe.

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

   La sortie doit inclure du contenu similaire à celui de l’exemple suivant  :

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

   Notes

   La commande précédente affiche une liste des redondances de sauvegarde disponibles dans la région spécifique. Les valeurs prise en charge sont affichées dans la propriété BackupStorageRedundancies. Par exemple, certaines régions peuvent prendre en charge jusqu’à trois options de redondance : Emplacement géographique, Zone et Local. D’autres régions peuvent prendre en charge un sous-ensemble de ces options. Avant de procéder à la mise à jour, choisissez l’option de redondance du stockage de sauvegarde qui est prise en charge dans toutes les régions que votre compte Azure Cosmos DB utilise.

3. Exécutez l’applet de commande Update-AzCosmosDBAccount avec l’option de redondance de sauvegarde choisie pour mettre à jour la redondance de sauvegarde sur un compte existant :

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

4. Vous pouvez également utiliser l’applet de commande New-AzCosmosDBAccount pour créer un compte avec l’option de redondance de sauvegarde choisie :

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

Ajouter une stratégie Azure pour la redondance du stockage de sauvegarde

Azure Policy vous aide à appliquer les normes organisationnelles et à évaluer la conformité à grande échelle. Pour plus d’informations, consultez l’article Présentation d’Azure Policy.

L’exemple suivant montre comment ajouter une stratégie Azure pour les comptes Azure Cosmos DB afin de vérifier (à l’aide de audit) que leur redondance de sauvegarde est configurée sur Local.

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

Étapes suivantes

Modifier l’intervalle de sauvegarde et la période de rétention