本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
- 
          失败的原始请求。