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