创建一个数据缓存
更新时间 2025-12-24 10:17:35
最近更新时间: 2025-12-24 10:17:35
接口功能介绍
调用该接口创建数据缓存
接口约束
无
URI
POST /eci/api/v1/dataCache/createDataCache
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 区域ID | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| dataCacheName | 是 | String | 数据缓存名字 | test | |
| size | 否 | Integer | 数据缓存大小 ,默认为20G ，允许取值范围位10-32728G | 20 | |
| tags | 否 | Array of Objects | 标签，标签数量不能超过20 | tag | |
| securityGroupId | 是 | String | 安全组ID | sg-test | |
| subnetId | 是 | String | 子网ID | subnet-test | |
| eip | 否 | Object | 弹性公网 IP。如果需要通过公网拉取数据源，需要确保 ECI 实例能够访问公网，您可以配置 EIP 或者 NAT 网关实现公网访问。 | eip | |
| bucket | 是 | String | 数据的存储空间 | ||
| path | 是 | String | 数据存储的路径 | ||
| vpcId | 是 | String | 实例所在vpcId | vpc-ctt6yag121 | |
| dataSource | 是 | Object | 数据源 | dataSource | |
| azName | 是 | String | 可用区名称 | cn-xinan1-1A | |
| 表 tag |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| key | 否 | String | 标签的key，长度不超过63 | key-test | |
| value | 否 | String | 标签的value ，长度不超过63 | value-test | |
| 表 eip |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| eipInstanceId | 否 | String | eip 实例ID | eip-xxxxxxxx | |
| autoCreateEip | 否 | Boolean | 自动创建 eip | false | |
| eipBandwidth | 否 | Integer | eip 带宽 | 1 | |
| 表 dataSource |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| dataSourceType | 是 | String | 数据源类型 | ||
| dataSourceOption | 是 | Object | 数据源配置 | dataSourceOption | |
| 表 dataSourceOption |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| git | 否 | Object | git类型数据源配置 | git | |
| 表 git |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| accessToken | 否 | String | 私有仓库的访问token值 | ghp_j7xozK6o7SMwuDXrEGEVqKeE53n4as0ciIaB | |
| branch | 否 | String | 仓库分支 | master | |
| url | 是 | String | git仓库地址 | https://github.com/cri-o/cri-o.git |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 请求成功(200)或失败(非200) | 200 | |
| error | String | 错误码，三段式 | ECI.Openapi.StatusReasonInternalError | |
| message | String | 错误信息描述 | Internal error occurred | |
| returnObj | Object | 返回信息 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| requestId | String | 请求ID | b0a55967-825e-4037-a1e2-c1320485 | |
| dataCacheId | String | 数据缓存ID | edc-kas70z3f11rs9l3r |
枚举参数
无
请求示例
请求url
POST https://eci-global.ctapi-test.ctyun.cn:21443/eci/api/v1/dataCache/createDataCache
请求头header
regionId: bb9fdb42056f11eda1610242ac110002
请求体body
{
"securityGroupId": "sg-nz9vppn0fo",
"subnetId": "subnet-uisqhhfqep",
"vpcId":"vpc-717d87ek7m",
"azName": "cn-huadong1-jsnj1A-public-ctcloud",
"bucket":"testbucket",
"path":"testpath",
"dataCacheName":"testedc",
"dataSource": {
"dataSourceType": "GIT",
"dataSourceOption":{
"git":{
"url":"https://hf-mirror.com/datasets/fka/awesome-chatgpt-prompts"
}
}
},
"size":40,
"eip":{
"autoCreateEip":true,
"eipBandwidth":10
}
}
响应示例
{
"statusCode": 200,
"returnObj": {
"requestId": "c8584614-daa4-475e-a8c3-113dc8f108c1",
"dataCacheId": "edc-kas70z3f11rs9l3r"
}
}
状态码
请参考 状态码
错误码
请参考 错误码
