QuickSight API로 Amazon QuickSight 분석을 위한 기본 테마 설정

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

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

   사용자 지정 테마의 테마 ID를 가져오려면 해당 테마가 있는 리전의 ListThemes 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'

2. ListUsers 또는 ListGroups API 작업을 사용하여 테마를 기본으로 사용해야 하는 사용자 또는 그룹의 Amazon 리소스 이름(ARN)을 수집할 수 있습니다. 최고 수준 ARN만 필요합니다. 모든 사용자가 같은 그룹에 속해 있는 경우 그룹 ARN을 사용하십시오.

   QuickSight ARN에 대한 자세한 내용은 Amazon QuickSight API 참조의 ARN 형식을 참조하십시오.

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

   다음 예제는 update-theme-permissions 명령을 사용하는 셸 스크립트를 보여줍니다. grant-permissions 파리미터는 속기 구문을 사용하여 표시됩니다. 대신 JSON 또는 YAML을 사용할 수 있습니다. 자세한 내용은 AWS Command Line Interface 사용 설명서에서 파라미터 값 지정을 참조하십시오.

   #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" 

4. 테마를 동일한 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"