更新资产 - UpdateAsset

功能介绍

更新资产接口用于在ModelArts平台上修改指定资产的属性信息，包括资产名称、描述、系列、能力、启用状态、标签及自定义属性等。

该接口适用于以下场景：当用户需要修改已有资产的元数据信息或调整资产状态时，可以通过此接口进行更新。使用该接口的前提条件是用户已具备项目访问权限，并已知目标资产的ID。平台将在校验资产存在性及归属权限后将更新应用到目标资产及其同组资产上。若资产不存在、为预置资产不可修改或用户无权限操作，接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

PUT /v2/{project_id}/assets/{asset_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：华为云项目ID，[获取项目ID]在ModelArts Studio任意页面，按F12进入开发者工具，刷新页面，在开发者工具Network页签找到/rest/me接口，从此接口的response里找到project_id字段。约束限制：1-64字符，英文字母，数字，下划线，中划线。取值范围：不涉及。默认取值：不涉及。
asset_id	是	String	参数解释：资产id。约束限制：1-36字符，英文字母，数字，下划线，中划线。取值范围：不涉及。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
workspace_id	否	String	参数解释：工作空间ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。约束限制：1-32字母，数字。取值范围：不涉及。默认取值：不涉及。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token]调用IAM的/v3/auth/tokens，在接口响应消息头中X-Subject-Token的值即为Token。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表4 请求Body参数
参数	是否必选	参数类型	描述
asset_name	否	String	参数解释：资产名称。约束限制：2-128位字符，只包含中文、字母、数字、中划线、下划线，且以中文、字母开头，以中文、字母、数字结尾名称。取值范围：不涉及。默认取值：不涉及。
asset_desc	否	String	参数解释：资产描述。约束限制：0-256位字符。取值范围：不涉及。默认取值：不涉及。
asset_group_desc	否	String	参数解释：资产组描述。约束限制：0-256位字符。取值范围：不涉及。默认取值：不涉及。
asset_series	否	String	参数解释：资产品牌，例如DeepSeek,Qwen,Wan,GPT,Llama,GLM,ERNIE,Mistral,Kimi,Other。约束限制：1-40位字符。取值范围：不涉及。默认取值：不涉及。
asset_capabilities	否	Array of strings	参数解释：资产能力，例如TextGeneration,ImageUnderstanding,ImageGeneration,VideoGeneration,AgenticRL,Other。约束限制：1-40位字符。
status	否	String	参数解释：数据集资产的上下线状态。约束限制：不涉及。取值范围：枚举值： online：上线 offline：下线 waiting: 等待中默认取值：不涉及。
enabled	否	Boolean	参数解释：资产是否可用。约束限制：不涉及。取值范围： true：可用 false：不可用默认取值：不涉及。
is_deleted	否	Boolean	参数解释：数据集资产是否被软删除。约束限制：不涉及。取值范围： true：可用 false：不可用默认取值：不涉及。
tags	否	map<string, object>	参数解释：资产tag。约束限制：不涉及。
properties	否	Properties object	参数解释：数据集资产扩展信息。约束限制：不涉及。

表5 Properties
参数	是否必选	参数类型	描述
dataset_num	否	Integer	参数解释：数据集的条数。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
dataset_size	否	Long	参数解释：数据集资产资源文件总大小。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
prompt_config	否	String	参数解释：数据集资产评测模版相对地址。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
data_copyright	否	String	参数解释：数据集资产版权信息，包含数据集信息，License和地址。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
manifest_file_path	否	String	参数解释：数据集资产索引文件地址。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
arguments	否	Array of OperatorArgument objects	参数解释：算子参数列表。约束限制：不涉及。
updater	否	String	参数解释：数据集资产修改人信息。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
{自定义key}	是	map<string, *>

表6 OperatorArgument
参数	是否必选	参数类型	描述
key	是	String	参数键
name	是	String	参数名称
type	是	String	参数类型
tips	否	String	参数说明
min	否	Float	参数最小值，数值型参数必填
max	否	Float	参数最大值，数值型参数必填
between	否	Boolean	是否为区间型数值
items	否	Array of OperatorArgItem objects	参数选项列表
default_value	否	String	参数默认值，用户不可见且必填的参数必须提供默认值
required	否	Boolean	参数是否必填，默认false
visible	否	Boolean	该参数界面是否展示给用户配置，默认true
arg_display_type	否	String	参数前端组件类型
task_category	否	Array of strings	数据集支持的任务类型，type为dataset时可用
dataset_catalog	否	Array of strings	数据集来源，type为dataset时可用
asset_types	否	String	资产类型,type为large_model时可用,多个以","分隔
asset_codes	否	String	资产代码,type为large_model时可用,多个以","分隔
sub_asset_type	否	String	模型的子资产类型,type为large_model时可用
depend_args	否	Array of DependArg objects	当前参数所依赖的其他参数信息列表

