Microsoft.DocumentDB databaseAccounts 2021-10-15

تعريف مورد Bicep

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2021-10-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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
    }
    connectorOffer: 'Small'
    consistencyPolicy: {
      defaultConsistencyLevel: 'string'
      maxIntervalInSeconds: int
      maxStalenessPrefix: int
    }
    cors: [
      {
        allowedHeaders: 'string'
        allowedMethods: 'string'
        allowedOrigins: 'string'
        exposedHeaders: 'string'
        maxAgeInSeconds: int
      }
    ]
    createMode: 'string'
    databaseAccountOfferType: 'Standard'
    defaultIdentity: 'string'
    disableKeyBasedMetadataWriteAccess: bool
    disableLocalAuth: bool
    enableAnalyticalStorage: bool
    enableAutomaticFailover: bool
    enableCassandraConnector: bool
    enableFreeTier: bool
    enableMultipleWriteLocations: bool
    ipRules: [
      {
        ipAddressOrRange: 'string'
      }
    ]
    isVirtualNetworkFilterEnabled: bool
    keyVaultKeyUri: 'string'
    locations: [
      {
        failoverPriority: int
        isZoneRedundant: bool
        locationName: 'string'
      }
    ]
    networkAclBypass: 'string'
    networkAclBypassResourceIds: [
      'string'
    ]
    publicNetworkAccess: 'string'
    restoreParameters: {
      databasesToRestore: [
        {
          collectionNames: [
            'string'
          ]
          databaseName: 'string'
        }
      ]
      restoreMode: 'PointInTime'
      restoreSource: 'string'
      restoreTimestampInUtc: 'string'
    }
    virtualNetworkRules: [
      {
        id: 'string'
        ignoreMissingVNetServiceEndpoint: bool
      }
    ]
  }
}

عناصر BackupPolicy

قم بتعيين خاصية النوع لتحديد نوع العنصر.

للتواصل، استخدم:

  type: 'Continuous'

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

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

قيم Property

حسابات قاعدة البيانات

الاسم الوصف القيمة
الاسم اسم المورد سلسلة (مطلوبة)

حد الحرف: 3-44

الأحرف الصالحة:
الأحرف صغيرة والأرقام والواصلات.

ابدأ بحرف صغير أو رقم.

يجب أن يكون اسم المورد فريدا عبر Azure.
الموقع موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة
العلامات العلامات هي قائمة بأزواج قيم المفاتيح التي تصف المورد. يمكن استخدام هذه العلامات في عرض هذا المورد وتجميعه (عبر مجموعات الموارد). يمكن توفير 15 علامة كحد أقصى لمورد. يجب أن تحتوي كل علامة على مفتاح لا يزيد عن 128 حرفا وقيمة لا تزيد عن 256 حرفا. على سبيل المثال، يتم تعيين التجربة الافتراضية لنوع القالب باستخدام "defaultExperience": "Cassandra". تتضمن قيم "defaultExperience" الحالية أيضا "Table" و"Graph" و"DocumentDB" و"MongoDB". قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع يشير إلى نوع حساب قاعدة البيانات. يمكن تعيين هذا فقط عند إنشاء حساب قاعدة البيانات. "GlobalDocumentDB"
'MongoDB'
"تحليل"
الهوية هوية المورد. ManagedServiceIdentity
خصائص خصائص لإنشاء حسابات قاعدة بيانات Azure Cosmos DB وتحديثها. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (مطلوب)

ManagedServiceIdentity

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

ManagedServiceIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

