Utilice el marco de aplicaciones dinámicas AppStream 2.0 para crear un proveedor de aplicaciones dinámico - Amazon AppStream 2.0.
Acerca del marco de aplicaciones dinámicasDefiniciones de Thrift y nombres de las canalizaciones con nombre en el marco de aplicaciones dinámicasAcciones de API para administrar los derechos de una aplicación

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilice el marco de aplicaciones dinámicas AppStream 2.0 para crear un proveedor de aplicaciones dinámico

El marco de aplicaciones dinámicas AppStream 2.0 proporciona operaciones de API dentro de una instancia de transmisión AppStream 2.0 que puedes usar para crear un proveedor de aplicaciones dinámico. Los proveedores de aplicaciones dinámicas pueden utilizar las operaciones API para modificar el catálogo de aplicaciones al que los usuarios pueden obtener acceso en tiempo real. Las aplicaciones administradas por los proveedores de aplicaciones dinámicas pueden estar dentro o fuera de la imagen, como en un recurso compartido de archivos de Windows o en una tecnología de virtualización de aplicaciones.

nota

Esta función requiere una flota AppStream 2.0 siempre activa o bajo demanda que esté unida a un dominio de Microsoft Active Directory. Para obtener más información, consulte Uso de Active Directory con AppStream 2.0.

nota

Esta función requiere una flota AppStream 2.0 que esté unida a un dominio de Microsoft Active Directory. Para obtener más información, consulte Uso de Active Directory con AppStream 2.0.

Acerca del marco de aplicaciones dinámicas

El marco de aplicaciones dinámicas utiliza el marco de software Apache Thrift para la mensajería entre procesos. Se expone a través de la opción "Canalizaciones con nombre" de Windows. El marco de Thrift le permite crear un proveedor de aplicaciones dinámicas en el lenguaje de desarrollo de software que prefiera. El marco de aplicaciones dinámicas se compone de tres operaciones API: AddApplications, RemoveApplications y ClearApplications.

Definiciones de Thrift y nombres de las canalizaciones con nombre en el marco de aplicaciones dinámicas

Thrift le permite utilizar archivos de definición simples proporcionados por la AppStream versión 2.0 para compilar clientes RPC. Los clientes RPC le permiten comunicarse con el software del agente AppStream 2.0 que se ejecuta en una instancia de streaming. Para obtener información acerca de cómo compilar el cliente RPC en su lenguaje, consulte la documentación de Apache Thrift. Una vez que haya compilado las bibliotecas de Thrift en lenguaje elegido, cree un cliente de Thrift utilizando el transporte de canalización con nombre. Utilice D56C0258-2173-48D5-B0E6-1EC85AC67893 como nombre de la canalización.

AppStreamServer.ahorro

namespace csharp AppStream.ApplicationCatalogService.Model

include "AppStreamServerMessages.thrift"

const string ServiceEndpoint = "D56C0258-2173-48D5-B0E6-1EC85AC67893";

service ApplicationCatalogService
{
    AppStreamServerMessages.AddApplicationsResponse AddApplications(1:AppStreamServerMessages.AddApplicationsRequest request)
    throws (1: AppStreamServerMessages.AppStreamClientException ce, 2: AppStreamServerMessages.AppStreamServerException se),

    AppStreamServerMessages.RemoveApplicationsResponse RemoveApplications(1:AppStreamServerMessages.RemoveApplicationsRequest request)
    throws (1: AppStreamServerMessages.AppStreamClientException ce, 2: AppStreamServerMessages.AppStreamServerException se),

    AppStreamServerMessages.ClearApplicationsResponse ClearApplications(1:AppStreamServerMessages.ClearApplicationsRequest request)
    throws (1: AppStreamServerMessages.AppStreamClientException ce, 2: AppStreamServerMessages.AppStreamServerException se),
}

AppStreamServerMessages.ahorro

namespace csharp AppStream.ApplicationCatalogService.Model

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
{
}

Acciones de API para administrar los permisos de aplicaciones para AppStream 2.0

