调用DescribeADInfo接口查询RDS SQL Server实例的AD域信息。

该接口仅支持RDS SQL Server实例。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeADInfo

系统规定参数。取值：DescribeADInfo。

ClientToken String 否 ETnLKlblzczshOTUbOCz*****

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。
DBInstanceId String 是 rm-bp1k8s41l2o52****

实例ID。可调用DescribeDBInstances获取。

RegionId String 是 cn-hangzhou

地域ID。

返回数据

名称 类型 示例值 描述
ADStatus String 1

AD域的状态。返回值：

  • -1：正在加入AD域。
  • 0：加入AD域失败。
  • 1：加入AD域成功。
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。
ADDNS String 100.100.XX.XX

AD域的DNS信息。
ADServerIpAddress String 192.168.XX.XX

AD域的服务IP地址。
AbnormalReason String XXXX

异常原因。
UserName String test_01

AD域的用户名。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeADInfo
&ClientToken=ETnLKlblzczshOTUbOCz*****
&DBInstanceId=rm-bp1k8s41l2o52****
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式 

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

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

JSON格式 

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

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

错误码

访问错误中心查看更多错误码。