Microsoft. Sql managedInstances

Bicep kaynak tanımı

managedInstances kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/managedInstances kaynağı için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Sql/managedInstances@2025-02-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'
  }
}

Özellik Değerleri

Microsoft. Sql/managedInstances

Name Description Value
identity Yönetilen örneğin Azure Active Directory kimliği. ResourceIdentity
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı dize (gerekli)
properties Kaynak özellikleri. ManagedInstanceProperties
sku Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5 (Genel Amaçlı, Standart seri); GP_G8IM (Genel Amaçlı, Premium seri); GP_G8IH (Genel Amaçlı, Premium serisi bellek için optimize edilmiş); BC_Gen5 (İş Açısından Kritik, Standard-Series); BC_G8IM (İş Açısından Kritik, Premium seri); BC_G8IH (İş Açısından Kritik, Premium serisi bellek için iyileştirilmiş). Sku
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Sunucu yöneticisinin türü. 'ActiveDirectory'
azureADOnlyAuthentication Azure Active Directory Yalnızca Authentication etkin. bool
login Sunucu yöneticisinin oturum açma adı. string
principalType Sunucu yöneticisinin Asıl Türü. 'Application'
'Group'
'User'
sid Sunucu yöneticisinin SID (nesne kimliği). string

Constraints:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Yöneticinin Kiracı Kimliği. string

Constraints:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorLogin Yönetilen örnek için yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir). string
administratorLoginPassword Yönetici oturum açma parolası (yönetilen örnek oluşturma için gereklidir). string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.
administrators Azure Active Directory yöneticisi, örnek oluşturma ve örnek güncellemeleri sırasında kullanılabilir, azureADOnlyAuthentication özelliği hariç. azureADOnlyAuthentication özelliğini güncelleştirmek için tek tek API'nin kullanılması gerekir. ManagedInstanceExternalAdministrator
authenticationMetadata Yönetilen örneğin kimlik doğrulaması meta veri arama modu. 'AzureAD'
'Paired'
'Windows'
collation Yönetilen örneğin harmanlanması. string
databaseFormat SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025'
dnsZonePartner Bu yönetilen örneğin dns bölgesi oluşturulduktan sonra paylaşılacak başka bir yönetilen örneğin kaynak kimliği. string
hybridSecondaryUsage Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır). 'Active'
'Passive'
instancePoolId Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği. string
isGeneralPurposeV2 Bunun Genel Amaçlı sürümün GPv2 çeşitlemesi olup olmadığı. bool
keyId Şifreleme için kullanılacak anahtarın CMK URI'si. string
licenseType Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir. string
managedInstanceCreateMode Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
'Default'
'PointInTimeRestore'
bellekBoyutInGB GB cinsinden bellek boyutu. Minimum değer: 28. En büyük değer: 870. En düşük ve en yüksek değer, sanal çekirdek sayısına ve hizmet katmanına bağlıdır. Kaynak sınırları hakkında daha fazla bilgi edinin: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2' string
pricingModel Managed Instance'ın fiyatlandırma modeli. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği. string
proxyOverride Örneğe bağlanmak için kullanılan bağlantı türü. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Genel veri uç noktasının etkinleştirilip etkinleştirilmediği. bool
requestedBackupStorageRedundancy Bu örneğe yönelik yedeklemeleri depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Managed Instance'ın sabitlendiği mantıksal erişilebilirlik bölgesini belirtir. '1'
'2'
'3'
'NoPreference'
restorePointInTime Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir. string
servicePrincipal Yönetilen örneğin hizmet sorumlusu. ServicePrincipal
sourceManagedInstanceId Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı. string
storageIOps Depolama IOps'si. En düşük değer: 300. Maksimum değer: 80000. Yalnızca 1 IOps artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageSizeInGB GB cinsinden depolama boyutu. En düşük değer: 32. En büyük değer: 32768. Yalnızca 32 GB'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageThroughputMBps Depolama aktarım hızı MB/sn parametresi örnek oluşturma/güncelleştirme işleminde desteklenmez. int
subnetId Yönetilen örneğin alt ağ kaynak kimliği. string
timezoneId Saat diliminin kimliği. İzin verilen değerler, Windows tarafından desteklenen zaman dilimleridir.
Windows, desteklenen saat dilimleri, kimlik dahil olmak üzere, kayıt defterinde şu altlıkta
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Saat Dilimleri.
Bu kayıt değerlerini SQL Server üzerinden alabilirsiniz; sys.time_zone_info'dan SELECT ismi AS timezone_id AS SELECT sorgusu yaparak sorgulayabilirsiniz.
Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir.
Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
string
vCores Sanal çekirdek sayısı. İzin verilen değerler: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Desteklenen sanal çekirdekler, seçilen donanım ailesine ve hizmet katmanına bağlıdır. int
zoneRedundant Bölge yedekliliğinin etkinleştirilip etkinleştirilmediği. bool