Puede utilizar las siguientes operaciones de la API para administrar la autorización a la aplicación AppStream 2.0.

Operación de AddApplicationsRequest

Añade aplicaciones al catálogo de aplicaciones para usuarios de la AppStream versión 2.0. El catálogo de aplicaciones que muestra la AppStream versión 2.0 incluye las aplicaciones que se añaden mediante esta operación de API y las aplicaciones que se añaden a la imagen. Una vez que se han añadido aplicaciones mediante uno o ambos de estos métodos, los usuarios pueden lanzar las aplicaciones.

Sintaxis de la solicitud

cadena SidUsuario;

list<Application> applications;

Parámetros de solicitud

SidUsuario

SID del usuario al que se aplica la solicitud.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 208 caracteres.

applications

Lista de aplicaciones a la que se aplica la solicitud.

Tipo: cadena

Obligatorio: sí

Objeto Application

Describe los metadatos de la aplicación necesarios para mostrar y lanzar la aplicación. El identificador de la aplicación debe ser único y no puede estar en conflicto con otras aplicaciones especificadas a través de la operación API o la imagen.

id

Identificador de la aplicación que se está especificando. Este valor, que corresponde alapplication_name valor de un informe de aplicaciones AppStream 2.0, se proporciona cuando un usuario inicia la aplicación. Al habilitar los informes de uso, por cada día que los usuarios inicien al menos una aplicación durante sus sesiones de streaming, AppStream 2.0 exporta un informe de aplicaciones a su bucket de Amazon S3. Para obtener más información acerca de los informes de aplicaciones, consulte Campos de los informes de aplicaciones.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 512 caracteres.

nombreParaMostrar

Nombre para mostrar de la aplicación que se está especificando. Este nombre es el que el usuario ve en el catálogo de aplicaciones.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 512 caracteres.

launchPath

Ruta de acceso del sistema de archivos de Windows correspondiente al ejecutable de la aplicación que se va a lanzar.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 32 767 caracteres.

datosIcono

Imagen codificada en base 64 que se va a mostrar en el catálogo de aplicaciones. La imagen debe estar en uno de los siguientes formatos: .png, .jpeg o .jpg.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 1 000 000 caracteres.

parámetrosLanzamiento

Parámetros que se van a utilizar para lanzar la aplicación.

Tipo: cadena

Obligatorio: no

Limitaciones de longitud: longitud máxima de 32 000 caracteres.

workingDirectory

Ruta de acceso del sistema de archivos de Windows correspondiente al directorio de trabajo en el que debe lanzarse la aplicación.

Tipo: cadena

Obligatorio: no

Limitaciones de longitud: longitud máxima de 32 767 caracteres.

Operación de RemoveApplicationsRequest

Elimina las aplicaciones que se han añadido con la aplicación AddApplicationsRequest. Las aplicaciones se eliminan del catálogo del usuario. Una vez que las aplicaciones se han eliminado, no se pueden lanzar. Si una aplicación sigue ejecutándose, AppStream 2.0 no la cierra. Las aplicaciones que se especifican directamente en la imagen AppStream 2.0 no se pueden eliminar.

Sintaxis de la solicitud

cadena SidUsuario;

list<Application> applications;

Parámetros de solicitud

SidUsuario

SID del usuario al que se aplica la solicitud.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 208 caracteres.

applications

Lista de aplicaciones a la que se aplica la solicitud.

Tipo: cadena

Obligatorio: sí

Operación de ClearApplicationsRequest

Elimina todas las aplicaciones que se han añadido al catálogo de aplicaciones con la operación AddApplicationsRequest. Una vez que las aplicaciones se han eliminado, no se pueden lanzar. Si las aplicaciones se están ejecutando cuando se utiliza laClearApplicationsRequest operación, AppStream 2.0 no las cierra. Las aplicaciones que se especifican directamente en la imagen AppStream 2.0 no se pueden eliminar.

Sintaxis de la solicitud

cadena SidUsuario;

Parámetros de solicitud

SidUsuario

SID del usuario al que se aplica la solicitud.

Tipo: cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 208 caracteres.