مشاركة عبر


حسابات قاعدة بيانات Microsoft.DocumentDB

تعريف مورد Bicep

يمكن نشر نوع مورد databaseAccounts مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.DocumentDB/databaseAccounts، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2025-11-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    analyticalStorageConfiguration: {
      schemaType: 'string'
    }
    apiProperties: {
      serverVersion: 'string'
    }
    backupPolicy: {
      migrationState: {
        startTime: 'string'
        status: 'string'
        targetType: 'string'
      }
      type: 'string'
      // For remaining properties, see BackupPolicy objects
    }
    capabilities: [
      {
        name: 'string'
      }
    ]
    capacity: {
      totalThroughputLimit: int
    }
    capacityMode: 'string'
    connectorOffer: 'string'
    consistencyPolicy: {
      defaultConsistencyLevel: 'string'
      maxIntervalInSeconds: int
      maxStalenessPrefix: int
    }
    cors: [
      {
        allowedHeaders: 'string'
        allowedMethods: 'string'
        allowedOrigins: 'string'
        exposedHeaders: 'string'
        maxAgeInSeconds: int
      }
    ]
    createMode: 'string'
    customerManagedKeyStatus: 'string'
    databaseAccountOfferType: 'Standard'
    defaultIdentity: 'string'
    defaultPriorityLevel: 'string'
    diagnosticLogSettings: {
      enableFullTextQuery: 'string'
    }
    disableKeyBasedMetadataWriteAccess: bool
    disableLocalAuth: bool
    enableAllVersionsAndDeletesChangeFeed: bool
    enableAnalyticalStorage: bool
    enableAutomaticFailover: bool
    enableBurstCapacity: bool
    enableCassandraConnector: bool
    enableFreeTier: bool
    enableMaterializedViews: bool
    enableMultipleWriteLocations: bool
    enablePartitionMerge: bool
    enablePerRegionPerPartitionAutoscale: bool
    enablePriorityBasedExecution: bool
    ipRules: [
      {
        ipAddressOrRange: 'string'
      }
    ]
    isVirtualNetworkFilterEnabled: bool
    keyVaultKeyUri: 'string'
    locations: [
      {
        failoverPriority: int
        isZoneRedundant: bool
        locationName: 'string'
      }
    ]
    minimalTlsVersion: 'string'
    networkAclBypass: 'string'
    networkAclBypassResourceIds: [
      'string'
    ]
    publicNetworkAccess: 'string'
    restoreParameters: {
      databasesToRestore: [
        {
          collectionNames: [
            'string'
          ]
          databaseName: 'string'
        }
      ]
      gremlinDatabasesToRestore: [
        {
          databaseName: 'string'
          graphNames: [
            'string'
          ]
        }
      ]
      restoreMode: 'string'
      restoreSource: 'string'
      restoreTimestampInUtc: 'string'
      restoreWithTtlDisabled: bool
      sourceBackupLocation: 'string'
      tablesToRestore: [
        'string'
      ]
    }
    virtualNetworkRules: [
      {
        id: 'string'
        ignoreMissingVNetServiceEndpoint: bool
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

عناصر نهج النسخ الاحتياطي

تعيين نوع الخاصية لتحديد نوع الكائن.

للحصول علىالمستمر ، استخدم:

{
  continuousModeProperties: {
    tier: 'string'
  }
  type: 'Continuous'
}

بالنسبةالدوري ، استخدم:

{
  periodicModeProperties: {
    backupIntervalInMinutes: int
    backupRetentionIntervalInHours: int
    backupStorageRedundancy: 'string'
  }
  type: 'Periodic'
}

قيم الخصائص

Microsoft.DocumentDB/databaseAccounts

اسم وصف قيمة
الهوية هوية المورد. ManagedServiceIdentity
نوع يشير إلى نوع حساب قاعدة البيانات. يمكن تعيين هذا فقط عند إنشاء حساب قاعدة البيانات. "GlobalDocumentDB"
"MongoDB"
"تحليل"
مكان موقع مجموعة الموارد التي ينتمي إليها المورد. خيط
اسم اسم المورد خيط

القيود:
الحد الأدنى للطول = 3
الحد الأقصى للطول = 50
النمط = ^[a-z0-9]+(-[a-z0-9]+)* (مطلوب)
خصائص خصائص لإنشاء حسابات قاعدة بيانات Azure Cosmos DB وتحديثها. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

تكوين التخزين التحليلي

اسم وصف قيمة
نوع المخطط يصف أنواع المخطط للتخزين التحليلي. "كامل الكفاءة"
'معرف جيدا'

خصائص واجهة برمجة التطبيقات

اسم وصف قيمة
إصدار الخادم يصف إصدار حساب MongoDB. '3.2'
'3.6'
'4.0'
'4.2'
'5.0'
'6.0'
'7.0'

ARMResourcePropertiesTags

اسم وصف قيمة

نهج النسخ الاحتياطي

اسم وصف قيمة
حالة الترحيل الكائن الذي يمثل حالة الترحيل بين نهج النسخ الاحتياطي. BackupPolicyMigrationState
نوع تعيين إلى "مستمر" للنوع ContinuousModeBackupPolicy. قم بتعيين إلى "دوري" للنوع PeriodicModeBackupPolicy. "مستمر"
'دوري' (مطلوب)

BackupPolicyMigrationState

اسم وصف قيمة
وقت البدء الوقت الذي بدأ فيه ترحيل نهج النسخ الاحتياطي (تنسيق ISO-8601). خيط
حالة يصف حالة الترحيل بين أنواع نهج النسخ الاحتياطي. "مكتمل"
"فشل"
"InProgress"
"غير صالح"
نوع الهدف يصف نوع نهج النسخ الاحتياطي الهدف لترحيل نهج النسخ الاحتياطي. "مستمر"
"دوري"

تمكن

اسم وصف قيمة
اسم اسم قدرة Cosmos DB. على سبيل المثال، "الاسم": "EnableCassandra". تتضمن القيم الحالية أيضا "EnableTable" و"EnableGremlin". خيط

سعة

اسم وصف قيمة
إجمالي معدل الإنتاجية الحد الإجمالي لمعدل النقل المفروض على الحساب. يفرض TotalThroughputLimit من 2000 حدا صارما لمعدل النقل الأقصى الذي يمكن توفيره على هذا الحساب ليكون 2000. يشير إجمالي معدل النقل من -1 إلى عدم وجود حدود لتوفير معدل النقل. الباحث

القيود:
قيمة الحد الأدنى = -1

نهج التناسق

اسم وصف قيمة
مستوى التوافق الافتراضي مستوى التناسق الافتراضي وإعدادات التكوين لحساب Cosmos DB. "BoundedStaleness"
"بادئة متسقة"
"في نهاية المطاف"
"جلسة عمل"
'قوي' (مطلوب)
maxIntervalInSeconds عند استخدامها مع مستوى تناسق Bounded Staleness، تمثل هذه القيمة مقدار الوقت المسموح به للثبات (بالثوان). النطاق المقبول لهذه القيمة هو 5 - 86400. مطلوب عند تعيين defaultConsistencyPolicy إلى "BoundedStaleness". الباحث

القيود:
الحد الأدنى للقيمة = 5
القيمة القصوى = 86400
maxStalenessبادئة عند استخدامها مع مستوى تناسق Bounded Staleness، تمثل هذه القيمة عدد الطلبات القديمة المسموح بها. النطاق المقبول لهذه القيمة هو 1 – 2,147,483,647. مطلوب عند تعيين defaultConsistencyPolicy إلى "BoundedStaleness". الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 2147483647

نهج النسخ الاحتياطي المستمر

اسم وصف قيمة
خصائص التعديل المستمر قيم التكوين للنسخ الاحتياطي لوضع مستمر ContinuousModeProperties
نوع يصف وضع النسخ الاحتياطية. "مستمر" (مطلوب)

خصائص التعديل المستمر

اسم وصف قيمة
المستوي تعداد للإشارة إلى نوع وضع النسخ الاحتياطي Continuos "30 يوما مستمرا"
"مستمر 7 أيام"

نهج Cors

اسم وصف قيمة
عناوين العناوين المسموح بها عناوين الطلب التي قد يحددها مجال الأصل على طلب CORS. خيط
طرق التتبع المسموح بها الأساليب (أفعال طلب HTTP) التي قد يستخدمها مجال الأصل لطلب CORS. خيط
التواريخ الأصلية المسموح بها مجالات الأصل المسموح لها بإجراء طلب مقابل الخدمة عبر CORS. سلسلة (مطلوب)
عناوين مكشوفة عناوين الاستجابة التي قد يتم إرسالها في الاستجابة لطلب CORS وعرضها بواسطة المستعرض لمصدر الطلب. خيط
maxAgeInSeconds الحد الأقصى لمقدار الوقت الذي يجب أن يقوم المستعرض بلتخزين المؤقت لطلب خيارات الاختبار المبدئي. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 2147483647

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties

اسم وصف قيمة
تكوين التخزين التحليلي خصائص محددة للتخزين التحليلي. تكوين التخزين التحليلي
خصائص واجهة برمجة التطبيقات خصائص محددة لواجهة برمجة التطبيقات. حاليا، مدعوم فقط لواجهة برمجة تطبيقات MongoDB. ApiProperties
نهج النسخ الاحتياطي الكائن الذي يمثل نهج أخذ النسخ الاحتياطية على حساب. نهج النسخ الاحتياطي
قدرات قائمة قدرات Cosmos DB للحساب القدرة []
سعة الكائن الذي يمثل جميع الخصائص المتعلقة بتطبيق السعة على حساب. السعة
وضع السعة يشير إلى capacityMode لحساب Cosmos DB. "بلا"
"تم التوفير"
"بلا خادم"
الموصلOffer نوع عرض موصل cassandra لحساب قاعدة بيانات Cosmos DB C*. "صغير"
نهج التناسق نهج التناسق لحساب Cosmos DB. نهج التناسق
CORS نهج CORS لحساب قاعدة بيانات Cosmos DB. CorsPolicy []
createMode تعداد للإشارة إلى وضع إنشاء الحساب. "افتراضي"
"استعادة"
customerManagedKeyStatus يشير إلى حالة ميزة المفتاح المدار للعميل على الحساب. في حالة وجود أخطاء، توفر الخاصية إرشادات استكشاف الأخطاء وإصلاحها. خيط
نوع حساب قاعدة البيانات نوع العرض لحساب قاعدة بيانات Cosmos DB. 'قياسي' (مطلوب)
معرف افتراضي الهوية الافتراضية للوصول إلى خزنة المفاتيح المستخدمة في ميزات مثل المفاتيح المدارة من قبل العميل. يجب تعيين الهوية الافتراضية بشكل صريح من قبل المستخدمين. يمكن أن يكون "FirstPartyIdentity" و"SystemAssignedIdentity" والمزيد. خيط
مستوى الدقة الافتراضية تعداد للإشارة إلى مستوى الأولوية الافتراضي لطلب التنفيذ المستند إلى الأولوية. "مرتفع"
"منخفض"
diagnosticLogSettings الكائن الذي يمثل إعدادات سجل التشخيص المختلفة لحساب Cosmos DB. DiagnosticLogSettings
disableKeyBasedMetadataWriteAccess تعطيل عمليات الكتابة على موارد بيانات التعريف (قواعد البيانات والحاويات ومعدل النقل) عبر مفاتيح الحساب قيمة منطقية
تعطيلLocalAuth إلغاء الاشتراك في المصادقة المحلية والتأكد من أن MSI وAD فقط يمكن استخدامهما حصريا للمصادقة. قيمة منطقية
enableAllVersionsAndDeletesChangeFeed وضع علامة للإشارة إلى ما إذا كانت ميزة تغيير جميع الإصدارات والحذف ممكنة على الحساب قيمة منطقية
تمكينAnalyticalStorage ضع علامة للإشارة إلى ما إذا كان يجب تمكين تحليلات التخزين. قيمة منطقية
enableAutomaticFailover تمكين تجاوز الفشل التلقائي لمنطقة الكتابة في الحدث النادر الذي لا تتوفر فيه المنطقة بسبب انقطاع التيار الكهربائي. سيؤدي تجاوز الفشل التلقائي إلى منطقة كتابة جديدة للحساب ويتم اختياره استنادا إلى أولويات تجاوز الفشل التي تم تكوينها للحساب. قيمة منطقية
تمكين القدرة على العمل وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة سعة الاندفاع على الحساب قيمة منطقية
تمكين CassandraConnector تمكين موصل cassandra على حساب Cosmos DB C* قيمة منطقية
تمكينFreeTier ضع علامة للإشارة إلى ما إذا كان المستوى المجاني ممكنا أم لا. قيمة منطقية
enableMaterializedViews وضع علامة للإشارة إلى ما إذا كان يجب تمكين MaterializedViews على حساب Cosmos DB قيمة منطقية
تمكين MultipleWriteLocations تمكين الحساب من الكتابة في مواقع متعددة قيمة منطقية
تمكينPartitionMerge وضع علامة للإشارة إلى تمكين/تعطيل ميزة دمج الأقسام على الحساب قيمة منطقية
enablePerRegionPerPartitionAutoscale وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة التحجيم التلقائي لكل قسم Per-Region على الحساب قيمة منطقية
تمكينPriorityBasedExecution وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة التنفيذ المستندة إلى الأولوية على الحساب قيمة منطقية
قواعد ip قائمة IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled ضع علامة للإشارة إلى ما إذا كان يجب تمكين/تعطيل قواعد ACL للشبكة الظاهرية. قيمة منطقية
keyVaultKeyUri عنوان URI لمخزن المفاتيح خيط
مواقع صفيف يحتوي على مواقع التبسيط الجغرافي الممكنة لحساب Cosmos DB. الموقع [] (مطلوب)
الحد الأدنى لTlsVersion يشير إلى الحد الأدنى المسموح به لإصدار Tls. الإعداد الافتراضي هو Tls 1.0، باستثناء Cassandra وMongo API، والتي تعمل فقط مع Tls 1.2. "TLS"
"TLS11"
"TLS12"
شبكةAclBypass يشير إلى الخدمات المسموح لها بتجاوز عمليات التحقق من جدار الحماية. "AzureServices"
"بلا"
networkAclBypassResourceIds صفيف يحتوي على معرفات الموارد لتجاوز Network Acl لحساب Cosmos DB. سلسلة[]
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
"SecuredByPerimeter"
استعادة المقاييس معلمات للإشارة إلى معلومات حول الاستعادة. RestoreParameters
قواعد الشبكة الظاهرية قائمة قواعد ACL للشبكة الظاهرية التي تم تكوينها لحساب Cosmos DB. VirtualNetworkRule []

DatabaseRestoreResource

اسم وصف قيمة
أسماء المجموعات أسماء المجموعات المتوفرة للاستعادة. سلسلة[]
اسم قاعدة البيانات اسم قاعدة البيانات المتوفرة للاستعادة. خيط

DiagnosticLogSettings

اسم وصف قيمة
enableFullTextQuery وصف مستوى التفاصيل التي سيتم تسجيل الاستعلامات بها. "خطأ"
"بلا"
"صحيح"

GremlinDatabaseRestoreResource

اسم وصف قيمة
اسم قاعدة البيانات اسم قاعدة بيانات gremlin المتوفرة للاستعادة. خيط
أسماء الرسم البياني أسماء الرسوم البيانية المتوفرة للاستعادة. سلسلة[]

IpAddressOrRange

اسم وصف قيمة
ipAddressOrRange عنوان IPv4 واحد أو نطاق عناوين IPv4 واحد بتنسيق CIDR. يجب أن تكون عناوين IP المتوفرة منسقة بشكل جيد ولا يمكن تضمينها في أحد النطاقات التالية: 10.0.0.0/8، 100.64.0.0/10، 172.16.0.0/12، 192.168.0.0/16، حيث لا يمكن فرضها بواسطة عامل تصفية عنوان IP. مثال على الإدخالات الصالحة: "23.40.210.245" أو "23.40.210.0/8". خيط

مكان

اسم وصف قيمة
ميزة تجاوز الفشل أولوية تجاوز الفشل للمنطقة. تشير أولوية تجاوز الفشل 0 إلى منطقة كتابة. الحد الأقصى لقيمة أولوية تجاوز الفشل = (العدد الإجمالي للمناطق - 1). يجب أن تكون قيم أولوية تجاوز الفشل فريدة لكل منطقة من المناطق التي يوجد فيها حساب قاعدة البيانات. الباحث

القيود:
قيمة الحد الأدنى = 0
isZoneRedundant وضع علامة للإشارة إلى ما إذا كانت هذه المنطقة منطقة AvailabilityZone أم لا قيمة منطقية
اسم الموقع اسم المنطقة. خيط

معرف الخدمة المدارة

اسم وصف قيمة
نوع نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"تعيين المستخدم"
معرفات تعيين المستخدم قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

نهج النسخ الاحتياطي الدوري

اسم وصف قيمة
خصائص التعديل الدورية قيم التكوين للنسخ الاحتياطي لوضع دوري PeriodicModeProperties
نوع يصف وضع النسخ الاحتياطية. 'دوري' (مطلوب)

خصائص الوحدات الدورية

اسم وصف قيمة
تنبيهات IntervalInMinutes للنسخ الاحتياطي عدد صحيح يمثل الفاصل الزمني بالدقائق بين نسختين احتياطيتين الباحث

القيود:
قيمة الحد الأدنى = 0
BackupRetentionIntervalInHours عدد صحيح يمثل الوقت (بالساعات) الذي يتم فيه الاحتفاظ بكل نسخة احتياطية الباحث

القيود:
قيمة الحد الأدنى = 0
النسخ الاحتياطيالتخزينالتكرار تعداد للإشارة إلى نوع موقع النسخ الاحتياطي "الموقع الجغرافي"
"محلي"
"المنطقة"

استعادة المعلمات

اسم وصف قيمة
قواعد البياناتToRestore قائمة قواعد بيانات محددة متاحة للاستعادة. DatabaseRestoreResource[]
gremlinDatabasesToRestore قائمة قواعد بيانات gremlin محددة متاحة للاستعادة. GremlinDatabaseRestoreResource[]
restoreMode يصف وضع الاستعادة. "PointInTime"
استعادة المصدر معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} خيط
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). خيط
restoreWithTtlDisabled يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. قيمة منطقية
المصدرالنسخ الاحتياطي الموقع موقع النسخ الاحتياطي المصدر للاستعادة. خيط
جداول للاستعادة قائمة جداول محددة متوفرة للاستعادة. سلسلة[]

