Managed Databases - List By Instance

Služba:: SQL Database

Verze rozhraní API:: 2023-08-01

Získá seznam spravovaných databází.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
managedInstanceName	path	True	string	Název spravované instance.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	ManagedDatabaseListResult	Seznam databází se úspěšně načetl.
Other Status Codes	ErrorResponse	Chybové odpovědi: *** 400 ManagedInstanceStoppingOrStopped – Konfliktní operace odeslaná, když je instance v zastaveném nebo zastaveném stavu 400 ManagedInstanceStarting – Konfliktní operace odeslaná při spuštění instance 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

Name

Typ

Description

200 OK

ManagedDatabaseListResult

Seznam databází se úspěšně načetl.

Other Status Codes

ErrorResponse

Chybové odpovědi: ***

400 ManagedInstanceStoppingOrStopped – Konfliktní operace odeslaná, když je instance v zastaveném nebo zastaveném stavu
400 ManagedInstanceStarting – Konfliktní operace odeslaná při spuštění instance
404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.
404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

Příklady

List databases by managed instances

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
    }
  ]
}

Definice

Name	Description
CatalogCollationType	Kolace katalogu metadat.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ManagedDatabase	Spravovaný databázový prostředek.
ManagedDatabaseCreateMode	Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId).
ManagedDatabaseListResult	Seznam spravovaných databází
ManagedDatabaseStatus	Stav databáze.

CatalogCollationType

Výčet

Kolace katalogu metadat.

Hodnota	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ManagedDatabase

Objekt

Spravovaný databázový prostředek.

Name	Typ	Description
id	string	ID prostředku.
location	string	Umístění prostředku
name	string	Název prostředku
properties.autoCompleteRestore	boolean	Určuje, jestli se má automaticky dokončit obnovení této spravované databáze.
properties.catalogCollation	CatalogCollationType	Kolace katalogu metadat.
properties.collation	string	Kolace spravované databáze.
properties.createMode	ManagedDatabaseCreateMode	Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId).
properties.creationDate	string (date-time)	Datum vytvoření databáze.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	Obnovitelné ID prostředku databáze vyřazeného mezi předplatnými, které se má obnovit při vytváření této databáze.
properties.crossSubscriptionSourceDatabaseId	string	Identifikátor prostředku zdrojové databáze mezi předplatnými přidružený k operaci vytvoření této databáze.
properties.crossSubscriptionTargetManagedInstanceId	string	ID cílové spravované instance použité při obnovení mezi předplatnými
properties.defaultSecondaryLocation	string	Geograficky spárovaná oblast
properties.earliestRestorePoint	string (date-time)	Nejstarší bod obnovení v čase pro obnovení k určitému bodu v čase.
properties.failoverGroupId	string	Identifikátor prostředku skupiny převzetí služeb při selhání instance, do kterého tato spravovaná databáze patří.
properties.isLedgerOn	boolean	Bez ohledu na to, jestli se jedná o databázi registru, znamená to, že všechny tabulky v databázi jsou tabulky registru. Poznámka: Hodnotu této vlastnosti nelze po vytvoření databáze změnit.
properties.lastBackupName	string	Název posledního záložního souboru pro obnovení této spravované databáze.
properties.longTermRetentionBackupResourceId	string	Název zálohy dlouhodobého uchovávání, který se má použít k obnovení této spravované databáze.
properties.recoverableDatabaseId	string	Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze.
properties.restorableDroppedDatabaseId	string	Id obnovovatelného vyřazeného prostředku databáze, které se má obnovit při vytváření této databáze.
properties.restorePointInTime	string (date-time)	Podmíněný. Pokud je createMode PointInTimeRestore, je tato hodnota povinná. Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi.
properties.sourceDatabaseId	string	Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze.
properties.status	ManagedDatabaseStatus	Stav databáze.
properties.storageContainerIdentity	string	Podmíněný. Pokud createMode je RestoreExternalBackup, použije se tato hodnota. Určuje identitu použitou pro ověřování kontejneru úložiště. Může být SharedAccessSignature nebo ManagedIdentity; Pokud není zadán parametr SharedAccessSignature, předpokládá se.
properties.storageContainerSasToken	string	Podmíněný. Pokud createMode je RestoreExternalBackup a storageContainerIdentity není ManagedIdentity, je tato hodnota povinná. Určuje token SAS kontejneru úložiště.
properties.storageContainerUri	string	Podmíněný. Pokud createMode je RestoreExternalBackup, je tato hodnota povinná. Určuje identifikátor URI kontejneru úložiště, ve kterém jsou uloženy zálohy pro toto obnovení.
tags	object	Značky prostředků
type	string	Typ prostředku.

ManagedDatabaseCreateMode

Výčet

Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId).

Hodnota	Description
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseListResult

Objekt

Seznam spravovaných databází

Name	Typ	Description
nextLink	string	Odkaz na načtení další stránky výsledků
value	ManagedDatabase[]	Pole výsledků

ManagedDatabaseStatus

Výčet

Stav databáze.

Hodnota	Description
Online
Offline
Shutdown
Creating
Inaccessible
Restoring
Updating
Stopping
Stopped
Starting
DbMoving
DbCopying

Sdílet prostřednictvím

Managed Databases - List By Instance

Parametry identifikátoru URI

Odpovědi

Příklady

List databases by managed instances

Ukázkový požadavek

Ukázková odpověď

Definice

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus