Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Creates a new dataset resource asynchronously. Returns immediately with status CREATING. Poll <code>GetDataset</code> until status transitions to ACTIVE or CREATE_FAILED.

post/datasets

Request body

clientTokenstring

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.

datasetNamestring required

Human-readable name for the dataset. Must be unique within the account. Immutable after creation.

descriptionstring

A description of the dataset.

schemaType'AGENTCORE_EVALUATION_PREDEFINED_V1' | 'AGENTCORE_EVALUATION_SIMULATED_V1' required

Versioned schema type for dataset examples. Each value identifies both the source format and the version of that format's schema.

kmsKeyArnstring

Optional KMS key ARN for server-side encryption on service Amazon S3 writes.

tagsobject

A map of tag keys and values to assign to the dataset.

Response

Success

datasetArnstring required

The Amazon Resource Name (ARN) of the created dataset.

datasetIdstring required

The unique identifier of the created dataset.

status'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED' required

Always CREATING immediately after this call. Poll <code>GetDataset</code> until status transitions to ACTIVE or CREATE_FAILED.

createdAtstring date-time required

The timestamp when the dataset was created.