Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Ruft Screenshots von einer oder mehreren Amazon DCV-Sitzungen ab.

Um das Bildformat zu ändern, konfigurieren Sie den `session-screenshot-format` Parameter in der Session Manager Broker-Konfiguration. Weitere Informationen finden Sie in der [Broker-Konfigurationsdatei](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) im *Amazon DCV Session Manager-Administratorhandbuch*.

Wenn die `MaxHeight` Parameter `MaxWidth` oder der `GetSessionScreenshots` Anforderung nicht angegeben sind, werden die in der Session Manager Broker-Konfigurationsdatei festgelegten `session-screenshot-max-height` Werte `session-screenshot-max-width` und verwendet. Informationen zum Ändern dieser Parameter finden Sie auch in der [Broker-Konfigurationsdatei](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) im *Amazon DCV Session Manager-Administratorhandbuch*.

Der obere Wert für die Screenshot-Auflösung ist auf die Auflösung der Remotesitzung beschränkt. Wenn die `MaxHeight` Parameter `MaxWidth` und auf Werte gesetzt sind, die höher sind als die aktuelle Auflösung der Remotesitzung, wird der resultierende Screenshot auf die tatsächliche Sitzungsauflösung beschränkt.

**Anmerkung**  
Informationen zum Ändern dieser Werte in der Access Console finden Sie in der [Web Client-Konfigurationsdatei](https://docs.aws.amazon.com/dcv/latest/access-console/web-client-config-files.html) im *Administratorhandbuch für die Amazon DCV Access Console*. Informationen zum Ändern dieser Werte mit der Session Manager-CLI finden Sie `get-session-screenshots` im *Amazon DCV CLI Guide*.

**Topics**
+ [Anforderungsparameter](#request)
+ [Antwortparameter](#response)
+ [Beispiel](#example)

## Anforderungsparameter
<a name="request"></a>

**`SessionId`**  
Die ID der Amazon DCV-Sitzung, von der der Screenshot abgerufen werden soll.  
Typ: Zeichenfolge  
Erforderlich: Ja

**`MaxWidth`**  
Die maximale Breite von Sitzungs-Screenshots in Pixeln. Wenn nicht angegeben, gelten die Werte aus der Session Manager Broker-Konfiguration. Falls angegeben, muss dies eine Zahl größer als 0 sein.   
Typ: Ganzzahl  
Erforderlich: Nein

**`MaxHeight`**  
Die maximale Höhe von Sitzungs-Screenshots in Pixeln. Wenn nicht angegeben, gelten die Werte aus der Session Manager Broker-Konfiguration. Falls angegeben, muss dies eine Zahl größer als 0 sein.  
Typ: Ganzzahl  
Erforderlich: Ja

## Antwortparameter
<a name="response"></a>

**`RequestId`**  
Die eindeutige ID der Anfrage.

**`SuccessfulList`**  
Informationen zu den erfolgreichen Screenshots. Diese Datenstruktur umfasst die folgenden verschachtelten Antwortparameter:    
**`SessionScreenshot`**  
Informationen zu den Screenshots. Diese Datenstruktur umfasst die folgenden verschachtelten Antwortparameter:    
**`SessionId`**  
Die ID der Amazon DCV-Sitzung, aus der der Screenshot aufgenommen wurde.  
**`Images`**  
Informationen zu den Bildern. Diese Datenstruktur umfasst die folgenden verschachtelten Antwortparameter:    
**`Format`**  
Das Format des Bilds. Mögliche Werte sind u. a. `jpeg` und `png`.  
**`Data`**  
Das im Base64-kodierten Format des Screenshot-Bildes.  
**`CreationTime`**  
Datum und Uhrzeit der Aufnahme des Screenshots.  
**`Primary`**  
Gibt an, ob es sich bei dem Screenshot um das primäre Display der Amazon DCV-Sitzung handelt.

**`UnsuccessfulList`**  
Informationen zu den erfolglosen Screenshots. Diese Datenstruktur umfasst die folgenden verschachtelten Antwortparameter:    
**`GetSesionScreenshotRequestData`**  
Die ursprüngliche Anfrage, die fehlgeschlagen ist.    
**`SessionId`**  
Die ID der Amazon DCV-Sitzung, aus der der Screenshot aufgenommen werden sollte.  
**`FailureReason`**  
Der Grund für den Fehlschlag.

**`GetSessionScreenshotRequestData`**  
Die ursprüngliche Anfrage, die fehlgeschlagen ist.

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

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

**Anforderung**  
Im folgenden Beispiel werden Screenshots von zwei Sitzungen (`sessionId1`und`sessionId2`) abgerufen, bei denen die maximale Breite auf 800 und die maximale Höhe auf 600 festgelegt sind. Die Sitzung `sessionId2` ist nicht vorhanden und führt zu einem Fehler.

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

**Antwort**  
Im Folgenden finden Sie ein Beispiel für die Ausgabe.

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

------