VirtualNetworkRule

اسم وصف قيمة
معرف معرف المورد لشبكة فرعية، على سبيل المثال: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. خيط
ignore MissingVNetServiceEndpoint إنشاء قاعدة جدار الحماية قبل تمكين نقطة نهاية خدمة vnet للشبكة الظاهرية. قيمة منطقية

أمثلة الاستخدام

عينات Bicep

مثال أساسي لنشر حساب CosmosDB (رسميا DocumentDB).

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: []
  }
}

الوحدات النمطية التي تم التحقق منها من Azure

يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.

الوحده النمطيه وصف
حساب قاعدة بيانات Cosmos DB وحدة موارد AVM لحساب قاعدة بيانات Cosmos DB

نماذج Azure Quickstart

تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.

ملف Bicep وصف
حساب Azure Cosmos DB SQL API مع مخزن تحليلي ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة تطبيقات Core (SQL) مع قاعدة بيانات وحاوية تم تكوينها باستخدام مخزن تحليلي.
حساب Azure Cosmos DB باستخدام تطبيق الويب ينشر هذا القالب حساب Azure Cosmos DB، وخطة خدمة التطبيقات، وينشئ تطبيق ويب في خطة خدمة التطبيقات. كما يضيف اثنين من إعدادات التطبيق إلى تطبيق الويب الذي يشير إلى نقطة نهاية حساب Azure Cosmos DB. بهذه الطريقة، يمكن للحلول المنشورة على تطبيق الويب الاتصال بنقطة نهاية حساب Azure Cosmos DB باستخدام هذه الإعدادات.
إنشاء حساب Cosmos DB مع تمكين Microsoft Defender باستخدام قالب ARM هذا، يمكنك نشر حساب Azure Cosmos DB مع تمكين Microsoft Defender ل Azure Cosmos DB. Microsoft Defender ل Azure Cosmos DB هو طبقة أمان أصلية من Azure تكتشف محاولات استغلال قواعد البيانات في حسابات Azure Cosmos DB الخاصة بك. يكتشف Microsoft Defender ل Azure Cosmos DB حقن SQL المحتملة، والممثلين السيئين المعروفين استنادا إلى التحليل الذكي للمخاطر من Microsoft، وأنماط الوصول المشبوهة، والاستغلال المحتمل لقاعدة البيانات الخاصة بك من خلال الهويات المخترقة أو المطلعين الضارين.
إنشاء حساب Azure Cosmos DB مجاني ينشئ هذا القالب حساب Azure Cosmos DB مجانيا لواجهة برمجة تطبيقات SQL مع قاعدة بيانات ذات معدل نقل وحاوية مشتركين.
إنشاء الحد الأدنى من حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL) ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL) مع تحديد الحد الأدنى من خصائص المورد المطلوبة فقط.
إنشاء حساب Azure Cosmos DB بلا خادم لواجهة برمجة تطبيقات SQL ينشئ هذا القالب حساب Azure Cosmos DB بلا خادم لواجهة برمجة تطبيقات Core (SQL).
إنشاء حساب Azure Cosmos بدون لمس وAzure Web App ينشئ هذا القالب حساب Azure Cosmos، ويدخل نقطة نهاية Cosmos DB والمفاتيح في إعدادات Azure Web App، ثم ينشر تطبيق ويب ASP MVC من GitHub.
إنشاء حساب Azure Cosmos لواجهة برمجة تطبيقات MongoDB ينشئ هذا القالب حساب Azure Cosmos DB ل MongoDB API 4.2 في منطقتين باستخدام معدل النقل المشترك والمخصص مع مجموعتين.
إنشاء حساب Azure Cosmos ل MongoDB API autoscale ينشئ هذا القالب حساب Azure Cosmos DB ل MongoDB API 4.2 في منطقتين باستخدام كل من معدل النقل التحجيم التلقائي المشترك والمخصص.
إنشاء حساب Azure Cosmos Table API ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات الجدول في منطقتين وجدول واحد مع معدل النقل المقدم.
إنشاء حساب Azure Cosmos ل Table API باستخدام التحجيم التلقائي ينشئ هذا القالب حساب Azure Cosmos DB ل Table API في منطقتين وجدول واحد مع معدل نقل مقياس تلقائي.
إنشاء حساب Azure Cosmos DB لواجهة برمجة تطبيقات Cassandra ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Cassandra في منطقتين مع مساحة مفتاح وجدول مع معدل نقل مخصص.
إنشاء حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL) ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة تطبيقات Core (SQL) مع قاعدة بيانات وحاوية ذات معدل نقل مع خيارات أخرى متعددة.
إنشاء حساب Azure Cosmos DB لواجهة برمجة تطبيقات Gremlin ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Gremlin في منطقتين مع قاعدة بيانات واحدة ورسم بياني واحد باستخدام معدل النقل المخصص.
إنشاء حساب Azure Cosmos DB ل Gremlin API autoscale ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Gremlin في منطقتين مع قاعدة بيانات واحدة ورسم بياني واحد باستخدام معدل النقل التلقائي.
إنشاء حساب Azure Cosmos DB في مناطق متعددة ينشئ هذا القالب حساب Azure Cosmos DB لأي نوع واجهة برمجة تطبيقات قاعدة بيانات مع منطقة أساسية وثانوية مع اختيار مستوى التناسق ونوع تجاوز الفشل.
إنشاء حساب Azure Cosmos DB SQL API باستخدام التحجيم التلقائي ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة تطبيقات Core (SQL) مع قاعدة بيانات وحاوية مع معدل نقل مقياس تلقائي مع خيارات أخرى متعددة.
إنشاء حساب Azure Cosmos DB بنقطة نهاية خاصة سيقوم هذا القالب بإنشاء حساب Cosmos وشبكة ظاهرية ونقطة نهاية خاصة تعرض حساب Cosmos للشبكة الظاهرية.
إنشاء حساب Azure Cosmos DB SQL مع مستوى البيانات RBAC سيقوم هذا القالب بإنشاء حساب SQL Cosmos، وتعريف دور تم الاحتفاظ به محليا، وتعيين دور تم الاحتفاظ به أصلا لهوية AAD.
إنشاء حساب Azure CosmosDB الهدف من قالب ARM هذا هو إنشاء حساب CosmosDB بسرعة مع الحد الأدنى من القيم المطلوبة
إنشاء حساب Azure Cosmos DB للتحجيم التلقائي لواجهة برمجة تطبيقات Cassandra ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Cassandra في منطقتين مع مساحة مفتاح وجدول مع معدل نقل مقياس تلقائي.
إنشاء الإجراءات المخزنة لواجهة برمجة تطبيقات Azure Cosmos DB Core (SQL) ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL) وحاوية مع إجراء مخزن ومشغل ووظيفة معرفة من قبل المستخدم.
إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية.
إنشاء تطبيق Dapr pub-sub servicebus باستخدام تطبيقات الحاوية إنشاء تطبيق Dapr pub-sub servicebus باستخدام Container Apps.
نشر Azure Data Explorer DB مع اتصال Cosmos DB نشر Azure Data Explorer DB مع اتصال Cosmos DB.

