更新时间:2024-04-15 GMT+08:00

查询云硬盘过户记录列表详情

功能介绍

查询当前租户下所有云硬盘的过户记录列表的详细信息,比如过户记录创建时间、ID以及名称等信息。

URI

  • URI格式

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

  • 参数说明

    参数

    是否必选

    描述

    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/detail?limit=50

响应参数

  • 响应参数

    参数

    参数类型

    描述

    transfers

    List<Transfer>

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

  • transfers参数说明

    参数

    参数类型

    描述

    links

    Array of Objects

    云硬盘过户记录的链接。请参见•Link

    created_at

    String

    云硬盘过户记录的创建时间。

    时间格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX

    volume_id

    String

    云硬盘ID。

    id

    String

    云硬盘过户记录的ID。

    name

    String

    云硬盘过户记录的名称。

  • Link参数说明

    参数

    参数类型

    描述

    href

    String

    对应的快捷链接。

    rel

    String

    快捷链接标记名称。

    缺省值:next

  • 响应样例
    {
        "transfers": [
            {
                "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377", 
                "created_at": "2015-02-25T03:56:53.081642", 
                "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", 
                "created_at": "2015-03-25T03:56:53.081642", 
                "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

错误码

请参考错误码