All Products
Search
Document Center

Platform For AI:UpdateDatasetFileMetas

Last Updated:Oct 20, 2025

Updates multiple file metadata records in a dataset.

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

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

Path Parameters

Parameter

Type

Required

Description

Example

DatasetId

string

Yes

The ID of the dataset. For more information, see ListDatasets.

d-lfd60v0p****ujtsdx

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

The request body.

DatasetVersion

string

No

The name of the dataset version.

v1

WorkspaceId

string

No

The ID of the workspace that contains the dataset. For more information, see ListWorkspaces.

796**

DatasetFileMetas

array

Yes

A list of dataset file metadata to update.

DatasetFileMetaConentUpdate

No

The details of the file metadata to update.

TagJobId

string

No

The ID of the tagging job for updating metadata tags.

dsjob-hv0b1****u8taig3y

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 update. A value of `true` indicates that all updates succeeded. If the value is `false`, check the `FailedDetails` parameter.

true

FailedDetails

array

A list of file metadata that failed to be updated.

DatasetFileMetaResponse

The details of the file metadata that failed to be updated.

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"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.