1、 ICS 35.100.01 CCS L 70 34 安徽省地方标准 DB34/T 55382026 算力公共服务平台资源纳管接口规范 Interface specification for resource onboarding and management in computing capability public service platform2026-09-09 发布2026-10-09 实施安徽省市场监督管理局发 布 DB34/T 55382026 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 总体架构.2 6 通用要求.3
2、7 通用算力接口要求.4 8 超级算力接口要求.26 9 智能算力接口要求.28 10 量子计算服务接口要求.32 11 安全产品接口要求.34 附录 A(资料性)HTTP 状态码.38 附录 B(资料性)接口 API 示例.40 参考文献.42 DB34/T 55382026 II 前言 本文件按照 GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由芜湖市大数据建设投资运营有限公司提出。本文件由安徽省数据资源管理局归口。本文件起草单位:芜湖市大数据建设投资运营有限公司、安徽
3、省质量和标准化研究院、安徽工程大学、芜湖市数据资源管理局(政务服务管理局)、中移(苏州)软件技术有限公司、中国移动通信集团安徽有限公司、合肥中科类脑智能技术有限公司、杭州安恒信息技术股份有限公司、本源量子计算科技(合肥)股份有限公司。本文件主要起草人:胡蓉、孔超、方坚、苗振营、柳梦辉、韩鹏飞、杭文鑫、吴锦、程宁、赵立芬、原超、汪鹏、钟大伟、王鸣、谷家磊、赵元、肖良军、陈程、何志刚、吴佳俊。DB34/T 55382026 1 算力公共服务平台资源纳管接口规范 1 范围 本文件规定了接入算力公共服务平台的通用算力、智能算力、超级算力、量子计算服务,以及安全管理服务等资源纳管接口的要求。本文件适用于
4、算力公共服务平台资源纳管接口的设计和验证。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。ISO/IEC 21778 信息技术 JSON数据交换语法(Information technology-The JSON data interchange syntax)3 术语和定义 下列术语和定义适用于本文件。算力 computing capability 网络中具有计算能力的节点通过对数据的处理,实现特定结果输出的能力,具体包括不限于计算、内存
5、和存储能力,算力可以分布在网络边缘、云数据中心、连网终端、转发节点等各种形态的设备上。来源:YD/T 4255-2023,3.1 算力公共服务平台 computing capability public service platform 通过整合和调度各类各地的算力资源,促进异构异地异属算力资源互联互通和高效利用的综合性服务平台。注:算力公共服务平台旨在满足人工智能、大数据处理、科学计算等领域的应用需求,为用户提供便捷、高效、低成本的算力服务。通用算力 generic computing capacity 以CPU芯片输出的计算能力为主,能够处理一般性计算任务的算力集群。智能算力 intell
6、igent computing capacity 以GPU、现场可编程门阵列(FPGA)、专用集成电路(ASIC)等AI芯片为主,能够执行图形显示、信号处理和物理模拟等计算密集型任务的高性能算力集群。注:智能算力通常服务于人工智能、机器学习以及深度学习等。超级算力 high performance computing capacity DB34/T 55382026 2 由通用或专用的高性能硬件和软件组成的,为处理复杂的数据、算法和应用等提供高性能算力的高性能计算集群。量子计算 quantum computing 基于量子力学原理,采用真实量子计算架构,利用量子比特进行信息处理,支持大规模信息
7、处理和计算的能力。资源纳管 resource onboarding and management 将分散的、异构的资源(如云主机、裸金属、存储、网络、数据库、中间件等)接入统一管控平面,实现统一分配、运营计费、监控运维的全生命周期管理。4 缩略语 下列缩略语适用于本文件。API:应用程序编程接口(Application Programming Interface)ASIC:专用集成电路(Application Specific Integrated Circuit)DCU:深度计算单元(Deep Computing Unit)HTTP:超文本传输协议(Hyper Text Transfer P
8、rotocol)HTTPS:超文本传输安全协议(Hypertext Transfer Protocol Secure)JSON:一种JavaScript对象的轻量级的数据交换格式(JavaScript Object Notation)NPU:神经网络处理器(Neural Processing Unit)RESTful:表现层状态传递(Representational State Transfer)URI:统一资源标识符(Uniform Resource Identifier)URL:统一资源定位器(Uniform Resource Locator)UTF-8:8位元转换格式(Unicode T
9、ransformation Format 8 bit)UUID:通用唯一标识符(Universally Unique Identifier)5 总体架构 算力公共服务平台通过纳管各种异属异构跨地域算网资源,实现集群数据中心资源的统一调度和全生命周期管理。其整体架构如图1 所示。平台主要功能模块包括以下方面。统一运营门户:实现计算、存储、网络、安全等各方算力提供者的各类资源的精细化统一运营管理,提供全局资源总览、资源使用情况、资源上下架、用户管理、日志管理等。服务交易中心:实现已纳管算力、网络、安全服务的交易,支持通过统一入口、统一流程订购资源、退订资源、变更资源等操作。服务运营:实现流程管控、
10、配额管理、成本管理和运营分析等能力。监控运维中心:实现对资源池基础设施以及虚拟化资源进行集中监控,提供高可用、统一认证、统一监控告警、日志分析、行为溯源等能力。编排管理中心:基于原子能力一体化编排,实现算、网、安能力统一设计开发和一体编排,满足不同行业应用场景对算网的需求,快速构建算网产品和解决方案。资源调度中心:支撑面向算力的跨域调度、弹性调度、容灾调度等多样化的调度场景。DB34/T 55382026 3 资源纳管:提供各类异构算力的纳管,形成标准接入规范,支持全量异构资源池的统一纳管。包括实例、流程、配额、资源对账等管理能力。算力公共服务平台基于统一协议,适配纳管通用算力、智能算力、超级
11、算力,以及量子算力服务,并提供认证、用户、算力、任务管理等相关接口,实现对异地异属异构算力资源及服务的开通和管理。图1 算力公共服务平台架构图 6 通用要求 接口调用方式 6.1.1 接口格式应遵循 RESTful API,传输协议支持 HTTP2.0 版本(RFC 7540)并向下兼容,并且基于 HTTPS 方式加密访问,常用 HTTP 状态码及信息的描述见附录 A。6.1.2 接口消息体包括请求体和响应体,请求体包含请求头以及 Request 内容,响应体包括 Response内容。6.1.3 HTTP 接口访问方法格式为:请求方法/api/v1/接口功能/路径参数(如果有)/操作(如果有
12、在实际调用中需补全前缀和后缀。注:请求方法包括POST、PUT等,api为域名地址或IP地址,v1为接口版本且随版本更新而更新,接口功能、路径参数与操作详见表1表69中的定义。示例:计算实例监控同步的接口访问方法为 POST/ instanceId 的值,monitor 为操作,表示监控。6.1.4 请求头应包含 Content-Type 信息。示例:认证授权的请求头为:Request HTTP Header Content-Type:application/json;charset=UTF-8 Response HTTP Header X-Auth-Token:发放的令牌 DB34/T
13、55382026 4 6.1.5 对通用算力、智能算力、超级算力等算力以及量子计算服务、安全管理服务等进行等管理行为时,请求头应包含携带的令牌。示例:Request HTTP Header Content-Type:application/json;charset=UTF-8 X-Auth-Token:发放的令牌 Response HTTP Header Content-Type:application/json;charset=UTF-8 6.1.6 接口请求(Request)和响应(Response)内容应采用 JSON 格式,并符合 ISO/IEC 21778 标准,应支持 UTF-8
14、无字节顺序标记(BOM)格式编码格式(返回值为文件、图片等特殊信息的除外),接口API 示例见附录 B。接口安全认证 算力公共服务平台应支持对纳管的各类算力资源进行认证,保证接口传输数据的机密性和完整性。算力供给方应保障对算力服务平台的接入安全,包括对基于证书的认证、基于HTTPS保护接口数据传输的机密性和完整性。返回时长 接口返回时长不应超过 10 s。7 通用算力接口要求 认证授权管理 7.1.1 认证授权 认证授权接口要求见表1。表1 认证授权接口名称及参数要求 消息体类型 参数名 参数类型 参数说明 是否必选 请求参数 orgId String 算力公共服务平台标识 是 cluster
15、Id String 算力供给方标识 是 accessKeyId String 算力供给方的访问密钥 ID:由平台统一分配,用于标识调用者身份 是 timestamp String 请求的时间戳,建议格式为 ISO 8601 UTC 时间。是 signature String 请求签名。通过使用 Secret Key 对请求内容进行加密计算得出的字符串 是 signatureNonce String 一次性的随机字符串,建议使用 UUID。是 返回值 code Int 状态码 否 message String 提示信息 否 isData Boolean 是否返回数据 否 返回值 success
16、Boolean 是否成功 是 接口说明:算力公共服务平台调用算力供给方,用于认证授权 接口访问方法:POST/api/v1/authentication/token DB34/T 55382026 5 7.1.2 授权废除 授权废除接口要求见表2。表2 授权废除接口名称及参数要求 消息体类型 参数名 参数类型 参数说明 是否必选 返回值 code Int 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:算力公共服务平台调用算力供给方,用于认证的授权废除 接口访问方法:DELETE/api/v1/authentication/tok
17、en 用户管理7.2.1 用户创建用户创建接口要求见表3。表3 用户创建接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 account String 用户名 是 accountId Int64 父账号 ID 否 startTime String 账号有效开始时间 否 endTime String 账号有效结束时间 否 isresetPassword String 是否首次登录重置密码 是 password String 密码 是 roleId String 角色 是 返回值 code Int 状态码 否 message String 提示信息 否 success B
18、oolean 是否成功 是 接口说明:算力公共服务平台调用创建用户接口,用于创建用户 接口访问方法:POST/api/v1/account 7.2.2 用户删除 用户删除接口要求见表4。表4 用户删除接口名称及参数要求 参数类型 参数名 参数类型 说明 是否必选 请求参数 accountId Int64 父账号 ID 是 返回值 code Int 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:算力公共服务平台调用用户删除接口,用于删除用户 接口访问方法:DELETE/api/v1/account/accountId 配额管理 7
19、3.1 创建配额 创建配额接口要求见表5。DB34/T 55382026 6 表5 创建配额接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 accountId String 主用户 ID 是 quotaSet Object 资源配额,包含 cpu、gpu 和 storage 是 cpu Int CPU 核数,默认配额 4 是 gpu Int GPU 卡数,默认配额 2 是 storage Int 存储容量(GB),默认配额 1024 否,否时无限制 返回值 code Int 状态码 否 message String 提示信息 否 isData Boolean 是否
20、返回数据 否 quotaSet Object 资源配额,包含 cpu、gpu 和 storage 否 cpu Int CPU 核数 否 gpu Int GPU 卡数 否 storage Int 存储容量(GB)否 success Boolean 是否成功 是 接口说明:算力公共服务平台调用创建配额接口,用于创建用户配额 接口访问方法:PUT/api/v1/quota-sets/account_id/accountId 7.3.2 查询配额 查询配额接口要求见表6。表6 查询配额接口名称及参数要求 参数类型 参数名 参数类型 说明 是否必选 请求参数 accountId String 主用户 I
21、D 是 返回值 code Int 状态码 否 message String 提示信息 否 isData Boolean 是否返回数据 否 quotaSet object 资源配额,包含 cpu、gpu 和 storage 否 cpu Int CPU 核数 否 gpu Int GPU 卡数 否 storage Int 存储容量(GB)否 success Boolean 是否成功 是 接口说明:算力公共服务平台查询配额接口 接口访问方法:GET/api/v1/quota-sets/account_id/accountId 实例管理 7.4.1 计算实例管理7.4.1.1 创建计算实例创建计算实例接
22、口要求见表7。表7 创建计算实例接口名称及参数要求 消息体 类型 参数名称 参数类型 说明 是否必选 请求参数 region String 可用区 是 chargeType Enum 计费方式:Year:按年计费;Month:按月计费;Hour:按小时计费 是 cpu Int cpu 核数(核)是 ram Int 内存大小(GB)是 DB34/T 55382026 7 消息体 类型 参数名称 参数类型 说明 是否必选 flavorName String 规格名称,建议填写,如 s1.medium.2。如填写该值,将以规格名称作为创建实例规格的依据 否 bootVolume Object 系统盘
23、 是 bootVolumeSize Int 系统盘大小 是 bootVolumeVolumeType String 系统盘类型 是 dataVolume Listt 一体化订购中数据盘产品 否 dataVolumIsShare Boolean 是否为共享数据盘,默认为非共享盘 否 dataVolumeResourceType String 数据盘类型 是 dataVolumeSize Int 数据盘大小(G)是 imageName String 镜像名称 是 name String 计算实例名称 是 password String 登录密码(使用非对称加密形式)否 keypairName St
24、ring 密钥对名称,可通过查询密钥列表接口获取。(password 和 keypairName 仅能填写一个)否 quantity Int 订购数量 是 duration Int 订购时长,取值范围为0,60,如果取值为0,会设置成订购一个月并开启自动续订,1-60 表示订购的月数 否 networks Object 计算实例网络信息 是 subnetId String 指定子网 id,具体可通过查询子网列表接口获取 是 portId String 指定网卡 id,具体可通过查询虚拟网卡列表接口获取 否 ip Enum 公网 IP 类型:MOBILE:弹性公网 IP;MULTI_LINE:优
25、享版弹性公网 IP 否 bandwidth Object 计算实例带宽信息 否 bandwidthSize Int 公网 IP 带宽大小(Mbps)是 chargeMode Enum 公网 IP 带宽计费方式:bandwidthCharge:按带宽计费;trafficCharge:按流量计费 是 ipv4Bandwidth Boolean 是否开通 Ipv4 公网带宽,默认开通 Ipv4 公网带宽 否 ipv6Bandwidth Boolean 是否开通 Ipv6 带宽,默认不开通 Ipv6 带宽 否 securityGroupIds List 安 全 组 Id,如 果 指 定 网 卡 Id(
26、即networks.portId 不为空),此参数无效 否 userData String 自定义参数 否 description String 计算实例描述 否 返回值 requestId String 请求 Id 是 success Boolean 是否成功 是 code String 状态码 否 message String 提示信息 否 entity Object 返回实体 是 orderId String 订单 Id,如果返回的是订单 Id,需要提供根据订单 Id 查询资源 Id 的接口 是 instanceId String 计算实例资源唯一标识(Id)是 接口说明:算力公共服务平
27、台请求创建计算实例 接口访问方法:POST/api/v1/instances/create 7.4.1.2 查询计算实例查询计算实例接口要求见表8。DB34/T 55382026 8 表8 查询计算实例接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 instanceId String 路径参数,计算实例唯一标识 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 entity Object 返回计算实例实体 是 vcpu Int c
28、pu 个数 否 memory Int 内存大小 否 createdTime String 创建时间 是 description String 计算实例描述 是 flavorId String 规格 Id 是 flavorName String 计算实例规格名称 是 instanceId String 计算实例 Id 否 imageId String 镜像 Id 否 imageName String 镜像名称 否 imageOsName String 镜像操作系统名称 否 imageOsType String 镜像类型 否 keypairId String 密钥对 Id 否 keypairNam
29、e String 密钥对名称 否 modifiedTime String 修改时间 否 name String 计算实例名称 是 ports List 计算实例网卡列表 是 portId String 网卡 Id 否 portName String 网卡名称 否 portIpv4Address String Ipv4 地址 否 portIpv6Address String Ipv6 地址 否 portPublicIpId String 公网 IpId 否 portPublicIp String 公网 Ip 否 region String 可用区 是 status Enum 计算实例状态:ACT
30、IVE:运行中;STOPPED:已关机;ERROR:错误;UNKNOWN:未知 是 chargeType Enum 计费方式:Year:按年计费;Month:按月计费;Hour:按小时计费 是 expiredTime String 过期时间 是 systemDiskId String 系统盘 Id 否 disk Int 系统盘大小 是 bootVolumeType String 计算实例系统盘类型 是 volumes List 计算实例数据盘列表 是 volumeId String 数据盘 Id 否 volumeName String 数据盘名称 是 volumeSize Int 数据盘大小
31、是 volumeType String 数据盘类型 是 接口说明:算力公共服务平台请求查询计算实例详情 接口访问方法:GET/api/v1/instances/instanceId 7.4.1.3 删除计算实例删除计算实例接口要求见表9。DB34/T 55382026 9 表9 删除计算实例接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 instanceId String 路径参数,计算实例唯一标识 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boole
32、an 是否成功 是 接口说明:算力公共服务平台请求删除计算实例 接口访问方法:DELETE/api/v1/instances/instanceId 7.4.1.4 开机/关机/重启计算实例开机/关机/重启计算实例接口要求见表10。表10 开机/关机/重启计算实例接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 instanceId String 路径参数,计算实例唯一标识 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:
33、算力公共服务平台请求开机/关机/重启计算实例 计算实例开机接口访问方法:PUT/api/v1/instances/instanceId/start 计算实例关机接口访问方法:PUT/api/v1/instances/instanceId/stop 计算实例重启接口访问方法:PUT/api/v1/instances/instanceId/restart 7.4.1.5 修改计算实例修改计算实例接口要求见表11。表11 修改计算实例接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 instanceId String 路径参数,计算实例唯一标识 是 name String
34、计算实例名称 是 password String 计算实例登录密码,使用非对称加密方式 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:算力公共服务平台请求修改计算实例,包括修改名称、密码 接口访问方法:PUT/api/v1/instances/instanceId/update 7.4.1.6 续订计算实例续订计算实例接口要求见表12。表12 续订计算实例接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 instanc
35、eId String 路径参数,计算实例唯一标识 是 actionId String 操作 ID 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 DB34/T 55382026 10 消息体类型 参数名 参数类型 说明 是否必选 success Boolean 是否成功 是 接口说明:算力公共服务平台请求续订计算实例 接口访问方法:PUT/api/v1/instances/instanceId/renew 7.4.1.7 监控数据同步计算实例资源的监控数据同步接口要求见表13。表13 监控数据同步接口
36、名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 instanceId String 路径参数,计算实例唯一标识 是 startTime String 查询开始时间,格式如 2020-07-19 23:47:12 是 endTime String 查询截止时间,格式如 2020-07-19 23:47:12 是 metrics List 需要查询的性能指标集合 是 metricName Enum 需要查询的性能指标名称:vm_custom_realtime_cpu_avg_util_percent:计算实例 cpu 利用率;vm_custom_realtime_mem_a
37、vg_util_percent:计算实例内存利用率;vm_disk_util_percent:计算实例磁盘利用率 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:用以同步计算实例资源运行状态等数据 接口访问方法:POST/api/v1/instances/instanceId/monitor 7.4.2 镜像管理7.4.2.1 创建镜像创建镜像接口要求见表14。表14 创建镜像接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求
38、参数 imagename String 文件名称 是 note String 镜像描述信息 否 instanceId String 计算实例 id 是 serverTypeEnum Enum 计算实例类型:VM:云主机;IRONIC:裸金属 否 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 imageId String 返回镜像 ID 是 接口说明:算力公共服务平台调用接口,用以创建镜像 接口访问方法:POST/api/v1/images/create 7.
39、4.2.2 删除镜像删除镜像接口要求见表15。DB34/T 55382026 11 表15 删除自定义镜像接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 imageId String 路径参数,镜像 Id 是 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:算力公共服务平台调用接口,用以删除镜像 接口访问方法:DELETE/api/v1/images/imageId 7.4.2.3 镜像下载镜像下载接口要求见表16。表16
40、 镜像下载接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 imageId String 镜像 Id 是 返回值 code Int 状态码 否 message String 提示信息 否 isData Boolean 是否返回数据 否 location String 文件地址 否 success Boolean 是否成功 否 接口说明:算力公共服务平台调用接口,用以下载镜像 接口访问方法:POST/api/v1/catalog/images/download 7.4.2.4 查询镜像查询镜像接口要求见表17。表17 查询镜像接口名称及参数要求 消息体类型 参数名 参数
41、类型 说明 是否必选 请求参数 type String 镜像类型 否 imageId String 镜像 Id 否 3rdosId String 三方运营服务系统 Id 否 返回值 code Int 状态码 否 message String 提示信息 否 isData Boolean 是否返回数据 否 imageList List 镜像实体列表 否 name String 镜像名称 否 description String 镜像描述 否 type String 镜像类型 是 publicView String 是否公开 否 imagePath String 镜像地址 是 success Boo
42、lean 是否成功 否 接口说明:算力公共服务平台调用接口,查询镜像列表 接口访问方法:GET/api/v1/catalog/images 存储实例管理7.5.1 文件存储管理7.5.1.1 创建文件存储创建文件接口要求见表18。DB34/T 55382026 12 表18 创建文件存储接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 name String 文件存储名称 是 region String 可用区 是 protocol Enum 文件系统协议:NFS:网络文件系统;CIFS:通用网络文件系统;GLUSTERFS:GlusterFS 分布式文件系统;HDF
43、S:Hadoop 分布式文件系统;SMB:SMB 网络文件系统 是 description String 文件存储描述 否 chargeType Enum 计费方式:Year:按年计费;Month:按月计费;Hour:按小时计费 否 duration Int 订购时长,取值范围为0,60,如果取值为 0,会设置成订购一个月并开启自动续订,1-60 表示订购的月数 否 shareSize Int 文件存储容量规格 是 vpcId String VPC 编号 否 subnetId String 子网编号 否 groupId String 安全组编号 否 返回值 requestId String 请
44、求 Id 是 code String 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 orderId String 订单 ID 是 efsId Sting 文件存储唯一标识(ID)是 接口说明:算力公共服务平台调用接口,创建文件存储 接口访问方法:POST/api/v1/efs/create 7.5.1.2 获取文件列表获取文件列表接口要求见表19。表19 获取文件列表接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 efsId String 文件存储唯一标识 ID 是 pageSize Int 分页页面大小 否
45、pageNum Int 分页页码 否 返回值 requestId String 请求 Id 是 code String 状态码 否 message String 提示信息 否 entity Object 返回实体 否 total Int 总个数 是 list List 文件存储列表 否 efsId String ID 否 name String 名称 否 shareSize Int 文件存储容量规格,单位:GB 否 usedSpace String 文件存储已使用容量 否 DB34/T 55382026 13 消息体类型 参数名 参数类型 说明 是否必选 protocol Enum 存储协议:
46、NFS:网络文件系统;CIFS:通用网络文件系统;GLUSTERFS:GlusterFS 分布式文件系统;HDFS:Hadoop 分布式文件系统;SMB:SMB 网络文件系统 否 exportLocation String 文件存储共享目录挂载点 否 createdTime String 文件存储创建时间 否 modifiedTime String 文件存储修改时间 否 status Enum 状态:AVAILABLE:可用;UNKNOWN:不可用 否 vpcId String VPC 编号 否 subnetId String 子网编号 否 groupId String 安全组编号 否 reg
47、ion String 区域 否 chargeType Enum 计费方式:Year:按年计费;Month:按月计费;Hour:按小时计费 否 expiredTime String 过期时间 否 description String 描述 否 success Boolean 是否成功 是 接口说明:算力公共服务平台调用接口,查询目录文件列表 接口访问方法:GET/api/v1/efs/list 7.5.1.3 删除文件存储 删除文件存储接口要求见表20。表20 删除文件存储接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 efsId String 路径参数,文件存储唯一
48、标识(ID)是 返回值 requestId String 请求 Id 是 code Int 状态码 否 message String 提示信息 否 success Boolean 是否成功 是 接口说明:算力公共服务平台调用接口,用于删除文件存储 接口访问方法:DELETE/api/v1/efs/efsId 7.5.2 对象存储管理7.5.2.1 创建桶创建桶接口要求见表21。表21 创建桶接口名称及参数要求 消息体类型 参数名 参数类型 说明 是否必选 请求参数 name String 桶名称 是 region String 可用区 是 storageClass Enum 存储类型:STAN
49、DARD:标准存储;STANDARD_IA:低频访问存储;GLACIER:归档存储;UNKNOWN:未知 是 description String 描述 否 DB34/T 55382026 14 消息体类型 参数名 参数类型 说明 是否必选 chargeType Enum 计费方式:Year:按年计费;Month:按月计费;Hour:按小时计费 否 duration Int 订购时长,取值范围为0,60,如果取值为 0,会设置成订购一个月并开启自动续订,1-60 表示订购的月数 否 bucketAcl Enum 桶权限:PUBLIC_READ_WRITE:公共读写;PUBLIC_READ:公共
50、读;PRIVATE:私有;AUTHENTICATED_READ:认证用户可读;PUBLIC_READ_DELIVERED:公共读;PUBLIC_READ_WRITE_DELIVERED:公共读写;UNKNOWN:未知 是 capacity Long 桶的初始容量 否 返回值 requestId String 请求 Id 是 code Int 状态码 否 message String 提示信息 否 entity Object 返回实体 否 orderId String 订单 ID 是 bucketId Sting 资源唯一标识(ID)否 success Boolean 是否成功 是 接口说明:算