CreateSessions

Membuat sesi Amazon DCV baru dengan detail yang ditentukan.

Permintaan parameter

Name

Nama untuk sesi tersebut.

Tipe: String

Diperlukan: Ya

Owner

Nama pemilik sesi. Ini harus menjadi nama pengguna yang ada di server DCV Amazon target.

Tipe: String

Diperlukan: Ya

Type

Jenis sesi. Untuk informasi selengkapnya tentang jenis sesi, lihat Pengantar Sesi Amazon DCV di Panduan Administrator Amazon DCV.

Nilai yang valid: CONSOLE | VIRTUAL

Tipe: String

Diperlukan: Ya

InitFile

Didukung dengan sesi virtual di server Linux Amazon DCV. Ini tidak didukung dengan sesi konsol di server Windows dan Linux Amazon DCV. Jalur ke skrip khusus di server Amazon DCV dijalankan untuk menginisialisasi sesi saat dibuat. Jalur file relatif terhadap direktori init yang ditentukan untuk parameter konfigurasi agent.init_folder Agen. Jika file berada di direktori init yang ditentukan, tentukan nama file saja. Jika file tidak dalam direktori init yang ditentukan, tentukan jalur relatif. Untuk informasi selengkapnya, lihat File konfigurasi agen di Panduan Administrator Manajer Sesi Amazon DCV.

Tipe: String

Wajib: Tidak

MaxConcurrents

Jumlah maksimum klien Amazon DCV bersamaan.

Tipe: Integer

Wajib: Tidak

DcvGlEnabled

Menunjukkan apakah sesi virtual dikonfigurasi untuk menggunakan OpenGL berbasis perangkat keras. Didukung dengan sesi virtual saja. Parameter ini tidak didukung dengan server Windows Amazon DCV.

Nilai yang valid: benar/salah

Tipe: Boolean

Wajib: Tidak

PermissionsFile

Isi berkas izin yang disandikan Base64. Default ke server default jika dihilangkan. Untuk informasi selengkapnya, lihat Mengonfigurasi Otorisasi Amazon DCV di Panduan Administrator Amazon DCV.

Tipe: String

Wajib: Tidak

EnqueueRequest

Menunjukkan apakah akan mengantri permintaan jika tidak dapat segera dipenuhi.

Jenis: Boolean

Bawaan: salah

Wajib: Tidak

AutorunFile

Didukung dengan sesi konsol di server Windows Amazon DCV dan sesi virtual di server Linux Amazon DCV. Ini tidak didukung dengan sesi konsol di server Linux Amazon DCV.

Jalur ke file di server host yang akan dijalankan di dalam sesi. Jalur file relatif terhadap direktori autorun yang ditentukan untuk parameter konfigurasi agent.autorun_folder Agen. Jika file berada di direktori autorun yang ditentukan, tentukan nama file saja. Jika file tidak ada dalam direktori autorun yang ditentukan, tentukan jalur relatif. Untuk informasi selengkapnya, lihat File konfigurasi agen di Panduan Administrator Manajer Sesi Amazon DCV.

File dijalankan atas nama Pemilik yang ditentukan. Pemilik yang ditentukan harus memiliki izin untuk menjalankan file di server. Pada server Windows Amazon DCV, file dijalankan ketika pemilik log ke sesi. Di server Linux Amazon DCV, file dijalankan saat sesi dibuat.

Tipe: String

Wajib: Tidak

AutorunFileArguments

Didukung dengan sesi virtual di server Linux Amazon DCV. Ini tidak didukung dalam sesi konsol di server Windows dan Linux Amazon DCV. Argumen baris perintah diteruskan ke AutorunFileeksekusi di dalam sesi. Argumen dilewatkan dalam urutan mereka muncul ke dalam array yang diberikan. Jumlah maksimum argumen yang diizinkan dan panjang maksimum yang diizinkan dari setiap argumen dapat dikonfigurasi. Untuk informasi selengkapnya, lihat File konfigurasi broker di Panduan Administrator Manajer Sesi Amazon DCV.

Tipe: Array string

Wajib: Tidak

DisableRetryOnFailure

Menunjukkan apakah tidak akan mencoba lagi permintaan sesi buat setelah gagal di host Amazon DCV karena alasan apa pun. Untuk informasi selengkapnya tentang membuat mekanisme percobaan ulang sesi, lihat File konfigurasi Broker di Panduan Administrator Manajer Sesi Amazon DCV.

Jenis: Boolean

Bawaan: salah

Wajib: Tidak

Requirements

Persyaratan yang harus dipenuhi server untuk menempatkan sesi. Persyaratan dapat mencakup properti and/or server tag server, baik tag server dan properti server diambil dengan memanggil DescribeServersAPI.

Persyaratan ekspresi kondisi:

• a! = b benar jika a tidak sama dengan b

• a= b benar a jika sama dengan b

• a> b benar jika a lebih besar dari b

• a>= b true jika a lebih besar dari atau sama dengan b

• a< b benar a jika kurang dari b

• a<= b true jika a kurang dari atau sama dengan b

• a= b true jika a berisi string b

Persyaratan operator boolean:

• adan b benar jika a b dan benar

• aatau b benar jika a atau b benar

• tidak a benar a jika salah

Kunci tag harus diawali olehtag:, properti server harus diawali server: oleh.Ekspresi persyaratan mendukung tanda kurung. ()

Contoh persyaratan:

• tag:color = 'pink' and (server:Host.Os.Family = 'windows' or tag:color := 'red')

• "server:Host.Aws.Ec2InstanceType := 't2' and server:Host.CpuInfo.NumberOfCpus >= 2"

Nilai numerik dapat ditentukan menggunakan notasi eksponensial, misalnya:. "server:Host.Memory.TotalBytes > 1024E6"

Properti server yang didukung adalah:

• 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

Tipe: String

Wajib: Tidak

StorageRoot

Menentukan path ke folder yang digunakan untuk penyimpanan sesi. Untuk informasi selengkapnya tentang penyimpanan sesi Amazon DCV, lihat Mengaktifkan Penyimpanan Sesi di Panduan Administrator Amazon DCV.

Tipe: String

Wajib: Tidak

Parameter respons

Id

ID unik sesi.

Name

Nama sesi.

Owner

Pemilik sesi.

Type

Jenis sesi.

State

Keadaan sesi. Jika permintaan berhasil diselesaikan, sesi memasuki CREATING status.

Substate

Substate sesi. Jika permintaan berhasil diselesaikan, substate memasuki substate. SESSION_PLACING

Contoh

Python

Permintaan

Contoh berikut menciptakan tiga sesi.

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),
])

Respons

Berikut ini adalah output sampel.

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