Compartilhar via


Alterar a prioridade de failover ou disparar um failover para uma conta do Azure Cosmos DB com região de gravação única usando o PowerShell

APLICA-SE AO: NoSQL MongoDB Cassandra Gremlin Table

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

Este exemplo exige o Azure PowerShell Az 5.4.0 ou posterior. Execute Get-Module -ListAvailable Az para ver quais versões estão instaladas. Se é preciso instalar, consulte Instalar o módulo do Azure PowerShell.

Execute Connect-AzAccount para entrar no Azure.

Exemplo de script

Observação

Qualquer alteração em uma região com failoverPriority=0 dispara um failover manual e só pode ser feita em uma conta configurada para failover manual. As alterações em todas as outras regiões apenas alteram a prioridade de failover para uma conta do Azure Cosmos DB.

Observação

Este exemplo demonstra como usar uma conta da API para NoSQL. Para usar essa amostra em outras APIs, copie as propriedades relacionadas e aplique-as ao script específico da 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

Limpar a implantação

Após a execução do script de exemplo, o comando a seguir pode ser usado para remover o grupo de recursos e todos os recursos associados a ele.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Explicação sobre o script

Este script usa os comandos a seguir. Cada comando da tabela é vinculado à documentação específica do comando.

Comando Observações
Azure Cosmos DB
Get-AzCosmosDBAccount Lista as contas do Azure Cosmos DB ou obtém uma conta do Azure Cosmos DB especificada.
Update-AzCosmosDBAccountFailoverPriority Atualize a ordem de prioridade de failover das regiões de uma Conta do Azure Cosmos DB.
Grupos de recursos do Azure
Remove-AzResourceGroup Exclui um grupo de recursos, incluindo todos os recursos aninhados.

Próximas etapas

Para obter mais informações sobre o Azure PowerShell, confira a Documentação do Azure PowerShell.