SWIFT API 使用文档
来源:互联网 发布:mac pages删除空白页 编辑:程序博客网 时间:2024/05/18 01:56
http://www.cnblogs.com/lxguidu/archive/2013/04/25/3042137.html
1、背景知识
OpenStack Object Storage (Swift) 是用来创建冗余的、可扩展的对象存储(引擎)的开源软件。 swift使用标准化的服务器存储 PB 级的访问数据。它并不是文件系统或者实时的数据存储系统 ,而是一个用于存储永久类型的静态数据的长期存储系统 ,这些数据可以检索、调整、必要时进行更新。最适合存储的数据类型的首要例子是虚拟机镜像,图片存储,邮件存储,存档备份。因为没有中心单元或者主控结点,swift提供了更强的扩展性、冗余和持久性。
OpenStack Object Storage (Swift)使用RESTful API对外提供服务,通过HTTP协议来进行数据间的交互,数据存放在request中。Swift支持单个无文件最大5G,大于5G的文件在客户端切分上传,并上传manifest文件。
图 1-1 SWIFT数据交互
2、API使用描述
1)获取token
接口名称:
获取一个token ID
接口定义:
curl -X POST -d '
{"auth":
{"tenantName": “{租户名}”,
"passwordCredentials": {
"username": “{用户名}”,
"password": “{用户密码}”}
}
}'
-H "Content-type: application/json" http://localhost:35357/v2.0/tokens | python -mjson.tool
传入参数定义:
{"tenantName": “{租户名}”,
"passwordCredentials": {
"username": “{用户名}”,
"password": “{用户密码}”}
}
返回结果:
返回的结果比较冗长,请自己在实验环境192.168.0.191上操作,并观察。而需要注意的是其中token的结果:
"token": {
"expires": "2012-09-27T13:41:15Z",
"id": "d8444bd1ab8140ceb136d748eef86647",
"tenant": {
"description": null,
"enabled": true,
"id": "e8b18580e5b44cb79b10bd0f7a03bbdc",
"name": "admin"
}
}
在以下的接口操作中,都需要从该token中获取它的id,以及其对应租户(tenant)的id。
协议:
http
示例:
curl -X POST -d '{"auth": {"tenantName": "admin", "passwordCredentials":{"username": "admin", "password": "pengchao"}}}' -H "Content-type: application/json" http://192.168.0.191:35357/v2.0/tokens | python -mjson.tool
2)容器列表
接口名称:
获取容器列表
接口定义:
curl -s http://localhost:8080/v1/AUTH_{Tenant_id} \
-X GET \
-H "X-Auth-Token: { Token_id}"
传入参数定义:
Tenant_id:租户id
Token_id:租户对应的token的id
返回结果:
协议:
http
示例:
curl -s http://192.168.0.191:8080/v1/AUTH_e8b18580e5b44cb79b10bd0f7a03bbdc -X GET -H "X-Auth-Token: 22ec6a37ed6b4b23a435e6b9050f21a4"
3)创建容器
接口名称:
创建容器
接口定义:
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name} \
-X PUT \
-H "X-Auth-Token: { Token_id}"
传入参数定义:
Tenant_id:租户id
Container_name: 所创建的容器名称
Token_id:租户对应的token的id
返回结果:
如果创建成功,返回“201 Created”
协议:
http
示例:
curl -s http://192.168.0.191:8080/v1/AUTH_e8b18580e5b44cb79b10bd0f7a03bbdc -X GET -H "X-Auth-Token: 22ec6a37ed6b4b23a435e6b9050f21a4"
4)删除容器
接口名称:
删除容器
接口定义:
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name} \
-X DELETE \
-H "X-Auth-Token: { Token_id}"
传入参数定义:
Tenant_id:租户id
Container_name: 所删除的容器名称
Token_id:租户对应的token的id
返回结果:
如果删除成功,什么也没返回。可以使用列出容器的api验证。
协议:
http
示例:
curl -s http://192.168.0.191:8080/v1/AUTH_e8b18580e5b44cb79b10bd0f7a03bbdc/my_container -X DELETE -H "X-Auth-Token: 22ec6a37ed6b4b23a435e6b9050f21a4"
5)列出对象
接口名称:
列出容器对象
接口定义:
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name}[?parm=value] \
-X GET \
-H "X-Auth-Token: { Token_id}"
传入参数定义:
Tenant_id:租户id
Container_name: 容器名称
Token_id:租户对应的token的id
返回结果:
协议:
http
示例:
curl -s http192.168.0.191:8080/v1/AUTH_AUTH_e8b18580e5b44cb79b10bd0f7a03bbdc/my_container?format=json -X GET -H "X-Auth-Token: 22ec6a37ed6b4b23a435e6b9050f21a4" | python -mjson.tool
6)创建对象
接口名称:
创建对象
接口定义:
curl –X PUT -i \
-H "X-Auth-Token: { Token_id}" \
-T {obj_path} \
http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name}/{obj_name}
传入参数定义:
Tenant_id:租户id
Obj_path:对象的完整路径
obj_name:对象名称
Container_name: 容器名称
Token_id:租户对应的token的id
返回结果:
<html>
<head>
<title>201 Created</title>
</head>
<body>
<h1>201 Created</h1>
<br /><br />
</body>
</html>
协议:
http
示例:
curl -X PUT -i -H "X-Auth-Token: 22ec6a37ed6b4b23a435e6b9050f21a4" -T ufw.log http://192.168.0.191:8080/v1/AUTH_e8b18580e5b44cb79b10bd0f7a03bbdc/my_container/ufw.log
7)删除对象
接口名称:
删除对象
接口定义:
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/{object_name} \
-X DELETE \
-H "X-Auth-Token: { Token_id}"
传入参数定义:
Tenant_id:租户id
Obj_name:对象名称
Container_name: 所删除的容器名称
Token_id:租户对应的token的id
返回结果:
无返回
协议:
http
示例:
curl -s http://192.168.0.191:8080/v1/AUTH_e8b18580e5b44cb79b10bd0f7a03bbdc/my_container/history24 -X DELETE -H "X-Auth-Token: 22ec6a37ed6b4b23a435e6b9050f21a4"
3、实例:使用Python实现
3.1、前提条件
由于数据是存放在request中,为了方便,先构造request,使用python(urllib2)代码实现如下:
@param:server_api 根据需要定义的rest url
@param:autho_token 管理员token
@param:send_data 需要发送的数据
@param:method 定义的方法【GET、PUT、DELETE、POST】,默认是POST
def get_server_request(server_api=None, auth_token=None, send_data=None, method=None):
if not server_api:
return None
server_request = urllib2.Request(server_api)
if not server_request:
return None
server_request.add_header('Content-Type', 'application/json;charset=utf8')
server_request.add_header('Accept', 'application/json')
server_request.add_header('User-Agent', 'python-mikeyp')
if auth_token:
server_request.add_header('X-Auth-Token', auth_token)
if send_data:
server_request.add_data(send_data)
if method:
server_request.get_method = lambda: method
return server_request
1)获取keystone认证,进行任何CURD操作,都需要从keystone中获取管理员的租户ID和管理员的token,用Python代码实现如下:
@param:user_name 管理员
@param:password 管理员密码
@param:tenant_name 管理员对应的租户名称
def get_keystone_token(user_name=None, password=None, tenant_name=None):
server_api = get_Keystone_Endpoint() + 'tokens'
send_data = None
if user_name and password and tenant_name:
send_data = {'auth': {'tenantName': tenant_name, 'passwordCredentials': \
{'username': user_name, 'password': password}}}
if not send_data:
return None
server_request = get_server_request(server_api, None, json.dumps(send_data), None)
if not server_request:
return None
try:
server_response = urllib2.urlopen(server_request)
receiver_data = server_response.read()
if receiver_data:
data = json.loads(receiver_data)
token = data['access']['token']['id']
tenant_id = data['access']['token']['tenant']['id']
return (tenant_id, token)
else:
return None
except Exception:
return None
3.2、主要功能实现
以下的代码都能单独使用,实现的关键在于对request操作,实现如下:
server_response = urllib2.urlopen(server_request)
1)列出容器
'''列出swift容器列表
@param:
@type:
@return:"count","bytes","name"
@rtype:json
'''
def Container_list():
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id
if not server_api:
api_logger.error('Container_list server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token)
api_logger.info('Container_list server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Container_list server_response: %s.' % server_response)
receiver_data = server_response.read()
if receiver_data:
data = json.loads(receiver_data)
con_list = []
for d in data:
con_list.append(d['name'])
return con_list
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Container_list function caught an exception.')
return untils.rest_result(False, True)
2)创建容器
'''创建一个容器
@param:
@type:
@return:"count","bytes","name"
@rtype:json
'''
def Container_create(name=None):
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id + "/" + name
if not server_api:
api_logger.error('Container_create server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token, None, "PUT")
api_logger.info('Container_create server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Container_create server_response: %s.' % server_response)
receiver_data = server_response.read()
if receiver_data:
data = json.dumps(receiver_data)
return untils.rest_result(True, False, data)
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Container_create function caught an exception.')
return untils.rest_result(False, True)
3)删除容器
'''删除一个容器
@param:
@type:
@return:"count","bytes","name"
@rtype:json
'''
def Container_delete(con_name=None):
if con_name not in Container_list():
return untils.rest_result()
obj_list= Object_list(con_name)[0]
if obj_list:
api_logger.info("the contaniner is not empty!")
for obj in obj_list:
Object_delete(con_name,obj)
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id + "/" + con_name
if not server_api:
api_logger.error('Container_delete server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token, None, "DELETE")
api_logger.info('Container_delete server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Container_delete server_response: %s.' % server_response)
receiver_data = server_response.read()
if receiver_data:
data = json.dumps(receiver_data)
return untils.rest_result(True, False, data)
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Container_delete function caught an exception.')
return untils.rest_result(False, True)
4)列出对象
'''列出swift某容器的对象列表
@param container_name:容器名称
@type:char
@return:"bytes","last_modified","hash","name","content_type"
@rtype:json
'''
def Object_list(container_name=None):
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id + "/" + container_name
if not server_api:
api_logger.error('Object_list server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token)
api_logger.info('Object_list server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Object_list server_response: %s.' % server_response)
receiver_data = server_response.read()
if receiver_data:
data = json.loads(receiver_data)
c_l = []
for d in data:
c_l.append(d['name'])
return untils.rest_result(True, False, c_l)
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Object_list function caught an exception.')
return untils.rest_result(False, True)
5)上传对象
'''在一个容器内创建、上传一个对象
@param container_name:容器名称
@param file_name:对象名称
@type:char
@return:
@rtype:json
'''
def Object_upload(container_name=None, obj_path=None, obj_name=None):
send_data = None
obj_full_path = os.path.join(obj_path, obj_name)
with open(obj_full_path) as obj:
send_data = json.dumps(obj.read())
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id + "/" + container_name + "/" + obj_name
if not server_api:
api_logger.error('Object_upload server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token, send_data, 'PUT')
api_logger.info('Object_upload server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Object_upload server_response: %s.' % server_response)
receiver_data = server_response.read().strip()
if receiver_data:
data = json.dumps(receiver_data)
return untils.rest_result(True, False, data)
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Object_upload function caught an exception.')
return untils.rest_result(False, True)
6)下载对象
'''从容器下载一个对象
@param container_name:容器名称
@param file_name:对象名称
@type:char
@return:
@rtype:json
'''
def Object_download(container_name=None, obj_path=None, obj_name=None):
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id + "/" + container_name + "/" + obj_name
if not server_api:
api_logger.error('Object_download server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token)
api_logger.info('Object_download server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Object_download server_response: %s.' % server_response)
receiver_data = server_response.read()
if receiver_data:
obj_full_path = os.path.join(obj_path, obj_name)
with open(obj_full_path, "wb") as code:
code.write(receiver_data)
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Object_download function caught an exception.')
return untils.rest_result(False, True)
7)删除对象
'''从容器删除一个对象
@param container_name:容器名称
@param file_name:对象名称
@type:char
@return:
@rtype:json
'''
def Object_delete(container_name=None, obj_name=None):
server_api = None
if tenant_id:
server_api = untils.get_Swift_Endpoint() + tenant_id + "/" + container_name + "/" + obj_name
if not server_api:
api_logger.error('Object_delete server_api: %s.' % server_api)
return untils.rest_result()
try:
server_request = untils.get_server_request(server_api, token, None, 'DELETE')
api_logger.info('Object_delete server_request: %s.' % server_request)
if not server_request:
return untils.rest_result()
server_response = urllib2.urlopen(server_request)
api_logger.info('Object_delete server_response: %s.' % server_response)
receiver_data = server_response.read()
if receiver_data:
data = json.dumps(receiver_data)
return untils.rest_result(True, False, data)
return untils.rest_result(True, False)
except Exception:
api_logger.critical('Object_delete function caught an exception.')
return untils.rest_result(False, True)
- SWIFT API 使用文档
- Flot使用文档 API
- 使用Java API文档
- Openstack api 学习文档 & restclient使用文档
- Openstack api 学习文档 & restclient使用文档
- Openstack api 学习文档 & restclient使用文档
- 使用API Blueprint创建API文档
- Android如何使用API文档
- java api文档的使用
- 第一次使用英文API文档
- Java-API文档的使用
- Redis常用API-使用文档
- JDK API文档的使用
- Redis常用API-使用文档
- Redis常用API-使用文档
- 使用GTK-DOC自动生成API文档
- DevExpress ASPxGridView 使用文档七:客户端API
- DevExpress ASPxGridView 使用文档七:客户端API
- jQuery,javascript获得网页的高度和宽度 .
- 使用Xmanager在CentOs5.5 安装oracle11g r2
- c文件与h文件及包含关系
- 线程编程中用到HttpContext.Current的方法封装
- C/C++堆、栈及静态数据区详解
- SWIFT API 使用文档
- 接口
- 如果在外网的情况下使用Xmanager无法连接到Linux上
- 搞笑的Spring框架理解
- linux内核中打开文件 及属性控制
- 头文件包含顺序
- C# 使用Oracle.DataAccess.dll注意事项
- C#里面如何利用流获取一个记事本内容的行数
- 设计模式 - 装饰模式