文档首页> 云地图服务 KooMap> API参考> API> 实景三维用量统计> 查询实景三维用量
更新时间：2024-05-17 GMT+08:00
查看PDF
分享

查询实景三维用量

功能介绍

您可以查看实景三维生产服务时空专属存储或影像建模的用量统计。

  • 时空专属存储：包括用户上传的数据、数据生产过程中产生的中间数据以及实景三维模型成果数据的存储总量。

    • 用户上传的数据：倾斜摄影影像（航空飞机影像和无人机影像）、生产资料、精修后处理任务的输入数据（精修前后的obj数据）。

    • 数据生产过程产生的中间数据：空三、显式辐射场阶段产生的数据。

    • 实景三维成果数据：纹理Mesh实景三维模型和显式辐射场实景三维模型的osgb、obj格式的文件。

  • 影像建模用量：统计成功建模的倾斜影像的像素数量（单位为“GP”，即十亿像素）、成功建模的次数。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/real3d/usages

表1 Query参数

参数

是否必选

参数类型

描述

usage_type

是

String

查询的用量类型。

  • DATA：时空专属存储占用空间大小。

  • REAL3D：统计实景三维生产服务完成的建模的倾斜影像的像素数量（单位为“GP”，即十亿像素）以及次数。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。

响应参数

状态码： 200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID，用于运维人员定位请求日志。
表4 响应Body参数

参数

参数类型

描述

data

Array of UsageVo objects

用量信息列表。
表5 UsageVo

参数

参数类型

描述

usage_measure_name

String

用量度量名称，通常与KooMap的计费项保持一致。当前支持以下用量度量名称：

  • 时空专属存储

  • 实景三维生产服务基础版

  • 实景三维生产服务专业版

usage_type

String

用量类型。

  • 该值为“DATA”时表示时空专属存储对应的用量消耗。

  • 该值为“REAL3D”时表示处理三维建模任务对应的用量消耗。

domain_id

String

华为云IAM租户账号ID。

最小长度：32

最大长度：32

usage_subtype

String

用量子类型，用于区分同一用量类型下的多个子用量，目前usage_type为“REAL3D”时才需要设置该值。

  • REAL3D_BASIC：实景三维生产服务基础版用量

  • REAL3D_PRO：实景三维生产服务专业版用量

usage

Float

租户当前的使用量数值。

capacity

Float

租户购买的套餐总量值，按需使用取值为0。

usage_unit_type

String

用量的计量单位类型。

  • “VOLUME”：容量。

  • “NUMBER”：数量。

  • “COUNT”：次数。

unit

String

用量的计量单位。

  • 当用量单位类型为“VOLUME”时，单位为存储量相关的单位，如：GB。

  • 当用量单位类型为“NUMBER”时，单位为十亿像素（GP）。

  • 当用量单位类型为“COUNT”时，单位为“次”。

created_time

String

用量记录的创建时间。格式为UTC标准时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

update_time

String

用量记录的更新时间。格式为UTC标准时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

状态码： 400

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID，用于运维人员定位请求日志。
表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为：KMP.XXXXXXXX，其中X表示数字。

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：2

最大长度：512

状态码： 500

表8 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID，用于运维人员定位请求日志。
表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为：KMP.XXXXXXXX，其中X表示数字。

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：2

最大长度：512

请求示例

查询时空专属存储空间的用量列表。

GET https://{Endpoint}/v1/real3d/usages?usage_type=DATA

响应示例

状态码： 200

请求成功。

{
  "data" : [ {
    "usage_measure_name" : "时空专属存储",
    "usage_type" : "DATA",
    "domain_id" : "abc123c55c3c4526b2ed7a0213bc9xxx",
    "usage_subtype" : "REAL3D_BASIC",
    "usage_unit_type" : "VOLUME",
    "capacity" : 0,
    "usage" : 0,
    "unit" : "GB",
    "created_time" : "2022-10-27T13:12:56Z",
    "update_time" : "2022-10-27T13:12:56Z"
  } ]
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

500

服务内部错误。

错误码

请参见错误码。

分享：

    相关文档

    相关产品