Health / Client / describe_entity_aggregates

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.