本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Boto3 和 Braket SDK 的 AWS CLI 設定檔


除非您另有明確指定，否則 Amazon Braket SDK 依賴預設 AWS CLI 登入資料。我們建議您在受管 Amazon Braket 筆記本上執行 時保持預設值，因為您必須提供具有啟動筆記本執行個體許可的 IAM 角色。

或者，如果您在本機 （例如 Amazon EC2 執行個體） 執行程式碼，您可以建立具名 AWS CLI 設定檔。您可以為每個設定檔提供不同的許可集，而不是定期覆寫預設設定檔。

本節提供如何設定此類 CLI `profile`以及如何將該設定檔併入 Amazon Braket 的簡短說明，以便使用來自該設定檔的許可進行API呼叫。

**Topics**
+ [

## 步驟 1：設定本機 AWS CLI `profile`
](#braket-using-boto3-profiles-step-1)
+ [

## 步驟 2：建立 Boto3 工作階段物件
](#braket-using-boto3-profiles-step-2)
+ [

## 步驟 3：將 Boto3 工作階段併入 Braket AwsSession
](#braket-using-boto3-profiles-step-3)

## 步驟 1：設定本機 AWS CLI `profile`


超出本文件的範圍，說明如何建立使用者，以及如何設定非預設設定檔。如需這些主題的詳細資訊，請參閱：
+  [開始使用](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) 
+  [設定 AWS CLI 以使用 AWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) 

若要使用 Amazon Braket，您必須向此使用者  和相關聯的 CLI `profile` 提供 必要的 Braket 許可。例如，您可以連接 **AmazonBraketFullAccess** 政策。

## 步驟 2：建立 Boto3 工作階段物件


若要建立 Boto3 工作階段物件，請利用下列程式碼範例。

```
from boto3 import Session

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

**注意**  
如果預期的API呼叫具有與`profile`預設區域不相符的區域型限制，您可以指定 Boto3 工作階段的區域，如下列範例所示。

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

對於指定為 的引數`region`，請取代對應至其中一個可用 Amazon Braket AWS 區域 的值`us-west-1`，例如 `us-east-1`、 等。

## 步驟 3：將 Boto3 工作階段併入 Braket AwsSession


下列範例顯示如何初始化 Boto3 Braket 工作階段，並執行個體化該工作階段中的裝置。

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

在此設定完成後，您可以將量子任務提交到該執行個體化`AwsDevice`物件 （例如呼叫 `device.run(…​)`命令）。該裝置進行的所有API呼叫都可以使用與您先前指定為 的 CLI 設定檔相關聯的 IAM 憑證`profile`。