Managed Databases - List By Instance

Layanan:: SQL Database

Versi API:: 2023-08-01

Mendapatkan daftar database terkelola.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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 API Azure Resource Manager atau portal.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang akan digunakan untuk permintaan tersebut.

Respons

Nama	Jenis	Deskripsi
200 OK	ManagedDatabaseListResult	Berhasil mengambil daftar database.
Other Status Codes	ErrorResponse	Respons Kesalahan: *** 400 ManagedInstanceStoppingOrStopped - Operasi yang bertentangan dikirimkan saat instans dalam status berhenti/dihentikan 400 ManagedInstanceStarting - Operasi bertentangan yang dikirimkan saat instans dalam status mulai 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

Nama

Jenis

Deskripsi

200 OK

ManagedDatabaseListResult

Berhasil mengambil daftar database.

Other Status Codes

ErrorResponse

Respons Kesalahan: ***

400 ManagedInstanceStoppingOrStopped - Operasi yang bertentangan dikirimkan saat instans dalam status berhenti/dihentikan
400 ManagedInstanceStarting - Operasi bertentangan yang dikirimkan saat instans dalam status mulai
404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.
404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

Contoh

List databases by managed instances

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/managedInstance/databases?api-version=2023-08-01

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
      "location": "southeastasia",
      "name": "testdb1",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "status": "Online",
        "isLedgerOn": false
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb2",
      "location": "southeastasia",
      "name": "testdb2",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "status": "Online",
        "isLedgerOn": false
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    }
  ]
}

Definisi

Nama	Deskripsi
CatalogCollationType	Kolate katalog metadata.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
ManagedDatabase	Sumber daya database terkelola.
ManagedDatabaseCreateMode	Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (diperlukan longTermRetentionBackupResourceId).
ManagedDatabaseListResult	Daftar database terkelola.
ManagedDatabaseStatus	Status database.

CatalogCollationType

Enumerasi

Kolate katalog metadata.

Nilai	Deskripsi
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

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[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ManagedDatabase

Objek

Sumber daya database terkelola.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
location	string	Lokasi sumber daya.
name	string	Nama sumber daya.
properties.autoCompleteRestore	boolean	Apakah akan menyelesaikan pemulihan otomatis database terkelola ini.
properties.catalogCollation	CatalogCollationType	Kolate katalog metadata.
properties.collation	string	Kolatasi database terkelola.
properties.createMode	ManagedDatabaseCreateMode	Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (diperlukan longTermRetentionBackupResourceId).
properties.creationDate	string (date-time)	Tanggal pembuatan database.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	Id sumber daya database lintas langganan yang dapat dihilangkan untuk dipulihkan saat membuat database ini.
properties.crossSubscriptionSourceDatabaseId	string	Pengidentifikasi sumber daya database sumber lintas langganan yang terkait dengan operasi pembuatan database ini.
properties.crossSubscriptionTargetManagedInstanceId	string	Id instans terkelola target yang digunakan dalam pemulihan lintas langganan.
properties.defaultSecondaryLocation	string	Wilayah berpasangan geografis.
properties.earliestRestorePoint	string (date-time)	Titik pemulihan paling awal tepat waktu untuk pemulihan titik waktu.
properties.failoverGroupId	string	Pengidentifikasi sumber daya Grup Failover Instans tempat database terkelola ini berada.
properties.isLedgerOn	boolean	Apakah database ini adalah database ledger atau tidak, yang berarti semua tabel dalam database adalah tabel ledger. Catatan: nilai properti ini tidak dapat diubah setelah database dibuat.
properties.lastBackupName	string	Nama file cadangan terakhir untuk pemulihan database terkelola ini.
properties.longTermRetentionBackupResourceId	string	Nama cadangan Retensi Jangka Panjang yang akan digunakan untuk pemulihan database terkelola ini.
properties.recoverableDatabaseId	string	Pengidentifikasi sumber daya database yang dapat dipulihkan yang terkait dengan operasi pembuatan database ini.
properties.restorableDroppedDatabaseId	string	Id sumber daya database yang dihilangkan yang dapat dipulihkan untuk dipulihkan saat membuat database ini.
properties.restorePointInTime	string (date-time)	Bersyarat. Jika createMode adalah PointInTimeRestore, nilai ini diperlukan. Menentukan titik waktu (format ISO8601) database sumber yang akan dipulihkan untuk membuat database baru.
properties.sourceDatabaseId	string	Pengidentifikasi sumber daya database sumber yang terkait dengan operasi pembuatan database ini.
properties.status	ManagedDatabaseStatus	Status database.
properties.storageContainerIdentity	string	Bersyarat. Jika createMode adalah RestoreExternalBackup, nilai ini digunakan. Menentukan identitas yang digunakan untuk autentikasi kontainer penyimpanan. Dapat berupa 'SharedAccessSignature' atau 'ManagedIdentity'; jika tidak ditentukan 'SharedAccessSignature' diasumsikan.
properties.storageContainerSasToken	string	Bersyarat. Jika createMode adalah RestoreExternalBackup dan storageContainerIdentity bukan ManagedIdentity, nilai ini diperlukan. Menentukan token sas kontainer penyimpanan.
properties.storageContainerUri	string	Bersyarat. Jika createMode adalah RestoreExternalBackup, nilai ini diperlukan. Menentukan uri kontainer penyimpanan tempat cadangan untuk pemulihan ini disimpan.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya.

ManagedDatabaseCreateMode

Enumerasi

Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (diperlukan longTermRetentionBackupResourceId).

Nilai	Deskripsi
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseListResult

Objek

Daftar database terkelola.

Nama	Jenis	Deskripsi
nextLink	string	Tautan untuk mengambil halaman hasil berikutnya.
value	ManagedDatabase[]	Array hasil.

ManagedDatabaseStatus

Enumerasi

Status database.

Nilai	Deskripsi
Online
Offline
Shutdown
Creating
Inaccessible
Restoring
Updating
Stopping
Stopped
Starting
DbMoving
DbCopying

Bagikan melalui

Managed Databases - List By Instance

Parameter URI

Respons

Contoh

List databases by managed instances

Permintaan sampel

Respon sampel

Definisi

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus