在集群中创建一个数据卷。

请求信息

请求行 RequestLine

POST /volumes/create HTTP/1.1

请求行参数 URI Param

特有请求头 RequestHead

Content-Type: application/json

请求体 RequestBody

JSON object

{
    "name": "***",
    "driver": "***",
    "driverOpts": {
       "para1": "value",
       "para2": "value",
       ...
    }
}

请求体解释

名称 类型 必须 描述
name string 数据卷名称。名称为 1~64 个字符,可包含数字,英文字符和连字符(-),且不能以连字符(-)开头。
driver string

数据卷类型。当前支持 ossfs,nas 类型。

driverOpts DriverOptions

数据卷配置参数选项,不同数据卷类型的参数不相同;OSS 数据卷为 OSSOpts,NAS 数据卷类型为 NASOpts。

各类型数据卷的定义如下所示:

OSSOpts:

名称 类型 必须 描述
bucket string OSS 存储的 bucket 名称,可以从 OSS 控制台获取。
ak_id string 用户访问 OSS 资源所需的 Access Key ID。

参见 如何获取 Access ID 和 Access Key

ak_secret string 用户访问 OSS 资源所需的 Access Key Secret。
url string OSS bucket 所提供的域名,可以从 OSS 控制台获取。
no_stat_cache string 文件缓存,如果需要在不同机器间同步同一个文件的修改,请关闭缓存。
other_opts string 连接 OSS 的配置参数,详见 FAQ

NASOpts:

名称 类型 必须 描述
diskid string NAS 实例的磁盘 ID。
host string NAS 实例的接入点域名,详见 NAS 使用文档。
path string NAS 路径下的子目录,详见 NAS 使用文档。
mode string 配置数据卷的访问权限。

返回信息

返回行 ResponseLine

HTTP/1.1 201 Created

返回体 ResponseBody

JSON object

{
"Name": "volume",
"Driver": "***",
"Mountpoint": "/mnt/acs_mnt/**/***",
"Labels": null,
"Scope": ""
}

返回体解释

名称 类型 描述
Name string 数据卷名称。
Driver string

数据卷的驱动类型:ossfs,nas 等。

Mountpoint string 数据卷在主机上的挂载点:/mnt/acs_mnt/**/***
Labels map[string]string 数据卷的元数据信息。
Scope string 描述数据卷管理范围。global 表示集群级别;local 表示主机内部。

OSS 数据卷示例

请求示例

{
    "name": "ossvolume",    
    "driver": "ossfs",    
    "driverOpts": {
       "bucket": "aliyun-docker",   
       "ak_id": "****", 
       "ak_secret": "*****",  
       "url": "oss-cn-hangzhou.aliyuncs.com",  
       "no_stat_cache": "true", 
       "other_opts": "-o allow_other -o default_permission=666"
  }
}

返回示例

{
    "Name": "ossvolume",
    "Driver": "ossfs",
    "Mountpoint": "/mnt/acs_mnt/ossfs/aliyun-docker",
    "Labels": null,
    "Scope": ""
}

NAS 数据卷示例

请求示例

{
    "name": "nasvolume",    
    "driver": "nas",    
    "driverOpts": {
       "diskid": "1234556",   
       "host": "1234556-gpp53.cn-hangzhou.nas.aliyuncs.com", 
       "path": "/abc",  
       "mode": "755" 
  }
}

返回示例

{
    "Name": "nasvolume",
    "Driver": "nas",
    "Mountpoint": "/mnt/acs_mnt/nas/nasvolume",
    "Labels": null,
    "Scope": ""
}