ResourceIdentity

Name Description Value
type Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory ana özelliği oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Hizmet sorumlusu türü. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Belirli bir SKU'nun kapasitesi. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
size Belirli SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Kullanım Örnekleri

Azure Doğrulanmış Modülleri

Aşağıdaki Azure Doğrulanmış Modüller bu kaynak türünü dağıtmak için kullanılabilir.

Module Description
SQL Managed Instance SQL Managed Instance için AVM Kaynak Modülü

Azure Quickstart Samples

Aşağıdaki Azure Hızlı Başlat şablonları bu kaynak türünü dağıtmak için Bicep örnek içerir.

Bicep Dosyası Description
Yeni sanal ağ içinde SQL MI oluştur Azure Sql Database Managed Instance (SQL MI) yeni Virtual Network içinde deploy edin.

ARM şablonu kaynak tanımı

managedInstances kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/managedInstances kaynağı için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2025-02-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"
  }
}

Özellik Değerleri

Microsoft. Sql/managedInstances

Name Description Value
apiVersion API sürümü '2025-02-01-önizleme'
identity Yönetilen örneğin Azure Active Directory kimliği. ResourceIdentity
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı dize (gerekli)
properties Kaynak özellikleri. ManagedInstanceProperties
sku Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5 (Genel Amaçlı, Standart seri); GP_G8IM (Genel Amaçlı, Premium seri); GP_G8IH (Genel Amaçlı, Premium serisi bellek için optimize edilmiş); BC_Gen5 (İş Açısından Kritik, Standard-Series); BC_G8IM (İş Açısından Kritik, Premium seri); BC_G8IH (İş Açısından Kritik, Premium serisi bellek için iyileştirilmiş). Sku
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
type Kaynak türü 'Microsoft. Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Sunucu yöneticisinin türü. 'ActiveDirectory'
azureADOnlyAuthentication Azure Active Directory Yalnızca Authentication etkin. bool
login Sunucu yöneticisinin oturum açma adı. string
principalType Sunucu yöneticisinin Asıl Türü. 'Application'
'Group'
'User'
sid Sunucu yöneticisinin SID (nesne kimliği). string

Constraints:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Yöneticinin Kiracı Kimliği. string

