Tous les produits
Search

Ce produit

    :UpdateInstance

    Centre de documentation

    :UpdateInstance

    Dernière mise à jour :Aug 07, 2026

    Met à jour les informations relatives à une instance de base de données et vérifie sa connectivité.

    Description de l'opération

    Avant d'appeler l'opération UpdateInstance, appelez l'opération GetInstance ou ListInstances pour obtenir les informations complètes sur l'instance.

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    dms:UpdateInstance

    update

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    Tid

    integer

    Non

    L'identifiant du locataire. Vous pouvez appeler l'opération GetUserActiveTenant pour interroger l'identifiant du locataire.

    3***
    InstanceType

    string

    Oui

    Le type de la base de données. Pour plus d'informations sur les valeurs valides de ce paramètre, consultez la section Paramètre DbType.

    mysql
    InstanceSource

    string

    Oui

    La source de l'instance de base de données. Valeurs valides :

    • PUBLIC_OWN : une instance de base de données autogérée déployée sur Internet

    • RDS : une instance ApsaraDB RDS

    • ECS_OWN : une base de données autogérée déployée sur une instance Elastic Compute Service (ECS)

    • VPC_IDC : une instance de base de données autogérée déployée dans un centre de données connecté via un réseau privé virtuel (VPC)

    ECS_OWN
    EnvType

    string

    Oui

    Le type d'environnement dans lequel l'instance de base de données est déployée. Valeurs valides :

    • product : environnement de production

    • dev : environnement de développement

    • pre : environnement de pré-production

    • test : environnement de test

    • sit : environnement de test d'intégration système (SIT)

    • uat : environnement de test d'acceptation utilisateur (UAT)

    • pet : environnement de test de charge

    • stag : environnement de préparation

    Valeurs valides :

    • product :

      product.

    • pre :

      pre.

    • dev :

      dev.

    • test :

      test.

    product
    EcsInstanceId

    string

    Non

    L'identifiant de l'instance ECS sur laquelle l'instance de base de données est déployée.

    Remarque

    Ce paramètre est requis si le paramètre InstanceSource est défini sur ECS_OWN.

    i-2zei9gs1t7h8l7ac****
    VpcId

    string

    Non

    L'identifiant du VPC auquel l'instance de base de données appartient.

    Remarque

    Ce paramètre est requis si le paramètre InstanceSource est défini sur VPC_IDC.

    vpc-xxx
    EcsRegion

    string

    Non

    L'identifiant de la région dans laquelle l'instance de base de données réside.

    Remarque

    Ce paramètre est requis si InstanceSource est défini sur RDS, ECS_OWN et VPC_IDC.

    cn-hangzhou
    Host

    string

    Oui

    L'adresse de l'hôte utilisée pour se connecter à l'instance de base de données.

    192.XXX.0.56
    Port

    integer

    Oui

    Le port utilisé pour se connecter à l'instance de base de données.

    3306
    Sid

    string

    Non

    L'identifiant système (SID) de l'instance de base de données.

    Remarque

    Ce paramètre est requis si le paramètre InstanceType est défini sur ORACLE.

    XXX
    DatabaseUser

    string

    Oui

    Le compte utilisé pour se connecter à la base de données.

    dbuser
    DatabasePassword

    string

    Oui

    Le mot de passe utilisé pour se connecter à la base de données.

    ******
    InstanceAlias

    string

    Oui

    L'alias de l'instance de base de données. Spécifiez un alias qui peut vous aider à identifier l'instance de base de données dans DMS.

    instance_test
    DbaId

    string

    Oui

    L'identifiant de l'utilisateur qui assume le rôle d'administrateur de base de données (DBA) de l'instance de base de données. Vous pouvez appeler l'opération ListUsers ou GetInstance pour interroger l'identifiant de l'utilisateur.

    27****
    SafeRuleId

    string

    Oui

    Le nom de l'ensemble de règles de sécurité (GroupName) pour l'instance. Vous pouvez appeler l'opération ListStandardGroups ou GetInstance pour interroger le nom de l'ensemble de règles de sécurité.

    3****
    QueryTimeout

    integer

    Oui

    Le délai d'attente pour les requêtes de données dans l'instance de base de données.

    60
    ExportTimeout

    integer

    Oui

    Le délai d'attente pour l'exportation des données depuis l'instance de base de données.

    600
    DataLinkName

    string

    Non

    Le nom du lien de base de données pour les requêtes inter-bases de données.

    Remarque

    • Ce paramètre est requis si UseDsql est défini sur 1.

    • Le nom ne peut contenir que des lettres minuscules et des traits de soulignement (_).

    • Le nom doit être unique au sein d'un locataire.

    datalink_test
    DdlOnline

    integer

    Non

    Indique si la fonctionnalité de modification de schéma sans verrouillage doit être activée pour l'instance de base de données. Valeurs valides :

    • 0 : désactive la fonctionnalité de modification de schéma sans verrouillage.

    • 1 : utilise d'abord le DDL en ligne de MySQL.

    • 2 : utilise d'abord la fonctionnalité de modification de schéma sans verrouillage de DMS.

    0
    UseDsql

    integer

    Non

    Indique si la fonctionnalité de requête inter-bases de données doit être activée pour l'instance de base de données. Valeurs valides :

    • 0 : désactive la fonctionnalité de requête inter-bases de données.

    • 1 : active la fonctionnalité de requête inter-bases de données.

    Remarque

    Types de bases de données pris en charge : MySQL, SQL Server, PostgreSQL, PolarDB for PostgreSQL (compatible avec Oracle) et ApsaraDB for Redis.

    0
    InstanceId

    string

    Oui

    L'identifiant de l'instance de base de données. Vous pouvez appeler l'opération GetInstance pour interroger l'identifiant de l'instance.

    126****
    SkipTest

    boolean

    Non

    Indique si le test de connectivité doit être ignoré. Valeurs valides :

    • true : ignore le test de connectivité

    • false : n'ignore pas le test de connectivité

    false
    EnableSellSitd

    string

    Non

    • Y : active la fonctionnalité de protection des données sensibles

    • N : désactive la fonctionnalité de protection des données sensibles

    • NULL ou autre : ne met pas à jour l'état de la fonctionnalité de protection des données sensibles

    Y
    TemplateId

    integer

    Non

    L'identifiant du modèle de classification. Vous pouvez appeler l'opération ListClassificationTemplates pour interroger l'identifiant du modèle.

    3***
    TemplateType

    string

    Non

    Le type du modèle de classification. Vous pouvez appeler l'opération ListClassificationTemplates pour interroger le type de modèle.

    INNER

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    RequestId

    string

    L'identifiant de la requête.

    E9BEBF41-4F69-4605-A5D5-A67955173941
    ErrorCode

    string

    Le code d'erreur renvoyé si la requête a échoué.

    UnknownError
    ErrorMessage

    string

    Le message d'erreur renvoyé si la requête a échoué.

    UnknownError
    Success

    boolean

    Indique si la requête a réussi. Valeurs valides :

    • true : la requête a réussi.

    • false : la requête a échoué.

    false

    Exemples

    JSON format

    {
  "RequestId": "E9BEBF41-4F69-4605-A5D5-A67955173941",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": false
}

    Codes d'erreur

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.