Managed Instances - Create Or Update

Layanan:: SQL Database

Versi API:: 2025-01-01

Membuat atau memperbarui instans terkelola.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2025-01-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
managedInstanceName	path	True	string	Nama instans terkelola.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi geografis tempat sumber daya berada
identity		ResourceIdentity	Identitas Azure Active Directory dari instans terkelola.
properties.administratorLogin		string	Nama pengguna administrator untuk instans terkelola. Hanya dapat ditentukan ketika instans terkelola sedang dibuat (dan diperlukan untuk pembuatan).
properties.administratorLoginPassword		string (password)	Kata sandi masuk administrator (diperlukan untuk pembuatan instans terkelola).
properties.administrators		ManagedInstanceExternalAdministrator	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.
properties.authenticationMetadata		AuthMetadataLookupModes	Mode pencarian metadata autentikasi instans terkelola.
properties.collation		string	Kolasasi instans terkelola.
properties.databaseFormat		ManagedInstanceDatabaseFormat	Menentukan format internal database instans khusus untuk versi mesin SQL.
properties.dnsZonePartner		string (arm-id)	Id sumber daya instans terkelola lain yang zona DNS-nya akan dibagikan instans terkelola ini setelah pembuatan.
properties.hybridSecondaryUsage		HybridSecondaryUsage	Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif).
properties.instancePoolId		string	Id kumpulan instans tempat server terkelola ini berada.
properties.isGeneralPurposeV2		boolean	Apakah ini adalah varian GPv2 edisi Tujuan Umum atau tidak.
properties.keyId		string	URI CMK kunci yang akan digunakan untuk enkripsi.
properties.licenseType		ManagedInstanceLicenseType	Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri).
properties.maintenanceConfigurationId		string	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini.
properties.managedInstanceCreateMode		ManagedServerCreateMode	Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan.
properties.memorySizeInGB		integer (int32)	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.
properties.minimalTlsVersion		string	Versi TLS minimal. Nilai yang diizinkan: 'None', '1.0', '1.1', '1.2'
properties.pricingModel		PricingModel	Model penetapan harga Managed Instance.
properties.primaryUserAssignedIdentityId		string (arm-id)	Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default.
properties.proxyOverride		ManagedInstanceProxyOverride	Jenis koneksi yang digunakan untuk menyambungkan ke instans.
properties.publicDataEndpointEnabled		boolean	Apakah titik akhir data publik diaktifkan atau tidak.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zona (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone (GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Menentukan zona ketersediaan logis yang disematkan Managed Instance.
properties.restorePointInTime		string (date-time)	Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru.
properties.servicePrincipal		ServicePrincipal	Perwakilan layanan instans terkelola.
properties.sourceManagedInstanceId		string (arm-id)	Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini.
properties.storageIOps		integer (int32)	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.
properties.storageSizeInGB		integer (int32)	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.
properties.storageThroughputMBps		integer (int32)	Parameter MBps throughput penyimpanan tidak didukung dalam operasi buat/perbarui instans.
properties.subnetId		string (arm-id)	ID sumber daya subnet untuk instans terkelola.
properties.timezoneId		string	Id zona waktu. Nilai yang diizinkan adalah zona waktu yang didukung oleh Windows. Windows menyimpan detail tentang zona waktu yang didukung, termasuk id, dalam registri di bawah KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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".
properties.vCores		integer (int32)	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.
properties.zoneRedundant		boolean	Apakah redundansi zona diaktifkan atau tidak.
sku		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).
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	ManagedInstance	Operasi pembaruan 'ManagedInstance' sumber daya berhasil
201 Created	ManagedInstance	Operasi pembuatan 'ManagedInstance' sumber daya berhasil Header Location: string Retry-After: integer
202 Accepted		Operasi sumber daya diterima. Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned"
    },
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Respon sampel

Kode status:: 200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Kode status:: 201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Kode status:: 202

Create managed instance with minimal properties

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "licenseType": "LicenseIncluded",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  }
}

Respon sampel

Kode status:: 200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

Kode status:: 201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

Kode status:: 202

Definisi

