Microsoft.Sql managedInstances

Makale
03/05/2024

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

Özellik değerleri

managedInstances

Ad	Açıklama	Değer
name	Kaynak adı	dize (gerekli) Karakter sınırı: 1-63 Geçerli karakterler: Küçük harfler, rakamlar ve kısa çizgiler. Kısa çizgiyle başlayamaz veya bitemez. Kaynak adı Azure genelinde benzersiz olmalıdır.
location	Kaynak konumu.	dize (gerekli)
etiketler	Kaynak etiketleri.	Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler
Sku	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
identity	Yönetilen örneğin Azure Active Directory kimliği.	ResourceIdentity
properties	Kaynak özellikleri.	ManagedInstanceProperties

ResourceIdentity

Ad	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.	'Yok' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		UserIdentity

UserIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermez. Tüm özellikler Salt Okunur'dır.

ManagedInstanceProperties

Ad	Açıklama	Değer
administratorLogin	Yönetilen örneğ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şturmak için gereklidir).	string 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. Örnek 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 örnek oluşturulduktan sonra DNS bölgesi paylaşılacak olan 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'tir (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ün GPv2 çeşidi olup olmadığı.	bool
keyId	Şifreleme için kullanılacak anahtarın CMK URI'si.	string
licenseType	Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (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: 'Yok', '1.0', '1.1', '1.2'	string
pricingModel	Hava durumu veya Yönetilen Örnek değil freemium'dır.	'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.	bool
requestedBackupStorageRedundancy	Bu örneğin yedeklerini 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: 120. En yüksek değer: 120000. Yalnızca 1 IOps'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
storageSizeInGB	GB cinsinden depolama boyutu. En düşük değer: 32. En yüksek değer: 16384. Yalnızca 32 GB artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.	int
storageThroughputMBps	MB/sn'de depolama aktarım hızı. En düşük değer: 25. Maksimum değer: 4000. Yalnızca 1 MB/sn artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.	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
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.	bool

ManagedInstanceExternalAdministrator

Ad	Açıklama	Değer
administratorType	Sunucu yöneticisinin türü.	'ActiveDirectory'
azureADOnlyAuthentication	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.	bool
oturum aç	Sunucu yöneticisinin oturum açma adı.	string
principalType	Sunucu yöneticisinin Asıl Türü.	'Uygulama' 'Grup' 'Kullanıcı'
Sid	Sunucu yöneticisinin SID (nesne kimliği).	string 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}$`
tenantId	Yöneticinin kiracı kimliği.	string 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}$`

ServicePrincipal

Ad	Açıklama	Değer
tür	Hizmet sorumlusu türü.	'Yok' 'SystemAssigned'

Sku

Ad	Açıklama	Değer
capacity	Belirli bir SKU'nun kapasitesi.	int
aile	Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir.	string
name	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.	dize (gerekli)
boyut	Belirli bir SKU'nun boyutu	string
tier	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.	string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Description
Ağ ile SQL Yönetilen Örneği dağıtma	Azure SQL Yönetilen Örneği desteklemek ve Yönetilen Örneği dağıtmak için UDR ve NSG dağıtma
Yeni sanal ağ içinde SQL MI oluşturma	Azure Sql Veritabanı Yönetilen Örneği'ni (SQL MI) yeni Sanal Ağ 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 kutusu ile SQL MI oluşturma	Yeni Sanal Ağ içinde SSMS ile Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve JumpBox'ı 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çidini 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": "2023-05-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "ActiveDirectory",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

Özellik değerleri

managedInstances

Ad	Açıklama	Değer
tür	Kaynak türü	'Microsoft.Sql/managedInstances'
apiVersion	Kaynak API'sinin sürümü	'2023-05-01-preview'
name	Kaynak adı	dize (gerekli) Karakter sınırı: 1-63 Geçerli karakterler: Küçük harfler, rakamlar ve kısa çizgiler. Kısa çizgiyle başlayamaz veya bitemez. Kaynak adı Azure genelinde benzersiz olmalıdır.
location	Kaynak konumu.	dize (gerekli)
etiketler	Kaynak etiketleri.	Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler
Sku	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
identity	Yönetilen örneğin Azure Active Directory kimliği.	ResourceIdentity
properties	Kaynak özellikleri.	ManagedInstanceProperties

ResourceIdentity

Ad	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.	'Yok' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		UserIdentity

UserIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermez. Tüm özellikler Salt Okunur'dır.

ManagedInstanceProperties

Ad	Açıklama	Değer
administratorLogin	Yönetilen örneğ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şturmak için gereklidir).	string 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. Örnek 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şlendi' '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 oluşturulduktan sonra DNS bölgesini paylaşacağı 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'tir (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ün GPv2 çeşidi olup olmadığı.	bool
keyId	Şifreleme için kullanılacak anahtarın CMK URI'si.	string
licenseType	Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (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: 'Yok', '1.0', '1.1', '1.2'	string
pricingModel	Hava durumu veya Yönetilen Örnek değil freemium'dır.	'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.	bool
requestedBackupStorageRedundancy	Bu örneğin yedeklerini 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: 120. En yüksek değer: 120000. Yalnızca 1 IOps'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
storageSizeInGB	GB cinsinden depolama boyutu. En düşük değer: 32. En yüksek değer: 16384. Yalnızca 32 GB artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.	int
storageThroughputMBps	MB/sn'de depolama aktarım hızı. En düşük değer: 25. Maksimum değer: 4000. Yalnızca 1 MB/sn artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.	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
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.	bool

ManagedInstanceExternalAdministrator

Ad	Açıklama	Değer
administratorType	Sunucu yöneticisinin türü.	'ActiveDirectory'
azureADOnlyAuthentication	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.	bool
oturum aç	Sunucu yöneticisinin oturum açma adı.	string
principalType	Sunucu yöneticisinin Asıl Türü.	'Uygulama' 'Grup' 'Kullanıcı'
Sid	Sunucu yöneticisinin SID (nesne kimliği).	string 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}$`
tenantId	Yöneticinin kiracı kimliği.	string 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}$`

