Microsoft.Sql managedInstances

تعريف مورد Bicep

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

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'string'
      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'
    memorySizeInGB: int
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    requestedLogicalAvailabilityZone: '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'
  }
  tags: {
    {customized property}: 'string'
  }
}

قيم الخصائص

Microsoft.Sql/managedInstances

Name	Description	Value
identity	هوية Azure Active Directory للمثيل المدار.	ResourceIdentity
location	موقع المورد.	سلسلة (مطلوب)
name	اسم المورد	سلسلة (مطلوب)
properties	خصائص المورد.	ManagedInstanceProperties
sku	SKU للمثيل المدار. القيم المسموح بها ل sku.name: GP_Gen5 (للأغراض العامة، السلسلة القياسية)؛ GP_G8IM (للأغراض العامة ، السلسلة المميزة) ؛ GP_G8IH (للأغراض العامة ، ذاكرة السلسلة المميزة المحسنة) ؛ BC_Gen5 (الأعمال الحرجة ، Standard-Series) ؛ BC_G8IM (الأعمال الحرجة ، السلسلة المميزة) ؛ BC_G8IH (Business Critical ، ذاكرة Premium-series محسنة).	Sku
tags	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	نوع مسؤول الخادم.	'ActiveDirectory'
azureADOnlyAuthentication	تمكين مصادقة Azure Active Directory فقط.	bool
login	اسم تسجيل الدخول لمسؤول الخادم.	string
principalType	النوع الأساسي لمسؤول الخادم.	'Application' 'Group' 'User'
sid	SID (معرف الكائن) لمسؤول الخادم.	string Constraints: الحد الأدنى للطول = 36 الحد الأقصى للطول = 36 النمط = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	معرف المستأجر للمسؤول.	string Constraints: الحد الأدنى للطول = 36 الحد الأقصى للطول = 36 النمط = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	اسم مستخدم المسؤول للمثيل المدار. يمكن تحديد فقط عند إنشاء المثيل المدار (وهو مطلوب للإنشاء).	string
administratorLoginPassword	كلمة مرور تسجيل دخول المسؤول (مطلوبة لإنشاء مثيل مدار).	string Constraints: قيمة حساسة. تمرير كمعلمة آمنة.
administrators	يمكن استخدام مسؤول Azure Active Directory أثناء إنشاء المثيل وتحديثات المثيل، باستثناء الخاصية azureADOnlyAuthentication. لتحديث خاصية azureADOnlyAuthentication، يجب استخدام واجهة برمجة التطبيقات الفردية.	ManagedInstanceExternalAdministrator
authenticationMetadata	وضع البحث عن بيانات تعريف المصادقة للمثيل المدار.	'AzureAD' 'Paired' 'Windows'
collation	ترتيب المثيل المدار.	string
databaseFormat	يحدد التنسيق الداخلي لقواعد بيانات المثيل الخاصة بإصدار محرك SQL.	'AlwaysUpToDate' 'SQLServer2022' "SQLServer2025"
dnsZonePartner	معرف المورد لمثيل مدار آخر ستشارك منطقة DNS الخاصة به هذا المثيل المدار بعد الإنشاء.	string
hybridSecondaryUsage	الاستخدام الثانوي المختلط. القيم المحتملة هي "Active" (القيمة الافتراضية) و"Passive" (يستخدم العميل الثانوي ك Dr سلبي).	'Active' 'Passive'
instancePoolId	معرف تجمع المثيل الذي ينتمي إليه هذا الخادم المدار.	string
isGeneralPurposeV2	ما إذا كان هذا متغير GPv2 من إصدار الأغراض العامة أم لا.	bool
keyId	CMK URI للمفتاح لاستخدامه للتشفير.	string
licenseType	نوع الترخيص. القيم المحتملة هي "LicenseIncluded" (السعر العادي الذي يشمل ترخيص SQL الجديد) و"BasePrice" (سعر AHB مخفض لإحضار تراخيص SQL الخاصة بك).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	يحدد معرف تكوين الصيانة لتطبيقه على هذا المثيل المدار.	string
managedInstanceCreateMode	تحديد وضع إنشاء قاعدة البيانات. الافتراضي: إنشاء مثيل عادي. استعادة: ينشئ مثيلا عن طريق استعادة مجموعة من النسخ الاحتياطية إلى نقطة زمنية محددة. يجب تحديد RestorePointInTime وS sourceManagedInstanceId.	'Default' 'PointInTimeRestore'
الذاكرةالحجبغيغابايت	حجم الذاكرة بالجيجابايت. الحد الأدنى للقيمة: 28. القيمة القصوى: 870. يعتمد الحد الأدنى والحد الأقصى للقيمة على عدد vCores ومستوى الخدمة. اقرأ المزيد عن حدود الموارد: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	الحد الأدنى من إصدار TLS. القيم المسموح بها: "بلا"، "1.0"، "1.1"، "1.2"	string
pricingModel	نموذج التسعير للمثيل المدار.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	معرف المورد لهوية معينة من قبل المستخدم لاستخدامها بشكل افتراضي.	string
proxyOverride	نوع الاتصال المستخدم للاتصال بالمثيل.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	ما إذا كانت نقطة نهاية البيانات العامة ممكنة أم لا.	bool
requestedBackupStorageRedundancy	نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لهذا المثيل. الخيارات محلية (LocallyRedundantStorage) والمنطقة (ZoneRedundantStorage) و Geo (GeoRedundantStorage) و GeoZone (GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	يحدد منطقة التوفر المنطقية التي تم تثبيت المثيل المدار بها.	'1' '2' '3' 'NoPreference'
restorePointInTime	تحديد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة.	string
servicePrincipal	كيان خدمة المثيل المدار.	ServicePrincipal
sourceManagedInstanceId	معرف المورد للمثيل المدار المصدر المقترن بعملية إنشاء هذا المثيل.	string
storageIOps	وحدات إدخال الإخراج في الثانية للتخزين. الحد الأدنى للقيمة: 300. القيمة القصوى: 80000. زيادات من 1 IOps مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores.	int
storageSizeInGB	حجم التخزين بالجيجابايت. الحد الأدنى للقيمة: 32. القيمة القصوى: 32768. زيادات 32 غيغابايت مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores.	int
storageThroughputMBps	معلمة معدل نقل التخزين MBps غير مدعومة في عملية إنشاء/تحديث المثيل.	int
subnetId	معرف مورد الشبكة الفرعية للمثيل المدار.	string
timezoneId	معرف المنطقة الزمنية. القيم المسموح بها هي المناطق الزمنية التي يدعمها 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. توقيت أوروبا الرسمي".	string
vCores	عدد vCores. القيم المسموح بها: 4 ، 6 ، 8 ، 10 ، 12 ، 16 ، 20 ، 24 ، 32 ، 40 ، 48 ، 56 ، 64 ، 80 ، 96 ، 128. تعتمد vCores المدعومة على عائلة الأجهزة المحددة وطبقة الخدمة.	int
zoneRedundant	ما إذا كان يتم تمكين تكرار المنطقة أم لا.	bool

ResourceIdentity

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

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	نوع كيان الخدمة.	'None' 'SystemAssigned'

Sku

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

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

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

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

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

Module	Description
SQL Managed Instance	وحدة موارد AVM لمثيل SQL المدار

نماذج Azure Quickstart

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

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

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

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "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",
    "memorySizeInGB": "int",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "requestedLogicalAvailabilityZone": "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

قيم الخصائص

Microsoft.Sql/managedInstances

Name	Description	Value
apiVersion	إصدار واجهة برمجة التطبيقات	'2024-11-01-preview'
identity	هوية Azure Active Directory للمثيل المدار.	ResourceIdentity
location	موقع المورد.	سلسلة (مطلوب)
name	اسم المورد	سلسلة (مطلوب)
properties	خصائص المورد.	ManagedInstanceProperties
sku	SKU للمثيل المدار. القيم المسموح بها ل sku.name: GP_Gen5 (للأغراض العامة، السلسلة القياسية)؛ GP_G8IM (للأغراض العامة ، السلسلة المميزة) ؛ GP_G8IH (للأغراض العامة ، ذاكرة السلسلة المميزة المحسنة) ؛ BC_Gen5 (الأعمال الحرجة ، Standard-Series) ؛ BC_G8IM (الأعمال الحرجة ، السلسلة المميزة) ؛ BC_G8IH (Business Critical ، ذاكرة Premium-series محسنة).	Sku
tags	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
type	نوع المورد	'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	نوع مسؤول الخادم.	'ActiveDirectory'
azureADOnlyAuthentication	تمكين مصادقة Azure Active Directory فقط.	bool
login	اسم تسجيل الدخول لمسؤول الخادم.	string
principalType	النوع الأساسي لمسؤول الخادم.	'Application' 'Group' 'User'
sid	SID (معرف الكائن) لمسؤول الخادم.	string Constraints: الحد الأدنى للطول = 36 الحد الأقصى للطول = 36 النمط = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	معرف المستأجر للمسؤول.	string Constraints: الحد الأدنى للطول = 36 الحد الأقصى للطول = 36 النمط = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	اسم مستخدم المسؤول للمثيل المدار. يمكن تحديد فقط عند إنشاء المثيل المدار (وهو مطلوب للإنشاء).	string
administratorLoginPassword	كلمة مرور تسجيل دخول المسؤول (مطلوبة لإنشاء مثيل مدار).	string Constraints: قيمة حساسة. تمرير كمعلمة آمنة.
administrators	يمكن استخدام مسؤول Azure Active Directory أثناء إنشاء المثيل وتحديثات المثيل، باستثناء الخاصية azureADOnlyAuthentication. لتحديث خاصية azureADOnlyAuthentication، يجب استخدام واجهة برمجة التطبيقات الفردية.	ManagedInstanceExternalAdministrator
authenticationMetadata	وضع البحث عن بيانات تعريف المصادقة للمثيل المدار.	'AzureAD' 'Paired' 'Windows'
collation	ترتيب المثيل المدار.	string
databaseFormat	يحدد التنسيق الداخلي لقواعد بيانات المثيل الخاصة بإصدار محرك SQL.	'AlwaysUpToDate' 'SQLServer2022' "SQLServer2025"
dnsZonePartner	معرف المورد لمثيل مدار آخر ستشارك منطقة DNS الخاصة به هذا المثيل المدار بعد الإنشاء.	string
hybridSecondaryUsage	الاستخدام الثانوي المختلط. القيم المحتملة هي "Active" (القيمة الافتراضية) و"Passive" (يستخدم العميل الثانوي ك Dr سلبي).	'Active' 'Passive'
instancePoolId	معرف تجمع المثيل الذي ينتمي إليه هذا الخادم المدار.	string
isGeneralPurposeV2	ما إذا كان هذا متغير GPv2 من إصدار الأغراض العامة أم لا.	bool
keyId	CMK URI للمفتاح لاستخدامه للتشفير.	string
licenseType	نوع الترخيص. القيم المحتملة هي "LicenseIncluded" (السعر العادي الذي يشمل ترخيص SQL الجديد) و"BasePrice" (سعر AHB مخفض لإحضار تراخيص SQL الخاصة بك).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	يحدد معرف تكوين الصيانة لتطبيقه على هذا المثيل المدار.	string
managedInstanceCreateMode	تحديد وضع إنشاء قاعدة البيانات. الافتراضي: إنشاء مثيل عادي. استعادة: ينشئ مثيلا عن طريق استعادة مجموعة من النسخ الاحتياطية إلى نقطة زمنية محددة. يجب تحديد RestorePointInTime وS sourceManagedInstanceId.	'Default' 'PointInTimeRestore'
الذاكرةالحجبغيغابايت	حجم الذاكرة بالجيجابايت. الحد الأدنى للقيمة: 28. القيمة القصوى: 870. يعتمد الحد الأدنى والحد الأقصى للقيمة على عدد vCores ومستوى الخدمة. اقرأ المزيد عن حدود الموارد: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	الحد الأدنى من إصدار TLS. القيم المسموح بها: "بلا"، "1.0"، "1.1"، "1.2"	string
pricingModel	نموذج التسعير للمثيل المدار.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	معرف المورد لهوية معينة من قبل المستخدم لاستخدامها بشكل افتراضي.	string
proxyOverride	نوع الاتصال المستخدم للاتصال بالمثيل.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	ما إذا كانت نقطة نهاية البيانات العامة ممكنة أم لا.	bool
requestedBackupStorageRedundancy	نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لهذا المثيل. الخيارات محلية (LocallyRedundantStorage) والمنطقة (ZoneRedundantStorage) و Geo (GeoRedundantStorage) و GeoZone (GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	يحدد منطقة التوفر المنطقية التي تم تثبيت المثيل المدار بها.	'1' '2' '3' 'NoPreference'
restorePointInTime	تحديد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة.	string
servicePrincipal	كيان خدمة المثيل المدار.	ServicePrincipal
sourceManagedInstanceId	معرف المورد للمثيل المدار المصدر المقترن بعملية إنشاء هذا المثيل.	string
storageIOps	وحدات إدخال الإخراج في الثانية للتخزين. الحد الأدنى للقيمة: 300. القيمة القصوى: 80000. زيادات من 1 IOps مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores.	int
storageSizeInGB	حجم التخزين بالجيجابايت. الحد الأدنى للقيمة: 32. القيمة القصوى: 32768. زيادات 32 غيغابايت مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores.	int
storageThroughputMBps	معلمة معدل نقل التخزين MBps غير مدعومة في عملية إنشاء/تحديث المثيل.	int
subnetId	معرف مورد الشبكة الفرعية للمثيل المدار.	string
timezoneId	معرف المنطقة الزمنية. القيم المسموح بها هي المناطق الزمنية التي يدعمها 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. توقيت أوروبا الرسمي".	string
vCores	عدد vCores. القيم المسموح بها: 4 ، 6 ، 8 ، 10 ، 12 ، 16 ، 20 ، 24 ، 32 ، 40 ، 48 ، 56 ، 64 ، 80 ، 96 ، 128. تعتمد vCores المدعومة على عائلة الأجهزة المحددة وطبقة الخدمة.	int
zoneRedundant	ما إذا كان يتم تمكين تكرار المنطقة أم لا.	bool

ResourceIdentity

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

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	نوع كيان الخدمة.	'None' 'SystemAssigned'

Sku

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

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

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

قوالب Azure Quickstart

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

Template	Description
إنشاء SQL MI داخل الشبكة الظاهرية الجديدة	نشر Azure Sql Database Managed Instance (SQL MI) داخل الشبكة الظاهرية الجديدة.
إنشاء SQL MI مع إرسال مكون للسجلات والمقاييس	يسمح لك هذا القالب بنشر SQL MI والموارد الإضافية المستخدمة لتخزين السجلات والمقاييس (مساحة العمل التشخيصية وحساب التخزين ومركز الأحداث).
إنشاء SQL MI باستخدام jumpbox داخل الشبكة الظاهرية الجديدة	نشر Azure Sql Database Managed Instance (SQL MI) و JumpBox مع SSMS داخل شبكة ظاهرية جديدة.
إنشاء SQL MI مع تكوين اتصال من نقطة إلى موقع	نشر Azure Sql Database Managed Instance (SQL MI) وبوابة الشبكة الظاهرية المكونة للاتصال من نقطة إلى موقع داخل الشبكة الظاهرية الجديدة.
نشر مثيل SQL المدار مع الشبكات	نشر UDR وNSG لدعم مثيل Azure SQL المدار ونشر المثيل المدار

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        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"
      memorySizeInGB = int
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      requestedLogicalAvailabilityZone = "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"
    }
  }
}

