调用DescribeVirtualMFADevices查询AD用户绑定的虚拟MFA设备。

调试

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

请求参数

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

系统规定参数。取值：DescribeVirtualMFADevices。
DirectoryId String 是 cn-shanghai+dir-afqe6hvw6amiz****

AD目录ID。
RegionId String 是 cn-hangzhou

地域ID。
MaxResults Integer 否 100

返回结果的最大数量。取值范围：1~500。默认值：100。
NextToken String 否 caeba0bbb2be03f84eb48b699f0a4883

查询凭证。取值为上一次API调用时返回的NextToken参数值。
EndUserId.N RepeatList 否 testuser

AD用户名。

返回数据

名称 类型 示例值 描述
NextToken String AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as

下一个查询开始的Token，NextToken为空表示没有下一个。
RequestId String FB550AAB-FB36-4A91-93F6-F4374AF65403

请求ID。
VirtualMFADevices Array of VirtualMFADevice

虚拟MFA设备信息集合。
ConsecutiveFails Integer 1

连续绑定或者认证虚拟MFA设备失败的次数。
DirectoryId String cn-hangzhou+dir-gx2x1dhsmu52rd****

AD用户所属的AD目录ID。
EndUserId String usertest

使用该虚拟MFA设备的AD用户名。
GmtEnabled String 2020-12-20T14:52:28Z

虚拟MFA设备启用时间。按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

GmtUnlock String 2020-12-21T15:21:28Z

虚拟MFA设备被锁定后的自动解锁时间。按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

SerialNumber String a25f297f-f2e1-4a44-bbf1-5f48a6e5****

虚拟MFA设备序列号，唯一标识。
status String NORMAL

虚拟MFA设备状态。可能值：

  • UNBOUND：未绑定
  • NORMAL：正常
  • LOCKED：已锁定

示例

请求示例

https://ecd.cn-hangzhou.aliyuncs.com/?Action=DescribeVirtualMFADevices
&DirectoryId=cn-shanghai+dir-afqe6hvw6amiz****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

<DescribeVirtualMFADevicesResponse>
      <VirtualMFADevices>
            <GmtEnabled>2020-12-20T14:52:28Z</GmtEnabled>
            <EndUserId>usertest</EndUserId>
            <DirectoryId>cn-hangzhou+dir-gx2x1dhsmu52rd****</DirectoryId>
            <SerialNumber>a25f297f-f2e1-4a44-bbf1-5f48a6e5****</SerialNumber>
            <ConsecutiveFails>1</ConsecutiveFails>
            <GmtUnlock>2020-12-21T15:21:28Z</GmtUnlock>
            <status>NORMAL</status>
      </VirtualMFADevices>
      <RequestId>FB550AAB-FB36-4A91-93F6-F4374AF65403</RequestId>
      <NextToken>AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as</NextToken>
</DescribeVirtualMFADevicesResponse>

JSON格式 

{
	"VirtualMFADevices": [{
		"GmtEnabled": "2020-12-20T14:52:28Z",
		"EndUserId": "usertest",
		"DirectoryId": "cn-hangzhou+dir-gx2x1dhsmu52rd****",
		"SerialNumber": "a25f297f-f2e1-4a44-bbf1-5f48a6e5****",
		"ConsecutiveFails": "1",
		"GmtUnlock": "2020-12-21T15:21:28Z",
		"status": "NORMAL"
	}],
	"RequestId": "FB550AAB-FB36-4A91-93F6-F4374AF65403",
	"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as"
}

错误码

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