Microsoft.Sql managedInstances

تعريف مورد Bicep

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.Sql/managedInstances@2023-05-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'ActiveDirectory'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    authenticationMetadata: 'string'
    collation: 'string'
    databaseFormat: 'string'
    dnsZonePartner: 'string'
    hybridSecondaryUsage: 'string'
    instancePoolId: 'string'
    isGeneralPurposeV2: bool
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
}

قيم Property

managedInstances

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

حد الحرف: 1-63

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

لا يمكنك البدء أو الانتهاء باستخدام واصلة.

يجب أن يكون اسم المورد فريدا عبر Azure.
الموقع الموقع الخاص بالمورد. سلسلة (مطلوب)
العلامات علامات الموارد. قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
sku وحدة SKU للمثيل المدار. القيم المسموح بها sku.name: GP_Gen5، GP_G8IM، GP_G8IH، BC_Gen5، BC_G8IM، BC_G8IH "Sku"
الهوية هوية Azure Active Directory للمثيل المدار. معرف المورد
خصائص خصائص المورد. ManagedInstanceProperties

معرف المورد

الاسم الوصف القيمة
النوع نوع الهوية. قم بتعيين هذا إلى "SystemAssigned" لإنشاء وتعيين أساس Azure Active Directory للمورد تلقائيا. 'بلا'
'SystemAssigned'
'SystemAssigned,UserAssigned'
"UserAssigned"
userAssignedIdentities معرفات الموارد للهويات المعينة من قبل المستخدم لاستخدامها معرف الموردUserAssignedIdentities

معرف الموردUserAssignedIdentities

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

UserIdentity

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

ManagedInstanceProperties

الاسم الوصف القيمة
سجل المسؤول اسم مستخدم المسؤول للمثيل المدار. يمكن تحديد فقط عند إنشاء المثيل المدار (وهو مطلوب للإنشاء). سلسلة
administratorLoginPassword كلمة مرور تسجيل دخول المسؤول (مطلوبة لإنشاء مثيل مدار). سلسلة

القيود:
قيمة حساسة. قم بالتمرير كمعلمة آمنة.
المسؤولين مسؤول Azure Active Directory للمثيل. يمكن استخدام هذا فقط في وقت إنشاء المثيل. إذا تم استخدامه لتحديث المثيل، فسيتم تجاهله أو سيؤدي إلى حدوث خطأ. بالنسبة للتحديثات، ستحتاج واجهات برمجة التطبيقات الفردية إلى استخدام. ManagedInstanceExternalAdministrator
authenticationMetadata وضع البحث عن بيانات تعريف المصادقة للمثيل المدار. "AzureAD"
"مقترن"
'Windows'
ترتيب ترتيب المثيل المدار. سلسلة
تنسيق قاعدة البيانات يحدد التنسيق الداخلي لقواعد بيانات المثيل الخاصة بإصدار محرك SQL. 'AlwaysUpToDate'
'SQLServer2022'
dnsZonePartner معرف المورد لمثيل مدار آخر ستشارك منطقة DNS الخاصة به هذا المثيل المدار بعد الإنشاء. سلسلة
hybridSecondaryUsage الاستخدام الثانوي المختلط. القيم المحتملة هي "نشط" (قيمة افتراضية) و"سلبي" (يستخدم العميل الثانوي ك DR سلبي). "نشط"
"سلبي"
instancePoolId معرف تجمع المثيل الذي ينتمي إليه هذا الخادم المدار. سلسلة
isGeneralPurposeV2 ما إذا كان هذا متغير GPv2 من إصدار General Purpose أم لا. Bool
keyId CMK URI للمفتاح لاستخدامه للتشفير. سلسلة
نوع الترخيص نوع الترخيص. القيم المحتملة هي "LicenseIncluded" (السعر العادي بما في ذلك ترخيص SQL الجديد) و"BasePrice" (سعر AHB مخفض لإحضار تراخيص SQL الخاصة بك). 'BasePrice'
"الترخيص المكعب"
معرف تكوين الصيانة يحدد معرف تكوين الصيانة لتطبيقه على هذا المثيل المدار. سلسلة
managedInstanceCreateMode يحدد وضع إنشاء قاعدة البيانات.

