更新时间:2022-02-22 GMT+08:00

查询云硬盘过户记录列表概要

功能介绍

查询当前租户下所有云硬盘的过户记录列表。

URI

  • URI格式

    GET /v2/{project_id}/os-volume-transfer

  • 参数说明

    参数

    是否必选

    描述

    project_id

    项目ID。

    获取方法请参见获取项目ID

  • Request filter参数说明

    参数

    参数类型

    是否必选

    描述

    limit

    Integer

    返回结果个数限制。

    最小值1,最大值1000,默认为1000。返回的结果中记录数不超过limit值。

    offset

    Integer

    偏移量,偏移量为一个大于0小于云硬盘过户记录总个数的整数,表示查询该偏移量后面的所有的云硬盘过户记录。

请求消息

以查询云硬盘过户记录的返回结果最大50个为例。

  • 请求样例
    GET https://{endpoint}/v2/{project_id}/os-volume-transfer?limit=50

响应消息

  • 响应参数

    参数

    参数类型

    描述

    transfers

    List<Transfer>

    云硬盘过户记录列表概要,请参见•transfers参数说明

  • transfers参数说明

    参数

    参数类型

    描述

    links

    List< Dict >

    云硬盘过户记录的链接。

    volume_id

    String

    云硬盘ID。

    id

    String

    云硬盘过户记录的ID。

    name

    String

    云硬盘过户记录的名称。

  • 响应样例
    {
        "transfers": [
            {
                "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377", 
                "name": "first volume transfer", 
                "volume_id": "894623a6-e901-4312-aa06-4275e6321cce", 
                "links": [
                    {
                        "href": "https://localhost/v2/firstproject/os-volume-transfer/1", 
                        "rel": "self"
                    }, 
                    {
                        "href": "https://localhost/firstproject/os-volume-transfer/1", 
                        "rel": "bookmark"
                    }
                ]
            }, 
            {
                "id": "f26c0dee-d20d-4e80-8dee-a8d91b9742a1", 
                "name": "second volume transfer", 
                "volume_id": "673db275-379f-41af-8371-e1652132b4c1", 
                "links": [
                    {
                        "href": "https://localhost/v2/firstproject/os-volume-transfer/2", 
                        "rel": "self"
                    }, 
                    {
                        "href": "https://localhost/firstproject/os-volume-transfer/2", 
                        "rel": "bookmark"
                    }
                ]
            }
        ]
    }

状态码

  • 正常

    200

错误码

请参考错误码说明