你当前正在访问 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...
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 格式) 。 |
字符串 |
快速入门模板
以下快速入门模板部署此资源类型。
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...
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 格式) 。 |
字符串 |
快速入门模板
以下快速入门模板部署此资源类型。
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...
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 格式) 。 |
字符串 |