调用DescribeRecordings查询云电脑录屏详细信息-无影云电脑企业版-阿里云-阿里云帮助中心

查询录屏文件的详细信息。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
ecd:DescribeRecordings	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-beijing
MaxResults	integer	否	分页查询时每页行数。最大值：100。默认值：10。	20
NextToken	string	否	查询凭证（Token）。取值为上一次调用该接口返回的`NextToken`参数值，初次调用接口时无需设置该参数。	aGN4YzAxQGNuLWhhbmd6aG91LjExNzU5NTMyNjgzMTQ1****
PolicyGroupId	string	否	策略 ID。	pg-gx2x1dhsmthe9****
DesktopId	string	否	云电脑 ID。不指定时，表示查询该地域下所有云电脑。	ecd-hlh41mk78dugw****
StartTime	string	否	查询的开始时间。使用 UTC+8 时间，格式为`YYYYMMDDhhmmss`。	20230424000000
EndTime	string	否	查询的结束时间。使用 UTC+8 时间，格式为`YYYYMMDDhhmmss`。	20230424004441
NeedSignedUrl	boolean	否	是否需要返回 URL。枚举值： true：返回URL。 false：不返回URL [默认值]。	false
SignedUrlExpireMinutes	integer	否	返回 URL 的有效时间。单位：分钟。	10
StandardStartTime	string	否	查询的开始时间。按照 ISO 8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-mm-ddthh:mm:ssz`。	2025-01-27T02:20:10Z
StandardEndTime	string	否	查询的结束时间。按照 ISO 8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-mm-ddthh:mm:ssz`。	2025-01-27T02:30:10Z

返回参数

名称	类型	描述	示例值
	object
NextToken	string	下一个查询开始的 Token，NextToken 为空表示没有下一个。	AAAAAV3MpHK1AP0pfERHZN5pu6nbCQ7ar+fECeh1IuWQXi39R5eoJ68zWp99mTAKRRNRhw==
RequestId	string	请求 ID。	327CFE78-1C0D-51AC-A9C6-BCEDF0DD44D6
Recordings	array<object>	云电脑录屏信息集合。
Recording	object	云电脑录屏信息。
EndTime	string	录制的结束时间。	2023-04-10T07:26:06Z
FilePath	string	文件路径。	pg-4w5nk44zo5yl1****/1mk78dugw344.mp4
StartTime	string	录制的开始时间。	2023-04-10T07:26:06Z
RecordingType	string	录制类型。枚举值： byaction_cmd_ft：由事件触发录屏-复制粘贴和文件传输都触发。 period：间隔录屏。 session：监听会话生命周期录屏。 byaction_commands：由事件触发录屏-复制粘贴触发。 alltime：全程录屏。 byaction_file_transfer：由事件触发录屏-文件传输触发。	alltime
RecordingSize	integer	录制文件大小。单位：Byte（字节）。	1742845
DesktopId	string	云电脑 ID。	ecd-10v0vuvm616sk****
EndUserIds	array	终端用户 ID 列表。
EndUserId	string	终端用户 ID。	alice
PolicyGroupId	string	策略 ID。	pg-6dn811rzrwh9w****
DesktopName	string	云电脑名称。	DemoComputer
SignedUrl	string	录屏文件下载地址。	https://eds-recording-bucket-cn-hangzhou-137187566615**.oss-cn-hangzhou.aliyuncs.com/pg-28l5tdjd33txz/ecd-e0so9m9u6chf1_gftest001_alltime_s0_.mp4?Expires=171256&OSSAccessKeyId=STS.&Signature=**4WyAA

示例

正常返回示例

JSON格式

{
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nbCQ7ar+fECeh1IuWQXi39R5eoJ68zWp99mTAKRRNRhw==",
  "RequestId": "327CFE78-1C0D-51AC-A9C6-BCEDF0DD44D6",
  "Recordings": [
    {
      "EndTime": "2023-04-10T07:26:06Z",
      "FilePath": "pg-4w5nk44zo5yl1****/1mk78dugw344.mp4",
      "StartTime": "2023-04-10T07:26:06Z",
      "RecordingType": "alltime",
      "RecordingSize": 1742845,
      "DesktopId": "ecd-10v0vuvm616sk****",
      "EndUserIds": [
        "alice"
      ],
      "PolicyGroupId": "pg-6dn811rzrwh9w****",
      "DesktopName": "DemoComputer",
      "SignedUrl": "https://eds-recording-bucket-cn-hangzhou-137187566615****.oss-cn-hangzhou.aliyuncs.com/pg-28l5tdjd33txz****/ecd-e0so9m9u6chf1****_gftest001_alltime_s0_****.mp4?Expires=171256****&OSSAccessKeyId=STS.****&Signature=****4WyAA"
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2025-01-16	OpenAPI 入参发生变更	查看变更详情
2022-04-24	新增 OpenAPI	查看变更详情