الاسم الوصف القيمة
تكوين التخزين التحليلي خصائص محددة للتخزين التحليلي. تكوين التخزين التحليلي
apiProperties خصائص محددة لواجهة برمجة التطبيقات. حاليا، مدعوم فقط لواجهة برمجة تطبيقات MongoDB. ApiProperties
نهج النسخ الاحتياطي الكائن الذي يمثل نهج أخذ النسخ الاحتياطية على حساب. BackupPolicy
الإمكانات قائمة قدرات Cosmos DB للحساب القدرة[]
السعة الكائن الذي يمثل جميع الخصائص المتعلقة بتطبيق السعة على حساب. السعة
الموصلOffer نوع عرض موصل cassandra لحساب قاعدة بيانات Cosmos DB C* . "صغير"
نهج التناسق نهج التناسق لحساب Cosmos DB. نهج التناسق
CORS نهج CORS لحساب قاعدة بيانات Cosmos DB. CorsPolicy[]
createMode تعداد للإشارة إلى وضع إنشاء الحساب. "افتراضي"
"استعادة"
databaseAccountOfferType نوع العرض لقاعدة البيانات 'قياسي' (مطلوب)
defaultIdentity الهوية الافتراضية للوصول إلى مخزن المفاتيح المستخدم في ميزات مثل المفاتيح المدارة من قبل العميل. يجب تعيين الهوية الافتراضية بشكل صريح من قبل المستخدمين. يمكن أن يكون "FirstPartyIdentity" و"SystemAssignedIdentity" والمزيد. سلسلة
disableKeyBasedMetadataWriteAccess تعطيل عمليات الكتابة على موارد بيانات التعريف (قواعد البيانات والحاويات ومعدل النقل) عبر مفاتيح الحساب Bool
disableLocalAuth إلغاء الاشتراك في المصادقة المحلية والتأكد من أن MSI وAD فقط يمكن استخدامهما حصريا للمصادقة. Bool
تمكينAnalyticalStorage ضع علامة للإشارة إلى ما إذا كان يجب تمكين تحليلات التخزين. Bool
enableAutomaticFailover تمكين تجاوز الفشل التلقائي لمنطقة الكتابة في الحدث النادر الذي لا تتوفر فيه المنطقة بسبب انقطاع التيار الكهربائي. سيؤدي تجاوز الفشل التلقائي إلى منطقة كتابة جديدة للحساب ويتم اختيارها استنادا إلى أولويات تجاوز الفشل التي تم تكوينها للحساب. Bool
enableCassandraConnector تمكين موصل cassandra على حساب Cosmos DB C* Bool
enableFreeTier ضع علامة للإشارة إلى ما إذا كان المستوى المجاني ممكنا أم لا. Bool
enableMultipleWriteLocations تمكين الحساب من الكتابة في مواقع متعددة Bool
ipRules قائمة IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled ضع علامة للإشارة إلى ما إذا كان يجب تمكين/تعطيل قواعد ACL للشبكة الظاهرية. Bool
keyVaultKeyUri عنوان URI لمخزن المفاتيح سلسلة
المواقع صفيف يحتوي على مواقع التبسيط الجغرافي الممكنة لحساب Cosmos DB. الموقع[] (مطلوب)
networkAclBypass "AzureServices"
'بلا': يشير إلى الخدمات المسموح لها بتجاوز عمليات التحقق من جدار الحماية.
networkAclBypassResourceIds صفيف يحتوي على معرفات الموارد لتجاوز Network Acl لحساب Cosmos DB. سلسلة []
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة. RestoreParameters
virtualNetworkRules قائمة قواعد ACL للشبكة الظاهرية التي تم تكوينها لحساب Cosmos DB. VirtualNetworkRule[]

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

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

ApiProperties

الاسم الوصف القيمة
serverVersion يصف ServerVersion لحساب MongoDB. '3.2'
'3.6'
'4.0'
'4.2'

BackupPolicy

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

BackupPolicyMigrationState

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

ContinuousModeBackupPolicy

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

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

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

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

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

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

القيود:
الحد الأدنى للقيمة = 0
backupStorageRedundancy تعداد للإشارة إلى نوع موقع النسخ الاحتياطي 'Geo'
"محلي"
"المنطقة"

الإمكانية

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

السعة

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

نهج التناسق

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

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

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

نهج Cors

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

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

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". سلسلة

‏‏الموقع

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

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

RestoreParameters

