GetSessionScreenshots - Amazon DCV 会话管理器
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

GetSessionScreenshots

获取一个或多个 Amazon DCV 会话的屏幕截图。

屏幕截图的图像文件类型和分辨率取决于 Session Manager Broker 配置。要修改图像文件类型,请配置 session-screenshot-format 参数。要修改分辨率,请配置 session-screenshot-max-widthsession-screenshot-max-height 参数。有关更多信息,请参阅 Amazon Sessi DCV on Manager 管理员指南中的代理配置文件

请求参数

SessionId

要从中获取屏幕截图的 Amazon DCV 会话 ID。

类型:字符串

必需:是

响应参数

RequestId

请求的唯一 ID。

SuccessfulList

有关成功屏幕截图的信息。该数据结构包括以下嵌套的响应参数:

SessionScreenshot

有关屏幕截图的信息。该数据结构包括以下嵌套的响应参数:

SessionId

从中截取屏幕截图的 Amazon DCV 会话的 ID。

Images

有关图像的信息。该数据结构包括以下嵌套的响应参数:

Format

图像的格式。可能的值包括:jpegpng

Data

屏幕截图 Base64 编码格式。

CreationTime

获取屏幕截图的日期和时间。

Primary

表示屏幕截图是否是 Amazon DCV 会话的主显示屏。

UnsuccessfulList

有关失败屏幕截图的信息。该数据结构包括以下嵌套的响应参数:

GetSesionScreenshotRequestData

失败的原始请求。

SessionId

要从中截取屏幕截图的 Amazon DCV 会话的 ID。

FailureReason

失败的原因。

示例

Python
请求

以下示例从两个会话(sessionId1sessionId2)中获取屏幕截图。会话 sessionId2 不存在并导致失败。

from swagger_client.models.describe_servers_request_data import DescribeServersRequestData def get_sessions_api(): api_instance = swagger_client.ServersApi(swagger_client.ApiClient(get_client_configuration())) set_request_headers(api_instance.api_client) return api_instance def get_session_screenshots(session_ids): request = [GetSessionScreenshotRequestData(session_id=session_id) for session_id in session_ids] print('Get Session Screenshots Request:', request) api_instance = get_sessions_api() api_response = api_instance.get_session_screenshots(body=request) print('Get Session Screenshots Response:', api_response) def main(): get_session_screenshots(["sessionId1", "sessionId2"])
响应

以下是示例输出。

{ "RequestId": "542735ef-f6ab-47d8-90e5-23df31d8d166", "SuccessfulList": [ { "SessionScreenshot": { "SessionId": "sessionId1", "Images": [ { "Format": "png", "Data": "iVBORw0KGgoAAAANSUhEUgAAAEXAMPLE", "CreationTime": "2021-03-30T15:47:06.822Z", "Primary": true } ] } } ], "UnsuccessfulList": [ { "GetSessionScreenshotRequestData": { "SessionId": "sessionId2" }, "FailureReason": "Dcv session not found." } ] }