首页 无影云桌面 API参考(云桌面管控) API目录 AD用户 DescribeVirtualMFADevices - 查询多因素认证设备

DescribeVirtualMFADevices - 查询多因素认证设备

查询AD用户绑定的多因素认证设备。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

地域ID。可以调用DescribeRegions获取无影云桌面支持的地域列表。

cn-hangzhou
MaxResultsinteger

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

100
NextTokenstring

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

caeba0bbb2be03f84eb48b699f0a4883
OfficeSiteIdstring

工作区ID。

cn-hangzhou+dir-269345****
EndUserIdarray

AD用户名。

string

AD用户名。

testuser

返回参数

名称类型描述示例值
object

返回信息集合。

NextTokenstring

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

AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as
RequestIdstring

请求ID。

FB550AAB-FB36-4A91-93F6-F4374AF65403
VirtualMFADevicesarray

虚拟MFA设备信息集合。

object

虚拟MFA设备信息。

SerialNumberstring

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

a25f297f-f2e1-4a44-bbf1-5f48a6e5****
GmtUnlockstring

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

2020-12-21T15:21:28Z
EndUserIdstring

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

usertest
ConsecutiveFailsinteger

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

1
OfficeSiteIdstring

工作区ID。

cn-hangzhou+dir-269345****
statusstring

虚拟MFA设备状态。

NORMAL
DirectoryIdstring
说明该参数正在邀测中,暂未开放使用。
cn-hangzhou+dir-gx2x1dhsmu52rd****
GmtEnabledstring

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

2020-12-20T14:52:28Z

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
2022-06-07OpenAPI 入参发生变更
变更项变更内容
入参OpenAPI 入参发生变更
    删除入参:DirectoryId
阿里云首页 无影云桌面 相关技术圈