Execution on Amazon Braket Cloud

Usage

• SDK
• IDE

from classiq import AwsBackendPreferences

preferences = AwsBackendPreferences(
    backend_name="Name of requested simulator or hardware",
    aws_access_key_id="Amazon access key ID for the user with Braket access",
    aws_secret_access_key="Secret access key for the user's key ID",
    s3_bucket_name="S3 bucket name to save the results",
    s3_folder="The folder path within the S3 bucket, where the results will be saved",
    job_timeout="Timeout for execution (Optional)",
)

Initial Account Setup

1. Download the AssumeRole.cf.yaml file.
2. Install AWS CLI.
3. Contact Classiq support to obtain these parameters:
   1. CORRECT_TRUSTED_ACCOUNT
   2. CORRECT_EXTERNAL_ID_VALUE
4. Execute this command:
   aws cloudformation create-stack --stack-name ClassiqBraketRole --template-body file://AssumeRole.cf.yaml --capabilities CAPABILITY_NAMED_IAM --parameters ParameterKey=TrustedAccount,ParameterValue=${CORRECT_TRUSTED_ACCOUNT} ParameterKey=ExternalId,ParameterValue=${CORRECT_EXTERNAL_ID_VALUE}
   

Required Credentials

1. aws_access_key_id
   1. Create a user with Braket full access
   2. Create AWS secret key for this user
   3. Fill the access key id as you got in the earlier steps
2. aws_secret_access_key
   1. Fill the Secret access key from the steps above
3. s3_bucket_name
   1. Create a new bucket. Its name must start with amazon-braket-.
   2. Use the bucket name as the s3_bucket_name. This is the bucket that saves the execution results.
4. s3_folder
   1. Enter the path to the folder in the S3 bucket. This is the path in the bucket where the execution results are saved.

Device emulation (emulate)

• Default emulate=False: standard adapter from Qiskit to Braket.
• emulate=True: use Classiq’s emulator-style translation for the chosen device. If compilation fails, try without emulate or another backend; see the error message from the executor.

from classiq import AwsBackendPreferences

preferences = AwsBackendPreferences(
    backend_name="Ankaa-3",
    aws_access_key_id="…",
    aws_secret_access_key="…",
    s3_bucket_name="amazon-braket-…",
    s3_folder="results",
    emulate=True,
)

Supported Backends

• “Forte 1”
• “Emerald”
• “Ankaa-3”
• “Garnet”

• “SV1”
• “TN1”
• “dm1”