其他功能
除了上述快速部署服务的命令外,我们的脚本还封装了完整的CFS API操作命令。
更新文件系统实例
描述:
- 更新一个CFS文件系统实例的配置信息(目前仅支持更新fsName)。
使用以下命令对文件系统实例进行更新:
python cfs.py --command=UpdateCFS --region=bj --accessKey=ak --secretKey=sk --fsId=cfs-lEh0GrO84J [--fsName=new_name]
必填参数:
- accessKey和secretKey用于身份验证
- region用于配置服务域名,具体请参见服务域名。
- fsId为待更新的文件系统实例的ID
可选参数:
- fsName为更新后的文件系统实例名。默认为空,即不做任何更新操作。
返回信息为:
httpStatus: 200
('content-length', '2')
('x-application-context', 'application:8688')
('server', 'BaiduBS/1.0')
('connection', 'keep-alive')
('date', 'Tue, 03 Apr 2018 03:26:23 GMT')
('x-bce-request-id', '307946d7-7745-4818-8406-e68489005a4c')
('content-type', 'application/json;charset=UTF-8')
body:
{}
查询文件系统实例
描述:
- 查询用户账户下的所有CFS文件系统实例信息
- 支持按fsId或userId查询,匹配规则支持部分包含
- 返回结果是多重查询条件的交集
- 结果支持marker分页,分页大小默认为1000,可通过maxKeys参数指定
使用以下命令查询文件系统实例:
python cfs.py --command=ListCFS --region=bj --accessKey=ak --secretKey=sk [--fsId=cfs-lEh0GrO84J]
必填参数:
- accessKey和secretKey用于身份验证
- region用于配置服务域名,具体请参见服务域名。
可选参数:
- fsId为待查询的文件系统实例ID;默认值为空,将会返回该用户(userId)创建的所有实例。
- marker是指批量获取列表的查询的起始位置,是一个由系统生成的字符串(与fsId等价);默认值为空,表示从头开始查询。
- maxKeys表示每页包含的最大数量,最大数量不超过1000,缺省值为1000。
返回信息为:
httpStatus: 200
('content-length', '207')
('x-application-context', 'application:8688')
('server', 'BaiduBS/1.0')
('connection', 'keep-alive')
('date', 'Tue, 03 Apr 2018 03:25:14 GMT')
('x-bce-request-id', 'cdb57595-62d8-4aa7-a5b3-bd0999eb40e0')
('content-type', 'application/json;charset=UTF-8')
body:
{
"FileSystemList": [
{
"MountTargetList": [],
"fsId": "cfs-lEh0GrO84J",
"fsName": "test_cfs10",
"protocol": "nfs",
"status": "available",
"type": "cap",
"vpcId": "vpc-a3ashy00skpu"
}
],
"isTruncated": false
}
其中,FileSystemList是包含查询结果的列表,成员类型为FileSystemModel。若结果列表为空,则marker项不存在。isTruncated=true表示数据未显示完,为false表示已全部显示。isTruncated为true时由nextMarker域指定获取下一页所需要传递的marker值。maxKeys为每页结果包含的最大数量。
删除文件系统实例
描述:
- 释放指定的CFS文件系统实例,被释放的FileSystem超过回收时间后会被永远删除,无法找回
注意:删除文件系统前必须删除该文件系统的所有挂载点
使用以下命令删除一个文件系统实例:
python cfs.py --command=DropCFS --region=bj --accessKey=ak --secretKey=sk --fsId=cfs-lEh0GrO84J
必填参数:
- accessKey和secretKey用于身份验证
- region用于配置服务域名,具体请参见服务域名。
- fsId为待删除的文件系统实例ID
返回信息为:
httpStatus: 200
('content-length', '2')
('x-application-context', 'application:8688')
('server', 'BaiduBS/1.0')
('connection', 'keep-alive')
('date', 'Tue, 03 Apr 2018 03:33:41 GMT')
('x-bce-request-id', '4cef898c-8c7b-44fd-b950-e85f11a08adb')
('content-type', 'application/json;charset=UTF-8')
body:
{}
查询挂载点
描述
- 查询指定CFS文件系统实例的所有MountTarget信息
- 返回结果是多重查询条件的交集
- 结果支持marker分页,分页大小默认为1000,可通过maxKeys参数指定
使用以下命令对挂载点进行查询:
python cfs.py --command=ListMountTarget --region=bj --accessKey=ak --secretKey=sk --fsId=cfs-lEh0GrO84J [--mountId=36684e635250353569345454684e76364c36457057513d3d]
必填参数:
- accessKey和secretKey用于身份验证
- region用于配置服务域名,具体请参见服务域名。
- fsId为待查询的文件系统实例的ID
可选参数:
- mountId为待查询的挂载点ID, 默认值为空,即返回实例所有挂载点信息
- marker为查询起始点标记,默认从头开始;maxKeys单页显示条数,默认值1000
返回信息为:
httpStatus: 200
('content-length', '217')
('x-application-context', 'application:8688')
('server', 'BaiduBS/1.0')
('connection', 'keep-alive')
('date', 'Tue, 03 Apr 2018 03:31:34 GMT')
('x-bce-request-id', 'c31f64e3-0ef9-405f-bbfc-df8356f7d5fe')
('content-type', 'application/json;charset=UTF-8')
body:
{
"MountTargetList": [
{
"domain": "cfs-lEh0GrO84J.lb-d12c1c31.bce.qa.sandbox.baidu.com",
"mountId": "36684e635250353569345454684e76364c36457057513d3d",
"subnetId": "sbn-qwkkxpvenm0z"
}
],
"isTruncated": false
}
其中,MountTargetList为包含查询结果的列表,成员类型为MountTargetModel。
删除挂载点
描述:
- 释放指定的FileSystem的MountTarget
使用以下指令删除指定的挂载点:
python cfs.py --command=DropMountTarget --region=bj --accessKey=ak --secretKey=sk --fsId=cfs-lEh0GrO84J --mountId=36684e635250353569345454684e76364c36457057513d3d
必填参数:
- accessKey和secretKey用于身份验证
- region用于配置服务域名,具体请参见服务域名。
- fsId为待删除的挂载点所在文件系统ID
- mountId为待删除的挂载点ID
返回信息为:
httpStatus: 200
('content-length', '2')
('x-application-context', 'application:8688')
('server', 'BaiduBS/1.0')
('connection', 'keep-alive')
('date', 'Tue, 03 Apr 2018 03:32:51 GMT')
('x-bce-request-id', 'fb229c07-532d-4b4a-9dec-25c81d0e410a')
('content-type', 'application/json;charset=UTF-8')
body:
{}