DescribeVirtualMFADevices - 查询AD账号绑定的虚拟MFA设备 - 无影云电脑

查询AD账号绑定的虚拟MFA设备。

调试

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

授权信息

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

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-hangzhou
MaxResults	integer	否	返回结果的最大数量。取值范围：1~500。默认值：100。	100
NextToken	string	否	查询凭证。取值为上一次调用此 API 时返回的 NextToken 参数值。	caeba0bbb2be03f84eb48b699f0a4883
OfficeSiteId	string	是	办公网络 ID。	cn-hangzhou+dir-269345****
EndUserId	array	否	AD 账号的用户名列表。
	string	否	AD 账号的用户名。	testuser

返回参数

名称	类型	描述	示例值
	object	返回信息集合。
NextToken	string	下一个查询开始的 Token，NextToken 为空表示没有下一个。	AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as
RequestId	string	请求 ID。	FB550AAB-FB36-4A91-93F6-F4374AF65403
VirtualMFADevices	array<object>	虚拟 MFA 设备信息集合。
VirtualMFADevice	object	虚拟 MFA 设备信息。
SerialNumber	string	虚拟 MFA 设备的序列号。	a25f297f-f2e1-4a44-bbf1-5f48a6e5****
GmtUnlock	string	虚拟 MFA 设备被锁定后的自动解锁时间。按照ISO 8601标准表示，并使用 UTC+0 时间，格式为 YYYY-MM-DDThh:mm:ssZ。	2020-12-21T15:21:28Z
EndUserId	string	使用该虚拟 MFA 设备的 AD 账号用户名。	usertest
ConsecutiveFails	integer	连续绑定或者认证虚拟 MFA 设备失败的次数。	1
OfficeSiteId	string	办公网络 ID。	cn-hangzhou+dir-269345****
status	string	虚拟 MFA 设备状态。枚举值： LOCKED：已锁定。 UNBOUND：未绑定。 NORMAL：正常。	NORMAL
DirectoryId	string	说明该参数正在邀测中，暂未开放使用。	cn-hangzhou+dir-gx2x1dhsmu52rd****
GmtEnabled	string	虚拟 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-07	OpenAPI 入参发生变更	查看变更详情