تعريف مورد Bicep
يمكن نشر نوع مورد databaseAccounts/sqlDatabases مع العمليات التي تستهدف:
- مجموعات الموارد - انظر <أوامر نشر مجموعة الموارد> c1
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
أمثلة الاستخدام
عينات Bicep
مثال أساسي لنشر قاعدة بيانات SQL داخل حساب Cosmos DB.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource databaseAccount 'Microsoft.DocumentDB/databaseAccounts@2021-10-15' = {
name: resourceName
location: location
kind: 'GlobalDocumentDB'
properties: {
capabilities: []
consistencyPolicy: {
defaultConsistencyLevel: 'BoundedStaleness'
maxIntervalInSeconds: 10
maxStalenessPrefix: 200
}
databaseAccountOfferType: 'Standard'
defaultIdentity: 'FirstPartyIdentity'
disableKeyBasedMetadataWriteAccess: false
disableLocalAuth: false
enableAnalyticalStorage: false
enableAutomaticFailover: false
enableFreeTier: false
enableMultipleWriteLocations: false
ipRules: []
isVirtualNetworkFilterEnabled: false
locations: [
{
failoverPriority: 0
isZoneRedundant: false
locationName: 'West Europe'
}
]
networkAclBypass: 'None'
networkAclBypassResourceIds: []
publicNetworkAccess: 'Enabled'
virtualNetworkRules: []
}
}
resource sqlDatabase 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15' = {
name: resourceName
parent: databaseAccount
properties: {
options: {
throughput: 400
}
resource: {
id: resourceName
}
}
}
نماذج Azure Quickstart
تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.
لإنشاء مورد Microsoft.DocumentDB/databaseAccounts/sqlDatabases، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2026-03-15' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
options: {
autoscaleSettings: {
maxThroughput: int
}
throughput: int
}
resource: {
createMode: 'string'
id: 'string'
restoreParameters: {
restoreSource: 'string'
restoreTimestampInUtc: 'string'
restoreWithTtlDisabled: bool
}
}
}
tags: {
{customized property}: 'string'
}
}
قيم الخصائص
Microsoft.DocumentDB/databaseAccounts/sqlDatabases
إعدادات التحجيم التلقائي
| اسم |
الوصف |
Value |
| الحد الأقصى لمعدل النقل |
يمثل الحد الأقصى لمعدل النقل، يمكن للمورد توسيع نطاقه. |
int |
CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
| اسم |
الوصف |
Value |
| إعدادات التحجيم التلقائي |
تحديد إعدادات التحجيم التلقائي. ملاحظة: مطلوب إما معدل النقل أو إعدادات التحجيم التلقائي، ولكن ليس كليهما. |
AutoscaleSettings |
| معدل النقل |
طلب الوحدات في الثانية. على سبيل المثال، "معدل النقل": 10000. |
int |
معرف الخدمة المدارة
| اسم |
الوصف |
Value |
| النوع |
نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. |
"بلا" "تم تعيين النظام" "تم تعيين النظام، UserAssigned "تعيين المستخدم" |
| معرفات مستخدم معينة |
قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
ManagedServiceIdentityUserAssignedIdentities
معلمات ResourceRestore
| اسم |
الوصف |
Value |
| restoreSource |
معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
سلسلة نصية |
| restoreTimestampInUtc |
الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). |
سلسلة نصية |
| restoreWithTtlDisabled |
يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. |
bool |
SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties
SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource
| اسم |
الوصف |
Value |
| createMode |
تعداد للإشارة إلى وضع إنشاء الحساب. |
'Default' "استعادة" |
| id |
اسم قاعدة بيانات Cosmos DB SQL |
سلسلة (مطلوب) |
| restoreParameters |
معلمات للإشارة إلى معلومات حول الاستعادة |
ResourceRestoreParameters |
تعريف مورد قالب ARM
يمكن نشر نوع مورد databaseAccounts/sqlDatabases مع العمليات التي تستهدف:
أمثلة الاستخدام
قوالب Azure Quickstart
قوالب Azure Quickstart التالية توزيع نوع المورد هذا.
لإنشاء مورد Microsoft.DocumentDB/databaseAccounts/sqlDatabases، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
"apiVersion": "2026-03-15",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"options": {
"autoscaleSettings": {
"maxThroughput": "int"
},
"throughput": "int"
},
"resource": {
"createMode": "string",
"id": "string",
"restoreParameters": {
"restoreSource": "string",
"restoreTimestampInUtc": "string",
"restoreWithTtlDisabled": "bool"
}
}
},
"tags": {
"{customized property}": "string"
}
}
قيم الخصائص
Microsoft.DocumentDB/databaseAccounts/sqlDatabases
| اسم |
الوصف |
Value |
| apiVersion |
إصدار واجهة برمجة التطبيقات |
'2026-03-15' |
| الهوية |
هوية المورد. |
ManagedServiceIdentity |
| مكان |
موقع مجموعة الموارد التي ينتمي إليها المورد. |
سلسلة نصية |
| الاسم |
اسم المورد |
سلسلة (مطلوب) |
| الخصائص |
خصائص لإنشاء وتحديث قاعدة بيانات Azure Cosmos DB SQL. |
SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (مطلوب) |
| العلامات |
علامات الموارد |
قاموس أسماء العلامات والقيم. انظر الوسوم في القوالب |
| النوع |
نوع المورد |
"Microsoft.DocumentDB/databaseAccounts/sqlDatabases" |
إعدادات التحجيم التلقائي
| اسم |
الوصف |
Value |
| الحد الأقصى لمعدل النقل |
يمثل الحد الأقصى لمعدل النقل، يمكن للمورد توسيع نطاقه. |
int |
CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
| اسم |
الوصف |
Value |
| إعدادات التحجيم التلقائي |
تحديد إعدادات التحجيم التلقائي. ملاحظة: مطلوب إما معدل النقل أو إعدادات التحجيم التلقائي، ولكن ليس كليهما. |
AutoscaleSettings |
| معدل النقل |
طلب الوحدات في الثانية. على سبيل المثال، "معدل النقل": 10000. |
int |
معرف الخدمة المدارة
| اسم |
الوصف |
Value |
| النوع |
نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. |
"بلا" "تم تعيين النظام" "تم تعيين النظام، UserAssigned "تعيين المستخدم" |
| معرفات مستخدم معينة |
قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
ManagedServiceIdentityUserAssignedIdentities
معلمات ResourceRestore
| اسم |
الوصف |
Value |
| restoreSource |
معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
سلسلة نصية |
| restoreTimestampInUtc |
الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). |
سلسلة نصية |
| restoreWithTtlDisabled |
يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. |
bool |
SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties
SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource
| اسم |
الوصف |
Value |
| createMode |
تعداد للإشارة إلى وضع إنشاء الحساب. |
'Default' "استعادة" |
| id |
اسم قاعدة بيانات Cosmos DB SQL |
سلسلة (مطلوب) |
| restoreParameters |
معلمات للإشارة إلى معلومات حول الاستعادة |
ResourceRestoreParameters |
يمكن نشر نوع مورد databaseAccounts/sqlDatabases مع العمليات التي تستهدف:
-
مجموعات الموارد للحصول على قائمة بالخصائص المتغيرة في كل إصدار من واجهة برمجة التطبيقات، انظر سجل التغيير.
أمثلة الاستخدام
مثال أساسي لنشر قاعدة بيانات SQL داخل حساب Cosmos DB.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "databaseAccount" {
type = "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
kind = "GlobalDocumentDB"
properties = {
capabilities = [
]
consistencyPolicy = {
defaultConsistencyLevel = "BoundedStaleness"
maxIntervalInSeconds = 10
maxStalenessPrefix = 200
}
databaseAccountOfferType = "Standard"
defaultIdentity = "FirstPartyIdentity"
disableKeyBasedMetadataWriteAccess = false
disableLocalAuth = false
enableAnalyticalStorage = false
enableAutomaticFailover = false
enableFreeTier = false
enableMultipleWriteLocations = false
ipRules = [
]
isVirtualNetworkFilterEnabled = false
locations = [
{
failoverPriority = 0
isZoneRedundant = false
locationName = "West Europe"
},
]
networkAclBypass = "None"
networkAclBypassResourceIds = [
]
publicNetworkAccess = "Enabled"
virtualNetworkRules = [
]
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "sqlDatabase" {
type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15"
parent_id = azapi_resource.databaseAccount.id
name = var.resource_name
body = {
properties = {
options = {
throughput = 400
}
resource = {
id = var.resource_name
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
لإنشاء مورد Microsoft.DocumentDB/databaseAccounts/sqlDatabases، أضف Terraform التالي إلى القالب الخاص بك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2026-03-15"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
options = {
autoscaleSettings = {
maxThroughput = int
}
throughput = int
}
resource = {
createMode = "string"
id = "string"
restoreParameters = {
restoreSource = "string"
restoreTimestampInUtc = "string"
restoreWithTtlDisabled = bool
}
}
}
}
}
قيم الخصائص
Microsoft.DocumentDB/databaseAccounts/sqlDatabases
| اسم |
الوصف |
Value |
| الهوية |
هوية المورد. |
ManagedServiceIdentity |
| مكان |
موقع مجموعة الموارد التي ينتمي إليها المورد. |
سلسلة نصية |
| الاسم |
اسم المورد |
سلسلة (مطلوب) |
| parent_id |
معرف المورد الأصل لهذا المورد. |
معرف المورد من النوع: databaseAccounts |
| الخصائص |
خصائص لإنشاء وتحديث قاعدة بيانات Azure Cosmos DB SQL. |
SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (مطلوب) |
| العلامات |
علامات الموارد |
قاموس أسماء العلامات والقيم. |
| النوع |
نوع المورد |
"Microsoft. DocumentDB/databaseAccounts/sqlDatabases@2026-03-15" |
إعدادات التحجيم التلقائي
| اسم |
الوصف |
Value |
| الحد الأقصى لمعدل النقل |
يمثل الحد الأقصى لمعدل النقل، يمكن للمورد توسيع نطاقه. |
int |
CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
| اسم |
الوصف |
Value |
| إعدادات التحجيم التلقائي |
تحديد إعدادات التحجيم التلقائي. ملاحظة: مطلوب إما معدل النقل أو إعدادات التحجيم التلقائي، ولكن ليس كليهما. |
AutoscaleSettings |
| معدل النقل |
طلب الوحدات في الثانية. على سبيل المثال، "معدل النقل": 10000. |
int |
معرف الخدمة المدارة
| اسم |
الوصف |
Value |
| النوع |
نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. |
"بلا" "تم تعيين النظام" "تم تعيين النظام، UserAssigned "تعيين المستخدم" |
| معرفات مستخدم معينة |
قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
ManagedServiceIdentityUserAssignedIdentities
معلمات ResourceRestore
| اسم |
الوصف |
Value |
| restoreSource |
معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
سلسلة نصية |
| restoreTimestampInUtc |
الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). |
سلسلة نصية |
| restoreWithTtlDisabled |
يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. |
bool |
SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties
SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource
| اسم |
الوصف |
Value |
| createMode |
تعداد للإشارة إلى وضع إنشاء الحساب. |
'Default' "استعادة" |
| id |
اسم قاعدة بيانات Cosmos DB SQL |
سلسلة (مطلوب) |
| restoreParameters |
معلمات للإشارة إلى معلومات حول الاستعادة |
ResourceRestoreParameters |