Nama	Deskripsi
AdministratorType	Jenis administrator sever.
AuthMetadataLookupModes	Mode pencarian metadata autentikasi instans terkelola.
AvailabilityZoneType	Menentukan zona ketersediaan tempat database disematkan.
BackupStorageRedundancy	Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk database ini.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ExternalGovernanceStatus	Status tata kelola eksternal.
HybridSecondaryUsage	Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif).
HybridSecondaryUsageDetected	Penggunaan sekunder hibrid terdeteksi. Nilai yang mungkin adalah 'Aktif' (pelanggan tidak memenuhi persyaratan untuk menggunakan sekunder sebagai DR Pasif) dan 'Pasif' (pelanggan memenuhi persyaratan untuk menggunakan sekunder sebagai DR Pasif).
IdentityType	Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya.
ManagedInstance	Instans terkelola Azure SQL.
ManagedInstanceDatabaseFormat	Menentukan format internal database instans khusus untuk versi mesin SQL.
ManagedInstanceExternalAdministrator	Properti administrator direktori aktif.
ManagedInstanceLicenseType	Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri).
ManagedInstancePecProperty	Koneksi titik akhir privat di bawah instans terkelola
ManagedInstancePrivateEndpointConnectionProperties	Properti koneksi titik akhir privat.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Jenis koneksi yang digunakan untuk menyambungkan ke instans.
ManagedServerCreateMode	Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan.
PricingModel	Model penetapan harga Managed Instance.
PrincipalType	Jenis Utama administrator sever.
ProvisioningState	Status provisi ARM dari eksekusi pekerjaan.
ResourceIdentity	Konfigurasi identitas Azure Active Directory untuk sumber daya.
ServicePrincipal	Konfigurasi perwakilan layanan instans terkelola untuk sumber daya.
ServicePrincipalType	Jenis perwakilan layanan.
Sku	SKU Sumber Daya ARM.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UserIdentity	Konfigurasi identitas Azure Active Directory untuk sumber daya.

AdministratorType

Enumerasi

Jenis administrator sever.

Nilai	Deskripsi
ActiveDirectory	Direktori Aktif

AuthMetadataLookupModes

Enumerasi

Mode pencarian metadata autentikasi instans terkelola.

Nilai	Deskripsi
AzureAD	AzureAD
Paired	Berpasangan
Windows	Windows

AvailabilityZoneType

Enumerasi

Menentukan zona ketersediaan tempat database disematkan.

Nilai	Deskripsi
NoPreference	Tidak Ada Preferensi
1	1
2	2
3	3

BackupStorageRedundancy

Enumerasi

Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk database ini.

Nilai	Deskripsi
Geo	Geografi
Local	Lokal
Zone	Zona
GeoZone	GeoZone

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ExternalGovernanceStatus

Enumerasi

Status tata kelola eksternal.

Nilai	Deskripsi
Enabled	Enabled
Disabled	Nonaktif

HybridSecondaryUsage

Enumerasi

Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif).

Nilai	Deskripsi
Active	Aktif
Passive	Passive

HybridSecondaryUsageDetected

Enumerasi

Penggunaan sekunder hibrid terdeteksi. Nilai yang mungkin adalah 'Aktif' (pelanggan tidak memenuhi persyaratan untuk menggunakan sekunder sebagai DR Pasif) dan 'Pasif' (pelanggan memenuhi persyaratan untuk menggunakan sekunder sebagai DR Pasif).

Nilai	Deskripsi
Active	Aktif
Passive	Passive

IdentityType

Enumerasi

Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya.

Nilai	Deskripsi
None	Tidak
SystemAssigned	DitugaskanSistem
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SistemTugas,Pengguna Ditetapkan

ManagedInstance

Objek