الافتراضي: إنشاء مثيل عادي.

استعادة: إنشاء مثيل عن طريق استعادة مجموعة من النسخ الاحتياطية إلى نقطة زمنية محددة. يجب تحديد RestorePointInTime وS sourceManagedInstanceId.
"افتراضي"
'PointInTimeRestore'
الحد الأدنى لTlsVersion الحد الأدنى من إصدار TLS. القيم المسموح بها: "بلا" و"1.0" و"1.1" و"1.2" سلسلة
pricingModel الطقس أو ليس المثيل المدار هو freemium. 'Freemium'
"عادي"
primaryUserAssignedIdentityId معرف المورد للهوية المعينة من قبل المستخدم لاستخدامها بشكل افتراضي. سلسلة
proxyOverride نوع الاتصال المستخدم للاتصال بالمثيل. "افتراضي"
"الوكيل"
"إعادة التوجيه"
publicDataEndpointEnabled ما إذا كانت نقطة نهاية البيانات العامة ممكنة أم لا. Bool
طلبBackupStorageRedundancy نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لهذا المثيل. الخيارات محلية (LocallyRedundantStorage) والمنطقة (ZoneRedundantStorage) و Geo (GeoRedundantStorage) و GeoZone (GeoZoneRedundantStorage) 'الموقع الجغرافي'
"المنطقة الجغرافية"
"محلي"
"المنطقة"
restorePointInTime يحدد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة. سلسلة
كيان الخدمة كيان خدمة المثيل المدار. ServicePrincipal
sourceManagedInstanceId معرف المورد للمثيل المدار المصدر المقترن بعملية إنشاء هذا المثيل. سلسلة
storageIOps عمليات الإدخال والإخراج في الثانية للتخزين. الحد الأدنى للقيمة: 120. القيمة القصوى: 120000. زيادة 1 IOps مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
storageSizeInGB حجم التخزين بالجيجابايت. الحد الأدنى للقيمة: 32. القيمة القصوى: 16384. زيادة 32 غيغابايت مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
storageThroughputMBps معدل نقل التخزين ب MBps. الحد الأدنى للقيمة: 25. القيمة القصوى: 4000. يسمح بزيادات تبلغ 1 ميغابت في الثانية فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
معرف الشبكة الفرعية معرف مورد الشبكة الفرعية للمثيل المدار. سلسلة
معرف المنطقة الزمنية معرف المنطقة الزمنية. القيم المسموح بها هي المناطق الزمنية التي يدعمها Windows.
يحتفظ Windows بتفاصيل حول المناطق الزمنية المدعومة، بما في ذلك المعرف، في السجل ضمن
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
يمكنك الحصول على قيم التسجيل هذه عبر SQL Server عن طريق الاستعلام عن اسم SELECT AS timezone_id FROM sys.time_zone_info.
يمكن أيضا الحصول على قائمة المعرفين عن طريق تنفيذ [System.TimeZoneInfo]::GetSystemTimeZones() في PowerShell.
مثال على معرف المنطقة الزمنية الصالح هو "توقيت المحيط الهادئ القياسي" أو "W. توقيت أوروبا الرسمي".
سلسلة
وحدات vCore عدد vCores. القيم المسموح بها: 8، 16، 24، 32، 40، 64، 80. int
zoneRedundant ما إذا كان قد تم تمكين multi-az أم لا. Bool

ManagedInstanceExternalAdministrator

الاسم الوصف القيمة
نوع المسؤول نوع مسؤول sever. "ActiveDirectory"
azureADOnlyAuthentication تمكين المصادقة في Azure Active Directory فقط. Bool
login اسم تسجيل الدخول لمسؤول الخادم. سلسلة
principalType النوع الأساسي لمسؤول sever. "التطبيق"
"المجموعة"
"المستخدم"
sid SID (معرف العنصر) لمسؤول الخادم. سلسلة

القيود:
الحد الأدنى للطول = 36
الحد الأقصى للطول = 36
النمط = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
معرّف المستأجر معرف المستأجر للمسؤول. سلسلة

القيود:
الحد الأدنى للطول = 36
الحد الأقصى للطول = 36
النمط = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipal

