使用ListMFADevicesForUser API查询用户的MFA设备列表-云SSO-阿里云-云SSO(CloudSSO)-阿里云帮助中心

接口说明

本文将提供一个示例，查询用户u-00q8wbq42wiltcrk****的 MFA 设备列表。返回结果显示，该用户配置了一个名为Alice-MFA1的 MFA 设备。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cloudsso:ListMFADevicesForUser

list

*User

acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}

无

请求参数

名称	类型	必填	描述	示例值
DirectoryId	string	是	目录 ID。	d-00fc2p61****
UserId	string	是	用户 ID。	u-00q8wbq42wiltcrk****

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	8B9982ED-FD0D-5622-8EA0-7B768685DCE7
TotalCounts	integer	MFA 设备总数。	1
MFADevices	array<object>	MFA 设备列表。
	object	MFA 设备列表。
DeviceType	string	MFA 设备类型。取值：TOTP，表示基于 TOTP 的虚拟 MFA 设备。	TOTP
EffectiveTime	string	生效时间。格式为 RFC 3339 的 UTC 时间（YYYY-MM-DDTHH:mm:ssZ）。	2021-10-29T09:14:06Z
DeviceId	string	MFA 设备 ID。	mfa-00ujhet8pycljj7j****
UserId	string	用户 ID。	u-00q8wbq42wiltcrk****
DeviceName	string	MFA 设备名称。	Alice-MFA1
LastUseTime	string

示例

正常返回示例

JSON格式

{
  "RequestId": "8B9982ED-FD0D-5622-8EA0-7B768685DCE7",
  "TotalCounts": 1,
  "MFADevices": [
    {
      "DeviceType": "TOTP",
      "EffectiveTime": "2021-10-29T09:14:06Z",
      "DeviceId": "mfa-00ujhet8pycljj7j****",
      "UserId": "u-00q8wbq42wiltcrk****",
      "DeviceName": "Alice-MFA1",
      "LastUseTime": ""
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。