Microsoft.Sql managedInstances

Makale
2025-05-06

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

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

resource symbolicname 'Microsoft.Sql/managedInstances@2024-05-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'
    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'
    totalMemoryMB: int
    vCores: int
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Özellik Değerleri

ManagedInstanceExternalAdministrator

İsim	Açıklama	Değer
administratorType	Sunucu yöneticisinin türü.	'ActiveDirectory'
azureADOnlyAuthentication	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.	Boole
oturum aç	Sunucu yöneticisinin oturum açma adı.	String
principalTürü	Sunucu yöneticisinin Asıl Türü.	'Uygulama' 'Grup' 'Kullanıcı'
sıd	Sunucu yöneticisinin SID (nesne kimliği).	karakter dizisi Kısıtlama -ları: En az uzunluk = 36 Maksimum uzunluk = 36 Desen = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
kiracıKimliği	Yöneticinin Kiracı Kimliği.	karakter dizisi Kısıtlama -ları: 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

İsim	Açıklama	Değer
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).	karakter dizisi Kısıtlama -ları: Hassas değer. Güvenli parametre olarak geçirin.
Yöneticiler	Örneğin Azure Active Directory yöneticisi. Bu yalnızca örnek oluşturma zamanında kullanılabilir. Örneğin güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir.	ManagedInstanceExternalAdministrator
authenticationMetadata	Yönetilen örneğin kimlik doğrulaması meta veri arama modu.	'AzureAD' 'Eşleştirilmiş' 'Windows'
Harmanlama	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'
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).	'Etkin' 'Pasif'
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ığı.	Boole
keyId	Şifreleme için kullanılacak anahtarın CMK URI'si.	String
lisansTürü	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.	'Varsayılan' 'PointInTimeRestore'
minimalTlsVersion	En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2'	String
fiyatlandırma modeli	Yönetilen Örneğin fiyatlandırma modeli.	'Freemium' 'Normal'
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ü.	'Varsayılan' 'Proxy' 'Yeniden Yönlendirme'
publicDataEndpointEnabled	Genel veri uç noktasının etkinleştirilip etkinleştirilmediği.	Boole
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' 'Yerel' 'Bölge'
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. 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. Maksimum değer: 16384. 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 saat dilimleridir. Windows, kimlik de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları kayıt defterinde KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak BU kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz. 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
totalMemoryMB	MB cinsinden toplam bellek. En düşük değer: 7168. En yüksek değer: 891328. Yalnızca 1 MB'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
sanal çekirdekler	Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80.	Int
zoneRedundant	multi-az'nin etkinleştirilip etkinleştirilmediği.	Boole

Microsoft.Sql/managedInstances

İsim	Açıklama	Değer
kimlik	Yönetilen örneğin Azure Active Directory kimliği.	ResourceIdentity
konum	Kaynak konumu.	dize (gerekli)
isim	Kaynak adı	dize (gerekli)
özellikler	Kaynak özellikleri.	ManagedInstanceProperties
Stok Kod/Ürün Kodu	Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH	Sku
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

ResourceIdentity

İsim	Açıklama	Değer
tür	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.	'Hiçbiri' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
kullanıcı tarafından atanan kimlikler	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

İsim	Açıklama	Değer

Hizmet İlkesi (ServicePrincipal)

İsim	Açıklama	Değer
tür	Hizmet sorumlusu türü.	'Hiçbiri' 'SystemAssigned'

Sku

İsim	Açıklama	Değer
kapasite	Belirli bir SKU'nun kapasitesi.	Int
aile	Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir.	String
isim	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.	dize (gerekli)
boyut	Belirli SKU'nun boyutu	String
seviye	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.	String

TrackedResourceTags

İsim	Açıklama	Değer

Kullanıcı Kimliği

İsim	Açıklama	Değer

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.

Modül	Açıklama
SQL Yönetilen Örneği	SQL Yönetilen Örneği için AVM Kaynak Modülü

Azure Hızlı Başlangıç Örnekleri

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

Bicep Dosyası	Açıklama
yeni sanal ağ içinde SQL MI oluşturma	Azure Sql Veritabanı Yönetilen Örneği'ni (SQL MI) yeni Sanal Ağ içinde dağıtın.

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

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

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-05-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",
    "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",
    "totalMemoryMB": "int",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Özellik Değerleri

ManagedInstanceExternalAdministrator

