CloudWatchApplicationSignals / Paginator / ListServiceStates

ListServiceStates¶

class CloudWatchApplicationSignals.Paginator.ListServiceStates¶

paginator = client.get_paginator('list_service_states')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from CloudWatchApplicationSignals.Client.list_service_states().

Request Syntax

response_iterator = paginator.paginate(
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    IncludeLinkedAccounts=True|False,
    AwsAccountId='string',
    AttributeFilters=[
        {
            'AttributeFilterName': 'string',
            'AttributeFilterValues': [
                'string',
            ]
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

StartTime (datetime) –
[REQUIRED]

The start time for the service states query. Only service states from this time onward will be included. Specify the time as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
EndTime (datetime) –
[REQUIRED]

The end time for the service states query. Only service states before this time will be included. Specify the time as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
IncludeLinkedAccounts (boolean) – Specifies whether to include service states from linked AWS accounts in the results. Set to true to include linked accounts, or false to only include the current account. Defaults to false.
AwsAccountId (string) – The AWS account ID to filter service states. If specified, only service states from this account will be returned. If not specified, service states from the current account (and linked accounts if enabled) are returned.
AttributeFilters (list) –
An array of attribute filters to narrow down the service states returned. Each filter specifies an attribute name and the values to match against.
- (dict) –
  
  Represents a filter for service attributes. Used to narrow down results based on specific attribute names and values.
  - AttributeFilterName (string) – [REQUIRED]
    
    The name of the attribute to filter on. This corresponds to service metadata attributes such as environment, team, or custom tags.
  - AttributeFilterValues (list) – [REQUIRED]
    
    An array of values to match against the specified attribute. Services with attribute values matching any of these values will be included in the results.
    - (string) –
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'StartTime': datetime(2015, 1, 1),
    'EndTime': datetime(2015, 1, 1),
    'ServiceStates': [
        {
            'AttributeFilters': [
                {
                    'AttributeFilterName': 'string',
                    'AttributeFilterValues': [
                        'string',
                    ]
                },
            ],
            'Service': {
                'string': 'string'
            },
            'LatestChangeEvents': [
                {
                    'Timestamp': datetime(2015, 1, 1),
                    'AccountId': 'string',
                    'Region': 'string',
                    'Entity': {
                        'string': 'string'
                    },
                    'ChangeEventType': 'DEPLOYMENT',
                    'EventId': 'string',
                    'UserName': 'string',
                    'EventName': 'string'
                },
            ]
        },
    ],

}

Response Structure

(dict) –
- StartTime (datetime) –
  
  The start time of the query range, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
- EndTime (datetime) –
  
  The end time of the query range, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
- ServiceStates (list) –
  
  An array of service state objects that match the specified criteria. Each service state includes current status, recent change events, and service metadata.
  - (dict) –
    
    Represents the current state and health information for a service monitored by Application Signals.
    - AttributeFilters (list) –
      
      The attribute filters that were applied when retrieving this service state.
      - (dict) –
        
        Represents a filter for service attributes. Used to narrow down results based on specific attribute names and values.
        
        AttributeFilterName (string) –
        
        The name of the attribute to filter on. This corresponds to service metadata attributes such as environment, team, or custom tags.
        
        AttributeFilterValues (list) –
        
        An array of values to match against the specified attribute. Services with attribute values matching any of these values will be included in the results.
        
        (string) –
    - Service (dict) –
      
      The service entity information for this service state.
      - (string) –
        
        (string) –
    - LatestChangeEvents (list) –
      
      An array of the most recent change events that may have affected this service, such as deployments or configuration changes.
      - (dict) –
        
        Represents a change event that occurred in the system, such as deployments, configuration changes, or other operational events that may impact service performance.
        
        Timestamp (datetime) –
        
        The timestamp when the change event occurred, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
        
        AccountId (string) –
        
        The AWS account ID where the change event occurred.
        
        Region (string) –
        
        The AWS region where the change event occurred.
        
        Entity (dict) –
        
        The entity or resource that was changed, such as a service, deployment, or configuration.
        
        (string) –
        
        (string) –
        
        ChangeEventType (string) –
        
        The type of change that occurred, such as “Deployment”, “Configuration”, or “Infrastructure”.
        
        EventId (string) –
        
        A unique identifier for the change event.
        
        UserName (string) –
        
        The name of the user or system that initiated the change event.
        
        EventName (string) –
        
        A descriptive name for the change event that provides context about what changed.