全部产品
Search
文档中心

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

更新时间:Oct 17, 2024

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

调试

您可以在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<object>

虚拟 MFA 设备信息集合。

VirtualMFADeviceobject

虚拟 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 设备状态。

枚举值:
  • LOCKED已锁定
  • UNBOUND未绑定
  • NORMAL正常
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 入参发生变更查看变更详情