更新时间:2024-03-25 GMT+08:00
查询云硬盘过户记录列表详情
功能介绍
查询当前租户下所有云硬盘的过户记录列表的详细信息,比如过户记录创建时间、ID以及名称等信息。
URI
- URI格式
- 参数说明
参数
是否必选
描述
project_id
是
项目ID。
获取方法请参见获取项目ID。
- Request filter参数说明
参数
参数类型
是否必选
描述
limit
Integer
否
返回结果个数限制。
最小值1,最大值1000,默认为1000。返回的结果中记录数不超过limit值。
offset
Integer
否
偏移量,偏移量为一个大于0小于云硬盘过户记录总个数的整数,表示查询该偏移量后面的所有的云硬盘过户记录。
请求消息
以查询云硬盘过户记录的返回结果最大50个为例。
- 请求样例
GET https://{endpoint}/v3/{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" } ] } ] }
错误码
请参考错误码。
父主题: 云硬盘过户