Share via

Изменение приоритета отработки отказа или триггера отработки отказа для учетной записи Azure Cosmos DB с одним регионом записи с помощью PowerShell

  • Статья

ПРИМЕНИМО К: Nosql Mongodb Кассандра Гремлин Таблица

Примечание

Для взаимодействия с Azure рекомендуется использовать модуль Azure Az PowerShell. Чтобы начать работу, см. статью Установка Azure PowerShell. Дополнительные сведения см. в статье Перенос Azure PowerShell с AzureRM на Az.

Для этого примера требуется модуль Azure PowerShell Az 5.4.0 или более поздней версии. Запустите Get-Module -ListAvailable Az для просмотра установленных версий. Если необходимо выполнить установку, см. статью об установке модуля Azure PowerShell.

Запустите Connect AzAccount для входа Azure.

Пример скрипта

Примечание

Любое изменение региона с помощью параметра failoverPriority=0 приводит к запуску отработки отказа вручную. Это действие может выполняться только в учетной записи, настроенной для запуска отработки отказа вручную. Изменения во всех остальных регионах просто изменяют приоритет отработки отказа для учетной записи Azure Cosmos DB.

Примечание

В этом примере демонстрируется использование API для учетной записи NoSQL. Чтобы использовать этот пример с другими API, соответствующие свойства необходимо скопировать в скрипт для такого 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

Очистка развертывания

После выполнения примера сценария можно удалить группу ресурсов и все связанные с ней ресурсы, выполнив следующую команду.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Описание скрипта

Этот скрипт использует следующие команды. Для каждой команды в таблице приведены ссылки на соответствующую документацию.

Get-Help Примечания
Azure Cosmos DB
Get-AzCosmosDBAccount Выводит список учетных записей Azure Cosmos DB или получает указанную учетную запись Azure Cosmos DB.
Update-AzCosmosDBAccountFailoverPriority Обновите порядок приоритета отработки отказа для регионов учетной записи Azure Cosmos DB.
Группы ресурсов Azure
Remove-AzResourceGroup Удаляет группу ресурсов со всеми вложенными ресурсами.

Дальнейшие действия

Дополнительные сведения о Azure PowerShell см. в документации по Azure PowerShell.