Obtenir la topologie d'une instance - - Centre de documentation Alibaba Cloud

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	GetDBInstanceTopology	Nom de l'opération à effectuer. Définissez la valeur sur GetDBInstanceTopology.
DBInstanceId	String	Oui	rm-uf6wjk5***	ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer l'ID de l'instance.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	Aucun	Paramètre interne. Vous pouvez l'ignorer.
Message	String	Aucun	Paramètre interne. Vous pouvez l'ignorer.
RequestId	String	7430AB1A-6D49-5B6D-B9E5-920250076074	ID de la requête.
Data	Object		Détails de la topologie.
DBInstanceName	String	rm-m5ezban**********	ID de l'instance.
Connections	Array of Connection		Connexions réseau de l'instance.
ZoneId	String	cn-qingdao-c	ID de la zone.
DBInstanceName	String	rm-m5ezban**********	ID de l'instance.
ConnectionString	String	rm-m5ezban**********.mysql.rds.aliyuncs.com	Endpoint utilisé pour se connecter à l'instance.
NetType	String	vpc	Type de réseau de l'endpoint. Valeurs possibles : vpc public
Nodes	Array of Node		Informations sur les nœuds.
DBInstanceName	String	rm-m5ezban**********	ID de l'instance.
ZoneId	String	cn-qingdao-c	ID de la zone.
DedicatedHostId	String	i-bpxxxxxxx	ID de l'hôte hébergeant l'instance dans le cluster dédié. Remarque Si l'instance ne réside pas dans un cluster dédié, aucune valeur n'est renvoyée.
Role	String	master	Type du nœud. Valeurs possibles : Master : nœud principal Slave : nœud secondaire
NodeId	String	349054	ID de l'instance. Remarque La valeur -1 est renvoyée pour les instances qui ne résident pas dans un cluster dédié.
DedicatedHostGroupId	String	dhg-4n*****	ID du cluster dédié. Remarque Si l'instance ne réside pas dans le cluster dédié spécifié, aucune valeur n'est renvoyée.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=GetDBInstanceTopology
&DBInstanceId=rm-uf6wjk5*******
&Common request parameters

Exemples de réponses réussies

XML format

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

<GetDBInstanceTopologyResponse>
    <RequestId>CF5A551A-80EF-1D3D-8F43-6B52C1E2EF71</RequestId>
    <Data>
    </Data>
</GetDBInstanceTopologyResponse>

JSON format

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

{
  "RequestId" : "CF5A551A-80EF-1D3D-8F43-6B52C1E2EF71",
  "Data" : {
    "Connections" : [ ],
    "Nodes" : [ ]
  }
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidAction	Specified action is not valid.	L'opération n'est pas prise en charge.
403	DBInstanceStatusNotActive	The status of the current instance is not active.	L'état de l'instance ne permet pas d'effectuer l'opération.
403	DBTypeNotSupported	The database type is not supported.	Le type de base de données n'est pas pris en charge.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	L'instance spécifiée est introuvable. Vérifiez l'ID de l'instance.

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