الاسم الوصف القيمة
النوع نوع كيان الخدمة. 'بلا'
'SystemAssigned'

Sku

الاسم الوصف القيمة
السعة سعة وحدة SKU معينة. int
الاسره إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا. سلسلة
الاسم اسم SKU، عادة، حرف + رمز رقم، على سبيل المثال P3. سلسلة (مطلوب)
الحجم حجم وحدة SKU المحددة سلسلة
المستوي طبقة أو إصدار وحدة SKU معينة، مثل Basic وPremium. سلسلة

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

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

قالب الوصف
توزيع مثيل SQL المدار مع الشبكات

نشر في Azure
توزيع UDR وNSG لدعم Azure SQL Managed Instance ونشر المثيل المدار
إنشاء SQL MI داخل الشبكة الظاهرية الجديدة

نشر في Azure
نشر مثيل Azure Sql Database المدار (SQL MI) داخل شبكة ظاهرية جديدة.
إنشاء SQL MI مع إرسال السجلات والمقاييس المكونة

نشر في Azure
يسمح لك هذا القالب بتوزيع SQL MI والموارد الإضافية المستخدمة لتخزين السجلات والمقاييس (مساحة العمل التشخيصية، وحساب التخزين، ومركز الأحداث).
إنشاء SQL MI مع jumpbox داخل شبكة ظاهرية جديدة

نشر في Azure
توزيع مثيل Azure Sql Database المدار (SQL MI) و JumpBox باستخدام SSMS داخل شبكة ظاهرية جديدة.
إنشاء SQL MI مع تكوين اتصال من نقطة إلى موقع

نشر في Azure
انشر Azure Sql Database Managed Instance (SQL MI) وبوابة الشبكة الظاهرية المكونة للاتصال من نقطة إلى موقع داخل الشبكة الظاهرية الجديدة.

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2023-05-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "ActiveDirectory",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

قيم Property

managedInstances

الاسم الوصف القيمة
النوع نوع المورد 'Microsoft.Sql/managedInstances'
apiVersion إصدار واجهة برمجة تطبيقات المورد 'معاينة 2023-05-01'
الاسم اسم المورد سلسلة (مطلوب)

حد الحرف: 1-63

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

لا يمكنك البدء أو الانتهاء باستخدام واصلة.

يجب أن يكون اسم المورد فريدا عبر Azure.
الموقع الموقع الخاص بالمورد. سلسلة (مطلوب)
العلامات علامات الموارد. قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
sku وحدة SKU للمثيل المدار. القيم المسموح بها sku.name: GP_Gen5، GP_G8IM، GP_G8IH، BC_Gen5، BC_G8IM، BC_G8IH "Sku"
الهوية هوية Azure Active Directory للمثيل المدار. معرف المورد
خصائص خصائص المورد. ManagedInstanceProperties

معرف المورد

الاسم الوصف القيمة
النوع نوع الهوية. قم بتعيين هذا إلى "SystemAssigned" لإنشاء وتعيين أساس Azure Active Directory للمورد تلقائيا. 'بلا'
'SystemAssigned'
'SystemAssigned,UserAssigned'
"UserAssigned"
userAssignedIdentities معرفات الموارد للهويات المعينة من قبل المستخدم لاستخدامها معرف الموردUserAssignedIdentities

معرف الموردUserAssignedIdentities

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

UserIdentity

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

ManagedInstanceProperties

الاسم الوصف القيمة
سجل المسؤول اسم مستخدم المسؤول للمثيل المدار. يمكن تحديد فقط عند إنشاء المثيل المدار (وهو مطلوب للإنشاء). سلسلة
administratorLoginPassword كلمة مرور تسجيل دخول المسؤول (مطلوبة لإنشاء مثيل مدار). سلسلة

