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à.
# CreateSessions
Crea una nuova sessione Amazon DCV con i dettagli specificati.
**Topics**
+ [
## Parametri della richiesta
](#request)
+ [
## Parametri di risposta
](#response)
+ [
## Esempio
](#example)
## Parametri della richiesta
**`Name`**
Il nome della sessione.
Tipo: stringa
Obbligatorio: sì
**`Owner`**
Il nome del proprietario della sessione. Deve essere il nome di un utente esistente sul server Amazon DCV di destinazione.
Tipo: stringa
Obbligatorio: sì
**`Type`**
Il tipo di sessione. Per ulteriori informazioni sui tipi di sessioni, consulta [Introduzione alle sessioni Amazon DCV](https://docs.aws.amazon.com/dcv/latest/adminguide/managing-sessions.html) nella *Amazon DCV Administrator* Guide.
Valori validi: CONSOLE \$1 VIRTUAL
Tipo: stringa
Obbligatorio: sì
**`InitFile`**
Supportato con sessioni virtuali su server Linux Amazon DCV. Non è supportato nelle sessioni di console su server Amazon DCV Windows e Linux. Il percorso dello script personalizzato sul server Amazon DCV da eseguire per inizializzare la sessione al momento della creazione. Il percorso del file è relativo alla directory init specificata per il parametro di configurazione dell'`agent.init_folder`agente. Se il file si trova nella directory init specificata, specifica solo il nome del file. Se il file non si trova nella directory init specificata, specificate il percorso relativo. Per ulteriori informazioni, consulta il [file di configurazione dell'agente](https://docs.aws.amazon.com/dcv/latest/sm-admin/agent-file.html) nella *Amazon DCV Session Manager Administrator Guide*.
▬Tipo: stringa
Obbligatorio: no
**`MaxConcurrents`**
Il numero massimo di client Amazon DCV simultanei.
Tipo: Integer
Obbligatorio: no
**`DcvGlEnabled`**
Indica se la sessione virtuale è configurata per utilizzare OpenGL basato su hardware. Supportato solo con sessioni virtuali. Questo parametro non è supportato con i server Windows Amazon DCV.
Valori validi: true \$1 false
Tipo: Booleano
Obbligatorio: no
**`PermissionsFile`**
Il contenuto codificato in Base64 del file delle autorizzazioni. Se omesso, tale valore è rappresentato dal server predefinito. Per ulteriori informazioni, consulta [Configuring Amazon DCV Authorization nella *Amazon DCV*](https://docs.aws.amazon.com/dcv/latest/adminguide/security-authorization.html) Administrator Guide.
▬Tipo: stringa
Obbligatorio: no
**`EnqueueRequest`**
Indica se mettere in coda la richiesta se non può essere soddisfatta immediatamente.
Tipo: Booleano
Impostazione predefinita: false
Obbligatorio: no
**`AutorunFile`**
Supportato con sessioni console su server Windows Amazon DCV e sessioni virtuali su server Amazon DCV Linux. Non è supportato con sessioni console su server Amazon DCV Linux.
Il percorso di un file sul server host che deve essere eseguito all'interno della sessione. Il percorso del file è relativo alla directory autorun specificata per il parametro di configurazione dell'`agent.autorun_folder`agente. Se il file si trova nella directory autorun specificata, specifica solo il nome del file. Se il file non si trova nella directory autorun specificata, specifica il percorso relativo. Per ulteriori informazioni, consulta il [file di configurazione dell'agente](https://docs.aws.amazon.com/dcv/latest/sm-admin/agent-file.html) nella *Amazon DCV Session Manager Administrator Guide*.
Il file viene eseguito per conto del **proprietario** specificato. Il proprietario specificato deve disporre dell'autorizzazione per eseguire il file sul server. Sui server Windows Amazon DCV, il file viene eseguito quando il proprietario accede alla sessione. Sui server Amazon DCV Linux, il file viene eseguito al momento della creazione della sessione.
▬Tipo: stringa
Obbligatorio: no
**`AutorunFileArguments`**
Supportato con sessioni virtuali su server Linux Amazon DCV. Non è supportato nelle sessioni di console su server Amazon DCV Windows e Linux. Argomenti della riga di comando passati al **AutorunFile**momento dell'esecuzione all'interno della sessione. Gli argomenti vengono passati nell'ordine in cui appaiono nell'array specificato. È possibile configurare il numero massimo consentito di argomenti e la lunghezza massima consentita di ogni argomento. Per ulteriori informazioni, 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*.
Tipo: array di stringhe
Obbligatorio: no
**`DisableRetryOnFailure`**
Indica se non ritentare la richiesta di creazione della sessione dopo che non è riuscita su un host Amazon DCV per qualsiasi motivo. Per ulteriori informazioni sulla creazione del meccanismo di riprova della sessione, 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*.
Tipo: Booleano
Impostazione predefinita: false
Obbligatorio: no
**`Requirements`**
I requisiti che il server deve soddisfare per poter effettuare la sessione. I requisiti possono includere tag del server, le proprietà and/or del server, sia i tag del server che le proprietà del server vengono recuperati chiamando l'**DescribeServers**API.
Espressioni relative alle condizioni dei requisiti:
+ *a***\$1 **= *b* vero se non *a* è uguale a *b*
+ *a***=** *b* vero se *a* è uguale a *b*
+ *a***>** *b* vero se *a* è maggiore di *b*
+ *a***>=** *b* vero se *a* è maggiore o uguale a *b*
+ *a***<** *b* vero se *a* è minore di *b*
+ *a***<=** *b* vero se *a* è minore o uguale a *b*
+ *a***=** *b* true se *a* contiene la stringa *b*
Requisiti degli operatori booleani:
+ *a***e** *b* vero se *a* e *b* sono veri
+ *a***o** *b* vero se *a* o *b* sono veri
+ **non è** *a* vero se *a* è falso
Le chiavi dei tag devono avere il prefisso da`tag:`, le proprietà del server devono essere precedute da `server:` .Le espressioni dei requisiti supportano le parentesi. `()`
Esempi di requisiti:
+ `tag:color = 'pink' and (server:Host.Os.Family = 'windows' or tag:color := 'red')`
+ `"server:Host.Aws.Ec2InstanceType := 't2' and server:Host.CpuInfo.NumberOfCpus >= 2"`
I valori numerici possono essere specificati utilizzando la notazione esponenziale, per esempio:. `"server:Host.Memory.TotalBytes > 1024E6"`
Le proprietà del server supportate sono:
+ `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`
▬Tipo: stringa
Obbligatorio: no
**`StorageRoot`**
Specifica il percorso della cartella usato per lo storage della sessione. Per ulteriori informazioni sullo storage delle sessioni di Amazon DCV, consulta [Enabling Session Storage](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-storage.html) nella *Amazon DCV Administrator Guide*.
▬Tipo: stringa
Obbligatorio: no
## Parametri di risposta
**`Id`**
L'ID univoco della sessione.
**`Name`**
Il nome della sessione.
**`Owner`**
Il proprietario della sessione.
**`Type`**
Il tipo di sessione.
**`State`**
Lo stato della sessione. Se la richiesta viene completata correttamente, la sessione entra nello `CREATING` stato.
**`Substate`**
Il sottostato della sessione. Se la richiesta viene completata correttamente, il substato entra nel sottostato. `SESSION_PLACING`
## Esempio
------
#### [ Python ]
**Richiesta**
L'esempio seguente crea tre sessioni.
```
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),
])
```
**Risposta**
Di seguito è riportato l'output di esempio.
```
{
"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": [
]
}
```
------