CreateSessions

Crea una nuova sessione Amazon DCV con i dettagli specificati.

Parametri della richiesta

Name

Il nome della sessione.

Tipo: stringa

Campo 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

Campo obbligatorio: sì

Type

Il tipo di sessione. Per ulteriori informazioni sui tipi di sessioni, consulta Introduzione alle sessioni Amazon DCV nella Amazon DCV Administrator Guide.

Valori validi: CONSOLE | VIRTUAL

Tipo: stringa

Campo 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_folderagente. 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 nella Amazon DCV Session Manager Administrator Guide.

Tipo: string

Campo obbligatorio: no

MaxConcurrents

Il numero massimo di client Amazon DCV simultanei.

Tipo: integer

Campo 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 | false

Tipo: Booleano

Campo 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 Administrator Guide.

Tipo: string

Campo obbligatorio: no

EnqueueRequest

Indica se mettere in coda la richiesta se non può essere soddisfatta immediatamente.

Tipo: Booleano

Impostazione predefinita: false

Campo 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_folderagente. 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 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: string

Campo 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 AutorunFilemomento 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 nella Amazon DCV Session Manager Administrator Guide.

Tipo: matrice di stringhe

Campo 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 nella Amazon DCV Session Manager Administrator Guide.

Tipo: Booleano

Impostazione predefinita: false

Campo 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'DescribeServersAPI.

Espressioni relative alle condizioni dei requisiti:

• a! = 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:

• ae b vero se a e b sono veri

• ao b vero se a o b sono veri

• non è a vero se a è falso

Le chiavi dei tag devono avere il prefisso datag:, 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: string

Campo 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 nella Amazon DCV Administrator Guide.

Tipo: string

Campo 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": [
    ]
}