本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
GetSessionScreenshots
获取一个或多个 Amazon DCV 会话的屏幕截图。
要修改图像格式,请在会话管理器代理配置中配置session-screenshot-format
参数。请参阅《Amazon DCV 会话管理器管理员指南》中的代理配置文件。
如果未指定GetSessionScreenshots
请求的MaxWidth
或MaxHeight
参数,则将使用在 Session Manager Broker 配置文件中设置的session-screenshot-max-width
和session-screenshot-max-height
值。要修改这些参数,另请参阅 Amazon DCV 会话管理器管理员指南中的代理配置文件。
屏幕截图分辨率的上限值仅限于远程会话分辨率。如果将MaxWidth
和MaxHeight
参数设置为高于当前远程会话分辨率的值,则生成的屏幕截图将仅限于实际会话分辨率。
注意
要通过访问控制台修改这些值,请参阅 Amazon DCV 访问控制台管理员指南中的 Web 客户端配置文件。要使用会话管理器 CLI 修改这些值,请参阅 Amazon DCV CLI 指南get-session-screenshots
中的。
请求参数
SessionId
-
要从中获取屏幕截图的 Amazon DCV 会话的 ID。
类型:字符串
必需:是
MaxWidth
-
会话屏幕截图的最大宽度(以像素为单位)。如果未指定,则将应用会话管理器代理配置中的值。如果提供,则必须是一个大于 0 的数字。
类型:整数
必需:否
MaxHeight
-
会话屏幕截图的最大高度(以像素为单位)。如果未指定,则将应用会话管理器代理配置中的值。如果提供,则必须是一个大于 0 的数字。
类型:整数
必需:是
响应参数
RequestId
-
请求的唯一 ID。
SuccessfulList
-
有关成功屏幕截图的信息。该数据结构包括以下嵌套的响应参数:
SessionScreenshot
-
有关屏幕截图的信息。该数据结构包括以下嵌套的响应参数:
SessionId
-
从中获取屏幕截图的 Amazon DCV 会话的 ID。
Images
-
有关图像的信息。该数据结构包括以下嵌套的响应参数:
Format
-
图像的格式。可能的值包括:
jpeg
和png
。 Data
-
屏幕截图 Base64 编码格式。
CreationTime
-
获取屏幕截图的日期和时间。
Primary
-
指示屏幕截图是否为 Amazon DCV 会话的主显示器。
UnsuccessfulList
-
有关失败屏幕截图的信息。该数据结构包括以下嵌套的响应参数:
GetSesionScreenshotRequestData
-
失败的原始请求。
SessionId
-
从中获取屏幕截图的 Amazon DCV 会话的 ID。
FailureReason
-
失败的原因。
GetSessionScreenshotRequestData
-
失败的原始请求。