Managed Databases - Create Or Update

  • Référence
Service:
SQL Database
API Version:
2021-11-01

Crée une base de données ou met à jour une base de données existante.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-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

L’ID d’abonnement d’un abonnement Azure.
api-version
 query True

string

Version de l’API à utiliser pour la requête.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement 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 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. Collation, 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 obligatoire).
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é restaurable à restaurer lors de la création de cette base de données.
properties.restorePointInTime

string

Conditionnelle. Si createMode a la valeur PointInTimeRestore, cette valeur est obligatoire. Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée 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.storageContainerSasToken

string

Conditionnelle. Si createMode est RestoreExternalBackup, cette valeur est obligatoire. Spécifie le jeton sas du conteneur de stockage.
properties.storageContainerUri

string

Conditionnelle. Si createMode est RestoreExternalBackup, cette valeur est obligatoire. Spécifie l’URI du conteneur de stockage où sont stockées les sauvegardes pour cette restauration.
tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

ManagedDatabase

Mise à jour réussie de la base de données.
201 Created

ManagedDatabase

La base de données a été créée.
202 Accepted

Accepté
Other Status Codes

Réponses d’erreur : ***

  • 400 PitrPointInTimeInvalid : le point dans le temps {0} n’est pas valide. Les points dans le temps valides sont compris entre {1} les jours d’avance et maintenant et non avant l’heure de création du serveur source.

  • 400 CannotUseTrailingWhitespacesInDatabaseName : la validation du nom de la base de données a échoué.

  • 400 StorageAccountFull : Managed Instance a atteint la capacité totale du compte de stockage Azure sous-jacent. Le compte Azure Stockage Premium est limité à 35 To d’espace alloué.

  • 400 AkvHostNotResolvingFromNode : l’hôte AKV «{0} » n’est pas résolvable à partir de SQL, sur le serveur « ».{1}

  • 400 InvalidBackupRetentionPeriod : les jours de rétention de {0} ne sont pas une configuration valide. La rétention de sauvegarde valide en jours doit être comprise entre {1} et {2}

  • 400 ManagedDatabaseNameInUse : la base de données '{0}' existe déjà. Choisissez un autre nom de base de données.

  • 400 NoMoreSpaceInManagedInstance : le instance managé a atteint sa limite de stockage. L’utilisation du stockage pour le instance managé ne peut pas dépasser (%d) Mo.

  • 400 ManagedInstanceUpdateSloInProgress : « L’opération n’a pas pu être effectuée, car un changement de niveau de service est en cours pour managed instance '{0}. Attendez la fin de l’opération en cours, puis réessayez. »

  • 400 SameKeyMaterialNotFoundOnRemoteServer : le serveur secondaire n’a pas le matériel de clé du protecteur de chiffrement du serveur principal.

  • 400 SourceDatabaseNotFound : la base de données source n’existe pas.

  • 400 RegionDoesNotSupportVersion : un utilisateur a tenté de créer un serveur d’une version spécifiée à un emplacement où cette version de serveur n’est pas prise en charge.

  • 400 PasswordNotComplex : le mot de passe fourni n’est pas assez complexe.

  • 400 CannotUseReservedDatabaseName : impossible d’utiliser le nom de la base de données réservée dans cette opération.

  • 400 InvalidServerName : nom de serveur non valide spécifié.

  • 400 SourceServerNotFound : la partie serveur d’un ID de base de données source fournie dans un appel d’API CreateDatabaseAsCopy ne correspond pas à un serveur existant.

  • 400 TokenTooLong : le jeton fourni est trop long.

  • 400 CurrentDatabaseSizeExceedsMaxSize : l’utilisateur a tenté de réduire la taille maximale d’une base de données à une taille inférieure à l’utilisation actuelle.

  • 400 InvalidCollation : le classement n’est pas reconnu par le serveur.

  • 400 AkvEndpointNotReachableFromNode : le point de terminaison AKV '{0}' n’est pas accessible à partir de SQL, sur le serveur '{1}'.

  • 400 ServerNotFound : le serveur demandé est introuvable.

  • 400 UnsupportedServiceName : le nom spécifié est un nom non valide, car il contient un ou plusieurs caractères Unicode non pris en charge.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize : l’utilisateur a tenté de remplacer la base de données par une référence sku avec une taille de journal maximale inférieure à celle de l’utilisation actuelle.

  • 400 DatabaseNumberLimitReached : nombre maximal de bases de données pour SQL Database Managed Instance atteint.

  • 400 InvalidDatabaseCreateOrUpdateRequest : le corps de la demande pour l’opération de création ou de mise à jour de base de données n’est pas valide.

  • 400 InvalidResourceId - Identificateur de ressource non valide.

  • 400 InvalidSourceDatabaseId : identificateur de base de données source non valide.

  • 400 InvalidRestorableDroppedDatabaseId - Identificateur de base de données supprimé restaurable non valide

  • 400 MismatchingResourceGroupNameWithUrl : le nom du groupe de ressources fourni ne correspond pas au nom de l’URL.

  • 400 IncompatibilitéserverNameWithUrl : le nom du serveur fourni ne correspond pas au nom dans l’URL.

  • 400 IncompatibilitéSubscriptionWithUrl : l’abonnement fourni ne correspond pas à l’abonnement dans l’URL.

  • 400 MissingCollation - Classement est requis.

  • 400 MissingSourceDatabaseId : identificateur de base de données source manquant.

  • 400 MissingRestorePointInTime - Point de restauration manquant dans le temps

  • 400 MissingStorageContainerSasToken - Jeton SAP du conteneur de stockage manquant

  • 400 MissingStorageContainerUri - URI de conteneur de stockage manquant

  • 400 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Impossible de spécifier restoreableDroppedDatabaseId lorsque sourceDatabaseId est déjà donné en mode de création de restauration

  • 400 CannotUseReservedDatabaseName : impossible d’utiliser le nom de la base de données réservée dans cette opération.

  • 400 InvalidLongTermRetentionManagedInstanceBackupId : identificateur de sauvegarde de rétention à long terme non valide pour les instances managées.

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy : Geo-Restore n’est pas autorisé pour les instances managées avec redondance du stockage de sauvegarde LRS/ZRS.

  • 400 UpdatingInstanceAndBackupRedundancy - La redondance de zone d’instance et la redondance du stockage de sauvegarde ne peuvent pas être mises à jour dans la même requête.

  • 400 ProvisioningDisabled : affiche le message d’erreur de l’autorisation d’opération des ressources en l’état, sans modification

  • 400 AadOnlyAuthenticationIsEnabled : l’authentification Azure Active Directory uniquement est activée. Contactez votre administrateur système.

  • 400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée.

  • 400 TargetServerDoesNotExist : le serveur {0} cible n’existe pas ou n’est pas encore prêt. Veuillez case activée qu’il existe et réessayez la demande de restauration.

  • 400 TargetServerRestoreNotAllowed : le serveur {0} cible n’est actuellement pas dans un état qui permet de démarrer une restauration.

  • 400 BackupSetNotFound : aucune sauvegarde n’a été trouvée pour restaurer la base de données. Contactez le support technique pour restaurer la base de données.

  • 400 FullBackupNotFound - La sauvegarde complète est introuvable.

  • 400 MissingThumbprint : certificat de serveur introuvable.

  • 400 RestoreFromStripedBackupsNotEnabled : la restauration à partir de sauvegardes entre bandes n’est pas prise en charge.

  • 400 BackupSetBroken - L’ensemble de sauvegarde est rompu.

  • 400 BrokenRestorePlanNoFullBackup : le plan de restauration est rompu, car il n’y a pas de sauvegarde complète.

  • 400 SqlRestoreError - Une erreur non retriable s’est produite lors de la restauration de la sauvegarde avec l’index {0} - {1}{2}

  • 400 BrokenRestorePlanWrongLogBackupLSN : le plan de restauration est rompu, car le premierLsn de la sauvegarde du journal actuel n’est pas <= lastLsn de la sauvegarde du journal suivante.

  • 400 BrokenRestorePlanWrongDiffBackupLSN : le plan de restauration est rompu, car firstLsn de diff sauvegarde n’est pas >= firstLsn de sauvegarde complète.

  • 400 BrokenRestorePlanGapInLogBackups : le plan de restauration est rompu, car le premierLsn de la sauvegarde actuelle du journal n’est pas égal à lastLsn de la sauvegarde du journal antérieur.

  • 400 PartiellementContainedDatabaseUnsupported : « La sauvegarde d’une base de données partiellement autonome n’est pas prise en charge ».

  • 400 RequiredBackupIsNotLastRestored - Impossible de terminer la migration, car le nom du fichier de sauvegarde fourni n’est pas le nom du dernier fichier de sauvegarde restauré.

  • 400 XtpInitializedDuringRestore : le groupe de fichiers à mémoire optimisée doit être vide pour être restauré sur usage général niveau de SQL Database Managed Instance.

  • 400 FullBackupMissingChecksum : la somme de contrôle est manquante pour la sauvegarde complète.

  • 400 FullBackupDamaged : la sauvegarde complète est endommagée.

  • 400 MissingStripeInBackupSet : le jeu de sauvegarde fourni a une ou plusieurs bandes manquantes.

  • 400 BrokenRestorePlanWrongDiffBaseGUID : le plan de restauration est rompu, car DifferentialBaseGuid de diff sauvegarde ne correspond pas à BackupSetGuid de la sauvegarde complète.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles - La sauvegarde de base de données contient une disposition physique incompatible. Aucun fichier de données n’est trouvé dans la sauvegarde.

  • 400 CorruptedPagesInBackupSet : l’opération a été abandonnée, car RESTORE a détecté une ou plusieurs pages endommagées dans le jeu de sauvegarde.

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - La sauvegarde de base de données contient une disposition physique incompatible. Il existe des fichiers de données non en ligne.

  • 400 CorruptedPagesListMaintenance : l’opération a été abandonnée car une erreur interne s’est produite lors du traitement de la sauvegarde effectuée sans somme de contrôle.

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - La sauvegarde de base de données contient une disposition physique incompatible. Les fichiers journaux multiples ne sont pas pris en charge.

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - La sauvegarde de base de données contient une disposition physique incompatible. Il existe des fichiers journaux non en ligne.

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - La sauvegarde de base de données contient une disposition physique incompatible. Trop de fichiers non-données/journaux.

  • 400 ExternalBackupAlreadySignaledToComplete : la demande de restauration a déjà été signalée comme terminée.

  • 400 ExternalBackupRestoreHasNotBeenStarted : la demande de restauration ne peut être effectuée qu’une fois la restauration démarrée.

  • 400 ExternalBackupUpgradeInProgress : la demande de restauration ne peut pas être effectuée, car la mise à niveau est en cours.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles - La sauvegarde de base de données contient une disposition physique incompatible. Plusieurs fichiers trouvés dans le groupe de fichiers qui contient MEMORY_OPTIMIZED_DATA.

  • 400 BlobStorageFailure - Échec du stockage d’objets blob.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart : il existe des sauvegardes à partir de plusieurs bases de données dans le dossier conteneur. Vérifiez que le dossier conteneur contient des sauvegardes à partir d’une base de données unique.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart : l’identité managée n’est pas configurée correctement. Vérifiez et réessayez.

  • 400 ManagedInstanceStorageLimitHit : le instance managé a atteint sa limite de stockage.

  • 400 AutoCompleteMissingLastBackupName : le paramètre lastBackupName doit être fourni pour la demande de restauration automatique.

  • 400 BlobStorageServerFailure - Échec du serveur de stockage Blob.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress : il existe des sauvegardes à partir de plusieurs bases de données dans le dossier conteneur. Vérifiez que le dossier conteneur contient des sauvegardes à partir d’une base de données unique.{0}

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress : l’identité managée n’est pas configurée correctement. Vérifiez et réessayez.

  • 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable

  • 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 ResourceNotFound : la ressource demandée est introuvable.

  • 404 CannotFindServerCertificateWithThumbprint - Impossible de trouver le certificat de serveur avec l’empreinte numérique '{0}'. Utilisez l’applet de commande PowerShell « Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate » pour créer le certificat.

  • 404 CannotFindObject - Impossible de trouver l’objet parce qu’il n’existe pas ou que vous ne disposez pas d’autorisations

  • 404 SubscriptionNotFound : l’abonnement demandé est introuvable.

  • 404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur ce serveur instance.

  • 404 ServerNotInSubscription : le serveur spécifié n’existe pas sur l’abonnement spécifié.

  • 404 RestoreSourceDatabaseNotFound : impossible de trouver la base de données «{0} » à l’heure «{1} » qui peut être restaurée.

  • 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 409 RemoteDatabaseExists : le nom de la base de données de destination existe déjà sur le serveur de destination.

  • 409 ConflictingDatabaseOperation : il existe déjà une opération sur la base de données et l’opération actuelle doit attendre qu’elle soit terminée.

  • 409 SubscriptionDisabled - L’abonnement est désactivé.

  • 409 ManagementServiceDatabaseBusy - La base de données '{0}' est occupée par une autre opération. Essayez votre opération ultérieurement.

  • 409 ConflictingSystemOperationInProgress : une opération de maintenance du système est en cours sur la base de données et d’autres opérations doivent attendre qu’elle soit terminée.

  • 409 ConflictingManagedInstanceOperation : une opération est actuellement en cours pour le instance managé.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict : le instance est multi-az, mais le stockage de sauvegarde est mis à jour de redondant interzone à non redondant interzone.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress : impossible de mettre à jour instance redondance, car la mise à jour de la redondance du stockage de sauvegarde est en cours.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict : le stockage de sauvegarde n’est pas redondant interzone, mais instance redondance est mise à jour vers une redondance interzone.

  • 409 BackupRedundancyUpdateConflict : impossible de mettre à jour la redondance du stockage de sauvegarde, car une mise à jour de la redondance du stockage de sauvegarde est déjà en cours.

  • 409 MiDropFailedOnAuthLocks : l’utilisateur a essayé de supprimer la dernière Managed Instance dans le sous-réseau auquel le verrou a été appliqué sur la ou les ressources.

  • 409 MiCreateFailedNonDelegatedSubnet : l’utilisateur a essayé de déployer Managed Instance ou Managed Instance pool dans un sous-réseau qui n’est pas délégué à Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate : impossible de mettre à jour la redondance du stockage de sauvegarde, car le instance n’est pas prêt.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 ConflictingSubscriptionOperation : une opération est actuellement en cours pour l’abonnement.

  • 500 ActivateOrDeactivateWorkflowThrottling - Échec du workflow d’activation ou de désactivation, car il y a trop de flux de travail simultanés

  • 503 DatabaseUnavailable : l’opération a échoué, car la base de données n’est pas disponible.

  • 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

  • 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

  • 504 RequestTimeout - La demande de service a dépassé le délai d’expiration autorisé.

  • 504 RequestTimeout - La demande de service a dépassé le délai d’expiration autorisé.

Exemples

Creates a new managed database by restoring from an external backup
Creates a new managed database from restoring a geo-replicated backup
Creates a new managed database from restoring a long term retention backup
Creates a new managed database using point in time restore
Creates a new managed database with maximal properties
Creates a new managed database with minimal properties

Creates a new managed database by restoring from an external backup

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "autoCompleteRestore": true,
    "lastBackupName": "last_backup_name"
  },
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database from restoring a geo-replicated backup

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/databases/testdb_recovered?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Recovery",
    "recoverableDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"
  }
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database from restoring a long term retention backup

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database using point in time restore

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb",
    "restorePointInTime": "2017-07-14T05:35:31.503Z"
  }
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database with maximal properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database with minimal properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Définitions

Nom Description
CatalogCollationType

Classement du catalogue de métadonnées.
ManagedDatabase

Une 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 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. Collation, 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 obligatoire).
ManagedDatabaseStatus

Statut de la base de données.

CatalogCollationType

Classement du catalogue de métadonnées.

Nom Type Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

Une ressource de base de données managée.

Nom Type Description
id

string

ID de la ressource
location

string

Emplacement de la ressource.
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 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. Collation, 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 obligatoire).
properties.creationDate

string

Date de création de la base de données.
properties.defaultSecondaryLocation

string

Région associée géographiquement.
properties.earliestRestorePoint

string

Point de restauration le plus tôt dans le temps pour la restauration dans le temps.
properties.failoverGroupId

string

Identificateur de ressource du groupe de basculement d’instance auquel appartient cette base de données managé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é restaurable à restaurer lors de la création de cette base de données.
properties.restorePointInTime

string

Conditionnelle. Si createMode a la valeur PointInTimeRestore, cette valeur est obligatoire. Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée 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

Statut de la base de données.
properties.storageContainerSasToken

string

Conditionnelle. Si createMode est RestoreExternalBackup, cette valeur est obligatoire. Spécifie le jeton sas du conteneur de stockage.
properties.storageContainerUri

string

Conditionnelle. Si createMode est RestoreExternalBackup, cette valeur est obligatoire. Spécifie l’URI du conteneur de stockage où sont stockées les sauvegardes pour cette restauration.
tags

object

Balises de ressource.
type

string

Type de ressource.

ManagedDatabaseCreateMode

Mode de création de base de données managée. PointInTimeRestore : créez une base de données en restaurant une sauvegarde 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. Collation, 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 obligatoire).

Nom Type Description
Default

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

Statut de la base de données.

Nom Type Description
Creating

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string