CloudTrail / Client / get_dashboard

get_dashboard

CloudTrail.Client.get_dashboard(**kwargs)

Returns the specified dashboard.

See also: AWS API Documentation

Request Syntax

response = client.get_dashboard(
    DashboardId='string'
)

Parameters:

DashboardId (string) –

[REQUIRED]

The name or ARN for the dashboard.

Return type:

dict

Returns:

Response Syntax

{
    'DashboardArn': 'string',
    'Type': 'MANAGED'|'CUSTOM',
    'Status': 'CREATING'|'CREATED'|'UPDATING'|'UPDATED'|'DELETING',
    'Widgets': [
        {
            'QueryAlias': 'string',
            'QueryStatement': 'string',
            'QueryParameters': [
                'string',
            ],
            'ViewProperties': {
                'string': 'string'
            }
        },
    ],
    'RefreshSchedule': {
        'Frequency': {
            'Unit': 'HOURS'|'DAYS',
            'Value': 123
        },
        'Status': 'ENABLED'|'DISABLED',
        'TimeOfDay': 'string'
    },
    'CreatedTimestamp': datetime(2015, 1, 1),
    'UpdatedTimestamp': datetime(2015, 1, 1),
    'LastRefreshId': 'string',
    'LastRefreshFailureReason': 'string',
    'TerminationProtectionEnabled': True|False
}

Response Structure

• (dict) –

  • DashboardArn (string) –

    The ARN for the dashboard.

  • Type (string) –

    The type of dashboard.

  • Status (string) –

    The status of the dashboard.

  • Widgets (list) –

    An array of widgets for the dashboard.

    • (dict) –

      A widget on a CloudTrail Lake dashboard.

      • QueryAlias (string) –

        The query alias used to identify the query for the widget.

      • QueryStatement (string) –

        The SQL query statement for the widget.

      • QueryParameters (list) –

        The query parameters for the widget.

        • (string) –

      • ViewProperties (dict) –

        The view properties for the widget. For more information about view properties, see View properties for widgets in the CloudTrail User Guide..

        • (string) –

          • (string) –

  • RefreshSchedule (dict) –

    The refresh schedule for the dashboard, if configured.

    • Frequency (dict) –

      The frequency at which you want the dashboard refreshed.

      • Unit (string) –

        The unit to use for the refresh.

        For custom dashboards, the unit can be HOURS or DAYS.

        For the Highlights dashboard, the Unit must be HOURS.

      • Value (integer) –

        The value for the refresh schedule.

        For custom dashboards, the following values are valid when the unit is HOURS: 1, 6, 12, 24

        For custom dashboards, the only valid value when the unit is DAYS is 1.

        For the Highlights dashboard, the Value must be 6.

    • Status (string) –

      Specifies whether the refresh schedule is enabled. Set the value to ENABLED to enable the refresh schedule, or to DISABLED to turn off the refresh schedule.

    • TimeOfDay (string) –

      The time of day in UTC to run the schedule; for hourly only refer to minutes; default is 00:00.

  • CreatedTimestamp (datetime) –

    The timestamp that shows when the dashboard was created.

  • UpdatedTimestamp (datetime) –

    The timestamp that shows when the dashboard was last updated.

  • LastRefreshId (string) –

    The ID of the last dashboard refresh.

  • LastRefreshFailureReason (string) –

    Provides information about failures for the last scheduled refresh.

  • TerminationProtectionEnabled (boolean) –

    Indicates whether termination protection is enabled for the dashboard.

Exceptions

• CloudTrail.Client.exceptions.ResourceNotFoundException

• CloudTrail.Client.exceptions.UnsupportedOperationException