الاسم الوصف القيمة
databasesToRestore قائمة قواعد بيانات محددة متاحة للاستعادة. DatabaseRestoreResource[]
restoreMode يصف وضع الاستعادة. 'PointInTime'
restoreMode معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} سلسلة
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). سلسلة

DatabaseRestoreResource

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

VirtualNetworkRule

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

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب الوصف
CI/CD باستخدام Jenkins على Azure Container Service (AKS)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

نشر في Azure
سيقوم هذا القالب بإنشاء حساب SQL Cosmos، وتعريف الدور الذي يتم الحفاظ عليه أصلاً، وتعيين الدور الأصلي لهوية Microsoft Azure Active Directory.
إنشاء حساب Azure Cosmos DB بلا خادم لواجهة برمجة تطبيقات SQL

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

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

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

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos، ويدخل نقطة نهاية Cosmos DB والمفاتيح في إعدادات Azure Web App، ثم ينشر تطبيق ويب ASP MVC من GitHub.
إنشاء حساب 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، وأنماط الوصول المشبوهة، والاستغلالات المحتملة لقاعدة البيانات الخاصة بك من خلال الهويات المخترقة أو المشاركين في برنامج Insider الضار.
توزيع Azure Data Explorer DB مع اتصال Cosmos DB

نشر في Azure
توزيع Azure Data Explorer DB مع اتصال Cosmos DB.
حساب Azure Cosmos DB مع تطبيق الويب

نشر في Azure
ينشر هذا القالب حساب Azure Cosmos DB، وخطة خدمة التطبيقات، وينشئ تطبيق ويب في خطة خدمة التطبيقات. كما يضيف إعدادين للتطبيق إلى تطبيق الويب الذي يشير إلى نقطة نهاية حساب Azure Cosmos DB. بهذه الطريقة يمكن للحلول المنشورة في Web App الاتصال بنقطة نهاية حساب Azure Cosmos DB باستخدام هذه الإعدادات.

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2021-10-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "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"
    },
    "connectorOffer": "Small",
    "consistencyPolicy": {
      "defaultConsistencyLevel": "string",
      "maxIntervalInSeconds": "int",
      "maxStalenessPrefix": "int"
    },
    "cors": [
      {
        "allowedHeaders": "string",
        "allowedMethods": "string",
        "allowedOrigins": "string",
        "exposedHeaders": "string",
        "maxAgeInSeconds": "int"
      }
    ],
    "createMode": "string",
    "databaseAccountOfferType": "Standard",
    "defaultIdentity": "string",
    "disableKeyBasedMetadataWriteAccess": "bool",
    "disableLocalAuth": "bool",
    "enableAnalyticalStorage": "bool",
    "enableAutomaticFailover": "bool",
    "enableCassandraConnector": "bool",
    "enableFreeTier": "bool",
    "enableMultipleWriteLocations": "bool",
    "ipRules": [
      {
        "ipAddressOrRange": "string"
      }
    ],
    "isVirtualNetworkFilterEnabled": "bool",
    "keyVaultKeyUri": "string",
    "locations": [
      {
        "failoverPriority": "int",
        "isZoneRedundant": "bool",
        "locationName": "string"
      }
    ],
    "networkAclBypass": "string",
    "networkAclBypassResourceIds": [ "string" ],
    "publicNetworkAccess": "string",
    "restoreParameters": {
      "databasesToRestore": [
        {
          "collectionNames": [ "string" ],
          "databaseName": "string"
        }
      ],
      "restoreMode": "PointInTime",
      "restoreSource": "string",
      "restoreTimestampInUtc": "string"
    },
    "virtualNetworkRules": [
      {
        "id": "string",
        "ignoreMissingVNetServiceEndpoint": "bool"
      }
    ]
  }
}

عناصر BackupPolicy

قم بتعيين خاصية النوع لتحديد نوع العنصر.

للتواصل، استخدم:

  "type": "Continuous"

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

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

قيم Property

حسابات قاعدة البيانات

