湖南省工信厅：2026湖南省算力调度平台算力资源并网规范（51页）.docx

1、湖南省算力调度平台算力资源并网规范目录1、总则32、获取Token接口93、创建/更新idc（互联网数据中心）集群信息124、idc（互联网数据中心）机房信息上报接口145、查询idc（互联网数据中心）信息186、新增/更新资源集群217、查询资源集群信息228、新增/修改资源规格信息249、查询资源规格信息2710、节点信息注册2911、查询已经注册的节点信息3312、idc（算力中心）检测数据上报（季维度）3513、节点静态资源上报（天维度）3814、节点资源使用数据上报（分钟维度）4315、节点网络资源使用数（季维度）4616、编码表48（1）各省编码表48（2）地市编码表附件49（3）

2、枚举编码表50（4）接口错误码表521、 总则1.1目的为统一省域算力调度平台网关接口标准，规范接口设计、开发、发布、调用、安全、日志、版本与运维管理，保障数据共享交换稳定、安全、高效、兼容，明确资源提供方与资源需求方责任义务，特制定本规范。本规范适用于所有接入省域算力调度平台网关的算力中心、业务系统、应用模块、接口开发方、调用方、运维方及相关管理活动。1.2 接口类型平台支持主流接口实现方式（REST接口），所有接口返回数据统一采用JSON 格式，发布服务时须明确标注接口实现类型。REST 风格接口服务消息封装，遵循HTTP标准协议。1.3 接口请求方式接口仅支持GET、POST两种请求方式

3、，严格按照业务场景区分使用：GET 请求：适用于资源需求方从资源提供方获取信息、查询数据的场景。POST 请求：适用于资源需求方向资源提供方提交信息、上报数据的场景。1.4 接口应答内容接口接收到有效请求后，统一返回标准化应答结构，包含状态标识与业务数据，应答字段定义如下：statusCode：执行结果状态码；200表示执行成功，非200表示执行失败，具体异常编码见接口错误编码表。msg：执行结果描述信息；执行失败时需返回详细错误原因result：接口返回的核心业务数据records: 列表数据（分页场景必填）count：数据总记录数（分页场景必填）page：数据总页数（分页场景必填）size

4、: 数据每页数量（分页场景必填）1.5 接口安全规范 传输安全：所有接口必须使用HTTPS 加密传输，禁止使用 HTTP。接口服务端启用TLS 1.2 及以上版本。 身份认证：必须校验appkey 合法性，未分配、无效、过期 appkey 拒绝调用。敏感数据接口必须增加username/appkey 身份校验。 权限控制：未授权接口的statusCode字段直接返回10003，表示用户权限不足。 防攻击：接口启用限流：单IP / 单 appKey 限制调用频次。防止重放攻击：支持timestamp + nonce + sign 签名机制。防止SQL 注入、XSS、参数篡改：参数必须校验与过滤。

5、 数据安全：数据传输与存储遵循国家网络安全、数据安全、个人信息保护相关法规。涉密数据不得通过普通接口明文传输。1.6 整体算力入网流程1.7 整体算力入网时序图：1.8 整体算力入网操作流程图：l 平台访问：用户访问算力调度平台的首页（https:/csp.hunan-l 用户注册：点击右上角注册，注册为平台用户l 企业认证：登录后，进入个人中心，认证为企业用户l 商家入驻：企业用户进入商家管理，申请作为算力供给方完成入驻l 商家中心：商家入驻成功后，平台分配对应APPKey，在商家中心完成算力资源上报n Step1：添加算力IDCn Step2：资源集群填报、资源规格填报n Step3：下载

6、并且安装Agent或者根据文档接口完成节点资源信息上报n Step4：完成算力入网2、获取Token接口（用于后续节点注册和数据上报相关接口）说明：获取平台的Token接口，在后续调用其它接口时，需要在Header参数中传入。注意Token是有有效期的，默认是72小时有效。调用该接口时需要在参数头中对所有参数使用md5映射后，得到sign属性放到Http Header中，用于校验参数的正确性。获取sign属性方法： 参数排序：将所有请求参数按照参数名的字母顺序（ASCII码升序）进行排序。 拼接字符串：将排序后的参数与对应值用等号=连接，参数之间使用&连接。若某参数值为空，则等号后保留空值。