Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
- Latest
- 2026-08-01-preview
- 2025-08-01-preview
- 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
Definisi sumber daya Bicep
Jenis sumber daya managedInstances dapat disebarkan dengan operasi yang menargetkan:
- Grup sumber daya
- Lihat perintah penyebaran grup sumber daya
Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.
Contoh Penggunaan
Modul Terverifikasi Azure
Modul Terverifikasi Azure berikut dapat digunakan untuk menyebarkan jenis sumber daya ini.
| Module | Description |
|---|---|
| Instans Terkelola SQL | Modul Sumber Daya AVM untuk SQL Managed Instance |
Sampel Mulai Cepat Azure
Templat Mulai Cepat Azure berikut berisi Bicep sampel untuk menyebarkan jenis sumber daya ini.
| File Bicep | Description |
|---|---|
| Buat SQL MI di dalam jaringan virtual baru | Sebarkan Azure Sql Database Managed Instance (SQL MI) di dalam Virtual Network baru. |
Format sumber daya
Untuk membuat Microsoft. Sql/managedInstances, tambahkan Bicep berikut ke templat Anda.
resource symbolicname 'Microsoft.Sql/managedInstances@2026-08-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'
}
}
Nilai Properti
Microsoft. SQL/managedInstances
| Name | Description | Value |
|---|---|---|
| identitas | Identitas Azure Active Directory dari instans terkelola. | ResourceIdentity |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| name | Nama sumber daya | string (diperlukan) |
| properties | Properti sumber daya. | ManagedInstanceProperties |
| sku | SKU instans terkelola. Nilai yang diizinkan untuk sku.name: GP_Gen5 (Tujuan Umum, Seri Standar); GP_G8IM (Tujuan Umum, Seri Premium); GP_G8IH (Tujuan Umum, memori seri Premium dioptimalkan); BC_Gen5 (Kritis Bisnis, Standard-Series); BC_G8IM (Business Critical, Premium-series); BC_G8IH (Business Critical, memori seri Premium dioptimalkan). | Sku |
| tags | Tag sumber daya | Kamus nama dan nilai tag. Lihat Tag dalam templat |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Jenis administrator sever. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Hanya Azure Active Directory Autentikasi diaktifkan. | bool |
| login | Nama masuk administrator server. | string |
| principalType | Jenis Utama administrator sever. | 'Application' 'Group' 'User' |
| sid | SID (ID objek) administrator server. | string Constraints: Panjang min = 36 Panjang maksimum = 36 Pola = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID penyewa administrator. | string Constraints: Panjang min = 36 Panjang maksimum = 36 Pola = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Nama pengguna administrator untuk instans terkelola. Hanya dapat ditentukan ketika instans terkelola sedang dibuat (dan diperlukan untuk pembuatan). | string |
| administratorLoginPassword | Kata sandi masuk administrator (diperlukan untuk pembuatan instans terkelola). | string Constraints: Nilai sensitif. Teruskan sebagai parameter aman. |
| administrators | Administrator Azure Active Directory dapat digunakan selama pembuatan instans dan untuk pembaruan instans, kecuali untuk properti azureADOnlyAuthentication. Untuk memperbarui properti azureADOnlyAuthentication, API individual harus digunakan. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Mode pencarian metadata autentikasi instans terkelola. | 'AzureAD' 'Paired' 'Windows' |
| kolase | Kolasasi instans terkelola. | string |
| databaseFormat | Menentukan format internal database instans khusus untuk versi mesin SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | Id sumber daya instans terkelola lain yang zona DNS-nya akan dibagikan instans terkelola ini setelah pembuatan. | string |
| hybridSecondaryUsage | Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif). | 'Active' 'Passive' |
| instancePoolId | Id kumpulan instans tempat server terkelola ini berada. | string |
| isGeneralPurposeV2 | Apakah ini adalah varian GPv2 edisi Tujuan Umum atau tidak. | bool |
| keyId | URI CMK kunci yang akan digunakan untuk enkripsi. | string |
| licenseType | Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini. | string |
| managedInstanceCreateMode | Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Ukuran memori dalam GB. Nilai minimum: 28. Nilai maksimum: 870. Nilai minimum dan maksimum bergantung pada jumlah vCore dan tingkat layanan. Baca selengkapnya tentang batas sumber daya: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Versi TLS minimal. Nilai yang diizinkan: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | Model penetapan harga Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default. | string |
| proxyOverride | Jenis koneksi yang digunakan untuk menyambungkan ke instans. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Apakah titik akhir data publik diaktifkan atau tidak. | bool |
| requestedBackupStorageRedundancy | Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zona (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone (GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Menentukan zona ketersediaan logis yang disematkan Managed Instance. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru. | string |
| servicePrincipal | Perwakilan layanan instans terkelola. | ServicePrincipal |
| sourceManagedInstanceId | Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini. | string |
| storageIOps | IOps penyimpanan. Nilai minimum: 300. Nilai maksimum: 80000. Kenaikan 1 IOps hanya diizinkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. | int |
| storageSizeInGB | Ukuran penyimpanan dalam GB. Nilai minimum: 32. Nilai maksimum: 32768. Kenaikan 32 GB hanya diperbolehkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. | int |
| storageThroughputMBps | Parameter MBps throughput penyimpanan tidak didukung dalam operasi buat/perbarui instans. | int |
| subnetId | ID sumber daya subnet untuk instans terkelola. | string |
| timezoneId | Id zona waktu. Nilai yang diizinkan adalah zona waktu yang didukung oleh Windows. Windows menyimpan detail tentang zona waktu yang didukung, termasuk id, di registri di bawah KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zona Waktu. Anda bisa mendapatkan nilai registri tersebut melalui SQL Server dengan mengkueri SELECT name AS timezone_id FROM sys.time_zone_info. Daftar Id juga dapat diperoleh dengan mengeksekusi [System.TimeZoneInfo]::GetSystemTimeZones() di PowerShell. Contoh id zona waktu yang valid adalah "Waktu Standar Pasifik" atau "W. Waktu Standar Eropa". |
string |
| vCores | Jumlah vCore. Nilai yang diizinkan: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. vCore yang didukung bergantung pada keluarga perangkat keras dan tingkat layanan yang dipilih. | int |
| zoneRedundant | Apakah redundansi zona diaktifkan atau tidak. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| jenis | Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| jenis | Jenis perwakilan layanan. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| kapasitas | Kapasitas SKU tertentu. | int |
| family | Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. | string |
| name | Nama SKU, biasanya, kode huruf + Angka, misalnya P3. | string (diperlukan) |
| size | Ukuran SKU tertentu | string |
| tier | Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Definisi sumber daya templat ARM
Jenis sumber daya managedInstances dapat disebarkan dengan operasi yang menargetkan:
- Grup sumber daya - Lihat perintah penyebaran grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.
Contoh Penggunaan
Templat Mulai Cepat Azure
Templat Mulai Cepat Azure berikut menyebarkan jenis sumber daya ini.
| Template | Description |
|---|---|
|
Buat SQL MI di dalam jaringan virtual baru |
Sebarkan Azure Sql Database Managed Instance (SQL MI) di dalam Virtual Network baru. |
|
Buat SQL MI dengan pengiriman log dan metrik yang dikonfigurasi |
Templat ini memungkinkan Anda untuk menyebarkan SQL MI dan sumber daya tambahan yang digunakan untuk menyimpan log dan metrik (ruang kerja diagnostik, akun penyimpanan, pusat aktivitas). |
|
Buat SQL MI dengan jumpbox di dalam jaringan virtual baru |
Sebarkan Azure Sql Database Managed Instance (SQL MI) dan JumpBox dengan SSMS di dalam Virtual Network baru. |
|
Buat SQL MI dengan koneksi titik-ke-situs yang dikonfigurasi |
Sebarkan Azure Sql Database Managed Instance (SQL MI) dan gateway jaringan virtual yang dikonfigurasi untuk koneksi titik-ke-situs di dalam jaringan virtual baru. |
|
Terapkan SQL Managed Instance dengan Jaringan |
Menyebarkan UDR dan NSG untuk mendukung Azure SQL Managed Instance dan menyebarkan Managed Instance |
Format sumber daya
Untuk membuat Microsoft. Sumber daya SQL/managedInstances, tambahkan JSON berikut ke templat Anda.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2026-08-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"
}
}
Nilai Properti
Microsoft. SQL/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | Versi api | '2026-08-01-pratinjau' |
| identitas | Identitas Azure Active Directory dari instans terkelola. | ResourceIdentity |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| name | Nama sumber daya | string (diperlukan) |
| properties | Properti sumber daya. | ManagedInstanceProperties |
| sku | SKU instans terkelola. Nilai yang diizinkan untuk sku.name: GP_Gen5 (Tujuan Umum, Seri Standar); GP_G8IM (Tujuan Umum, Seri Premium); GP_G8IH (Tujuan Umum, memori seri Premium dioptimalkan); BC_Gen5 (Kritis Bisnis, Standard-Series); BC_G8IM (Business Critical, Premium-series); BC_G8IH (Business Critical, memori seri Premium dioptimalkan). | Sku |
| tags | Tag sumber daya | Kamus nama dan nilai tag. Lihat Tag dalam templat |
| jenis | Jenis sumber daya | "Microsoft. Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Jenis administrator sever. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Hanya Azure Active Directory Autentikasi diaktifkan. | bool |
| login | Nama masuk administrator server. | string |
| principalType | Jenis Utama administrator sever. | 'Application' 'Group' 'User' |
| sid | SID (ID objek) administrator server. | string Constraints: Panjang min = 36 Panjang maksimum = 36 Pola = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID penyewa administrator. | string Constraints: Panjang min = 36 Panjang maksimum = 36 Pola = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Nama pengguna administrator untuk instans terkelola. Hanya dapat ditentukan ketika instans terkelola sedang dibuat (dan diperlukan untuk pembuatan). | string |
| administratorLoginPassword | Kata sandi masuk administrator (diperlukan untuk pembuatan instans terkelola). | string Constraints: Nilai sensitif. Teruskan sebagai parameter aman. |
| administrators | Administrator Azure Active Directory dapat digunakan selama pembuatan instans dan untuk pembaruan instans, kecuali untuk properti azureADOnlyAuthentication. Untuk memperbarui properti azureADOnlyAuthentication, API individual harus digunakan. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Mode pencarian metadata autentikasi instans terkelola. | 'AzureAD' 'Paired' 'Windows' |
| kolase | Kolasasi instans terkelola. | string |
| databaseFormat | Menentukan format internal database instans khusus untuk versi mesin SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | Id sumber daya instans terkelola lain yang zona DNS-nya akan dibagikan instans terkelola ini setelah pembuatan. | string |
| hybridSecondaryUsage | Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif). | 'Active' 'Passive' |
| instancePoolId | Id kumpulan instans tempat server terkelola ini berada. | string |
| isGeneralPurposeV2 | Apakah ini adalah varian GPv2 edisi Tujuan Umum atau tidak. | bool |
| keyId | URI CMK kunci yang akan digunakan untuk enkripsi. | string |
| licenseType | Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini. | string |
| managedInstanceCreateMode | Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Ukuran memori dalam GB. Nilai minimum: 28. Nilai maksimum: 870. Nilai minimum dan maksimum bergantung pada jumlah vCore dan tingkat layanan. Baca selengkapnya tentang batas sumber daya: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Versi TLS minimal. Nilai yang diizinkan: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | Model penetapan harga Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default. | string |
| proxyOverride | Jenis koneksi yang digunakan untuk menyambungkan ke instans. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Apakah titik akhir data publik diaktifkan atau tidak. | bool |
| requestedBackupStorageRedundancy | Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zona (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone (GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Menentukan zona ketersediaan logis yang disematkan Managed Instance. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru. | string |
| servicePrincipal | Perwakilan layanan instans terkelola. | ServicePrincipal |
| sourceManagedInstanceId | Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini. | string |
| storageIOps | IOps penyimpanan. Nilai minimum: 300. Nilai maksimum: 80000. Kenaikan 1 IOps hanya diizinkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. | int |
| storageSizeInGB | Ukuran penyimpanan dalam GB. Nilai minimum: 32. Nilai maksimum: 32768. Kenaikan 32 GB hanya diperbolehkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. | int |
| storageThroughputMBps | Parameter MBps throughput penyimpanan tidak didukung dalam operasi buat/perbarui instans. | int |
| subnetId | ID sumber daya subnet untuk instans terkelola. | string |
| timezoneId | Id zona waktu. Nilai yang diizinkan adalah zona waktu yang didukung oleh Windows. Windows menyimpan detail tentang zona waktu yang didukung, termasuk id, di registri di bawah KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zona Waktu. Anda bisa mendapatkan nilai registri tersebut melalui SQL Server dengan mengkueri SELECT name AS timezone_id FROM sys.time_zone_info. Daftar Id juga dapat diperoleh dengan mengeksekusi [System.TimeZoneInfo]::GetSystemTimeZones() di PowerShell. Contoh id zona waktu yang valid adalah "Waktu Standar Pasifik" atau "W. Waktu Standar Eropa". |
string |
| vCores | Jumlah vCore. Nilai yang diizinkan: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. vCore yang didukung bergantung pada keluarga perangkat keras dan tingkat layanan yang dipilih. | int |
| zoneRedundant | Apakah redundansi zona diaktifkan atau tidak. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| jenis | Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| jenis | Jenis perwakilan layanan. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| kapasitas | Kapasitas SKU tertentu. | int |
| family | Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. | string |
| name | Nama SKU, biasanya, kode huruf + Angka, misalnya P3. | string (diperlukan) |
| size | Ukuran SKU tertentu | string |
| tier | Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Definisi sumber daya Terraform (penyedia AzAPI)
Jenis sumber daya managedInstances dapat disebarkan dengan operasi yang menargetkan:
- Grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.
Contoh Penggunaan
Modul Terverifikasi Azure
Modul Terverifikasi Azure berikut dapat digunakan untuk menyebarkan jenis sumber daya ini.
| Module | Description |
|---|---|
| Instans Terkelola SQL | Modul Sumber Daya AVM untuk SQL Managed Instance |
Format sumber daya
Untuk membuat Microsoft. Sumber daya SQL/managedInstances, tambahkan Terraform berikut ke templat Anda.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2026-08-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"
}
}
}
Nilai Properti
Microsoft. SQL/managedInstances
| Name | Description | Value |
|---|---|---|
| identitas | Identitas Azure Active Directory dari instans terkelola. | ResourceIdentity |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| name | Nama sumber daya | string (diperlukan) |
| properties | Properti sumber daya. | ManagedInstanceProperties |
| sku | SKU instans terkelola. Nilai yang diizinkan untuk sku.name: GP_Gen5 (Tujuan Umum, Seri Standar); GP_G8IM (Tujuan Umum, Seri Premium); GP_G8IH (Tujuan Umum, memori seri Premium dioptimalkan); BC_Gen5 (Kritis Bisnis, Standard-Series); BC_G8IM (Business Critical, Premium-series); BC_G8IH (Business Critical, memori seri Premium dioptimalkan). | Sku |
| tags | Tag sumber daya | Kamus nama dan nilai tag. |
| jenis | Jenis sumber daya | "Microsoft. Sql/managedInstances@2026-08-01-preview" |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Jenis administrator sever. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Hanya Azure Active Directory Autentikasi diaktifkan. | bool |
| login | Nama masuk administrator server. | string |
| principalType | Jenis Utama administrator sever. | 'Application' 'Group' 'User' |
| sid | SID (ID objek) administrator server. | string Constraints: Panjang min = 36 Panjang maksimum = 36 Pola = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID penyewa administrator. | string Constraints: Panjang min = 36 Panjang maksimum = 36 Pola = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Nama pengguna administrator untuk instans terkelola. Hanya dapat ditentukan ketika instans terkelola sedang dibuat (dan diperlukan untuk pembuatan). | string |
| administratorLoginPassword | Kata sandi masuk administrator (diperlukan untuk pembuatan instans terkelola). | string Constraints: Nilai sensitif. Teruskan sebagai parameter aman. |
| administrators | Administrator Azure Active Directory dapat digunakan selama pembuatan instans dan untuk pembaruan instans, kecuali untuk properti azureADOnlyAuthentication. Untuk memperbarui properti azureADOnlyAuthentication, API individual harus digunakan. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Mode pencarian metadata autentikasi instans terkelola. | 'AzureAD' 'Paired' 'Windows' |
| kolase | Kolasasi instans terkelola. | string |
| databaseFormat | Menentukan format internal database instans khusus untuk versi mesin SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | Id sumber daya instans terkelola lain yang zona DNS-nya akan dibagikan instans terkelola ini setelah pembuatan. | string |
| hybridSecondaryUsage | Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif). | 'Active' 'Passive' |
| instancePoolId | Id kumpulan instans tempat server terkelola ini berada. | string |
| isGeneralPurposeV2 | Apakah ini adalah varian GPv2 edisi Tujuan Umum atau tidak. | bool |
| keyId | URI CMK kunci yang akan digunakan untuk enkripsi. | string |
| licenseType | Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini. | string |
| managedInstanceCreateMode | Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Ukuran memori dalam GB. Nilai minimum: 28. Nilai maksimum: 870. Nilai minimum dan maksimum bergantung pada jumlah vCore dan tingkat layanan. Baca selengkapnya tentang batas sumber daya: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Versi TLS minimal. Nilai yang diizinkan: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | Model penetapan harga Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default. | string |
| proxyOverride | Jenis koneksi yang digunakan untuk menyambungkan ke instans. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Apakah titik akhir data publik diaktifkan atau tidak. | bool |
| requestedBackupStorageRedundancy | Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zona (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone (GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Menentukan zona ketersediaan logis yang disematkan Managed Instance. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru. | string |
| servicePrincipal | Perwakilan layanan instans terkelola. | ServicePrincipal |
| sourceManagedInstanceId | Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini. | string |
| storageIOps | IOps penyimpanan. Nilai minimum: 300. Nilai maksimum: 80000. Kenaikan 1 IOps hanya diizinkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. | int |
| storageSizeInGB | Ukuran penyimpanan dalam GB. Nilai minimum: 32. Nilai maksimum: 32768. Kenaikan 32 GB hanya diperbolehkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. | int |
| storageThroughputMBps | Parameter MBps throughput penyimpanan tidak didukung dalam operasi buat/perbarui instans. | int |
| subnetId | ID sumber daya subnet untuk instans terkelola. | string |
| timezoneId | Id zona waktu. Nilai yang diizinkan adalah zona waktu yang didukung oleh Windows. Windows menyimpan detail tentang zona waktu yang didukung, termasuk id, di registri di bawah KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zona Waktu. Anda bisa mendapatkan nilai registri tersebut melalui SQL Server dengan mengkueri SELECT name AS timezone_id FROM sys.time_zone_info. Daftar Id juga dapat diperoleh dengan mengeksekusi [System.TimeZoneInfo]::GetSystemTimeZones() di PowerShell. Contoh id zona waktu yang valid adalah "Waktu Standar Pasifik" atau "W. Waktu Standar Eropa". |
string |
| vCores | Jumlah vCore. Nilai yang diizinkan: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. vCore yang didukung bergantung pada keluarga perangkat keras dan tingkat layanan yang dipilih. | int |
| zoneRedundant | Apakah redundansi zona diaktifkan atau tidak. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| jenis | Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| jenis | Jenis perwakilan layanan. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| kapasitas | Kapasitas SKU tertentu. | int |
| family | Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. | string |
| name | Nama SKU, biasanya, kode huruf + Angka, misalnya P3. | string (diperlukan) |
| size | Ukuran SKU tertentu | string |
| tier | Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|