الاسم الوصف القيمة
النوع نوع المورد 'Microsoft.DocumentDB/databaseAccounts'
apiVersion إصدار واجهة برمجة تطبيقات المورد '2021-10-15'
الاسم اسم المورد سلسلة (مطلوبة)

حد الحرف: 3-44

الأحرف الصالحة:
الأحرف صغيرة والأرقام والواصلات.

ابدأ بحرف صغير أو رقم.

يجب أن يكون اسم المورد فريدا عبر Azure.
الموقع موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة
العلامات العلامات هي قائمة بأزواج قيم المفاتيح التي تصف المورد. يمكن استخدام هذه العلامات في عرض هذا المورد وتجميعه (عبر مجموعات الموارد). يمكن توفير 15 علامة كحد أقصى لمورد. يجب أن تحتوي كل علامة على مفتاح لا يزيد عن 128 حرفا وقيمة لا تزيد عن 256 حرفا. على سبيل المثال، يتم تعيين التجربة الافتراضية لنوع القالب باستخدام "defaultExperience": "Cassandra". تتضمن قيم "defaultExperience" الحالية أيضا "Table" و"Graph" و"DocumentDB" و"MongoDB". قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع يشير إلى نوع حساب قاعدة البيانات. يمكن تعيين هذا فقط عند إنشاء حساب قاعدة البيانات. "GlobalDocumentDB"
'MongoDB'
"تحليل"
الهوية هوية المورد. ManagedServiceIdentity
خصائص خصائص لإنشاء حسابات قاعدة بيانات Azure Cosmos DB وتحديثها. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (مطلوب)

ManagedServiceIdentity

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

ManagedServiceIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

الاسم الوصف القيمة
تكوين التخزين التحليلي خصائص محددة للتخزين التحليلي. تكوين التخزين التحليلي
apiProperties خصائص محددة لواجهة برمجة التطبيقات. حاليا، مدعوم فقط لواجهة برمجة تطبيقات MongoDB. ApiProperties
نهج النسخ الاحتياطي الكائن الذي يمثل نهج أخذ النسخ الاحتياطية على حساب. BackupPolicy
الإمكانات قائمة بقدرات Cosmos DB للحساب القدرة[]
السعة الكائن الذي يمثل جميع الخصائص المتعلقة بإنفاذ السعة على حساب. السعة
الموصلOffer نوع عرض موصل cassandra لحساب قاعدة بيانات Cosmos DB C* . "صغير"
نهج التناسق نهج التناسق لحساب Cosmos DB. نهج التناسق
CORS نهج CORS لحساب قاعدة بيانات Cosmos DB. CorsPolicy[]
createMode تعداد للإشارة إلى وضع إنشاء الحساب. "افتراضي"
"استعادة"
databaseAccountOfferType نوع العرض لقاعدة البيانات 'قياسي' (مطلوب)
defaultIdentity الهوية الافتراضية للوصول إلى مخزن المفاتيح المستخدمة في ميزات مثل المفاتيح المدارة من قبل العميل. يجب تعيين الهوية الافتراضية بشكل صريح من قبل المستخدمين. يمكن أن يكون "FirstPartyIdentity" و"SystemAssignedIdentity" والمزيد. سلسلة
disableKeyBasedMetadataWriteAccess تعطيل عمليات الكتابة على موارد بيانات التعريف (قواعد البيانات والحاويات ومعدل النقل) عبر مفاتيح الحساب Bool
disableLocalAuth إلغاء الاشتراك في المصادقة المحلية والتأكد من أن MSI وAD فقط يمكن استخدامهما حصريا للمصادقة. Bool
تمكينAnalyticalStorage وضع علامة للإشارة إلى ما إذا كان يجب تمكين تحليلات التخزين. Bool
enableAutomaticFailover تمكين تجاوز الفشل التلقائي لمنطقة الكتابة في الحدث النادر الذي تكون فيه المنطقة غير متوفرة بسبب انقطاع التيار الكهربائي. سيؤدي تجاوز الفشل التلقائي إلى منطقة كتابة جديدة للحساب ويتم اختياره استنادا إلى أولويات تجاوز الفشل التي تم تكوينها للحساب. Bool
enableCassandraConnector تمكين موصل cassandra على حساب Cosmos DB C* Bool
تمكينFreeTier وضع علامة للإشارة إلى ما إذا كان المستوى المجاني ممكنا أم لا. Bool
enableMultipleWriteLocations تمكين الحساب من الكتابة في مواقع متعددة Bool
ipRules قائمة IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled ضع علامة للإشارة إلى ما إذا كان يجب تمكين/تعطيل قواعد قائمة التحكم في الوصول للشبكة الظاهرية. Bool
keyVaultKeyUri عنوان URI لمخزن المفاتيح سلسلة
المواقع صفيف يحتوي على مواقع النسخ الجغرافي الممكنة لحساب Cosmos DB. الموقع[] (مطلوب)
networkAclBypass "AzureServices"
'بلا': يشير إلى الخدمات المسموح لها بتجاوز عمليات التحقق من جدار الحماية.
networkAclBypassResourceIds صفيف يحتوي على معرفات الموارد لتجاوز Network Acl لحساب Cosmos DB. سلسلة []
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
مقاييس الاستعادة معلمات للإشارة إلى معلومات حول الاستعادة. RestoreParameters
VirtualNetworkRules قائمة قواعد قائمة التحكم بالوصول للشبكة الظاهرية المكونة لحساب Cosmos DB. VirtualNetworkRule[]

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

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

