素材组 Action
更新素材组
火山文档原文UpdateAssetGroup - 更新素材组名称或描述
AuthorizationBearer <token>
兼容网关 API Key，例如 sk-...。
In: header
Query Parameters
Action*string
Default
"UpdateAssetGroup"Version*string
Default
"2024-01-01"Header Parameters
X-Date?string
使用 HMAC-SHA256 时必填，格式为 YYYYMMDDTHHMMSSZ。
X-Content-Sha256?string
使用 HMAC-SHA256 时必填，请求体 SHA-256 小写十六进制。
Request Body
application/json
Id*string
需要更新的素材组 ID。
Name?string
Length
length <= 64Description?string
Length
length <= 300ProjectName?string
资源所属项目名称，大小写敏感。省略时使用 default。
Default
"default"Response Body
application/json
application/json
curl -X POST "https://jieyun.cc/?Action=UpdateAssetGroup&Version=2024-01-01" \ -H "Content-Type: application/json" \ -d '{ "Id": "group-202607210001-example", "Name": "产品素材（新版）", "Description": "更新后的描述", "ProjectName": "default" }'{
"ResponseMetadata": {
"RequestId": "20260721000000000000000000000000",
"Action": "UpdateAssetGroup",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Id": "group-202607210001-example"
}
}{
"ResponseMetadata": {
"RequestId": "string",
"Action": "UpdateAssetGroup",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing",
"Error": {
"Code": "string",
"Message": "string"
}
}
}Empty
Empty
Empty
Empty
接口说明
更新单个素材组的名称或描述。当前不支持修改 GroupType 或把素材组移动到其他项目。本文档已按火山引擎官方接口说明校对。
POST https://jieyun.cc/?Action=UpdateAssetGroup&Version=2024-01-01
Content-Type: application/json
Authorization: Bearer <API_KEY>也可使用 AK/SK HMAC-SHA256 签名，详见素材库认证与签名。
请求参数
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
Id | string | 是 | 需要更新的素材组 ID。 |
Name | string | 否 | 新名称，最长 64 个字符。 |
Description | string | 否 | 新描述，最长 300 个字符。 |
ProjectName | string | 否 | 素材组所属项目，默认 default，大小写敏感。 |
Name 和 Description 至少应提供一个。
{
"Id": "group-2026-example",
"Name": "新素材组名称",
"Description": "更新后的素材组描述",
"ProjectName": "default"
}响应内容
成功响应的 Result.Id 为已更新的素材组 ID。
{
"Result": {
"Id": "group-2026-example"
}
}