CreateSessions

Membuat DCV sesi Amazon 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 DCV server Amazon target.

Tipe: String

Diperlukan: Ya

Type

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

Nilai yang valid: CONSOLE | VIRTUAL

Tipe: String

Diperlukan: Ya

InitFile

Didukung dengan sesi virtual di DCV server Amazon Linux. Ini tidak didukung dengan sesi konsol di DCV server Windows dan Linux Amazon. Jalur ke skrip khusus di DCV server Amazon untuk 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 DCV Sesi Amazon.

Tipe: String

Wajib: Tidak

MaxConcurrents

Jumlah maksimum DCV klien Amazon 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 DCV server Windows Amazon.

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 DCV Otorisasi Amazon di Panduan DCVAdministrator Amazon.

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 DCV server Windows Amazon dan sesi virtual di DCV server Amazon Linux. Ini tidak didukung dengan sesi konsol di DCV server Amazon Linux.

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 DCV Sesi Amazon.

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

Tipe: String

Wajib: Tidak

AutorunFileArguments

Didukung dengan sesi virtual di DCV server Amazon Linux. Ini tidak didukung dalam sesi konsol di DCV server Windows dan Linux Amazon. 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 DCV Sesi Amazon.

Tipe: Array string

Wajib: Tidak

DisableRetryOnFailure

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

Jenis: Boolean

Bawaan: salah

Wajib: Tidak

Requirements

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

Persyaratan ekspresi kondisi:

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

• a = b benar jika a adalah sama dengan b

• a > b benar jika a lebih besar dari b

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

• a < b benar jika a kurang dari b

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

• a = b benar jika a berisi string b

Persyaratan operator boolean:

• a dan b benar jika a and b adalah benar

• a atau b benar jika a atau b adalah benar

• tidak a benar jika a adalah palsu

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 DCV sesi Amazon, lihat Mengaktifkan Penyimpanan Sesi di Panduan DCV Administrator Amazon.

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