调用DescribeMfaDevices查询便捷用户绑定的虚拟MFA设备_无影云电脑企业版(EDS)-阿里云帮助中心

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

调试

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

授权信息

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

请求参数

名称	类型	必填	描述	示例值
MaxResults	long	否	返回结果的最大数量。取值范围：1~500。默认值：100。	100
NextToken	string	否	查询凭证。取值为上一次 API 调用时返回的 NextToken 参数值。	caeba0bbb2be03f84eb48b699f0a4883
EndUserIds	array	否	便捷账号的用户名列表。
	string	否	便捷账号的用户名。	alice
SerialNumbers	array	否	虚拟 MFA 设备的序列号列表。
	string	否	虚拟 MFA 设备的序列号。	c2d9ae94-a64b-4a0d-8024-9519ca50****
AdDomain	string	否	AD 办公网络地址。	cn.misumi.pri

返回参数

名称	类型	描述	示例值
	object	返回信息集合。
RequestId	string	请求 ID。	33DBB8EC-6E68-4726-91C4-E09C59D9A7D8
NextToken	string	下一个查询开始的 Token。	AAAAAV3MpHK1AP0pfERHZN5pu6na6YlN9asMM31MsMcdQNpp
MfaDevices	array<object>	虚拟 MFA 设备信息集合。
	object	虚拟 MFA 设备信息。
Id	long	虚拟 MFA 设备的 ID。	36
EndUserId	string	使用该虚拟 MFA 设备的便捷账号用户名。	alice
Email	string	说明该参数暂未开放使用。	username@example.com
GmtEnabled	string	虚拟 MFA 设备启用时间。按照 ISO8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-MM-ddTHH:mm:ssZ`。	2021-06-22T06:20:49Z
GmtUnlock	string	虚拟 MFA 设备被锁定后的自动解锁时间。按照 ISO8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-MM-ddTHH:mm:ssZ`。	2021-06-23T06:20:49Z
ConsecutiveFails	integer	连续绑定或者认证虚拟 MFA 设备失败的次数。	0
SerialNumber	string	虚拟 MFA 设备的序列号。	dc856334-446b-4035-bfbc-18af261e****
Status	string	虚拟 MFA 设备状态。枚举值： LOCKED：已锁定。 UNBOUND：未绑定。 NORMAL：正常。	NORMAL
DeviceType	string	虚拟 MFA 设备类型。目前仅支持`TOTP_VIRTUAL`，即遵循 TOTP 算法的虚拟 MFA 设备。	TOTP_VIRTUAL

示例

正常返回示例

JSON格式

{
  "RequestId": "33DBB8EC-6E68-4726-91C4-E09C59D9A7D8",
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6na6YlN9asMM31MsMcdQNpp",
  "MfaDevices": [
    {
      "Id": 36,
      "EndUserId": "alice",
      "Email": "username@example.com",
      "GmtEnabled": "2021-06-22T06:20:49Z",
      "GmtUnlock": "2021-06-23T06:20:49Z",
      "ConsecutiveFails": 0,
      "SerialNumber": "dc856334-446b-4035-bfbc-18af261e****",
      "Status": "NORMAL",
      "DeviceType": "TOTP_VIRTUAL"
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2023-08-21	OpenAPI 入参发生变更	查看变更详情