2020/09/23 - Amazon QuickSight - 3 updated api methods
Changes Added Sheet information to DescribeDashboard, DescribeTemplate and DescribeAnalysis API response.
{'Analysis': {'Sheets': [{'Name': 'string', 'SheetId': 'string'}]}}
Provides a summary of the metadata for an analysis.
See also: AWS API Documentation
Request Syntax
client.describe_analysis(
AwsAccountId='string',
AnalysisId='string'
)
string
[REQUIRED]
The ID of the AWS account that contains the analysis. You must be using the AWS 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
{
'Analysis': {
'AnalysisId': 'string',
'Arn': 'string',
'Name': 'string',
'Status': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Errors': [
{
'Type': 'ACCESS_DENIED'|'SOURCE_NOT_FOUND'|'DATA_SET_NOT_FOUND'|'INTERNAL_FAILURE'|'PARAMETER_VALUE_INCOMPATIBLE'|'PARAMETER_TYPE_INVALID'|'PARAMETER_NOT_FOUND'|'COLUMN_TYPE_MISMATCH'|'COLUMN_GEOGRAPHIC_ROLE_MISMATCH'|'COLUMN_REPLACEMENT_MISSING',
'Message': 'string'
},
],
'DataSetArns': [
'string',
],
'ThemeArn': 'string',
'CreatedTime': datetime(2015, 1, 1),
'LastUpdatedTime': datetime(2015, 1, 1),
'Sheets': [
{
'SheetId': 'string',
'Name': 'string'
},
]
},
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Analysis (dict) --
A metadata structure that contains summary information for the analysis that you're describing.
AnalysisId (string) --
The ID of the analysis.
Arn (string) --
The Amazon Resource Name (ARN) of the analysis.
Name (string) --
The descriptive name of the analysis.
Status (string) --
Status associated with the analysis.
Errors (list) --
Errors associated with the analysis.
(dict) --
A metadata error structure for an analysis.
Type (string) --
The type of the analysis error.
Message (string) --
The message associated with the analysis error.
DataSetArns (list) --
The ARNs of the datasets of the analysis.
(string) --
ThemeArn (string) --
The ARN of the theme of the analysis.
CreatedTime (datetime) --
The time that the analysis was created.
LastUpdatedTime (datetime) --
The time that the analysis was last updated.
Sheets (list) --
A list of the associated sheets with the unique identifier and name of each sheet.
(dict) --
A sheet is an object that contains a set of visuals that are viewed together on one page in the Amazon QuickSight console. Every analysis and dashboard contains at least one sheet. Each sheet contains at least one visualization widget, for example a chart, pivot table, or narrative insight. Sheets can be associated with other components, such as controls, filters, and so on.
SheetId (string) --
The unique identifier associated with a sheet.
Name (string) --
The name of a sheet. This is displayed on the sheet's tab in the QuickSight console.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The AWS request ID for this operation.
{'Dashboard': {'Version': {'Sheets': [{'Name': 'string',
'SheetId': 'string'}]}}}
Provides a summary for a dashboard.
See also: AWS API Documentation
Request Syntax
client.describe_dashboard(
AwsAccountId='string',
DashboardId='string',
VersionNumber=123,
AliasName='string'
)
string
[REQUIRED]
The ID of the AWS 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
{
'Dashboard': {
'DashboardId': 'string',
'Arn': 'string',
'Name': 'string',
'Version': {
'CreatedTime': datetime(2015, 1, 1),
'Errors': [
{
'Type': 'ACCESS_DENIED'|'SOURCE_NOT_FOUND'|'DATA_SET_NOT_FOUND'|'INTERNAL_FAILURE'|'PARAMETER_VALUE_INCOMPATIBLE'|'PARAMETER_TYPE_INVALID'|'PARAMETER_NOT_FOUND'|'COLUMN_TYPE_MISMATCH'|'COLUMN_GEOGRAPHIC_ROLE_MISMATCH'|'COLUMN_REPLACEMENT_MISSING',
'Message': 'string'
},
],
'VersionNumber': 123,
'Status': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'Arn': 'string',
'SourceEntityArn': 'string',
'DataSetArns': [
'string',
],
'Description': 'string',
'ThemeArn': 'string',
'Sheets': [
{
'SheetId': 'string',
'Name': 'string'
},
]
},
'CreatedTime': datetime(2015, 1, 1),
'LastPublishedTime': datetime(2015, 1, 1),
'LastUpdatedTime': datetime(2015, 1, 1)
},
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Dashboard (dict) --
Information about the dashboard.
DashboardId (string) --
Dashboard ID.
Arn (string) --
The Amazon Resource Name (ARN) of the resource.
Name (string) --
A display name for the dashboard.
Version (dict) --
Version.
CreatedTime (datetime) --
The time that this dashboard version was created.
Errors (list) --
Errors associated with this dashboard version.
(dict) --
Dashboard error.
Type (string) --
Type.
Message (string) --
Message.
VersionNumber (integer) --
Version number for this version of the dashboard.
Status (string) --
The HTTP status of the request.
Arn (string) --
The Amazon Resource Name (ARN) of the resource.
SourceEntityArn (string) --
Source entity ARN.
DataSetArns (list) --
The Amazon Resource Numbers (ARNs) for the datasets that are associated with this version of the dashboard.
(string) --
Description (string) --
Description.
ThemeArn (string) --
The ARN of the theme associated with a version of the dashboard.
Sheets (list) --
A list of the associated sheets with the unique identifier and name of each sheet.
(dict) --
A sheet is an object that contains a set of visuals that are viewed together on one page in the Amazon QuickSight console. Every analysis and dashboard contains at least one sheet. Each sheet contains at least one visualization widget, for example a chart, pivot table, or narrative insight. Sheets can be associated with other components, such as controls, filters, and so on.
SheetId (string) --
The unique identifier associated with a sheet.
Name (string) --
The name of a sheet. This is displayed on the sheet's tab in the QuickSight console.
CreatedTime (datetime) --
The time that this dataset was created.
LastPublishedTime (datetime) --
The last time that this dataset was published.
LastUpdatedTime (datetime) --
The last time that this dataset was updated.
Status (integer) --
The HTTP status of this request.
RequestId (string) --
The AWS request ID for this operation.
{'Template': {'Version': {'Sheets': [{'Name': 'string', 'SheetId': 'string'}]}}}
Describes a template's metadata.
See also: AWS API Documentation
Request Syntax
client.describe_template(
AwsAccountId='string',
TemplateId='string',
VersionNumber=123,
AliasName='string'
)
string
[REQUIRED]
The ID of the AWS account that contains the template that you're describing.
string
[REQUIRED]
The ID for the template.
integer
(Optional) The number for the version to describe. If a VersionNumber parameter value isn't provided, the latest version of the template is described.
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
{
'Template': {
'Arn': 'string',
'Name': 'string',
'Version': {
'CreatedTime': datetime(2015, 1, 1),
'Errors': [
{
'Type': 'SOURCE_NOT_FOUND'|'DATA_SET_NOT_FOUND'|'INTERNAL_FAILURE'|'ACCESS_DENIED',
'Message': 'string'
},
],
'VersionNumber': 123,
'Status': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETED',
'DataSetConfigurations': [
{
'Placeholder': 'string',
'DataSetSchema': {
'ColumnSchemaList': [
{
'Name': 'string',
'DataType': 'string',
'GeographicRole': 'string'
},
]
},
'ColumnGroupSchemaList': [
{
'Name': 'string',
'ColumnGroupColumnSchemaList': [
{
'Name': 'string'
},
]
},
]
},
],
'Description': 'string',
'SourceEntityArn': 'string',
'ThemeArn': 'string',
'Sheets': [
{
'SheetId': 'string',
'Name': 'string'
},
]
},
'TemplateId': 'string',
'LastUpdatedTime': datetime(2015, 1, 1),
'CreatedTime': datetime(2015, 1, 1)
},
'Status': 123,
'RequestId': 'string'
}
Response Structure
(dict) --
Template (dict) --
The template structure for the object you want to describe.
Arn (string) --
The Amazon Resource Name (ARN) of the template.
Name (string) --
The display name of the template.
Version (dict) --
A structure describing the versions of the template.
CreatedTime (datetime) --
The time that this template version was created.
Errors (list) --
Errors associated with this template version.
(dict) --
List of errors that occurred when the template version creation failed.
Type (string) --
Type of error.
Message (string) --
Description of the error type.
VersionNumber (integer) --
The version number of the template version.
Status (string) --
The HTTP status of the request.
DataSetConfigurations (list) --
Schema of the dataset identified by the placeholder. Any dashboard created from this template should be bound to new datasets matching the same schema described through this API operation.
(dict) --
Dataset configuration.
Placeholder (string) --
Placeholder.
DataSetSchema (dict) --
Dataset schema.
ColumnSchemaList (list) --
A structure containing the list of column schemas.
(dict) --
The column schema.
Name (string) --
The name of the column schema.
DataType (string) --
The data type of the column schema.
GeographicRole (string) --
The geographic role of the column schema.
ColumnGroupSchemaList (list) --
A structure containing the list of column group schemas.
(dict) --
The column group schema.
Name (string) --
The name of the column group schema.
ColumnGroupColumnSchemaList (list) --
A structure containing the list of schemas for column group columns.
(dict) --
A structure describing the name, data type, and geographic role of the columns.
Name (string) --
The name of the column group's column schema.
Description (string) --
The description of the template.
SourceEntityArn (string) --
The Amazon Resource Name (ARN) of an analysis or template that was used to create this template.
ThemeArn (string) --
The ARN of the theme associated with this version of the template.
Sheets (list) --
A list of the associated sheets with the unique identifier and name of each sheet.
(dict) --
A sheet is an object that contains a set of visuals that are viewed together on one page in the Amazon QuickSight console. Every analysis and dashboard contains at least one sheet. Each sheet contains at least one visualization widget, for example a chart, pivot table, or narrative insight. Sheets can be associated with other components, such as controls, filters, and so on.
SheetId (string) --
The unique identifier associated with a sheet.
Name (string) --
The name of a sheet. This is displayed on the sheet's tab in the QuickSight console.
TemplateId (string) --
The ID for the template. This is unique per AWS Region for each AWS account.
LastUpdatedTime (datetime) --
Time when this was last updated.
CreatedTime (datetime) --
Time when this was created.
Status (integer) --
The HTTP status of the request.
RequestId (string) --
The AWS request ID for this operation.