Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# API-Aktionen zur Verwaltung von App-Berechtigungen für Anwendungen WorkSpaces
<a name="manage-app-entitlement-api-actions"></a>

Sie können die folgenden API-Operationen verwenden, um die Anwendungsberechtigungen für WorkSpaces Anwendungen zu verwalten.

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

Fügt dem Anwendungskatalog WorkSpaces Anwendungen für Anwendungsbenutzer hinzu. Der von WorkSpaces Applications angezeigte Anwendungskatalog umfasst die Anwendungen, die Sie mithilfe dieses API-Vorgangs hinzufügen, sowie die Anwendungen, die Sie dem Image hinzufügen. Nach dem Hinzufügen der Anwendungen anhand einer oder beider Methoden können Ihre Benutzer die Anwendungen starten.

**Erforderliche Syntax**

{{string userSid;}}

`list<Application> applications;`

**Anfrageparameter**

**{{userSid}}**  
Die SID des Benutzers, für den die Anforderung gilt.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 201 Zeichen.

**{{applications}}**  
Die Liste der Anwendungen, für die die Anforderung gilt.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja

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

Beschreibt die erforderlichen Anwendungsmetadaten, um die Anwendung anzuzeigen und zu starten. Die Anwendungs-ID muss eindeutig sein und darf nicht im Konflikt mit anderen Anwendungen stehen, die über die API-Operation oder das Abbild angegeben sind.

**{{id}}**  
Die ID der Anwendung, die angegeben wird. Dieser Wert, der dem `application_name` Wert in einem WorkSpaces Anwendungsbericht entspricht, wird bereitgestellt, wenn ein Benutzer die Anwendung startet. Wenn Sie [Nutzungsberichte](enable-usage-reports.md) aktivieren, exportiert WorkSpaces Applications für jeden Tag, an dem Benutzer während ihrer Streaming-Sitzungen mindestens eine Anwendung starten, einen Anwendungsbericht in Ihren Amazon S3 S3-Bucket. Weitere Informationen über Anwendungsberichte finden Sie unter [Felder in Anwendungsberichten](usage-reports-fields-applications-reports.md).  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 512 Zeichen.

**{{displayName}}**  
Der Anzeigename der Anwendung, die angegeben wird. Dieser Name wird dem Benutzer im Anwendungskatalog angezeigt.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 512 Zeichen.

**{{launchPath}}**  
Der Windows-Dateisystempfad zur ausführbaren Datei der Anwendung, die gestartet werden soll.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 32,767 Zeichen.

**{{iconData}}**  
Das Basis-64-kodierte Abbild zum Anzeigen im Anwendungskatalog. Das Abbild muss in einem der folgenden Formate vorliegen: .png, .jpeg oder .jpg.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 1 000 000 Zeichen.

**{{launchParams}}**  
Die Parameter, mit denen die Anwendung gestartet wird.  
**Typ:** Zeichenfolge  
**Required**: No  
**Längenbeschränkungen:** maximale Länge von 32 000 Zeichen.

**{{workingDirectory}}**  
Der Windows-Dateisystempfad zum Arbeitsverzeichnis, in dem die Anwendung gestartet werden soll.  
**Typ:** Zeichenfolge  
**Required**: No  
**Längenbeschränkungen:** maximale Länge von 32 767 Zeichen.

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

Entfernt Anwendungen, die anhand der `AddApplicationsRequest`-Operation hinzugefügt wurden. Die Anwendungen werden aus dem Anwendungskatalog für den Benutzer entfernt. Nach dem Entfernen der Anwendungen können diese nicht gestartet werden. Wenn eine Anwendung noch läuft, wird sie von WorkSpaces Applications nicht geschlossen. Anwendungen, die direkt im WorkSpaces Anwendungs-Image angegeben sind, können nicht entfernt werden.

**Erforderliche Syntax**

{{string userSid;}}

`list<Application> applications;`

**Anfrageparameter**

**{{userSid}}**  
Die SID des Benutzers, für den die Anforderung gilt.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 201 Zeichen.

**{{applications}}**  
Die Liste der Anwendungen, für die die Anforderung gilt.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja

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

Entfernt alle Anwendungen, die dem Anwendungskatalog anhand der `AddApplicationsRequest`-Operation hinzugefügt wurden. Nach dem Entfernen der Anwendungen können diese nicht gestartet werden. Wenn die Anwendungen ausgeführt werden, während der `ClearApplicationsRequest` Vorgang ausgeführt wird, werden sie von WorkSpaces Applications nicht geschlossen. Anwendungen, die direkt im WorkSpaces Anwendungs-Image angegeben sind, können nicht entfernt werden.

**Erforderliche Syntax**

{{string userSid;}}

**Anfrageparameter**

**{{userSid}}**  
Die SID des Benutzers, für den die Anforderung gilt.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja  
**Längenbeschränkungen:** minimale Länge 1, maximale Länge 201 Zeichen.