

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.

# Configure los AWS CLI perfiles para Boto3 y el SDK de Braket
<a name="braket-using-boto3-profiles"></a>

El SDK de Amazon Braket se basa en las AWS CLI credenciales predeterminadas, a menos que especifiques lo contrario de forma explícita. Le recomendamos que mantenga la configuración predeterminada cuando ejecute un cuaderno administrado de Amazon Braket, ya que debe proporcionar un rol de IAM que tenga permisos para iniciar la instancia del cuaderno.

Si lo desea, si ejecuta el código localmente (en una instancia de Amazon EC2, por ejemplo), puede establecer perfiles con nombre AWS CLI . Puede asignar a cada perfil un conjunto de permisos diferente, en lugar de sobrescribir regularmente el perfil predeterminado.

En esta sección se explica brevemente cómo configurar dicho `profile` de CLI y cómo incorporar ese perfil en Amazon Braket para que las llamadas a la API se realicen con los permisos de ese perfil.

**Topics**
+ [Paso 1: Configurar una AWS CLI local `profile`](#braket-using-boto3-profiles-step-1)
+ [Paso 2: Establecer un objeto de sesión de Boto3](#braket-using-boto3-profiles-step-2)
+ [Paso 3: Incorpora la sesión de Boto3 al Braket AwsSession](#braket-using-boto3-profiles-step-3)

## Paso 1: Configurar una AWS CLI local `profile`
<a name="braket-using-boto3-profiles-step-1"></a>

Explicar cómo crear un usuario y cómo configurar un perfil no predeterminado está fuera del alcance de este documento. Para obtener más información sobre estos temas, consulte:
+  [Introducción](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) 
+  [Configurar el que se AWS CLI va a utilizar AWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) 

Para utilizar Amazon Braket, debe proporcionar a este usuario, y al `profile` de CLI asociado, los permisos necesarios de Braket. Por ejemplo, puede adjuntar la **AmazonBraketFullAccess**política.

## Paso 2: Establecer un objeto de sesión de Boto3
<a name="braket-using-boto3-profiles-step-2"></a>

Para establecer un objeto de sesión de Boto3, utilice el siguiente ejemplo de código.

```
from boto3 import Session

# Insert CLI profile name here
boto_sess = Session(profile_name=`profile`)
```

**nota**  
Si las llamadas a la API previstas tienen restricciones basadas en la región que no coinciden con su región de `profile` predeterminada, puede especificar una región para la sesión de Boto3, como se muestra en el siguiente ejemplo.

```
# Insert CLI profile name _and_ region
boto_sess = Session(profile_name=`profile`, region_name=`region`)
```

Sustituya el argumento designado como `region` por un valor que corresponda a uno de los Regiones de AWS en los que Amazon Braket esté disponible, por ejemplo`us-east-1`,`us-west-1`, y así sucesivamente.

## Paso 3: Incorpora la sesión de Boto3 al Braket AwsSession
<a name="braket-using-boto3-profiles-step-3"></a>

En el siguiente ejemplo, se muestra cómo inicializar una sesión de Boto3 con Braket e instanciar un dispositivo en esa sesión.

```
from braket.aws import AwsSession, AwsDevice

# Initialize Braket session with Boto3 Session credentials
aws_session = AwsSession(boto_session=boto_sess)

# Instantiate any Braket QPU device with the previously initiated AwsSession
sim_arn = 'arn:aws:braket:::device/quantum-simulator/amazon/sv1'
device = AwsDevice(sim_arn, aws_session=aws_session)
```

Una vez completada esta configuración, puede enviar tareas cuánticas a ese objeto de `AwsDevice` instanciado (por ejemplo, llamando al comando `device.run(…​)`). Todas las llamadas a la API realizadas por ese dispositivo pueden usar las credenciales de IAM asociadas al perfil de CLI que previamente designó como `profile`.