接口功能介绍

创建文件系统

接口约束

用户vpc/subnet资源可用
regionID资源池支持sfsType类型的并行文件
底层集群剩余可用空间大于sfsSize，sfsSize大小区间为[512GB, 1048576GB]
用户配额大小默认为100TB
目前只支持按需下单
仅有部分资源池支持指定clusterName，若不指定clusterName，则系统会将其开通到默认的集群
仅有部分资源池支持指定baseline

URI

POST /v4/hpfs/new-sfs

路径参数

无

Query参数

无

请求参数

请求头header参数

无

请求体body参数

参数	是否必填	参数类型	说明	示例
clientToken	否	String	客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一	test-new-hpfs-2023-0719-0003-token
regionID	是	String	资源池 ID，例：100054c0416811e9a6690242ac110002	81f7728662dd11ec810800155d307d5b
projectID	否	String	资源所属企业项目 ID，默认为'0'	0
sfsType	是	String	并行文件类型，hpfs_perf(HPC性能型)	hpfs_perf
sfsProtocol	是	String	协议类型,nfs/hpfs	nfs
onDemand	否	Boolean	是否按需下单。true/false，默认为 true	true
cycleType	否	String	包周期（subscription）类型，year/month。onDemand 为 false 时，必须指定
cycleCount	否	Integer	包周期数。onDemand 为 false 时必须指定。周期最大长度不能超过 3 年	1
sfsName	是	String	并行文件名。单账户单资源池下，命名需唯一	hpfs-2023-0711-16092
sfsSize	是	Integer	大小，单位 GB，起始容量512，步长为512	512
azName	否	String	多可用区资源池下，必须指定可用区。如不指定则在数据库中自动匹配	az2
vpc	否	String	虚拟网 ID	vpc-93gwgagqxd
subnet	否	String	子网 ID	g5t9dg9tbr
clusterName	否	String	集群名称，仅资源池支持指定集群时可传入该参数	nm0001
baseline	否	String	性能基线（MB/s/TB），仅资源池支持性能基线时可传入该参数	200

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	返回状态码(800 为成功，900 为失败)	800
message	String	响应描述	SUCCESS
description	String	响应描述	成功
returnObj	Object	返回对象		参考returnObj
errorCode	String	业务细分码，为 product.module.code 三段式码。	sfs.sfsInfo.resourceNotExists
errorDetail	Object	错误明细。一般情况下，会对订单侧(bss)的并行文件订单业务相关的错误做明确的错误映射和提升，有唯一对应的errorCode。其他订单侧(bss)的错误，以sfs.order.procFailed的errorCode统一映射返回，并在errorDetail中返回订单侧的详细错误信息		参考errorDetail
error	String	业务细分码，为product.module.code三段式大驼峰码。	Sfs.SfsInfo.ResourceNotExists

表 returnObj

参数	参数类型	说明	示例	下级对象
masterOrderID	String	订单 ID。调用方在拿到 masterOrderID 之后，在若干错误情况下，可以使用 materOrderID 进一步确认订单状态及资源状态	b50beb2a3cd411eea5db0242ac11001b
masterOrderNO	String	订单号	null
masterResourceID	String	主资源 ID	0142042f3c004d81a5cd4ed237cd0327
masterResourceStatus	String	主资源状态。参考主资源状态	started
regionID	String	资源所属资源池 ID	81f7728662dd11ec810800155d307d5b
resources	Array of Objects	资源明细		参考 resources

表 resources

参数	参数类型	说明	示例
resourceID	String	单项资源的变配、续订、退订等需要该资源项的 ID。比如某个云主机资源作为主资源，对其挂载	0142042f3c004d81a5cd4ed237cd0327
resourceType	String	资源类型	HPFS
orderID	String	无需关心	e87b130883e94a96918eef7a4b555de0
startTime	Long	启动时刻，epoch 时戳，毫秒精度。例：1589869069561	1692259495000
createTime	Long	创建时刻，epoch 时戳，毫秒精度	1692259479000
updateTime	Long	更新时刻，epoch 时戳，毫秒精度	1692259504000
status	Integer	资源状态	2
isMaster	Boolean	是否是主资源项	true
itemValue	Integer	无需关心	512
sfsUID	String	并行文件系统内部唯一 ID	a2d4b927-9511-5a9b-b1de-cfe55779c1ea
sfsStatus	String	并行文件状态	available
masterOrderID	String	订单 ID	b50beb2a3cd411eea5db0242ac11001b
sfsName	String	并行文件名字	hpfs-2023-0711-16092
masterResourceID	String	主资源 ID	0142042f3c004d81a5cd4ed237cd0327

表 errorDetail

参数	参数类型	说明	示例
bssErrCode	String	bss错误明细码，包含于bss格式化JSON错误信息中	code_foo
bssErrMsg	String	bss错误信息，包含于bss格式化JSON错误信息中	error_foo
bssOrigErr	String	无法明确解码bss错误信息时，原样透出的bss错误信息	unknow_error
bssErrPrefixHint	String	bss格式化JSON错误信息的前置提示信息	error_bar

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

{
  "subnet": "subnet-g5t9dg9tbr",
  "vpc": "vpc-93gwgagqxd",
  "onDemand": true,
  "sfsType": "hpfs_perf",
  "regionID": "81f7728662dd11ec810800155d307d5b",
  "sfsSize": 512,
  "sfsProtocol": "nfs",
  "azName": "az2",
  "clusterName": "nm0001",
  "baseline": "200",
  "clientToken": "test-new-hpfs-2023-0719-0003-token",
  "sfsName": "hpfs-2023-0711-16092"
}

响应示例

{
  "returnObj": {
    "masterResourceStatus": "started",
    "regionID": "81f7728662dd11ec810800155d307d5b",
    "masterOrderID": "b50beb2a3cd411eea5db0242ac11001b",
    "masterResourceID": "0142042f3c004d81a5cd4ed237cd0327",
    "masterOrderNO": null,
    "resources": [
      {
        "orderID": "e87b130883e94a96918eef7a4b555de0",
        "status": 2,
        "isMaster": true,
        "sfsStatus": "available",
        "resourceType": "HPFS",
        "resourceID": "0142042f3c004d81a5cd4ed237cd0327",
        "masterOrderID": "b50beb2a3cd411eea5db0242ac11001b",
        "updateTime": 1692259504000,
        "masterResourceID": "0142042f3c004d81a5cd4ed237cd0327",
        "itemValue": 512,
        "startTime": 1692259495000,
        "sfsName": "hpfs-2023-0711-16092",
        "createTime": 1692259479000,
        "sfsUID": "a2d4b927-9511-5a9b-b1de-cfe55779c1ea"
      }
    ]
  },
  "message": "success",
  "description": "成功",
  "statusCode": 800
}

状态码

请参考状态码

错误码

请参考错误码

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

并行文件服务 HPFS

并行文件服务 HPFS

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

并行文件服务 HPFS

并行文件服务 HPFS

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码