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

# Amazon Quick APIs를 사용한 Amazon Quick 분석의 기본 테마 설정
<a name="customizing-quicksight-default-theme"></a>

**API를 사용하여 기본 테마를 설정하기**

1. 기본값으로 사용할 사용자 지정 테마를 식별하고 해당 테마 ID를 찾습니다. QuickSight 스타터 테마 중 하나를 사용하려면 이 단계를 건너뛸 수 있습니다.

   사용자 지정 테마의 테마 ID를 가져오려면 해당 테마가 있는 리전의 [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html) API 작업을 사용하십시오. 테마를 사용해야 하는 사용자 또는 그룹이 있는 동일한 리전에 있는지 확인하세요.

   다음 예제는 AWS CLI에서 `list-themes` 명령을 사용하는 셸 스크립트를 보여줍니다. AWS 계정 ID와를 변수 AWS 리전 로 설정합니다. 이전에 기본 리전을 설정하는 데 `aws configure`을(를) 사용한 경우, 명령에 `--region` 변수를 추가하면 기본 설정보다 우선 적용됩니다.

   ```
   #declare variables
   awsacct1='111122223333'
   region='us-west-2'
   
   aws quicksight list-themes \
   --region {{$region}} \
   --aws-account-id {{$awsacct1}} \
   --type 'CUSTOM'
   ```

   

1. [ListUsers](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListUsers.html) 또는 [ListGroups](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListGroups.html) API 작업을 사용하여 테마를 기본으로 사용해야 하는 사용자 또는 그룹의 Amazon 리소스 이름(ARN)을 수집할 수 있습니다. 최고 수준 ARN만 필요합니다. 모든 사용자가 같은 그룹에 속해 있는 경우 그룹 ARN을 사용하십시오.

   Amazon Quick ARNs에 대한 자세한 내용은 Quick API 참조의 [ARN 형식을](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html) 참조하세요. ** 

1. 사용자 지정 테마를 사용하는 경우 이전 단계에서 수집한 ARN의 테마에 대한 액세스 권한을 부여하십시오. 스타터 테마를 사용하는 경우 모든 사용자가 스타터 테마에 액세스할 수 있으므로 이 단계를 건너뛰세요.

   다음 예제는 [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html) 명령을 사용하는 셸 스크립트를 보여줍니다. `grant-permissions` 파리미터는 속기 구문을 사용하여 표시됩니다. 대신 JSON 또는 YAML을 사용할 수 있습니다. 자세한 내용은AWS Command Line Interface 사용 설명서에서 [파라미터 값 지정](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html)을 참조하십시오.

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639' #Find this with list-themes
   
   aws quicksight update-theme-permissions \
   #Specify region if necessary: --region {{$region}} \
   --aws-account-id {{$awsacct1}} \
   --theme-id {{$theme-id}} \
   --grant-permissions Principal="arn:aws:quicksight:{{$region}}:{{$awsacct1}}:group/{{$namespace}}/{{QuickSight_Group_Name}}",Actions="quicksight:DescribeTheme","quicksight:ListThemeVersions","quicksight:ListThemeAliases","quicksight:DescribeThemeAlias"
   ```

1. 테마를 동일한 ARN 또는 ARN의 기본값으로 지정합니다.

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639'
   
   aws quicksight create-account-customization \
   #Specify region if necessary: --region {{$region}} \
   --aws-account-id {{$awsacct1}} \
   --namespace {{$namespace}} \
   --account-customization DefaultTheme="arn:aws:quicksight:{{$region}}:{{$awsacct1}}:theme/{{$theme-id}}"
   ```

현재 스타터 테마는 Classic, Midnight 및 Seaside의 세 가지입니다. ARN은 테마 이름의 대문자 철자입니다. 사용자 지정 테마 대신 스타터 테마를 사용하는 경우 다음 테마 ARN 중 하나를 사용하십시오.
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`