تعريف مورد قالب ARM

يمكن نشر نوع مورد databaseAccounts مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.DocumentDB/databaseAccounts، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2025-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "analyticalStorageConfiguration": {
      "schemaType": "string"
    },
    "apiProperties": {
      "serverVersion": "string"
    },
    "backupPolicy": {
      "migrationState": {
        "startTime": "string",
        "status": "string",
        "targetType": "string"
      },
      "type": "string"
      // For remaining properties, see BackupPolicy objects
    },
    "capabilities": [
      {
        "name": "string"
      }
    ],
    "capacity": {
      "totalThroughputLimit": "int"
    },
    "capacityMode": "string",
    "connectorOffer": "string",
    "consistencyPolicy": {
      "defaultConsistencyLevel": "string",
      "maxIntervalInSeconds": "int",
      "maxStalenessPrefix": "int"
    },
    "cors": [
      {
        "allowedHeaders": "string",
        "allowedMethods": "string",
        "allowedOrigins": "string",
        "exposedHeaders": "string",
        "maxAgeInSeconds": "int"
      }
    ],
    "createMode": "string",
    "customerManagedKeyStatus": "string",
    "databaseAccountOfferType": "Standard",
    "defaultIdentity": "string",
    "defaultPriorityLevel": "string",
    "diagnosticLogSettings": {
      "enableFullTextQuery": "string"
    },
    "disableKeyBasedMetadataWriteAccess": "bool",
    "disableLocalAuth": "bool",
    "enableAllVersionsAndDeletesChangeFeed": "bool",
    "enableAnalyticalStorage": "bool",
    "enableAutomaticFailover": "bool",
    "enableBurstCapacity": "bool",
    "enableCassandraConnector": "bool",
    "enableFreeTier": "bool",
    "enableMaterializedViews": "bool",
    "enableMultipleWriteLocations": "bool",
    "enablePartitionMerge": "bool",
    "enablePerRegionPerPartitionAutoscale": "bool",
    "enablePriorityBasedExecution": "bool",
    "ipRules": [
      {
        "ipAddressOrRange": "string"
      }
    ],
    "isVirtualNetworkFilterEnabled": "bool",
    "keyVaultKeyUri": "string",
    "locations": [
      {
        "failoverPriority": "int",
        "isZoneRedundant": "bool",
        "locationName": "string"
      }
    ],
    "minimalTlsVersion": "string",
    "networkAclBypass": "string",
    "networkAclBypassResourceIds": [ "string" ],
    "publicNetworkAccess": "string",
    "restoreParameters": {
      "databasesToRestore": [
        {
          "collectionNames": [ "string" ],
          "databaseName": "string"
        }
      ],
      "gremlinDatabasesToRestore": [
        {
          "databaseName": "string",
          "graphNames": [ "string" ]
        }
      ],
      "restoreMode": "string",
      "restoreSource": "string",
      "restoreTimestampInUtc": "string",
      "restoreWithTtlDisabled": "bool",
      "sourceBackupLocation": "string",
      "tablesToRestore": [ "string" ]
    },
    "virtualNetworkRules": [
      {
        "id": "string",
        "ignoreMissingVNetServiceEndpoint": "bool"
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

عناصر نهج النسخ الاحتياطي

تعيين نوع الخاصية لتحديد نوع الكائن.

للحصول علىالمستمر ، استخدم:

{
  "continuousModeProperties": {
    "tier": "string"
  },
  "type": "Continuous"
}

بالنسبةالدوري ، استخدم:

{
  "periodicModeProperties": {
    "backupIntervalInMinutes": "int",
    "backupRetentionIntervalInHours": "int",
    "backupStorageRedundancy": "string"
  },
  "type": "Periodic"
}

قيم الخصائص

Microsoft.DocumentDB/databaseAccounts

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات "معاينة 2025-11-01"
الهوية هوية المورد. ManagedServiceIdentity
نوع يشير إلى نوع حساب قاعدة البيانات. يمكن تعيين هذا فقط عند إنشاء حساب قاعدة البيانات. "GlobalDocumentDB"
"MongoDB"
"تحليل"
مكان موقع مجموعة الموارد التي ينتمي إليها المورد. خيط
اسم اسم المورد خيط

القيود:
الحد الأدنى للطول = 3
الحد الأقصى للطول = 50
النمط = ^[a-z0-9]+(-[a-z0-9]+)* (مطلوب)
خصائص خصائص لإنشاء حسابات قاعدة بيانات Azure Cosmos DB وتحديثها. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع نوع المورد "Microsoft.DocumentDB/databaseAccounts"

تكوين التخزين التحليلي

اسم وصف قيمة
نوع المخطط يصف أنواع المخطط للتخزين التحليلي. "كامل الكفاءة"
'معرف جيدا'

خصائص واجهة برمجة التطبيقات

اسم وصف قيمة
إصدار الخادم يصف إصدار حساب MongoDB. '3.2'
'3.6'
'4.0'
'4.2'
'5.0'
'6.0'
'7.0'

ARMResourcePropertiesTags

اسم وصف قيمة

نهج النسخ الاحتياطي

اسم وصف قيمة
حالة الترحيل الكائن الذي يمثل حالة الترحيل بين نهج النسخ الاحتياطي. BackupPolicyMigrationState
نوع تعيين إلى "مستمر" للنوع ContinuousModeBackupPolicy. قم بتعيين إلى "دوري" للنوع PeriodicModeBackupPolicy. "مستمر"
'دوري' (مطلوب)

BackupPolicyMigrationState

اسم وصف قيمة
وقت البدء الوقت الذي بدأ فيه ترحيل نهج النسخ الاحتياطي (تنسيق ISO-8601). خيط
حالة يصف حالة الترحيل بين أنواع نهج النسخ الاحتياطي. "مكتمل"
"فشل"
"InProgress"
"غير صالح"
نوع الهدف يصف نوع نهج النسخ الاحتياطي الهدف لترحيل نهج النسخ الاحتياطي. "مستمر"
"دوري"

تمكن

اسم وصف قيمة
اسم اسم قدرة Cosmos DB. على سبيل المثال، "الاسم": "EnableCassandra". تتضمن القيم الحالية أيضا "EnableTable" و"EnableGremlin". خيط

سعة

اسم وصف قيمة
إجمالي معدل الإنتاجية الحد الإجمالي لمعدل النقل المفروض على الحساب. يفرض TotalThroughputLimit من 2000 حدا صارما لمعدل النقل الأقصى الذي يمكن توفيره على هذا الحساب ليكون 2000. يشير إجمالي معدل النقل من -1 إلى عدم وجود حدود لتوفير معدل النقل. الباحث

القيود:
قيمة الحد الأدنى = -1

نهج التناسق

اسم وصف قيمة
مستوى التوافق الافتراضي مستوى التناسق الافتراضي وإعدادات التكوين لحساب Cosmos DB. "BoundedStaleness"
"بادئة متسقة"
"في نهاية المطاف"
"جلسة عمل"
'قوي' (مطلوب)
maxIntervalInSeconds عند استخدامها مع مستوى تناسق Bounded Staleness، تمثل هذه القيمة مقدار الوقت المسموح به للثبات (بالثوان). النطاق المقبول لهذه القيمة هو 5 - 86400. مطلوب عند تعيين defaultConsistencyPolicy إلى "BoundedStaleness". الباحث

القيود:
الحد الأدنى للقيمة = 5
القيمة القصوى = 86400
maxStalenessبادئة عند استخدامها مع مستوى تناسق Bounded Staleness، تمثل هذه القيمة عدد الطلبات القديمة المسموح بها. النطاق المقبول لهذه القيمة هو 1 – 2,147,483,647. مطلوب عند تعيين defaultConsistencyPolicy إلى "BoundedStaleness". الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 2147483647

نهج النسخ الاحتياطي المستمر

اسم وصف قيمة
خصائص التعديل المستمر قيم التكوين للنسخ الاحتياطي لوضع مستمر ContinuousModeProperties
نوع يصف وضع النسخ الاحتياطية. "مستمر" (مطلوب)

خصائص التعديل المستمر

اسم وصف قيمة
المستوي تعداد للإشارة إلى نوع وضع النسخ الاحتياطي Continuos "30 يوما مستمرا"
"مستمر 7 أيام"

نهج Cors

اسم وصف قيمة
عناوين العناوين المسموح بها عناوين الطلب التي قد يحددها مجال الأصل على طلب CORS. خيط
طرق التتبع المسموح بها الأساليب (أفعال طلب HTTP) التي قد يستخدمها مجال الأصل لطلب CORS. خيط
التواريخ الأصلية المسموح بها مجالات الأصل المسموح لها بإجراء طلب مقابل الخدمة عبر CORS. سلسلة (مطلوب)
عناوين مكشوفة عناوين الاستجابة التي قد يتم إرسالها في الاستجابة لطلب CORS وعرضها بواسطة المستعرض لمصدر الطلب. خيط
maxAgeInSeconds الحد الأقصى لمقدار الوقت الذي يجب أن يقوم المستعرض بلتخزين المؤقت لطلب خيارات الاختبار المبدئي. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 2147483647

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties

اسم وصف قيمة
تكوين التخزين التحليلي خصائص محددة للتخزين التحليلي. تكوين التخزين التحليلي
خصائص واجهة برمجة التطبيقات خصائص محددة لواجهة برمجة التطبيقات. حاليا، مدعوم فقط لواجهة برمجة تطبيقات MongoDB. ApiProperties
نهج النسخ الاحتياطي الكائن الذي يمثل نهج أخذ النسخ الاحتياطية على حساب. نهج النسخ الاحتياطي
قدرات قائمة قدرات Cosmos DB للحساب القدرة []
سعة الكائن الذي يمثل جميع الخصائص المتعلقة بتطبيق السعة على حساب. السعة
وضع السعة يشير إلى capacityMode لحساب Cosmos DB. "بلا"
"تم التوفير"
"بلا خادم"
الموصلOffer نوع عرض موصل cassandra لحساب قاعدة بيانات Cosmos DB C*. "صغير"
نهج التناسق نهج التناسق لحساب Cosmos DB. نهج التناسق
CORS نهج CORS لحساب قاعدة بيانات Cosmos DB. CorsPolicy []
createMode تعداد للإشارة إلى وضع إنشاء الحساب. "افتراضي"
"استعادة"
customerManagedKeyStatus يشير إلى حالة ميزة المفتاح المدار للعميل على الحساب. في حالة وجود أخطاء، توفر الخاصية إرشادات استكشاف الأخطاء وإصلاحها. خيط
نوع حساب قاعدة البيانات نوع العرض لحساب قاعدة بيانات Cosmos DB. 'قياسي' (مطلوب)
معرف افتراضي الهوية الافتراضية للوصول إلى خزنة المفاتيح المستخدمة في ميزات مثل المفاتيح المدارة من قبل العميل. يجب تعيين الهوية الافتراضية بشكل صريح من قبل المستخدمين. يمكن أن يكون "FirstPartyIdentity" و"SystemAssignedIdentity" والمزيد. خيط
مستوى الدقة الافتراضية تعداد للإشارة إلى مستوى الأولوية الافتراضي لطلب التنفيذ المستند إلى الأولوية. "مرتفع"
"منخفض"
diagnosticLogSettings الكائن الذي يمثل إعدادات سجل التشخيص المختلفة لحساب Cosmos DB. DiagnosticLogSettings
disableKeyBasedMetadataWriteAccess تعطيل عمليات الكتابة على موارد بيانات التعريف (قواعد البيانات والحاويات ومعدل النقل) عبر مفاتيح الحساب قيمة منطقية
تعطيلLocalAuth إلغاء الاشتراك في المصادقة المحلية والتأكد من أن MSI وAD فقط يمكن استخدامهما حصريا للمصادقة. قيمة منطقية
enableAllVersionsAndDeletesChangeFeed وضع علامة للإشارة إلى ما إذا كانت ميزة تغيير جميع الإصدارات والحذف ممكنة على الحساب قيمة منطقية
تمكينAnalyticalStorage ضع علامة للإشارة إلى ما إذا كان يجب تمكين تحليلات التخزين. قيمة منطقية
enableAutomaticFailover تمكين تجاوز الفشل التلقائي لمنطقة الكتابة في الحدث النادر الذي لا تتوفر فيه المنطقة بسبب انقطاع التيار الكهربائي. سيؤدي تجاوز الفشل التلقائي إلى منطقة كتابة جديدة للحساب ويتم اختياره استنادا إلى أولويات تجاوز الفشل التي تم تكوينها للحساب. قيمة منطقية
تمكين القدرة على العمل وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة سعة الاندفاع على الحساب قيمة منطقية
تمكين CassandraConnector تمكين موصل cassandra على حساب Cosmos DB C* قيمة منطقية
تمكينFreeTier ضع علامة للإشارة إلى ما إذا كان المستوى المجاني ممكنا أم لا. قيمة منطقية
enableMaterializedViews وضع علامة للإشارة إلى ما إذا كان يجب تمكين MaterializedViews على حساب Cosmos DB قيمة منطقية
تمكين MultipleWriteLocations تمكين الحساب من الكتابة في مواقع متعددة قيمة منطقية
تمكينPartitionMerge وضع علامة للإشارة إلى تمكين/تعطيل ميزة دمج الأقسام على الحساب قيمة منطقية
enablePerRegionPerPartitionAutoscale وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة التحجيم التلقائي لكل قسم Per-Region على الحساب قيمة منطقية
تمكينPriorityBasedExecution وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة التنفيذ المستندة إلى الأولوية على الحساب قيمة منطقية
قواعد ip قائمة IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled ضع علامة للإشارة إلى ما إذا كان يجب تمكين/تعطيل قواعد ACL للشبكة الظاهرية. قيمة منطقية
keyVaultKeyUri عنوان URI لمخزن المفاتيح خيط
مواقع صفيف يحتوي على مواقع التبسيط الجغرافي الممكنة لحساب Cosmos DB. الموقع [] (مطلوب)
الحد الأدنى لTlsVersion يشير إلى الحد الأدنى المسموح به لإصدار Tls. الإعداد الافتراضي هو Tls 1.0، باستثناء Cassandra وMongo API، والتي تعمل فقط مع Tls 1.2. "TLS"
"TLS11"
"TLS12"
شبكةAclBypass يشير إلى الخدمات المسموح لها بتجاوز عمليات التحقق من جدار الحماية. "AzureServices"
"بلا"
networkAclBypassResourceIds صفيف يحتوي على معرفات الموارد لتجاوز Network Acl لحساب Cosmos DB. سلسلة[]
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
"SecuredByPerimeter"
استعادة المقاييس معلمات للإشارة إلى معلومات حول الاستعادة. RestoreParameters
قواعد الشبكة الظاهرية قائمة قواعد ACL للشبكة الظاهرية التي تم تكوينها لحساب Cosmos DB. VirtualNetworkRule []

DatabaseRestoreResource

اسم وصف قيمة
أسماء المجموعات أسماء المجموعات المتوفرة للاستعادة. سلسلة[]
اسم قاعدة البيانات اسم قاعدة البيانات المتوفرة للاستعادة. خيط

DiagnosticLogSettings

اسم وصف قيمة
enableFullTextQuery وصف مستوى التفاصيل التي سيتم تسجيل الاستعلامات بها. "خطأ"
"بلا"
"صحيح"

GremlinDatabaseRestoreResource

اسم وصف قيمة
اسم قاعدة البيانات اسم قاعدة بيانات gremlin المتوفرة للاستعادة. خيط
أسماء الرسم البياني أسماء الرسوم البيانية المتوفرة للاستعادة. سلسلة[]

IpAddressOrRange

اسم وصف قيمة
ipAddressOrRange عنوان IPv4 واحد أو نطاق عناوين IPv4 واحد بتنسيق CIDR. يجب أن تكون عناوين IP المتوفرة منسقة بشكل جيد ولا يمكن تضمينها في أحد النطاقات التالية: 10.0.0.0/8، 100.64.0.0/10، 172.16.0.0/12، 192.168.0.0/16، حيث لا يمكن فرضها بواسطة عامل تصفية عنوان IP. مثال على الإدخالات الصالحة: "23.40.210.245" أو "23.40.210.0/8". خيط

مكان

اسم وصف قيمة
ميزة تجاوز الفشل أولوية تجاوز الفشل للمنطقة. تشير أولوية تجاوز الفشل 0 إلى منطقة كتابة. الحد الأقصى لقيمة أولوية تجاوز الفشل = (العدد الإجمالي للمناطق - 1). يجب أن تكون قيم أولوية تجاوز الفشل فريدة لكل منطقة من المناطق التي يوجد فيها حساب قاعدة البيانات. الباحث

القيود:
قيمة الحد الأدنى = 0
isZoneRedundant وضع علامة للإشارة إلى ما إذا كانت هذه المنطقة منطقة AvailabilityZone أم لا قيمة منطقية
اسم الموقع اسم المنطقة. خيط

معرف الخدمة المدارة

اسم وصف قيمة
نوع نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"تعيين المستخدم"
معرفات تعيين المستخدم قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

نهج النسخ الاحتياطي الدوري

اسم وصف قيمة
خصائص التعديل الدورية قيم التكوين للنسخ الاحتياطي لوضع دوري PeriodicModeProperties
نوع يصف وضع النسخ الاحتياطية. 'دوري' (مطلوب)

خصائص الوحدات الدورية

اسم وصف قيمة
تنبيهات IntervalInMinutes للنسخ الاحتياطي عدد صحيح يمثل الفاصل الزمني بالدقائق بين نسختين احتياطيتين الباحث

القيود:
قيمة الحد الأدنى = 0
BackupRetentionIntervalInHours عدد صحيح يمثل الوقت (بالساعات) الذي يتم فيه الاحتفاظ بكل نسخة احتياطية الباحث

القيود:
قيمة الحد الأدنى = 0
النسخ الاحتياطيالتخزينالتكرار تعداد للإشارة إلى نوع موقع النسخ الاحتياطي "الموقع الجغرافي"
"محلي"
"المنطقة"

استعادة المعلمات

اسم وصف قيمة
قواعد البياناتToRestore قائمة قواعد بيانات محددة متاحة للاستعادة. DatabaseRestoreResource[]
gremlinDatabasesToRestore قائمة قواعد بيانات gremlin محددة متاحة للاستعادة. GremlinDatabaseRestoreResource[]
restoreMode يصف وضع الاستعادة. "PointInTime"
استعادة المصدر معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} خيط
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). خيط
restoreWithTtlDisabled يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. قيمة منطقية
المصدرالنسخ الاحتياطي الموقع موقع النسخ الاحتياطي المصدر للاستعادة. خيط
جداول للاستعادة قائمة جداول محددة متوفرة للاستعادة. سلسلة[]

