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.
Mettre à jour la redondance du stockage
Procédez comme suit pour mettre à jour la redondance du stockage de sauvegarde.
Connectez-vous au portail Azure et accédez à votre compte Azure Cosmos DB.
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.
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.
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.
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
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>
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
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.
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
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
