Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# GetSessionScreenshots
<a name="GetSessionScreenshots"></a>

Ottiene schermate di una o più sessioni Amazon DCV.

Per modificare il formato dell'immagine, configura il `session-screenshot-format` parametro nella configurazione di Session Manager Broker. Consulta [il file di configurazione del broker](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) nella *Amazon DCV Session Manager Administrator Guide*.

Quando i `MaxHeight` parametri `MaxWidth` o della `GetSessionScreenshots` richiesta non sono specificati, verranno utilizzati `session-screenshot-max-height` i valori `session-screenshot-max-width` e impostati nel file di configurazione di Session Manager Broker. Per modificare questi parametri, consulta anche il [file di configurazione del broker](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) nella *Amazon DCV Session Manager Administrator Guide*.

Il valore massimo per la risoluzione dello screenshot è limitato alla risoluzione della sessione remota. Se i `MaxHeight` parametri `MaxWidth` and sono impostati su valori superiori alla risoluzione corrente della sessione remota, lo screenshot risultante sarà limitato alla risoluzione effettiva della sessione.

**Nota**  
Per modificare questi valori dalla console di accesso, consulta il [file di configurazione del client Web](https://docs.aws.amazon.com/dcv/latest/access-console/web-client-config-files.html) nella *Amazon DCV Access Console Administrator Guide*. Per modificare questi valori con la CLI di Session Manager, consulta `get-session-screenshots` la *Amazon DCV CLI* Guide.

**Topics**
+ [Parametri della richiesta](#request)
+ [Parametri di risposta](#response)
+ [Esempio](#example)

## Parametri della richiesta
<a name="request"></a>

**`SessionId`**  
L'ID della sessione Amazon DCV da cui ottenere lo screenshot.  
Tipo: stringa  
Obbligatorio: sì

**`MaxWidth`**  
La larghezza massima, in pixel, degli screenshot della sessione. Se non specificato, verranno applicati i valori della configurazione di Session Manager Broker. Se fornito, deve essere un numero maggiore di 0.   
Tipo: Integer  
Obbligatorio: no

**`MaxHeight`**  
L'altezza massima, in pixel, degli screenshot della sessione. Se non specificato, verranno applicati i valori della configurazione di Session Manager Broker. Se fornito, deve essere un numero maggiore di 0.  
Tipo: numero intero  
Obbligatorio: sì

## Parametri di risposta
<a name="response"></a>

**`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 di dati include i seguenti parametri di risposta annidati:    
**`SessionId`**  
L'ID della sessione Amazon DCV da cui è stata acquisita 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 sessione Amazon DCV.

**`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 sessione Amazon DCV da cui è stata scattata la schermata.  
**`FailureReason`**  
Il motivo dell’errore.

**`GetSessionScreenshotRequestData`**  
La richiesta originale non riuscita.

## Esempio
<a name="example"></a>

------
#### [ Python ]

**Richiesta**  
L'esempio seguente ottiene schermate da due sessioni (`sessionId1`e`sessionId2`) con la larghezza massima impostata su 800 e l'altezza massima impostata su 600. La sessione `sessionId2` non esiste e genera un errore.

```
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)
```

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

------