Skip to main content

templates

Creates, updates, deletes or gets a template resource or lists templates in a region

Overview

Nametemplates
TypeResource
DescriptionDefinition of the AWS::QuickSight::Template Resource Type.
Idawscc.quicksight.templates

Fields

NameDatatypeDescription
created_timestring<p>Time when this was created.</p>
version_descriptionstring
source_entityobject<p>The source entity of the template.</p>
definitionobject
last_updated_timestring<p>Time when this was last updated.</p>
validation_strategyobject<p>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 <code>LENIENT</code>, validation is skipped for specific errors.</p>
namestring
versionobject<p>A version of a template.</p>
aws_account_idstring
permissionsarray
arnstring<p>The Amazon Resource Name (ARN) of the template.</p>
tagsarray
template_idstring
regionstringAWS region.

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

Methods

NameResourceAccessible byRequired Params
create_resourcetemplatesINSERTAwsAccountId, TemplateId, region
delete_resourcetemplatesDELETEIdentifier, region
update_resourcetemplatesUPDATEIdentifier, PatchDocument, region
list_resourcestemplates_list_onlySELECTregion
get_resourcetemplatesSELECTIdentifier, region

SELECT examples

Gets all properties from an individual template.

SELECT
region,
created_time,
version_description,
source_entity,
definition,
last_updated_time,
validation_strategy,
name,
version,
aws_account_id,
permissions,
arn,
tags,
template_id
FROM awscc.quicksight.templates
WHERE
region = 'us-east-1' AND
Identifier = '{{ aws_account_id }}|{{ template_id }}';

INSERT example

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

/*+ create */
INSERT INTO awscc.quicksight.templates (
AwsAccountId,
TemplateId,
region
)
SELECT
'{{ aws_account_id }}',
'{{ template_id }}',
'{{ region }}';

UPDATE example

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

/*+ update */
UPDATE awscc.quicksight.templates
SET PatchDocument = string('{{ {
"VersionDescription": version_description,
"SourceEntity": source_entity,
"Definition": definition,
"ValidationStrategy": validation_strategy,
"Name": name,
"Permissions": permissions,
"Tags": tags
} | generate_patch_document }}')
WHERE
region = '{{ region }}' AND
Identifier = '{{ aws_account_id }}|{{ template_id }}';

DELETE example

/*+ delete */
DELETE FROM awscc.quicksight.templates
WHERE
Identifier = '{{ aws_account_id }}|{{ template_id }}' AND
region = 'us-east-1';

Permissions

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

quicksight:DescribeTemplate,
quicksight:DescribeTemplatePermissions,
quicksight:ListTagsForResource