Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# CreateSessions
<a name="CreateSessions"></a>

Membuat sesi Amazon DCV baru dengan detail yang ditentukan.

**Topics**
+ [Permintaan parameter](#request)
+ [Parameter respons](#response)
+ [Contoh](#example)

## Permintaan parameter
<a name="request"></a>

**`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](https://docs.aws.amazon.com/dcv/latest/adminguide/managing-sessions.html) di Panduan *Administrator Amazon DCV*.  
Nilai yang valid: CONSOLE \$1 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](https://docs.aws.amazon.com/dcv/latest/sm-admin/agent-file.html) 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](https://docs.aws.amazon.com/dcv/latest/adminguide/security-authorization.html) 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](https://docs.aws.amazon.com/dcv/latest/sm-admin/agent-file.html) 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 **AutorunFile**eksekusi 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](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) 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](https://docs.aws.amazon.com/dcv/latest/sm-admin/broker-file.html) *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 **DescribeServers**API.   
Persyaratan ekspresi kondisi:  
+ *a***\$1 **= *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:  
+ *a***dan** *b* benar jika *a* *b* dan benar
+ *a***atau** *b* benar jika *a* atau *b* benar
+ **tidak** *a* benar *a* jika salah
Kunci tag harus diawali oleh`tag:`, 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](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-storage.html) Administrator *Amazon DCV*.  
Tipe: String  
Wajib: Tidak

## Parameter respons
<a name="response"></a>

**`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
<a name="example"></a>

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

------