القيود:
قيمة حساسة. قم بالتمرير كمعلمة آمنة.
المسؤولين مسؤول Azure Active Directory للمثيل. يمكن استخدام هذا فقط في وقت إنشاء المثيل. إذا تم استخدامه لتحديث المثيل، فسيتم تجاهله أو سيؤدي إلى حدوث خطأ. بالنسبة للتحديثات، ستحتاج واجهات برمجة التطبيقات الفردية إلى استخدام. ManagedInstanceExternalAdministrator
authenticationMetadata وضع البحث عن بيانات تعريف مصادقة المثيل المدار. "AzureAD"
"مقترن"
'Windows'
ترتيب ترتيب المثيل المدار. سلسلة
تنسيق قاعدة البيانات يحدد التنسيق الداخلي لقواعد بيانات المثيل الخاصة بإصدار محرك SQL. 'AlwaysUpToDate'
'SQLServer2022'
dnsZonePartner معرف المورد لمثيل مدار آخر ستشاركه منطقة DNS التي سيشاركها هذا المثيل المدار بعد الإنشاء. سلسلة
HybridSecondaryUsage الاستخدام الثانوي المختلط. القيم المحتملة هي "Active" (القيمة الافتراضية) و"Passive" (يستخدم العميل الثانوي ك Dr سلبي). "نشط"
"سلبي"
instancePoolId معرف تجمع المثيل الذي ينتمي إليه هذا الخادم المدار. سلسلة
isGeneralPurposeV2 ما إذا كان هذا متغير GPv2 من إصدار General Purpose أم لا. Bool
keyId CMK URI للمفتاح لاستخدامه للتشفير. سلسلة
نوع الترخيص نوع الترخيص. القيم المحتملة هي "LicenseIncluded" (السعر العادي بما في ذلك ترخيص SQL جديد) و"BasePrice" (سعر AHB مخفض لإحضار تراخيص SQL الخاصة بك). 'BasePrice'
'LicenseIncluded'
معرف تكوين الصيانة يحدد معرف تكوين الصيانة لتطبيقه على هذا المثيل المدار. سلسلة
managedInstanceCreateMode يحدد وضع إنشاء قاعدة البيانات.

الافتراضي: إنشاء مثيل عادي.

الاستعادة: إنشاء مثيل عن طريق استعادة مجموعة من النسخ الاحتياطية إلى نقطة زمنية محددة. يجب تحديد RestorePointInTime و SourceManagedInstanceId.
"افتراضي"
'PointInTimeRestore'
الحد الأدنى لTlsVersion الحد الأدنى من إصدار TLS. القيم المسموح بها: 'بلا'، '1.0'، '1.1'، '1.2' سلسلة
pricingModel الطقس أو ليس المثيل المدار هو freemium. 'Freemium'
'عادي'
primaryUserAssignedIdentityId معرف المورد للهوية المعينة من قبل المستخدم لاستخدامها بشكل افتراضي. سلسلة
proxyOverride نوع الاتصال المستخدم للاتصال بالمثيل. "افتراضي"
"الوكيل"
"إعادة التوجيه"
publicDataEndpointEnabled ما إذا كانت نقطة نهاية البيانات العامة ممكنة أم لا. Bool
طلبBackupStorageRedundancy نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لهذا المثيل. الخيارات محلية (LocallyRedundantStorage) والمنطقة (ZoneRedundantStorage) و Geo (GeoRedundantStorage) و GeoZone (GeoZoneRedundantStorage) 'Geo'
'GeoZone'
"محلي"
"المنطقة"
restorePointInTime يحدد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة. سلسلة
كيان الخدمة كيان خدمة المثيل المدار. ServicePrincipal
sourceManagedInstanceId معرف المورد للمثيل المدار المصدر المقترن بعملية إنشاء هذا المثيل. سلسلة
storageIOps عمليات الإدخال والإخراج في الثانية للتخزين. الحد الأدنى للقيمة: 120. القيمة القصوى: 120000. زيادة 1 IOps مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
storageSizeInGB حجم التخزين بالجيجابايت. الحد الأدنى للقيمة: 32. القيمة القصوى: 16384. زيادة 32 غيغابايت مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
storageThroughputMBps معدل نقل التخزين ب MBps. الحد الأدنى للقيمة: 25. الحد الأقصى للقيمة: 4000. يسمح بزيادات قدرها 1 ميغابت في الثانية فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
معرف الشبكة الفرعية معرف مورد الشبكة الفرعية للمثيل المدار. سلسلة
معرف المنطقة الزمنية معرف المنطقة الزمنية. القيم المسموح بها هي المناطق الزمنية التي يدعمها Windows.
يحتفظ Windows بتفاصيل حول المناطق الزمنية المدعومة، بما في ذلك المعرف، في السجل ضمن
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
يمكنك الحصول على قيم التسجيل هذه عبر SQL Server عن طريق الاستعلام عن اسم SELECT AS timezone_id FROM sys.time_zone_info.
يمكن أيضا الحصول على قائمة المعرفين عن طريق تنفيذ [System.TimeZoneInfo]::GetSystemTimeZones() في PowerShell.
مثال على معرف المنطقة الزمنية الصالح هو "توقيت المحيط الهادئ القياسي" أو "W. توقيت أوروبا الرسمي".
سلسلة
وحدات vCore عدد vCores. القيم المسموح بها: 8، 16، 24، 32، 40، 64، 80. int
zoneRedundant ما إذا كان قد تم تمكين multi-az أم لا. Bool

