本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 用于管理应用程序应用程序授权的 WorkSpaces API 操作
<a name="manage-app-entitlement-api-actions"></a>

您可以使用以下 API 操作来管理应用程序的 WorkSpaces 应用程序授权。

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

将应用程序添加到应用程序用户的 WorkSpaces 应用程序目录中。Applicati WorkSpaces ons 显示的应用程序目录包括您使用此 API 操作添加的应用程序和您在图像中添加的应用程序。在您使用其中一种或两种方法添加应用程序后，您的用户可以启动应用程序。

**请求语法**

*string userSid;*

`list<Application> applications;`

**请求参数**

***userSid***  
请求适用于的用户的 SID。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 208 个字符。

***applications***  
请求适用于的应用程序的列表。  
**类型**：字符串  
**是否必需**：是

## `Application` 对象
<a name="manage-app-entitlement-api-application-object"></a>

描述显示和启动应用程序所需的应用程序元数据。应用程序标识符必须是唯一的，并且不与通过 API 操作或映像指定的其他应用程序冲突。

***id***  
指定的应用程序的标识符。该值与 WorkSpaces 应用程序应用程序报告中的`application_name`值相对应，在用户启动应用程序时提供。启用[使用率报告](enable-usage-reports.md)后，对于用户在流式传输会话期间每天至少启动一个应用程序，应用程序会将一份 WorkSpaces 应用程序报告导出到您的 Amazon S3 存储桶。有关应用程序报告的更多信息，请参阅[应用程序报告字段](usage-reports-fields-applications-reports.md)。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 512 个字符。

***displayName***  
指定的应用程序的显示名称。此名称显示给应用程序目录中的用户。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 512 个字符。

***launchPath***  
要启动的应用程序的可执行文件的 Windows 文件系统路径。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 32767 个字符。

***iconData***  
要在应用程序目录中显示的 base-64 编码的图像。此图像必须为以下格式之一：.png、.jpeg 或 .jpg。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 1000000 个字符。

***launchParams***  
用于启动应用程序的参数。  
**类型**：字符串  
**必需**：否  
**长度约束：**最大长度为 32000 个字符。

***workingDirectory***  
应在其中启动应用程序的工作目录的 Windows 文件系统路径。  
**类型**：字符串  
**必需**：否  
**长度约束：**最大长度为 32767 个字符。

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

删除使用 `AddApplicationsRequest` 操作添加的应用程序。将从用户的应用程序目录中删除应用程序。在删除应用程序后，无法启动它们。如果应用程序仍在运行，则 WorkSpaces 应用程序不会将其关闭。无法删除直接在 WorkSpaces 应用程序映像中指定的应用程序。

**请求语法**

*string userSid;*

`list<Application> applications;`

**请求参数**

***userSid***  
请求适用于的用户的 SID。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 208 个字符。

***applications***  
请求适用于的应用程序的列表。  
**类型**：字符串  
**是否必需**：是

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

删除使用 `AddApplicationsRequest` 操作添加到应用程序目录中的所有应用程序。在删除应用程序后，无法启动它们。如果在使用`ClearApplicationsRequest`操作时应用程序正在运行，则 WorkSpaces 应用程序不会将其关闭。无法删除直接在 WorkSpaces 应用程序映像中指定的应用程序。

**请求语法**

*string userSid;*

**请求参数**

***userSid***  
请求适用于的用户的 SID。  
**类型**：字符串  
**是否必需**：是  
**长度约束：**最小长度为 1 个字符，最大长度为 208 个字符。