GPU服务API文档
实例镜像
更新镜像信息

UpdateCompShareImage — 更新镜像信息

接口说明

更新自制镜像或社区镜像的名称、描述、标签、端口等元信息。


请求参数

名称类型必填描述示例值
ActionString接口名称UpdateCompShareImage
RegionString地域cn-wlcb
CompShareImageIdString镜像 IDcompshareImage-xxxx
GroupIdString版本组 IDgroup-xxxx
NameString镜像名称my-updated-env
DescriptionString镜像描述更新了CUDA版本
VisibilityInteger可见性。0:私有,1:公开0
PriceFloat价格(元/小时)。公开时需设置,0 为免费0
CoverString封面图(Base64 编码)
ReadmeString使用说明(富文本)
TagsArray of String标签列表["深度学习","PyTorch"]
VersionNameString版本名称v2.0
VersionDescString版本描述升级PyTorch到2.1
SupportedGpuTypesArray of String支持的 GPU 类型列表["4090","A100"]
AutoStartBoolean是否支持自启动true

响应参数

名称类型描述示例值
ActionString响应名称UpdateCompShareImageResponse
RetCodeInteger返回码,0 为成功0

请求示例

Python(使用 UCloud SDK)

from ucloud.core import exc
from ucloud.client import Client
 
 
def main():
    client = Client({
        "region": "cn-wlcb",
        "public_key": "my_public_key",    # 替换为你的公钥,从 https://console.compshare.cn/uaccount/api_manage 获取
        "private_key": "my_private_key",   # 替换为你的私钥
        "base_url": "https://api.compshare.cn",
    })
 
    try:
        resp = client.ucompshare().update_comp_share_image({
            "CompShareImageId": "compshareImage-xxxx",  # 镜像 ID,通过 DescribeCompShareImages 获取
            "Name": "my-updated-env",
            "Tags": ["深度学习", "PyTorch"],
        })
        print("更新成功")
    except exc.UCloudException as e:
        print(e)
 
 
if __name__ == "__main__":
    main()

Go(使用 UCloud SDK)

package main
 
import (
	"fmt"
 
	"github.com/ucloud/ucloud-sdk-go/services/ucompshare"
	"github.com/ucloud/ucloud-sdk-go/ucloud"
	"github.com/ucloud/ucloud-sdk-go/ucloud/auth"
)
 
func main() {
	cfg := ucloud.NewConfig()
	cfg.Region = "cn-wlcb"
	cfg.BaseUrl = "https://api.compshare.cn"
 
	credential := auth.NewCredential()
	credential.PublicKey = "my_public_key"   // 替换为你的公钥,从 https://console.compshare.cn/uaccount/api_manage 获取
	credential.PrivateKey = "my_private_key" // 替换为你的私钥
	client := ucompshare.NewClient(&cfg, &credential)
 
	req := client.NewUpdateCompShareImageRequest()
	req.CompShareImageId = ucloud.String("compshareImage-xxxx") // 镜像 ID,通过 DescribeCompShareImages 获取
	req.Name = ucloud.String("my-updated-env")
 
	_, err := client.UpdateCompShareImage(req)
	if err != nil {
		fmt.Printf("更新失败: %s\n", err)
		return
	}
	fmt.Println("更新成功")
}

响应示例

{
  "Action": "UpdateCompShareImageResponse",
  "RetCode": 0
}
Copyright © 2026 沪ICP备12020087号-61