在 powershell 中使用 Azure CLI 创建 CosmosDB

Question

我正在尝试创建一个新的 cosmosdb，但在执行以下代码时出现以下错误。

az cosmosdb create --name TIC_Test
                    --resource-group "TIC" 
                    --default-consistency-level  Session  
                    --locations "Central US"=0 "Central US"=0 
                    --max-interval 5  --max-staleness-prefix 100  
                    --enable-automatic-failover false  
                    --enable-virtual-network false  
                    --kind GlobalDocumentDB

错误：

az : usage: az cosmosdb create [-h] [--verbose] [--debug]
At line:2 char:1
+ az cosmosdb create --name TIC_Test --resource-group "TIC"  --default- ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (usage: az cosmo...bose] [--debug]:String) [], RemoteException
    + FullyQualifiedErrorId : NativeCommandError

                          [--output {json,jsonc,table,tsv}] [--query JMESPATH]
                          --resource-group RESOURCE_GROUP_NAME --name
                          ACCOUNT_NAME [--locations LOCATIONS [LOCATIONS ...]]
                          [--tags [TAGS [TAGS ...]]]
                          [--kind {GlobalDocumentDB,MongoDB,Parse}]
                          [--default-consistency-level {Eventual,Session,BoundedStaleness,Strong,ConsistentPrefix}]
                          [--max-staleness-prefix MAX_STALENESS_PREFIX]
                          [--max-interval MAX_INTERVAL]
                          [--ip-range-filter IP_RANGE_FILTER [IP_RANGE_FILTER ...]]
                          [--enable-automatic-failover [{true,false}]]
                          [--capabilities CAPABILITIES [CAPABILITIES ...]]
                          [--enable-virtual-network [{true,false}]]
                          [--virtual-network-rules VIRTUAL_NETWORK_RULES [VIRTUAL_NETWORK_RULES ...]]
                          [--subscription _SUBSCRIPTION]
az cosmosdb create: error: list index out of range

知道错误的原因吗？

我怀疑这一行，但不确定如何指定：

 --locations "Central US"=0 "Central US"=0

Answer 1

--locations 选项允许您指定故障转移优先级。

在下面找到创建新 CosmosDB/SQL 帐户的示例，其中 美国东部为主（读写），美国西部为次要（只读）.

az cosmosdb create --name "cosmosdb5555" --kind GlobalDocumentDB --resource-group "cosmosdbrg" --locations "eastus=0", "westus=1"

您观察到一个错误，因为您指定的 --locations 由于区域和语法重复而无效。

如果在--locations:

中指定重复的区域，将会抛出以下错误

Operation failed with status: 'BadRequest'. Details: Failover priorities must be unique and 0 <= priority < (number of failover policies)
ActivityId: 689752f6-8081-11e8-8a4b-9cb6d00f36f2, Microsoft.Azure.Documents.Common/2.0.0.0

Answer 2

是的，--locations 似乎是问题所在。根据 doc:

Space-separated locations in 'regionName=failoverPriority' format. E.g eastus=0 westus=1. Failover priority values are 0 for write regions and greater than 0 for read regions. A failover priority value must be unique and less than the total number of regions. Default: single region account in the location of the specified resource group.

例如，这适用于将 CentralUS 配置为 read/write 区域，将 EastUS 配置为读取区域：

--locations "CentralUS=0" "EastUS=1"

在 powershell 中使用 Azure CLI 创建 CosmosDB

Creating CosmosDB with Azure CLI in powershell

powershell

azure

azure-cli

azure-cosmosdb