调用DescribeMfaDevices查询便捷用户绑定的虚拟MFA设备。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeMfaDevices |
系统规定参数。取值:DescribeMfaDevices。 |
MaxResults | Long | 否 | 100 |
返回结果的最大数量。取值范围:1~500。 默认值:100。 |
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a4883 |
查询凭证。取值为上一次API调用时返回的NextToken参数值。 |
EndUserIds.N | RepeatList | 否 | test |
便捷用户的用户名。 |
SerialNumbers.N | RepeatList | 否 | c2d9ae94-a64b-4a0d-8024-9519ca50**** |
虚拟MFA设备序列号,唯一标识。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
MfaDevices | Array of data |
虚拟MFA设备信息集合。 |
|
ConsecutiveFails | Integer | 0 |
连续绑定或者认证虚拟MFA设备失败的次数。 |
DeviceType | String | TOTP_VIRTUAL |
虚拟MFA设备类型。目前仅支持TOTP_VIRTUAL,即遵循TOTP算法的虚拟MFA设备。 |
String | test@example***.com |
该参数暂未开放使用。 |
|
EndUserId | String | test |
使用该虚拟MFA设备的便捷用户名。 |
GmtEnabled | String | 2021-06-22T06:20:49Z |
虚拟MFA设备启用时间。按照ISO8601标准表示,并使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
GmtUnlock | String | 2021-06-23T06:20:49Z |
虚拟MFA设备被锁定后的自动解锁时间。按照ISO8601标准表示,并使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
Id | Long | 36 |
该参数暂未开放使用。 |
SerialNumber | String | dc856334-446b-4035-bfbc-18af261e**** |
虚拟MFA设备序列号,唯一标识。 |
Status | String | NORMAL |
虚拟MFA设备状态。可能值:
|
NextToken | String | AAAAAV3MpHK1AP0pfERHZN5pu6na6YlN9asMM31MsMcdQNpp |
下一个查询开始的Token。 |
RequestId | String | 33DBB8EC-6E68-4726-91C4-E09C59D9A7D8 |
请求ID。 |
示例
请求示例
https://eds-user.cn-shanghai.aliyuncs.com/?Action=DescribeMfaDevices
&<公共请求参数>
正常返回示例
XML
格式
<DescribeMfaDevicesResponse>
<NextToken>AAAAAV3MpHK1AP0pfERHZN5pu6na6YlN9asMM31MsMcdQNpp</NextToken>
<RequestId>8C09C087-99C3-43F0-BFEA-03E651E04696</RequestId>
<MfaDevices>
<Status>NORMAL</Status>
<DeviceType>TOTP_VIRTUAL</DeviceType>
<GmtEnabled>2021-06-22T06:20:49Z</GmtEnabled>
<EndUserId>test</EndUserId>
<SerialNumber>dc856334-446b-4035-bfbc-18af261e****</SerialNumber>
<ConsecutiveFails>0</ConsecutiveFails>
<Id>36</Id>
</MfaDevices>
</DescribeMfaDevicesResponse>
JSON
格式
{
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6na6YlN9asMM31MsMcdQNpp",
"RequestId": "8C09C087-99C3-43F0-BFEA-03E651E04696",
"MfaDevices": [
{
"Status": "NORMAL",
"DeviceType": "TOTP_VIRTUAL",
"GmtEnabled": "2021-06-22T06:20:49Z",
"EndUserId": "test",
"SerialNumber": "dc856334-446b-4035-bfbc-18af261e****",
"ConsecutiveFails": 0,
"Id": 36
}
]
}