İsim	Açıklama	Değer
administratorType	Sunucu yöneticisinin türü.	'ActiveDirectory'
azureADOnlyAuthentication	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.	Boole
oturum aç	Sunucu yöneticisinin oturum açma adı.	String
principalTürü	Sunucu yöneticisinin Asıl Türü.	'Uygulama' 'Grup' 'Kullanıcı'
sıd	Sunucu yöneticisinin SID (nesne kimliği).	karakter dizisi Kısıtlama -ları: En az uzunluk = 36 Maksimum uzunluk = 36 Desen = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
kiracıKimliği	Yöneticinin Kiracı Kimliği.	karakter dizisi Kısıtlama -ları: 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

İsim	Açıklama	Değer
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).	karakter dizisi Kısıtlama -ları: Hassas değer. Güvenli parametre olarak geçirin.
Yöneticiler	Örneğin Azure Active Directory yöneticisi. Bu yalnızca örnek oluşturma zamanında kullanılabilir. Örneğin güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir.	ManagedInstanceExternalAdministrator
authenticationMetadata	Yönetilen örneğin kimlik doğrulaması meta veri arama modu.	'AzureAD' 'Eşleştirilmiş' 'Windows'
Harmanlama	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'
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).	'Etkin' 'Pasif'
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ığı.	Boole
keyId	Şifreleme için kullanılacak anahtarın CMK URI'si.	String
lisansTürü	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.	'Varsayılan' 'PointInTimeRestore'
minimalTlsVersion	En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2'	String
fiyatlandırma modeli	Yönetilen Örneğin fiyatlandırma modeli.	'Freemium' 'Normal'
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ü.	'Varsayılan' 'Proxy' 'Yeniden Yönlendirme'
publicDataEndpointEnabled	Genel veri uç noktasının etkinleştirilip etkinleştirilmediği.	Boole
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' 'Yerel' 'Bölge'
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. 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. Maksimum değer: 16384. 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 saat dilimleridir. Windows, kimlik de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları kayıt defterinde KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak BU kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz. 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
totalMemoryMB	MB cinsinden toplam bellek. En düşük değer: 7168. En yüksek değer: 891328. Yalnızca 1 MB'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
sanal çekirdekler	Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80.	Int
zoneRedundant	multi-az'nin etkinleştirilip etkinleştirilmediği.	Boole

Microsoft.Sql/managedInstances

İsim	Açıklama	Değer
apiVersiyonu	API sürümü	'2024-05-01-preview'
kimlik	Yönetilen örneğin Azure Active Directory kimliği.	ResourceIdentity
konum	Kaynak konumu.	dize (gerekli)
isim	Kaynak adı	dize (gerekli)
özellikler	Kaynak özellikleri.	ManagedInstanceProperties
Stok Kod/Ürün Kodu	Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH	Sku
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
tür	Kaynak türü	'Microsoft.Sql/managedInstances'

ResourceIdentity

İsim	Açıklama	Değer
tür	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.	'Hiçbiri' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
kullanıcı tarafından atanan kimlikler	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

İsim	Açıklama	Değer

Hizmet İlkesi (ServicePrincipal)

İsim	Açıklama	Değer
tür	Hizmet sorumlusu türü.	'Hiçbiri' 'SystemAssigned'

Sku

İsim	Açıklama	Değer
kapasite	Belirli bir SKU'nun kapasitesi.	Int
aile	Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir.	String
isim	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.	dize (gerekli)
boyut	Belirli SKU'nun boyutu	String
seviye	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.	String

TrackedResourceTags

İsim	Açıklama	Değer

Kullanıcı Kimliği

İsim	Açıklama	Değer

Kullanım Örnekleri

Azure Hızlı Başlangıç Şablonları

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak.

Şablon	Açıklama
yeni sanal ağ içinde SQL MI oluşturma	Azure Sql Veritabanı Yönetilen Örneği'ni (SQL MI) yeni Sanal Ağ içinde dağıtın.
Günlüklerin ve ölçümlerin yapılandırılmış gönderilmesiyle SQL MI oluşturma	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 sıçrama kutusuyla SQL MI oluşturma	Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve JumpBox'ı yeni Sanal Ağ içinde SSMS ile dağıtın.
Noktadan siteye bağlantı yapılandırılmış SQL MI oluşturma	Yeni sanal ağ içinde noktadan siteye bağlantı için yapılandırılmış Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve Sanal ağ geçidi dağıtın.
Ağ ile SQL Yönetilen Örneği Dağıtma	Azure SQL Yönetilen Örneği'ni desteklemek için UDR ve NSG dağıtma ve Yönetilen Örneği dağıtma

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-05-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"
      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"
      totalMemoryMB = int
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Özellik Değerleri

ManagedInstanceExternalAdministrator

