DescribeReplicaSetRole - - Centro de documentación de Alibaba Cloud

Puede llamar a esta operación para consultar el rol y la información de conexión de una instancia de ApsaraDB for MongoDB.

Esta operación se aplica a instancias de conjunto de réplicas e instancias independientes, pero no a instancias de clúster fragmentado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeReplicaSetRole	La operación que desea ejecutar. Establezca el valor en DescribeReplicaSetRole.
DBInstanceId	String	Sí	dds-bpxxxxxxxx	El ID de la instancia.
RegionId	String	No	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar el ID de región de la instancia.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	DB4A0595-FCA9-437F-B2BB-25DBFC009D3E	El ID de la solicitud.
DBInstanceId	String	dds-bpxxxxxxxx	El ID de la instancia.
ReplicaSets	Array		Detalles sobre los roles del conjunto de réplicas.
ReplicaSet
ConnectionDomain	String	dds-bpxxxxxxxx.mongodb.rds.aliyuncs.com	El endpoint del nodo.
ConnectionPort	String	3717	El puerto del nodo.
ExpiredTime	String	1209582	La duración restante del endpoint de red clásica. Unidad: segundos.
NetworkType	String	VPC	El tipo de red. Valores válidos: VPC Classic Public
ReplicaSetRole	String	Primary	El rol del nodo en el conjunto de réplicas. Primary Secondary
RoleId	String	651xxxxx	El ID de rol del nodo.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato 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>

Formato 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"
            }
        ]
    }
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.