Cambiare la priorità di failover o attivare un failover di un account Azure Cosmos DB con una singola area di scrittura tramite PowerShell

SI APPLICA A: NoSQL MongoDB Cassandra Gremlin Tabella

Nota

È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.

Questo esempio richiede Az di Azure PowerShell 5.4.0 o versione successiva. Eseguire Get-Module -ListAvailable Az per determinare le versioni installate. Se è necessario installarlo, vedere Installare il modulo Azure PowerShell.

Eseguire Connect-AzAccount per accedere ad Azure.

Script di esempio

Nota

Qualsiasi modifica apportata a un'area con failoverPriority=0 attiva un failover manuale e può essere eseguita solo in un account configurato per il failover manuale. Le modifiche apportate a tutte le altre aree cambiano semplicemente la priorità di failover per un account Azure Cosmos DB.

Nota

Questo esempio mostra l'uso di un account API per NoSQL. Per usare questo esempio per altre API, copiare le proprietà correlate e applicarle allo script specifico dell'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

Pulire la distribuzione

Dopo l'esecuzione dello script di esempio, è possibile usare il comando seguente per rimuovere il gruppo di risorse e tutte le risorse ad esso associate.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Spiegazione dello script

Questo script usa i comandi seguenti. Ogni comando della tabella include collegamenti alla documentazione specifica del comando.

Comando Note
Azure Cosmos DB
Get-AzCosmosDBAccount Elenca gli account Azure Cosmos DB o ottiene un account Azure Cosmos DB specificato.
Update-AzCosmosDBAccountFailoverPriority Aggiornare l'ordine delle priorità di failover delle aree di un account Azure Cosmos DB.
Gruppi di risorse di Azure
Remove-AzResourceGroup Consente di eliminare un gruppo di risorse incluse tutte le risorse annidate.

Passaggi successivi

Per altre informazioni su Azure PowerShell, vedere la documentazione di Azure PowerShell.