CreateAccountCustomization - Amazon QuickSight
요청 구문URI 요청 파라미터요청 본문응답 구문응답 요소오류참고 항목

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

CreateAccountCustomization

아마존 생성 QuickSight 현재에 대한 사용자 지정AWS 리전. 현재 다음을 사용하여 사용자 지정 기본 테마를 추가할 수 있습니다.CreateAccountCustomization또는UpdateAccountCustomizationAPI 작업. 아마존을 추가로 사용자 지정하려면 QuickSight 아마존을 제거하여 QuickSight모든 신규 사용자를 위한 샘플 자산 및 비디오, 참조아마존 커스터마이징 QuickSight의아마존 QuickSight 사용 설명서.

다음에 대한 사용자 지정을 만들 수 있습니다.AWS계정 또는 네임스페이스를 지정하는 경우 QuickSight 네임스페이스입니다. 네임스페이스에 적용되는 사용자 지정은 항상AWS계정. 적용되는 사용자 지정을 확인하려면DescribeAccountCustomizationAPI 작업.

사용하기 전에CreateAccountCustomization네임스페이스 기본값으로 테마를 추가하는 API 작업입니다. 먼저 테마를 네임스페이스와 공유해야 합니다. 네임스페이스와 공유하지 않는 경우 테마를 기본 테마로 설정하더라도 해당 테마는 사용자에게 표시되지 않습니다. 테마가 공유되어 있는지 확인하려면 다음을 사용하여 현재 권한을 확인합니다. DescribeThemePermissions API 작업. 테마를 공유하려면 다음을 사용하여 권한을 부여합니다. UpdateThemePermissions API 작업.

요청 구문

POST /accounts/AwsAccountId/customizations?namespace=Namespace HTTP/1.1
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI 요청 파라미터

요청은 다음의 URI 파라미터를 사용합니다.

AwsAccountId

ID입니다.AWSAmazon을 사용자 지정할 계정입니다. QuickSight 에 대한.

길이 제약 조건: 고정 길이는 12입니다.

패턴: ^[0-9]{12}$

필수 사항: 예

Namespace

Amazon QuickSight 사용자 지정을 추가할 네임스페이스입니다.

길이 제약 조건: 최대 길이 64.

Pattern: ^[a-zA-Z0-9._-]*$

요청 본문

요청은 JSON 형식의 다음 데이터를 받습니다.

AccountCustomization

Amazon QuickSight 현재 항목에 추가 중인 사용자 지정AWS 리전. 다음을 수행할 수 있습니다.AWS계정 및 a QuickSight 네임스페이스.

예를 들어 다음을 수행하면 기본 테마를 추가할 수 있습니다.AccountCustomization미드나잇 테마로 "AccountCustomization": { "DefaultTheme": "arn:aws:quicksight::aws:theme/MIDNIGHT" }. 또는 다음을 지정하여 사용자 지정 테마를 추가할 수 있습니다."AccountCustomization": { "DefaultTheme": "arn:aws:quicksight:us-west-2:111122223333:theme/bdb844d0-0fe9-4d9d-b520-0fe602d93639" }.

유형: AccountCustomization 객체

필수 사항: 예

Tags

리소스에 연결할 태그의 목록입니다.

Type: 배열Tag사물

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다.

필수 사항: 아니요

응답 구문

HTTP/1.1 Status
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Arn": "string",
   "AwsAccountId": "string",
   "Namespace": "string",
   "RequestId": "string"
}

응답 요소

작업이 성공하면 서비스가 다음 HTTP 응답을 다시 전송합니다.

Status

요청의 HTTP 상태입니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

AccountCustomization

Amazon QuickSight 현재 항목에 추가 중인 사용자 지정AWS 리전.

유형: AccountCustomization 객체

Arn

이를 위해 생성한 사용자 지정에 대한 Amazon 리소스 이름입니다.AWS계정.

Type: 문자열

AwsAccountId

ID입니다.AWSAmazon을 사용자 지정할 계정입니다. QuickSight 에 대한.

Type: 문자열

길이 제약 조건: 고정 길이는 12입니다.

패턴: ^[0-9]{12}$

Namespace

생성 중인 사용자 지정에 연결된 네임스페이스입니다.

Type: 문자열

길이 제약 조건: 최대 길이 64.

패턴: ^[a-zA-Z0-9._-]*$

RequestId

이AWS작업에 대한 요청 ID입니다.

Type: 문자열

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

AccessDeniedException

이 항목에 액세스할 수 없습니다. 제공된 자격 증명의 유효성을 검사할 수 없습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 정책에 올바른 권한이 있고 올바른 액세스 키를 사용하고 있는지 확인합니다.

HTTP 상태 코드: 401

ConflictException

리소스를 업데이트하거나 삭제하면 일관성 없는 상태가 발생할 수 있습니다.

HTTP 상태 코드: 409

InternalFailureException

내부 실패가 발생했습니다.

HTTP 상태 코드: 500

InvalidParameterValueException

하나 이상의 매개변수에 유효하지 않은 값이 있습니다.

HTTP 상태 코드: 400

ResourceExistsException

지정한 리소스가 이미 존재합니다.

HTTP 상태 코드: 409

ResourceNotFoundException

하나 이상의 리소스를 찾을 수 없습니다.

HTTP 상태 코드: 404

ResourceUnavailableException

이 리소스를 현재 사용할 수 없습니다.

HTTP 상태 코드: 503

ThrottlingException

액세스가 제한되었습니다.

HTTP 상태 코드: 429

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.