Skip to main content

analyses

Creates, updates, deletes or gets an analysis resource or lists analyses in a region

Overview

Nameanalyses
TypeResource
DescriptionDefinition of the AWS::QuickSight::Analysis Resource Type.
Idawscc.quicksight.analyses

Fields

NameDatatypeDescription
statusstring
created_timestring

The time that the analysis was created.

parametersobject

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

data_set_arnsarray

The ARNs of the datasets of the analysis.

source_entityobject

The source entity of an analysis.

theme_arnstring

The ARN of the theme of the analysis.

definitionobject
last_updated_timestring

The time that the analysis was last 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
namestring

The descriptive name of the analysis.

errorsarray

Errors associated with the analysis.

analysis_idstring
aws_account_idstring
permissionsarray
arnstring

The Amazon Resource Name (ARN) of the analysis.

tagsarray
sheetsarray

A list of the associated sheets with the unique identifier and name of each sheet.

regionstringAWS region.

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

Methods

NameResourceAccessible byRequired Params
create_resourceanalysesINSERTAwsAccountId, AnalysisId, Name, region
delete_resourceanalysesDELETEIdentifier, region
update_resourceanalysesUPDATEIdentifier, PatchDocument, region
list_resourcesanalyses_list_onlySELECTregion
get_resourceanalysesSELECTIdentifier, region

SELECT examples

Gets all properties from an individual analysis.

SELECT
region,
status,
created_time,
parameters,
data_set_arns,
source_entity,
theme_arn,
definition,
last_updated_time,
validation_strategy,
folder_arns,
name,
errors,
analysis_id,
aws_account_id,
permissions,
arn,
tags,
sheets
FROM awscc.quicksight.analyses
WHERE
region = '{{ region }}' AND
Identifier = '{{ analysis_id }}|{{ aws_account_id }}';

INSERT example

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

/*+ create */
INSERT INTO awscc.quicksight.analyses (
Name,
AnalysisId,
AwsAccountId,
region
)
SELECT
'{{ name }}',
'{{ analysis_id }}',
'{{ 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 analysis resource, using stack-deploy.

/*+ update */
UPDATE awscc.quicksight.analyses
SET PatchDocument = string('{{ {
"Status": status,
"Parameters": parameters,
"SourceEntity": source_entity,
"ThemeArn": theme_arn,
"Definition": definition,
"ValidationStrategy": validation_strategy,
"FolderArns": folder_arns,
"Name": name,
"Errors": errors,
"Permissions": permissions,
"Tags": tags,
"Sheets": sheets
} | generate_patch_document }}')
WHERE
region = '{{ region }}' AND
Identifier = '{{ analysis_id }}|{{ aws_account_id }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;

DELETE example

/*+ delete */
DELETE FROM awscc.quicksight.analyses
WHERE
Identifier = '{{ analysis_id }}|{{ aws_account_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 analyses resource, the following permissions are required:

quicksight:DescribeAnalysis,
quicksight:DescribeAnalysisPermissions,
quicksight:ListTagsForResource