本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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-
失敗的原始請求。