AWS Health APIs and Notifications

Returns lifecycle information for Amazon Web Services services, including end-of-life dates, version recommendations, and lifecycle events.

See also: AWS API Documentation

Request Syntax

client.describe_service_lifecycle(
    filter={
        'service': 'string'
    },
    nextToken='string',
    maxResults=123
)

type filter:

dict

param filter:

Values to narrow the results returned.

• service (string) --

  The Amazon Web Services service name to filter by.

type nextToken:

string

param nextToken:

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

type maxResults:

integer

param maxResults:

The maximum number of items to return in one batch, between 1 and 20, inclusive.

rtype:

dict

returns:

Response Syntax

{
    'serviceLifecycles': [
        {
            'service': 'string',
            'version': 'string',
            'title': 'string',
            'recommendedVersion': 'string',
            'lifecycleEvents': [
                {
                    'lifecycleEventType': 'string',
                    'date': datetime(2015, 1, 1),
                    'regions': [
                        'string',
                    ],
                    'impactRisks': [
                        'string',
                    ],
                    'description': 'string'
                },
            ]
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) --

  • serviceLifecycles (list) --

    The list of service lifecycle entries matching the filter criteria.

    • (dict) --

      Contains lifecycle information for an Amazon Web Services service version, including lifecycle events and version recommendations.

      • service (string) --

        The name of the Amazon Web Services service.

      • version (string) --

        The version of the service.

      • title (string) --

        A human-readable title for the lifecycle entry.

      • recommendedVersion (string) --

        The recommended version to upgrade to.

      • lifecycleEvents (list) --

        The list of lifecycle events for this service version.

        • (dict) --

          A lifecycle event for an Amazon Web Services service version, such as end-of-support or end-of-life.

          • lifecycleEventType (string) --

            The type of lifecycle event (for example, end-of-support, end-of-life).

          • date (datetime) --

            The date of the lifecycle event.

          • regions (list) --

            The Amazon Web Services Regions affected by this lifecycle event.

            • (string) --

          • impactRisks (list) --

            The potential impact risks associated with this lifecycle event.

            • (string) --

          • description (string) --

            A description of the lifecycle event.

  • nextToken (string) --

    If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.