Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Actions d'API pour gérer les droits des WorkSpaces applications
<a name="manage-app-entitlement-api-actions"></a>

Vous pouvez utiliser les opérations d'API suivantes pour gérer les droits des WorkSpaces applications.

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

Ajoute des applications au catalogue d'applications pour les utilisateurs WorkSpaces d'applications. Le catalogue d'applications affiché par WorkSpaces Applications inclut les applications que vous ajoutez à l'aide de cette opération d'API et les applications que vous ajoutez dans l'image. Une fois que vous avez ajouté des applications à l'aide d'une ou deux de ces méthodes, vos utilisateurs peuvent lancer les applications.

**Syntaxe de demande**

{{string userSid;}}

`list<Application> applications;`

**Paramètres de requête**

**{{userSid}}**  
Le SID de l'utilisateur à qui s'applique la demande.  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 208 caractères.

**{{applications}}**  
La liste des applications auxquelles s’applique la demande.  
**Type** : chaîne  
**Obligatoire** : oui

## Objet `de l'application`
<a name="manage-app-entitlement-api-application-object"></a>

Décrit les métadonnées d'application requises pour afficher et lancer l'application. L'identifiant de l'application doit être unique et ne doit pas être en conflit avec d'autres applications spécifiées par le biais de l'opération d'API ou de l'image.

**{{id}}**  
L'identifiant de l'application spécifiée. Cette valeur, qui correspond à la `application_name` valeur d'un rapport sur WorkSpaces les applications d'applications, est fournie lorsqu'un utilisateur lance l'application. Lorsque vous activez les [rapports d'utilisation](enable-usage-reports.md), pour chaque jour pendant lequel les utilisateurs lancent au moins une application pendant leurs sessions de streaming, WorkSpaces Applications exporte un rapport d'applications vers votre compartiment Amazon S3. Pour plus d'informations sur les rapports d'applications, consultez [Champs du rapport d’applications](usage-reports-fields-applications-reports.md).  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 512 caractères.

**{{displayName}}**  
Le nom d'affichage de l'application spécifiée. Ce nom s'affiche à l'utilisateur dans le catalogue d'applications.  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 512 caractères.

**{{launchPath}}**  
Le chemin d'accès du système de fichiers Windows à l'exécutable de l'application à lancer.  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 32 767 caractères.

**{{iconData}}**  
L'image encodée base-64 à afficher dans le catalogue d'applications. L'image doit être dans l'un des formats suivants : .png, .jpeg ou .jpg.  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 1 000 000 caractères.

**{{launchParams}}**  
Les paramètres utilisés pour lancer l'application.  
**Type** : chaîne  
**Obligatoire** : non  
**Contraintes de longueur :** longueur maximale de 32 000 caractères.

**{{workingDirectory}}**  
Le chemin d'accès du système de fichiers Windows au répertoire de travail dans lequel l'application doit être lancée.  
**Type** : chaîne  
**Obligatoire** : non  
**Contraintes de longueur :** longueur maximale de 32 767 caractères.

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

Supprime les applications qui ont été ajoutées à l'aide de l'opération `AddApplicationsRequest`. Les applications sont supprimées du catalogue d'applications pour l'utilisateur. Une fois les applications supprimées, elles ne peuvent pas être lancées. Si une application est toujours en cours d'exécution, WorkSpaces Applications ne la ferme pas. Les applications spécifiées directement dans l'image WorkSpaces Applications ne peuvent pas être supprimées.

**Syntaxe de demande**

{{string userSid;}}

`list<Application> applications;`

**Paramètres de requête**

**{{userSid}}**  
Le SID de l’utilisateur à qui s’applique la demande.  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 208 caractères.

**{{applications}}**  
La liste des applications auxquelles s’applique la demande.  
**Type** : chaîne  
**Obligatoire** : oui

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

Supprime toutes les applications qui ont été ajoutées au catalogue d'applications à l'aide de l'opération `AddApplicationsRequest`. Une fois les applications supprimées, elles ne peuvent pas être lancées. Si les applications sont en cours d'exécution lorsque l'`ClearApplicationsRequest`opération est utilisée, WorkSpaces Applications ne les ferme pas. Les applications spécifiées directement dans l'image WorkSpaces Applications ne peuvent pas être supprimées.

**Syntaxe de demande**

{{string userSid;}}

**Paramètres de requête**

**{{userSid}}**  
Le SID de l’utilisateur à qui s’applique la demande.  
**Type** : chaîne  
**Obligatoire** : oui  
**Contraintes de longueur :** longueur minimale de 1 caractère, longueur maximale de 208 caractères.