Managed Databases - Get

Service:: SQL Database

API-versie:: 2023-08-01

Hiermee haalt u een beheerde database op.

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

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
managedInstanceName	path	True	string	De naam van het beheerde exemplaar.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	ManagedDatabase	De opgegeven beheerde database is opgehaald.
Other Status Codes	ErrorResponse	Foutreacties: *** 400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft 400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft 404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ResourceNotFound : de aangevraagde resource is niet gevonden.

Name

Type

Description

200 OK

ManagedDatabase

De opgegeven beheerde database is opgehaald.

Other Status Codes

ErrorResponse

Foutreacties: ***

400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft
400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft
404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 ResourceNotFound : de aangevraagde resource is niet gevonden.

Voorbeelden

Gets a managed database

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

{
  "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"
}

Definities

Name	Description
CatalogCollationType	Sortering van de metagegevenscatalogus.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ManagedDatabase	Een beheerde databaseresource.
ManagedDatabaseCreateMode	Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door deze te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up voor langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist).
ManagedDatabaseStatus	Status van de database.

CatalogCollationType

Opsomming

Sortering van de metagegevenscatalogus.

Waarde	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ManagedDatabase

Object

Een beheerde databaseresource.

Name	Type	Description
id	string	Resource-id.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.autoCompleteRestore	boolean	Hiermee wordt aangegeven of het automatisch herstellen van deze beheerde database moet worden voltooid.
properties.catalogCollation	CatalogCollationType	Sortering van de metagegevenscatalogus.
properties.collation	string	Sortering van de beheerde database.
properties.createMode	ManagedDatabaseCreateMode	Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door deze te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up voor langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist).
properties.creationDate	string (date-time)	De aanmaakdatum van de database.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	De herstelbare databaseresource-id voor meerdere abonnementen is verwijderd om te herstellen bij het maken van deze database.
properties.crossSubscriptionSourceDatabaseId	string	De resource-id van de brondatabase voor meerdere abonnementen die is gekoppeld aan het maken van deze database.
properties.crossSubscriptionTargetManagedInstanceId	string	Doel-id van beheerd exemplaar dat wordt gebruikt bij het herstellen van meerdere abonnementen.
properties.defaultSecondaryLocation	string	Geografisch gekoppelde regio.
properties.earliestRestorePoint	string (date-time)	Vroegst herstelpunt in de tijd voor herstel naar een bepaald tijdstip.
properties.failoverGroupId	string	Resource-id van exemplaarfailovergroep waartoe deze beheerde database behoort.
properties.isLedgerOn	boolean	Of deze database nu een grootboekdatabase is, wat betekent dat alle tabellen in de database grootboektabellen zijn. Opmerking: de waarde van deze eigenschap kan niet worden gewijzigd nadat de database is gemaakt.
properties.lastBackupName	string	De naam van het laatste back-upbestand voor het herstellen van deze beheerde database.
properties.longTermRetentionBackupResourceId	string	De naam van de langetermijnretentieback-up die moet worden gebruikt voor het herstellen van deze beheerde database.
properties.recoverableDatabaseId	string	De resource-id van de herstelbare database die is gekoppeld aan het maken van deze database.
properties.restorableDroppedDatabaseId	string	De herstelde databaseresource-id die moet worden hersteld bij het maken van deze database.
properties.restorePointInTime	string (date-time)	Voorwaardelijk. Als createMode PointInTimeRestore is, is deze waarde vereist. Hiermee geeft u het tijdstip (ISO8601-indeling) van de brondatabase op die wordt hersteld om de nieuwe database te maken.
properties.sourceDatabaseId	string	De resource-id van de brondatabase die is gekoppeld aan het maken van deze database.
properties.status	ManagedDatabaseStatus	Status van de database.
properties.storageContainerIdentity	string	Voorwaardelijk. Als createMode RestoreExternalBackup is, wordt deze waarde gebruikt. Hiermee geeft u de identiteit op die wordt gebruikt voor verificatie van opslagcontainers. Kan SharedAccessSignature of ManagedIdentity zijn; als er geen SharedAccessSignature is opgegeven, wordt ervan uitgegaan.
properties.storageContainerSasToken	string	Voorwaardelijk. Als createMode RestoreExternalBackup is en storageContainerIdentity niet ManagedIdentity is, is deze waarde vereist. Hiermee geeft u het sas-token voor de opslagcontainer op.
properties.storageContainerUri	string	Voorwaardelijk. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u de URI van de opslagcontainer waarin back-ups voor deze herstel worden opgeslagen.
tags	object	Resourcetags.
type	string	Resourcetype.

ManagedDatabaseCreateMode

Opsomming

Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door deze te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up voor langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist).

Waarde	Description
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Opsomming

Status van de database.

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

Delen via

Managed Databases - Get

URI-parameters

Antwoorden

Voorbeelden

Gets a managed database

Voorbeeldaanvraag

Voorbeeldrespons

Definities

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus