Todos os produtos
Search
Central de documentação

:DescribeReplicaSetRole

Última atualização: Jul 09, 2026

Use esta operação para consultar a função e as informações de conexão de uma instância do ApsaraDB for MongoDB.

Esta operação aplica-se a instâncias de replica set e standalone, mas não a instâncias de sharded cluster.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeReplicaSetRole

Operação a ser executada. Defina o valor como DescribeReplicaSetRole.

DBInstanceId

String

Sim

dds-bpxxxxxxxx

ID da instância.

RegionId

String

Não

cn-hangzhou

ID da região da instância. Chame a operação DescribeRegions para consultar o ID da região da instância.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdStringDB4A0595-FCA9-437F-B2BB-25DBFC009D3E

ID da solicitação.

DBInstanceIdStringdds-bpxxxxxxxx

ID da instância.

ReplicaSetsArray

Detalhes sobre as funções do replica set.

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

Endpoint do nó.

ConnectionPortString3717

Porta do nó.

ExpiredTimeString1209582

Tempo restante do endpoint de rede clássica. Unidade: segundos.

NetworkTypeStringVPC

Tipo de rede. Valores válidos:

  • VPC
  • Classic
  • Public
ReplicaSetRoleStringPrimary

Função do nó no replica set.

  • Primary
  • Secondary
RoleIdString651xxxxx

ID da função do nó.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

Para obter uma lista de códigos de erro, visite o API Error Center.