İsim	Açıklama	Değer
administratorType	Sunucu yöneticisinin türü.	'ActiveDirectory'
azureADOnlyAuthentication	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.	Boole
oturum aç	Sunucu yöneticisinin oturum açma adı.	String
principalTürü	Sunucu yöneticisinin Asıl Türü.	'Uygulama' 'Grup' 'Kullanıcı'
sıd	Sunucu yöneticisinin SID (nesne kimliği).	karakter dizisi Kısıtlama -ları: En az uzunluk = 36 Maksimum uzunluk = 36 Desen = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
kiracıKimliği	Yöneticinin Kiracı Kimliği.	karakter dizisi Kısıtlama -ları: 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

İsim	Açıklama	Değer
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).	karakter dizisi Kısıtlama -ları: Hassas değer. Güvenli parametre olarak geçirin.
Yöneticiler	Örneğin Azure Active Directory yöneticisi. Bu yalnızca örnek oluşturma zamanında kullanılabilir. Örneğin güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir.	ManagedInstanceExternalAdministrator
authenticationMetadata	Yönetilen örneğin kimlik doğrulaması meta veri arama modu.	'AzureAD' 'Eşleştirilmiş' 'Windows'
Harmanlama	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'
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).	'Etkin' 'Pasif'
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ığı.	Boole
keyId	Şifreleme için kullanılacak anahtarın CMK URI'si.	String
lisansTürü	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.	'Varsayılan' 'PointInTimeRestore'
minimalTlsVersion	En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2'	String
fiyatlandırma modeli	Yönetilen Örneğin fiyatlandırma modeli.	'Freemium' 'Normal'
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ü.	'Varsayılan' 'Proxy' 'Yeniden Yönlendirme'
publicDataEndpointEnabled	Genel veri uç noktasının etkinleştirilip etkinleştirilmediği.	Boole
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' 'Yerel' 'Bölge'
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. 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. Maksimum değer: 16384. 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 saat dilimleridir. Windows, kimlik de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları kayıt defterinde KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak BU kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz. 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
totalMemoryMB	MB cinsinden toplam bellek. En düşük değer: 7168. En yüksek değer: 891328. Yalnızca 1 MB'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
sanal çekirdekler	Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80.	Int
zoneRedundant	multi-az'nin etkinleştirilip etkinleştirilmediği.	Boole

Microsoft.Sql/managedInstances

İsim	Açıklama	Değer
kimlik	Yönetilen örneğin Azure Active Directory kimliği.	ResourceIdentity
konum	Kaynak konumu.	dize (gerekli)
isim	Kaynak adı	dize (gerekli)
özellikler	Kaynak özellikleri.	ManagedInstanceProperties
Stok Kod/Ürün Kodu	Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH	Sku
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü.
tür	Kaynak türü	"Microsoft.Sql/managedInstances@2024-05-01-preview"

ResourceIdentity

İsim	Açıklama	Değer
tür	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.	'Hiçbiri' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
kullanıcı tarafından atanan kimlikler	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

İsim	Açıklama	Değer

Hizmet İlkesi (ServicePrincipal)

İsim	Açıklama	Değer
tür	Hizmet sorumlusu türü.	'Hiçbiri' 'SystemAssigned'

Sku

İsim	Açıklama	Değer
kapasite	Belirli bir SKU'nun kapasitesi.	Int
aile	Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir.	String
isim	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.	dize (gerekli)
boyut	Belirli SKU'nun boyutu	String
seviye	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.	String

TrackedResourceTags

İsim	Açıklama	Değer

Kullanıcı Kimliği

İsim	Açıklama	Değer

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.

Modül	Açıklama
SQL Yönetilen Örneği	SQL Yönetilen Örneği için AVM Kaynak Modülü

Aracılığıyla paylaş

Microsoft.Sql managedInstances

Bicep kaynak tanımı

Kaynak biçimi

Özellik Değerleri

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

Microsoft.Sql/managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

Hizmet İlkesi (ServicePrincipal)

Sku

TrackedResourceTags

Kullanıcı Kimliği

Kullanım Örnekleri

Azure Doğrulanmış Modülleri

Azure Hızlı Başlangıç Örnekleri

ARM şablonu kaynak tanımı

Kaynak biçimi

Özellik Değerleri

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

Microsoft.Sql/managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

Hizmet İlkesi (ServicePrincipal)

Sku

TrackedResourceTags

Kullanıcı Kimliği

Kullanım Örnekleri

Azure Hızlı Başlangıç Şablonları

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

Kaynak biçimi

Özellik Değerleri

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

Microsoft.Sql/managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

Hizmet İlkesi (ServicePrincipal)

Sku

TrackedResourceTags

Kullanıcı Kimliği

Kullanım Örnekleri

Azure Doğrulanmış Modülleri

Geri Bildirim

Ek kaynaklar