LocationService / Paginator / ListJobs

ListJobs

class LocationService.Paginator.ListJobs

paginator = client.get_paginator('list_jobs')

paginate(**kwargs)

Creates an iterator that will paginate through responses from LocationService.Client.list_jobs().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filter={
        'JobStatus': 'Pending'|'Running'|'Completed'|'Failed'|'Cancelling'|'Cancelled'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• Filter (dict) –

  An optional structure containing criteria by which to filter job results.

  • JobStatus (string) –

    Filter by job 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

{
    'Entries': [
        {
            'Action': 'ValidateAddress',
            'ActionOptions': {
                'ValidateAddress': {
                    'AdditionalFeatures': [
                        'Position'|'CountrySpecificAttributes',
                    ]
                }
            },
            'CreatedAt': datetime(2015, 1, 1),
            'ExecutionRoleArn': 'string',
            'EndedAt': datetime(2015, 1, 1),
            'Error': {
                'Code': 'ValidationError'|'InternalServerError',
                'Messages': [
                    'string',
                ]
            },
            'InputOptions': {
                'Location': 'string',
                'Format': 'Parquet'
            },
            'JobId': 'string',
            'JobArn': 'string',
            'Name': 'string',
            'OutputOptions': {
                'Format': 'Parquet',
                'Location': 'string'
            },
            'Status': 'Pending'|'Running'|'Completed'|'Failed'|'Cancelling'|'Cancelled',
            'UpdatedAt': datetime(2015, 1, 1)
        },
    ],

}

Response Structure

• (dict) –

  • Entries (list) –

    List of jobs in your Amazon Web Services account.

    • (dict) –

      Job summary information returned in list operations.

      • Action (string) –

        Action performed by the job.

      • ActionOptions (dict) –

        Additional options for configuring job action parameters.

        • ValidateAddress (dict) –

          Options specific to address validation jobs.

          • AdditionalFeatures (list) –

            A list of optional additional parameters that can be requested for each result.

            Values:

            • Position - Return the position coordinates of the address if available.

            • CountrySpecificAttributes - Return additional information about the address specific to the country of origin.

            • (string) –

      • CreatedAt (datetime) –

        Job creation time in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sss.

      • ExecutionRoleArn (string) –

        IAM role used for job execution.

      • EndedAt (datetime) –

        Job completion time in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sss. Only returned for jobs in a terminal status: Completed | Failed | Cancelled.

      • Error (dict) –

        Error information if the job failed.

        • Code (string) –

          Error code indicating the type of error that occurred.

        • Messages (list) –

          Error messages providing details about the failure.

          • (string) –

      • InputOptions (dict) –

        Input configuration.

        • Location (string) –

          S3 ARN or URI where input files are stored.

          Note

          The Amazon S3 bucket must be created in the same Amazon Web Services region where you plan to run your job.

        • Format (string) –

          Input data format. Currently only Parquet is supported.

          Note

          Input files have a limitation of 10gb per file, and 1gb per Parquet row-group within the file.

      • JobId (string) –

        Unique job identifier.

      • JobArn (string) –

        Amazon Resource Name (ARN) of the job.

      • Name (string) –

        Job name (if provided during creation).

      • OutputOptions (dict) –

        Output configuration.

        • Format (string) –

          Output data format. Currently only “Parquet” is supported.

        • Location (string) –

          S3 ARN or URI where output files will be written.

          Note

          The Amazon S3 bucket must exist in the same Amazon Web Services region where you plan to run your job.

      • Status (string) –

        Current job status.

      • UpdatedAt (datetime) –

        Last update time in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sss.