VirtualNetworkRule

اسم وصف قيمة
معرف معرف المورد لشبكة فرعية، على سبيل المثال: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. خيط
ignore MissingVNetServiceEndpoint إنشاء قاعدة جدار الحماية قبل تمكين نقطة نهاية خدمة vnet للشبكة الظاهرية. قيمة منطقية

أمثلة الاستخدام

قوالب Azure Quickstart

قوالب Azure Quickstart التالية توزيع نوع المورد هذا.

قالب وصف
حساب Azure Cosmos DB SQL API مع مخزن تحليلي

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة تطبيقات Core (SQL) مع قاعدة بيانات وحاوية تم تكوينها باستخدام مخزن تحليلي.
حساب Azure Cosmos DB باستخدام تطبيق الويب

نشر في Azure
ينشر هذا القالب حساب Azure Cosmos DB، وخطة خدمة التطبيقات، وينشئ تطبيق ويب في خطة خدمة التطبيقات. كما يضيف اثنين من إعدادات التطبيق إلى تطبيق الويب الذي يشير إلى نقطة نهاية حساب Azure Cosmos DB. بهذه الطريقة، يمكن للحلول المنشورة على تطبيق الويب الاتصال بنقطة نهاية حساب Azure Cosmos DB باستخدام هذه الإعدادات.
CI/CD باستخدام Jenkins على خدمة حاويات Azure (AKS)

