Mengubah prioritas failover atau memicu failover untuk akun Azure Cosmos dengan wilayah tulis tunggal dengan menggunakan PowerShell

  • Artikel
  • 2 menit untuk membaca

BERLAKU UNTUK: SQL API Cassandra API Gremlin API Table API Azure Cosmos DB API for MongoDB

Catatan

Artikel ini menggunakan modul Azure Az PowerShell, yang merupakan modul PowerShell yang direkomendasikan untuk berinteraksi dengan Azure. Untuk mulai menggunakan modul Az PowerShell, lihat Menginstal Azure PowerShell. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.

Sampel ini memerlukan Azure PowerShell Az 5.4.0 atau yang lebih baru. Jalankan Get-Module -ListAvailable Az untuk melihat versi mana yang dipasang. Jika Anda perlu memasang, lihat Pasang modul Azure PowerShell.

Jalankan Connect-AzAccount untuk masuk ke Azure.

Skrip sampel

Catatan

Setiap perubahan pada wilayah failoverPriority=0 dengan pemicu failover manual dan hanya dapat dilakukan ke akun yang dikonfigurasi untuk failover manual. Perubahan ke semua wilayah lain hanya mengubah prioritas failover untuk akun Cosmos.

Catatan

Sampel ini menjelaskan dengan menggunakan akun API SQL (Core). Untuk menggunakan sampel ini di API lain, salin properti terkait dan terapkan ke skrip spesifik API Anda

# 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

Membersihkan penyebaran

Setelah sampel skrip dijalankan, perintah berikut dapat digunakan untuk menghapus grup sumber daya dan semua sumber daya yang terkait.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

Penjelasan skrip

Skrip ini menggunakan perintah berikut. Setiap perintah dalam tabel menautkan ke dokumentasi perintah tertentu.

Perintah Catatan
Azure Cosmos DB
Get-AzCosmosDBAccount Mendaftarkan Akun DB Cosmos, atau mendapatkan Akun Cosmos DB tertentu.
Pembaruan-AzCosmosDBAccountFailoverPriority Perbarui urutan prioritas failover dari wilayah Akun Cosmos DB.
Grup Sumber Daya Azure
Remove-AzResourceGroup Menghapus grup sumber daya termasuk semua sumber daya berlapis.

Langkah berikutnya

Untuk informasi selengkapnya tentang Azure PowerShell, lihat dokumentasi Azure PowerShell.