接口功能介绍

在您将 1 份私有镜像共享给其他用户之后，此接口可用于查询该私有镜像的共享列表。准备：
1. 在调用前需了解如何构造请求，可参见：如何调用 API - 构造请求
2. OpenAPI 请求需进行加密调用，可参见：如何调用 API - 认证鉴权
注意：
1. 若需要查询您的共享镜像（其他用户共享给您），则可使用查询可以使用的镜像资源接口
2. 在调用前，请您认真阅读此文档，包括但不限于参数描述中的“注意”部分

接口约束

接口请求成功需至少满足：
1. 您具有调用此接口的权限
2. 传入的有取值范围的参数的值在取值范围内
3. 传入的 imageID 参数所指定的镜像对您而言是存在的
4. 传入的 regionID 参数所指定的资源池对您而言是存在的

URI

GET /v4/image/show-shared-list

路径参数
无

Query参数

请求参数

请求头header参数
无

请求体body参数
无

响应参数

表 returnObj

表 image

枚举参数

参数名 imageIntegrityCheckStatus

参数名 imageStatus

请求示例

请求url

示例 1：若您在华东 1 有 1 份 ID 为 8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa 的私有镜像，则可参考如下形式查询第 1 页（每页最多 10 份镜像）共享列表。
GET .../v4/image/show-shared-list?imageID=8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa&regionID=bb9fdb42056f11eda1610242ac110002

示例 2：若您在华东 1 有 1 份 ID 为 8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa 的私有镜像，则可参考如下形式查询第 2 页（每页最多 20 份镜像）共享列表。
GET .../v4/image/show-shared-list?imageID=8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa&pageNo=2&pageSize=20&regionID=bb9fdb42056f11eda1610242ac110002

请求头header

无

请求体body

无

响应示例

{
  "returnObj": {
    "images": [
      {
        "appVersion": null,
        "architecture": "x86_64",
        "azName": null,
        "bootMode": "bios",
        "chargeableImage": false,
        "containerFormat": null,
        "createdTime": 1698145871,
        "createdTimeStr": "2023-10-24T11:11:11Z",
        "cwaiType": null,
        "description": "Test CTyunOS",
        "destinationAccountID": "8888f88ee8888fddbdb888bef888e8fe",
        "destinationUser": "test@test.com",
        "diskFormat": null,
        "diskID": null,
        "diskSize": 40,
        "enableImageIntegrityCheck": false,
        "fullECSDiskSize": null,
        "gpuImageCategory": null,
        "hasAcceptedSharedImages": null,
        "imageClass": "ECS",
        "imageDisplayName": null,
        "imageID": "8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa",
        "imageIntegrityCheckStatus": null,
        "imageName": "CTyunOS-test",
        "imageScene": null,
        "imageShareCount": null,
        "imageSize": null,
        "imageSource": "cloud_server",
        "imageStatus": "waiting",
        "imageSubcategory": null,
        "imageType": null,
        "imageVisibility": "shared",
        "maximumRAM": 0,
        "minimumRAM": 0,
        "osDistro": "CTyunOS",
        "osType": "linux",
        "osVersion": "23.01",
        "projectID": null,
        "sourceAccountID": "a88fc8888a8a8b8e8f8888888d888ed8",
        "sourceServerID": null,
        "sourceUser": "ims-test@test.com",
        "supportOneClickSFSMount": false,
        "supportXSSD": false,
        "taskID": null,
        "updatedTime": 1698145871,
        "updatedTimeStr": "2023-10-24T11:11:11Z"
      }
    ],
    "currentPage": 1,
    "pageNo": 1,
    "currentCount": 1,
    "pageSize": 1,
    "totalPage": 1,
    "totalCount": 1
  },
  "errorCode": "",
  "message": "SUCCESS",
  "description": "成功",
  "statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码