

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Braket 문제 해결
<a name="braket-troubleshooting"></a>

이 섹션의 문제 해결 정보와 솔루션을 사용하여 Amazon Braket 관련 문제를 해결합니다.

**Topics**
+ [AccessDeniedException](#braket-troubleshooting-access-denied)
+ [CreateQuantumTask 연산을 직접적으로 호출할 때 오류(ValidationException)가 발생함](#braket-troubleshooting-create-fail)
+ [SDK 기능이 작동하지 않음](#braket-troubleshooting-sdk)
+ [ServiceQuotaExceededException으로 인해 하이브리드 작업이 실패함](#braket-jobs-quota-troubleshoot)
+ [노트북 인스턴스에서 구성 요소가 작동을 멈춤](#braket-troubleshooting-notebook-issue)
+ [Python 3.12 업그레이드 문제 해결](braket-troubleshooting-python312.md)
+ [OpenQASM 문제 해결](braket-troubleshooting-openqasm.md)

## AccessDeniedException
<a name="braket-troubleshooting-access-denied"></a>

Braket을 활성화하거나 사용할 때 **AccessDeniedException**을 수신하는 경우 제한된 역할에 액세스 권한이 없는 리전에서 Braket을 활성화하거나 사용하려 시도하고 있을 가능성이 높습니다.

이러한 경우 내부 AWS 관리자에게 문의하여 다음 중 어떤 조건이 적용되는지 알아보십시오.
+ 리전에 대한 액세스를 금지하는 역할 제한이 있는 경우
+ 사용하려는 역할에 Braket 사용이 허용된 경우

Braket을 사용할 때 역할이 지정된 리전에 액세스할 수 없는 경우 해당 리전의 디바이스를 사용할 수 없습니다.

## CreateQuantumTask 연산을 직접적으로 호출할 때 오류(ValidationException)가 발생함
<a name="braket-troubleshooting-create-fail"></a>

`An error occurred (ValidationException) when calling the CreateQuantumTask operation: Caller doesn't have access to amazon-braket-…​`과 유사한 오류가 발생하는 경우 기존 s3\$1folder를 참조하고 있는지 확인합니다. Braket은 새 Amazon S3 버킷과 접두사를 자동으로 생성하지 않습니다.

API에 직접 액세스하고 `Failed to create quantum task: Caller doesn't have access to s3://MY_BUCKET`과 유사한 오류가 수신되는 경우: Amazon S3 버킷 경로에 `s3://`이 포함되어 있지 않은지 확인합니다.

## SDK 기능이 작동하지 않음
<a name="braket-troubleshooting-sdk"></a>

Python 버전은 3.10 이상이어야 합니다. Amazon Braket Hybrid Jobs의 경우 Python 3.12를 사용하는 것이 좋습니다.

SDK 및 스키마가 최신 상태인지 확인합니다. 노트북 또는 Python 편집기에서 SDK를 업데이트하려면 다음 명령을 실행합니다.

```
pip install amazon-braket-sdk --upgrade --upgrade-strategy eager
```

스키마를 업데이트하려면 다음 명령을 실행합니다.

```
pip install amazon-braket-schemas --upgrade
```

자체 클라이언트에서 Amazon Braket에 액세스하는 경우 [AWS 리전](https://docs.aws.amazon.com/braket/latest/developerguide/braket-devices.html#braket-regions)이 Amazon Braket에서 지원하는 리전으로 설정되어 있는지 확인합니다.

## ServiceQuotaExceededException으로 인해 하이브리드 작업이 실패함
<a name="braket-jobs-quota-troubleshoot"></a>

대상 시뮬레이터 디바이스의 동시 양자 작업 제한을 초과하면 Amazon Braket 시뮬레이터에 대해 양자 작업을 실행하는 하이브리드 작업이 생성되지 않을 수 있습니다. 서비스 제한에 대한 자세한 내용은 [할당량](braket-quotas.md) 주제를 참조하세요.

 계정의 여러 하이브리드 작업에서 시뮬레이터 디바이스에 대해 동시 작업을 실행하는 경우 이 오류가 발생할 수 있습니다.

특정 시뮬레이터 디바이스에 대한 동시 양자 작업 수를 보려면 다음 코드 예제와 같이 `search-quantum-tasks` API를 사용합니다.

```
DEVICE_ARN=arn:aws:braket:::device/quantum-simulator/amazon/sv1
task_list=""
for status_value in "CREATED" "QUEUED" "RUNNING" "CANCELLING"; do
    tasks=$(aws braket search-quantum-tasks --filters name=status,operator=EQUAL,values=${status_value} name=deviceArn,operator=EQUAL,values=$DEVICE_ARN --max-results 100 --query 'quantumTasks[*].quantumTaskArn' --output text)
    task_list="$task_list $tasks"
done;
echo "$task_list" | tr -s ' \t' '[\n*]' | sort | uniq
```

Amazon CloudWatch 지표: ** Braket ** > **내 디바이스**를 사용하여 디바이스에 대해 생성된 양자 작업을 볼 수도 있습니다.

**이러한 오류가 발생하지 않도록 하려면 다음과 같이 하세요.**

1. 시뮬레이터 디바이스의 동시 양자 작업 수에 대한 서비스 할당량 증가를 요청합니다. 이는 SV1 디바이스에만 적용됩니다.

1. 코드의 `ServiceQuotaExceeded` 예외를 처리하고 다시 시도합니다.

## 노트북 인스턴스에서 구성 요소가 작동을 멈춤
<a name="braket-troubleshooting-notebook-issue"></a>

노트북의 일부 구성 요소가 작동을 멈추면 다음을 시도하세요.

1. 생성하거나 수정한 노트북을 로컬 드라이브에 다운로드합니다.

1. 노트북 인스턴스를 중지합니다.

1. 노트북 인스턴스를 삭제합니다.

1. 다른 이름으로 새 노트북 인스턴스를 생성합니다.

1. 노트북을 새 인스턴스에 업로드합니다.