华为云计算 云知识 更新镜像成员状态(OpenStack原生)GlanceUpdateImageMember
更新镜像成员状态(OpenStack原生)GlanceUpdateImageMember

 

功能介绍

用户接受或者拒绝共享 镜像 时,使用该接口更新镜像成员的状态。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v2/images/{image_id}/members/{member_id}

参数说明请参见表1。
表1 参数说明

参数

是否必选

参数类型

描述

image_id

String

镜像ID

member_id

String

成员ID

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    status

    String

    镜像成员的状态。

    取值如下:

    • accepted:表示接受共享镜像。接受后,该镜像在用户镜像列表中可见,用户可以使用该镜像创建 云服务器
    • rejected:表示拒绝共享镜像。拒绝后,该镜像在用户镜像列表中不可见,但是,用户仍然可以使用该镜像创建云服务器

    vault_id

    String

    存储库ID。

    如果是CBR创建的整机镜像,则在接受该共享镜像时,为必选参数,需传入该值。

    存储库ID可以从 云备份 服务控制台获取,或者参考“查询存储库列表”查询。

请求示例

  • 更新镜像成员状态,其中,镜像状态为“接受共享镜像”。
    PUT https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/edc89b490d7d4392898e19b2deb34797
    
    {
        "status": "accepted"
    }
    
  • 更新通过CBR创建的整机镜像成员状态,其中,镜像状态为“接受共享镜像”,存储库ID为“6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61”。
    PUT https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/edc89b490d7d4392898e19b2deb34797
    
    {
        "status": "accepted",
        "vault_id": "6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61"
    }
    

响应消息

  • 响应参数

    参数

    参数类型

    描述

    status

    String

    共享状态

    created_at

    String

    共享时间,格式为UTC时间

    updated_at

    String

    更新时间,格式为UTC时间

    image_id

    String

    镜像ID

    member_id

    String

    成员ID

    schema

    String

    共享视图

  • 响应样例
    STATUS CODE 200
    {
        "status": "accepted",
        "created_at": "2016-09-01T02:05:14Z",
        "updated_at": "2016-09-01T02:37:11Z",
        "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64",
        "member_id": "edc89b490d7d4392898e19b2deb34797",
        "schema": "/v2/schemas/member"
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

上一篇:fping是什么 下一篇:创建通过VPN访问公网的VPC

镜像服务 IMS

镜像是用于创建服务器或磁盘的模板。镜像服务提供镜像生命周期管理能力。可以通过服务器或外部文件创建系统盘镜像或数据盘镜像,也可以使用弹性云服务器或云服务器备份创建带数据盘的整机镜像。创建镜像功能免费,仅需支付使用对象存储服务或云服务器备份的费用。