SageMaker / Paginator / ListEndpoints

ListEndpoints#

class SageMaker.Paginator.ListEndpoints#
paginator = client.get_paginator('list_endpoints')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from SageMaker.Client.list_endpoints().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    SortBy='Name'|'CreationTime'|'Status',
    SortOrder='Ascending'|'Descending',
    NameContains='string',
    CreationTimeBefore=datetime(2015, 1, 1),
    CreationTimeAfter=datetime(2015, 1, 1),
    LastModifiedTimeBefore=datetime(2015, 1, 1),
    LastModifiedTimeAfter=datetime(2015, 1, 1),
    StatusEquals='OutOfService'|'Creating'|'Updating'|'SystemUpdating'|'RollingBack'|'InService'|'Deleting'|'Failed'|'UpdateRollbackFailed',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • SortBy (string) – Sorts the list of results. The default is CreationTime.

  • SortOrder (string) – The sort order for results. The default is Descending.

  • NameContains (string) – A string in endpoint names. This filter returns only endpoints whose name contains the specified string.

  • CreationTimeBefore (datetime) – A filter that returns only endpoints that were created before the specified time (timestamp).

  • CreationTimeAfter (datetime) – A filter that returns only endpoints with a creation time greater than or equal to the specified time (timestamp).

  • LastModifiedTimeBefore (datetime) – A filter that returns only endpoints that were modified before the specified timestamp.

  • LastModifiedTimeAfter (datetime) – A filter that returns only endpoints that were modified after the specified timestamp.

  • StatusEquals (string) – A filter that returns only endpoints with the specified status.

  • 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

{
    'Endpoints': [
        {
            'EndpointName': 'string',
            'EndpointArn': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'LastModifiedTime': datetime(2015, 1, 1),
            'EndpointStatus': 'OutOfService'|'Creating'|'Updating'|'SystemUpdating'|'RollingBack'|'InService'|'Deleting'|'Failed'|'UpdateRollbackFailed'
        },
    ],

}

Response Structure

  • (dict) –

    • Endpoints (list) –

      An array or endpoint objects.

      • (dict) –

        Provides summary information for an endpoint.

        • EndpointName (string) –

          The name of the endpoint.

        • EndpointArn (string) –

          The Amazon Resource Name (ARN) of the endpoint.

        • CreationTime (datetime) –

          A timestamp that shows when the endpoint was created.

        • LastModifiedTime (datetime) –

          A timestamp that shows when the endpoint was last modified.

        • EndpointStatus (string) –

          The status of the endpoint.

          • OutOfService: Endpoint is not available to take incoming requests.

          • Creating: CreateEndpoint is executing.

          • Updating: UpdateEndpoint or UpdateEndpointWeightsAndCapacities is executing.

          • SystemUpdating: Endpoint is undergoing maintenance and cannot be updated or deleted or re-scaled until it has completed. This maintenance operation does not change any customer-specified values such as VPC config, KMS encryption, model, instance type, or instance count.

          • RollingBack: Endpoint fails to scale up or down or change its variant weight and is in the process of rolling back to its previous configuration. Once the rollback completes, endpoint returns to an InService status. This transitional status only applies to an endpoint that has autoscaling enabled and is undergoing variant weight or capacity changes as part of an UpdateEndpointWeightsAndCapacities call or when the UpdateEndpointWeightsAndCapacities operation is called explicitly.

          • InService: Endpoint is available to process incoming requests.

          • Deleting: DeleteEndpoint is executing.

          • Failed: Endpoint could not be created, updated, or re-scaled. Use DescribeEndpointOutput$FailureReason for information about the failure. DeleteEndpoint is the only operation that can be performed on a failed endpoint.

          To get a list of endpoints with a specified status, use the StatusEquals filter with a call to ListEndpoints.