Managed Instances - Get
Mendapatkan instance terkelola.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2021-11-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
managed
|
path | True |
string |
Nama instans terkelola. |
resource
|
path | True |
string |
Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal. |
subscription
|
path | True |
string |
ID langganan yang mengidentifikasi langganan Azure. |
api-version
|
query | True |
string |
Versi API yang digunakan untuk permintaan. |
$expand
|
query |
string |
Sumber daya anak untuk disertakan dalam respons. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Berhasil mengambil instans terkelola yang ditentukan. |
|
Other Status Codes |
Respons Kesalahan: ***
|
Contoh
Get managed instance |
Get managed instance with $expand=administrators/activedirectory |
Get managed instance
Permintaan sampel
Respon sampel
{
"sku": {
"name": "GP_Gen4",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"servicePrincipal": {
"principalId": "00000011-1111-2222-2222-123456789111",
"clientId": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"type": "SystemAssigned"
}
},
"location": "japaneast",
"tags": {
"key": "value"
},
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
Get managed instance with $expand=administrators/activedirectory
Permintaan sampel
Respon sampel
{
"sku": {
"name": "GP_Gen4",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"administrators": {
"principalType": "User",
"login": "bob@contoso.com",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"azureADOnlyAuthentication": true
}
},
"location": "japaneast",
"tags": {
"key": "value"
},
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
Definisi
Nama | Deskripsi |
---|---|
Administrator |
Jenis administrator sever. |
Backup |
Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone(GeoZoneRedundantStorage) |
Identity |
Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya. |
Managed |
Instans terkelola Azure SQL. |
Managed |
Properti administrator direktori aktif. |
Managed |
Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (diskon harga AHB untuk membawa lisensi SQL Anda sendiri). |
Managed |
Koneksi titik akhir privat di bawah instans terkelola |
Managed |
Properti koneksi titik akhir privat. |
Managed |
|
Managed |
|
Managed |
Jenis koneksi yang digunakan untuk menyambungkan ke instans. |
Managed |
Menentukan mode pembuatan database. Default: Pembuatan instans reguler. Pemulihan: Membuat instans dengan memulihkan sekumpulan cadangan ke titik waktu tertentu. RestorePointInTime dan SourceManagedInstanceId harus ditentukan. |
Principal |
Jenis Utama administrator sever. |
Resource |
Konfigurasi identitas Azure Active Directory untuk sumber daya. |
Service |
Konfigurasi perwakilan layanan instans terkelola untuk sumber daya. |
Service |
Jenis perwakilan layanan. |
Sku |
SKU Sumber Daya ARM. |
User |
Konfigurasi identitas Azure Active Directory untuk sumber daya. |
AdministratorType
Jenis administrator sever.
Nama | Jenis | Deskripsi |
---|---|---|
ActiveDirectory |
string |
BackupStorageRedundancy
Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone(GeoZoneRedundantStorage)
Nama | Jenis | Deskripsi |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
IdentityType
Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
ManagedInstance
Instans terkelola Azure SQL.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID Sumber Daya. |
identity |
Identitas Azure Active Directory dari instans terkelola. |
|
location |
string |
Lokasi sumber daya. |
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 |
Kata sandi masuk administrator (diperlukan untuk pembuatan instans terkelola). |
properties.administrators |
Administrator Azure Active Directory server. |
|
properties.collation |
string |
Kolas instans terkelola. |
properties.currentBackupStorageRedundancy |
Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone(GeoZoneRedundantStorage) |
|
properties.dnsZone |
string |
Zona Dns tempat instans terkelola berada. |
properties.dnsZonePartner |
string |
Id sumber daya instans terkelola lain yang zona DNS-nya akan dibagikan instans terkelola ini setelah pembuatan. |
properties.fullyQualifiedDomainName |
string |
Nama domain yang sepenuhnya memenuhi syarat dari instans terkelola. |
properties.instancePoolId |
string |
Id kumpulan instans tempat server terkelola ini berada. |
properties.keyId |
string |
URI CMK kunci yang digunakan untuk enkripsi. |
properties.licenseType |
Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (diskon harga AHB untuk membawa lisensi SQL Anda sendiri). |
|
properties.maintenanceConfigurationId |
string |
Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini. |
properties.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. |
|
properties.minimalTlsVersion |
string |
Versi TLS minimal. Nilai yang diizinkan: 'None', '1.0', '1.1', '1.2' |
properties.primaryUserAssignedIdentityId |
string |
Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default. |
properties.privateEndpointConnections |
Daftar koneksi titik akhir privat pada instans terkelola. |
|
properties.provisioningState |
enum:
|
|
properties.proxyOverride |
Jenis koneksi yang digunakan untuk menyambungkan ke instans. |
|
properties.publicDataEndpointEnabled |
boolean |
Apakah titik akhir data publik diaktifkan atau tidak. |
properties.requestedBackupStorageRedundancy |
Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah Lokal (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) dan GeoZone(GeoZoneRedundantStorage) |
|
properties.restorePointInTime |
string |
Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru. |
properties.servicePrincipal |
Perwakilan layanan instans terkelola. |
|
properties.sourceManagedInstanceId |
string |
Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini. |
properties.state |
string |
Status instans terkelola. |
properties.storageSizeInGB |
integer |
Ukuran penyimpanan dalam GB. Nilai minimum: 32. Nilai maksimum: 16384. Kenaikan 32 GB hanya diperbolehkan. Nilai maksimum tergantung pada keluarga perangkat keras yang dipilih dan jumlah vCore. |
properties.subnetId |
string |
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 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Anda bisa mendapatkan nilai registri tersebut melalui SQL Server dengan mengkueri nama SELECT 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 |
Jumlah vCore. Nilai yang diizinkan: 8, 16, 24, 32, 40, 64, 80. |
properties.zoneRedundant |
boolean |
Apakah multi-az diaktifkan atau tidak. |
sku |
SKU instans terkelola. Nilai yang diizinkan untuk sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH |
|
tags |
object |
Tag sumber daya. |
type |
string |
Jenis sumber daya |
ManagedInstanceExternalAdministrator
Properti administrator direktori aktif.
Nama | Jenis | Deskripsi |
---|---|---|
administratorType |
Jenis administrator sever. |
|
azureADOnlyAuthentication |
boolean |
Azure Active Directory hanya Autentikasi yang diaktifkan. |
login |
string |
Nama masuk administrator server. |
principalType |
Jenis Utama administrator sever. |
|
sid |
string |
SID (ID objek) administrator server. |
tenantId |
string |
ID penyewa administrator. |
ManagedInstanceLicenseType
Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga reguler termasuk lisensi SQL baru) dan 'BasePrice' (diskon harga AHB untuk membawa lisensi SQL Anda sendiri).
Nama | Jenis | Deskripsi |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ManagedInstancePecProperty
Koneksi titik akhir privat di bawah instans terkelola
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID Sumber Daya. |
properties |
Properti koneksi titik akhir privat |
ManagedInstancePrivateEndpointConnectionProperties
Properti koneksi titik akhir privat.
Nama | Jenis | Deskripsi |
---|---|---|
privateEndpoint |
Titik akhir privat tempat koneksi berada. |
|
privateLinkServiceConnectionState |
Status Koneksi Koneksi Titik Akhir Privat. |
|
provisioningState |
string |
Status Koneksi Titik Akhir Privat. |
ManagedInstancePrivateEndpointProperty
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
Id sumber daya titik akhir privat. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
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
Jenis koneksi yang digunakan untuk menyambungkan ke instans.
Nama | Jenis | Deskripsi |
---|---|---|
Default |
string |
|
Proxy |
string |
|
Redirect |
string |
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.
Nama | Jenis | Deskripsi |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
PrincipalType
Jenis Utama administrator sever.
Nama | Jenis | Deskripsi |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
ResourceIdentity
Konfigurasi identitas Azure Active Directory untuk sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
principalId |
string |
Id utama Azure Active Directory. |
tenantId |
string |
Id penyewa Azure Active Directory. |
type |
Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya. |
|
userAssignedIdentities |
<string,
User |
Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan |
ServicePrincipal
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 |
Jenis perwakilan layanan. |
ServicePrincipalType
Jenis perwakilan layanan.
Nama | Jenis | Deskripsi |
---|---|---|
None |
string |
|
SystemAssigned |
string |
Sku
SKU Sumber Daya ARM.
Nama | Jenis | Deskripsi |
---|---|---|
capacity |
integer |
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. |
UserIdentity
Konfigurasi identitas Azure Active Directory untuk sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
clientId |
string |
Id klien Azure Active Directory. |
principalId |
string |
Id utama Azure Active Directory. |