نشر في Azure
تجعل الحاويات من السهل عليك إنشاء تطبيقاتك ونشرها باستمرار. من خلال تنسيق توزيع هذه الحاويات باستخدام Kubernetes في Azure Container Service، يمكنك تحقيق مجموعات قابلة للنسخ المتماثلة يمكن إدارتها من الحاويات. من خلال إعداد بناء مستمر لإنتاج صور الحاوية وتنسيقها، يمكنك زيادة سرعة وموثوقية النشر الخاص بك.
إنشاء حساب Cosmos DB مع تمكين Microsoft Defender

نشر في Azure
باستخدام قالب ARM هذا، يمكنك نشر حساب Azure Cosmos DB مع تمكين Microsoft Defender ل Azure Cosmos DB. Microsoft Defender ل Azure Cosmos DB هو طبقة أمان أصلية من Azure تكتشف محاولات استغلال قواعد البيانات في حسابات Azure Cosmos DB الخاصة بك. يكتشف Microsoft Defender ل Azure Cosmos DB حقن SQL المحتملة، والممثلين السيئين المعروفين استنادا إلى التحليل الذكي للمخاطر من Microsoft، وأنماط الوصول المشبوهة، والاستغلال المحتمل لقاعدة البيانات الخاصة بك من خلال الهويات المخترقة أو المطلعين الضارين.
إنشاء حساب Azure Cosmos DB مجاني

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB مجانيا لواجهة برمجة تطبيقات SQL مع قاعدة بيانات ذات معدل نقل وحاوية مشتركين.
إنشاء الحد الأدنى من حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL)

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL) مع تحديد الحد الأدنى من خصائص المورد المطلوبة فقط.
إنشاء حساب Azure Cosmos DB بلا خادم لواجهة برمجة تطبيقات SQL

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB بلا خادم لواجهة برمجة تطبيقات Core (SQL).
إنشاء حساب Azure Cosmos بدون لمس وAzure Web App

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos، ويدخل نقطة نهاية Cosmos DB والمفاتيح في إعدادات Azure Web App، ثم ينشر تطبيق ويب ASP MVC من GitHub.
إنشاء حساب Azure Cosmos لواجهة برمجة تطبيقات MongoDB

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB ل MongoDB API 4.2 في منطقتين باستخدام معدل النقل المشترك والمخصص مع مجموعتين.
إنشاء حساب Azure Cosmos ل MongoDB API autoscale

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB ل MongoDB API 4.2 في منطقتين باستخدام كل من معدل النقل التحجيم التلقائي المشترك والمخصص.
إنشاء حساب Azure Cosmos Table API

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات الجدول في منطقتين وجدول واحد مع معدل النقل المقدم.
إنشاء حساب Azure Cosmos ل Table API باستخدام التحجيم التلقائي

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB ل Table API في منطقتين وجدول واحد مع معدل نقل مقياس تلقائي.
إنشاء حساب Azure Cosmos DB لواجهة برمجة تطبيقات Cassandra

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Cassandra في منطقتين مع مساحة مفتاح وجدول مع معدل نقل مخصص.
إنشاء حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL)

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة تطبيقات Core (SQL) مع قاعدة بيانات وحاوية ذات معدل نقل مع خيارات أخرى متعددة.
إنشاء حساب Azure Cosmos DB لواجهة برمجة تطبيقات Gremlin

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Gremlin في منطقتين مع قاعدة بيانات واحدة ورسم بياني واحد باستخدام معدل النقل المخصص.
إنشاء حساب Azure Cosmos DB ل Gremlin API autoscale

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Gremlin في منطقتين مع قاعدة بيانات واحدة ورسم بياني واحد باستخدام معدل النقل التلقائي.
إنشاء حساب Azure Cosmos DB في مناطق متعددة

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لأي نوع واجهة برمجة تطبيقات قاعدة بيانات مع منطقة أساسية وثانوية مع اختيار مستوى التناسق ونوع تجاوز الفشل.
إنشاء حساب Azure Cosmos DB SQL API باستخدام التحجيم التلقائي

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة تطبيقات Core (SQL) مع قاعدة بيانات وحاوية مع معدل نقل مقياس تلقائي مع خيارات أخرى متعددة.
إنشاء حساب Azure Cosmos DB بنقطة نهاية خاصة

نشر في Azure
سيقوم هذا القالب بإنشاء حساب Cosmos وشبكة ظاهرية ونقطة نهاية خاصة تعرض حساب Cosmos للشبكة الظاهرية.
إنشاء حساب Azure Cosmos DB SQL مع مستوى البيانات RBAC

نشر في Azure
سيقوم هذا القالب بإنشاء حساب SQL Cosmos، وتعريف دور تم الاحتفاظ به محليا، وتعيين دور تم الاحتفاظ به أصلا لهوية AAD.
إنشاء حساب Azure CosmosDB

نشر في Azure
الهدف من قالب ARM هذا هو إنشاء حساب CosmosDB بسرعة مع الحد الأدنى من القيم المطلوبة
إنشاء حساب Azure Cosmos DB للتحجيم التلقائي لواجهة برمجة تطبيقات Cassandra

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Cassandra في منطقتين مع مساحة مفتاح وجدول مع معدل نقل مقياس تلقائي.
إنشاء الإجراءات المخزنة لواجهة برمجة تطبيقات Azure Cosmos DB Core (SQL)

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة تطبيقات Core (SQL) وحاوية مع إجراء مخزن ومشغل ووظيفة معرفة من قبل المستخدم.
إنشاء Azure Cosmos باستخدام واجهة برمجة تطبيقات SQL وحاويات متعددة

نشر في Azure
ينشئ القالب حاوية Cosmos باستخدام واجهة برمجة تطبيقات SQL ويسمح بإضافة حاويات متعددة.
إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية

نشر في Azure
إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية.
إنشاء تطبيق Dapr pub-sub servicebus باستخدام تطبيقات الحاوية

نشر في Azure
إنشاء تطبيق Dapr pub-sub servicebus باستخدام Container Apps.
نشر Azure Data Explorer DB مع اتصال Cosmos DB

نشر في Azure
نشر Azure Data Explorer DB مع اتصال Cosmos DB.
Web App مع قاعدة بيانات SQL وAzure Cosmos DB وAzure Search