ManagedInstanceExternalAdministrator

الاسم الوصف القيمة
نوع المسؤول نوع مسؤول الخادم. "ActiveDirectory"
azureADOnlyAuthentication تمكين مصادقة Azure Active Directory فقط. Bool
login اسم تسجيل الدخول لمسؤول الخادم. سلسلة
principalType النوع الأساسي لمسؤول الخادم. "التطبيق"
"مجموعة"
"المستخدم"
sid SID (معرف العنصر) لمسؤول الخادم. سلسلة

القيود:
الحد الأدنى للطول = 36
الحد الأقصى للطول = 36
النمط = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
معرّف المستأجر معرف المستأجر للمسؤول. سلسلة

القيود:
الحد الأدنى للطول = 36
الحد الأقصى للطول = 36
النمط = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipal

الاسم الوصف القيمة
النوع نوع كيان الخدمة. 'بلا'
'SystemAssigned'

Sku

الاسم الوصف القيمة
السعة سعة وحدة حفظ المخزون المحددة. int
الاسره إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا. سلسلة
الاسم اسم SKU، عادة، حرف + رمز رقم، على سبيل المثال P3. سلسلة (مطلوبة)
الحجم حجم وحدة SKU المحددة سلسلة
المستوي مستوى أو إصدار SKU المحدد، مثل Basic وPremium. سلسلة

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

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

قالب الوصف
توزيع مثيل SQL المدار مع الشبكات

نشر في Azure
نشر UDR وNSG لدعم Azure SQL Managed Instance ونشر المثيل المدار
إنشاء SQL MI داخل الشبكة الظاهرية الجديدة

نشر في Azure
نشر Azure Sql Database Managed Instance (SQL MI) داخل الشبكة الظاهرية الجديدة.
إنشاء SQL MI مع إرسال مكون للسجلات والمقاييس

نشر في Azure
يسمح لك هذا القالب بتوزيع SQL MI والموارد الإضافية المستخدمة لتخزين السجلات والمقاييس (مساحة العمل التشخيصية وحساب التخزين ومركز الأحداث).
إنشاء SQL MI مع jumpbox داخل شبكة ظاهرية جديدة

نشر في Azure
توزيع Azure Sql Database Managed Instance (SQL MI) و JumpBox مع SSMS داخل شبكة ظاهرية جديدة.
إنشاء SQL MI مع تكوين اتصال من نقطة إلى موقع

نشر في Azure
انشر Azure Sql Database Managed Instance (SQL MI) وبوابة الشبكة الظاهرية المكونة للاتصال من نقطة إلى موقع داخل الشبكة الظاهرية الجديدة.

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2023-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "ActiveDirectory"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      authenticationMetadata = "string"
      collation = "string"
      databaseFormat = "string"
      dnsZonePartner = "string"
      hybridSecondaryUsage = "string"
      instancePoolId = "string"
      isGeneralPurposeV2 = bool
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

قيم Property

managedInstances

الاسم الوصف القيمة
النوع نوع المورد "Microsoft.Sql/managedInstances@2023-05-01-preview"
الاسم اسم المورد سلسلة (مطلوبة)

حد الحرف: 1-63

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

لا يمكنك البدء أو الانتهاء باستخدام واصلة.

