Změna priority převzetí služeb při selhání nebo aktivace převzetí služeb při selhání pro účet služby Azure Cosmos DB s jednou oblastí zápisu pomocí PowerShellu

PLATÍ PRO: NoSQL MongoDB Cassandra Gremlin Tabulka

Poznámka

K interakci s Azure doporučujeme použít modul Azure Az PowerShell. Začněte tím, že si projdete téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.

Tato ukázka vyžaduje Azure PowerShell Az 5.4.0 nebo novější. Spuštěním příkazu Get-Module -ListAvailable Az zjistíte, které verze jsou nainstalované. Pokud potřebujete instalaci, přečtěte si téma Instalace modulu Azure PowerShell.

Spuštěním příkazu Connect-AzAccount se přihlaste k Azure.

Ukázkový skript

Poznámka

Jakákoli změna oblasti s failoverPriority=0 aktivuje ruční převzetí služeb při selhání a dá se provést pouze u účtu nakonfigurovaného pro ruční převzetí služeb při selhání. Změny ve všech ostatních oblastech jednoduše změní prioritu převzetí služeb při selhání pro účet služby Azure Cosmos DB.

Poznámka

Tato ukázka ukazuje použití rozhraní API pro účet NoSQL. Pokud chcete tuto ukázku použít pro jiná rozhraní API, zkopírujte související vlastnosti a použijte ho na váš skript specifický pro rozhraní 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

Vyčištění nasazení

Po spuštění ukázkového skriptu můžete pomocí následujícího příkazu odebrat skupinu prostředků a všechny k ní přidružené prostředky.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Vysvětlení skriptu

Tento skript používá následující příkazy. Každý příkaz v tabulce odkazuje na příslušnou část dokumentace.

Příkaz Poznámky
Azure Cosmos DB
Get-AzCosmosDBAccount Zobrazí seznam účtů služby Azure Cosmos DB nebo získá zadaný účet služby Azure Cosmos DB.
Update-AzCosmosDBAccountFailoverPriority Aktualizujte pořadí priority převzetí služeb při selhání oblastí účtu služby Azure Cosmos DB.
Skupiny prostředků Azure
Remove-AzResourceGroup Odstraní skupinu prostředků včetně všech vnořených prostředků.

Další kroky

Další informace o Azure PowerShellu najdete v dokumentaci k Azure PowerShellu.