As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Ações de API para gerenciar a titularidade de aplicativos WorkSpaces
<a name="manage-app-entitlement-api-actions"></a>

Você pode usar as seguintes operações de API para gerenciar a autorização de aplicativos. WorkSpaces 

## Operação do `AddApplicationsRequest`
<a name="manage-app-entitlement-api-addapplications-request"></a>

Adiciona aplicativos ao catálogo de aplicativos para usuários de WorkSpaces aplicativos. O catálogo de WorkSpaces aplicativos exibido por Aplicativos inclui os aplicativos que você adiciona usando essa operação de API e os aplicativos que você adiciona na imagem. Após adicionar aplicativos usando um ou ambos os métodos, os usuários podem executar os aplicativos.

**Sintaxe da solicitação**

{{string userSid;}}

`list<Application> applications;`

**Parâmetros de solicitação**

**{{userSid}}**  
O SID do usuário ao qual a solicitação se aplica.  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 208 caracteres.

**{{applications}}**  
A lista de aplicativos à qual a solicitação se aplica.  
**Tipo:** string  
**Obrigatório**: Sim

## Objeto `de aplicativo`
<a name="manage-app-entitlement-api-application-object"></a>

Descreve os metadados de aplicativos necessários para exibir e executar o aplicativo. O identificador de aplicativo deve ser exclusivo e não estar em conflito com outros aplicativos especificados por meio da operação da API ou a imagem.

**{{id}}**  
O identificador do aplicativo que está sendo especificado. Esse valor, que corresponde ao `application_name` valor em um relatório de WorkSpaces aplicativos de aplicativos, é fornecido quando um usuário inicia o aplicativo. Quando você habilita [relatórios de uso](enable-usage-reports.md), para cada dia em que os usuários iniciam pelo menos um aplicativo durante suas sessões de streaming, o WorkSpaces Applications exporta um relatório de aplicativos para seu bucket do Amazon S3. Para obter mais informações sobre relatórios de aplicativos, consulte [Campos do relatório de aplicativos](usage-reports-fields-applications-reports.md).  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 512 caracteres.

**{{displayName}}**  
O nome de exibição do aplicativo que está sendo especificado. Esse nome é exibido ao usuário no catálogo de aplicativos.  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 512 caracteres.

**{{launchPath}}**  
O caminho do sistema de arquivos do Windows para o executável do aplicativo a ser iniciado.  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 32,767 caracteres.

**{{iconData}}**  
A imagem codificada em base64 para exibir no catálogo de aplicativos. A imagem deve estar em um dos seguintes formatos: .png, .jpeg ou .jpg.  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 1,000,000 caracteres.

**{{launchParams}}**  
Os parâmetros usados para executar o aplicativo.  
**Tipo:** string  
**Obrigatório**: não  
**Restrições de tamanho**: o tamanho máximo é de 32.000 caracteres.

**{{workingDirectory}}**  
O caminho do sistema de arquivos do Windows para o diretório de trabalho no qual o aplicativo deve ser executado.  
**Tipo:** string  
**Obrigatório**: não  
**Restrições de tamanho**: o tamanho máximo é de 32.767 caracteres.

## Operação do `RemoveApplicationsRequest`
<a name="manage-app-entitlement-api-removeapplications-request"></a>

Remove os aplicativos que foram adicionados usando a operação `AddApplicationsRequest`. Os aplicativos são removidos do catálogo de aplicativos para o usuário. Após a remoção dos aplicativos, eles não podem ser executados. Se um aplicativo ainda estiver em execução, o WorkSpaces Applications não o fechará. Os aplicativos especificados diretamente na imagem WorkSpaces Aplicativos não podem ser removidos.

**Sintaxe da solicitação**

{{string userSid;}}

`list<Application> applications;`

**Parâmetros de solicitação**

**{{userSid}}**  
O SID do usuário ao qual a solicitação se aplica.  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 208 caracteres.

**{{applications}}**  
A lista de aplicativos à qual a solicitação se aplica.  
**Tipo:** string  
**Obrigatório**: Sim

## Operação do `ClearApplicationsRequest`
<a name="manage-app-entitlement-api-clearapplications-request"></a>

Remove todos os aplicativos que foram adicionados ao catálogo de aplicativos usando a operação `AddApplicationsRequest`. Após a remoção dos aplicativos, eles não podem ser executados. Se os aplicativos estiverem em execução quando a `ClearApplicationsRequest` operação for usada, os WorkSpaces Aplicativos não os fecharão. Os aplicativos especificados diretamente na imagem WorkSpaces Aplicativos não podem ser removidos.

**Sintaxe da solicitação**

{{string userSid;}}

**Parâmetros de solicitação**

**{{userSid}}**  
O SID do usuário ao qual a solicitação se aplica.  
**Tipo:** string  
**Obrigatório**: Sim  
**Restrições de comprimento**: mínimo de 1, máximo de 208 caracteres.