Configurar perfis AWS CLI para o Boto3 e o SDK do Braket
O Amazon Braket SDK depende das credenciais AWS CLI padrão, a menos que você especifique explicitamente o contrário. Recomendamos que você mantenha o padrão ao executar em um caderno Amazon Braket gerenciado, pois você deve fornecer um perfil do IAM que tenha permissões para iniciar a instância do caderno.
Opcionalmente, se você rodar o código localmente (em uma instância do Amazon EC2, por exemplo), é possível estabelecer perfis AWS CLI nomeados. Você pode atribuir a cada perfil um conjunto de permissões diferente, em vez de substituir regularmente o perfil padrão.
Esta seção fornece uma breve explicação de como configurar esse profile CLI e como incorporá-lo ao Amazon Braket para que as chamadas de API sejam feitas com as permissões desse perfil.
Nesta seção:
Etapa 1: Configurar um profileAWS CLI local
Está além do escopo deste documento explicar como criar um usuário e como configurar um perfil não padrão. Para mais informações sobre esses tópicos, consulte .
Para usar o Amazon Braket, você deve fornecer a esse usuário — e ao profile CLI associado — as permissões necessárias do Braket. Por exemplo, você pode anexar a política AmazonBraketFullAccess.
Etapa 2: estabelecer um objeto de sessão de Boto3
Para estabelecer um objeto de sessão do Boto3, utilize o exemplo de código a seguir.
from boto3 import Session # Insert CLI profile name here boto_sess = Session(profile_name=`profile`)
nota
Se as chamadas de API esperadas tiverem restrições baseadas na região que não estejam alinhadas com sua região profile padrão, você poderá especificar uma região para a sessão de Boto3, conforme mostrado no exemplo a seguir.
# Insert CLI profile name _and_ region boto_sess = Session(profile_name=`profile`, region_name=`region`)
Para o argumento designado como region, substitua um valor que corresponda a um dos Regiões da AWS em que Amazon Braket está disponível, comous-east-1, us-west-1, e assim por diante.
Etapa 3: incorporar a sessão de Boto3 na sessão Braket AwsSession
O exemplo a seguir mostra como inicializar uma sessão de Boto3 Braket e instanciar um dispositivo nessa sessão.
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)
Depois que essa configuração for concluída, você poderá enviar tarefas quânticas para esse objeto AwsDevice instanciado (chamando o comando device.run(…), por exemplo). Todas as chamadas de API feitas por esse dispositivo podem usar as credenciais do IAM associadas ao perfil da CLI que você designou anteriormente como profile.