Health / Client / describe_service_lifecycle

describe_service_lifecycle

Health.Client.describe_service_lifecycle(**kwargs)

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

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

  • filter (dict) –

    Values to narrow the results returned.

    • service (string) –

      The Amazon Web Services service name to filter by.

  • 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.

  • maxResults (integer) – The maximum number of items to return in one batch, between 1 and 20, inclusive.

Return type:

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.

Exceptions