ApiProperties

الاسم الوصف القيمة
serverVersion يصف ServerVersion لحساب MongoDB. '3.2'
'3.6'
'4.0'
'4.2'

BackupPolicy

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

BackupPolicyMigrationState

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

ContinuousModeBackupPolicy

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

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

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

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

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

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

القيود:
الحد الأدنى للقيمة = 0
backupStorageRedundancy تعداد للإشارة إلى نوع موقع النسخ الاحتياطي 'Geo'
"محلي"
"المنطقة"

الإمكانية

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

السعة

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

نهج التناسق

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

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

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

CorsPolicy

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

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

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". سلسلة

‏‏الموقع

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

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

RestoreParameters

الاسم الوصف القيمة
databasesToRestore قائمة قواعد بيانات محددة متاحة للاستعادة. DatabaseRestoreResource[]
restoreMode يصف وضع الاستعادة. 'PointInTime'
restoreMode معرف حساب قاعدة البيانات القابل للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} سلسلة
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). سلسلة

DatabaseRestoreResource

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

VirtualNetworkRule

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

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب الوصف
CI/CD باستخدام Jenkins على Azure Container Service (AKS)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

نشر في Azure
سيقوم هذا القالب بإنشاء حساب SQL Cosmos، وتعريف الدور الذي يتم الحفاظ عليه أصلاً، وتعيين الدور الأصلي لهوية Microsoft Azure Active Directory.
إنشاء حساب Azure Cosmos DB بلا خادم لواجهة برمجة تطبيقات SQL

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

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

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

نشر في Azure
ينشئ هذا القالب حساب Azure Cosmos، ويدخل نقطة نهاية Cosmos DB والمفاتيح في إعدادات Azure Web App، ثم ينشر تطبيق ويب ASP MVC من GitHub.
إنشاء حساب 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، وأنماط الوصول المشبوهة، والاستغلال المحتمل لقاعدة البيانات الخاصة بك من خلال الهويات المخترقة أو المشاركين في برنامج Insider الضار.
توزيع Azure Data Explorer DB مع اتصال Cosmos DB

نشر في Azure
توزيع Azure Data Explorer DB مع اتصال Cosmos DB.
حساب Azure Cosmos DB مع تطبيق الويب

