Changer la priorité de basculement ou déclencher un basculement pour un compte Azure Cosmos DB avec une seule région d’écriture à l’aide de PowerShell

S’APPLIQUE À : NoSQL MongoDB Cassandra Gremlin Table

Notes

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour bien démarrer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Cet exemple nécessite Azure PowerShell Az 5.4.0 ou ultérieur. Exécutez Get-Module -ListAvailable Az pour voir quelles versions sont installées. Si vous devez l’installer, consultez Installer le module Azure PowerShell.

Exécutez Connect-AzAccount pour vous connecter à Azure.

Exemple de script

Notes

Toute modification apportée à une région avec failoverPriority=0 déclenche un basculement manuel et peut uniquement être effectuée sur un compte configuré pour le basculement manuel. Les modifications apportées à toutes les autres régions modifient simplement la priorité de basculement pour un compte Azure Cosmos DB.

Notes

Cet exemple illustre l’utilisation d’un compte d’API pour NoSQL. Pour utiliser cet exemple pour d’autres API, copiez les propriétés associées et appliquez-les à votre script propre à l’API.

# Reference: Az.CosmosDB | https://docs.microsoft.com/powershell/module/az.cosmosdb
# --------------------------------------------------
# Purpose
# Update Cosmos DB account: Change region failover priority.
# Note: updating location at priority 0 triggers a failover to the new location
# --------------------------------------------------
# Variables - ***** SUBSTITUTE YOUR VALUES *****
$resourceGroupName = "myResourceGroup" # Resource Group must already exist
$accountName = "myaccount" # Must be all lower case
$locations = @("West US", "East US") # Regions ordered by UPDATED failover priority
# --------------------------------------------------

# Get existing Cosmos DB account
$account = Get-AzCosmosDBAccount -ResourceGroupName $resourceGroupName -Name $accountName

# Update account failover priority
Update-AzCosmosDBAccountFailoverPriority -InputObject $account -FailoverPolicy $locations

Nettoyer le déploiement

Une fois l’exemple de script exécuté, la commande suivante permet de supprimer le groupe de ressources et toutes les ressources associées.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Explication du script

Ce script utilise les commandes suivantes. Chaque commande du tableau renvoie à une documentation spécifique.

Commande	Notes
Azure Cosmos DB
Get-AzCosmosDBAccount	Liste les comptes Azure Cosmos DB ou obtient un compte Azure Cosmos DB spécifié.
Update-AzCosmosDBAccountFailoverPriority	Met à jour l’ordre de priorité de basculement des régions d’un compte Azure Cosmos DB.
Groupes de ressources Azure
Remove-AzResourceGroup	Supprime un groupe de ressources, y compris toutes les ressources imbriquées.

Étapes suivantes

Pour plus d’informations sur Azure PowerShell, consultez la documentation Azure PowerShell.