PrometheusService / Paginator / ListScrapers

ListScrapers

class PrometheusService.Paginator.ListScrapers

paginator = client.get_paginator('list_scrapers')

paginate(**kwargs)

Creates an iterator that will paginate through responses from PrometheusService.Client.list_scrapers().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    filters={
        'string': [
            'string',
        ]
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• filters (dict) –

  A list of scraper filters.

  • (string) –

    The name of the key to filter by. Currently supported filter keys are ‘status’, ‘sourceArn’, ‘destinationArn’, and ‘alias’.

    • (list) –

      The values of the given key to filter by.

      • (string) –

        The value of a given key to filter by.

• 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

{
    'scrapers': [
        {
            'alias': 'string',
            'scraperId': 'string',
            'arn': 'string',
            'roleArn': 'string',
            'status': {
                'statusCode': 'CREATING'|'ACTIVE'|'DELETING'|'CREATION_FAILED'|'DELETION_FAILED'
            },
            'createdAt': datetime(2015, 1, 1),
            'lastModifiedAt': datetime(2015, 1, 1),
            'tags': {
                'string': 'string'
            },
            'statusReason': 'string',
            'source': {
                'eksConfiguration': {
                    'clusterArn': 'string',
                    'securityGroupIds': [
                        'string',
                    ],
                    'subnetIds': [
                        'string',
                    ]
                }
            },
            'destination': {
                'ampConfiguration': {
                    'workspaceArn': 'string'
                }
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  Represents the output of a ListScrapers operation.

  • scrapers (list) –

    The list of scrapers, filtered down if a set of filters was provided in the request.

    • (dict) –

      Represents a summary of the properties of a scraper.

      • alias (string) –

        Alias of this scraper.

      • scraperId (string) –

        Unique string identifying this scraper.

      • arn (string) –

        The Amazon Resource Name (ARN) of this scraper.

      • roleArn (string) –

        The Amazon Resource Name (ARN) of the IAM role that provides permissions for the scraper to dsicover, collect, and produce metrics on your behalf.

      • status (dict) –

        The status of this scraper.

        • statusCode (string) –

          Status code of this scraper.

      • createdAt (datetime) –

        The time when the scraper was created.

      • lastModifiedAt (datetime) –

        The time when the scraper was last modified.

      • tags (dict) –

        The tags of this scraper.

        • (string) –

          The key of the tag.

          Constraints: Tag keys are case-sensitive and accept a maximum of 128 Unicode characters. Valid characters are Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @ May not begin with aws:.

          • (string) –

            The value of the tag.

            Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters. Valid characters are Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @

      • statusReason (string) –

        The reason for failure if any.

      • source (dict) –

        The source that the scraper is discovering and collecting metrics from.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: eksConfiguration. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • eksConfiguration (dict) –

          A representation of an EKS source.

          • clusterArn (string) –

            The ARN of an EKS cluster.

          • securityGroupIds (list) –

            A list of security group IDs specified for VPC configuration.

            • (string) –

              ID of a VPC security group.

          • subnetIds (list) –

            A list of subnet IDs specified for VPC configuration.

            • (string) –

              ID of a VPC subnet.

      • destination (dict) –

        The destination that the scraper is producing metrics to.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: ampConfiguration. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • ampConfiguration (dict) –

          A representation of an AMP destination.

          • workspaceArn (string) –

            The ARN of an AMP workspace.

  • NextToken (string) –

    A token to resume pagination.