Share via


Managed Databases - Update

Met à jour une base de données existante.

PATCH 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 Type Description
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. 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 restaurant à 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ée restaurable à restaurer lors de la création de cette base de données.

properties.restorePointInTime

string

Conditionnelle. Si createMode est 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.

202 Accepted

La mise à jour de la base de données managée est en cours.

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 la 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 Non correspondanceResourceGroupNameWithUrl : le nom du groupe de ressources fourni ne correspond pas au nom dans l’URL.

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

  • 400 MismatchingSubscriptionWithUrl : l’abonnement fourni ne correspond pas à l’abonnement dans l’URL.

  • 400 MissingCollation : le 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 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId : impossible de spécifier restorableDroppedDatabaseId quand 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.

  • 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, car il n’existe pas ou vous n’avez 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 dans 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.

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

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

  • 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.

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

Exemples

Updates a managed database with maximal properties
Updates a managed database with minimal properties

Updates a managed database with maximal properties

Sample Request

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

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Sample Response

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Updates a managed database with minimal properties

Sample Request

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

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Sample Response

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

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. 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 restaurant à partir d’une sauvegarde de rétention à long terme (longTermRetentionBackupResourceId obligatoire).

ManagedDatabaseStatus

Statut de la base de données.

ManagedDatabaseUpdate

Mise à jour de base de données managée.

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

S’il faut effectuer la restauration automatique 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. 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 restaurant à 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 ancien 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ée restaurable à restaurer lors de la création de cette base de données.

properties.restorePointInTime

string

Conditionnelle. Si createMode est 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. 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 restaurant à 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

ManagedDatabaseUpdate

Mise à jour de base de données managée.

Nom Type Description
properties.autoCompleteRestore

boolean

S’il faut effectuer la restauration automatique 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. 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 restaurant à 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 ancien 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ée restaurable à restaurer lors de la création de cette base de données.

properties.restorePointInTime

string

Conditionnelle. Si createMode est 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.