Tous les produits
Search
Centre de documentation

:Interroger les poids de lecture attribués par le système

Dernière mise à jour :Aug 19, 2026

Appelez l'opération CalculateDBInstanceWeight pour interroger les poids de lecture attribués par le système à une instance principale et à ses instances en lecture seule.

Lorsque la fonctionnalité de répartition lecture/écriture est activée, cette opération calcule les poids de lecture attribués par le système. Pour plus d'informations sur les poids de lecture personnalisés, consultez l'opération DescribeDBInstanceNetInfo.

Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

  • La fonctionnalité de proxy partagé est activée pour votre instance ApsaraDB RDS for MySQL.

  • L'instance doit exécuter l'une des versions de moteur de base de données et éditions RDS suivantes :

    • MySQL 5.7 sur RDS High-availability Edition (avec des SSD locaux)

    • MySQL 5.6

    • SQL Server sur RDS Cluster Edition

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

CalculateDBInstanceWeight

Opération à effectuer. Définissez la valeur sur CalculateDBInstanceWeight.

DBInstanceId

String

Oui

rm-uf6wjk5xxxxxxx

ID de l'instance principale.

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String C816A4BF-A6EC-4722-95F9-2055859CCFD2

ID de la requête.

Items Array of DBInstanceWeight

Tableau contenant les poids de lecture attribués par le système.

DBInstanceWeight
ReadonlyInstanceSQLDelayedTime String 30

Seuil de latence de la réplication des données de l'instance principale vers les instances en lecture seule. Les instances en lecture seule commencent à synchroniser les données depuis l'instance principale après l'écoulement du délai spécifié par le paramètre ReadonlyInstanceSQLDelayedTime. Unité : secondes.

Weight String 100

Poids de lecture calculé en temps réel par ApsaraDB RDS pour l'instance.

DBInstanceType String Master

Rôle de l'instance. Valeurs possibles :

  • Master : instance principale
  • Readonly : instance en lecture seule
DBInstanceId String rm-uf6wjk5xxxxxxx

ID de l'instance.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CalculateDBInstanceWeight
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Exemple de réponse réussie

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CalculateDBInstanceWeightResponse>
    <RequestId>4139E1C3-0480-5A50-B327-23E6B1028906</RequestId>
    <Items>
        <DBInstanceWeight>
            <Role>master</Role>
            <DBInstanceId>******</DBInstanceId>
            <DBInstanceType>Readonly</DBInstanceType>
            <Weight>400</Weight>
        </DBInstanceWeight>
        <DBInstanceWeight>
            <Role>master</Role>
            <DBInstanceId>******</DBInstanceId>
            <DBInstanceType>Master</DBInstanceType>
            <Weight>0</Weight>
        </DBInstanceWeight>
        <DBInstanceWeight>
            <Role>slave</Role>
            <DBInstanceId>******</DBInstanceId>
            <DBInstanceType>Master</DBInstanceType>
            <Weight>1600</Weight>
        </DBInstanceWeight>
    </Items>
</CalculateDBInstanceWeightResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4139E1C3-0480-5A50-B327-23E6B1028906",
  "Items" : {
    "DBInstanceWeight" : [ {
      "Role" : "master",
      "DBInstanceId" : "******",
      "DBInstanceType" : "Readonly",
      "Weight" : "400"
    }, {
      "Role" : "master",
      "DBInstanceId" : "******",
      "DBInstanceType" : "Master",
      "Weight" : "0"
    }, {
      "Role" : "slave",
      "DBInstanceId" : "******",
      "DBInstanceType" : "Master",
      "Weight" : "1600"
    } ]
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.