AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

ListExcessiveDeviceRegistrationApplications - 批量查询设备超额注册申请

更新时间：
复制为 MD 格式
产品详情
我的收藏

查询当前阿里云账号下用户终端设备的超额注册申请列表。

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

csas:ListExcessiveDeviceRegistrationApplications

list

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
CurrentPage

integer

是

分页查询时显示的当前页的页码。取值：1~10000。

1
PageSize

integer

是

分页查询时设置的每页数量。取值范围：1~500。

10
Username

string

否

用户名。长度为 1~128 个字符，支持中文和大小写英文字母，可包含数字、半角句号（.）、下划线（_）和短划线（-）、星号（*）、at（@）和空格。

王先生
SaseUserId

string

否

用户 ID。取值来源：

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
Department

string

否

用户所属部门。长度为 1~128 个字符，支持中文和大小写英文字母，可包含数字、半角句号（.）、半角逗号（,）、半角分号（;）、短划线（-）、下划线（_）、分隔号（/）、at（@）和空格。

测试部
Hostname

string

否

终端设备名称。长度为 1~128 个字符，支持中文和大小写英文字母，可包含数字、半角句号（.）、半角逗号（,）、半角分号（;）、短划线（-）、下划线（_）、分隔号（/）、at（@）和空格。单独输入下划线（_）将额外查询所有名称中带 4 字节 utf-8 字符的终端设备。

win10-64bit
Mac

string

否

终端设备 MAC 地址。

00:16:XX:XX:7c:46
DeviceTag

string

否

终端设备 ID。取值：

36efa42d-2c32-c4dc-e3fc-8541e33a****

Statuses

array

否

超额注册申请状态集合。

string

否

超额注册申请状态。取值：

  • Pending：待处理。

  • Approved：通过。

  • Rejected：拒绝。

枚举值：

  • Approved :

    通过

  • Rejected :

    拒绝

  • Pending :

    待处理

Pending
ApplicationIds

array

否

超额注册申请 ID 集合。

string

否

超额注册申请 ID。取值来源 ListExcessiveDeviceRegistrationApplications ：批量查询设备超额注册申请。

reg-application-0f4a127b7e78****

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次请求的 ID。

58D6B23E-E5DA-5418-8F61-51A3B5A30049
TotalNum

integer

超额注册申请总数。

1
Applications

array<object>

超额注册申请列表。

object

超额注册申请。

DeviceTag

string

终端设备 ID。

36efa42d-2c32-c4dc-e3fc-8541e33a****
DeviceType

string

终端设备操作系统类型。取值：

  • Windows：Windows 系统。

  • macOS：macOS 系统。

  • Linux：Linux 系统。

  • Android：Android 系统。

  • iOS：iOS 系统。

  • Windows_Wuying：无影云桌面系统。

枚举值：

  • Linux :

    Linux 系统

  • Windows_Wuying :

    无影云桌面系统

  • Windows :

    Windows 系统

  • iOS :

    iOS 系统

  • macOS :

    macOS 系统

  • Android :

    Android 系统

Windows
Hostname

string

终端设备名称。

win10-64bit
Username

string

用户名。

王先生
SaseUserId

string

用户 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
Department

string

用户所属部门。

测试部
Mac

string

终端设备 MAC 地址。

00:16:XX:XX:7c:46
IsUsed

boolean

超额注册申请是否被使用。取值：

  • true：被使用。

  • false：尚未使用。

枚举值：

  • true :

    被使用

  • false :

    尚未使用

false
Status

string

超额注册申请状态。取值：

  • Pending：待处理。

  • Approved：通过。

  • Rejected：拒绝。

枚举值：

  • Approved :

    通过

  • Rejected :

    拒绝

  • Pending :

    待处理

Approved
CreateTime

string

超额注册申请创建时间。

2023-07-17 18:46:55
Description

string

超额注册申请理由。

这是一条超额注册申请
ApplicationId

string

超额注册申请 ID。

reg-application-0f4a127b7e78****
FullDepartment

array

string

示例

正常返回示例

JSON格式

{
  "RequestId": "58D6B23E-E5DA-5418-8F61-51A3B5A30049",
  "TotalNum": 1,
  "Applications": [
    {
      "DeviceTag": "36efa42d-2c32-c4dc-e3fc-8541e33a****",
      "DeviceType": "Windows",
      "Hostname": "win10-64bit",
      "Username": "王先生",
      "SaseUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
      "Department": "测试部",
      "Mac": "00:16:XX:XX:7c:46",
      "IsUsed": false,
      "Status": "Approved",
      "CreateTime": "2023-07-17 18:46:55",
      "Description": "这是一条超额注册申请",
      "ApplicationId": "reg-application-0f4a127b7e78****",
      "FullDepartment": [
        ""
      ]
    }
  ]
}

错误码

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

变更历史

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

上一篇：UpdateUserDevicesStatus - 批量修改用户终端设备状态下一篇：UpdateExcessiveDeviceRegistrationApplicationsStatus - 批量修改设备超额注册申请状态