使用 設定 Amazon QuickSight 分析的預設主題 QuickSight APIs

使用 設定預設主題 API

1. 確定要用作預設值的自訂佈景主題，並找到其佈景主題 ID。如果您想要使用其中一個 QuickSight 入門主題，請略過此步驟。

   若要取得自訂主題的主題 ID，請使用主題所在區域的 ListThemesAPI操作。確保佈景主題與需要使用該佈景主題的使用者或群組位於同一區域。

   下列範例顯示使用 AWS CLI中之 list-themes 命令的 Shell 指令碼。它將 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或 ListGroupsAPI操作，為需要使用主題作為預設的使用者或群組收集 Amazon Resource Names （ARNs）。您只需要頂層 ARN。如果所有使用者都屬於同一個群組，請使用群組 ARN。

   如需 的詳細資訊 QuickSight ARNs，請參閱 Amazon 參考中的ARN格式。 QuickSight API

3. 如果您使用的是自訂主題，請為您在上一個步驟中收集ARNs的 授予該主題的存取權。如果使用的是入門佈景主題，請略過此步驟，因為所有使用者都可以存取入門佈景主題。

   下列範例顯示使用 update-theme-permissions命令的 Shell 指令碼。 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或 的預設值ARNs。

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