GPU操作指南
API接口文档
获取自制镜像列表

获取自制镜像列表-DescribeCompShareCustomImages

获取自制镜像列表

Request Parameters

Parameter nameTypeDescriptionRequired
Regionstring地域。 参见 地域和可用区列表 (opens in a new tab)Yes
Zonestring可用区。参见 可用区列表 (opens in a new tab)Yes
ProjectIdstring项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口 (opens in a new tab)No
CompShareImageIdstring指定镜像Id查询No
Offsetint列表起始位置偏移量,默认为0No
Limitint返回数据长度,默认为20,最大100No

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint返回码Yes
Actionstring操作名称Yes
ImageSetarray镜像详情信息Yes
TotalCountint总数量No

CompShareImage

Parameter nameTypeDescriptionRequired
CompShareImageIdstring镜像IdNo
Namestring镜像名称No
Authorstring镜像作者昵称No
AuthInfoint镜像作者认证信息No
ImageOwnerAliasstring镜像来源。- Official 平台镜像;- Community 社区镜像No
ImageTypestring镜像类型。- System 平台提供的公共镜像;- App 平台提供的应用镜像;- Custom 自制镜像;- Community 社区镜像No
IsOfficialbool来源是否为官方镜像【仅自制镜像信息返回该字段】No
Containerstring是否为容器镜像。- True 容器镜像- False 虚机镜像No
Statusstring镜像状态。- Making 制作中;- Available 可用;- UnAvailable 不可用;- Reviewing 审核中;- Offline 已下线No
Sizeint镜像大小。单位MBNo
Visibilityint可见性。0:私密镜像;1:公开至镜像社区No
Descriptionstring镜像描述信息No
Tagsarray【array of string】镜像标签No
Pricefloat镜像价格。单位:元No
Coverstring镜像封面URLNo
Readmestring镜像详细描述。仅指定镜像Id查询时返回No
Softwaresobject镜像软件信息No
CreatedCountint镜像引用创建计数No
FavoritesCountint镜像收藏计数No
FailedReasonstring镜像制作失败错误原因No
CreateTimeint创建时间戳No
PubTimeint发布时间戳No
Ownerobject镜像所属账号信息No
GroupIdstring镜像组idNo
VersionNamestring版本名称No
VersionDescstring版本描述No
SourceGpuTypestring自制镜像来源机型No
AutoStartbool是否支持自启动 default:falseNo
ImageChargebool是否镜像收费 default: falseNo
ImageUseTimeint镜像使用时长No

Software

Parameter nameTypeDescriptionRequired
Frameworkstring框架名称No
FrameworkVersionstring框架版本No
CUDAVersionstringCUDA版本No
Applicationsarray【array of string】应用列表No

Projects

Parameter nameTypeDescriptionRequired
AccountNamestring账号昵称No
AccountIdstring账号IdNo

Request Example

https://api.ucloud.cn/?Action=DescribeCompShareCustomImages
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=GSIKgudm
&CompShareImageId=ECyEnJbe
&Offset=2
&Limit=2

Response Example

{
    "Action": "DescribeCompShareCustomImagesResponse", 
    "ImageSet": [
        {
            "Status": "hlqtbVJG", 
            "Name": "nFmURawE", 
            "Author": "CpKmKtmy", 
            "CreatedCount": "DQIOscsN", 
            "CompShareImageId": "hjNwBATq", 
            "Tags": [
                "PbbXTujk"
            ], 
            "Cover": "PFuhwZhm", 
            "Visibility": 2, 
            "CreateTime": "IFXxRGPj", 
            "AuthInfo": 6, 
            "FavoritesCount": "hnuFiuwm", 
            "ImageOwnerAlias": "xWXjOYVE", 
            "Readme": "ufXKfxWg", 
            "Description": "yXiGjmEh", 
            "PubTime": "kkupHyrZ", 
            "Price": 9.99592, 
            "ImageType": "AeSmLeoE", 
            "Size": 4
        }
    ], 
    "RetCode": 0, 
    "TotalCount": 4
}
Copyright © 2026 沪ICP备12020087号-61