Todos os produtos
Search

Este produto

    :Consultar informações do domínio AD

    Central de documentação

    :Consultar informações do domínio AD

    Última atualização: Jun 26, 2026

    Use a operação DescribeADInfo para consultar as informações do domínio Active Directory (AD) de uma instância ApsaraDB RDS for SQL Server.

    Esta operação está disponível apenas para instâncias ApsaraDB RDS for SQL Server.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

    Parâmetros de solicitação

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    Action

    String

    Sim

    DescribeADInfo

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

    ClientToken

    String

    Não

    ETnLKlblzczshOTUbOCz*

    Token do cliente usado para garantir a idempotência da solicitação. Gere o valor no cliente e garanta que seja único entre solicitações distintas. O token aceita apenas caracteres ASCII e tem limite de 64 caracteres.

    DBInstanceId

    String

    Sim

    rm-bp1k8s41l2o52****

    ID da instância. Para obter esse ID, use a operação DescribeDBInstances.

    RegionId

    String

    Sim

    cn-hangzhou

    ID da região.

    Parâmetros de resposta

    Parâmetro Tipo Exemplo Descrição
    ADStatus String 1

    Status do domínio AD. Valores válidos:

    • -1: Adição da instância ao domínio AD em andamento.
    • 0: Falha na adição da instância ao domínio AD.
    • 1: Instância adicionada ao domínio AD.
    RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

    ID da solicitação.

    ADDNS String 100.100.XX.XX

    Informações de DNS do domínio AD.

    ADServerIpAddress String 192.168.XX.XX

    Endereço IP de serviço do domínio AD.

    AbnormalReason String XXXX

    Causa da exceção.

    UserName String test_01

    Nome de usuário do domínio AD.

    Exemplos

    Solicitações de exemplo

    http(s)://[Endpoint]/?Action=DescribeADInfo
&ClientToken=ETnLKlblzczshOTUbOCz*****
&DBInstanceId=rm-bp1k8s41l2o52****
&RegionId=cn-hangzhou
&<Common request parameters>

    Respostas de sucesso de exemplo

    Formato XML

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

<DescribeADInfoResponse>
    <RequestId>DA62101F-9710-506F-B9A4-DD89C432B04B</RequestId>
</DescribeADInfoResponse>

    Formato JSON

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

{
  "RequestId" : "DA62101F-9710-506F-B9A4-DD89C432B04B"
}

    Códigos de erro

    Para obter uma lista de códigos de erro, visite a Central de Erros de API.