CreateTheme - Amazon QuickSight
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CreateTheme

建立佈景主題。

佈景主題是顏色和配置的組態選項集。佈景主題適用於分析和儀表板。如需詳細資訊，請參閱「」在 Amazon 中使用佈景主題 QuickSight中的亞馬遜 QuickSight 使用者指南。

請求語法

POST /accounts/AwsAccountId/themes/ThemeId HTTP/1.1
Content-type: application/json

{
   "BaseThemeId": "string",
   "Configuration": { 
      "DataColorPalette": { 
         "Colors": [ "string" ],
         "EmptyFillColor": "string",
         "MinMaxGradient": [ "string" ]
      },
      "Sheet": { 
         "Tile": { 
            "Border": { 
               "Show": boolean
            }
         },
         "TileLayout": { 
            "Gutter": { 
               "Show": boolean
            },
            "Margin": { 
               "Show": boolean
            }
         }
      },
      "UIColorPalette": { 
         "Accent": "string",
         "AccentForeground": "string",
         "Danger": "string",
         "DangerForeground": "string",
         "Dimension": "string",
         "DimensionForeground": "string",
         "Measure": "string",
         "MeasureForeground": "string",
         "PrimaryBackground": "string",
         "PrimaryForeground": "string",
         "SecondaryBackground": "string",
         "SecondaryForeground": "string",
         "Success": "string",
         "SuccessForeground": "string",
         "Warning": "string",
         "WarningForeground": "string"
      }
   },
   "Name": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VersionDescription": "string"
}

URI 請求參數

請求會使用下列 URI 參數。

AwsAccountId

的 IDAWS帳戶，您希望在其中存放新佈景主題。

長度限制：固定長度 12。

模式：^[0-9]{12}$

必要 是

ThemeId

您要建立之佈景主題的 ID。主題 ID 是每個唯一AWS 區域在每AWS帳戶。

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+

必要 是

請求主體

請求接受採用 JSON 格式的下列資料。

BaseThemeId

自訂佈景主題將繼承的佈景主題 ID。所有主題都從亞馬遜定義的起始主題之一繼承 QuickSight。如需起始佈景主題的清單，請使用ListThemes或選擇Themes (主題)從分析中。

類型：字串

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+

必要 是

Configuration

佈景主題組態，其中包含佈景主題顯示屬性。

類型：ThemeConfiguration 物件

必要 是

Name

主題的顯示名稱。

類型：字串

長度限制：長度下限為 1。長度上限為 2048。

必要 是

Permissions

要套用至新佈景主題的有效資源權限群組。

類型：的陣列ResourcePermission對象

陣列成員：項目數下限為 1。項目數上限為 64。

必要 否

Tags

您要新增至資源之一或多個標籤的鍵值對映。

類型：的陣列Tag對象

陣列成員：項目數下限為 1。項目數上限為 200。

必要 否

VersionDescription

您正在建立之佈景主題的第一個版本的說明。每次UpdateTheme被呼叫，建立新的版本。主題的每個版本都有該版本的描述VersionDescription欄位。

類型：字串

長度限制：長度下限為 1。長度上限為 512。

必要 否

回應語法

HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string",
   "ThemeId": "string",
   "VersionArn": "string"
}

回應元素

如果動作成功，則服務傳回下列 HTTP 回應。

Status

請求的 HTTP 狀態。

服務會傳回下列 JSON 格式的資料。

Arn

在 Amazon Resource Name (ARN) 的佈景主題。

類型：字串

CreationStatus

佈景主題建立狀態。

類型：字串

有效值： CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED

RequestId

所以此AWS此操作的請求 ID。

類型：字串

ThemeId

佈景主題的 ID。

類型：字串

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+

VersionArn

Amazon Resource Name (ARN) 的新佈景主題。

類型：字串

錯誤

如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。

AccessDeniedException

您無法存取此項目。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶已獲授權使用亞馬遜 QuickSight 服務，您的政策有正確許可，以及您使用正確的存取金鑰。

HTTP 狀態碼：401

InternalFailureException

發生內部故障。

HTTP 狀態碼：500

InvalidParameterValueException

一或多個參數具有無效的值。

HTTP 狀態碼：400

LimitExceededException

已超過上限。

HTTP 狀態碼：409

ResourceExistsException

指定的資源已存在。

HTTP 狀態碼：409

ResourceNotFoundException

無法找到一個或多個資源。

HTTP 狀態碼：404

ThrottlingException

存取已調節。

HTTP 狀態碼：429

UnsupportedUserEditionException

此錯誤表示您正在呼叫 Amazon 上的操作 QuickSight訂閱版本不包括對該操作的支持。Amazon QuickSight 目前包含 Standard Edition (標準版) 不是每個版本都會提供所有操作和功能。

HTTP 狀態碼：403

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：