计量接口参考说明.docx

计量接口参考说明
1 .说明
为实现运营看板统计功能与计费功能(可不计费)，需要实现计量接口与话单接口。 由jt-operation-service调用来获取计量数据。
2.接口详情
2.1接口规范
所有接口均以统一格式返回：
(
“code”： 200, ——200代表成功
nmsgn:"成功。——失败时，返回失败原因
"data**:数据一一实际数据，可能为数组或对象
}
定义文件可参考附件2.2计量接口

2.2计量接口
l=J
|==1

计量接口用于对一段时间内的实例运行情况进行统计。
jt-operation-service会每隔6分钟获取一次计量数据。
6n+l分钟获取上一个周期6(n-l)到6n的计量数据，留一分钟时间用于保证被调用服务准备 好相关数据，且不会因为时间同步问题出现问题。
如当前时间为01:01会调用00:54到01:00的数据
被调用服务需返回请求时间段(tl,t2)内的实例运行情况，可分为一下三种情况。
如调用时间内，实例一直是运行状态，那么返回当前实例的开始与结束时间为tl,t2
如调用时间内，实例在s时变成运行状态，既tl量数据。
接口请求参数
参数
类型
位置
说明
样例
beginTime
String
param
计量的开 始时间，
请注意格
式
2021-12-02T16:00:00Z
endTime
String
param
计量的结 束时间，
请注意格
式
2021-12-02T16:06:00Z
requestld
String
header
请求Id, UUID,用 于链路追 踪
lc81f0bc-db8b-459b-bbb5-cfeb38edb5aa

接口返回参数
返回最外层格式参考2.1中所示
其中，数据格式为数组，数组中元素格式如下:
参数
类型
说明
样例
beginTime
String
计量开始时间
2021-12-02T16:00:00Z
endTime
String
计量结束时间
2021-12-02T16:06:00Z
resourceType
String
无用参数
空
instanceld
String
实例Id （自动标
注Id）
dl-
cpu
String
规格信息，与规 格接口中 specAttribute 对 应
1C4G,标注中应为AUTOLABEL,标注对 应值请再次与寿文卉确认
storage
String
无用参数
空
userid
String
用户Id
3fd577b9・4807・4423・b5a3・f92350d993e2
projectType
String
工程类型
0,123,4,5 分 别代表课程，竞 赛，数据集，求 职，模型,标注， 如要添加提前告 知，标注对应值 请再次与寿文卉 确认
1
userGroup
String
用户的组织信息
中国移动/集团公司/研究院/人工智能

与智慧运营中心
instanceName
String
实例名称，如自 动标注任务名称
yxrtest-dlds
样例
"code”: 200,msg : 成功，
"data”:[（
"beginTime”: "2021・12-02T16:00:00Z〃,"endTime”: "2021-12-02T16:06:00Z〃, z，resourceType，z: "compute”,
"instanceld〃： 〃dl-〃，zzresourcesld，z: null,
〃cpu〃：〃1C4G〃，// . 〃 〃 〃
storage :,〃userld〃: 〃5a2fal9f-c322-4865-9d7e-6ca3f80c3cb8〃， "projectType〃： 4,
〃userGroup〃：〃中国移动/集团公司/研究院/人工智能与智慧运营中心〃, "instanceName”: 〃yxrtest-dlds〃},
{〃beginTime〃: 〃2021-12-02T16:00:00Z〃，
，zendTimez/: 〃2021-12-02T16:06:00Z〃， 〃resourceType〃: "compute”,"instanceld”: 〃dl-〃，
〃resourcesld〃: null,〃cpu〃：〃1C4G〃，
// . 〃 〃〃storage :,
"userid": 〃bf222ef2-0349-4197-8c4e-d〃，，zprojcctType，z： 4,
，，userGroup/，:中国移动/苏州研发中心/PaaS产品部/人工智能产品组〃, "instanceName”:〃修改〃）
]
）
可参考附件中的java文件，字段解释请以本文说明为准。
ResourceFeignS ervice.java
resourceFeiginService 为调用接口文件UsedFactorDto.j ava
UsedFactorDto为计量接口返回值定义文件
DpGpuSpec.java
DpGpuSpec为规格接口返回值定义文件
Result.java
Result为返回值泛型