Managed Databases - Get

Service:: SQL Database

Version d'API:: 2023-08-01

Obtient une base de données managée.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
managedInstanceName	path	True	string	Nom de l’instance managée.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	ManagedDatabase	Récupération réussie de la base de données managée spécifiée.
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 400 ManagedInstanceStoppingOrStopped : opération en conflit envoyée pendant l’arrêt/l’état arrêté de l’instance 400 ManagedInstanceStarting - Opération en conflit envoyée pendant que l’instance est à l’état de démarrage 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable 404 ResourceNotFound : la ressource demandée est introuvable.

Nom

Type

Description

200 OK

ManagedDatabase

Récupération réussie de la base de données managée spécifiée.

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

400 ManagedInstanceStoppingOrStopped : opération en conflit envoyée pendant l’arrêt/l’état arrêté de l’instance
400 ManagedInstanceStarting - Opération en conflit envoyée pendant que l’instance est à l’état de démarrage
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable
404 ResourceNotFound : la ressource demandée est introuvable.

Exemples

Gets a managed database

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
CatalogCollationType	Classement du catalogue de métadonnées.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ManagedDatabase	Ressource de base de données managée.
ManagedDatabaseCreateMode	Mode de création de base de données managée. PointInTimeRestore : Créez une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. SourceDatabaseName, SourceManagedInstanceName et PointInTime doivent être spécifiés. RestoreExternalBackup : Créez une base de données en restaurant à partir de fichiers de sauvegarde externes. Le classement, StorageContainerUri et StorageContainerSasToken doivent être spécifiés. Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. RecoverableDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer. RestoreLongTermRetentionBackup : créez une base de données en effectuant une restauration à partir d’une sauvegarde de rétention à long terme (longTermRetentionBackupResourceId requis).
ManagedDatabaseStatus	État de la base de données.

CatalogCollationType

Énumération

Classement du catalogue de métadonnées.

Valeur	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ManagedDatabase

Objet

Ressource de base de données managée.

Nom	Type	Description
id	string	ID de ressource.
location	string	Emplacement des ressources.
name	string	Nom de la ressource.
properties.autoCompleteRestore	boolean	Indique s’il faut effectuer automatiquement la restauration de cette base de données managée.
properties.catalogCollation	CatalogCollationType	Classement du catalogue de métadonnées.
properties.collation	string	Classement de la base de données managée.
properties.createMode	ManagedDatabaseCreateMode	Mode de création de base de données managée. PointInTimeRestore : Créez une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. SourceDatabaseName, SourceManagedInstanceName et PointInTime doivent être spécifiés. RestoreExternalBackup : Créez une base de données en restaurant à partir de fichiers de sauvegarde externes. Le classement, StorageContainerUri et StorageContainerSasToken doivent être spécifiés. Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. RecoverableDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer. RestoreLongTermRetentionBackup : créez une base de données en effectuant une restauration à partir d’une sauvegarde de rétention à long terme (longTermRetentionBackupResourceId requis).
properties.creationDate	string (date-time)	Date de création de la base de données.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	L’ID de ressource de base de données pouvant être restauré entre abonnements a été supprimé lors de la création de cette base de données.
properties.crossSubscriptionSourceDatabaseId	string	Identificateur de ressource de la base de données source inter-abonnement associée à l’opération de création de cette base de données.
properties.crossSubscriptionTargetManagedInstanceId	string	ID d’instance managée cible utilisé dans la restauration entre abonnements.
properties.defaultSecondaryLocation	string	Région géo-jumelée.
properties.earliestRestorePoint	string (date-time)	Point de restauration le plus ancien dans le temps pour la restauration dans le temps.
properties.failoverGroupId	string	Identificateur de ressource de groupe de basculement d’instance auquel appartient cette base de données managée.
properties.isLedgerOn	boolean	Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée.
properties.lastBackupName	string	Nom du dernier fichier de sauvegarde pour la restauration de cette base de données managée.
properties.longTermRetentionBackupResourceId	string	Nom de la sauvegarde de rétention à long terme à utiliser pour la restauration de cette base de données managée.
properties.recoverableDatabaseId	string	Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données.
properties.restorableDroppedDatabaseId	string	ID de ressource de base de données supprimé pouvant être restauré lors de la création de cette base de données.
properties.restorePointInTime	string (date-time)	Conditionnel. Si createMode est PointInTimeRestore, cette valeur est requise. Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données.
properties.sourceDatabaseId	string	Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données.
properties.status	ManagedDatabaseStatus	État de la base de données.
properties.storageContainerIdentity	string	Conditionnel. Si createMode est RestoreExternalBackup, cette valeur est utilisée. Spécifie l’identité utilisée pour l’authentification de conteneur de stockage. Peut être « SharedAccessSignature » ou « ManagedIdentity » ; s’il n’est pas spécifié « SharedAccessSignature » est supposé.
properties.storageContainerSasToken	string	Conditionnel. Si createMode est RestoreExternalBackup et storageContainerIdentity n’est pas ManagedIdentity, cette valeur est requise. Spécifie le jeton sas du conteneur de stockage.
properties.storageContainerUri	string	Conditionnel. Si createMode est RestoreExternalBackup, cette valeur est requise. Spécifie l’URI du conteneur de stockage dans lequel les sauvegardes de cette restauration sont stockées.
tags	object	Balises de ressource.
type	string	Type de ressource.

ManagedDatabaseCreateMode

Énumération

Mode de création de base de données managée. PointInTimeRestore : Créez une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. SourceDatabaseName, SourceManagedInstanceName et PointInTime doivent être spécifiés. RestoreExternalBackup : Créez une base de données en restaurant à partir de fichiers de sauvegarde externes. Le classement, StorageContainerUri et StorageContainerSasToken doivent être spécifiés. Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. RecoverableDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer. RestoreLongTermRetentionBackup : créez une base de données en effectuant une restauration à partir d’une sauvegarde de rétention à long terme (longTermRetentionBackupResourceId requis).

Valeur	Description
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Énumération

État de la base de données.

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

Partager via

Managed Databases - Get

Paramètres URI

Réponses

Exemples

Gets a managed database

Exemple de requête

Exemple de réponse

Définitions

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus