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

Microsoft.DocumentDB databaseAccounts/sqlDatabases

Bicep 资源定义

databaseAccounts/sqlDatabases 资源类型可以使用以下目标操作进行部署:

有关每个 API 版本中更改的属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.DocumentDB/databaseAccounts/sqlDatabases 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-05-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      createMode: 'string'
      id: 'string'
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
      }
    }
  }
}

属性值

databaseAccounts/sqlDatabases

名称 说明
name 资源名称

了解如何在 Bicep 中为子资源设置名称和类型。
字符串 (必需)
location 资源所属的资源组的位置。 字符串
标记 标记是描述资源的键值对的列表。 在查看此资源和为此资源分组(跨资源组)时,可以使用这些标记。 最多可以为一个资源提供 15 个标记。 每个标记的键不能超过 128 个字符,值不能超过 256 个字符。 例如,模板类型的默认体验设置为“defaultExperience”:“Cassandra”。 当前的“defaultExperience”值还包括“Table”、“Graph”、“DocumentDB”和“MongoDB”。 标记名称和值的字典。 请参阅 模板中的标记
父级 (parent) 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源之外的子资源
类型为资源的符号名称: databaseAccounts
properties 用于创建和更新 Azure Cosmos DB SQL 数据库的属性。 SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... 所需的 ()

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

名称 说明 Value
options 要为请求应用的选项的键值对。 这对应于随请求一起发送的标头。 CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
resource SQL 数据库的标准 JSON 格式 SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... 所需的 ()

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

名称 说明
autoscaleSettings 指定自动缩放设置。 注意:吞吐量或自动缩放设置是必需的,但不是两者兼而有之。 AutoscaleSettings
throughput 每秒请求单位数。 例如,“吞吐量”:10000。 int

AutoscaleSettings

名称 说明
maxThroughput 表示资源可以纵向扩展到的最大吞吐量。 int

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

名称 说明
createMode 用于指示资源创建模式的枚举。 'Default'
“还原”
id Cosmos DB SQL 数据库的名称 字符串 (必需)
restoreParameters 用于指示有关还原的信息的参数 ResourceRestoreParameters

ResourceRestoreParameters

名称 说明
restoreSource 必须从中启动还原的可还原数据库帐户的 ID。 例如:/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} 字符串
restoreTimestampInUtc 帐户必须还原到的时间 (ISO-8601 格式) 。 字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板 说明
创建免费层 Azure Cosmos DB 帐户

部署到 Azure
此模板为 SQL API 创建一个免费层 Azure Cosmos DB 帐户,其中包含具有共享吞吐量和容器的数据库。
为 Core (SQL) API 创建 Azure Cosmos DB 帐户

部署到 Azure
此模板为 Core (SQL) API 创建一个 Azure Cosmos 帐户,其中包含一个数据库和具有多个其他选项的吞吐量容器。
使用分析存储的 Azure Cosmos DB 帐户 SQL API

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos 帐户,其中包含配置了分析存储的数据库和容器。
使用自动缩放创建 Azure Cosmos DB 帐户 SQL API

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos 帐户,其中包含具有自动缩放吞吐量的数据库和容器以及多个其他选项。
创建 Azure Cosmos DB Core (SQL) API 存储过程

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos DB 帐户,以及一个包含存储过程、触发器和用户定义的函数的容器。
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB

部署到 Azure
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。

ARM 模板资源定义

可以使用面向以下操作部署 databaseAccounts/sqlDatabases 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.DocumentDB/databaseAccounts/sqlDatabases 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
  "apiVersion": "2024-05-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "createMode": "string",
      "id": "string",
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string"
      }
    }
  }
}

属性值

databaseAccounts/sqlDatabases

名称 说明 Value
type 资源类型 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases'
apiVersion 资源 API 版本 '2024-05-15'
name 资源名称

了解如何在 JSON ARM 模板中设置子资源的名称和类型。
字符串 (必需)
location 资源所属的资源组的位置。 字符串
标记 标记是描述资源的键值对的列表。 在查看此资源和为此资源分组(跨资源组)时,可以使用这些标记。 最多可以为资源提供 15 个标记。 每个标记的键不能超过 128 个字符,值不能超过 256 个字符。 例如,模板类型的默认体验设置为“defaultExperience”:“Cassandra”。 当前的“defaultExperience”值还包括“Table”、“Graph”、“DocumentDB”和“MongoDB”。 标记名称和值的字典。 请参阅 模板中的标记
properties 用于创建和更新 Azure Cosmos DB SQL 数据库的属性。 SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... 所需的 ()

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

