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.
# CreateSessions
Erstellt eine neue Amazon DCV-Sitzung mit den angegebenen Details.
**Topics**
+ [Anforderungsparameter](#request)
+ [Antwortparameter](#response)
+ [Beispiel](#example)
## Anforderungsparameter
**`Name`**
Der Name für die Sitzung.
Typ: Zeichenfolge
Erforderlich: Ja
**`Owner`**
Der Name des Sitzungsbesitzers. Dies muss der Name eines vorhandenen Benutzers auf dem Amazon DCV-Zielserver sein.
Typ: Zeichenfolge
Erforderlich: Ja
**`Type`**
Der Sitzungstyp Weitere Informationen zu den Sitzungstypen finden Sie unter [Einführung in Amazon DCV-Sitzungen](https://docs.aws.amazon.com/dcv/latest/adminguide/managing-sessions.html) im *Amazon DCV-Administratorhandbuch*.
Gültige Werte: CONSOLE \$1 VIRTUAL
Typ: Zeichenfolge
Erforderlich: Ja
**`InitFile`**
Wird mit virtuellen Sitzungen auf Linux-Amazon-DCV-Servern unterstützt. Es wird bei Konsolensitzungen auf Windows- und Linux-Amazon-DCV-Servern nicht unterstützt. Der Pfad zum benutzerdefinierten Skript auf dem Amazon DCV-Server, das für die Initialisierung der Sitzung ausgeführt werden soll, wenn sie erstellt wird. Der Dateipfad ist relativ zu dem für den `agent.init_folder` Agent-Konfigurationsparameter angegebenen Init-Verzeichnis. Wenn sich die Datei im angegebenen Init-Verzeichnis befindet, geben Sie nur den Dateinamen an. Wenn sich die Datei nicht im angegebenen Init-Verzeichnis befindet, geben Sie den relativen Pfad an. Weitere Informationen finden Sie in der [Agent-Konfigurationsdatei](https://docs.aws.amazon.com/dcv/latest/sm-admin/agent-file.html) im *Amazon DCV Session Manager-Administratorhandbuch*.
Typ: Zeichenfolge
Erforderlich: Nein
**`MaxConcurrents`**
Die maximale Anzahl gleichzeitiger Amazon DCV-Clients.
Typ: Ganzzahl
Erforderlich: Nein
**`DcvGlEnabled`**
Gibt an, ob die virtuelle Sitzung für die Verwendung von hardwarebasiertem OpenGL konfiguriert ist. Wird nur bei virtuellen Sitzungen unterstützt. Dieser Parameter wird von Windows Amazon DCV-Servern nicht unterstützt.
Zulässige Werte: true \$1 false
Typ: Boolesch
Erforderlich: Nein
**`PermissionsFile`**
Der Base64-kodierte Inhalt der Berechtigungsdatei. Standardmäßig die Server-Standardwerte, falls kein Wert angegeben ist. Weitere Informationen finden Sie unter [Konfiguration der Amazon DCV-Autorisierung](https://docs.aws.amazon.com/dcv/latest/adminguide/security-authorization.html) im *Amazon DCV-Administratorhandbuch*.
Typ: Zeichenfolge
Erforderlich: Nein
**`EnqueueRequest`**
Gibt an, ob die Anfrage in die Warteschlange gestellt werden soll, wenn sie nicht sofort bearbeitet werden kann.
Typ: Boolescher Wert
Standard: false
Erforderlich: Nein
**`AutorunFile`**
Unterstützt mit Konsolensitzungen auf Windows Amazon DCV-Servern und virtuellen Sitzungen auf Linux-Amazon-DCV-Servern. Es wird bei Konsolensitzungen auf Linux-Amazon-DCV-Servern nicht unterstützt.
Der Pfad zu einer Datei auf dem Host-Server, die innerhalb der Sitzung ausgeführt werden soll. Der Dateipfad ist relativ zu dem Autorun-Verzeichnis, das für den `agent.autorun_folder` Agent-Konfigurationsparameter angegeben wurde. Wenn sich die Datei im angegebenen Autorun-Verzeichnis befindet, geben Sie nur den Dateinamen an. Wenn sich die Datei nicht im angegebenen Autorun-Verzeichnis befindet, geben Sie den relativen Pfad an. Weitere Informationen finden Sie in der [Agent-Konfigurationsdatei](https://docs.aws.amazon.com/dcv/latest/sm-admin/agent-file.html) im *Amazon DCV Session Manager-Administratorhandbuch*.
Die Datei wird im Namen des angegebenen **Besitzers** ausgeführt. Der angegebene Besitzer muss berechtigt sein, die Datei auf dem Server auszuführen. Auf Windows Amazon DCV-Servern wird die Datei ausgeführt, wenn sich der Besitzer bei der Sitzung anmeldet. Auf Linux-Amazon-DCV-Servern wird die Datei ausgeführt, wenn die Sitzung erstellt wird.
Typ: Zeichenfolge
Erforderlich: Nein
**`AutorunFileArguments`**
Wird mit virtuellen Sitzungen auf Linux-Amazon-DCV-Servern unterstützt. Es wird in Konsolensitzungen auf Windows- und Linux-Amazon-DCV-Servern nicht unterstützt. Befehlszeilenargumente, an die **AutorunFile**bei der Ausführung innerhalb der Sitzung übergeben wurde. Argumente werden in der Reihenfolge übergeben, in der sie im angegebenen Array erscheinen. Die maximal zulässige Anzahl von Argumenten und die maximal zulässige Länge jedes Arguments können konfiguriert werden. 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*.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
**`DisableRetryOnFailure`**
Gibt an, ob die Anfrage zum Erstellen einer Sitzung nicht erneut versucht werden soll, wenn sie auf einem Amazon DCV-Host aus irgendeinem Grund fehlschlägt. Weitere Informationen zum Mechanismus zum Erstellen von Sitzungswiederholungen finden Sie in der [Broker-Konfigurationsdatei](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) im *Amazon DCV Session Manager-Administratorhandbuch*.
Typ: Boolescher Wert
Standard: false
Erforderlich: Nein
**`Requirements`**
Die Anforderungen, die der Server erfüllen muss, um die Sitzung durchführen zu können. Die Anforderungen können Server-Tags und and/or Servereigenschaften beinhalten. Sowohl Server-Tags als auch Servereigenschaften werden durch Aufrufen der **DescribeServers**API abgerufen.
Bedingungsausdrücke für Anforderungen:
+ *a***\$1 **= *b* wahr, wenn ungleich *a* ist *b*
+ *a***=** *b* wahr, wenn gleich *a* ist *b*
+ *a***>** *b* wahr, wenn größer *a* ist als *b*
+ *a***>=** *b* wahr, wenn *a* es größer oder gleich ist *b*
+ *a***<** *b* wahr, wenn kleiner *a* ist als *b*
+ *a***<=** *b* wahr, wenn kleiner oder gleich *a* ist *b*
+ *a***=** *b* wahr, wenn es die *a* Zeichenfolge enthält *b*
Anforderungen boolesche Operatoren:
+ *a***und** *b* wahr, wenn *a* und *b* wahr sind
+ *a***oder** *b* wahr, wenn *a* oder wahr *b* sind
+ **nicht** *a* wahr, wenn *a* es falsch ist
Den Tag-Schlüsseln muss ein Präfix vorangestellt werden`tag:`, den Servereigenschaften muss ein Präfix vorangestellt werden. `server:` Die Anforderungsausdrücke unterstützen Klammern. `()`
Beispiele für Anforderungen:
+ `tag:color = 'pink' and (server:Host.Os.Family = 'windows' or tag:color := 'red')`
+ `"server:Host.Aws.Ec2InstanceType := 't2' and server:Host.CpuInfo.NumberOfCpus >= 2"`
Numerische Werte können in exponentieller Notation angegeben werden, zum Beispiel:`"server:Host.Memory.TotalBytes > 1024E6"`.
Die unterstützten Servereigenschaften sind:
+ `Id`
+ `Hostname`
+ `Version`
+ `SessionManagerAgentVersion`
+ `Host.Os.BuildNumber`
+ `Host.Os.Family`
+ `Host.Os.KernelVersion`
+ `Host.Os.Name`
+ `Host.Os.Version`
+ `Host.Memory.TotalBytes`
+ `Host.Memory.UsedBytes`
+ `Host.Swap.TotalBytes`
+ `Host.Swap.UsedBytes`
+ `Host.CpuLoadAverage.OneMinute`
+ `Host.CpuLoadAverage.FiveMinutes`
+ `Host.CpuLoadAverage.FifteenMinutes`
+ `Host.Aws.Ec2InstanceId`
+ `Host.Aws.Ec2InstanceType`
+ `Host.Aws.Region`
+ `Host.Aws.Ec2ImageId`
+ `Host.CpuInfo.Architecture`
+ `Host.CpuInfo.ModelName`
+ `Host.CpuInfo.NumberOfCpus`
+ `Host.CpuInfo.PhysicalCoresPerCpu`
+ `Host.CpuInfo.Vendor`
Typ: Zeichenfolge
Erforderlich: Nein
**`StorageRoot`**
Gibt den Pfad zu dem Ordner an, der als Speicher für die Sitzung verwendet wird. Weitere Informationen zum Amazon DCV-Sitzungsspeicher finden Sie unter [Enabling Session Storage](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-storage.html) im *Amazon DCV-Administratorhandbuch*.
Typ: Zeichenfolge
Erforderlich: Nein
## Antwortparameter
**`Id`**
Die eindeutige ID der Sitzung.
**`Name`**
Der Sitzungsname
**`Owner`**
Der Besitzer der Sitzung.
**`Type`**
Die Art der Sitzung.
**`State`**
Der Status der Sitzung. Wenn die Anfrage erfolgreich abgeschlossen wurde, wechselt die Sitzung in den `CREATING` Status.
**`Substate`**
Der Unterstatus der Sitzung. Wenn die Anforderung erfolgreich abgeschlossen wurde, wechselt der Unterstatus in den `SESSION_PLACING` Unterstatus.
## Beispiel
------
#### [ Python ]
**Anforderung**
Im folgenden Beispiel werden drei Sitzungen erstellt.
```
from swagger_client.models.create_session_request_data import CreateSessionRequestData
def get_sessions_api():
api_instance = swagger_client.SessionsApi(swagger_client.ApiClient(get_client_configuration()))
set_request_headers(api_instance.api_client)
return api_instance
def create_sessions(sessions_to_create):
create_sessions_request = list()
for name, owner, session_type, init_file_path, autorun_file, autorun_file_arguments, max_concurrent_clients,\
dcv_gl_enabled, permissions_file, requirements, storage_root in sessions_to_create:
a_request = CreateSessionRequestData(
name=name, owner=owner, type=session_type,
init_file_path=init_file_path, autorun_file=autorun_file, autorun_file_arguments=autorun_file_arguments, max_concurrent_clients=max_concurrent_clients,
dcv_gl_enabled=dcv_gl_enabled, permissions_file=permissions_file, requirements=requirements, storage_root=storage_root)
create_sessions_request.append(a_request)
api_instance = get_sessions_api()
print('Create Sessions Request:', create_sessions_request)
api_response = api_instance.create_sessions(body=create_sessions_request)
print('Create Sessions Response:', api_response)
def main():
create_sessions([
('session1', 'user1', 'CONSOLE', None, None, None, 1, None, '/dcv/permissions.file', "tag:os = 'windows' and server:Host.Memory.TotalBytes > 1024", "/storage/root"),
('session2', 'user1', 'VIRTUAL', None, 'myapp.sh', None, 1, False, None, "tag:os = 'linux'", None),
('session3', 'user1', 'VIRTUAL', '/dcv/script.sh', 'myapp.sh', ['argument1', 'argument2'], 1, False, None, "tag:os = 'linux'", None),
])
```
**Antwort**
Das Folgende ist die Beispielausgabe.
```
{
"RequestId": "e32d0b83-25f7-41e7-8c8b-e89326ecc87f",
"SuccessfulList": [
{
"Id": "78b45deb-1163-46b1-879b-7d8fcbe9d9d6",
"Name": "session1",
"Owner": "user1",
"Type": "CONSOLE",
"State": "CREATING"
},
{
"Id": " a0c743c4-9ff7-43ce-b13f-0c4d55a268dd",
"Name": "session2",
"Owner": "user1",
"Type": "VIRTUAL",
"State": "CREATING"
},
{
"Id": " 10311636-df90-4cd1-bcf7-474e9675b7cd",
"Name": "session3",
"Owner": "user1",
"Type": "VIRTUAL",
"State": "CREATING"
}
],
"UnsuccessfulList": [
]
}
```
------