你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Microsoft.DocumentDB databaseAccounts 2015-04-08
- 最新
- 2024-12-01-preview
- 2024-11-15
- 2024-09-01-preview
- 2024-08-15
- 2024-05-15
- 2024-05-15-preview
- 2024-02-15-preview
- 2023-11-15
- 2023-11-15-preview
- 2023-09-15
- 2023-09-15-preview
- 2023-04-15
- 2023-03-15
- 2023-03-15-preview
- 2023-03-01-preview
- 2022-11-15
- 2022-11-15-preview
- 2022-08-15
- 2022-08-15-preview
- 2022-05-15
- 2022-05-15-preview
- 2022-02-15-preview
- 2021-11-15-preview
- 2021-10-15
- 2021-10-15-preview
- 2021-07-01-preview
- 2021-06-15
- 2021-05-15
- 2021-04-15
- 2021-04-01-preview
- 2021-03-15
- 2021-03-01-preview
- 2021-01-15
- 2020-09-01
- 2020-06-01-preview
- 2020-04-01
- 2020-03-01
- 2019-12-12
- 2019-08-01
- 2016-03-31
- 2016-03-19
- 2015-11-06
- 2015-04-08
- 2015-04-01
Bicep 资源定义
可以使用目标操作部署 databaseAccounts 资源类型：
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.DocumentDB/databaseAccounts 资源，请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2015-04-08' = {
kind: 'string'
location: 'string'
name: 'string'
properties: {
capabilities: [
{
name: 'string'
}
]
connectorOffer: 'string'
consistencyPolicy: {
defaultConsistencyLevel: 'string'
maxIntervalInSeconds: int
maxStalenessPrefix: int
}
databaseAccountOfferType: 'Standard'
enableAutomaticFailover: bool
enableCassandraConnector: bool
enableMultipleWriteLocations: bool
ipRangeFilter: 'string'
isVirtualNetworkFilterEnabled: bool
locations: [
{
failoverPriority: int
isZoneRedundant: bool
locationName: 'string'
}
]
virtualNetworkRules: [
{
id: 'string'
ignoreMissingVNetServiceEndpoint: bool
}
]
}
tags: {
{customized property}: 'string'
}
}
属性值
能力
| 名字 | 描述 | 价值 |
|---|---|---|
| 名字 | Cosmos DB 功能的名称。 例如，“name”：“EnableCassandra”。 当前值还包括“EnableTable”和“EnableGremlin”。 | 字符串 |
ConsistencyPolicy
| 名字 | 描述 | 价值 |
|---|---|---|
| defaultConsistencyLevel | Cosmos DB 帐户的默认一致性级别和配置设置。 | “BoundedStaleness” “ConsistentPrefix” “最终” “Session” “强”（必需） |
| maxIntervalInSeconds | 与有限过期一致性级别一起使用时，此值表示容忍的过期时间量（以秒为单位）。 此值的接受范围为 5 - 86400。 当 defaultConsistencyPolicy 设置为“BoundedStaleness”时必需。 | int 约束： 最小值 = 5 最大值 = 86400 |
| maxStalenessPrefix | 与有限过期一致性级别一起使用时，此值表示允许的过时请求数。 此值的接受范围为 1 – 2,147,483,647。 当 defaultConsistencyPolicy 设置为“BoundedStaleness”时必需。 | int 约束： 最小值 = 1 最大值 = 2147483647 |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| 能力 | 帐户的 Cosmos DB 功能列表 | 功能[] |
| connectorOffer | cassandra 连接器为 Cosmos DB 数据库 C* 帐户提供类型。 | “Small” |
| consistencyPolicy | Cosmos DB 帐户的一致性策略。 | ConsistencyPolicy |
| databaseAccountOfferType | 数据库的套餐类型 | “标准”（必需） |
| enableAutomaticFailover | 在极少数情况下启用写入区域的自动故障转移，因为服务中断导致该区域不可用。 自动故障转移将导致帐户的新写入区域，并根据为帐户配置的故障转移优先级进行选择。 | bool |
| enableCassandraConnector | 在 Cosmos DB C* 帐户上启用 cassandra 连接器 | bool |
| enableMultipleWriteLocations | 使帐户能够在多个位置写入 | bool |
| ipRangeFilter | Cosmos DB 防火墙支持：此值指定要作为给定数据库帐户的客户端 IP 允许列表包含在 CIDR 形式的 IP 地址或 IP 地址范围集。 IP 地址/范围必须以逗号分隔，并且不能包含任何空格。 | 字符串 |
| isVirtualNetworkFilterEnabled | 用于指示是否启用/禁用虚拟网络 ACL 规则的标志。 | bool |
| 地点 | 一个数组，其中包含为 Cosmos DB 帐户启用的地理复制位置。 | 位置[] （必需） |
| virtualNetworkRules | 为 Cosmos DB 帐户配置的虚拟网络 ACL 规则列表。 | VirtualNetworkRule[] |
位置
| 名字 | 描述 | 价值 |
|---|---|---|
| failoverPriority | 区域的故障转移优先级。 故障转移优先级为 0 表示写入区域。 故障转移优先级的最大值 = （区域总数 - 1）。 故障转移优先级值对于数据库帐户所在的每个区域必须是唯一的。 | int 约束： 最小值 = 0 |
| isZoneRedundant | 用于指示此区域是否为 AvailabilityZone 区域的标志 | bool |
| locationName | 区域的名称。 | 字符串 |
Microsoft.DocumentDB/databaseAccounts
| 名字 | 描述 | 价值 |
|---|---|---|
| 类 | 指示数据库帐户的类型。 只能在创建数据库帐户时设置此设置。 | “GlobalDocumentDB” “MongoDB” “Parse” |
| 位置 | 资源所属的资源组的位置。 | 字符串 |
| 名字 | 资源名称 | 字符串 约束： 最小长度 = 3 最大长度 = 3 模式 = ^[a-z0-9]+(-[a-z0-9]+)* （必需） |
| 性能 | 用于创建和更新 Azure Cosmos DB 数据库帐户的属性。 | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountProperties （必需） |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
标签
| 名字 | 描述 | 价值 |
|---|
VirtualNetworkRule
| 名字 | 描述 | 价值 |
|---|---|---|
| id | 子网的资源 ID，例如：/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}。 | 字符串 |
| ignoreMissingVNetServiceEndpoint | 在虚拟网络启用 vnet 服务终结点之前创建防火墙规则。 | bool |
快速入门示例
以下快速入门示例部署此资源类型。
| Bicep 文件 | 描述 |
|---|---|
| 使用分析存储 |
此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，其中包含配置了分析存储的数据库和容器。 |
| 使用 Web 应用 |
此模板部署 Azure Cosmos DB 帐户、应用服务计划，并在应用服务计划中创建 Web 应用。 它还将两个应用程序设置添加到引用 Azure Cosmos DB 帐户终结点的 Web 应用。 这样，部署到 Web 应用的解决方案就可以使用这些设置连接到 Azure Cosmos DB 帐户终结点。 |
| 创建启用了 Microsoft Defender 的 Cosmos DB 帐户 | 使用此 ARM 模板，可以部署启用了 Microsoft Defender for Azure Cosmos DB 的 Azure Cosmos DB 帐户。 Microsoft Defender for Azure Cosmos DB 是一个 Azure 原生安全层，用于检测尝试利用 Azure Cosmos DB 帐户中的数据库。 Microsoft Defender for Azure Cosmos DB 根据Microsoft威胁情报、可疑访问模式以及通过泄露的标识或恶意预览体验成员对数据库的潜在攻击来检测潜在的 SQL 注入、已知不良参与者。 |
| 创建免费层 Azure Cosmos DB 帐户 | 此模板使用具有共享吞吐量和容器的数据库为 SQL API 创建免费层 Azure Cosmos DB 帐户。 |
| 为 Core （SQL） API 创建最小 Azure Cosmos DB 帐户 | 此模板为 Core （SQL） API 创建 Azure Cosmos DB 帐户，同时仅指定所需的最少资源属性。 |
| 为 SQL API 创建无服务器 Azure Cosmos DB 帐户 | 此模板为 Core （SQL） API 创建无服务器 Azure Cosmos DB 帐户。 |
| 创建零接触 Azure Cosmos 帐户和 Azure Web 应用 | 此模板创建 Azure Cosmos 帐户，将 Cosmos DB 终结点和密钥注入 Azure Web 应用设置，然后从 GitHub 部署 ASP MVC Web 应用。 |
| 为 MongoDB API 创建 Azure Cosmos 帐户 | 此模板使用具有两个集合的共享吞吐量和专用吞吐量，在两个区域中为 MongoDB API 4.2 创建 Azure Cosmos DB 帐户。 |
| 为 MongoDB API 自动缩放创建 Azure Cosmos 帐户 | 此模板使用共享和专用自动缩放吞吐量在两个区域中为 MongoDB API 4.2 创建 Azure Cosmos DB 帐户。 |
| 为表 API 创建 Azure Cosmos 帐户 | 此模板在两个区域中为表 API 创建一个 Azure Cosmos DB 帐户，以及一个具有预配吞吐量的表。 |
| 使用自动缩放 为表 API 创建 Azure Cosmos 帐户 | 此模板在两个区域中为表 API 创建一个 Azure Cosmos DB 帐户，以及一个具有自动缩放吞吐量的表。 |
| 为 Cassandra API 创建 Azure Cosmos DB 帐户 | 此模板在具有密钥空间和具有专用吞吐量的表的两个区域中为 Cassandra API 创建 Azure Cosmos DB 帐户。 |
| 为 Core （SQL） API 创建 Azure Cosmos DB 帐户 | 此模板创建一个 Azure Cosmos 帐户，用于 Core （SQL） API，其中包含具有多个其他选项的吞吐量的数据库和容器。 |
| 为 Gremlin API 创建 Azure Cosmos DB 帐户 | 此模板使用专用吞吐量在两个区域中为 Gremlin API 创建 Azure Cosmos DB 帐户，其中包含一个数据库和一个图形。 |
| 为 Gremlin API 自动缩放 创建 Azure Cosmos DB 帐户 | 此模板使用自动缩放吞吐量在两个区域中为 Gremlin API 创建 Azure Cosmos DB 帐户，其中包含一个数据库和一个图形。 |
| 在多个区域创建 Azure Cosmos DB 帐户 | 此模板为具有选择一致性级别和故障转移类型的主要和次要区域的任何数据库 API 类型创建 Azure Cosmos DB 帐户。 |
| 使用自动缩放 创建 Azure Cosmos DB 帐户 SQL API | 此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，该帐户包含具有多个其他选项的自动缩放吞吐量的数据库和容器。 |
| 使用专用终结点创建 Azure Cosmos DB 帐户 | 此模板将创建 Cosmos 帐户、虚拟网络以及向虚拟网络公开 Cosmos 帐户的专用终结点。 |
| 使用数据平面 RBAC 创建 Azure Cosmos DB SQL 帐户 | 此模板将创建 SQL Cosmos 帐户、本机维护的角色定义，以及 AAD 标识的本机维护角色分配。 |
| 创建 Azure CosmosDB 帐户 | 此 ARM 模板旨在快速创建具有最少所需值的 CosmosDB 帐户 |
| 为 Cassandra API 创建自动缩放 Azure Cosmos DB 帐户 | 此模板在具有密钥空间和具有自动缩放吞吐量的表的两个区域中为 Cassandra API 创建 Azure Cosmos DB 帐户。 |
| 创建 Azure Cosmos DB Core （SQL） API 存储过程 | 此模板创建一个用于 Core （SQL） API 的 Azure Cosmos DB 帐户，以及一个包含存储过程、触发器和用户定义的函数的容器。 |
| 使用容器应用创建 Dapr 微服务应用 | 使用容器应用创建 Dapr 微服务应用。 |
| 使用容器应用创建 Dapr pub-sub servicebus 应用 | 使用容器应用创建 Dapr pub-sub servicebus 应用。 |
| 使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB | 使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。 |
ARM 模板资源定义
可以使用目标操作部署 databaseAccounts 资源类型：
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.DocumentDB/databaseAccounts 资源，请将以下 JSON 添加到模板。
{
"type": "Microsoft.DocumentDB/databaseAccounts",
"apiVersion": "2015-04-08",
"name": "string",
"kind": "string",
"location": "string",
"properties": {
"capabilities": [
{
"name": "string"
}
],
"connectorOffer": "string",
"consistencyPolicy": {
"defaultConsistencyLevel": "string",
"maxIntervalInSeconds": "int",
"maxStalenessPrefix": "int"
},
"databaseAccountOfferType": "Standard",
"enableAutomaticFailover": "bool",
"enableCassandraConnector": "bool",
"enableMultipleWriteLocations": "bool",
"ipRangeFilter": "string",
"isVirtualNetworkFilterEnabled": "bool",
"locations": [
{
"failoverPriority": "int",
"isZoneRedundant": "bool",
"locationName": "string"
}
],
"virtualNetworkRules": [
{
"id": "string",
"ignoreMissingVNetServiceEndpoint": "bool"
}
]
},
"tags": {
"{customized property}": "string"
}
}
属性值
能力
| 名字 | 描述 | 价值 |
|---|---|---|
| 名字 | Cosmos DB 功能的名称。 例如，“name”：“EnableCassandra”。 当前值还包括“EnableTable”和“EnableGremlin”。 | 字符串 |
ConsistencyPolicy
| 名字 | 描述 | 价值 |
|---|---|---|
| defaultConsistencyLevel | Cosmos DB 帐户的默认一致性级别和配置设置。 | “BoundedStaleness” “ConsistentPrefix” “最终” “Session” “强”（必需） |
| maxIntervalInSeconds | 与有限过期一致性级别一起使用时，此值表示容忍的过期时间量（以秒为单位）。 此值的接受范围为 5 - 86400。 当 defaultConsistencyPolicy 设置为“BoundedStaleness”时必需。 | int 约束： 最小值 = 5 最大值 = 86400 |
| maxStalenessPrefix | 与有限过期一致性级别一起使用时，此值表示允许的过时请求数。 此值的接受范围为 1 – 2,147,483,647。 当 defaultConsistencyPolicy 设置为“BoundedStaleness”时必需。 | int 约束： 最小值 = 1 最大值 = 2147483647 |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| 能力 | 帐户的 Cosmos DB 功能列表 | 功能[] |
| connectorOffer | cassandra 连接器为 Cosmos DB 数据库 C* 帐户提供类型。 | “Small” |
| consistencyPolicy | Cosmos DB 帐户的一致性策略。 | ConsistencyPolicy |
| databaseAccountOfferType | 数据库的套餐类型 | “标准”（必需） |
| enableAutomaticFailover | 在极少数情况下启用写入区域的自动故障转移，因为服务中断导致该区域不可用。 自动故障转移将导致帐户的新写入区域，并根据为帐户配置的故障转移优先级进行选择。 | bool |
| enableCassandraConnector | 在 Cosmos DB C* 帐户上启用 cassandra 连接器 | bool |
| enableMultipleWriteLocations | 使帐户能够在多个位置写入 | bool |
| ipRangeFilter | Cosmos DB 防火墙支持：此值指定要作为给定数据库帐户的客户端 IP 允许列表包含在 CIDR 形式的 IP 地址或 IP 地址范围集。 IP 地址/范围必须以逗号分隔，并且不能包含任何空格。 | 字符串 |
| isVirtualNetworkFilterEnabled | 用于指示是否启用/禁用虚拟网络 ACL 规则的标志。 | bool |
| 地点 | 一个数组，其中包含为 Cosmos DB 帐户启用的地理复制位置。 | 位置[] （必需） |
| virtualNetworkRules | 为 Cosmos DB 帐户配置的虚拟网络 ACL 规则列表。 | VirtualNetworkRule[] |
位置
| 名字 | 描述 | 价值 |
|---|---|---|
| failoverPriority | 区域的故障转移优先级。 故障转移优先级为 0 表示写入区域。 故障转移优先级的最大值 = （区域总数 - 1）。 故障转移优先级值对于数据库帐户所在的每个区域必须是唯一的。 | int 约束： 最小值 = 0 |
| isZoneRedundant | 用于指示此区域是否为 AvailabilityZone 区域的标志 | bool |
| locationName | 区域的名称。 | 字符串 |
Microsoft.DocumentDB/databaseAccounts
| 名字 | 描述 | 价值 |
|---|---|---|
| apiVersion | API 版本 | '2015-04-08' |
| 类 | 指示数据库帐户的类型。 只能在创建数据库帐户时设置此设置。 | “GlobalDocumentDB” “MongoDB” “Parse” |
| 位置 | 资源所属的资源组的位置。 | 字符串 |
| 名字 | 资源名称 | 字符串 约束： 最小长度 = 3 最大长度 = 3 模式 = ^[a-z0-9]+(-[a-z0-9]+)* （必需） |
| 性能 | 用于创建和更新 Azure Cosmos DB 数据库帐户的属性。 | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountProperties （必需） |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 类型 | 资源类型 | “Microsoft.DocumentDB/databaseAccounts” |
标签
| 名字 | 描述 | 价值 |
|---|
VirtualNetworkRule
| 名字 | 描述 | 价值 |
|---|---|---|
| id | 子网的资源 ID，例如：/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}。 | 字符串 |
| ignoreMissingVNetServiceEndpoint | 在虚拟网络启用 vnet 服务终结点之前创建防火墙规则。 | bool |
快速入门模板
以下快速入门模板部署此资源类型。
| 模板 | 描述 |
|---|---|
使用分析存储 
|
此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，其中包含配置了分析存储的数据库和容器。 |
| 使用 Web 应用
|
此模板部署 Azure Cosmos DB 帐户、应用服务计划，并在应用服务计划中创建 Web 应用。 它还将两个应用程序设置添加到引用 Azure Cosmos DB 帐户终结点的 Web 应用。 这样，部署到 Web 应用的解决方案就可以使用这些设置连接到 Azure Cosmos DB 帐户终结点。 |
| 在 Azure 容器服务（AKS）上使用 Jenkins CI/CD
|
容器使你可以轻松地持续生成和部署应用程序。 通过在 Azure 容器服务中使用 Kubernetes 协调这些容器的部署，可以实现可复制、可管理的容器群集。 通过设置持续生成来生成容器映像和业务流程，可以提高部署的速度和可靠性。 |
|
创建启用了 Microsoft Defender 的 Cosmos DB 帐户
|
使用此 ARM 模板，可以部署启用了 Microsoft Defender for Azure Cosmos DB 的 Azure Cosmos DB 帐户。 Microsoft Defender for Azure Cosmos DB 是一个 Azure 原生安全层，用于检测尝试利用 Azure Cosmos DB 帐户中的数据库。 Microsoft Defender for Azure Cosmos DB 根据Microsoft威胁情报、可疑访问模式以及通过泄露的标识或恶意预览体验成员对数据库的潜在攻击来检测潜在的 SQL 注入、已知不良参与者。 |
|
创建免费层 Azure Cosmos DB 帐户
|
此模板使用具有共享吞吐量和容器的数据库为 SQL API 创建免费层 Azure Cosmos DB 帐户。 |
|
为 Core （SQL） API 创建最小 Azure Cosmos DB 帐户
|
此模板为 Core （SQL） API 创建 Azure Cosmos DB 帐户，同时仅指定所需的最少资源属性。 |
|
为 SQL API 创建无服务器 Azure Cosmos DB 帐户
|
此模板为 Core （SQL） API 创建无服务器 Azure Cosmos DB 帐户。 |
|
创建零接触 Azure Cosmos 帐户和 Azure Web 应用
|
此模板创建 Azure Cosmos 帐户，将 Cosmos DB 终结点和密钥注入 Azure Web 应用设置，然后从 GitHub 部署 ASP MVC Web 应用。 |
|
为 MongoDB API 创建 Azure Cosmos 帐户
|
此模板使用具有两个集合的共享吞吐量和专用吞吐量，在两个区域中为 MongoDB API 4.2 创建 Azure Cosmos DB 帐户。 |
|
为 MongoDB API 自动缩放创建 Azure Cosmos 帐户
|
此模板使用共享和专用自动缩放吞吐量在两个区域中为 MongoDB API 4.2 创建 Azure Cosmos DB 帐户。 |
|
为表 API 创建 Azure Cosmos 帐户
|
此模板在两个区域中为表 API 创建一个 Azure Cosmos DB 帐户，以及一个具有预配吞吐量的表。 |
|
使用自动缩放 为表 API 创建 Azure Cosmos 帐户
|
此模板在两个区域中为表 API 创建一个 Azure Cosmos DB 帐户，以及一个具有自动缩放吞吐量的表。 |
|
为 Cassandra API 创建 Azure Cosmos DB 帐户
|
此模板在具有密钥空间和具有专用吞吐量的表的两个区域中为 Cassandra API 创建 Azure Cosmos DB 帐户。 |
|
为 Core （SQL） API 创建 Azure Cosmos DB 帐户
|
此模板创建一个 Azure Cosmos 帐户，用于 Core （SQL） API，其中包含具有多个其他选项的吞吐量的数据库和容器。 |
|
为 Gremlin API 创建 Azure Cosmos DB 帐户
|
此模板使用专用吞吐量在两个区域中为 Gremlin API 创建 Azure Cosmos DB 帐户，其中包含一个数据库和一个图形。 |
|
为 Gremlin API 自动缩放 创建 Azure Cosmos DB 帐户
|
此模板使用自动缩放吞吐量在两个区域中为 Gremlin API 创建 Azure Cosmos DB 帐户，其中包含一个数据库和一个图形。 |
|
在多个区域创建 Azure Cosmos DB 帐户
|
此模板为具有选择一致性级别和故障转移类型的主要和次要区域的任何数据库 API 类型创建 Azure Cosmos DB 帐户。 |
|
使用自动缩放 创建 Azure Cosmos DB 帐户 SQL API
|
此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，该帐户包含具有多个其他选项的自动缩放吞吐量的数据库和容器。 |
|
使用专用终结点创建 Azure Cosmos DB 帐户
|
此模板将创建 Cosmos 帐户、虚拟网络以及向虚拟网络公开 Cosmos 帐户的专用终结点。 |
|
使用数据平面 RBAC 创建 Azure Cosmos DB SQL 帐户
|
此模板将创建 SQL Cosmos 帐户、本机维护的角色定义，以及 AAD 标识的本机维护角色分配。 |
|
创建 Azure CosmosDB 帐户
|
此 ARM 模板旨在快速创建具有最少所需值的 CosmosDB 帐户 |
|
为 Cassandra API 创建自动缩放 Azure Cosmos DB 帐户
|
此模板在具有密钥空间和具有自动缩放吞吐量的表的两个区域中为 Cassandra API 创建 Azure Cosmos DB 帐户。 |
|
创建 Azure Cosmos DB Core （SQL） API 存储过程
|
此模板创建一个用于 Core （SQL） API 的 Azure Cosmos DB 帐户，以及一个包含存储过程、触发器和用户定义的函数的容器。 |
|
使用 SQL API 和多个容器创建 Azure Cosmos
|
该模板使用 SQL API 创建 Cosmos 容器，并允许添加多个容器。 |
|
使用容器应用创建 Dapr 微服务应用
|
使用容器应用创建 Dapr 微服务应用。 |
|
使用容器应用创建 Dapr pub-sub servicebus 应用
|
使用容器应用创建 Dapr pub-sub servicebus 应用。 |
|
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB
|
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。 |
| 使用 SQL 数据库、Azure Cosmos DB、Azure 搜索
|
此模板预配 Web 应用、SQL 数据库、Azure Cosmos DB、Azure 搜索和 Application Insights。 |
Terraform （AzAPI 提供程序）资源定义
可以使用目标操作部署 databaseAccounts 资源类型：
- 资源组
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.DocumentDB/databaseAccounts 资源，请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts@2015-04-08"
name = "string"
kind = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
capabilities = [
{
name = "string"
}
]
connectorOffer = "string"
consistencyPolicy = {
defaultConsistencyLevel = "string"
maxIntervalInSeconds = int
maxStalenessPrefix = int
}
databaseAccountOfferType = "Standard"
enableAutomaticFailover = bool
enableCassandraConnector = bool
enableMultipleWriteLocations = bool
ipRangeFilter = "string"
isVirtualNetworkFilterEnabled = bool
locations = [
{
failoverPriority = int
isZoneRedundant = bool
locationName = "string"
}
]
virtualNetworkRules = [
{
id = "string"
ignoreMissingVNetServiceEndpoint = bool
}
]
}
})
}
属性值
能力
| 名字 | 描述 | 价值 |
|---|---|---|
| 名字 | Cosmos DB 功能的名称。 例如，“name”：“EnableCassandra”。 当前值还包括“EnableTable”和“EnableGremlin”。 | 字符串 |
ConsistencyPolicy
| 名字 | 描述 | 价值 |
|---|---|---|
| defaultConsistencyLevel | Cosmos DB 帐户的默认一致性级别和配置设置。 | “BoundedStaleness” “ConsistentPrefix” “最终” “Session” “强”（必需） |
| maxIntervalInSeconds | 与有限过期一致性级别一起使用时，此值表示容忍的过期时间量（以秒为单位）。 此值的接受范围为 5 - 86400。 当 defaultConsistencyPolicy 设置为“BoundedStaleness”时必需。 | int 约束： 最小值 = 5 最大值 = 86400 |
| maxStalenessPrefix | 与有限过期一致性级别一起使用时，此值表示允许的过时请求数。 此值的接受范围为 1 – 2,147,483,647。 当 defaultConsistencyPolicy 设置为“BoundedStaleness”时必需。 | int 约束： 最小值 = 1 最大值 = 2147483647 |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| 能力 | 帐户的 Cosmos DB 功能列表 | 功能[] |
| connectorOffer | cassandra 连接器为 Cosmos DB 数据库 C* 帐户提供类型。 | “Small” |
| consistencyPolicy | Cosmos DB 帐户的一致性策略。 | ConsistencyPolicy |
| databaseAccountOfferType | 数据库的套餐类型 | “标准”（必需） |
| enableAutomaticFailover | 在极少数情况下启用写入区域的自动故障转移，因为服务中断导致该区域不可用。 自动故障转移将导致帐户的新写入区域，并根据为帐户配置的故障转移优先级进行选择。 | bool |
| enableCassandraConnector | 在 Cosmos DB C* 帐户上启用 cassandra 连接器 | bool |
| enableMultipleWriteLocations | 使帐户能够在多个位置写入 | bool |
| ipRangeFilter | Cosmos DB 防火墙支持：此值指定要作为给定数据库帐户的客户端 IP 允许列表包含在 CIDR 形式的 IP 地址或 IP 地址范围集。 IP 地址/范围必须以逗号分隔，并且不能包含任何空格。 | 字符串 |
| isVirtualNetworkFilterEnabled | 用于指示是否启用/禁用虚拟网络 ACL 规则的标志。 | bool |
| 地点 | 一个数组，其中包含为 Cosmos DB 帐户启用的地理复制位置。 | 位置[] （必需） |
| virtualNetworkRules | 为 Cosmos DB 帐户配置的虚拟网络 ACL 规则列表。 | VirtualNetworkRule[] |
位置
| 名字 | 描述 | 价值 |
|---|---|---|
| failoverPriority | 区域的故障转移优先级。 故障转移优先级为 0 表示写入区域。 故障转移优先级的最大值 = （区域总数 - 1）。 故障转移优先级值对于数据库帐户所在的每个区域必须是唯一的。 | int 约束： 最小值 = 0 |
| isZoneRedundant | 用于指示此区域是否为 AvailabilityZone 区域的标志 | bool |
| locationName | 区域的名称。 | 字符串 |
Microsoft.DocumentDB/databaseAccounts
| 名字 | 描述 | 价值 |
|---|---|---|
| 类 | 指示数据库帐户的类型。 只能在创建数据库帐户时设置此设置。 | “GlobalDocumentDB” “MongoDB” “Parse” |
| 位置 | 资源所属的资源组的位置。 | 字符串 |
| 名字 | 资源名称 | 字符串 约束： 最小长度 = 3 最大长度 = 3 模式 = ^[a-z0-9]+(-[a-z0-9]+)* （必需） |
| 性能 | 用于创建和更新 Azure Cosmos DB 数据库帐户的属性。 | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountProperties （必需） |
| 标签 | 资源标记 | 标记名称和值的字典。 |
| 类型 | 资源类型 | “Microsoft.DocumentDB/databaseAccounts@2015-04-08” |
标签
| 名字 | 描述 | 价值 |
|---|
VirtualNetworkRule
| 名字 | 描述 | 价值 |
|---|---|---|
| id | 子网的资源 ID，例如：/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}。 | 字符串 |
| ignoreMissingVNetServiceEndpoint | 在虚拟网络启用 vnet 服务终结点之前创建防火墙规则。 | bool |