ServicePrincipal

Ad	Açıklama	Değer
tür	Hizmet sorumlusu türü.	'Yok' 'SystemAssigned'

Sku

Ad	Açıklama	Değer
capacity	Belirli bir SKU'nun kapasitesi.	int
aile	Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir.	string
name	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.	dize (gerekli)
boyut	Belirli bir SKU'nun boyutu	string
tier	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.	string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Description
Ağ ile SQL Yönetilen Örneği dağıtma	Azure SQL Yönetilen Örneği desteklemek ve Yönetilen Örneği dağıtmak için UDR ve NSG dağıtma
Yeni sanal ağ içinde SQL MI oluşturma	Azure Sql Veritabanı Yönetilen Örneği'ni (SQL MI) yeni Sanal Ağ 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 kutusu ile SQL MI oluşturma	Yeni Sanal Ağ içinde SSMS ile Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve JumpBox'ı 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çidini dağıtın.

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

Özellik değerleri

managedInstances

Ad	Açıklama	Değer
tür	Kaynak türü	"Microsoft.Sql/managedInstances@2023-05-01-preview"
name	Kaynak adı	dize (gerekli) Karakter sınırı: 1-63 Geçerli karakterler: Küçük harfler, rakamlar ve kısa çizgiler. Kısa çizgiyle başlayamaz veya bitemez. Kaynak adı Azure genelinde benzersiz olmalıdır.
location	Kaynak konumu.	dize (gerekli)
parent_id	Bir kaynak grubuna dağıtmak için bu kaynak grubunun kimliğini kullanın.	dize (gerekli)
etiketler	Kaynak etiketleri.	Etiket adlarının ve değerlerinin sözlüğü.
Sku	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
identity	Yönetilen örneğin Azure Active Directory kimliği.	ResourceIdentity
properties	Kaynak özellikleri.	ManagedInstanceProperties

ResourceIdentity

Ad	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.	"SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned"
identity_ids	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri	Kullanıcı kimliği kimlikleri dizisi.

ResourceIdentityUserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		UserIdentity

UserIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermez. Tüm özellikler Salt Okunur'dır.

ManagedInstanceProperties

Ad	Açıklama	Değer
administratorLogin	Yönetilen örneğ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şturmak için gereklidir).	string 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. Örnek 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 oluşturulduktan sonra DNS bölgesini paylaşacağı başka bir yönetilen örneğin kaynak kimliği.	string
hybridSecondaryUsage	Karma ikincil kullanım. Olası değerler şunlardır: 'Etkin' (varsayılan değer) ve 'Pasif' (müşteri ikincili 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ü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: 'LicenseIncluded' (yeni SQL lisansı dahil 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: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Hava durumu veya Yönetilen Örnek değildir, freemium'dır.	"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.	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)	"Coğrafi" "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: 120. Maksimum değer: 120000. Yalnızca 1 IOps'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
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	MB/sn'de depolama aktarım hızı. En düşük değer: 25. Maksimum değer: 4000. Yalnızca 1 MB/sn'lik artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.	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, kimliği 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 alınabilir. Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".	string
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.	bool

ManagedInstanceExternalAdministrator

Ad	Açıklama	Değer
administratorType	Sunucu yöneticisinin türü.	"ActiveDirectory"
azureADOnlyAuthentication	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.	bool
oturum aç	Sunucu yöneticisinin oturum açma adı.	string
principalType	Sunucu yöneticisinin Asıl Türü.	"Uygulama" "Grup" "Kullanıcı"
Sid	Sunucu yöneticisinin SID (nesne kimliği).	string 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}$`
tenantId	Yöneticinin kiracı kimliği.	string 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}$`

ServicePrincipal

Ad	Açıklama	Değer
tür	Hizmet sorumlusu türü.	"Hiçbiri" "SystemAssigned"

Sku

Ad	Açıklama	Değer
capacity	Belirli bir SKU'nun kapasitesi.	int
aile	Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir.	string
name	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.	dize (gerekli)
boyut	Belirli bir SKU'nun boyutu	string
tier	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.	string

Aracılığıyla paylaş

Microsoft.Sql managedInstances

Bicep kaynak tanımı

Kaynak biçimi

Özellik değerleri

managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

UserIdentity

ManagedInstanceProperties

ManagedInstanceExternalAdministrator

ServicePrincipal

Sku

Hızlı başlangıç şablonları

ARM şablonu kaynak tanımı

Kaynak biçimi

Özellik değerleri

managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

UserIdentity

ManagedInstanceProperties

ManagedInstanceExternalAdministrator

ServicePrincipal

Sku

Hızlı başlangıç şablonları

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

Kaynak biçimi

Özellik değerleri

managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

UserIdentity

ManagedInstanceProperties

ManagedInstanceExternalAdministrator

ServicePrincipal

Sku

Geri Bildirim

Ek kaynaklar