本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
GetSessionScreenshots
取得一或多個 Amazon DCV 工作階段的螢幕擷取畫面。
若要修改映像格式,請在 Session Manager Broker 組態上設定 session-screenshot-format
參數。請參閱《Amazon DCV Session Manager 管理員指南》中的代理程式組態檔案。
未指定GetSessionScreenshots
請求的 MaxWidth
或 MaxHeight
參數時,將使用 Session Manager Broker 組態檔案中設定的 session-screenshot-max-width
和 session-screenshot-max-height
值。若要修改這些參數,另請參閱《Amazon DCV Session Manager 管理員指南》中的代理程式組態檔案。
螢幕擷取畫面解析度的上限值僅限於遠端工作階段解析度。如果 MaxWidth
和 MaxHeight
參數設定為高於目前遠端工作階段解析的值,產生的螢幕擷取畫面將僅限於實際工作階段解析。
注意
若要從存取主控台修改這些值,請參閱《Amazon DCV 存取主控台管理員指南》中的 Web 用戶端組態檔案。若要使用 Session Manager CLI 修改這些值,請參閱《Amazon DCV CLI 指南get-session-screenshots
》中的 。
請求參數
SessionId
-
要從中取得螢幕擷取畫面的 Amazon DCV 工作階段 ID。
類型:字串
必要:是
MaxWidth
-
工作階段螢幕擷取畫面的最大寬度,以像素為單位。如果未指定,將套用來自 Session Manager Broker 組態的值。如果提供,這必須是大於 0 的數字。
類型:整數
必要:否
MaxHeight
-
工作階段螢幕擷取畫面的最大高度,以像素為單位。如果未指定,將套用來自 Session Manager Broker 組態的值。如果提供,這必須是大於 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
-
失敗的原始請求。