# 更新资产 - UpdateAsset #### 功能介绍 更新资产接口用于在ModelArts平台上修改指定资产的属性信息，包括资产名称、描述、系列、能力、启用状态、标签及自定义属性等。 该接口适用于以下场景：当用户需要修改已有资产的元数据信息或调整资产状态时，可以通过此接口进行更新。使用该接口的前提条件是用户已具备项目访问权限，并已知目标资产的ID。平台将在校验资产存在性及归属权限后将更新应用到目标资产及其同组资产上。若资产不存在、为预置资产不可修改或用户无权限操作，接口将返回相应的错误信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=UpdateAsset)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，当前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字符，英文字母，数字，下划线，中划线。 **取值范围**：不涉及。 **默认取值**：不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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\ | **参数解释**：资产tag。 **约束限制**：不涉及。 | | properties | 否 | [Properties] object | **参数解释**：数据集资产扩展信息。 **约束限制**：不涉及。 | 表5Properties | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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\ | | 表6OperatorArgument | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 当前参数所依赖的其他参数信息列表 | 表7OperatorArgItem | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | 参数名 | | value | 是 | String | 参数值 | | tips | 否 | String | 参数说明 | 表8DependArg | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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\ | **参数解释**：资产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\ | | 表10AssetActionRsp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | action_type | String | **参数解释**：资产action类型。 **取值范围**：不涉及。 | | action_dir | String | **参数解释**：资产action配置文件地址。 **取值范围**：不涉及。 | | {自定义key} | map\ | | #### 请求示例 ``` 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 | 更新资产 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。