Constraints:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorLogin Yönetilen örnek için yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir). string
administratorLoginPassword Yönetici oturum açma parolası (yönetilen örnek oluşturma için gereklidir). string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.
administrators Azure Active Directory yöneticisi, örnek oluşturma ve örnek güncellemeleri sırasında kullanılabilir, azureADOnlyAuthentication özelliği hariç. azureADOnlyAuthentication özelliğini güncelleştirmek için tek tek API'nin kullanılması gerekir. ManagedInstanceExternalAdministrator
authenticationMetadata Yönetilen örneğin kimlik doğrulaması meta veri arama modu. 'AzureAD'
'Paired'
'Windows'
collation Yönetilen örneğin harmanlanması. string
databaseFormat SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025'
dnsZonePartner Bu yönetilen örneğin dns bölgesi oluşturulduktan sonra paylaşılacak başka bir yönetilen örneğin kaynak kimliği. string
hybridSecondaryUsage Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır). 'Active'
'Passive'
instancePoolId Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği. string
isGeneralPurposeV2 Bunun Genel Amaçlı sürümün GPv2 çeşitlemesi olup olmadığı. bool
keyId Şifreleme için kullanılacak anahtarın CMK URI'si. string
licenseType Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir. string
managedInstanceCreateMode Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
'Default'
'PointInTimeRestore'
bellekBoyutInGB GB cinsinden bellek boyutu. Minimum değer: 28. En büyük değer: 870. En düşük ve en yüksek değer, sanal çekirdek sayısına ve hizmet katmanına bağlıdır. Kaynak sınırları hakkında daha fazla bilgi edinin: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2' string
pricingModel Managed Instance'ın fiyatlandırma modeli. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği. string
proxyOverride Örneğe bağlanmak için kullanılan bağlantı türü. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Genel veri uç noktasının etkinleştirilip etkinleştirilmediği. bool
requestedBackupStorageRedundancy Bu örneğe yönelik yedeklemeleri depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Managed Instance'ın sabitlendiği mantıksal erişilebilirlik bölgesini belirtir. '1'
'2'
'3'
'NoPreference'
restorePointInTime Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir. string
servicePrincipal Yönetilen örneğin hizmet sorumlusu. ServicePrincipal
sourceManagedInstanceId Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı. string
storageIOps Depolama IOps'si. En düşük değer: 300. Maksimum değer: 80000. Yalnızca 1 IOps artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageSizeInGB GB cinsinden depolama boyutu. En düşük değer: 32. En büyük değer: 32768. Yalnızca 32 GB'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageThroughputMBps Depolama aktarım hızı MB/sn parametresi örnek oluşturma/güncelleştirme işleminde desteklenmez. int
subnetId Yönetilen örneğin alt ağ kaynak kimliği. string
timezoneId Saat diliminin kimliği. İzin verilen değerler, Windows tarafından desteklenen zaman dilimleridir.
Windows, desteklenen saat dilimleri, kimlik dahil olmak üzere, kayıt defterinde şu altlıkta
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Saat Dilimleri.
Bu kayıt değerlerini SQL Server üzerinden alabilirsiniz; sys.time_zone_info'dan SELECT ismi AS timezone_id AS SELECT sorgusu yaparak sorgulayabilirsiniz.
Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir.
Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
string
vCores Sanal çekirdek sayısı. İzin verilen değerler: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Desteklenen sanal çekirdekler, seçilen donanım ailesine ve hizmet katmanına bağlıdır. int
zoneRedundant Bölge yedekliliğinin etkinleştirilip etkinleştirilmediği. bool

ResourceIdentity

Name Description Value
type Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory ana özelliği oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Hizmet sorumlusu türü. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Belirli bir SKU'nun kapasitesi. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
size Belirli SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Kullanım Örnekleri

Azure Quickstart Şablonları

Aşağıdaki Azure Hızlı başlat şablonları bu kaynak tipini dağıtır.

Template Description
Yeni sanal ağ içinde SQL MI oluştur

Azure
Azure Sql Database Managed Instance (SQL MI) yeni Virtual Network içinde deploy edin.
Loglar ve metriklerin yapılandırılmış gönderimiyle SQL MI oluştur

Azure
Bu şablon, günlükleri ve ölçümleri (tanılama çalışma alanı, depolama hesabı, olay hub'ı) depolamak için kullanılan SQL MI ve ek kaynakları dağıtmanıza olanak tanır.
Yeni sanal ağ içinde jumpbox ile SQL MI oluştur

Azure
Azure Sql Database Managed Instance (SQL MI) ve JumpBox'u SSMS ile yeni Virtual Network içinde dağıtın.
Noktadan-siteye bağlantı yapılandırılmış SQL MI oluştur

Azure
Yeni sanal ağ içinde noktadan siteye bağlantı için yapılandırılmış Azure Sql Database Managed Instance (SQL MI) ve Virtual ağ geçidi'ni dağıtın.
Networking

Azure
UDR ve NSG'yi Azure SQL Managed Instance'ı desteklemek ve Managed Instance'ı dağıtmak için deploy et

Terraform (AzAPI sağlayıcısı) kaynak tanımı

managedInstances kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/managedInstances kaynağı için aşağıdaki Terraform'u şablonunuza ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2025-02-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"
    }
  }
}

Özellik Değerleri

Microsoft. Sql/managedInstances

Name Description Value
identity Yönetilen örneğin Azure Active Directory kimliği. ResourceIdentity
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı dize (gerekli)
properties Kaynak özellikleri. ManagedInstanceProperties
sku Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5 (Genel Amaçlı, Standart seri); GP_G8IM (Genel Amaçlı, Premium seri); GP_G8IH (Genel Amaçlı, Premium serisi bellek için optimize edilmiş); BC_Gen5 (İş Açısından Kritik, Standard-Series); BC_G8IM (İş Açısından Kritik, Premium seri); BC_G8IH (İş Açısından Kritik, Premium serisi bellek için iyileştirilmiş). Sku
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
type Kaynak türü "Microsoft. Sql/managedInstances@2025-02-01-önizleme"

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Sunucu yöneticisinin türü. 'ActiveDirectory'
azureADOnlyAuthentication Azure Active Directory Yalnızca Authentication etkin. bool
login Sunucu yöneticisinin oturum açma adı. string
principalType Sunucu yöneticisinin Asıl Türü. 'Application'
'Group'
'User'
sid Sunucu yöneticisinin SID (nesne kimliği). string