يجب أن يكون اسم المورد فريدا عبر Azure.
الموقع الموقع الخاص بالمورد. سلسلة (مطلوب)
parent_id للنشر إلى مجموعة موارد، استخدم معرف مجموعة الموارد هذه. سلسلة (مطلوب)
العلامات علامات الموارد. قاموس أسماء العلامات والقيم.
sku وحدة SKU للمثيل المدار. القيم المسموح بها sku.name: GP_Gen5، GP_G8IM، GP_G8IH، BC_Gen5، BC_G8IM، BC_G8IH "Sku"
الهوية هوية Azure Active Directory للمثيل المدار. معرف المورد
خصائص خصائص المورد. ManagedInstanceProperties

معرف المورد

الاسم الوصف القيمة
النوع نوع الهوية. قم بتعيين هذا إلى "SystemAssigned" لإنشاء وتعيين أساس Azure Active Directory للمورد تلقائيا. "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
identity_ids معرفات الموارد للهويات المعينة من قبل المستخدم لاستخدامها صفيف معرفات هوية المستخدم.

معرف الموردUserAssignedIdentities

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

UserIdentity

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

ManagedInstanceProperties

الاسم الوصف القيمة
سجل المسؤول اسم مستخدم المسؤول للمثيل المدار. يمكن تحديد فقط عند إنشاء المثيل المدار (وهو مطلوب للإنشاء). سلسلة
administratorLoginPassword كلمة مرور تسجيل دخول المسؤول (مطلوبة لإنشاء مثيل مدار). سلسلة

القيود:
قيمة حساسة. قم بالتمرير كمعلمة آمنة.
المسؤولين مسؤول Azure Active Directory للمثيل. يمكن استخدام هذا فقط في وقت إنشاء المثيل. إذا تم استخدامه لتحديث المثيل، فسيتم تجاهله أو سيؤدي إلى حدوث خطأ. بالنسبة للتحديثات، ستحتاج واجهات برمجة التطبيقات الفردية إلى استخدام. ManagedInstanceExternalAdministrator
authenticationMetadata وضع البحث عن بيانات تعريف مصادقة المثيل المدار. "AzureAD"
"مقترن"
"Windows"
ترتيب ترتيب المثيل المدار. سلسلة
تنسيق قاعدة البيانات يحدد التنسيق الداخلي لقواعد بيانات المثيل الخاصة بإصدار محرك SQL. "AlwaysUpToDate"
"SQLServer2022"
dnsZonePartner معرف المورد لمثيل مدار آخر ستشاركه منطقة DNS التي سيشاركها هذا المثيل المدار بعد الإنشاء. سلسلة
HybridSecondaryUsage الاستخدام الثانوي المختلط. القيم المحتملة هي "Active" (القيمة الافتراضية) و"Passive" (يستخدم العميل الثانوي ك Dr سلبي). "نشط"
"سلبي"
instancePoolId معرف تجمع المثيل الذي ينتمي إليه هذا الخادم المدار. سلسلة
isGeneralPurposeV2 ما إذا كان هذا متغير GPv2 من إصدار General Purpose أم لا. Bool
keyId CMK URI للمفتاح لاستخدامه للتشفير. سلسلة
نوع الترخيص نوع الترخيص. القيم المحتملة هي "LicenseIncluded" (السعر العادي بما في ذلك ترخيص SQL جديد) و"BasePrice" (سعر AHB مخفض لإحضار تراخيص SQL الخاصة بك). "BasePrice"
"LicenseIncluded"
معرف تكوين الصيانة يحدد معرف تكوين الصيانة لتطبيقه على هذا المثيل المدار. سلسلة
managedInstanceCreateMode يحدد وضع إنشاء قاعدة البيانات.

الافتراضي: إنشاء مثيل عادي.