نشر في Azure
يقوم هذا القالب بتوفير تطبيق ويب وقاعدة بيانات SQL وAzure Cosmos DB وAzure Search وApplication Insights.

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد databaseAccounts مع العمليات التي تستهدف:

  • مجموعات الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.DocumentDB/databaseAccounts، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2025-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      analyticalStorageConfiguration = {
        schemaType = "string"
      }
      apiProperties = {
        serverVersion = "string"
      }
      backupPolicy = {
        migrationState = {
          startTime = "string"
          status = "string"
          targetType = "string"
        }
        type = "string"
        // For remaining properties, see BackupPolicy objects
      }
      capabilities = [
        {
          name = "string"
        }
      ]
      capacity = {
        totalThroughputLimit = int
      }
      capacityMode = "string"
      connectorOffer = "string"
      consistencyPolicy = {
        defaultConsistencyLevel = "string"
        maxIntervalInSeconds = int
        maxStalenessPrefix = int
      }
      cors = [
        {
          allowedHeaders = "string"
          allowedMethods = "string"
          allowedOrigins = "string"
          exposedHeaders = "string"
          maxAgeInSeconds = int
        }
      ]
      createMode = "string"
      customerManagedKeyStatus = "string"
      databaseAccountOfferType = "Standard"
      defaultIdentity = "string"
      defaultPriorityLevel = "string"
      diagnosticLogSettings = {
        enableFullTextQuery = "string"
      }
      disableKeyBasedMetadataWriteAccess = bool
      disableLocalAuth = bool
      enableAllVersionsAndDeletesChangeFeed = bool
      enableAnalyticalStorage = bool
      enableAutomaticFailover = bool
      enableBurstCapacity = bool
      enableCassandraConnector = bool
      enableFreeTier = bool
      enableMaterializedViews = bool
      enableMultipleWriteLocations = bool
      enablePartitionMerge = bool
      enablePerRegionPerPartitionAutoscale = bool
      enablePriorityBasedExecution = bool
      ipRules = [
        {
          ipAddressOrRange = "string"
        }
      ]
      isVirtualNetworkFilterEnabled = bool
      keyVaultKeyUri = "string"
      locations = [
        {
          failoverPriority = int
          isZoneRedundant = bool
          locationName = "string"
        }
      ]
      minimalTlsVersion = "string"
      networkAclBypass = "string"
      networkAclBypassResourceIds = [
        "string"
      ]
      publicNetworkAccess = "string"
      restoreParameters = {
        databasesToRestore = [
          {
            collectionNames = [
              "string"
            ]
            databaseName = "string"
          }
        ]
        gremlinDatabasesToRestore = [
          {
            databaseName = "string"
            graphNames = [
              "string"
            ]
          }
        ]
        restoreMode = "string"
        restoreSource = "string"
        restoreTimestampInUtc = "string"
        restoreWithTtlDisabled = bool
        sourceBackupLocation = "string"
        tablesToRestore = [
          "string"
        ]
      }
      virtualNetworkRules = [
        {
          id = "string"
          ignoreMissingVNetServiceEndpoint = bool
        }
      ]
    }
  }
}

عناصر نهج النسخ الاحتياطي

تعيين نوع الخاصية لتحديد نوع الكائن.

للحصول علىالمستمر ، استخدم:

{
  continuousModeProperties = {
    tier = "string"
  }
  type = "Continuous"
}

بالنسبةالدوري ، استخدم:

{
  periodicModeProperties = {
    backupIntervalInMinutes = int
    backupRetentionIntervalInHours = int
    backupStorageRedundancy = "string"
  }
  type = "Periodic"
}

قيم الخصائص

Microsoft.DocumentDB/databaseAccounts

اسم وصف قيمة
الهوية هوية المورد. ManagedServiceIdentity
نوع يشير إلى نوع حساب قاعدة البيانات. يمكن تعيين هذا فقط عند إنشاء حساب قاعدة البيانات. "GlobalDocumentDB"
"MongoDB"
"تحليل"
مكان موقع مجموعة الموارد التي ينتمي إليها المورد. خيط
اسم اسم المورد خيط

القيود:
الحد الأدنى للطول = 3
الحد الأقصى للطول = 50
النمط = ^[a-z0-9]+(-[a-z0-9]+)* (مطلوب)
خصائص خصائص لإنشاء حسابات قاعدة بيانات Azure Cosmos DB وتحديثها. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم.
نوع نوع المورد "Microsoft.DocumentDB/databaseAccounts@2025-11-01-preview"

تكوين التخزين التحليلي

اسم وصف قيمة
نوع المخطط يصف أنواع المخطط للتخزين التحليلي. "كامل الكفاءة"
'معرف جيدا'

خصائص واجهة برمجة التطبيقات

اسم وصف قيمة
إصدار الخادم يصف إصدار حساب MongoDB. '3.2'
'3.6'
'4.0'
'4.2'
'5.0'
'6.0'
'7.0'

ARMResourcePropertiesTags

اسم وصف قيمة

نهج النسخ الاحتياطي

اسم وصف قيمة
حالة الترحيل الكائن الذي يمثل حالة الترحيل بين نهج النسخ الاحتياطي. BackupPolicyMigrationState
نوع تعيين إلى "مستمر" للنوع ContinuousModeBackupPolicy. قم بتعيين إلى "دوري" للنوع PeriodicModeBackupPolicy. "مستمر"
'دوري' (مطلوب)

BackupPolicyMigrationState

اسم وصف قيمة
وقت البدء الوقت الذي بدأ فيه ترحيل نهج النسخ الاحتياطي (تنسيق ISO-8601). خيط
حالة يصف حالة الترحيل بين أنواع نهج النسخ الاحتياطي. "مكتمل"
"فشل"
"InProgress"
"غير صالح"
نوع الهدف يصف نوع نهج النسخ الاحتياطي الهدف لترحيل نهج النسخ الاحتياطي. "مستمر"
"دوري"

تمكن

اسم وصف قيمة
اسم اسم قدرة Cosmos DB. على سبيل المثال، "الاسم": "EnableCassandra". تتضمن القيم الحالية أيضا "EnableTable" و"EnableGremlin". خيط

سعة

اسم وصف قيمة
إجمالي معدل الإنتاجية الحد الإجمالي لمعدل النقل المفروض على الحساب. يفرض TotalThroughputLimit من 2000 حدا صارما لمعدل النقل الأقصى الذي يمكن توفيره على هذا الحساب ليكون 2000. يشير إجمالي معدل النقل من -1 إلى عدم وجود حدود لتوفير معدل النقل. الباحث

القيود:
قيمة الحد الأدنى = -1

نهج التناسق

اسم وصف قيمة
مستوى التوافق الافتراضي مستوى التناسق الافتراضي وإعدادات التكوين لحساب Cosmos DB. "BoundedStaleness"
"بادئة متسقة"
"في نهاية المطاف"
"جلسة عمل"
'قوي' (مطلوب)
maxIntervalInSeconds عند استخدامها مع مستوى تناسق Bounded Staleness، تمثل هذه القيمة مقدار الوقت المسموح به للثبات (بالثوان). النطاق المقبول لهذه القيمة هو 5 - 86400. مطلوب عند تعيين defaultConsistencyPolicy إلى "BoundedStaleness". الباحث

القيود:
الحد الأدنى للقيمة = 5
القيمة القصوى = 86400
maxStalenessبادئة عند استخدامها مع مستوى تناسق Bounded Staleness، تمثل هذه القيمة عدد الطلبات القديمة المسموح بها. النطاق المقبول لهذه القيمة هو 1 – 2,147,483,647. مطلوب عند تعيين defaultConsistencyPolicy إلى "BoundedStaleness". الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 2147483647

نهج النسخ الاحتياطي المستمر

اسم وصف قيمة
خصائص التعديل المستمر قيم التكوين للنسخ الاحتياطي لوضع مستمر ContinuousModeProperties
نوع يصف وضع النسخ الاحتياطية. "مستمر" (مطلوب)

خصائص التعديل المستمر

اسم وصف قيمة
المستوي تعداد للإشارة إلى نوع وضع النسخ الاحتياطي Continuos "30 يوما مستمرا"
"مستمر 7 أيام"

نهج Cors

اسم وصف قيمة
عناوين العناوين المسموح بها عناوين الطلب التي قد يحددها مجال الأصل على طلب CORS. خيط
طرق التتبع المسموح بها الأساليب (أفعال طلب HTTP) التي قد يستخدمها مجال الأصل لطلب CORS. خيط
التواريخ الأصلية المسموح بها مجالات الأصل المسموح لها بإجراء طلب مقابل الخدمة عبر CORS. سلسلة (مطلوب)
عناوين مكشوفة عناوين الاستجابة التي قد يتم إرسالها في الاستجابة لطلب CORS وعرضها بواسطة المستعرض لمصدر الطلب. خيط
maxAgeInSeconds الحد الأقصى لمقدار الوقت الذي يجب أن يقوم المستعرض بلتخزين المؤقت لطلب خيارات الاختبار المبدئي. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 2147483647

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties

اسم وصف قيمة
تكوين التخزين التحليلي خصائص محددة للتخزين التحليلي. تكوين التخزين التحليلي
خصائص واجهة برمجة التطبيقات خصائص محددة لواجهة برمجة التطبيقات. حاليا، مدعوم فقط لواجهة برمجة تطبيقات MongoDB. ApiProperties
نهج النسخ الاحتياطي الكائن الذي يمثل نهج أخذ النسخ الاحتياطية على حساب. نهج النسخ الاحتياطي
قدرات قائمة قدرات Cosmos DB للحساب القدرة []
سعة الكائن الذي يمثل جميع الخصائص المتعلقة بتطبيق السعة على حساب. السعة
وضع السعة يشير إلى capacityMode لحساب Cosmos DB. "بلا"
"تم التوفير"
"بلا خادم"
الموصلOffer نوع عرض موصل cassandra لحساب قاعدة بيانات Cosmos DB C*. "صغير"
نهج التناسق نهج التناسق لحساب Cosmos DB. نهج التناسق
CORS نهج CORS لحساب قاعدة بيانات Cosmos DB. CorsPolicy []
createMode تعداد للإشارة إلى وضع إنشاء الحساب. "افتراضي"
"استعادة"
customerManagedKeyStatus يشير إلى حالة ميزة المفتاح المدار للعميل على الحساب. في حالة وجود أخطاء، توفر الخاصية إرشادات استكشاف الأخطاء وإصلاحها. خيط
نوع حساب قاعدة البيانات نوع العرض لحساب قاعدة بيانات Cosmos DB. 'قياسي' (مطلوب)
معرف افتراضي الهوية الافتراضية للوصول إلى خزنة المفاتيح المستخدمة في ميزات مثل المفاتيح المدارة من قبل العميل. يجب تعيين الهوية الافتراضية بشكل صريح من قبل المستخدمين. يمكن أن يكون "FirstPartyIdentity" و"SystemAssignedIdentity" والمزيد. خيط
مستوى الدقة الافتراضية تعداد للإشارة إلى مستوى الأولوية الافتراضي لطلب التنفيذ المستند إلى الأولوية. "مرتفع"
"منخفض"
diagnosticLogSettings الكائن الذي يمثل إعدادات سجل التشخيص المختلفة لحساب Cosmos DB. DiagnosticLogSettings
disableKeyBasedMetadataWriteAccess تعطيل عمليات الكتابة على موارد بيانات التعريف (قواعد البيانات والحاويات ومعدل النقل) عبر مفاتيح الحساب قيمة منطقية
تعطيلLocalAuth إلغاء الاشتراك في المصادقة المحلية والتأكد من أن MSI وAD فقط يمكن استخدامهما حصريا للمصادقة. قيمة منطقية
enableAllVersionsAndDeletesChangeFeed وضع علامة للإشارة إلى ما إذا كانت ميزة تغيير جميع الإصدارات والحذف ممكنة على الحساب قيمة منطقية
تمكينAnalyticalStorage ضع علامة للإشارة إلى ما إذا كان يجب تمكين تحليلات التخزين. قيمة منطقية
enableAutomaticFailover تمكين تجاوز الفشل التلقائي لمنطقة الكتابة في الحدث النادر الذي لا تتوفر فيه المنطقة بسبب انقطاع التيار الكهربائي. سيؤدي تجاوز الفشل التلقائي إلى منطقة كتابة جديدة للحساب ويتم اختياره استنادا إلى أولويات تجاوز الفشل التي تم تكوينها للحساب. قيمة منطقية
تمكين القدرة على العمل وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة سعة الاندفاع على الحساب قيمة منطقية
تمكين CassandraConnector تمكين موصل cassandra على حساب Cosmos DB C* قيمة منطقية
تمكينFreeTier ضع علامة للإشارة إلى ما إذا كان المستوى المجاني ممكنا أم لا. قيمة منطقية
enableMaterializedViews وضع علامة للإشارة إلى ما إذا كان يجب تمكين MaterializedViews على حساب Cosmos DB قيمة منطقية
تمكين MultipleWriteLocations تمكين الحساب من الكتابة في مواقع متعددة قيمة منطقية
تمكينPartitionMerge وضع علامة للإشارة إلى تمكين/تعطيل ميزة دمج الأقسام على الحساب قيمة منطقية
enablePerRegionPerPartitionAutoscale وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة التحجيم التلقائي لكل قسم Per-Region على الحساب قيمة منطقية
تمكينPriorityBasedExecution وضع علامة للإشارة إلى تمكين/تعطيل ميزة معاينة التنفيذ المستندة إلى الأولوية على الحساب قيمة منطقية
قواعد ip قائمة IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled ضع علامة للإشارة إلى ما إذا كان يجب تمكين/تعطيل قواعد ACL للشبكة الظاهرية. قيمة منطقية
keyVaultKeyUri عنوان URI لمخزن المفاتيح خيط
مواقع صفيف يحتوي على مواقع التبسيط الجغرافي الممكنة لحساب Cosmos DB. الموقع [] (مطلوب)
الحد الأدنى لTlsVersion يشير إلى الحد الأدنى المسموح به لإصدار Tls. الإعداد الافتراضي هو Tls 1.0، باستثناء Cassandra وMongo API، والتي تعمل فقط مع Tls 1.2. "TLS"
"TLS11"
"TLS12"
شبكةAclBypass يشير إلى الخدمات المسموح لها بتجاوز عمليات التحقق من جدار الحماية. "AzureServices"
"بلا"
networkAclBypassResourceIds صفيف يحتوي على معرفات الموارد لتجاوز Network Acl لحساب Cosmos DB. سلسلة[]
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
"SecuredByPerimeter"
استعادة المقاييس معلمات للإشارة إلى معلومات حول الاستعادة. RestoreParameters
قواعد الشبكة الظاهرية قائمة قواعد ACL للشبكة الظاهرية التي تم تكوينها لحساب Cosmos DB. VirtualNetworkRule []

DatabaseRestoreResource

اسم وصف قيمة
أسماء المجموعات أسماء المجموعات المتوفرة للاستعادة. سلسلة[]
اسم قاعدة البيانات اسم قاعدة البيانات المتوفرة للاستعادة. خيط

DiagnosticLogSettings

اسم وصف قيمة
enableFullTextQuery وصف مستوى التفاصيل التي سيتم تسجيل الاستعلامات بها. "خطأ"
"بلا"
"صحيح"

GremlinDatabaseRestoreResource

اسم وصف قيمة
اسم قاعدة البيانات اسم قاعدة بيانات gremlin المتوفرة للاستعادة. خيط
أسماء الرسم البياني أسماء الرسوم البيانية المتوفرة للاستعادة. سلسلة[]

IpAddressOrRange

اسم وصف قيمة
ipAddressOrRange عنوان IPv4 واحد أو نطاق عناوين IPv4 واحد بتنسيق CIDR. يجب أن تكون عناوين IP المتوفرة منسقة بشكل جيد ولا يمكن تضمينها في أحد النطاقات التالية: 10.0.0.0/8، 100.64.0.0/10، 172.16.0.0/12، 192.168.0.0/16، حيث لا يمكن فرضها بواسطة عامل تصفية عنوان IP. مثال على الإدخالات الصالحة: "23.40.210.245" أو "23.40.210.0/8". خيط

مكان

اسم وصف قيمة
ميزة تجاوز الفشل أولوية تجاوز الفشل للمنطقة. تشير أولوية تجاوز الفشل 0 إلى منطقة كتابة. الحد الأقصى لقيمة أولوية تجاوز الفشل = (العدد الإجمالي للمناطق - 1). يجب أن تكون قيم أولوية تجاوز الفشل فريدة لكل منطقة من المناطق التي يوجد فيها حساب قاعدة البيانات. الباحث

القيود:
قيمة الحد الأدنى = 0
isZoneRedundant وضع علامة للإشارة إلى ما إذا كانت هذه المنطقة منطقة AvailabilityZone أم لا قيمة منطقية
اسم الموقع اسم المنطقة. خيط

معرف الخدمة المدارة

اسم وصف قيمة
نوع نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"تعيين المستخدم"
معرفات تعيين المستخدم قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

نهج النسخ الاحتياطي الدوري

اسم وصف قيمة
خصائص التعديل الدورية قيم التكوين للنسخ الاحتياطي لوضع دوري PeriodicModeProperties
نوع يصف وضع النسخ الاحتياطية. 'دوري' (مطلوب)

خصائص الوحدات الدورية

اسم وصف قيمة
تنبيهات IntervalInMinutes للنسخ الاحتياطي عدد صحيح يمثل الفاصل الزمني بالدقائق بين نسختين احتياطيتين الباحث

القيود:
قيمة الحد الأدنى = 0
BackupRetentionIntervalInHours عدد صحيح يمثل الوقت (بالساعات) الذي يتم فيه الاحتفاظ بكل نسخة احتياطية الباحث

القيود:
قيمة الحد الأدنى = 0
النسخ الاحتياطيالتخزينالتكرار تعداد للإشارة إلى نوع موقع النسخ الاحتياطي "الموقع الجغرافي"
"محلي"
"المنطقة"

استعادة المعلمات

اسم وصف قيمة
قواعد البياناتToRestore قائمة قواعد بيانات محددة متاحة للاستعادة. DatabaseRestoreResource[]
gremlinDatabasesToRestore قائمة قواعد بيانات gremlin محددة متاحة للاستعادة. GremlinDatabaseRestoreResource[]
restoreMode يصف وضع الاستعادة. "PointInTime"
استعادة المصدر معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} خيط
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). خيط
restoreWithTtlDisabled يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. قيمة منطقية
المصدرالنسخ الاحتياطي الموقع موقع النسخ الاحتياطي المصدر للاستعادة. خيط
جداول للاستعادة قائمة جداول محددة متوفرة للاستعادة. سلسلة[]

VirtualNetworkRule

اسم وصف قيمة
معرف معرف المورد لشبكة فرعية، على سبيل المثال: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. خيط
ignore MissingVNetServiceEndpoint إنشاء قاعدة جدار الحماية قبل تمكين نقطة نهاية خدمة vnet للشبكة الظاهرية. قيمة منطقية

أمثلة الاستخدام

عينات Terraform

مثال أساسي لنشر حساب CosmosDB (رسميا DocumentDB).

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    = ["*"]
}