v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14108906717.7 KB

Creates an evaluation job.

post/evaluation-jobs

Request body

jobNamestring required

A name for the evaluation job. Names must unique with your Amazon Web Services account, and your account's Amazon Web Services region.

jobDescriptionstring password

A description of the evaluation job.

clientRequestTokenstring

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 <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.

roleArnstring required

The Amazon Resource Name (ARN) of an IAM service role that Amazon Bedrock can assume to perform tasks on your behalf. To learn more about the required permissions, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-evaluation-security.html">Required permissions for model evaluations</a>.

customerEncryptionKeyIdstring

Specify your customer managed encryption key Amazon Resource Name (ARN) that will be used to encrypt your evaluation job.

applicationType'ModelEvaluation' | 'RagEvaluation'

Specifies whether the evaluation job is for evaluating a model or evaluating a knowledge base (retrieval and response generation).

Response

Success

jobArnstring required

The Amazon Resource Name (ARN) of the evaluation job.