

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.

# Cómo utilizar el rol de IAM con WorkSpaces Instancias de streaming de aplicaciones
<a name="how-to-use-iam-role-with-streaming-instances"></a>

Después de crear un rol de IAM, puede aplicarlo en un constructor de imágenes o una instancia de streaming de flota al lanzar el constructor de imágenes o crear una flota. También puede aplicar un rol de IAM en las flotas existentes. Para obtener información acerca de cómo aplicar un rol de IAM al lanzar un constructor de imágenes, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md). Para obtener información acerca de cómo aplicar un rol de IAM al crear una flota, consulte [Crea una flota en Amazon WorkSpaces ¿Aplicaciones](set-up-stacks-fleets-create.md).

Cuando aplicas una función de IAM a tu instancia de creación de imágenes o de streaming de flotas, WorkSpaces Applications recupera las credenciales temporales y crea las **appstream\_machine\_role** perfil de credenciales de la instancia. Las credenciales temporales son válidas durante 1 hora y las nuevas credenciales se recuperan cada hora. Las credenciales anteriores no vencen, por lo que puede utilizarlas mientras sean válidas. Puede usar el perfil de credenciales para llamar AWS servicios mediante programación mediante el AWS Interfaz de línea de comandos (AWS CLI), AWS Herramientas para PowerShell, o el AWS SDK con el idioma que elijas.

Cuando realice llamadas a la API, especifique **appstream\_machine\_role** como el perfil de credenciales. De lo contrario, la operación falla debido a los permisos insuficientes.

WorkSpaces Las aplicaciones asumen la función especificada mientras se aprovisiona la instancia de streaming. Porque WorkSpaces Las aplicaciones utilizan la interfaz de red elástica que está conectada a su VPC para AWS Para realizar llamadas a la API, su aplicación o script debe esperar a que la interfaz de red elástica esté disponible AWS Llamadas a la API. Si las llamadas a la API se realizan antes de que la interfaz de red elástica esté disponible, las llamadas fallan.

En los siguientes ejemplos, se muestra cómo puede utilizar el perfil de credenciales** appstream\_machine\_role** para describir las instancias de streaming (instancias EC2) y crear el cliente de Boto. Boto es el SDK de Amazon Web Services (AWS) para Python. 

**Describa las instancias de streaming (instancias EC2) mediante el AWS CLI**

```
aws ec2 describe-instances --region us-east-1 --profile appstream_machine_role
```

**Describa las instancias de streaming (instancias EC2) mediante AWS Herramientas para PowerShell**

Debes usar AWS Herramientas para PowerShell versión 3.3.563.1 o posterior, con la versión 3.3.103.22 o posterior del SDK de Amazon Web Services para.NET. Puede descargar el AWS El instalador de herramientas para Windows, que incluye AWS Herramientas para PowerShell y el SDK de Amazon Web Services para.NET, desde [AWS Herramientas para PowerShell](https://aws.amazon.com/powershell/) sitio web.

```
Get-EC2Instance -Region us-east-1 -ProfileName appstream_machine_role
```

**Creación del cliente Boto mediante el AWS SDK para Python**

```
session = boto3.Session(profile_name='appstream_machine_role')
```