نشر في Azure
ينشر هذا القالب حساب Azure Cosmos DB، وخطة خدمة التطبيقات، وينشئ تطبيق ويب في خطة خدمة التطبيقات. كما يضيف إعدادين للتطبيق إلى تطبيق الويب الذي يشير إلى نقطة نهاية حساب Azure Cosmos DB. بهذه الطريقة يمكن للحلول المنشورة في Web App الاتصال بنقطة نهاية حساب Azure Cosmos DB باستخدام هذه الإعدادات.

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    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
      }
      connectorOffer = "Small"
      consistencyPolicy = {
        defaultConsistencyLevel = "string"
        maxIntervalInSeconds = int
        maxStalenessPrefix = int
      }
      cors = [
        {
          allowedHeaders = "string"
          allowedMethods = "string"
          allowedOrigins = "string"
          exposedHeaders = "string"
          maxAgeInSeconds = int
        }
      ]
      createMode = "string"
      databaseAccountOfferType = "Standard"
      defaultIdentity = "string"
      disableKeyBasedMetadataWriteAccess = bool
      disableLocalAuth = bool
      enableAnalyticalStorage = bool
      enableAutomaticFailover = bool
      enableCassandraConnector = bool
      enableFreeTier = bool
      enableMultipleWriteLocations = bool
      ipRules = [
        {
          ipAddressOrRange = "string"
        }
      ]
      isVirtualNetworkFilterEnabled = bool
      keyVaultKeyUri = "string"
      locations = [
        {
          failoverPriority = int
          isZoneRedundant = bool
          locationName = "string"
        }
      ]
      networkAclBypass = "string"
      networkAclBypassResourceIds = [
        "string"
      ]
      publicNetworkAccess = "string"
      restoreParameters = {
        databasesToRestore = [
          {
            collectionNames = [
              "string"
            ]
            databaseName = "string"
          }
        ]
        restoreMode = "PointInTime"
        restoreSource = "string"
        restoreTimestampInUtc = "string"
      }
      virtualNetworkRules = [
        {
          id = "string"
          ignoreMissingVNetServiceEndpoint = bool
        }
      ]
    }
    kind = "string"
  })
}

عناصر BackupPolicy

قم بتعيين خاصية النوع لتحديد نوع العنصر.

للتواصل، استخدم:

  type = "Continuous"

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

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

قيم Property

حسابات قاعدة البيانات

الاسم الوصف القيمة
النوع نوع المورد "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
الاسم اسم المورد سلسلة (مطلوب)

حد الحرف: 3-44

أحرف صالحة:
الأحرف صغيرة والأرقام والواصلات.

ابدأ بحرف صغير أو رقم.

يجب أن يكون اسم المورد فريدا عبر Azure.
الموقع موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة
parent_id للنشر إلى مجموعة موارد، استخدم معرف مجموعة الموارد هذه. سلسلة (مطلوب)
العلامات العلامات هي قائمة أزواج قيم المفاتيح التي تصف المورد. يمكن استخدام هذه العلامات في عرض هذا المورد وتجميعه (عبر مجموعات الموارد). يمكن توفير 15 علامة كحد أقصى لمورد. يجب أن تحتوي كل علامة على مفتاح لا يزيد عن 128 حرفا وقيمة لا تزيد عن 256 حرفا. على سبيل المثال، يتم تعيين التجربة الافتراضية لنوع القالب باستخدام "defaultExperience": "Cassandra". تتضمن قيم "defaultExperience" الحالية أيضا "Table" و"Graph" و"DocumentDB" و"MongoDB". قاموس أسماء العلامات والقيم.
نوع يشير إلى نوع حساب قاعدة البيانات. يمكن تعيين هذا فقط عند إنشاء حساب قاعدة البيانات. "GlobalDocumentDB"
"MongoDB"
"تحليل"
الهوية هوية المورد. ManagedServiceIdentity
خصائص خصائص لإنشاء حسابات قاعدة بيانات Azure Cosmos DB وتحديثها. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (مطلوب)

ManagedServiceIdentity

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

ManagedServiceIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