名称 说明 Value
options 要应用于请求的选项的键值对。 这对应于随请求一起发送的标头。 CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
resource SQL 数据库的标准 JSON 格式 SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... 所需的 ()

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

名称 说明
autoscaleSettings 指定自动缩放设置。 注意:吞吐量或自动缩放设置是必需的,但不是两者兼而有之。 AutoscaleSettings
throughput 每秒请求单位数。 例如,“吞吐量”:10000。 int

AutoscaleSettings

名称 说明
maxThroughput 表示资源可纵向扩展的最大吞吐量。 int

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

名称 说明
createMode 用于指示资源创建模式的枚举。 'Default'
“还原”
id Cosmos DB SQL 数据库的名称 字符串 (必需)
restoreParameters 指示有关还原的信息的参数 ResourceRestoreParameters

ResourceRestoreParameters

名称 说明
restoreSource 必须从中启动还原的可还原数据库帐户的 ID。 例如:/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} 字符串
restoreTimestampInUtc 帐户必须还原到的时间 (ISO-8601 格式) 。 字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板 说明
创建免费层 Azure Cosmos DB 帐户

部署到 Azure
此模板为 SQL API 创建一个免费层 Azure Cosmos DB 帐户,其中包含具有共享吞吐量和容器的数据库。
为 Core (SQL) API 创建 Azure Cosmos DB 帐户

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos 帐户,其中包含数据库和具有多个其他选项的吞吐量容器。
具有分析存储的 Azure Cosmos DB 帐户 SQL API

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos 帐户,其中包含配置了分析存储的数据库和容器。
使用自动缩放创建 Azure Cosmos DB 帐户 SQL API

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos 帐户,其中包含具有自动缩放吞吐量的数据库和容器以及多个其他选项。
创建 Azure Cosmos DB Core (SQL) API 存储过程

部署到 Azure
此模板为 Core (SQL) API 创建 Azure Cosmos DB 帐户,并使用存储过程、触发器和用户定义的函数创建容器。
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB

部署到 Azure
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。

Terraform (AzAPI 提供程序) 资源定义

databaseAccounts/sqlDatabases 资源类型可以使用以下目标操作进行部署:

  • 资源组

有关每个 API 版本中更改的属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.DocumentDB/databaseAccounts/sqlDatabases 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-05-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        createMode = "string"
        id = "string"
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
        }
      }
    }
  })
}

属性值

databaseAccounts/sqlDatabases

名称 说明 Value
type 资源类型 “Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-05-15”
name 资源名称 字符串 (必需)
location 资源所属的资源组的位置。 字符串
parent_id 此资源的父资源 ID。 类型为:databaseAccounts 的资源的 ID
标记 标记是描述资源的键值对的列表。 在查看此资源和为此资源分组(跨资源组)时,可以使用这些标记。 最多可以为一个资源提供 15 个标记。 每个标记的键不能超过 128 个字符,值不能超过 256 个字符。 例如,模板类型的默认体验设置为“defaultExperience”:“Cassandra”。 当前的“defaultExperience”值还包括“Table”、“Graph”、“DocumentDB”和“MongoDB”。 标记名称和值的字典。
properties 用于创建和更新 Azure Cosmos DB SQL 数据库的属性。 SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... 所需的 ()

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

名称 说明 Value
options 要应用于请求的选项的键值对。 这对应于随请求一起发送的标头。 CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
resource SQL 数据库的标准 JSON 格式 SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... 所需的 ()

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

名称 说明
autoscaleSettings 指定自动缩放设置。 注意:需要吞吐量或 autoscaleSettings,但不能同时满足这两项要求。 AutoscaleSettings
throughput 每秒请求单位数。 例如,“throughput”:10000。 int

AutoscaleSettings

名称 说明
maxThroughput 表示资源可以纵向扩展到的最大吞吐量。 int

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

名称 说明
createMode 用于指示资源创建模式的枚举。 “Default”
“还原”
id Cosmos DB SQL 数据库的名称 字符串 (必需)
restoreParameters 用于指示有关还原的信息的参数 ResourceRestoreParameters

ResourceRestoreParameters

名称 说明
restoreSource 必须从中启动还原的可还原数据库帐户的 ID。 例如:/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} 字符串
restoreTimestampInUtc 帐户必须还原到的时间 (ISO-8601 格式) 。 字符串