翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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[「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 の 3 つのスターターテーマをご用意しています。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`