الاسم الوصف القيمة
تكوين التخزين التحليلي خصائص محددة للتخزين التحليلي. تكوين التخزين التحليلي
apiProperties خصائص محددة لواجهة برمجة التطبيقات. حاليا، مدعوم فقط لواجهة برمجة تطبيقات MongoDB. ApiProperties
نهج النسخ الاحتياطي الكائن الذي يمثل نهج أخذ النسخ الاحتياطية على حساب. BackupPolicy
الإمكانات قائمة قدرات Cosmos DB للحساب القدرة[]
السعة الكائن الذي يمثل جميع الخصائص المتعلقة بتطبيق السعة على حساب. السعة
الموصلOffer نوع عرض موصل cassandra لحساب قاعدة بيانات Cosmos DB C* . "صغير"
نهج التناسق نهج التناسق لحساب Cosmos DB. نهج التناسق
CORS نهج CORS لحساب قاعدة بيانات Cosmos DB. CorsPolicy[]
createMode تعداد للإشارة إلى وضع إنشاء الحساب. "افتراضي"
"استعادة"
databaseAccountOfferType نوع العرض لقاعدة البيانات "قياسي" (مطلوب)
defaultIdentity الهوية الافتراضية للوصول إلى مخزن المفاتيح المستخدم في ميزات مثل المفاتيح المدارة من قبل العميل. يجب تعيين الهوية الافتراضية بشكل صريح من قبل المستخدمين. يمكن أن يكون "FirstPartyIdentity" و"SystemAssignedIdentity" والمزيد. سلسلة
disableKeyBasedMetadataWriteAccess تعطيل عمليات الكتابة على موارد بيانات التعريف (قواعد البيانات والحاويات ومعدل النقل) عبر مفاتيح الحساب Bool
disableLocalAuth إلغاء الاشتراك في المصادقة المحلية والتأكد من أن MSI وAD فقط يمكن استخدامهما حصريا للمصادقة. Bool
تمكينAnalyticalStorage ضع علامة للإشارة إلى ما إذا كان يجب تمكين تحليلات التخزين. Bool
enableAutomaticFailover تمكين تجاوز الفشل التلقائي لمنطقة الكتابة في الحدث النادر الذي لا تتوفر فيه المنطقة بسبب انقطاع التيار الكهربائي. سيؤدي تجاوز الفشل التلقائي إلى منطقة كتابة جديدة للحساب ويتم اختيارها استنادا إلى أولويات تجاوز الفشل التي تم تكوينها للحساب. Bool
enableCassandraConnector تمكين موصل cassandra على حساب Cosmos DB C* Bool
enableFreeTier ضع علامة للإشارة إلى ما إذا كان المستوى المجاني ممكنا أم لا. Bool
enableMultipleWriteLocations تمكين الحساب من الكتابة في مواقع متعددة Bool
ipRules قائمة IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled ضع علامة للإشارة إلى ما إذا كان يجب تمكين/تعطيل قواعد ACL للشبكة الظاهرية. Bool
keyVaultKeyUri عنوان URI لمخزن المفاتيح سلسلة
المواقع صفيف يحتوي على مواقع التبسيط الجغرافي الممكنة لحساب Cosmos DB. الموقع[] (مطلوب)
networkAclBypass "AzureServices"
"بلا": يشير إلى الخدمات المسموح لها بتجاوز عمليات التحقق من جدار الحماية.
networkAclBypassResourceIds صفيف يحتوي على معرفات الموارد لتجاوز Network Acl لحساب Cosmos DB. سلسلة []
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة. RestoreParameters
virtualNetworkRules قائمة قواعد ACL للشبكة الظاهرية التي تم تكوينها لحساب Cosmos DB. VirtualNetworkRule[]

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

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

ApiProperties

الاسم الوصف القيمة
serverVersion يصف ServerVersion لحساب MongoDB. "3.2"
"3.6"
"4.0"
"4.2"

BackupPolicy

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

BackupPolicyMigrationState

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

ContinuousModeBackupPolicy

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

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

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

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

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

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

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

الإمكانية

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

السعة

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

نهج التناسق

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

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

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

نهج Cors

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

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

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". سلسلة

‏‏الموقع

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

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

RestoreParameters

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

DatabaseRestoreResource

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

VirtualNetworkRule

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