SheetDefinition - Amazon QuickSight
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

SheetDefinition

A sheet is an object that contains a set of visuals that are viewed together on one page in a paginated report. Every analysis and dashboard must contain at least one sheet.

Contents

Note

In the following list, the required parameters are described first.

SheetId

The unique identifier of a sheet.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 512.

Pattern: [\w\-]+

Required: Yes

ContentType

The layout content type of the sheet. Choose one of the following options:

  • PAGINATED: Creates a sheet for a paginated report.

  • INTERACTIVE: Creates a sheet for an interactive dashboard.

Type: String

Valid Values: PAGINATED | INTERACTIVE

Required: No

Description

A description of the sheet.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

FilterControls

The list of filter controls that are on a sheet.

For more information, see Adding filter controls to analysis sheets in the Amazon QuickSight User Guide.

Type: Array of FilterControl objects

Array Members: Maximum number of 200 items.

Required: No

Layouts

Layouts define how the components of a sheet are arranged.

For more information, see Types of layout in the Amazon QuickSight User Guide.

Type: Array of Layout objects

Array Members: Fixed number of 1 item.

Required: No

Name

The name of the sheet. This name is displayed on the sheet's tab in the Amazon QuickSight console.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Required: No

ParameterControls

The list of parameter controls that are on a sheet.

For more information, see Using a Control with a Parameter in Amazon QuickSight in the Amazon QuickSight User Guide.

Type: Array of ParameterControl objects

Array Members: Maximum number of 200 items.

Required: No

SheetControlLayouts

The control layouts of the sheet.

Type: Array of SheetControlLayout objects

Array Members: Minimum number of 0 items. Maximum number of 1 item.

Required: No

TextBoxes

The text boxes that are on a sheet.

Type: Array of SheetTextBox objects

Array Members: Maximum number of 100 items.

Required: No

Title

The title of the sheet.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

Visuals

A list of the visuals that are on a sheet. Visual placement is determined by the layout of the sheet.

Type: Array of Visual objects

Array Members: Maximum number of 50 items.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: