UpdateDataset-对象存储(OSS)-阿里云帮助中心

调用 UpdateDataset 接口更新指定 Dataset 的 description、datasetConfig 等配置。

注意事项

阿里云账号默认拥有更新 Dataset 的权限。如需通过 RAM 用户更新,请确保 RAM 用户拥有 oss:MetaQuery 权限。
调用本接口前,Bucket 必须已通过 OpenMetaQuery 开启元数据管理,且指定 Dataset 已存在。
更新仅对调用之后新索引的 Object 生效;已索引的 Object 不会回填重算。如需对历史数据重算,请先调用 DeleteFileMeta 清理对应文件的元数据,再重新写入触发索引。
仅显式传入的参数会被更新,未传入的字段保持原值。
description、workflowParameters、datasetConfig 三者至少传入一个,否则返回 InvalidArgument。
请求体为空。所有可更新字段均通过 URL Query Parameter 传入。
WorkflowParameters 为兼容旧版本的基础工作流开关。后续 AI 内容感知新能力不再通过该字段演进,新接入建议使用 datasetConfig。

请求语法

POST /?metaQuery&action=updateDataset&datasetName=DatasetName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

请求元素

名称	类型	是否必选	示例值	描述
datasetName	字符串	是	videos-en	待更新的 Dataset 名称。
description	字符串	否	新描述	新的 Dataset 描述文本。包含非 ASCII 字符时需 URL 编码。长度不超过 256 字符。
workflowParameters	WorkflowParameter 数组	否	[{"Name":"ImageInsightEnable","Value":"False"}]	兼容旧版本 AI 内容感知基础开关。通过 URL Query String 传递时需 JSON 序列化并 URL 编码。后续新功能不再通过该字段演进,推荐使用 `datasetConfig`。子节点:WorkflowParameter
WorkflowParameter	容器	否	不涉及	单个工作流参数配置。子节点:Name、Value 父节点:workflowParameters
Name	字符串	是	ImageInsightEnable	工作流参数名。可选值:VideoInsightEnable、ImageInsightEnable、UserDefinedLabelsEnable。父节点:WorkflowParameter
Value	字符串	是	False	工作流参数取值。取值 True / False。父节点:WorkflowParameter
datasetConfig	DatasetConfig 对象	否	{"Insights":{"Language":"pt"}}	覆盖原有的 Dataset 级配置。通过 URL Query String 传递时需 JSON 序列化并 URL 编码。字段结构与 DatasetConfig 数据结构一致。子节点:Insights、ReverseImage、SmartCluster

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。

响应元素

名称

类型

是否必选

示例值

描述

UpdateDatasetResponse

容器

是

不涉及

接口响应的根容器。

子节点:Dataset

Dataset

容器

是

不涉及

更新后的 Dataset 完整信息。详细字段见 Dataset 数据结构。

父节点:UpdateDatasetResponse

示例

请求示例

将 Dataset videos-en 的 Insights 语言从 en 改为 pt:

POST /?metaQuery&action=updateDataset&datasetName=videos-en&datasetConfig=%7B%22Insights%22%3A%7B%22Language%22%3A%22pt%22%7D%7D HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 May 2026 09:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260520/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

兼容旧版本的 workflowParameters 更新示例。该方式仅用于存量基础开关,后续新功能不再通过 workflowParameters 演进:

POST /?metaQuery&action=updateDataset&datasetName=videos-basic&workflowParameters=%5B%7B%22Name%22%3A%22VideoInsightEnable%22%2C%22Value%22%3A%22False%22%7D%5D HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 May 2026 09:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260520/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

workflowParameters 参数 URL 解码后:

[
  {"Name": "VideoInsightEnable", "Value": "False"}
]

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 64C8B6F4E7C5A3A8B9D6E7F3
Date: Wed, 20 May 2026 09:00:01 GMT
Content-Type: application/xml
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<UpdateDatasetResponse>
  <Dataset>
    <DatasetName>videos-en</DatasetName>
    <Description>新描述</Description>
    <CreateTime>2026-05-20T08:00:00.000+08:00</CreateTime>
    <UpdateTime>2026-05-20T09:00:00.000+08:00</UpdateTime>
    <DatasetMaxFileCount>100000000</DatasetMaxFileCount>
    <DatasetMaxEntityCount>10000000000</DatasetMaxEntityCount>
    <DatasetMaxRelationCount>100000000000</DatasetMaxRelationCount>
    <DatasetMaxTotalFileSize>90000000000000000</DatasetMaxTotalFileSize>
    <DatasetConfig>
      <Insights>
        <Language>pt</Language>
      </Insights>
    </DatasetConfig>
  </Dataset>
</UpdateDatasetResponse>