Skip to main content

dashboards

Creates, updates, deletes or gets a dashboard resource or lists dashboards in a region

Overview

Namedashboards
TypeResource
DescriptionDefinition of the AWS::QuickSight::Dashboard Resource Type.
Idawscc.quicksight.dashboards

Fields

NameDatatypeDescription
created_timestring

The time that this dashboard was created.

parametersobject

A list of Amazon QuickSight parameters and the list's override values.

version_descriptionstring
source_entityobject

Dashboard source entity.

theme_arnstring
definitionobject
last_updated_timestring

The last time that this dashboard was updated.

validation_strategyobject

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.

folder_arnsarray
dashboard_idstring
link_sharing_configurationobject
namestring
dashboard_publish_optionsobject

Dashboard publish options.

last_published_timestring

The last time that this dashboard was published.

versionobject

Dashboard version.

aws_account_idstring
permissionsarray
link_entitiesarray
arnstring

The Amazon Resource Name (ARN) of the resource.

tagsarray
regionstringAWS region.

For more information, see AWS::QuickSight::Dashboard.

Methods

NameResourceAccessible byRequired Params
create_resourcedashboardsINSERTAwsAccountId, DashboardId, Name, region
delete_resourcedashboardsDELETEIdentifier, region
update_resourcedashboardsUPDATEIdentifier, PatchDocument, region
list_resourcesdashboards_list_onlySELECTregion
get_resourcedashboardsSELECTIdentifier, region

SELECT examples

Gets all properties from an individual dashboard.

SELECT
region,
created_time,
parameters,
version_description,
source_entity,
theme_arn,
definition,
last_updated_time,
validation_strategy,
folder_arns,
dashboard_id,
link_sharing_configuration,
name,
dashboard_publish_options,
last_published_time,
version,
aws_account_id,
permissions,
link_entities,
arn,
tags
FROM awscc.quicksight.dashboards
WHERE
region = '{{ region }}' AND
Identifier = '{{ aws_account_id }}|{{ dashboard_id }}';

INSERT example

Use the following StackQL query and manifest file to create a new dashboard resource, using stack-deploy.

/*+ create */
INSERT INTO awscc.quicksight.dashboards (
DashboardId,
Name,
AwsAccountId,
region
)
SELECT
'{{ dashboard_id }}',
'{{ name }}',
'{{ aws_account_id }}',
'{{ region }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;

UPDATE example

Use the following StackQL query and manifest file to update a dashboard resource, using stack-deploy.

/*+ update */
UPDATE awscc.quicksight.dashboards
SET PatchDocument = string('{{ {
"Parameters": parameters,
"VersionDescription": version_description,
"SourceEntity": source_entity,
"ThemeArn": theme_arn,
"Definition": definition,
"ValidationStrategy": validation_strategy,
"FolderArns": folder_arns,
"LinkSharingConfiguration": link_sharing_configuration,
"Name": name,
"DashboardPublishOptions": dashboard_publish_options,
"Permissions": permissions,
"LinkEntities": link_entities,
"Tags": tags
} | generate_patch_document }}')
WHERE
region = '{{ region }}' AND
Identifier = '{{ aws_account_id }}|{{ dashboard_id }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;

DELETE example

/*+ delete */
DELETE FROM awscc.quicksight.dashboards
WHERE
Identifier = '{{ aws_account_id }}|{{ dashboard_id }}' AND
region = '{{ region }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;

Additional Parameters

Mutable resources in the Cloud Control provider support additional optional parameters which can be supplied with INSERT, UPDATE, or DELETE operations. These include:

ParameterDescription
ClientToken
A unique identifier to ensure the idempotency of the resource request.This allows the provider to accurately distinguish between retries and new requests.
A client token is valid for 36 hours once used.
After that, a resource request with the same client token is treated as a new request.
If you do not specify a client token, one is generated for inclusion in the request.
RoleArn
The ARN of the IAM role used to perform this resource operation.The role specified must have the permissions required for this operation.
If you do not specify a role, a temporary session is created using your AWS user credentials.
TypeVersionId
For private resource types, the type version to use in this resource operation.If you do not specify a resource version, the default version is used.

Permissions

To operate on the dashboards resource, the following permissions are required:

quicksight:DescribeDashboard,
quicksight:DescribeDashboardPermissions,
quicksight:ListTagsForResource