表7 OperatorArgItem
参数	是否必选	参数类型	描述
name	是	String	参数名
value	是	String	参数值
tips	否	String	参数说明

表8 DependArg
参数	是否必选	参数类型	描述
key	是	String	依赖的参数key值
value	是	String	依赖的参数value值,多个值用","分隔

响应参数

状态码：200

表9 响应Body参数
参数	参数类型	描述
asset_id	String	参数解释：资产id。取值范围：不涉及。
parent_asset_id	String	参数解释：父资产id。取值范围：不涉及。
root_asset_id	String	参数解释：根资产id。取值范围：不涉及。
api_version	String	参数解释：资产API版本。取值范围：v1,v2。
asset_name	String	参数解释：资产名称。取值范围：不涉及。
asset_group_id	String	参数解释：需要加入的资产组id。取值范围：0-36位字符，已存在的组id。
workspace_id	String	参数解释：工作空间ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。取值范围：1-32位字母，数字。
asset_type	String	参数解释：资产类型。取值范围：枚举值： TEMPLATE: 模板资产 DATASET: 数据集资产 WORKFLOW: 工作流资产 IMAGE: 镜像资产 ALGORITHM：算法资产 MODEL: 模型资产 DATASET_TEMPLATE: 数据集模板资产
sub_asset_type	String	参数解释：资产子类型。取值范围：不涉及。
asset_desc	String	参数解释：资产描述。取值范围：0-256位字符。
asset_code	String	参数解释：资产code。取值范围：1-60字符，英文字母，数字，中划线，下划线，点。
asset_version	String	参数解释：资产版本。取值范围：数字或格式为x.y.z，x,y,z为数字。
tags	map<string, object>	参数解释：资产tag。取值范围：不涉及。
support_actions	Array of strings	参数解释：资产支持的操作列表，例如监督微调:SFT,LORA微调:LORA,在线部署:ONLINE-DEPLOY,强化学习:AgenticRL。
asset_location	String	参数解释：资产文件存储地址。取值范围：0-1024位字符。
actions	Array of AssetActionRsp objects	参数解释：资产可执行操作详情配置。
status	String	参数解释：资产状态。取值范围：枚举值: online: 上线 offline: 下线 waiting: 等待中
dataset_usage	String	参数解释：数据集用途。取值范围：1-40位字符。
dataset_file_formats	Array of strings	参数解释：数据集存储格式，例如JSONL，TXT，MOBI，EPUB，DOCX，PDF。
dataset_type	String	参数解释：数据集模态划分，如音频。取值范围：1-40位字符。
dataset_sub_type	String	参数解释：数据集模态细分值，如语义分割。取值范围：1-40位字符。
dataset_schema_format	String	参数解释：数据集逻辑规范，如盘古格式。取值范围：1-40位字符。
{自定义key}	map<string, *>

**表10** AssetActionRsp
参数	参数类型	描述
action_type	String	参数解释：资产action类型。取值范围：不涉及。
action_dir	String	参数解释：资产action配置文件地址。取值范围：不涉及。
{自定义key}	map<string, *>

请求示例

https://{endpoint}/v2/{project_id}/assets/{asset_id}

{
  "asset_name" : "Qwen3-8B-SFT-update",
  "asset_desc" : "Qwen3-8B精调模型，并对模型详情做了更新。",
  "asset_group_desc" : "Qwen3-8B的一批精调模型。",
  "asset_series" : "Qwen",
  "asset_capabilities" : [ "TextGeneration" ]
}

响应示例

状态码：200

{
  "asset_name" : "Pangu-AIKits-ImageSearch-Large-Tagging",
  "external_version" : "1.0.0",
  "asset_desc" : "Pangu-AI Kits-ImageSearch-Large-Tagging模型在MA Studio上首次支持。",
  "asset_version" : "0.1.7",
  "category" : "pangu",
  "storage_type" : "OBS",
  "asset_location" : "Pangu-AIKits-ImageSearch-Large-Tagging/0.1.7/models",
  "asset_type" : "ImageSearch",
  "sub_asset_type" : "",
  "asset_code" : "Pangu-AIKits-ImageSearch-Large-Tagging",
  "asset_source" : "Preset",
  "asset_tag" : "PRETRAIN，SFT",
  "security_policy" : "SCCBase64",
  "encode_type" : "BASE64",
  "asset_series" : "AIKits",
  "asset_scenes" : [ "ImageSearch" ]
}

状态码

状态码	描述
200	更新资产

错误码

请参见错误码。

父主题： 资产中心API

上一篇：查询资产详情 - ShowAsset

下一篇：删除资产 - DeleteAsset