Tous les produits
Search
Centre de documentation

:DescribeReplicaSetRole

Dernière mise à jour :Aug 08, 2026

Interrogez le rôle et les informations de connexion d'une instance ApsaraDB for MongoDB.

Cette opération s'applique aux instances en ensemble de réplicas et aux instances autonomes, mais pas aux clusters fragmentés (sharded cluster).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil 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 DescribeReplicaSetRole

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

DBInstanceId String Oui dds-bpxxxxxxxx

ID de l'instance.

RegionId String Non cn-hangzhou

ID de région de l'instance. Appelez l'opération DescribeRegions pour récupérer cet ID.

Paramètres de réponse

ParamètreTypeExempleDescription
RequestIdStringDB4A0595-FCA9-437F-B2BB-25DBFC009D3E

ID de la requête.

DBInstanceIdStringdds-bpxxxxxxxx

ID de l'instance.

ReplicaSetsArray

Détails sur les rôles de l'ensemble de réplicas.

ReplicaSet
ConnectionDomainStringdds-bpxxxxxxxx.mongodb.rds.aliyuncs.com

Endpoint du nœud.

ConnectionPortString3717

Port du nœud.

ExpiredTimeString1209582

Durée restante avant l'expiration de l'endpoint du réseau classique, en secondes.

NetworkTypeStringVPC

Type de réseau. Valeurs possibles :

  • VPC
  • Classic
  • Public
ReplicaSetRoleStringPrimary

Rôle du nœud dans l'ensemble de réplicas.

  • Primary
  • Secondary
RoleIdString651xxxxx

ID du rôle du nœud.

Exemples

Exemple de requête

http(s)://mongodb.aliyuncs.com/? Action=DescribeReplicaSetRole
&DBInstanceId=dds-bpxxxxxxxx
&<Common request parameters>

Exemple de réponse réussie

Format XML

<DescribeReplicaSetRoleResponse>
      <RequestId>7762D0FF-F34D-4DAF-9D06-6C1C28CC98CD</RequestId>
      <DBInstanceId>dds-bpxxxxxxxx</DBInstanceId>
      <ReplicaSets>
            <ReplicaSet>
                  <NetworkType>Classic</NetworkType>
                  <ConnectionPort>3717</ConnectionPort>
                  <ReplicaSetRole>Primary</ReplicaSetRole>
                  <ConnectionDomain>dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com</ConnectionDomain>
                  <ExpiredTime>12xxxxx</ExpiredTime>
                  <RoleId>55xxxxx</RoleId>
            </ReplicaSet>
            <ReplicaSet>
                  <NetworkType>Classic</NetworkType>
                  <ConnectionPort>3717</ConnectionPort>
                  <ReplicaSetRole>Secondary</ReplicaSetRole>
                  <ConnectionDomain>dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com</ConnectionDomain>
                  <ExpiredTime>12xxxxx</ExpiredTime>
                  <RoleId>55xxxxx</RoleId>
            </ReplicaSet>
            <ReplicaSet>
                  <NetworkType>VPC</NetworkType>
                  <ConnectionPort>3717</ConnectionPort>
                  <ReplicaSetRole>Primary</ReplicaSetRole>
                  <ConnectionDomain>dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com</ConnectionDomain>
                  <RoleId>55xxxxx</RoleId>
            </ReplicaSet>
            <ReplicaSet>
                  <NetworkType>VPC</NetworkType>
                  <ConnectionPort>3717</ConnectionPort>
                  <ReplicaSetRole>Secondary</ReplicaSetRole>
                  <ConnectionDomain>dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com</ConnectionDomain>
                  <RoleId>55xxxxx</RoleId>
            </ReplicaSet>
      </ReplicaSets>
</DescribeReplicaSetRoleResponse>

Format JSON

{
    "RequestId": "7762D0FF-F34D-4DAF-9D06-6C1C28CC98CD",
    "DBInstanceId": "dds-bpxxxxxxxx",
    "ReplicaSets": {
        "ReplicaSet": [
            {
                "NetworkType": "Classic",
                "ConnectionPort": "3717",
                "ReplicaSetRole": "Primary",
                "ConnectionDomain": "dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com",
                "ExpiredTime": "12xxxxx",
                "RoleId": "55xxxxx"
            },
            {
                "NetworkType": "Classic",
                "ConnectionPort": "3717",
                "ReplicaSetRole": "Secondary",
                "ConnectionDomain": "dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com",
                "ExpiredTime": "12xxxxx",
                "RoleId": "55xxxxx"
            },
            {
                "NetworkType": "VPC",
                "ConnectionPort": "3717",
                "ReplicaSetRole": "Primary",
                "ConnectionDomain": "dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com",
                "RoleId": "55xxxxx"
            },
            {
                "NetworkType": "VPC",
                "ConnectionPort": "3717",
                "ReplicaSetRole": "Secondary",
                "ConnectionDomain": "dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com",
                "RoleId": "55xxxxx"
            }
        ]
    }
}

Codes d'erreur

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