Bedrock / Client / list_model_invocation_jobs

list_model_invocation_jobs#

Bedrock.Client.list_model_invocation_jobs(**kwargs)#

Lists all batch inference jobs in the account. For more information, see View details about a batch inference job.

See also: AWS API Documentation

Request Syntax

response = client.list_model_invocation_jobs(
    submitTimeAfter=datetime(2015, 1, 1),
    submitTimeBefore=datetime(2015, 1, 1),
    statusEquals='Submitted'|'InProgress'|'Completed'|'Failed'|'Stopping'|'Stopped'|'PartiallyCompleted'|'Expired'|'Validating'|'Scheduled',
    nameContains='string',
    maxResults=123,
    nextToken='string',
    sortBy='CreationTime',
    sortOrder='Ascending'|'Descending'
)
Parameters:
  • submitTimeAfter (datetime) – Specify a time to filter for batch inference jobs that were submitted after the time you specify.

  • submitTimeBefore (datetime) – Specify a time to filter for batch inference jobs that were submitted before the time you specify.

  • statusEquals (string) – Specify a status to filter for batch inference jobs whose statuses match the string you specify.

  • nameContains (string) – Specify a string to filter for batch inference jobs whose names contain the string.

  • maxResults (integer) – The maximum number of results to return. If there are more results than the number that you specify, a nextToken value is returned. Use the nextToken in a request to return the next batch of results.

  • nextToken (string) – If there were more results than the value you specified in the maxResults field in a previous ListModelInvocationJobs request, the response would have returned a nextToken value. To see the next batch of results, send the nextToken value in another request.

  • sortBy (string) – An attribute by which to sort the results.

  • sortOrder (string) – Specifies whether to sort the results by ascending or descending order.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'invocationJobSummaries': [
        {
            'jobArn': 'string',
            'jobName': 'string',
            'modelId': 'string',
            'clientRequestToken': 'string',
            'roleArn': 'string',
            'status': 'Submitted'|'InProgress'|'Completed'|'Failed'|'Stopping'|'Stopped'|'PartiallyCompleted'|'Expired'|'Validating'|'Scheduled',
            'message': 'string',
            'submitTime': datetime(2015, 1, 1),
            'lastModifiedTime': datetime(2015, 1, 1),
            'endTime': datetime(2015, 1, 1),
            'inputDataConfig': {
                's3InputDataConfig': {
                    's3InputFormat': 'JSONL',
                    's3Uri': 'string',
                    's3BucketOwner': 'string'
                }
            },
            'outputDataConfig': {
                's3OutputDataConfig': {
                    's3Uri': 'string',
                    's3EncryptionKeyId': 'string',
                    's3BucketOwner': 'string'
                }
            },
            'vpcConfig': {
                'subnetIds': [
                    'string',
                ],
                'securityGroupIds': [
                    'string',
                ]
            },
            'timeoutDurationInHours': 123,
            'jobExpirationTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) –

    • nextToken (string) –

      If there are more results than can fit in the response, a nextToken is returned. Use the nextToken in a request to return the next batch of results.

    • invocationJobSummaries (list) –

      A list of items, each of which contains a summary about a batch inference job.

      • (dict) –

        A summary of a batch inference job.

        • jobArn (string) –

          The Amazon Resource Name (ARN) of the batch inference job.

        • jobName (string) –

          The name of the batch inference job.

        • modelId (string) –

          The unique identifier of the foundation model used for model inference.

        • clientRequestToken (string) –

          A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.

        • roleArn (string) –

          The Amazon Resource Name (ARN) of the service role with permissions to carry out and manage batch inference. You can use the console to create a default service role or follow the steps at Create a service role for batch inference.

        • status (string) –

          The status of the batch inference job.

        • message (string) –

          If the batch inference job failed, this field contains a message describing why the job failed.

        • submitTime (datetime) –

          The time at which the batch inference job was submitted.

        • lastModifiedTime (datetime) –

          The time at which the batch inference job was last modified.

        • endTime (datetime) –

          The time at which the batch inference job ended.

        • inputDataConfig (dict) –

          Details about the location of the input to the batch inference job.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: s3InputDataConfig. 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'}
          
          • s3InputDataConfig (dict) –

            Contains the configuration of the S3 location of the input data.

            • s3InputFormat (string) –

              The format of the input data.

            • s3Uri (string) –

              The S3 location of the input data.

            • s3BucketOwner (string) –

              The ID of the Amazon Web Services account that owns the S3 bucket containing the input data.

        • outputDataConfig (dict) –

          Details about the location of the output of the batch inference job.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: s3OutputDataConfig. 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'}
          
          • s3OutputDataConfig (dict) –

            Contains the configuration of the S3 location of the output data.

            • s3Uri (string) –

              The S3 location of the output data.

            • s3EncryptionKeyId (string) –

              The unique identifier of the key that encrypts the S3 location of the output data.

            • s3BucketOwner (string) –

              The ID of the Amazon Web Services account that owns the S3 bucket containing the output data.

        • vpcConfig (dict) –

          The configuration of the Virtual Private Cloud (VPC) for the data in the batch inference job. For more information, see Protect batch inference jobs using a VPC.

          • subnetIds (list) –

            An array of IDs for each subnet in the VPC to use.

            • (string) –

          • securityGroupIds (list) –

            An array of IDs for each security group in the VPC to use.

            • (string) –

        • timeoutDurationInHours (integer) –

          The number of hours after which the batch inference job was set to time out.

        • jobExpirationTime (datetime) –

          The time at which the batch inference job times or timed out.

Exceptions

  • Bedrock.Client.exceptions.AccessDeniedException

  • Bedrock.Client.exceptions.ValidationException

  • Bedrock.Client.exceptions.InternalServerException

  • Bedrock.Client.exceptions.ThrottlingException