All Products
Search
Document Center

Platform For AI:CreateDatasetFileMetas

Last Updated:Oct 17, 2025

Creates file metadata records for a dataset in a batch.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /api/v1/datasets/{DatasetId}/datasetfilemetas HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

DatasetId

string

Yes

The dataset ID. For more information about how to obtain a dataset ID, see ListDatasets.

d-lfd60v0p****ujtsdx

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

The request body.

WorkspaceId

string

Yes

The ID of the workspace where the dataset is located. For more information about how to obtain a workspace ID, see ListWorkspaces.

478**

DatasetVersion

string

Yes

The name of the dataset version.

v1

DatasetFileMetas

array

Yes

A list of file metadata content.

DatasetFileMetaContentCreate

No

The details of the file metadata content.

Response elements

Element

Type

Description

Example

object

The request result.

RequestId

string

The request ID.

5A14FA81-DD4E-******-6343FE44B941

Status

boolean

The status of the batch metadata creation. A value of `true` indicates that all records were created successfully. If the value is `false`, check `FailedDetails`.

Valid values:

  • true :

    Success

  • false :

    Failed

true

FailedDetails

array

A list of file metadata records that failed to be created.

DatasetFileMetaResponse

The details of a file metadata record that failed to be created.

SucceedDetails

array

A list of file metadata records that were successfully created.

DatasetFileMetaResponse

The details of a file metadata record that was successfully created.

Examples

Success response

JSON format

{
  "RequestId": "5A14FA81-DD4E-******-6343FE44B941",
  "Status": true,
  "FailedDetails": [
    {
      "DatasetFileMetaId": "07914c9534586e4e7aa6e9dbca5009082df*******8a0d857b33296c59bf6",
      "Result": "Not Found",
      "Uri": "oss://l*****-test/dataset/1653421.jpg"
    }
  ],
  "SucceedDetails": [
    {
      "DatasetFileMetaId": "07914c9534586e4e7aa6e9dbca5009082df*******8a0d857b33296c59bf6",
      "Result": "Not Found",
      "Uri": "oss://l*****-test/dataset/1653421.jpg"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.