你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Database Accounts - Failover Priority Change

更改 Azure Cosmos DB 数据库帐户的故障转移优先级。 故障转移优先级为 0 表示写入区域。 故障转移优先级的最大值 = (区域总数 - 1) 。 对于数据库帐户所在的每个区域,故障转移优先级值必须是唯一的。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/failoverPriorityChange?api-version=2024-05-15

URI 参数

名称 必需 类型 说明
accountName
path True

string

Cosmos DB 数据库帐户名称。

正则表达式模式: ^[a-z0-9]+(-[a-z0-9]+)*

resourceGroupName
path True

string

资源组的名称。 此名称不区分大小写。

subscriptionId
path True

string

目标订阅的 ID。

api-version
query True

string

要用于此操作的 API 版本。

请求正文

名称 必需 类型 说明
failoverPolicies True

FailoverPolicy[]

故障转移策略列表。

响应

名称 类型 说明
202 Accepted

已接受。 故障转移策略更改操作将以异步方式完成。

标头

  • azure-AsyncOperation: string
  • location: string
204 No Content

无内容

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

CosmosDBDatabaseAccountFailoverPriorityChange

示例请求

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1-failover/failoverPriorityChange?api-version=2024-05-15

{
  "failoverPolicies": [
    {
      "locationName": "eastus",
      "failoverPriority": 0
    },
    {
      "locationName": "westus",
      "failoverPriority": 1
    }
  ]
}

示例响应

Location: https://centraluseuap.management.azure.com/subscriptions/d1eb41bc-1b7f-4404-bd2a-8568c222852d/providers/Microsoft.DocumentDB/locations/centraluseuap/operationsStatus/fdd04b7b-86d5-460f-b19e-386230348bcc?api-version=2024-05-15
Azure-AsyncOperation: https://centraluseuap.management.azure.com/subscriptions/d1eb41bc-1b7f-4404-bd2a-8568c222852d/providers/Microsoft.DocumentDB/locations/centraluseuap/operationsStatus/fdd04b7b-86d5-460f-b19e-386230348bcc?api-version=2024-05-15

定义

名称 说明
FailoverPolicies

故障转移优先级更改的新故障转移策略列表。

FailoverPolicy

数据库帐户的给定区域的故障转移策略。

FailoverPolicies

故障转移优先级更改的新故障转移策略列表。

名称 类型 说明
failoverPolicies

FailoverPolicy[]

故障转移策略列表。

FailoverPolicy

数据库帐户的给定区域的故障转移策略。

名称 类型 说明
failoverPriority

integer

区域的故障转移优先级。 故障转移优先级为 0 表示写入区域。 故障转移优先级的最大值 = (区域总数 - 1) 。 对于数据库帐户所在的每个区域,故障转移优先级值必须是唯一的。

id

string

数据库帐户复制到的区域的唯一标识符。 示例:<accountName-locationName>><。

locationName

string

数据库帐户所在的区域的名称。