Constraints:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Yöneticinin Kiracı Kimliği. string

Constraints:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorLogin Yönetilen örnek için yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir). string
administratorLoginPassword Yönetici oturum açma parolası (yönetilen örnek oluşturma için gereklidir). string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.
administrators Azure Active Directory yöneticisi, örnek oluşturma ve örnek güncellemeleri sırasında kullanılabilir, azureADOnlyAuthentication özelliği hariç. azureADOnlyAuthentication özelliğini güncelleştirmek için tek tek API'nin kullanılması gerekir. ManagedInstanceExternalAdministrator
authenticationMetadata Yönetilen örneğin kimlik doğrulaması meta veri arama modu. 'AzureAD'
'Paired'
'Windows'
collation Yönetilen örneğin harmanlanması. string
databaseFormat SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025'
dnsZonePartner Bu yönetilen örneğin dns bölgesi oluşturulduktan sonra paylaşılacak başka bir yönetilen örneğin kaynak kimliği. string
hybridSecondaryUsage Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır). 'Active'
'Passive'
instancePoolId Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği. string
isGeneralPurposeV2 Bunun Genel Amaçlı sürümün GPv2 çeşitlemesi olup olmadığı. bool
keyId Şifreleme için kullanılacak anahtarın CMK URI'si. string
licenseType Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir. string
managedInstanceCreateMode Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
'Default'
'PointInTimeRestore'
bellekBoyutInGB GB cinsinden bellek boyutu. Minimum değer: 28. En büyük değer: 870. En düşük ve en yüksek değer, sanal çekirdek sayısına ve hizmet katmanına bağlıdır. Kaynak sınırları hakkında daha fazla bilgi edinin: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2' string
pricingModel Managed Instance'ın fiyatlandırma modeli. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği. string
proxyOverride Örneğe bağlanmak için kullanılan bağlantı türü. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Genel veri uç noktasının etkinleştirilip etkinleştirilmediği. bool
requestedBackupStorageRedundancy Bu örneğe yönelik yedeklemeleri depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Managed Instance'ın sabitlendiği mantıksal erişilebilirlik bölgesini belirtir. '1'
'2'
'3'
'NoPreference'
restorePointInTime Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir. string
servicePrincipal Yönetilen örneğin hizmet sorumlusu. ServicePrincipal
sourceManagedInstanceId Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı. string
storageIOps Depolama IOps'si. En düşük değer: 300. Maksimum değer: 80000. Yalnızca 1 IOps artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageSizeInGB GB cinsinden depolama boyutu. En düşük değer: 32. En büyük değer: 32768. Yalnızca 32 GB'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageThroughputMBps Depolama aktarım hızı MB/sn parametresi örnek oluşturma/güncelleştirme işleminde desteklenmez. int
subnetId Yönetilen örneğin alt ağ kaynak kimliği. string
timezoneId Saat diliminin kimliği. İzin verilen değerler, Windows tarafından desteklenen zaman dilimleridir.
Windows, desteklenen saat dilimleri, kimlik dahil olmak üzere, kayıt defterinde şu altlıkta
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Saat Dilimleri.
Bu kayıt değerlerini SQL Server üzerinden alabilirsiniz; sys.time_zone_info'dan SELECT ismi AS timezone_id AS SELECT sorgusu yaparak sorgulayabilirsiniz.
Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir.
Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
string
vCores Sanal çekirdek sayısı. İzin verilen değerler: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Desteklenen sanal çekirdekler, seçilen donanım ailesine ve hizmet katmanına bağlıdır. int
zoneRedundant Bölge yedekliliğinin etkinleştirilip etkinleştirilmediği. bool

ResourceIdentity

Name Description Value
type Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory ana özelliği oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Hizmet sorumlusu türü. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Belirli bir SKU'nun kapasitesi. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
size Belirli SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Kullanım Örnekleri

Azure Doğrulanmış Modülleri

Aşağıdaki Azure Doğrulanmış Modüller bu kaynak türünü dağıtmak için kullanılabilir.

Module Description
SQL Managed Instance SQL Managed Instance için AVM Kaynak Modülü