describe_entity_aggregates

Health.Client.describe_entity_aggregates(**kwargs)

Returns the number of entities that are affected by each of the specified events.

See also: AWS API Documentation

Request Syntax

response = client.describe_entity_aggregates(
    eventArns=[
        'string',
    ]
)

Parameters

eventArns (list) --

A list of event ARNs (unique identifiers). For example: "arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456", "arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101"

• (string) --

Return type

dict

Returns

Response Syntax

{
    'entityAggregates': [
        {
            'eventArn': 'string',
            'count': 123
        },
    ]
}

Response Structure

• (dict) --
  • entityAggregates (list) --

    The number of entities that are affected by each of the specified events.

    • (dict) --

      The number of entities that are affected by one or more events. Returned by the DescribeEntityAggregates operation.

      • eventArn (string) --

        The unique identifier for the event. The event ARN has the arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID format.

        For example, an event ARN might look like the following:

        arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456

      • count (integer) --

        The number of entities that match the criteria for the specified events.