2023/06/06 - Amazon QuickSight - 9 updated api methods
Changes QuickSight support for pivot table field collapse state, radar chart range scale and multiple scope options in conditional formatting.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Creates an analysis in Amazon QuickSight. Analyses can be created either from a template or from an AnalysisDefinition.
See also: AWS API Documentation
Request Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.Parameters
# This section is too large to render. # Please see the AWS API Documentation linked below.
dict
Response Syntax
{
'Arn': 'string',
'AnalysisId': 'string',
'CreationStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Arn (string) --
The ARN for the analysis.
AnalysisId (string) --
The ID of the analysis.
CreationStatus (string) --
The status of the creation of the analysis.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The Amazon Web Services request ID for this operation.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Creates a dashboard from either a template or directly with a DashboardDefinition. To first create a template, see the CreateTemplate API operation.
A dashboard is an entity in Amazon QuickSight that identifies Amazon QuickSight reports, created from analyses. You can share Amazon QuickSight dashboards. With the right permissions, you can create scheduled email reports from them. If you have the correct permissions, you can create a dashboard from a template that exists in a different Amazon Web Services account.
See also: AWS API Documentation
Request Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.Parameters
# This section is too large to render. # Please see the AWS API Documentation linked below.
dict
Response Syntax
{
'Arn': 'string',
'VersionArn': 'string',
'DashboardId': 'string',
'CreationStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Arn (string) --
The ARN of the dashboard.
VersionArn (string) --
The ARN of the dashboard, including the version number of the first version that is created.
DashboardId (string) --
The ID for the dashboard.
CreationStatus (string) --
The status of the dashboard creation request.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The Amazon Web Services request ID for this operation.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Creates a template either from a TemplateDefinition or from an existing Amazon QuickSight analysis or template. You can use the resulting template to create additional dashboards, templates, or analyses.
A template is an entity in Amazon QuickSight that encapsulates the metadata required to create an analysis and that you can use to create s dashboard. A template adds a layer of abstraction by using placeholders to replace the dataset associated with the analysis. You can use templates to create dashboards by replacing dataset placeholders with datasets that follow the same schema that was used to create the source analysis and template.
See also: AWS API Documentation
Request Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.Parameters
# This section is too large to render. # Please see the AWS API Documentation linked below.
dict
Response Syntax
{
'Arn': 'string',
'VersionArn': 'string',
'TemplateId': 'string',
'CreationStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Arn (string) --
The ARN for the template.
VersionArn (string) --
The ARN for the template, including the version information of the first version.
TemplateId (string) --
The ID of the template.
CreationStatus (string) --
The template creation status.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The Amazon Web Services request ID for this operation.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Provides a detailed description of the definition of an analysis.
See also: AWS API Documentation
Request Syntax
client.describe_analysis_definition(
AwsAccountId='string',
AnalysisId='string'
)
string
[REQUIRED]
The ID of the Amazon Web Services account that contains the analysis. You must be using the Amazon Web Services account that the analysis is in.
string
[REQUIRED]
The ID of the analysis that you're describing. The ID is part of the URL of the analysis.
dict
Response Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.
Response Structure
# This section is too large to render. # Please see the AWS API Documentation linked below.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Provides a detailed description of the definition of a dashboard.
See also: AWS API Documentation
Request Syntax
client.describe_dashboard_definition(
AwsAccountId='string',
DashboardId='string',
VersionNumber=123,
AliasName='string'
)
string
[REQUIRED]
The ID of the Amazon Web Services account that contains the dashboard that you're describing.
string
[REQUIRED]
The ID for the dashboard.
integer
The version number for the dashboard. If a version number isn't passed, the latest published dashboard version is described.
string
The alias name.
dict
Response Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.
Response Structure
# This section is too large to render. # Please see the AWS API Documentation linked below.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Provides a detailed description of the definition of a template.
See also: AWS API Documentation
Request Syntax
client.describe_template_definition(
AwsAccountId='string',
TemplateId='string',
VersionNumber=123,
AliasName='string'
)
string
[REQUIRED]
The ID of the Amazon Web Services account that contains the template. You must be using the Amazon Web Services account that the template is in.
string
[REQUIRED]
The ID of the template that you're describing.
integer
The version number of the template.
string
The alias of the template that you want to describe. If you name a specific alias, you describe the version that the alias points to. You can specify the latest version of the template by providing the keyword $LATEST in the AliasName parameter. The keyword $PUBLISHED doesn't apply to templates.
dict
Response Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.
Response Structure
# This section is too large to render. # Please see the AWS API Documentation linked below.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Updates an analysis in Amazon QuickSight
See also: AWS API Documentation
Request Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.Parameters
# This section is too large to render. # Please see the AWS API Documentation linked below.
dict
Response Syntax
{
'Arn': 'string',
'AnalysisId': 'string',
'UpdateStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Arn (string) --
The ARN of the analysis that you're updating.
AnalysisId (string) --
The ID of the analysis.
UpdateStatus (string) --
The update status of the last update that was made to the analysis.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The Amazon Web Services request ID for this operation.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Updates a dashboard in an Amazon Web Services account.
See also: AWS API Documentation
Request Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.Parameters
# This section is too large to render. # Please see the AWS API Documentation linked below.
dict
Response Syntax
{
'Arn': 'string',
'VersionArn': 'string',
'DashboardId': 'string',
'CreationStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the resource.
VersionArn (string) --
The ARN of the dashboard, including the version number.
DashboardId (string) --
The ID for the dashboard.
CreationStatus (string) --
The creation status of the request.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The Amazon Web Services request ID for this operation.
{'Definition': {'Sheets': {'Visuals': {'PivotTableVisual': {'ChartConfiguration': {'FieldOptions': {'CollapseStateOptions': [{'State': 'COLLAPSED '
'| '
'EXPANDED',
'Target': {'FieldDataPathValues': [{'FieldId': 'string',
'FieldValue': 'string'}],
'FieldId': 'string'}}]}},
'ConditionalFormatting': {'ConditionalFormattingOptions': {'Cell': {'Scopes': [{'Role': 'FIELD '
'| '
'FIELD_TOTAL '
'| '
'GRAND_TOTAL'}]}}}},
'RadarChartVisual': {'ChartConfiguration': {'AxesRangeScale': 'AUTO '
'| '
'INDEPENDENT '
'| '
'SHARED'}}}}}}
Updates a template from an existing Amazon QuickSight analysis or another template.
See also: AWS API Documentation
Request Syntax
# This section is too large to render. # Please see the AWS API Documentation linked below.Parameters
# This section is too large to render. # Please see the AWS API Documentation linked below.
dict
Response Syntax
{
'TemplateId': 'string',
'Arn': 'string',
'VersionArn': 'string',
'CreationStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
TemplateId (string) --
The ID for the template.
Arn (string) --
The Amazon Resource Name (ARN) for the template.
VersionArn (string) --
The ARN for the template, including the version information of the first version.
CreationStatus (string) --
The creation status of the template.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The Amazon Web Services request ID for this operation.