ListEvaluationJobs - Amazon Bedrock

ListEvaluationJobs

Lists model evaluation jobs.

Request Syntax

GET /evaluation-jobs?creationTimeAfter=creationTimeAfter&creationTimeBefore=creationTimeBefore&maxResults=maxResults&nameContains=nameContains&nextToken=nextToken&sortBy=sortBy&sortOrder=sortOrder&statusEquals=statusEquals HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

creationTimeAfter

A filter that includes model evaluation jobs created after the time specified.

creationTimeBefore

A filter that includes model evaluation jobs created prior to the time specified.

maxResults

The maximum number of results to return.

Valid Range: Minimum value of 1. Maximum value of 1000.

nameContains

Query parameter string for model evaluation job names.

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: ^[a-z0-9](-*[a-z0-9]){0,62}$

nextToken

Continuation token from the previous response, for Amazon Bedrock to list the next set of results.

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: ^\S*$

sortBy

Allows you to sort model evaluation jobs by when they were created.

Valid Values: CreationTime

sortOrder

How you want the order of jobs sorted.

Valid Values: Ascending | Descending

statusEquals

Only return jobs where the status condition is met.

Valid Values: InProgress | Completed | Failed | Stopping | Stopped | Deleting

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "jobSummaries": [ { "creationTime": "string", "evaluationTaskTypes": [ "string" ], "jobArn": "string", "jobName": "string", "jobType": "string", "modelIdentifiers": [ "string" ], "status": "string" } ], "nextToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

jobSummaries

A summary of the model evaluation jobs.

Type: Array of EvaluationSummary objects

Array Members: Minimum number of 1 item. Maximum number of 5 items.

nextToken

Continuation token from the previous response, for Amazon Bedrock to list the next set of results.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: ^\S*$

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

The request is denied because of missing access permissions.

HTTP Status Code: 403

InternalServerException

An internal server error occurred. Retry your request.

HTTP Status Code: 500

ThrottlingException

The number of requests exceeds the limit. Resubmit your request later.

HTTP Status Code: 429

ValidationException

Input validation failed. Check your request parameters and retry the request.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: