更新时间:2024-10-28 GMT+08:00
分享

查询快照用量

功能介绍

查询快照用量

调用方法

请参见如何调用API

URI

GET /v5/{project_id}/snapshot-usages

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

表2 Query参数

参数

是否必选

参数类型

描述

start_time

String

查询快照用量开始的时间,ISO 8601标准的日期时间格式,表示为YYYY-MM-DDTHH:mm:ss,其中T表示时间的分隔符。例如2000-01-01T00:00:00,日期是2000年1月1日,时间是00点00分00秒。开始时间和结束时间的间隔不能大于40天。

end_time

String

查询快照用量结束的时间,ISO 8601标准的日期时间格式,表示为YYYY-MM-DDTHH:mm:ss,其中T表示时间的分隔符。例如2000-01-01T00:00:00,日期是2000年1月1日,时间是00点00分00秒。开始时间和结束时间的间隔不能大于40天。

category

String

快照链的类型,当前快照链支持"standard"和"flash"两种类型。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

snapshot_usages

SnapshotUsage object

表5 SnapshotUsage

参数

参数类型

描述

capacity

Integer

快照容量,单位为GiB。

id

String

快照使用量ID。

category

String

快照链类型。

project_id

String

项目ID。

record_time

String

快照使用量的记录时间。

created_at

String

创建时间。

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

updated_at

String

快照使用量的更新时间。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息。

表7 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。

错误码和其对应的含义请参考错误码说明

message

String

出现错误时,返回的错误消息。

请求示例

GET https://{endpoint}/v5/{project_id}/snapshot-usages

响应示例

状态码: 200

OK

{
  "snapshot_usages" : [ {
    "capacity" : 10,
    "deleted" : false,
    "id" : "3c70711c-6c53-4737-bd7a-3ac4713bc8f2",
    "category" : "standard",
    "project_id" : "9d7df4a4c0034d6b857968710777e85f",
    "record_time" : "2023-05-15T02:00:00",
    "created_at" : "2023-05-15T02:10:40.856011",
    "updated_at" : null
  }, {
    "capacity" : 10,
    "deleted" : false,
    "id" : "3c70711c-6c53-4737-bd7a-3ac4713bc8f3",
    "category" : "flash",
    "project_id" : "9d7df4a4c0034d6b857968710777e85f",
    "record_time" : "2023-05-15T02:00:00",
    "created_at" : "2023-05-15T02:10:40.856011",
    "updated_at" : null
  } ]
}

状态码: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码

相关文档