赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 百度云
  3. 云服务器 BCC
  4. API参考
  5. 镜像相关接口
  6. 查询镜像详情

查询镜像详情

  • 镜像相关接口
  • 发布于 2025-04-02
  • 0 次阅读
文档编辑
文档编辑

该接口用于根据指定的镜像ID查询单个镜像的详细信息。

请求结构

GET /v{version}/image/{imageId} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
imageId String 是 URL参数 待查询的镜像ID

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
image ImageModel 返回的镜像信息

请求示例

GET /v2/image/m-nky7qeom HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "image": {
        "id": "m-nky7qeom",
        "name": "ubuntu-14.04.1-server-amd64-201506171832",
        "createTime": "2015-06-17T10:37:02Z",
        "osArch": "x86_64 (64bit)",
        "osBuild": "2015061700",
        "osName": "Ubuntu",
        "osType": "linux",
        "osVersion": "14.04.1 LTS",
        "osLang": "ENG",
        "specialVersion": "",
        "type": "System",
        "status": "Available",
        "diskSize": 0,
        "minDiskGb": 10,
        "ephemeralSize": 0,
        "encrypted": false,
        "package": false,
        "desc": ""
    }
}
相关文章

创建自定义镜像 2025-04-02 17:55

该接口用于创建自定义镜像,创建后的镜像可用于创建实例,每个用户单地域最多可拥有20个镜像。 支持通过实例创建和通过快照创建两种方式。 当通过实例创建时,只有 Running 或 Stopped 状态的实例才可以执行成功,否则会提示 409 错误。 仅限通过系统盘快照创建自定义镜像。 当通过快照创建时

查询镜像列表 2025-04-02 17:55

该接口用于查询用户所有的镜像信息。 查询的镜像信息包括公共镜像、自定义镜像和服务集成镜像。 支持按 imageType 来过滤查询,此参数非必需,缺省为 All,即查询所有类型的镜像。 支持按 imageName 来过滤查询镜像,返回名称中包含该字符串的镜像。此参数非必需。 请求结构 GET /v{

查询镜像详情 2025-04-02 17:55

该接口用于根据指定的镜像ID查询单个镜像的详细信息。 请求结构 GET /v{version}/image/{imageId} HTTP/1.1 Host: bcc.bj.baidubce.com Authorization: authorization string

删除自定义镜像 2025-04-02 17:55

该接口用于用户删除指定的自定义镜像,仅限自定义镜像,公共镜像和服务集成镜像不能删除。 imageId 所指定的镜像不存在,提示404错误。 镜像删除后无法恢复,不能再用于创建、重置实例。 请求结构 DELETE /v{version}/image/{imageId} HTTP/1.1 Host: b

共享自定义镜像 2025-04-02 17:55

该接口用于用户共享自己指定的自定义镜像,仅限自定义镜像,公共镜像和服务集成镜像不能共享。 imageId 所指定的镜像不存在,提示404错误。 镜像共享后,被共享的用户可以使用此镜像创建、重置实例。 请求参数中的account和accountId均为可选参数,但不能全部为空,当两个参数同时出现时,服

取消共享自定义镜像 2025-04-02 17:55

该接口用于用户取消共享指定的自定义镜像。 imageId 所指定的镜像不存在,提示404错误。 镜像取消共享后,被取消共享的用户不能再使用此镜像创建、重置实例。 请求参数中的account和accountId均为可选参数,但不能全部为空,当两个参数同时出现时,服务端会自动去重。 请求结构 POST

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号