As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar AWS CLI perfis para o Boto3 e o SDK do Braket
<a name="braket-using-boto3-profiles"></a>

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ê executar seu código localmente (em uma instância do Amazon EC2, por exemplo), você pode estabelecer AWS CLI perfis 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.

**Topics**
+ [Etapa 1: Configurar uma AWS CLI local `profile`](#braket-using-boto3-profiles-step-1)
+ [Etapa 2: estabelecer um objeto de sessão de Boto3](#braket-using-boto3-profiles-step-2)
+ [Etapa 3: incorporar a sessão de Boto3 ao Braket AwsSession](#braket-using-boto3-profiles-step-3)

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

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 .
+  [Conceitos básicos](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) 
+  [Configurando o AWS CLI para usar Centro de Identidade do AWS IAM](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) 

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 **AmazonBraketFullAccess**política.

## Etapa 2: estabelecer um objeto de sessão de Boto3
<a name="braket-using-boto3-profiles-step-2"></a>

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`us-east-1`, como`us-west-1`, e assim por diante.

## Etapa 3: incorporar a sessão de Boto3 ao Braket AwsSession
<a name="braket-using-boto3-profiles-step-3"></a>

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`.