调用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设备。

Email 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设备状态。可能值:

  • UNBOUND:未绑定
  • NORMAL:正常
  • LOCKED:已锁定
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
        }
    ]
}