Instans terkelola Azure SQL.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	Identitas Azure Active Directory dari instans terkelola.
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya
properties.administratorLogin	string	Nama pengguna administrator untuk instans terkelola. Hanya dapat ditentukan ketika instans terkelola sedang dibuat (dan diperlukan untuk pembuatan).
properties.administratorLoginPassword	string (password)	Kata sandi masuk administrator (diperlukan untuk pembuatan instans terkelola).
properties.administrators	ManagedInstanceExternalAdministrator	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.
properties.authenticationMetadata	AuthMetadataLookupModes	Mode pencarian metadata autentikasi instans terkelola.
properties.collation	string	Kolasasi instans terkelola.
properties.createTime	string (date-time)	Menentukan titik waktu (format ISO8601) pembuatan Managed Instance.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zona (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone (GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Menentukan format internal database instans khusus untuk versi mesin SQL.
properties.dnsZone	string	Zona Dns tempat instans terkelola berada.
properties.dnsZonePartner	string (arm-id)	Id sumber daya instans terkelola lain yang zona DNS-nya akan dibagikan instans terkelola ini setelah pembuatan.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status tata kelola eksternal.
properties.fullyQualifiedDomainName	string	Nama domain yang sepenuhnya memenuhi syarat dari instans terkelola.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Penggunaan sekunder hibrid. Nilai yang mungkin adalah 'Aktif' (nilai default) dan 'Pasif' (pelanggan menggunakan sekunder sebagai DR Pasif).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Penggunaan sekunder hibrid terdeteksi. Nilai yang mungkin adalah 'Aktif' (pelanggan tidak memenuhi persyaratan untuk menggunakan sekunder sebagai DR Pasif) dan 'Pasif' (pelanggan memenuhi persyaratan untuk menggunakan sekunder sebagai DR Pasif).
properties.instancePoolId	string	Id kumpulan instans tempat server terkelola ini berada.
properties.isGeneralPurposeV2	boolean	Apakah ini adalah varian GPv2 edisi Tujuan Umum atau tidak.
properties.keyId	string	URI CMK kunci yang akan digunakan untuk enkripsi.
properties.licenseType	ManagedInstanceLicenseType	Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri).
properties.maintenanceConfigurationId	string	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan.
properties.memorySizeInGB	integer (int32)	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.
properties.minimalTlsVersion	string	Versi TLS minimal. Nilai yang diizinkan: 'None', '1.0', '1.1', '1.2'
properties.pricingModel	PricingModel	Model penetapan harga Managed Instance.
properties.primaryUserAssignedIdentityId	string (arm-id)	Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Daftar koneksi titik akhir privat pada instans terkelola.
properties.provisioningState	ProvisioningState	Status provisi instans terkelola.
properties.proxyOverride	ManagedInstanceProxyOverride	Jenis koneksi yang digunakan untuk menyambungkan ke instans.
properties.publicDataEndpointEnabled	boolean	Apakah titik akhir data publik diaktifkan atau tidak.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zona (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone (GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone	AvailabilityZoneType	Menentukan zona ketersediaan logis yang disematkan Managed Instance.
properties.restorePointInTime	string (date-time)	Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru.
properties.servicePrincipal	ServicePrincipal	Perwakilan layanan instans terkelola.
properties.sourceManagedInstanceId	string (arm-id)	Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini.
properties.state	string	Status instans terkelola.
properties.storageIOps	integer (int32)	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.
properties.storageSizeInGB	integer (int32)	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.
properties.storageThroughputMBps	integer (int32)	Parameter MBps throughput penyimpanan tidak didukung dalam operasi buat/perbarui instans.
properties.subnetId	string (arm-id)	ID sumber daya subnet untuk instans terkelola.
properties.timezoneId	string	Id zona waktu. Nilai yang diizinkan adalah zona waktu yang didukung oleh Windows. Windows menyimpan detail tentang zona waktu yang didukung, termasuk id, dalam registri di bawah KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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".
properties.vCores	integer (int32)	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.
properties.virtualClusterId	string	ID sumber daya kluster virtual untuk Managed Instance.
properties.zoneRedundant	boolean	Apakah redundansi zona diaktifkan atau tidak.
sku	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).
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

ManagedInstanceDatabaseFormat

Enumerasi

Menentukan format internal database instans khusus untuk versi mesin SQL.

Nilai	Deskripsi
AlwaysUpToDate	SelaluTerkini
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Objek

Properti administrator direktori aktif.

Nama	Jenis	Deskripsi
administratorType	AdministratorType	Jenis administrator sever.
azureADOnlyAuthentication	boolean	Hanya Azure Active Directory Autentikasi diaktifkan.
login	string	Nama masuk administrator server.
principalType	PrincipalType	Jenis Utama administrator sever.
sid	string (uuid)	SID (ID objek) administrator server.
tenantId	string (uuid)	ID penyewa administrator.

ManagedInstanceLicenseType

Enumerasi

Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (harga AHB diskon untuk membawa lisensi SQL Anda sendiri).

Nilai	Deskripsi
LicenseIncluded	Termasuk Lisensi
BasePrice	BasePrice

ManagedInstancePecProperty

Objek

Koneksi titik akhir privat di bawah instans terkelola

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
properties	ManagedInstancePrivateEndpointConnectionProperties	Properti koneksi titik akhir privat

ManagedInstancePrivateEndpointConnectionProperties

Objek

Properti koneksi titik akhir privat.

Nama	Jenis	Deskripsi
privateEndpoint	ManagedInstancePrivateEndpointProperty	Titik akhir privat tempat koneksi berada.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Status Koneksi Koneksi Titik Akhir Privat.
provisioningState	string	Status Koneksi Titik Akhir Privat.

ManagedInstancePrivateEndpointProperty

Objek

Nama	Jenis	Deskripsi
id	string	Id sumber daya titik akhir privat.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objek

Nama	Jenis	Deskripsi
actionsRequired	string	Deskripsi koneksi layanan tautan privat.
description	string	Deskripsi koneksi layanan tautan privat.
status	string	Status koneksi layanan tautan privat.

ManagedInstanceProxyOverride

Enumerasi

Jenis koneksi yang digunakan untuk menyambungkan ke instans.

Nilai	Deskripsi
Proxy	Proxy
Redirect	Pengalihan
Default	Default

ManagedServerCreateMode

Enumerasi

Menentukan mode pembuatan database.

Default: Pembuatan instans reguler.

Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan.

Nilai	Deskripsi
Default	Default
PointInTimeRestore	PointInTimeRestore

PricingModel

Enumerasi

Model penetapan harga Managed Instance.

Nilai	Deskripsi
Regular	Reguler
Freemium	Freemium

PrincipalType

Enumerasi

Jenis Utama administrator sever.

Nilai	Deskripsi
User	Pengguna
Group	Kelompok
Application	Application

ProvisioningState

Enumerasi

Status provisi ARM dari eksekusi pekerjaan.

Nilai	Deskripsi
Created	Telah dibuat
InProgress	InProgress
Succeeded	Berhasil
Failed	Kegagalan
Canceled	Dibatalkan

ResourceIdentity

Objek

Konfigurasi identitas Azure Active Directory untuk sumber daya.

Nama	Jenis	Deskripsi
principalId	string (uuid)	ID perwakilan Azure Active Directory.
tenantId	string (uuid)	ID penyewa Azure Active Directory.
type	IdentityType	Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya.
userAssignedIdentities	<string, UserIdentity>	Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan

ServicePrincipal

Objek

Konfigurasi perwakilan layanan instans terkelola untuk sumber daya.

Nama	Jenis	Deskripsi
clientId	string	ID klien aplikasi Azure Active Directory.
principalId	string	ID objek aplikasi Azure Active Directory.
tenantId	string	ID penyewa Azure Active Directory.
type	ServicePrincipalType	Jenis perwakilan layanan.

ServicePrincipalType

Enumerasi

Jenis perwakilan layanan.

Nilai	Deskripsi
None	Tidak
SystemAssigned	DitugaskanSistem

Sku

Objek

SKU Sumber Daya ARM.

Nama	Jenis	Deskripsi
capacity	integer (int32)	Kapasitas SKU tertentu.
family	string	Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
name	string	Nama SKU, biasanya, kode huruf + Angka, misalnya P3.
size	string	Ukuran SKU tertentu
tier	string	Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UserIdentity

Objek

Konfigurasi identitas Azure Active Directory untuk sumber daya.

Nama	Jenis	Deskripsi
clientId	string (uuid)	ID klien Azure Active Directory.
principalId	string (uuid)	ID perwakilan Azure Active Directory.

Bagikan melalui

Managed Instances - Create Or Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

Create managed instance with all properties

Permintaan sampel

Respon sampel

Create managed instance with minimal properties

Permintaan sampel

Respon sampel

Definisi

AdministratorType

AuthMetadataLookupModes

AvailabilityZoneType

BackupStorageRedundancy

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

systemData

UserIdentity