Todos os produtos
Search
Central de documentação

:Modifique as informações do domínio AD

Última atualização: Jun 26, 2026

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

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

Debugging

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Request parameters

Parameter

Type

Required

Example

Description

Action

String

Yes

ModifyADInfo

A operação que você deseja executar. Defina o valor como ModifyADInfo.

ClientToken

String

No

ETnLKlblzczshOTUbOCzxxxxxxx

O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre solicitações diferentes. O token pode conter apenas caracteres ASCII e não pode ultrapassar 64 caracteres.

DBInstanceId

String

Yes

rm-uf6wjk5xxxxxxx

O ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.

RegionId

String

Yes

cn-hangzhou

O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ADDNS

String

No

example.com

As informações de DNS do domínio AD.

ADServerIpAddress

String

No

47.100.XX.XX

O endereço IP do domínio AD.

ADAccountName

String

No

test_account

A conta do domínio AD.

ADPassword

String

No

test_password

A senha da conta do domínio AD.

Response parameters

Parameter

Type

Example

Description

RequestId

String

1AD222E9-E606-4A42-BF6D-8A4442913CEF

O ID da solicitação.

Examples

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyADInfo
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxx
&DBInstanceId=rm-uf6wjk5xxxxxxx
&RegionId=cn-hangzhou
&ADDNS=100.100.XX.XX
&ADServerIpAddress=192.168.XX.XX
&ADAccountName=test_account
&ADPassword=test_password
&Common request parameters

Exemplos de respostas bem-sucedidas

XML format

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

<ModifyADInfoResponse>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
</ModifyADInfoResponse>

JSON format

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

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF"
}

Error codes

Para obter a lista de códigos de erro, acesse o API Error Center.