CreateAccountCustomization - Amazon QuickSight
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CreateAccountCustomization

创建亚马逊 QuickSight 当前的自定义AWS 区域. 目前，您可以使用CreateAccountCustomization要么UpdateAccountCustomizationAPI 操作。进一步定制亚马逊 QuickSight 通过移除亚马逊 QuickSight面向所有新用户的样本资产和视频，请参阅定制亚马逊 QuickSight中的亚马逊 QuickSight 用户指南。

您可以为自己的AWS帐户，或者，如果您指定命名空间，则为 QuickSight 相反，命名空间。应用于命名空间的自定义项始终覆盖应用于命名空间的自定义项AWSaccount. 要了解哪些自定义项适用，请使用DescribeAccountCustomizationAPI 操作。

使用CreateAccountCustomizationAPI 操作添加主题作为命名空间默认值，请确保先与命名空间共享主题。如果您不将其与命名空间共享，则即使您将其设为默认主题，用户也看不到该主题。要检查主题是否已共享，请使用 DescribeThemePermissions API 操作。要共享模版，请使用 UpdateThemePermissions API 操作。

请求语法

POST /accounts/AwsAccountId/customizations?namespace=Namespace HTTP/1.1
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI 请求参数

请求使用以下 URI 参数。

AwsAccountId

的IDAWS您要自定义Amazon QuickSight 对于。

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

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

必需：是

Namespace

Amazon QuickSight 要添加自定义项的命名空间。

长度约束：最大长度为 64。

模式：^[a-zA-Z0-9._-]*$

请求正文

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

AccountCustomization

Amazon QuickSight 你在当前版本中添加的自定义项AWS 区域. 您可以将这些添加到AWS账户和一个 QuickSight 命名空间。

例如，您可以通过以下方式添加默认主题：AccountCustomization到午夜的主题："AccountCustomization": { "DefaultTheme": "arn:aws:quicksight::aws:theme/MIDNIGHT" }. 或者，您可以通过指定"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight:us-west-2:111122223333:theme/bdb844d0-0fe9-4d9d-b520-0fe602d93639" }.

类型：AccountCustomization 对象

必需：是

Tags

您要附加到此资源的标签的列表。

类型: 数组的数组Tag对象

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

必需：否

响应语法

HTTP/1.1 Status
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Arn": "string",
   "AwsAccountId": "string",
   "Namespace": "string",
   "RequestId": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 响应。

Status

请求的 HTTP 状态。

服务以 JSON 格式返回的以下数据。

AccountCustomization

Amazon QuickSight 你在当前版本中添加的自定义项AWS 区域.

类型：AccountCustomization 对象

Arn

您为此创建的Amazon 资源名称 (ARN)AWSaccount.

类型: 字符串

AwsAccountId

的IDAWS您要自定义Amazon QuickSight 对于。

类型: 字符串

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

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

Namespace

与您要创建的命名空间。

类型: 字符串

长度约束：最大长度为 64。

模式：^[a-zA-Z0-9._-]*$

RequestId

这些区域有：AWS用于此操作的请求 ID。

类型: 字符串

错误

有关所有操作常见错误的信息，请参阅常见错误.

AccessDeniedException

您无权访问此项目。无法验证提供的凭证。您可能无权执行请求。确保您的账户已获得使用亚马逊的授权 QuickSight 服务，您的策略具有正确的权限，您使用的是正确的访问密钥。

HTTP 状态代码：401

ConflictException

更新或删除资源可能会导致状态不一致。

HTTP 状态代码：409

InternalFailureException

出现内部故障。

HTTP 状态代码：500

InvalidParameterValueException

一个或多个参数的值无效。

HTTP 状态代码：400

ResourceExistsException

已存在指定的资源。

HTTP 状态代码：409

ResourceNotFoundException

无法找到一个或多个资源。

HTTP 状态代码：404

ResourceUnavailableException

此资源当前不可用。

HTTP 状态代码：503

ThrottlingException

访问受限。

HTTP 状态代码：429

另请参阅

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