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

调试

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

请求参数

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

系统规定参数。取值:DescribeVirtualMFADevices

RegionId String cn-hangzhou

地域ID。

MaxResults Integer 100

返回结果的最大数量。取值范围:1~500。默认值:100。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

查询凭证。取值为上一次API调用时返回的NextToken参数值。

OfficeSiteId String cn-hangzhou+dir-269345****

工作区ID。

EndUserId.N String testuser

AD用户名。

返回数据

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

下一个查询开始的Token,NextToken为空表示没有下一个。

RequestId String FB550AAB-FB36-4A91-93F6-F4374AF65403

请求ID。

VirtualMFADevices Array of VirtualMFADevice

虚拟MFA设备信息集合。

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

虚拟MFA设备序列号,唯一标识。

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

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

EndUserId String usertest

使用该虚拟MFA设备的AD用户名。

ConsecutiveFails Integer 1

连续绑定或者认证虚拟MFA设备失败的次数。

OfficeSiteId String cn-hangzhou+dir-269345****

工作区ID。

status String NORMAL

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

  • UNBOUND:未绑定
  • NORMAL:正常
  • LOCKED:已锁定
DirectoryId String cn-hangzhou+dir-gx2x1dhsmu52rd****
说明 该参数正在邀测中,暂未开放使用。
GmtEnabled String 2020-12-20T14:52:28Z

虚拟MFA设备启用时间。按照ISO 8601标准表示,并使用UTC+0时间,格式为YYYY-MM-DDThh:mm:ssZ。

示例

请求示例

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

正常返回示例

XML格式

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

<DescribeVirtualMFADevicesResponse>
<VirtualMFADevices>
    <GmtEnabled>2020-12-20T14:52:28Z</GmtEnabled>
    <OfficeSiteId>cn-hangzhou+dir-269345****</OfficeSiteId>
    <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格式

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

{
  "VirtualMFADevices" : [ {
    "GmtEnabled" : "2020-12-20T14:52:28Z",
    "OfficeSiteId" : "cn-hangzhou+dir-269345****",
    "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"
}