기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# GetSessionScreenshots
하나 이상의 Amazon DCV 세션 스크린샷을 가져옵니다.
이미지 형식을 수정하려면 세션 관리자 브로커 구성에서 `session-screenshot-format` 파라미터를 구성합니다. *Amazon DCV 세션 관리자 관리 안내서*의 [브로커 구성 파일](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html)을 참조하세요.
`GetSessionScreenshots` 요청의 `MaxWidth` 또는 `MaxHeight` 파라미터를 지정하지 않으면 세션 관리자 브로커 구성 파일에 설정된 `session-screenshot-max-width` 및 `session-screenshot-max-height` 값이 사용됩니다. 해당 파라미터를 수정하려면 *Amazon DCV 세션 관리자 관리 안내서*의 [브로커 구성 파일](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html)을 참조하세요.
스크린샷 해상도의 상한값은 원격 세션 해상도로 제한됩니다. `MaxWidth` 및 `MaxHeight` 파라미터가 현재 원격 세션 해상도보다 높은 값으로 설정된 경우 결과 스크린샷은 실제 세션 해상도로 제한됩니다.
**참고**
액세스 콘솔에서 이러한 값을 수정하려면 *Amazon DCV 액세스 콘솔 관리자 안내서*의 [웹 클라이언트 구성 파일](https://docs.aws.amazon.com/dcv/latest/access-console/web-client-config-files.html)을 참조하세요. 세션 관리자 CLI를 사용하여 이러한 값을 수정하려면 *Amazon DCV CLI 안내서*의 `get-session-screenshots` 섹션을 참조하세요.
**Topics**
+ [요청 파라미터](#request)
+ [응답 파라미터](#response)
+ [예제](#example)
## 요청 파라미터
**`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`**
실패한 원래 요청입니다.
## 예제
------
#### [ Python ]
**요청**
다음 예제에서는 최대 너비가 800으로 설정되고 최대 높이가 600으로 설정된 2개 세션(`sessionId1` 및 `sessionId2`)에서 스크린샷을 가져옵니다. `sessionId2` 세션이 존재하지 않아 오류가 발생합니다.
```
from swagger_client.models.describe_servers_request_data import GetSessionScreenshotRequestData
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, max_width=None, max_height=None):
request = [GetSessionScreenshotRequestData(session_id=session_id, max_width=max_width, max_height=max_height) 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"]), 800, 600)
```
**응답**
다음은 출력 샘플입니다.
```
{
"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."
}
]
}
```
------