GetSessionScreenshots

Ottiene schermate di una o più DCV sessioni Amazon.

Il tipo di file di immagine e la risoluzione dello screenshot dipendono dalla configurazione di Session Manager Broker. Per modificare il tipo di file di immagine, configura il session-screenshot-format parametro. Per modificare la risoluzione, configurate i session-screenshot-max-height parametri session-screenshot-max-width and. Per ulteriori informazioni, consulta il file di configurazione del broker nella Amazon DCV Session Manager Administrator Guide.

Parametri della richiesta

SessionId

L'ID della DCV sessione Amazon da cui ottenere lo screenshot.

Tipo: stringa

Campo obbligatorio: sì

Parametri di risposta

RequestId

L'ID univoco della richiesta.

SuccessfulList

Informazioni sugli screenshot riusciti. Questa struttura di dati include i seguenti parametri di risposta annidati:

SessionScreenshot

Informazioni sugli screenshot. Questa struttura dati include i seguenti parametri di risposta annidati:

SessionId

L'ID della DCV sessione Amazon da cui è stata scattata la schermata.

Images

Informazioni sulle immagini. Questa struttura di dati include i seguenti parametri di risposta annidati:

Format

Il formato dell'immagine. I valori possibili sono jpeg e png.

Data

Il formato codificato base64 dell'immagine dello screenshot.

CreationTime

La data e l'ora in cui è stata scattata la schermata.

Primary

Indica se lo screenshot è dello schermo principale della DCV sessione Amazon.

UnsuccessfulList

Informazioni sugli screenshot non riusciti. Questa struttura di dati include i seguenti parametri di risposta annidati:

GetSesionScreenshotRequestData

La richiesta originale non riuscita.

SessionId

L'ID della DCV sessione Amazon da cui doveva essere scattata la schermata.

FailureReason

Il motivo dell'errore.

Esempio

Python

Richiesta

L'esempio seguente ottiene schermate da due sessioni (sessionId1esessionId2). La sessione sessionId2 non esiste e genera un errore.

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"])

Risposta

Di seguito è riportato l'output di esempio.

{
    "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."
        }
    ]
}