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

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

UpdateDashboard

更新控制面板AWSaccount.

注意

更新仪表板会创建新的仪表板版本，但不会立即发布新版本。您可以通过以下方式更新控制面板的已发布版本 UpdateDashboardPublishedVersion API 操作。

请求语法

PUT /accounts/AwsAccountId/dashboards/DashboardId HTTP/1.1
Content-type: application/json

{
   "DashboardPublishOptions": { 
      "AdHocFilteringOption": { 
         "AvailabilityStatus": "string"
      },
      "ExportToCSVOption": { 
         "AvailabilityStatus": "string"
      },
      "SheetControlsOption": { 
         "VisibilityState": "string"
      }
   },
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "ThemeArn": "string",
   "VersionDescription": "string"
}

URI 请求参数

请求使用以下 URI 参数。

AwsAccountId

的 IDAWS包含您要更新的仪表板的帐户。

长度限制：固定长度为 12。

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

必需：是

DashboardId

控制面板 ID。

长度限制：最小长度为 1。长度上限为 2048。

模式：[\w\-]+

必需：是

请求正文

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

Name

控制面板的显示名称。

类型: 字符串

长度限制：最小长度为 1。长度上限为 2048。

必需：是

SourceEntity

更新仪表板时用作源的实体。InSourceEntity，则指定要用作源的对象的类型。您只能从模板更新仪表板，因此您可以使用SourceTemplate实体。如果需要从分析更新仪表板，请先使用 CreateTemplate API 操作。对于 SourceTemplate，指定源模板的 Amazon 资源名称（ARN）。这些区域有：SourceTemplateARN 可以包含任何AWS账户和任何亚马逊 QuickSight-支持AWS 区域.

使用 SourceTemplate 中的 DataSetReferences 实体列出原文中所列占位符的替换数据集。每个数据集中的架构必须与其占位符匹配。

类型：DashboardSourceEntity 对象

必需：是

DashboardPublishOptions

创建时发布控制面板的选项：

  • AvailabilityStatus 的 AdHocFilteringOption - 此状态可以是 ENABLED 或 DISABLED。当设置为DISABLED，Amaon on QuickSight 禁用已发布仪表板上的左侧筛选器窗格，该窗格可用于临时（一次性）筛选。默认情况下，此选项为 ENABLED。

  • AvailabilityStatus 的 ExportToCSVOption - 此状态可以是 ENABLED 或 DISABLED。此项设置为 DISABLED 时，将数据导出为 .CSV 格式的可视选项未启用。默认情况下，此选项为 ENABLED。

  • VisibilityState 的 SheetControlsOption - 此可见性状态可以是 COLLAPSED 或 EXPANDED。默认情况下，此选项为 COLLAPSED。

类型：DashboardPublishOptions 对象

必需：否

Parameters

包含仪表板参数的结构。这些是仪表板的参数覆盖。控制面板可以具有任何类型的参数，并且某些参数可接受多个值。

类型：Parameters 对象

必需：否

ThemeArn

用于此控制面板的主题的 Amazon 资源名称（ARN）。如果您为此字段添加值，它会覆盖最初与实体关联的值。主题 ARN 必须存在于创建控制面板的同一 AWS 账户中。

类型: 字符串

必需：否

VersionDescription

所创建控制面板的第一个版本的描述。

类型: 字符串

长度限制：最小长度为 1。长度上限为 512。

必需：否

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "DashboardId": "string",
   "RequestId": "string",
   "Status": number,
   "VersionArn": "string"
}

响应元素

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

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

Arn

资源的 Amazon 资源名称（ARN）。

类型: 字符串

CreationStatus

请求的创建状态。

类型: 字符串

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

DashboardId

控制面板 ID。

类型: 字符串

长度限制：最小长度为 1。长度上限为 2048。

模式：[\w\-]+

RequestId

这些区域有：AWS对于是必需的。

类型: 字符串

Status

请求的 HTTP 状态。

类型: 整数

VersionArn

控制面板 ARN，包括版本代码。

类型: 字符串

错误

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

ConflictException

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

HTTP 状态代码：409

InternalFailureException

出现内部故障。

HTTP 状态代码：500

InvalidParameterValueException

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

HTTP 状态代码：400

LimitExceededException

超出限制。

HTTP 状态代码：409

ResourceNotFoundException

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

HTTP 状态代码：404

ThrottlingException

访问受限。

HTTP 状态代码：429

UnsupportedUserEditionException

此错误指示您正在 Amazon 上调用某个操作 QuickSight该版本不支持该操作的订阅。Amazon on QuickSight 当前具有标准版和企业版。每个版本中并未提供所有操作和功能。

HTTP 状态代码：403

另请参阅

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