弹性云桌面 DescribeVirtualMFADevices

By | 2021年4月22日

调用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"
}

错误码

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

请关注公众号获取更多资料

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

Iconic One Theme | Powered by Wordpress