Failoverprioriteit wijzigen of failover activeren voor een Azure Cosmos DB-account met één schrijfregio met behulp van PowerShell
VAN TOEPASSING OP: NoSQL MongoDB Cassandra Gremlin Tafel
Notitie
Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.
Voor dit voorbeeld is Azure PowerShell Az 5.4.0 of hoger vereist. Voer Get-Module -ListAvailable Az
uit om te zien welke versies zijn geïnstalleerd.
Als u PowerShell moet installeren, raadpleegt u De Azure PowerShell-module installeren.
Voer Connect-AzAccount uit om u aan te melden bij Azure.
Voorbeeldscript
Notitie
Iedere wijziging van een regio met failoverPriority=0
resulteert in een handmatige failover en kan alleen worden uitgevoerd voor een account dat is geconfigureerd voor handmatige failover. Wijzigingen in alle andere regio's wijzigen de failoverprioriteit voor een Azure Cosmos DB-account.
Notitie
In dit voorbeeld ziet u hoe u een API voor Een NoSQL-account gebruikt. Als u dit voorbeeld voor andere API's wilt gebruiken, kopieert u de gerelateerde eigenschappen en past u deze toe op uw API-specifieke script.
# 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
Opschonen van implementatie
Na het uitvoeren van het voorbeeldscript kan de volgende opdracht worden gebruikt om de resourcegroep en alle resources die er aan zijn gekoppeld te verwijderen.
Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"
Uitleg van het script
In dit script worden de volgende opdrachten gebruikt. Elke opdracht in de tabel is een koppeling naar specifieke documentatie over de opdracht.
Opdracht | Opmerkingen |
---|---|
Azure Cosmos DB | |
Get-AzCosmosDBAccount | Geeft een lijst weer met Azure Cosmos DB-accounts of haalt een opgegeven Azure Cosmos DB-account op. |
Update-AzCosmosDBAccountFailoverPriority | Werk de volgorde van de failoverprioriteit van de regio's van een Azure Cosmos DB-account bij. |
Azure-resourcegroepen | |
Remove-AzResourceGroup | Hiermee verwijdert u een resourcegroep met inbegrip van alle ingesloten resources. |
Volgende stappen
Zie Documentatie over Azure PowerShell voor meer informatie over Azure PowerShell.