Dataset

更新时间:
复制 MD 格式

A Dataset is a unit in the new version of MetaQuery that serves as a logical group for metadata within a single bucket. A bucket can have multiple Datasets, each with its own metadata, AI content awareness configuration (DatasetConfig), and a dedicated query endpoint. This design lets you isolate and manage file metadata by service, device, or scenario within the same bucket. This topic describes the structure of Dataset metadata, which is returned in the responses of API operations such as GetDataset and ListDatasets.

Parameter

Type

Required

Example

Description

Dataset

container

Yes

N/A

A container for Dataset metadata.

Child nodes: DatasetName, Description, CreateTime, UpdateTime, WorkflowParameters, DatasetConfig, DatasetMaxFileCount, DatasetMaxEntityCount, DatasetMaxRelationCount, DatasetMaxTotalFileSize, FileCount, TotalFileSize

DatasetName

String

Yes

photos-2026

The name of the Dataset.

Parent node: Dataset

Description

String

No

Photo library for 2026

The description of the Dataset.

Parent node: Dataset

CreateTime

String

Yes

2026-05-20T08:00:00.000+08:00

The time when the Dataset was created, in RFC 3339 format.

Parent node: Dataset

UpdateTime

String

Yes

2026-05-20T08:30:00.000+08:00

The time when the Dataset configuration was last updated, in RFC 3339 format.

Parent node: Dataset

WorkflowParameters

container

No

N/A

A container for workflow parameters. It returns the basic AI content awareness switches configured during creation or updates to ensure backward compatibility. For new features, use DatasetConfig.

Child node: WorkflowParameter

Parent node: Dataset

WorkflowParameter

container

No

N/A

A container for a single workflow parameter.

Child nodes: Name, Value

Parent node: WorkflowParameters

Name

String

No

VideoInsightEnable

The name of the workflow parameter. Valid values:

  • VideoInsightEnable: Enables AI content awareness for videos.

  • ImageInsightEnable: Enables AI content awareness for images.

  • UserDefinedLabelsEnable: Enables user-defined labels.

Parent node: WorkflowParameter

Value

String

No

True

The value of the workflow parameter. Valid values:

  • True: Enabled

  • False: Disabled

Parent node: WorkflowParameter

DatasetConfig

container

No

N/A

A container for Dataset-level configurations. It returns the detailed AI content awareness options and smart grouping rules configured for the Dataset. For details about the fields, see the DatasetConfig data structure.

Parent node: Dataset

DatasetMaxFileCount

Integer

Yes

100000000

The maximum number of files allowed in the Dataset.

Parent node: Dataset

DatasetMaxEntityCount

Integer

Yes

10000000000

The maximum number of entities (objects identified by image recognition) allowed in the Dataset.

Parent node: Dataset

DatasetMaxRelationCount

Integer

Yes

100000000000

The maximum number of relationships between entities allowed in the Dataset.

Parent node: Dataset

DatasetMaxTotalFileSize

Integer

Yes

90000000000000000

The maximum total size of all files in the Dataset, in bytes.

Parent node: Dataset

FileCount

Integer

No

3456

The total number of files currently indexed in the Dataset. The GetDataset operation returns this value only when withStatistics=true.

Parent node: Dataset

TotalFileSize

Integer

No

10737418240

The total size in bytes of all indexed files in the Dataset. This value is returned by the GetDataset API only when withStatistics=true.

Parent node: Dataset