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

您要在其中存储新主题的 AWS 账户的 ID。

长度约束：固定长度为 12。

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

必需: 是

ThemeId

您希望创建的主题的 ID。每个 AWS 账户中每个 AWS 区域 的主题 ID 都是唯一的。

长度约束：最小长度为 1。长度上限为 2048。

模式：[\w\-]+

必需: 是

请求正文

请求接受采用 JSON 格式的以下数据。

BaseThemeId

自定义主题将从中继承的主题的 ID。所有主题都继承自亚马逊定义的其中一个起始主题 QuickSight. 有关起始主题的列表，请使用 ListThemes 或从分析中选择 Themes（主题）。

类型: 字符串

长度约束：最小长度为 1。长度上限为 2048。

模式：[\w\-]+

必需: 是

Configuration

主题配置，包含主题显示属性。

类型：ThemeConfiguration 对象

必需: 是

Name

主题的显示名称。

类型: 字符串

长度约束：最小长度为 1。长度上限为 2048。

必需: 是

Permissions

应用于新主题的有效资源权限分组。

类型: 数组的ResourcePermission对象

数组成员：最少 1 项。最多 6项。

必需: 否

Tags

要添加到资源的一个或多个资源标签的键值对映射。

类型: 数组的Tag对象

数组成员：最少 1 项。最多 20项。

必需: 否

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 资源名称 (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 资源名称 (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 当前具有标准版和企业版。每个版本中并未提供所有操作和功能。

HTTP 状态代码：403

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：