Managed Instances - Get

Service:

SQL Database

API Version:

2021-02-01-preview

Mendapatkan instance terkelola.

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

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2021-02-01-preview

Parameter URI

Name	In	Required	Type	Description
managedInstanceName	path	True	string	Nama instans terkelola.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
subscriptionId	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 yang akan disertakan dalam respons.

Respons

Name	Type	Description
200 OK	ManagedInstance	Berhasil mengambil instans terkelola yang ditentukan.
Other Status Codes		Respons Kesalahan: *** 400 SubscriptionNotFound - Langganan yang diminta tidak ditemukan. 400 MiGeoRestoreWithWrongBackupStorageRedundancy - Geo-Restore tidak diizinkan untuk instans terkelola dengan redundansi penyimpanan cadangan LRS/ZRS. 400 ProvisioningDisabled - Menampilkan pesan kesalahan dari otorisasi operasi sumber daya apa adanya, tanpa perubahan 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory Hanya Autentikasi diaktifkan. Silakan hubungi administrator sistem Anda. 400 ManagementServiceFeatureDisabled - Pengguna mencoba menggunakan fitur yang dinonaktifkan. 404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan. 404 ManagedInstanceNotInSubscriptionResourceGroup - Instans terkelola yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 409 ConflictingManagedInstanceOperation - Operasi saat ini sedang berlangsung untuk instans terkelola. 409 MiDropFailedOnAuthLocks - Pengguna mencoba menghilangkan Instans Terkelola terakhir di subnet yang telah Mengunci yang diterapkan pada sumber daya. 409 MiCreateFailedNonDelegatedSubnet - Pengguna mencoba menyebarkan Instans Terkelola atau kumpulan Instans Terkelola di subnet yang tidak didelegasikan ke Microsoft.Sql/managedInstances. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 ConflictingSubscriptionOperation - Operasi saat ini sedang berlangsung untuk langganan. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 504 RequestTimeout - Permintaan layanan melebihi batas waktu yang diizinkan. 504 RequestTimeout - Permintaan layanan melebihi batas waktu yang diizinkan.

Contoh

Get managed instance

Get managed instance with $expand=administrators

Get managed instance

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-02-01-preview

Sample Response

Status code:

200

{
  "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",
    "storageAccountType": "GRS"
  },
  "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

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-02-01-preview

Sample Response

Status code:

200

{
  "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",
    "storageAccountType": "GRS",
    "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

AdministratorType	Jenis administrator sever.
IdentityType	Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.
ManagedInstance	Instans terkelola Azure SQL.
ManagedInstanceExternalAdministrator	Properti administrator direktori aktif.
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).
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.
PrincipalType	Jenis Utama administrator sever.
ResourceIdentity	Azure Active Directory konfigurasi identitas untuk sumber daya.
Sku	SKU Sumber Daya ARM.
StorageAccountType	Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) dan GRS (GeoRedundantStorage)
UserIdentity	Azure Active Directory konfigurasi identitas untuk sumber daya.

AdministratorType

Jenis administrator sever.

Name	Type	Description
ActiveDirectory	string

IdentityType

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

Name	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ManagedInstance

Instans terkelola Azure SQL.

Name	Type	Description
id	string	ID Sumber Daya.
identity	ResourceIdentity	Identitas Azure Active Directory 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	ManagedInstanceExternalAdministrator	Administrator Azure Active Directory server.
properties.collation	string	Kolas instans terkelola.
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	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).
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.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	ManagedInstancePecProperty[]	Daftar koneksi titik akhir privat pada instans terkelola.
properties.provisioningState	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
properties.proxyOverride	ManagedInstanceProxyOverride	Jenis koneksi yang digunakan untuk menyambungkan ke instans.
properties.publicDataEndpointEnabled	boolean	Apakah titik akhir data publik diaktifkan atau tidak.
properties.restorePointInTime	string	Menentukan titik waktu (format ISO8601) dari database sumber yang akan dipulihkan untuk membuat database baru.
properties.sourceManagedInstanceId	string	Pengidentifikasi sumber daya instans terkelola sumber yang terkait dengan operasi pembuatan instans ini.
properties.state	string	Status instans terkelola.
properties.storageAccountType	StorageAccountType	Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) dan GRS (GeoRedundantStorage)
properties.storageSizeInGB	integer	Storage ukuran dalam GB. Nilai minimum: 32. Nilai maksimum: 8192. Kenaikan 32 GB hanya diperbolehkan.
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	SKU instans terkelola. Nilai yang diizinkan untuk sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5
tags	object	Tag sumber daya.
type	string	Jenis sumber daya

ManagedInstanceExternalAdministrator

Properti administrator direktori aktif.

Name	Type	Description
administratorType	AdministratorType	Jenis administrator sever.
azureADOnlyAuthentication	boolean	Azure Active Directory hanya Autentikasi yang diaktifkan.
login	string	Nama masuk administrator server.
principalType	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).

Name	Type	Description
BasePrice	string
LicenseIncluded	string

ManagedInstancePecProperty

Koneksi titik akhir privat di bawah instans terkelola

Name	Type	Description
id	string	ID Sumber Daya.
properties	ManagedInstancePrivateEndpointConnectionProperties	Properti koneksi titik akhir privat

ManagedInstancePrivateEndpointConnectionProperties

Properti koneksi titik akhir privat.

Name	Type	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Titik akhir privat tempat koneksi berada.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Status Koneksi Koneksi Titik Akhir Privat.
provisioningState	string	Status Koneksi Titik Akhir Privat.

ManagedInstancePrivateEndpointProperty

Name	Type	Description
id	string	Id sumber daya titik akhir privat.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
Default	string
PointInTimeRestore	string

PrincipalType

Jenis Utama administrator sever.

Name	Type	Description
Application	string
Group	string
User	string

ResourceIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Name	Type	Description
principalId	string	Id utama Azure Active Directory.
tenantId	string	Id penyewa Azure Active Directory.
type	IdentityType	Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.
userAssignedIdentities	<string,  UserIdentity>	Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan

Sku

SKU Sumber Daya ARM.

Name	Type	Description
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.

StorageAccountType

Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk instans ini. Opsinya adalah LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) dan GRS (GeoRedundantStorage)

Name	Type	Description
GRS	string
LRS	string
ZRS	string

UserIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Name	Type	Description
clientId	string	Id klien Azure Active Directory.
principalId	string	Id utama Azure Active Directory.