Configuración de perfiles de AWS CLI para Boto3 y el SDK de Braket
El SDK de Amazon Braket se basa en las credenciales de la AWS CLI predeterminadas, a menos que especifique 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.
Opcionalmente, si ejecuta su código localmente (en una instancia de Amazon EC2, por ejemplo), puede establecer perfiles de AWS CLI con nombre. 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.
En esta sección:
Paso 1: Configurar un profile de CLI de AWS
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:
Para utilizar Amazon Braket, debe proporcionar a este usuario, y al profile de CLI asociado, los permisos necesarios de Braket. Por ejemplo, puede asociar la política AmazonBraketFullAccess.
Paso 2: Establecer un objeto de sesión de Boto3
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`)
Para el argumento designado como region, sustituya un valor que corresponda a uno de las Regiones de AWS en las que Amazon Braket esté disponible, como us-east-1 o us-west-1, entre otras.
Paso 3: Incorporar la sesión de Boto3 a la sesión de Braket AWS
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.
