CfnDashboardProps
- class aws_cdk.aws_quicksight.CfnDashboardProps(*, aws_account_id, dashboard_id, name, dashboard_publish_options=None, definition=None, folder_arns=None, link_entities=None, link_sharing_configuration=None, parameters=None, permissions=None, source_entity=None, tags=None, theme_arn=None, validation_strategy=None, version_description=None)
Bases:
object
Properties for defining a
CfnDashboard
.- Parameters:
aws_account_id (
str
) – The ID of the AWS account where you want to create the dashboard.dashboard_id (
str
) – The ID for the dashboard, also added to the IAM policy.name (
str
) – The display name of the dashboard.dashboard_publish_options (
Union
[IResolvable
,DashboardPublishOptionsProperty
,Dict
[str
,Any
],None
]) – Options for publishing the dashboard when you create it:. -AvailabilityStatus
forAdHocFilteringOption
- This status can be eitherENABLED
orDISABLED
. When this is set toDISABLED
, Amazon QuickSight disables the left filter pane on the published dashboard, which can be used for ad hoc (one-time) filtering. This option isENABLED
by default. -AvailabilityStatus
forExportToCSVOption
- This status can be eitherENABLED
orDISABLED
. The visual option to export data to .CSV format isn’t enabled when this is set toDISABLED
. This option isENABLED
by default. -VisibilityState
forSheetControlsOption
- This visibility state can be eitherCOLLAPSED
orEXPANDED
. This option isCOLLAPSED
by default.definition (
Union
[IResolvable
,DashboardVersionDefinitionProperty
,Dict
[str
,Any
],None
]) –folder_arns (
Optional
[Sequence
[str
]]) –link_entities (
Optional
[Sequence
[str
]]) – A list of analysis Amazon Resource Names (ARNs) to be linked to the dashboard.link_sharing_configuration (
Union
[IResolvable
,LinkSharingConfigurationProperty
,Dict
[str
,Any
],None
]) – A structure that contains the link sharing configurations that you want to apply overrides to.parameters (
Union
[IResolvable
,ParametersProperty
,Dict
[str
,Any
],None
]) – The parameters for the creation of the dashboard, which you want to use to override the default settings. A dashboard can have any type of parameters, and some parameters might accept multiple values.permissions (
Union
[IResolvable
,Sequence
[Union
[IResolvable
,ResourcePermissionProperty
,Dict
[str
,Any
]]],None
]) – A structure that contains the permissions of the dashboard. You can use this structure for granting permissions by providing a list of IAM action information for each principal ARN. To specify no permissions, omit the permissions list.source_entity (
Union
[IResolvable
,DashboardSourceEntityProperty
,Dict
[str
,Any
],None
]) – The entity that you are using as a source when you create the dashboard. InSourceEntity
, you specify the type of object that you want to use. You can only create a dashboard from a template, so you use aSourceTemplate
entity. If you need to create a dashboard from an analysis, first convert the analysis to a template by using theCreateTemplate
API operation. ForSourceTemplate
, specify the Amazon Resource Name (ARN) of the source template. TheSourceTemplate
ARN can contain any AWS account; and any QuickSight-supported AWS Region . Use theDataSetReferences
entity withinSourceTemplate
to list the replacement datasets for the placeholders listed in the original. The schema in each dataset must match its placeholder.tags (
Optional
[Sequence
[Union
[CfnTag
,Dict
[str
,Any
]]]]) – Contains a map of the key-value pairs for the resource tag or tags assigned to the dashboard.theme_arn (
Optional
[str
]) – The Amazon Resource Name (ARN) of the theme that is being used for this dashboard. If you add a value for this field, it overrides the value that is used in the source entity. The theme ARN must exist in the same AWS account where you create the dashboard.validation_strategy (
Union
[IResolvable
,ValidationStrategyProperty
,Dict
[str
,Any
],None
]) – The option to relax the validation that is required to create and update analyses, dashboards, and templates with definition objects. When you set this value toLENIENT
, validation is skipped for specific errors.version_description (
Optional
[str
]) – A description for the first version of the dashboard being created.
- See:
http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dashboard.html
- ExampleMetadata:
fixture=_generated
Example:
.. rubric:: Attributes
- aws_account_id
The ID of the AWS account where you want to create the dashboard.
- dashboard_id
The ID for the dashboard, also added to the IAM policy.
- dashboard_publish_options
.
AvailabilityStatus
forAdHocFilteringOption
- This status can be eitherENABLED
orDISABLED
. When this is set toDISABLED
, Amazon QuickSight disables the left filter pane on the published dashboard, which can be used for ad hoc (one-time) filtering. This option isENABLED
by default.AvailabilityStatus
forExportToCSVOption
- This status can be eitherENABLED
orDISABLED
. The visual option to export data to .CSV format isn’t enabled when this is set toDISABLED
. This option isENABLED
by default.VisibilityState
forSheetControlsOption
- This visibility state can be eitherCOLLAPSED
orEXPANDED
. This option isCOLLAPSED
by default.
- See:
- Type:
Options for publishing the dashboard when you create it
- definition
-
- Type:
see
- folder_arns
-
- Type:
see
- link_entities
A list of analysis Amazon Resource Names (ARNs) to be linked to the dashboard.
- link_sharing_configuration
A structure that contains the link sharing configurations that you want to apply overrides to.
- name
The display name of the dashboard.
- parameters
The parameters for the creation of the dashboard, which you want to use to override the default settings.
A dashboard can have any type of parameters, and some parameters might accept multiple values.
- permissions
A structure that contains the permissions of the dashboard.
You can use this structure for granting permissions by providing a list of IAM action information for each principal ARN.
To specify no permissions, omit the permissions list.
- source_entity
The entity that you are using as a source when you create the dashboard.
In
SourceEntity
, you specify the type of object that you want to use. You can only create a dashboard from a template, so you use aSourceTemplate
entity. If you need to create a dashboard from an analysis, first convert the analysis to a template by using theCreateTemplate
API operation. ForSourceTemplate
, specify the Amazon Resource Name (ARN) of the source template. TheSourceTemplate
ARN can contain any AWS account; and any QuickSight-supported AWS Region .Use the
DataSetReferences
entity withinSourceTemplate
to list the replacement datasets for the placeholders listed in the original. The schema in each dataset must match its placeholder.
- tags
Contains a map of the key-value pairs for the resource tag or tags assigned to the dashboard.
- theme_arn
The Amazon Resource Name (ARN) of the theme that is being used for this dashboard.
If you add a value for this field, it overrides the value that is used in the source entity. The theme ARN must exist in the same AWS account where you create the dashboard.
- validation_strategy
The option to relax the validation that is required to create and update analyses, dashboards, and templates with definition objects.
When you set this value to
LENIENT
, validation is skipped for specific errors.
- version_description
A description for the first version of the dashboard being created.