Ändra redundansprioritet eller utlösa redundans för ett Azure Cosmos DB-konto med en enda skrivregion med hjälp av PowerShell
GÄLLER FÖR: NoSQL MongoDB Kassandra Gremlin Bord
Kommentar
Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Se Installera Azure PowerShell för att komma igång. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.
Det här exemplet kräver Azure PowerShell Az 5.4.0 eller senare. Kör Get-Module -ListAvailable Az
för att se vilka versioner som är installerade.
Om du behöver installera kan du läsa Installera Azure PowerShell-modulen.
Kör Connect-AzAccount för att logga in på Azure.
Exempelskript
Kommentar
Alla ändringar i en region med failoverPriority=0
utlöser en manuell redundansväxling och kan bara göras till ett konto som konfigurerats för manuell redundans. Ändringar i alla andra regioner ändrar helt enkelt redundansprioriteten för ett Azure Cosmos DB-konto.
Kommentar
Det här exemplet visar hur du använder ett API för NoSQL-konto. Om du vill använda det här exemplet för andra API:er kopierar du de relaterade egenskaperna och tillämpar på ditt API-specifika skript
# 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
Rensa distribution
När skriptexemplet har körts kan följande kommando användas för att ta bort resursgruppen och alla resurser som är kopplade till den.
Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"
Förklaring av skript
Det här skriptet använder följande kommandon. Varje kommando i tabellen länkar till kommandospecifik dokumentation.
Command | Kommentar |
---|---|
Azure Cosmos DB | |
Get-AzCosmosDBAccount | Visar en lista över Azure Cosmos DB-konton eller hämtar ett angivet Azure Cosmos DB-konto. |
Update-AzCosmosDBAccountFailoverPriority | Uppdatera prioritetsordningen för redundans för ett Azure Cosmos DB-kontos regioner. |
Azure-resursgrupper | |
Remove-AzResourceGroup | Tar bort en resursgrupp, inklusive alla kapslade resurser. |
Nästa steg
Mer information om Azure PowerShell finns i Azure PowerShell-dokumentationen.