Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
- Latest
- 2025-02-01-preview
- 2025-01-01
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
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 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 |
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 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 |
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. |
| 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ü |