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

# Tindakan API untuk Mengelola Hak Aplikasi untuk WorkSpaces Aplikasi
<a name="manage-app-entitlement-api-actions"></a>

Anda dapat menggunakan operasi API berikut untuk mengelola hak aplikasi untuk WorkSpaces Aplikasi.

## Operasi `AddApplicationsRequest`
<a name="manage-app-entitlement-api-addapplications-request"></a>

Menambahkan aplikasi ke katalog aplikasi untuk pengguna WorkSpaces Aplikasi. Katalog aplikasi yang ditampilkan oleh WorkSpaces Aplikasi mencakup aplikasi yang Anda tambahkan dengan menggunakan operasi API ini dan aplikasi yang Anda tambahkan dalam gambar. Setelah Anda menambahkan aplikasi dengan menggunakan salah satu atau kedua metode ini, pengguna Anda dapat meluncurkan aplikasi.

**Permintaan sintaks**

{{string userSid;}}

`list<Application> applications;`

**Parameter permintaan**

**{{userSid}}**  
SID pengguna yang permintaannya berlaku.  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 208 karakter.

**{{applications}}**  
Daftar aplikasi yang berlaku untuk permintaan tersebut.  
**Tipe**: String  
**Wajib**: Ya

## Objek `aplikasi`
<a name="manage-app-entitlement-api-application-object"></a>

Menjelaskan metadata aplikasi yang diperlukan untuk menampilkan dan meluncurkan aplikasi. Pengidentifikasi aplikasi harus unik dan tidak bertentangan dengan aplikasi lain yang ditentukan melalui operasi API atau gambar.

**{{id}}**  
Pengidentifikasi aplikasi yang ditentukan. Nilai ini, yang sesuai dengan `application_name` nilai dalam laporan WorkSpaces aplikasi Aplikasi, diberikan saat pengguna meluncurkan aplikasi. Saat Anda mengaktifkan [laporan penggunaan](enable-usage-reports.md), untuk setiap hari pengguna meluncurkan setidaknya satu aplikasi selama sesi streaming mereka, WorkSpaces Aplikasi mengekspor laporan aplikasi ke bucket Amazon S3 Anda. Untuk informasi selengkapnya tentang laporan aplikasi, lihat[Bidang Laporan Aplikasi](usage-reports-fields-applications-reports.md).  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 512 karakter.

**{{displayName}}**  
Nama tampilan aplikasi yang ditentukan. Nama ini ditampilkan kepada pengguna di katalog aplikasi.  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 512 karakter.

**{{launchPath}}**  
Jalur sistem file Windows ke executable aplikasi yang akan diluncurkan.  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 32.767 karakter.

**{{iconData}}**  
Gambar yang dikodekan basis-64 untuk ditampilkan dalam katalog aplikasi. Gambar harus dalam salah satu format berikut: .png, .jpeg, atau .jpg.  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 1.000.000 karakter.

**{{launchParams}}**  
Parameter yang digunakan untuk meluncurkan aplikasi.  
**Tipe**: String  
**Wajib**: Tidak  
**Kendala panjang: Panjang maksimum 32.000** karakter.

**{{workingDirectory}}**  
Jalur sistem file Windows ke direktori kerja tempat aplikasi harus diluncurkan.  
**Tipe**: String  
**Wajib**: Tidak  
**Kendala panjang: Panjang maksimum 32.767** karakter.

## Operasi `RemoveApplicationsRequest`
<a name="manage-app-entitlement-api-removeapplications-request"></a>

Menghapus aplikasi yang ditambahkan dengan menggunakan `AddApplicationsRequest` operasi. Aplikasi dihapus dari katalog aplikasi untuk pengguna. Setelah aplikasi dihapus, mereka tidak dapat diluncurkan. Jika aplikasi masih berjalan, WorkSpaces Aplikasi tidak menutupnya. Aplikasi yang ditentukan langsung dalam gambar WorkSpaces Aplikasi tidak dapat dihapus.

**Permintaan sintaks**

{{string userSid;}}

`list<Application> applications;`

**Parameter permintaan**

**{{userSid}}**  
SID pengguna permintaan berlaku untuk.  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 208 karakter.

**{{applications}}**  
Daftar aplikasi yang berlaku untuk permintaan tersebut.  
**Tipe**: String  
**Wajib**: Ya

## Operasi `ClearApplicationsRequest`
<a name="manage-app-entitlement-api-clearapplications-request"></a>

Menghapus semua aplikasi yang ditambahkan ke katalog aplikasi dengan menggunakan `AddApplicationsRequest` operasi. Setelah aplikasi dihapus, mereka tidak dapat diluncurkan. Jika aplikasi berjalan saat `ClearApplicationsRequest` operasi digunakan, WorkSpaces Aplikasi tidak menutupnya. Aplikasi yang ditentukan langsung dalam gambar WorkSpaces Aplikasi tidak dapat dihapus.

**Permintaan sintaks**

{{string userSid;}}

**Parameter permintaan**

**{{userSid}}**  
SID pengguna permintaan berlaku untuk.  
**Tipe**: String  
**Wajib**: Ya  
**Kendala panjang:** Panjang minimum 1, panjang maksimum 208 karakter.