Zmienianie priorytetu trybu failover lub wyzwalanie trybu failover dla konta usługi Azure Cosmos DB z pojedynczym regionem zapisu przy użyciu programu PowerShell

DOTYCZY: Nosql Mongodb Cassandra Gremlin Tabeli

Uwaga

Zalecamy korzystanie z modułu Azure Az programu PowerShell do interakcji z platformą Azure. Zobacz Instalowanie programu Azure PowerShell, aby rozpocząć. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Ten przykład wymaga modułu Azure PowerShell Az 5.4.0 lub nowszego. Uruchom polecenie Get-Module -ListAvailable Az , aby zobaczyć, które wersje są zainstalowane. Jeśli musisz zainstalować, zobacz Instalowanie modułu Azure PowerShell.

Uruchom polecenie Connect-AzAccount , aby zalogować się do platformy Azure.

Przykładowy skrypt

Uwaga

Każda zmiana w regionie z failoverPriority=0 wyzwalaczami ręcznego przejścia w tryb failover i można to zrobić tylko na koncie skonfigurowanym do ręcznego przejścia w tryb failover. Zmiany we wszystkich innych regionach po prostu zmieniają priorytet trybu failover dla konta usługi Azure Cosmos DB.

Uwaga

W tym przykładzie pokazano, jak używać interfejsu API dla konta NoSQL. Aby użyć tego przykładu dla innych interfejsów API, skopiuj powiązane właściwości i zastosuj do skryptu specyficznego dla interfejsu 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

Czyszczenie wdrożenia

Po wykonaniu przykładowego skryptu możesz uruchomić następujące polecenie, aby usunąć grupę zasobów i wszystkie skojarzone z nią zasoby.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Objaśnienia dla skryptu

W tym skrypcie użyto następujących poleceń. Każde polecenie w tabeli stanowi link do dokumentacji polecenia.

Polecenie Uwagi
Azure Cosmos DB
Get-AzCosmosDBAccount Wyświetla listę kont usługi Azure Cosmos DB lub pobiera określone konto usługi Azure Cosmos DB.
Update-AzCosmosDBAccountFailoverPriority Zaktualizuj kolejność priorytetu trybu failover dla regionów konta usługi Azure Cosmos DB.
Grupy zasobów platformy Azure
Remove-AzResourceGroup Usuwa grupę zasobów wraz ze wszystkimi zagnieżdżonymi zasobami.

Następne kroki

Aby uzyskać więcej informacji na temat programu Azure PowerShell, zobacz dokumentację programu Azure PowerShell.