CFS-Open-API(删除)
更新时间:2024-12-13
如果您是初次调用百度智能云产品的API,可以观看API入门视频指南,快速掌握调用API的方法。
文件系统
CreateFileSystem创建文件系统
描述
- 创建一个cfs文件系统,返回分配的实例ID。
- 付费方式为后付费。
请求
请求结构
Plain Text
1POST /v{version}/cfs HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "fsName": name,
7 "zone": zonB,
8 "type": type,
9 "protocol": protocol
10 "tags": [
11 {"tagKey": "aaa", "tagValue": "bbb"}
12 ]
13 "capacityQuota": 1075838976
14}
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1。 |
fsName | String | 是 | RequestBody参数 | FileSystem的名称,方便记忆。长度1~65个字节,字母开头,可包含字母数字-_/.字符。 |
zone | String | 是 | RequestBody参数 | FileSystem所在可用区,例如zoneB。 |
type | String | 否 | RequestBody参数 | 文件系统类型:1.cap(容量型) 2.ssd(性能型) 当前默认是容量型 |
protocol | String | 否 | RequestBody参数 | 协议类型:1.nfs 2.smb,默认nfs协议。 |
tags | List<Tag> | 否 | RequestBody参数 | |
capacityQuota | uint64 | 否 | RequestBody参数 | 文件系统的quota值,不选或者值为0是表示无自定义硬限,否则表示上限容量(设置时最小为1GB,最大为10PB),单位 bytes。 |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
fsId | String | FileSystem的ID。后续针对该实例的操作,均需要在请求中带上此ID。 |
示例
请求:
Plain Text
1POST /v1/cfs HTTP/1.1
2HOST cfs.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4{
5 "fsName":"cfs-for-test"
6}
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7{
8 "fsId":"cfs-jVDkWrBBoj"
9}
UpdateFileSystem更新文件系统
描述
更新一个filesystem的配置信息。
请求
请求结构
Plain Text
1PUT /v{version}/cfs/{fsId} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "fsName": name
6 "capacityQuota": 1075838976
7}
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1。 |
fsId | String | 是 | URL参数 | 待更新的FileSystem的ID。 |
fsName | String | 否 | RequestBody参数 | FileSystem的名称,方便记忆。长度1~65个字节,字母开头,可包含字母数字-_/.字符。 |
capacityQuota | uint64 | 否 | RequestBody参数 | 更新之后的quota值,不选或者值为0是表示无自定义硬限,否则表示上限容量(设置时最小为1GB,最大为10PB),单位 bytes。 |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数:无
示例
请求:
Plain Text
1PUT /v1/cfs/cfs-jVDkWrBBoj HTTP/1.1
2HOST cfs.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4{
5 "fsName":"cfs-for-test"
6}
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
DescribeFileSystem查询文件系统
描述
- 查询用户账户下的所有FileSystem信息。
- 支持按fsId、userId,匹配规则支持部分包含。
- 返回结果是多重查询条件的交集
- 结果支持marker分页,分页大小默认为1000,可通过maxKeys参数指定
请求
请求结构
Plain Text
1GET /v{version}/cfs?fsId={fsId}&userId={userId}&marker={marker}&maxKeys={maxKeys}&filterTag={filterTag} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
userId | String | 是 | Query参数 | 要查询文件系统所属的用户ID |
fsId | String | 否 | Query参数 | 要查询的FileSystem ID |
marker | String | 否 | Query参数 | 批量获取列表的查询的起始位置,是一个由系统生成的字符串 |
maxKeys | int | 否 | Query参数 | 每页包含的最大数量,最大数量不超过1000。缺省值为1000 |
filterTag | String | 否 | Query参数 | {key}:{value}格式 查询key下所有值为 {key}:@@@ |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
fileSystemList | List<FileSystemModel> | 包含查询结果的列表 |
marker | String | 标记查询的起始位置,若结果列表为空,此项不存在 |
isTruncated | boolean | true表示后面还有数据,false表示已经是最后一页 |
nextMarker | String | 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现 |
maxKeys | int | 每页结果包含的数量 |
示例
请求:
Plain Text
1GET /v1/cfs?fsId=cfs-jVDkWrBBoj&maxKeys=2 HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
响应
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "fileSystemList": [
10 {
11 "fsId": "cfs-jVDkWrBBoj",
12 "status": available,
13 "name": "test-cfs",
14 "type": "cap",
15 "protocol": "nfs",
16 "vpcId":"",
17 "mountTargetList": [
18 {
19 "domain": "cfs-jVDkWrBBoj-jowjsoosdkwe.bce.qa.sandbox.baidu.com",
20 "subnetId": "sbn-qwkkxpvenm0z",
21 "mountId": "70445147635732514f306c5a466a38394450385a37513d3e",
22 "ovip": "128.0.0.1"
23 }
24 ]
25 },
26 ],
27 "marker": "cfs-jVDkWrBBoj",
28 "isTruncated": false,
29 "maxKeys": 1
30}
DropFileSystem释放文件系统实例
描述
- 释放指定的FileSystem,被释放的FileSystem超过回收时间后会被永远删除,无法找回
请求
请求结构
Plain Text
1DELETE /v{version}/cfs/{fsId} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
fsId | String | 是 | URL参数 | 待释放的FileSystem的ID |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数:无
示例
请求:
Plain Text
1DELETE /v1/cfs/cfs-jVDkWrBBoj HTTP/1.1
2HOST cfs.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
UpdateFileSystemTags更新文件系统标签
描述
-
更新文件系统标签
- 指定单个FileSystem时,将此FileSystem标签全量更新为参数指定的标签 (不填标签则解绑该FileSystem所有标签)
- 指定多个FileSystem时,将指定的FileSystem标签增加参数指定的标签 (不填标签则无实际作用)
- 可传FileSystem个数限制为10,标签个数限制为100
请求
请求结构
Plain Text
1POST /v{version}/cfs?tag HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "fsId": [
7 "cfs-xxxxx",
8 "cfs-yyyyy"
9 ],
10 "tags": [
11 { "tagKey": "aaa", "tagValue": "bbb" },
12 { "tagKey": "bbb", "tagValue": "ccc" }
13 ]
14}
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
tag | None | 是 | Query参数 | |
fsId | List<String> | 是 | RequestBody参数 | FileSystem ID 列表 |
tags | List<Tag> | 否 | RequestBody参数 |
返回参数:除公共头域外,无其他特殊头域
示例
请求:
Plain Text
1POST /v{version}/cfs?tag HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "fsId": [
7 "cfs-xxxxx",
8 "cfs-yyyyy"
9 ],
10 "tags": [
11 { "tagKey": "aaa", "tagValue": "bbb" },
12 { "tagKey": "bbb", "tagValue": "ccc" }
13 ]
14}
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
挂载点
CreateMountTarget创建挂载点
描述
- 创建一个文件系统的挂载点,返回domain。
- 付费方式为后付费。
请求
请求结构
Plain Text
1POST /v{version}/cfs/{fsId} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "subnetId": subnetId
6}
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
fsId | String | 是 | URL参数 | 待创建MountTarget的FileSystem的ID |
subnetId | String | 是 | RequestBody参数 | MountTarget所属子网,subnet属于fs所在vpc,为短id |
vpcId | String | 是 | RequestBody参数 | fs实例vip所属VPC的短Id |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
domain | String | 分配的服务dns,通过此dns执行文件系统挂载,即可访问服务 |
mountId | String | mount点的ID |
示例
请求:
Plain Text
1POST /v1/cfs/cfs-jVDkWrBBoj HTTP/1.1
2HOST cfs.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "subnetId":"sbn-qwkkxpvenm0z"
7}
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7{
8 "mountId" : "53585364776c6d577a2f424444796a2b6641584251773d3d"
9 "domain":"cfs-jVDkWrBBoj-sdfoijnvsdf.bce.qa.sandbox.baidu.com"
10}
DeleteMountTarget删除挂载点
描述
- 释放指定的FileSystem的MountTarget
请求
请求结构
Plain Text
1DELETE /v{version}/cfs/{fsId}/{mountId} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
请求头域
除公共头域外,无其他特殊头域
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
fsId | String | 是 | URL参数 | 待释放的target的FileSystem的ID |
mountId | String | 是 | URL参数 | 待释放的target的ID |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数:无
示例
请求:
Plain Text
1DELETE /v1/cfs/cfs-jVDkWrBBoj/53585364776c6d577a2f424444796a2b6641584251773d3d HTTP/1.1
2HOST cfs.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
DescribeMountTarget描述挂载点
描述
- 查询指定文件系统下的所有MountTarget信息。
- 返回结果是多重查询条件的交集
- 结果支持marker分页,分页大小默认为1000,可通过maxKeys参数指定
请求
请求结构
Plain Text
1GET /v{version}/cfs/{fId}?&mountId={mountId}&marker={marker}&maxKeys={maxKeys} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
请求头域:除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
fsId | String | 是 | URL参数 | 要查询的FileSystem ID |
mountId | String | 否 | Query参数 | 要查询的MountTarget的ID |
marker | String | 否 | Query参数 | 批量获取列表的查询的起始位置,是一个由系统生成的字符串 |
maxKeys | int | 否 | Query参数 | 每页包含的最大数量,最大数量不超过1000。缺省值为1000 |
响应
返回状态码:成功返回200,失败返回见错误码
返回头域:除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
mountTargetList | List<MountTargetModel> | 包含查询结果的列表 |
marker | String | 标记查询的起始位置,若结果列表为空,此项不存在 |
isTruncated | boolean | true表示后面还有数据,false表示已经是最后一页 |
nextMarker | String | 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现 |
maxKeys | int | 每页包含的最大数量 |
示例
请求:
Plain Text
1GET /v1/cfs/cfs-jVDkWrBBoj?maxKeys=100 HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
响应:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "mountTargetList": [
10 {
11 "domain": "cfs-jVDkWrBBoj-xsjkusdgffes.bce.qa.sandbox.baidu.com",
12 "subnetId": "sbn-qwkkxpvenm0z"
13 "mountId": "53585364776c6d577a2f424444796a2b6641584251773d3d",
14 "ovip": "128.0.0.1"
15
16 },
17 {
18 "domain": "cfs-jVDkWrBBoj-kweicskdgsev.bce.qa.sandbox.baidu.com",
19 "subnetId": "sbn-keisnlekndsw"
20 "mountId": "36684e635250353569345454684e76364c36457057513d3d",
21 "ovip": "128.1.0.1"
22 }
23 ],
24 "marker": "kweicskdgsev",
25 "nextMarker": "kweicskdgsev",
26 "isTruncated": false,
27 "maxKeys": 2
28}