Managed Instances - List By Resource Group

Mendapatkan daftar instans terkelola dalam grup sumber daya.

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

Parameter URI

Name In Required Type Description
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 untuk disertakan dalam respons.

Respons

Name Type Description
200 OK

Berhasil mengambil daftar instans terkelola.

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 memiliki Kunci 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

List managed instances by resource group
List managed instances by resource group with $expand=administrators

List managed instances by resource group

Sample Request

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2021-02-01-preview

Sample Response

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "maintenanceConfigurationId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "storageAccountType": "GRS"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "storageAccountType": "GRS"
      }
    }
  ]
}

List managed instances by resource group with $expand=administrators

Sample Request

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2021-02-01-preview

Sample Response

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "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",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "storageAccountType": "GRS",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        }
      }
    }
  ]
}

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).

ManagedInstanceListResult

Daftar instans terkelola.

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

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

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

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:
  • Accepted
  • Canceled
  • Created
  • Creating
  • Deleted
  • Deleting
  • Failed
  • NotSpecified
  • Registering
  • Running
  • Succeeded
  • TimedOut
  • Unknown
  • Unrecognized
  • Updating
properties.proxyOverride

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

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 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

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).

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstanceListResult

Daftar instans terkelola.

Name Type Description
nextLink
  • string

Tautan untuk mengambil halaman hasil berikutnya.

value

Array hasil.

ManagedInstancePecProperty

Koneksi titik akhir privat di bawah instans terkelola

Name Type Description
id
  • string

ID Sumber Daya.

properties

Properti koneksi titik akhir privat

ManagedInstancePrivateEndpointConnectionProperties

Properti koneksi titik akhir privat.

Name Type Description
privateEndpoint

Titik akhir privat tempat koneksi berada.

privateLinkServiceConnectionState

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

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

userAssignedIdentities

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.