استعادة: إنشاء مثيل عن طريق استعادة مجموعة من النسخ الاحتياطية إلى نقطة زمنية محددة. يجب تحديد RestorePointInTime وS sourceManagedInstanceId.
"افتراضي"
"PointInTimeRestore"
الحد الأدنى لTlsVersion الحد الأدنى من إصدار TLS. القيم المسموح بها: "بلا" و"1.0" و"1.1" و"1.2" سلسلة
pricingModel الطقس أو ليس المثيل المدار هو freemium. "Freemium"
"عادي"
primaryUserAssignedIdentityId معرف المورد للهوية المعينة من قبل المستخدم لاستخدامها بشكل افتراضي. سلسلة
proxyOverride نوع الاتصال المستخدم للاتصال بالمثيل. "افتراضي"
"الوكيل"
"إعادة التوجيه"
publicDataEndpointEnabled ما إذا كانت نقطة نهاية البيانات العامة ممكنة أم لا. Bool
طلبBackupStorageRedundancy نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لهذا المثيل. الخيارات محلية (LocallyRedundantStorage) والمنطقة (ZoneRedundantStorage) و Geo (GeoRedundantStorage) و GeoZone (GeoZoneRedundantStorage) "الموقع الجغرافي"
"GeoZone"
"محلي"
"المنطقة"
restorePointInTime يحدد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة. سلسلة
كيان الخدمة كيان خدمة المثيل المدار. ServicePrincipal
sourceManagedInstanceId معرف المورد للمثيل المدار المصدر المقترن بعملية إنشاء هذا المثيل. سلسلة
storageIOps عمليات الإدخال والإخراج في الثانية للتخزين. الحد الأدنى للقيمة: 120. القيمة القصوى: 120000. زيادة 1 IOps مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
storageSizeInGB حجم التخزين بالجيجابايت. الحد الأدنى للقيمة: 32. القيمة القصوى: 16384. زيادة 32 غيغابايت مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
storageThroughputMBps معدل نقل التخزين ب MBps. الحد الأدنى للقيمة: 25. القيمة القصوى: 4000. يسمح بزيادات تبلغ 1 ميغابت في الثانية فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores. int
معرف الشبكة الفرعية معرف مورد الشبكة الفرعية للمثيل المدار. سلسلة
معرف المنطقة الزمنية معرف المنطقة الزمنية. القيم المسموح بها هي المناطق الزمنية التي يدعمها Windows.
يحتفظ Windows بتفاصيل حول المناطق الزمنية المدعومة، بما في ذلك المعرف، في السجل ضمن
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
يمكنك الحصول على قيم التسجيل هذه عبر SQL Server عن طريق الاستعلام عن اسم SELECT AS timezone_id FROM sys.time_zone_info.
يمكن أيضا الحصول على قائمة المعرف عن طريق تنفيذ [System.TimeZoneInfo]::GetSystemTimeZones() في PowerShell.
مثال على معرف المنطقة الزمنية الصالح هو "توقيت المحيط الهادئ القياسي" أو "W. توقيت أوروبا الرسمي".
سلسلة
وحدات vCore عدد vCores. القيم المسموح بها: 8، 16، 24، 32، 40، 64، 80. int
zoneRedundant ما إذا كان قد تم تمكين multi-az أم لا. Bool

ManagedInstanceExternalAdministrator

الاسم الوصف القيمة
نوع المسؤول نوع مسؤول الخادم. "ActiveDirectory"
azureADOnlyAuthentication تمكين مصادقة Azure Active Directory فقط. Bool
login اسم تسجيل الدخول لمسؤول الخادم. سلسلة
principalType النوع الأساسي لمسؤول الخادم. "التطبيق"
"مجموعة"
"المستخدم"
sid SID (معرف العنصر) لمسؤول الخادم. سلسلة

القيود:
الحد الأدنى للطول = 36
الحد الأقصى للطول = 36
النمط = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
معرّف المستأجر معرف المستأجر للمسؤول. سلسلة

القيود:
الحد الأدنى للطول = 36
الحد الأقصى للطول = 36
النمط = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipal

الاسم الوصف القيمة
النوع نوع كيان الخدمة. "لا أحد"
"SystemAssigned"

Sku

الاسم الوصف القيمة
السعة سعة وحدة حفظ المخزون المحددة. int
الاسره إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا. سلسلة
الاسم اسم SKU، عادة، حرف + رمز رقم، على سبيل المثال P3. سلسلة (مطلوبة)
الحجم حجم وحدة SKU المحددة سلسلة
المستوي مستوى أو إصدار SKU المحدد، مثل Basic وPremium. سلسلة