قيم الخصائص

Microsoft.Sql/managedInstances

Name	Description	Value
identity	هوية Azure Active Directory للمثيل المدار.	ResourceIdentity
location	موقع المورد.	سلسلة (مطلوب)
name	اسم المورد	سلسلة (مطلوب)
properties	خصائص المورد.	ManagedInstanceProperties
sku	SKU للمثيل المدار. القيم المسموح بها ل sku.name: GP_Gen5 (للأغراض العامة، السلسلة القياسية)؛ GP_G8IM (للأغراض العامة ، السلسلة المميزة) ؛ GP_G8IH (للأغراض العامة ، ذاكرة السلسلة المميزة المحسنة) ؛ BC_Gen5 (الأعمال الحرجة ، Standard-Series) ؛ BC_G8IM (الأعمال الحرجة ، السلسلة المميزة) ؛ BC_G8IH (Business Critical ، ذاكرة Premium-series محسنة).	Sku
tags	علامات الموارد	قاموس أسماء العلامات والقيم.
type	نوع المورد	"Microsoft.Sql/managedInstances@2024-11-01-preview"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	نوع مسؤول الخادم.	'ActiveDirectory'
azureADOnlyAuthentication	تمكين مصادقة Azure Active Directory فقط.	bool
login	اسم تسجيل الدخول لمسؤول الخادم.	string
principalType	النوع الأساسي لمسؤول الخادم.	'Application' 'Group' 'User'
sid	SID (معرف الكائن) لمسؤول الخادم.	string Constraints: الحد الأدنى للطول = 36 الحد الأقصى للطول = 36 النمط = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	معرف المستأجر للمسؤول.	string Constraints: الحد الأدنى للطول = 36 الحد الأقصى للطول = 36 النمط = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	اسم مستخدم المسؤول للمثيل المدار. يمكن تحديد فقط عند إنشاء المثيل المدار (وهو مطلوب للإنشاء).	string
administratorLoginPassword	كلمة مرور تسجيل دخول المسؤول (مطلوبة لإنشاء مثيل مدار).	string Constraints: قيمة حساسة. تمرير كمعلمة آمنة.
administrators	يمكن استخدام مسؤول Azure Active Directory أثناء إنشاء المثيل وتحديثات المثيل، باستثناء الخاصية azureADOnlyAuthentication. لتحديث خاصية azureADOnlyAuthentication، يجب استخدام واجهة برمجة التطبيقات الفردية.	ManagedInstanceExternalAdministrator
authenticationMetadata	وضع البحث عن بيانات تعريف المصادقة للمثيل المدار.	'AzureAD' 'Paired' 'Windows'
collation	ترتيب المثيل المدار.	string
databaseFormat	يحدد التنسيق الداخلي لقواعد بيانات المثيل الخاصة بإصدار محرك SQL.	'AlwaysUpToDate' 'SQLServer2022' "SQLServer2025"
dnsZonePartner	معرف المورد لمثيل مدار آخر ستشارك منطقة DNS الخاصة به هذا المثيل المدار بعد الإنشاء.	string
hybridSecondaryUsage	الاستخدام الثانوي المختلط. القيم المحتملة هي "Active" (القيمة الافتراضية) و"Passive" (يستخدم العميل الثانوي ك Dr سلبي).	'Active' 'Passive'
instancePoolId	معرف تجمع المثيل الذي ينتمي إليه هذا الخادم المدار.	string
isGeneralPurposeV2	ما إذا كان هذا متغير GPv2 من إصدار الأغراض العامة أم لا.	bool
keyId	CMK URI للمفتاح لاستخدامه للتشفير.	string
licenseType	نوع الترخيص. القيم المحتملة هي "LicenseIncluded" (السعر العادي الذي يشمل ترخيص SQL الجديد) و"BasePrice" (سعر AHB مخفض لإحضار تراخيص SQL الخاصة بك).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	يحدد معرف تكوين الصيانة لتطبيقه على هذا المثيل المدار.	string
managedInstanceCreateMode	تحديد وضع إنشاء قاعدة البيانات. الافتراضي: إنشاء مثيل عادي. استعادة: ينشئ مثيلا عن طريق استعادة مجموعة من النسخ الاحتياطية إلى نقطة زمنية محددة. يجب تحديد RestorePointInTime وS sourceManagedInstanceId.	'Default' 'PointInTimeRestore'
الذاكرةالحجبغيغابايت	حجم الذاكرة بالجيجابايت. الحد الأدنى للقيمة: 28. القيمة القصوى: 870. يعتمد الحد الأدنى والحد الأقصى للقيمة على عدد vCores ومستوى الخدمة. اقرأ المزيد عن حدود الموارد: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	الحد الأدنى من إصدار TLS. القيم المسموح بها: "بلا"، "1.0"، "1.1"، "1.2"	string
pricingModel	نموذج التسعير للمثيل المدار.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	معرف المورد لهوية معينة من قبل المستخدم لاستخدامها بشكل افتراضي.	string
proxyOverride	نوع الاتصال المستخدم للاتصال بالمثيل.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	ما إذا كانت نقطة نهاية البيانات العامة ممكنة أم لا.	bool
requestedBackupStorageRedundancy	نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لهذا المثيل. الخيارات محلية (LocallyRedundantStorage) والمنطقة (ZoneRedundantStorage) و Geo (GeoRedundantStorage) و GeoZone (GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	يحدد منطقة التوفر المنطقية التي تم تثبيت المثيل المدار بها.	'1' '2' '3' 'NoPreference'
restorePointInTime	تحديد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة.	string
servicePrincipal	كيان خدمة المثيل المدار.	ServicePrincipal
sourceManagedInstanceId	معرف المورد للمثيل المدار المصدر المقترن بعملية إنشاء هذا المثيل.	string
storageIOps	وحدات إدخال الإخراج في الثانية للتخزين. الحد الأدنى للقيمة: 300. القيمة القصوى: 80000. زيادات من 1 IOps مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores.	int
storageSizeInGB	حجم التخزين بالجيجابايت. الحد الأدنى للقيمة: 32. القيمة القصوى: 32768. زيادات 32 غيغابايت مسموح بها فقط. تعتمد القيمة القصوى على عائلة الأجهزة المحددة وعدد vCores.	int
storageThroughputMBps	معلمة معدل نقل التخزين MBps غير مدعومة في عملية إنشاء/تحديث المثيل.	int
subnetId	معرف مورد الشبكة الفرعية للمثيل المدار.	string
timezoneId	معرف المنطقة الزمنية. القيم المسموح بها هي المناطق الزمنية التي يدعمها 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. توقيت أوروبا الرسمي".	string
vCores	عدد vCores. القيم المسموح بها: 4 ، 6 ، 8 ، 10 ، 12 ، 16 ، 20 ، 24 ، 32 ، 40 ، 48 ، 56 ، 64 ، 80 ، 96 ، 128. تعتمد vCores المدعومة على عائلة الأجهزة المحددة وطبقة الخدمة.	int
zoneRedundant	ما إذا كان يتم تمكين تكرار المنطقة أم لا.	bool

ResourceIdentity

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

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	نوع كيان الخدمة.	'None' 'SystemAssigned'

Sku

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

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

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

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

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

Module	Description
SQL Managed Instance	وحدة موارد AVM لمثيل SQL المدار

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2025-09-17

مشاركة عبر

Microsoft.Sql managedInstances

تعريف مورد Bicep

تنسيق المورد

قيم الخصائص

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

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

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

نماذج Azure Quickstart

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

تنسيق المورد

قيم الخصائص

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

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

قوالب Azure Quickstart

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

تنسيق المورد

قيم الخصائص

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

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

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

الملاحظات

الموارد الإضافية