[同步] 获取公有云公共镜像

localhost

http://localhost:8080

POST

/api/v1/imageTbl/list/public

获取某个region下公共镜像列表信息。

请求参数

Body 参数application/json

cloudCredentialInfo

object (codeup_aliyun_com_644a10bf88aef0db4b8c1edc_uci_puhui-uci_pkg_types.CloudProviderParams)

可选

accessKey

string

必需

身份验证 AccessKey

accountId

string

可选

用于百度云 // 服务商地址，用于私有云

hypervisor

string

用于轻量云

可选

provider

enum<string>

可选

云服务商，枚举类型 Aliyun、Qcloud

枚举值:

AliyunQcloudAwsHuaweiBaiduCfelCloudpodsEscrowEcloudCfelCtyunVolcEngineChinaUnionCfel

secretKey

string

必需

身份验证 SecretKey

url

string

可选

服务商地址，用于私有云

data

object (codeup_aliyun_com_644a10bf88aef0db4b8c1edc_uci_puhui-uci_pkg_types.ListCloudImagesOptions)

可选

bareMetal

boolean

是否为裸金属镜像

可选

env

enum<string>

必需

调用方对应环境参数, 如果需要为某个环境启用某个镜像，需要为镜像打上对应的tag
例如 daily环境启用 ubuntu2204 镜像，需要为该镜像打上 tag >> daily:true

枚举值:

dailylocalproduct

externalId

string

可选

实力规格，不传则返回所有镜像，传了则返回该实力规格可用镜像

instanceTypeInfo

object

实例规格信息

可选

regionId

string

region id

必需

示例

{
    "cloudCredentialInfo": {
        "accessKey": "string",
        "accountId": "string",
        "hypervisor": "string",
        "provider": "Aliyun",
        "secretKey": "string",
        "url": "string"
    },
    "data": {
        "bareMetal": true,
        "env": "daily",
        "externalId": "string",
        "instanceTypeInfo": {
            "category": "string",
            "gpuCount": 0,
            "gpuVendorDevice": "string",
            "instanceType": "string",
            "interfaceManagement": 0,
            "interfaceService": 0,
            "localDataDiskCount": 0,
            "localDataDiskVendorDevice": "string",
            "nicVendorDevice": "string",
            "sysDiskCount": 0,
            "sysDiskRaid": "string",
            "sysDiskStorageType": "string",
            "vcpuCount": 0,
            "vmemSize": 0
        },
        "regionId": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8080/api/v1/imageTbl/list/public' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cloudCredentialInfo": {
        "accessKey": "string",
        "accountId": "string",
        "hypervisor": "string",
        "provider": "Aliyun",
        "secretKey": "string",
        "url": "string"
    },
    "data": {
        "bareMetal": true,
        "env": "daily",
        "externalId": "string",
        "instanceTypeInfo": {
            "category": "string",
            "gpuCount": 0,
            "gpuVendorDevice": "string",
            "instanceType": "string",
            "interfaceManagement": 0,
            "interfaceService": 0,
            "localDataDiskCount": 0,
            "localDataDiskVendorDevice": "string",
            "nicVendorDevice": "string",
            "sysDiskCount": 0,
            "sysDiskRaid": "string",
            "sysDiskStorageType": "string",
            "vcpuCount": 0,
            "vmemSize": 0
        },
        "regionId": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

content

object

可选

return data

resources

array[object (codeup_aliyun_com_644a10bf88aef0db4b8c1edc_uci_puhui-uci_pkg_model.CloudImage) {19}]

可选

errorCode

string

失败 code

可选

errorMsg

string

失败信息

可选

msg

string

响应信息，ok

可选

success

boolean

是否操作成功

可选

示例

{
    "content": {
        "resources": [
            {
                "bios": "string",
                "canInstallGpuDriver": true,
                "creationTime": "string",
                "description": "string",
                "fullOsName": "string",
                "imageFormat": "string",
                "imageId": "string",
                "imageType": "system",
                "minOsDiskSizeGb": 0,
                "minRamSizeMb": 0,
                "name": "string",
                "osArch": "string",
                "osDist": "string",
                "osLang": "string",
                "osName": "string",
                "osType": "Linux",
                "osVersion": "string",
                "sizeByte": 0,
                "status": "init"
            }
        ]
    },
    "errorCode": "string",
    "errorMsg": "string",
    "msg": "string",
    "success": true
}

修改于 2025-04-17 10:22:13

根据id获取镜像

上传镜像