기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon 사용 QuickSight API
다음에서는 Amazon 사용을 시작하는 방법을 확인할 수 있습니다. QuickSight API.
**Topics**
+ [API 요청 만들기](qs-api-making-api-requests.md)
+ [Amazon 리소스 이름 (ARN) QuickSight](qs-arns.md)
+ [Amazon 권한 QuickSight 리소스](qs-api-permissions.md)
+ [아마존 QuickSight API 오류](qs-api-errors.md)
# API 요청 만들기
AWS는 아마존에 API를 제공합니다. QuickSight및 Amazon에 액세스할 수 있는 Amazon SDK를 사용할 수 있습니다. QuickSight 기본 프로그래밍 언어 Amazon 사용 QuickSight에서는 Amazon SDK를 사용하여 배포의 몇몇 측면을 관리할 수 있습니다.
Amazon에 걸려온 통화를 모니터링하려면 QuickSight 계정의 API, 다음을 사용할 수 있습니다.AWS CloudTrail. CloudTrail 에서 걸려온 통화를 모니터링할 수 있습니다AWS Management Console, 명령줄 도구 및 기타 서비스가 있습니다. 자세한 내용은 [AWS CloudTrail 사용 설명서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)를 참조하세요.
**Topics**
+ [사전 필수 지식](#qs-api-required-knowledge)
+ [Amazon에서 사용 가능한 API 작업 QuickSight](#qs-api-using-libraries)
## 사전 필수 지식
아마존에 액세스하려는 경우 QuickSight API를 통해 다음에 대한 지식이 있어야 합니다.
+ JSON
+ 웹 서비스
+ HTTP 요청
+ 하나 이상의 프로그래밍 언어 JavaScript, Java, C\$1.
를 방문하는 것이 좋습니다.AWS [리소스 센터 시작하기](https://aws.amazon.com//getting-started/tools-sdks/)Amazon SDK 및 툴킷이 제공하는 기능에 대해 알아봅니다.
터미널과 자주 사용하는 텍스트 편집기를 사용할 수 있지만 IDE (통합 개발 환경) 에서 얻을 수 있는 시각적 UI 환경의 이점을 누릴 수 있습니다. 우리는 IDE 목록을 제공합니다.*AWS리소스 센터 시작하기*의[IDE 및 IDE 툴킷](https://aws.amazon.com//getting-started/tools-sdks/#IDE_and_IDE_Toolkits)섹션. 이 사이트는AWS원하는 IDE용으로 다운로드할 수 있는 툴킷입니다. 또한 일부 IDE에서는 프로그래밍 언어에 대해 더 자세히 배울 수 있는 자습서도 제공합니다.
## Amazon에서 사용 가능한 API 작업 QuickSight
아마존 QuickSight API 작업은 다음을 제공합니다.
+ 사용자 및 그룹 관리
+ 데이터 관리 (데이터 소스, 데이터 세트, 템플릿 및 SPICE 수집)
+ 대시보드 및 분석 관리
+ 템플릿 관리
+ 권한 관리
+ 사용자 지정 관리
AWS에서는 HTTPS를 통해 요청을 제출하는 대신 각 언어별 API 작업을 사용하여 애플리케이션을 빌드하는 것을 선호하는 소프트웨어 개발자를 위해 라이브러리, 샘플 코드, 자습서 및 기타 리소스를 제공합니다. 이러한 라이브러리는 요청에 암호화 서명, 요청 재시도, 오류 응답 처리 등과 같은 작업을 자동으로 관리하는 기본 기능을 제공합니다. 이러한 라이브러리는 쉽게 시작할 수 있는 데 도움이 됩니다.
Amazon SDK 다운로드에 대한 자세한 내용은 단원을 참조하십시오.[Amazon SDK 및 도구](https://aws.amazon.com/tools/). 다음 링크는 사용 가능한 언어별 API 문서의 샘플입니다.
**AWS Command Line Interface**
+ [AWS CLI QuickSight 명령 참조](https://docs.aws.amazon.com//cli/latest/reference/quicksight/index.html)
+ [AWS CLI 사용 설명서](https://docs.aws.amazon.com//cli/latest/userguide/)
+ [AWS CLI 명령 참조](https://docs.aws.amazon.com//cli/latest/reference/)
**AWS SDK for .NET**
+ [아마존. 퀵사이트](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html)
+ [아마존. 퀵사이트 모델](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html)
**AWS SDK for C\$1\$1**
+ [아스:QuickSight::QuickSightClient 클래스 참조](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html)
**AWS SDK for Go**
+ [Quick사이트](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/)
**AWS SDK for Java**
+ [QuickSightClient](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/package-frame.html)
+ [QuickSightModel](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/model/package-frame.html)
**AWS SDK for JavaScript**
+ [QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html)
**AWS SDK for PHP**
+ [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html)
**AWS SDK for Python (Boto3)**
+ [QuickSight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html)
**AWS SDK for Ruby**
+ [아스:QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html)
# Amazon 리소스 이름 (ARN) QuickSight
Amazon 리소스 이름(ARN)은 AWS 리소스를 고유하게 식별합니다. ARN 모든 리소스에서 명확하게 리소스를 식별합니다.AWS예를 들어, IAMPolicy, Amazon Relational Database Service (Amazon RDS) 태그 및 API 호출에 있습니다. Amazon ARN을 검색하려면 QuickSight리소스를 사용할 수 있습니다.`Describe`관련 리소스에 대한 작업을 수행합니다.
이 단원에서는 ARN이 작동하는 방식을 알아봅니다. 여기 자료는 Amazon을 위해 특별히 고안된 예제를 제공합니다. QuickSight.
**Topics**
+ [ARN 형식](qs-arn-format.md)
+ [아마존 QuickSight 리소스 ARN](qs-resource-arns.md)
# ARN 형식
ARN은 콜론으로 구분되며 다음과 같이 구성됩니다.*세그먼트*는 콜론 (:) 으로 구분된 부분입니다.`:`). ARN 세그먼트에 사용되는 특정 구성 요소 및 값은 다음에 따라 달라집니다.AWSARN의 대상 서비스입니다. 다음 예는 ARN이 구성되는 방식을 보여줍니다.
```
arn:partition:service:region:account-id:resource-id
arn:partition:service:region:account-id:resource-type/resource-id
arn:partition:service:region:account-id:resource-type:resource-id
```
이러한 ARN에는 다음 세그먼트가 포함됩니다.
***`partition`***- 리소스가 있는 파티션. 표준의 경우AWS 리전,,,,, 등*aws*. 리소스가 다른 파티션에 있는 경우 파티션은 다음과 같습니다.*aws-파티션 이름*. 예를 들어 중국(베이징) 리전에 있는 리소스의 파티션은 `aws-cn`입니다.
***`service`***- 를 식별하는 서비스 네임스페이스입니다.AWS제품입니다. 예,`quicksight`아마존을 식별합니다. QuickSight,`s3`Amazon S3를 식별합니다.`iam`는 IAM 등을 식별합니다.
***`region`***—AWS 리전리소스가 상주하는 위치입니다. 일부 리소스의 ARN에는AWS 리전따라서 S3의 경우와 같은 경우에 이 구성 요소는 생략될 수 있습니다. 아마존 QuickSight ARN에는 다음이 필요합니다.AWS 리전.
***`account-id`***— 의 ID입니다.AWS 계정리소스를 소유한 ARN 또는 API 작업에서 계정 번호를 사용하는 경우 하이픈을 생략합니다 (예: 123456789012). 일부 리소스의 ARN에는 계정 번호가 필요하지 않으므로 이 구성 요소는 생략될 수 있습니다. 아마존 QuickSight ARN에는 다음이 필요합니다.AWS 계정숫자. 하지만 계정 번호와AWS 리전다음과 같이 S3 버킷 ARN에서 생략됩니다.
```
arn:aws:s3:::bucket_name
arn:aws:s3:::bucket_name/key_name
```
***`resource`*또는*`resource-type`***- 이 ARN 부분의 내용은 서비스별로 다릅니다. 리소스 식별자는 리소스의 이름 또는 ID일 수 있습니다 (예:`user/Bob`또는`instance/i-1234567890abcdef0`) 또는 리소스 경로로 지정할 수 있습니다. 예를 들어, 일부 리소스 식별자에는 상위 리소스 (`sub-resource-type/parent-resource/sub-resource`) 또는 버전과 같은 한정자 (*리소스 유형*:*리소스 이름*:*한정자*).
일부 리소스 ARN에는 경로, 변수 또는 와일드카드가 포함될 수 있습니다.
와일드카드 문자 (`*`과`?`) 는 모든 ARN 세그먼트 내에 포함됩니다. 별표(`*`)는 0개 이상의 문자 조합을 나타내고 물음표(`?`)는 단일 문자를 나타냅니다. \$1 또는 ? 문자를 각 세그먼트에서 여러 번 사용할 수 있지만, 와일드카드 한 개를 여러 세그먼트에 걸쳐서 적용할 수는 없습니다. 권한에 대해 ARN을 사용하는 경우 다음을 사용하지 마십시오.`*`와일드카드를 사용하여 필요한 요소로만 액세스를 제한합니다. 다음은 경로, 와일드카드 및 변수를 사용하는 몇 가지 예제입니다.
다음 예제에서는 S3 ARN을 사용합니다. IAMPolicy에서 S3에 권한을 부여할 때 사용할 수 있습니다. 이 S3 ARN은 경로와 파일이 지정되었음을 보여줍니다.
**참고**
용어*키 이름*다음 경로와 파일처럼 보이는 것을 설명하는 데 사용됩니다.`bucketname/`. 버킷에는 컴퓨터의 파일 시스템에서 사용되는 것과 같은 폴더 구조가 실제로 포함되어 있지 않기 때문에 키 이름이라고 합니다. 대신 슬래시 (`/`) 는 버킷을 보다 직관적으로 구성하는 데 도움이 되는 구분 기호입니다. 이 경우 버킷 이름은`examplebucket`, 및 키 이름입니다.`developers/design_info.doc`.
```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json
```
버킷의 모든 객체를 식별하려는 경우 와일드카드를 사용하여 다음과 같이 모든 키 이름 (또는 경로 및 파일) 이 ARN에 포함되어 있음을 나타낼 수 있습니다.
```
arn:aws:s3:::examplebucket/*
```
키 이름의 일부와 와일드카드를 사용하여 특정 패턴으로 시작하는 모든 객체를 식별할 수 있습니다. 이 경우 다음과 같이 폴더 이름에 와일드카드를 더한 것과 비슷합니다. 하지만 이 ARN에는 의 “하위 폴더”도 포함되어 있습니다.`my-data`.
```
arn:aws:s3:::examplebucket/my-data/*
```
와일드카드를 추가하여 이름의 일부를 지정할 수 있습니다. 이것은 다음으로 시작하는 모든 객체를 식별합니다.`my-data/sales-export*`.
```
arn:aws:s3:::examplebucket/my-data/sales-export*
```
이 경우 이 와일드카드를 사용하여 지정하면 다음과 같은 이름을 가진 객체가 포함됩니다.
+ `my-data/sales-export-1.xlsx`
+ `my-data/sales-export-new.txt`
+ `my-data/sales-export-2019/file1.txt`
다음과 같이 두 가지 유형의 와일드카드 (별표 및 물음표) 를 조합하거나 별도로 사용할 수 있습니다.
```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.*
```
또는 ARN의 미래를 보장하려는 경우 마지막 두 자리 숫자에 와일드카드를 사용하는 대신 전체 연도를 와일드카드로 바꿀 수 있습니다.
```
arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.*
```
S3 ARN에 대한 자세한 내용은 단원을 참조하십시오.[정책에서 리소스 지정](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)과[객체 키와 메타데이터](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)의*Amazon Storage Service 사용 설명서.*
# 아마존 QuickSight 리소스 ARN
Amazon에서 정의하는 리소스 유형은 다음과 같습니다. QuickSight: 사용자, 그룹 및 대시보드 아마존에서 사용됩니다. QuickSight API는 및 를 IAMPermission 문의 요소로 호출합니다. Findup-to-date Amazon 용 정보 QuickSight (서비스 접두사: 퀵사이트) IamPermission 정책에 사용할 수 있는 리소스, 작업 및 조건 컨텍스트 키에 대한 자세한 내용은 단원을 참조하십시오.[Amazon에 사용되는 작업, 리소스 및 조건 키 QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)의*IAM 사용 설명서.*
| 리소스 유형 | ARN 형식 | 조건 키 |
| --- | --- | --- |
| 사용자 | arn \$1 \$1Regcount\$1\$1 Region\$1, \$1 \$1Region\$1 Region\$1 Region \$1 \$1Region\$1ResourceId\$1 | 해당 사항 없음 |
| 그룹 | arn \$1 \$1Regcount\$1\$1 /\$1 \$1Region\$1 Region\$1ResourceId\$1 | 해당 사항 없음 |
| 대시보드 | arn: \$1 \$1Partition\$1 :퀵사이트: \$1 \$1Region\$1 :\$1 \$1Account\$1 :대시보드/\$1 \$1ResourceId\$1 | 해당 사항 없음 |
리소스 ARN은 리소스를 설명하는 세그먼트로 구성됩니다. 예를 들어 분석을 위한 리소스 ARN은 다음 세그먼트로 구성됩니다.
```
arn::quicksight:::/
```
세그먼트는 다음과 같이 정의됩니다.
+ *`partition`*— 예:`aws`또는`aws-cn`.
+ *`aws-region`*—AWS 리전리소스가 포함되어 있습니다.
+ *`aws-account-id`*—AWS 계정리소스가 포함되어 있습니다. 하이픈은 제외됩니다.
+ *`resource-type`*- 리소스의 유형입니다. 이 예제에서`analyses`. 대시보드의 경우 다음과 같습니다.`dashboard`.
+ *`resource-id`*- 특정 리소스에 대한 고유 식별자입니다.
이AWS 리전, 리소스 유형 및 리소스 ID는 Amazon을 사용할 때 리소스의 URL에서 식별됩니다. QuickSight 콘솔. 예를 들어 ARN을 만들려는 분석상의 URL이라고 가정해 보겠습니다.
```
https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```
AWS 리전은 `us-east-2`입니다. 리소스 유형은`analysis`. 이 URL의 리소스 ID는 다음과 같습니다.`4036e682-7de6-4c05-8a76-be51b9ec9b29`. 계정 번호가`111122223333`이 분석을 위한 ARN은 다음과 같습니다.
```
arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```
를 얻으려면AWS 계정번호를 얻으려면 시스템 관리자에게 문의하십시오.
# Amazon 권한 QuickSight 리소스
필요한 권한이 무엇인지 잘 모르는 경우에도 호출을 시도할 수 있습니다. 그러면 클라이언트는 누락된 권한이 무엇인지 알려줍니다. 별표 () 를 사용할 수 있습니다.`*`) 를 명시적 리소스를 지정하는 대신 권한 정책의 Resource 필드에 입력합니다. 그러나 각 권한을 최대한 제한하는 것이 좋습니다. Amazon을 사용하여 정책상의 리소스를 지정하거나 제외하여 사용자 액세스를 제한할 수 있습니다. QuickSight ARN. Amazon ARN을 검색하려면 QuickSight 리소스 사용`Describe`관련 리소스에 대한 작업을 수행합니다.
Amazon에 전화하기 전에 QuickSight API 작업이 필요합니다.`quicksight:operation-name`IAMIdentity에 연결된 정책의 권한입니다. 예를 들어 `list-users`를 호출하려면 `quicksight:ListUsers` 권한이 필요합니다. 모든 작업에 같은 패턴이 적용됩니다. 호출을 시도할 수 있는 권한이 없는 경우, 결과 오류는 누락된 권한이 무엇인지 보여줍니다. 각 권한을 최대한 제한하는 것이 좋습니다.
상황에 따라 IAM에 조건을 추가하여 API에 대한 액세스를 추가로 제한할 수 있습니다. 예를 들어 다음을 추가할 때`User1`에`Group1`, 주 리소스는`Group1`. 특정 그룹에 대한 액세스를 허용하거나 거부할 수 있습니다. 또는 Amazon을 편집할 수도 있습니다. QuickSight 아이엠 키`quicksight:UserName`특정 사용자가 해당 그룹에 추가되는 것을 허용하거나 금지하는 조건을 추가합니다.
자세한 정보는 다음 자료를 참조하세요.
+ [작업, 리소스 및 조건 키](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_amazonquicksight.html)
+ [IAMJSON 정책 요소](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html)
가장 많이 보려면 up-to-date 아마존 목록 QuickSight 작업, 참조[아마존에서 정의한 작업 QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html#amazonquicksight-actions-as-permissions)의*IAM 사용 설명서*.
## 모범 사례
아마존 QuickSight 에서는 분석, 대시보드, 템플릿 및 테마를 최대 100명의 주도자와 공유할 수 있습니다. A*주요한*의 값은 다음 중 하나일 수 있습니다.
+ 아마존의 Amazon 리소스 이름 (ARN) QuickSight 데이터 소스 또는 데이터세트와 연결된 사용자 또는 그룹입니다. (일반적이지 않음)
+ Amazon ARN입니다. QuickSight 분석, 대시보드, 템플릿 또는 테마와 연결된 사용자, 그룹 또는 네임스페이스 (일반적이지 않음)
+ 의 ARN입니다.AWS계정 루트: 이는 QuickSight ARN. 리소스 (템플릿) 를 공유하는 경우에만 이 옵션을 사용합니다.AWS계정. (일반적이지 않음)
이러한 리소스를 더 많은 보안 주체와 공유하려면 그룹 또는 네임스페이스 수준에서 리소스 권한을 할당하는 것이 좋습니다. 예를 들어 그룹에 사용자를 추가하고 그룹에 리소스를 공유하는 경우 그룹의 모든 사람과 공유되더라도 그룹은 한 명의 주도자로 계산됩니다.
# 아마존 QuickSight API 오류
아마존 QuickSight 에는 두 가지 유형의 오류 코드가 있습니다.
+ **클라이언트 오류**— 이러한 오류는 일반적으로 클라이언트가 수행한 작업으로 인해 발생합니다. 요청에 올바르지 않거나 잘못된 파라미터를 지정하거나 작업 또는 리소스를 사용할 권한이 없는 사용자를 위해 작업 또는 리소스를 사용하는 경우를 예로 들 수 있습니다. 이러한 오류에는 400 시리즈 HTTP 응답 코드가 수반됩니다.
+ **서버 오류**- 이러한 오류는 일반적으로AWS서버 측 문제. 이러한 오류에는 500 시리즈 HTTP 응답 코드가 수반됩니다.
**Topics**
+ [일반적인 클라이언트 오류](#qs-api-errors-client)
+ [클라이언트 오류](#qs-api-errors-table-client)
+ [서버 오류](#qs-api-errors-table-server)
## 일반적인 클라이언트 오류
다음은 모든 작업에서 반환할 수 있는 일반적인 클라이언트 오류 목록을 확인할 수 있습니다.
| 오류 코드 | 설명 |
| --- | --- |
| AuthFailure | 제공된 자격 증명을 유효하지 않을 수 있습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 신용 카드 세부 정보가 정확하고 올바른 액세스 키를 사용하고 있는지 확인합니다. |
| Blocked | 계정이 현재 차단되었습니다. 궁금한 점이 있으면 aws-verification@amazon.com 으로 문의하십시오. |
| DryRunOperation | 사용자에게 필요한 권한이 있으므로 요청이 성공했겠지만DryRun파라미터가 사용되었습니다. |
| IdempotentParameterMismatch | 요청은 이전의 요청과 동일한 클라이언트 토큰을 사용하지만 동일하지는 않습니다. 요청이 동일하지 않는 한 다른 요청과 함께 클라이언트 토큰을 재사용하지 마십시오. |
| IncompleteSignature | 요청 서명이 에 부합하지 않습니다.AWS표준. |
| InvalidAction | 요청된 동작 또는 작업이 유효하지 않습니다. 작업을 올바로 입력했는지 확인합니다. |
| InvalidCharacter | 지정된 문자가 유효하지 않습니다. |
| InvalidClientTokenId | X.509 인증서AWS제공된 액세스 키 ID가 AWS의 레코드에 존재하지 않습니다. |
| InvalidPaginationToken | 지정된 페이지 매김 토큰이 유효하지 않거나 만료되었습니다. |
| InvalidParameter | 요청에 지정된 파라미터가 유효하지 않거나 지원되지 않거나 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다. |
| InvalidParameterCombination | 잘못된 매개 변수 조합 또는 매개 변수가 누락되었음을 나타냅니다. |
| InvalidParameterValue | 매개 변수에 지정된 값이 유효하지 않거나 지원되지 않거나 사용할 수 없습니다. 전체 ID를 사용하여 리소스를 지정해야 합니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다. |
| InvalidQueryParameter | 이AWS쿼리 문자열이 잘못된 양식이거나 준수하지 않습니다.AWS표준. |
| MalformedQueryString | 쿼리 문자열에 구문 오류가 있습니다. |
| MissingAction | 요청에서 작업 또는 필요한 파라미터가 누락되었습니다. |
| MissingAuthenticationToken | 요청은 유효한(등록된) AWS 액세스 키 ID 또는 X.509 인증서를 포함해야 합니다. |
| MissingParameter | 요청에서 필요한 파라미터가 누락되었습니다. 요청에 필요한 모든 매개 변수 (예: 리소스 ID) 를 제공했는지 확인합니다. |
| OptInRequired | 요청된 서비스를 사용할 수 있는 권한이 없습니다. 사용하려는 서비스에 가입했는지 확인합니다. 처음 사용하는 경우AWS, 신용 카드 세부 정보가 확인되는 동안 계정을 활성화하는 데 다소 시간이 걸릴 수 있습니다. |
| PendingVerification | 계정이 확인 보류 중입니다. 확인 프로세스가 완료될 때까지 이 계정으로 요청을 수행하지 못할 수도 있습니다. 궁금한 점은 [AWS Support](https://console.aws.amazon.com/support/home#/)에 문의하십시오. |
| RequestExpired | 요청상의 날짜 스탬프로부터 15분 이상 또는 요청 만료 날짜 (예: 미리 서명된 URL용) 로부터 15분 이상, 요청 상의 날짜 스탬프로부터 15분 이상 남아 있습니다. 또는 요청의 날짜 스탬프가 future 15분 이상일 수도 있습니다. 임시 보안 자격 증명을 사용하는 경우 자격 증명이 만료된 경우에도 이 오류가 발생할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 [임시 보안 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)을 참조하세요. |
| UnauthorizedOperation | 이 작업을 수행할 수 있는 권한이 없습니다. IAM 정책을 확인하고 올바른 액세스 키를 사용하고 있는지 확인합니다. |
| UnknownParameter | 알 수 없거나 인식할 수 없는 매개변수가 제공되었습니다. 이 오류를 일으킬 수 있는 요청에는 철자가 틀린 매개 변수 또는 지정된 API 버전에서 지원되지 않는 매개 변수 제공이 포함됩니다. |
| UnsupportedInstanceAttribute | 지정된 속성은 수정할 수 없습니다. |
| UnsupportedOperation | 지정된 요청에 지원되지 않는 작업이 포함되어 있습니다. 반환된 메시지는 지원되지 않는 작업의 세부 정보를 제공합니다. |
| UnsupportedProtocol | 사용한 프로토콜은 지원되지 않습니다. |
| ValidationError | 입력이 에 지정된 제약에 충족되지 않습니다.AWS서비스. |
## 클라이언트 오류
아래에서 Amazon과 관련된 클라이언트 오류 목록입니다. QuickSight API 작업.
| 오류 코드 | 설명 |
| --- | --- |
| AccessDeniedException | 이에 대한 액세스 권한이 없습니다. 제공된 자격 증명을 유효하지 않을 수 있습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 정책에 올바른 권한이 있고 올바른 액세스 키를 사용하고 있는지 확인합니다. |
| DomainNotWhiteListedException | 지정된 도메인이 허용 목록에 없습니다. 내장된 대시보드의 모든 도메인은 Amazon에서 승인된 목록에 추가해야 합니다. QuickSight admin. |
| IdentityTypeNotSupportedException | 지정된 ID 유형은 지원되지 않습니다. 지원되는 ID 유형은 다음과 같습니다. 저는 퀵사이트입니다. |
| InvalidNextTokenException | 이NextToken값이 유효하지 않습니다. |
| InvalidParameterValueException | 하나 이상의 매개변수에 유효한 값이 없습니다. |
| PreconditionNotMetException | 하나 이상의 사전 조건이 충족되지 않았습니다. |
| QuickSightUserNotFoundException | 사용자를 찾을 수 없습니다. 이 문제는 다음과 같이 제공된 사용자 이름을 기반으로 사용자를 찾아야 하는 모든 작업에서 발생할 수 있습니다. DeleteUser,DescribeUser,,,,, 등. |
| ResourceExistsException | 지정된 리소스가 존재하지 않습니다. |
| ResourceNotFoundException | 하나 이상의 리소스를 찾을 수 없습니다. |
| SessionLifetimeInMinutesInvalidException | 세션 수명 동안 지정된 시간 (분) 이 잘못되었습니다. 세션 수명은 15분에서 600분 사이여야 합니다. |
| ThrottlingException | 액세스가 제한되었습니다. |
| UnsupportedUserEditionException | 아마존에서 오퍼레이션을 호출하고 있음을 나타냅니다. QuickSight구독: 에디션에는 해당 작업에 대한 지원이 포함되어 있지 않습니다. 아마존 QuickSight 현재 스탠다드 에디션과 엔터프라이즈 에디션이 있습니다. 모든 에디션에서 모든 작동 및 기능을 사용할 수 있는 것은 아닙니다. |
### 클라이언트 오류의 일반적인 원인
요청을 수행하는 동안 오류가 발생하는 데에는 여러 가지 이유가 있습니다. 다음 지침에 따라 일부 오류를 방지하거나 쉽게 해결할 수 있습니다.
+ **를 지정합니다.AWS 계정ID 및 네임스페이스**— 관련AWS 계정각 요청과 함께 ID를 제공해야 합니다. 네임스페이스가 로 설정해야 합니다.`default`.
+ **최종 일관성 허용**— 이전 요청이 아직 시스템 전체에 전파되지 않았기 때문에 일부 오류가 발생합니다.
+ **요청 비율 사이의 절전 간격 사용**— Amazon QuickSight API 요청은 서비스 성능을 유지하는 데 도움이 되도록 조절됩니다. 요청이 병목 현상이 발생한 경우 오류가 발생합니다.
+ **리소스의 전체 ID 사용**— 리소스를 지정할 때 사용자가 제공한 이름이나 설명이 아닌 전체 ID를 사용해야 합니다.
+ **서비스 확인**— 사용하려는 모든 서비스에 가입했는지 확인합니다. 다음 페이지로 이동하여 가입한 서비스를 확인할 수 있습니다.**내 계정**의 단원[AWS홈 페이지](https://aws.amazon.com/).
+ **권한 확인**— 요청을 수행하는 데 필요한 권한이 있는지 확인합니다.
+ **VPC 확인**— 보안 그룹과 같은 일부 리소스는 가상 사설 클라우드 (VPC) 간에 공유할 수 없습니다.
+ **자격 증명 확인**— 요청을 할 때 액세스 키를 제공하고 자격 증명을 올바르게 입력했는지 확인합니다. 또한 계정이 두 개 이상인 경우에도 특정 계정에 올바른 자격 증명을 사용하고 있는지 확인합니다. 제공된 자격 증명이 올바르지 않은 경우 다음 오류가 발생할 수 있습니다.`Client.AuthFailure`.
## 서버 오류
다음은 서버에서 반환할 수 있는 오류 목록입니다.
| 오류 코드 | 설명 |
| --- | --- |
| BatchClientRequestTokensNotDistinctException – | 배치 클라이언트 요청 토큰은 고유하지 않습니다. |
| EmptyBatchRequestException | 배치 요청이 비어 있습니다. |
| InternalFailureException | 내부 실패가 발생했습니다. |
| InternalServiceError | 서비스에서 내부 오류가 발생했습니다. |
| InvalidBatchClientRequestTokenException | 이AWS이 클라이언트 배치 요청에 대한 요청 토큰이 잘못되었습니다. |
| InvalidParameterException | 하나 이상의 파라미터에 잘못된 값이 있습니다. |
| LimitExceededException | 한도를 초과했습니다. |
| ResourceUnavailableException | 이 리소스는 현재 사용할 수 없습니다. |
| TooManyEntriesInBatchRequestException | 이 일괄 요청에 항목이 너무 많습니다. |