Verwenden des AppStream 2.0 Dynamic Application Framework zum Erstellen eines Anbieters für dynamische Apps - Amazon AppStream 2.0

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.

Verwenden des AppStream 2.0 Dynamic Application Framework zum Erstellen eines Anbieters für dynamische Apps

Das AppStream 2.0 Dynamic Application Framework stellt API-Operationen auf einer Streaming-Instance von AppStream 2.0 bereit, die Sie zum Erstellen eines Anbieters für dynamische Apps verwenden können. Anbieter dynamischer Apps können die bereitgestellten API-Operationen zum Ändern des Katalogs der Anwendungen verwenden, auf die Ihre Benutzer in Echtzeit zugreifen können. Die von den Anbietern dynamischer Apps verwalteten Anwendungen können im Abbild enthalten sein oder sich außerhalb der Instance befinden, etwa auf einer Windows-Dateifreigabe oder in einer Anwendungsvirtualisierungstechnologie.

Anmerkung

Diese Funktion erfordert eine AppStream-2.0-Flotte, die einer Microsoft-Active-Directory-Domain beigetreten ist. Weitere Informationen finden Sie unter Verwenden von Active Directory mit AppStream 2.0.

Über das Dynamic Application Framework

Das Dynamic Application Framework verwendet das Apache Thrift-Software-Framework für Inter-Process-Messaging. Es wird über benannte Pipes in Windows bereitgestellt. Durch Verwendung des Thrift-Frameworks können Sie Ihren Anbieter für dynamische Apps in der Softwareentwicklungssprache Ihrer Wahl erstellen. Das Dynamic Application Framework besteht aus drei API-Operationen: AddApplications, RemoveApplications und ClearApplications.

Dynamic Application Framework Thrift-Definitionen und Name der benannten Pipe

Thrift ermöglicht Ihnen die Verwendung von einfachen Definitionsdateien, die von AppStream 2.0 bereitgestellt werden, um RPC-Clients zu kompilieren. Dank der RPC-Clients können Sie mit der AppStream-2.0-Agentensoftware auf einer Streaming-Instance kommunizieren. Weitere Informationen zum Kompilieren des RPC-Clients für Ihre Sprache finden Sie in der Apache Thrift-Dokumentation. Nach dem Kompilieren der Thrift-Bibliotheken für die Sprache Ihrer Wahl erstellen Sie einen Thrift-Client anhand des Named Pipe-Transports. Verwenden Sie D56C0258-2173-48D5-B0E6-1EC85AC67893 als Pipe-Name.

AppStreamServer.thrift

namespace netstd AppStream.ApplicationCatalogService.Model const string ServiceEndpoint = "D56C0258-2173-48D5-B0E6-1EC85AC67893"; struct AddApplicationsRequest { 1: required string userSid; 2: required list<Application> applications; } struct AddApplicationsResponse { } struct RemoveApplicationsRequest { 1: required string userSid; 2: required list<string> applicationIds; } struct RemoveApplicationsResponse { } struct ClearApplicationsRequest { 1: required string userSid; } struct ClearApplicationsResponse { } struct Application { 1: required string id; 2: required string displayName; 3: required string launchPath; 4: required string iconData; 5: string launchParams; 6: string workingDirectory; } exception AppStreamClientException { 1: string errorMessage, 2: ErrorCode errorCode } exception AppStreamServerException { 1: string errorMessage, 2: ErrorCode errorCode } enum ErrorCode { } service ApplicationCatalogService { AddApplicationsResponse AddApplications(1:AddApplicationsRequest request) throws (1: AppStreamClientException ce, 2: AppStreamServerException se), RemoveApplicationsResponse RemoveApplications(1:RemoveApplicationsRequest request) throws (1: AppStreamClientException ce, 2: AppStreamServerException se), ClearApplicationsResponse ClearApplications(1:ClearApplicationsRequest request) throws (1: AppStreamClientException ce, 2: AppStreamServerException se), }

API-Aktionen für die Verwaltung von App-Berechtigungen für AppStream 2.0

Sie können zur Verwaltung von Anwendungsberechtigungen für AppStream 2.0 die folgenden API-Operationen verwenden.

AddApplicationsRequest-Operation

Fügt dem Anwendungskatalog Anwendungen für AppStream-2.0-Benutzer hinzu Der von AppStream 2.0 angezeigte Anwendungskatalog enthält die Anwendungen, die Sie anhand dieser API-Operation hinzufügen und die Anwendungen, die Sie im Abbild hinzufügen. Nach dem Hinzufügen der Anwendungen anhand einer oder beider Methoden können Ihre Benutzer die Anwendungen starten.

Erforderliche Syntax

Zeichenfolge 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

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 AppStream-2.0-Anwendungsbericht entspricht, wird bereitgestellt, wenn ein Benutzer die Anwendung startet. Wenn Sie Nutzungsberichte aktivieren, exportiert AppStream 2.0 für jeden Tag, an dem Benutzer mindestens eine Anwendung während ihrer Streaming-Sitzungen starten, einen Anwendungsbericht in Ihren Amazon-S3-Bucket. Weitere Informationen über Anwendungsberichte finden Sie unter Felder in Anwendungsberichten.

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

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. Wird eine Anwendung noch ausgeführt, so wird sie von AppStream 2.0 nicht geschlossen. Anwendungen, die direkt im AppStream-2.0-Abbild angegeben werden, können nicht entfernt werden.

Erforderliche Syntax

Zeichenfolge 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

Entfernt alle Anwendungen, die dem Anwendungskatalog anhand der AddApplicationsRequest-Operation hinzugefügt wurden. Nach dem Entfernen der Anwendungen können diese nicht gestartet werden. Falls die Anwendungen ausgeführt werden, wenn die ClearApplicationsRequest-Operation verwendet wird, werden sie von AppStream 2.0 nicht geschlossen. Anwendungen, die direkt im AppStream-2.0-Abbild angegeben werden, können nicht entfernt werden.

Erforderliche Syntax

Zeichenfolge 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.