Swift API和Command

最新推荐文章于 2022-10-22 20:32:39 发布
最新推荐文章于 2022-10-22 20:32:39 发布
阅读量1.5k 收藏
点赞数
分类专栏： Swift 文章标签： Swift Command api
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/sinat_27186785/article/details/51957103
版权

Restful API使用描述 

使用限制

 Account(账户)   Container(容器)   Object(对象)    metadata(元数据)

  1. 元数据（metadata）的总个数不能大于90个,且所有元数据总大小不能超过4KB
  2. 元数据名字长度不能大于128个字节
  3. 元数据值的长度不能大于256个字节
  4. 对象最大不能超过5G，超过则需要分割后在上传
  5. 对象名字的总长度不能超过1024个字节
  6. 账户名字的总长度不能超过256个字节
  7. 容器名字的总长度不能超过256个字节
  8. 列取账户中容器的时候一次返回容器个数最大为10000个，如果账户中有超过10000个容器的则需要采用分批获取的方式来获取,列取容器中的对象也一样
  9. 账户名、容器名、对象名和元数据都需要是utf-8或者unicode编码
  10. iQiyi内部的Swift已将对象的自动过期功能取消
  11. HTTP请求的头总大小不能超过8KB

获取token

接口名称：

 
获取一个token ID

接口定义：

 
curl -X POST -d '
{"auth":
        {"tenantName": “{租户名}”,
         "passwordCredentials": {
            "username": “{用户名}”,
            "password": “{用户密码}”}
        }
 }' 
-H "Content-type: application/json" http://localhost:5000/v2.0/tokens | python -mjson.tool
 

传入参数定义：

 
{"tenantName": “{租户名}”,
     "passwordCredentials": {
     "username": “{用户名}”,
     "password": “{用户密码}”}
}
 

返回结果：

 
返回结果很长，token字段如下：
 "token": {
            "expires": "2013-07-20T08:15:57Z", 
            "id": "c38bcd05c19a4ec7b7f8d0c58b110aac", 
            "tenant": {
                "description": null, 
                "enabled": true, 
                "id": "321879173bf44366a76ba34e84d71d00", 
                "name": "service"
            }
    }, 
在以下的接口操作中，都需要从该token中获取它的id，以及其对应租户（tenant）的id。

协议：

 
http

示例：

 
keystone: curl -X POST -d '{"auth": {"tenantName": "service", "passwordCredentials":{"username": "root", "password": "passwd"}}}' -H "Content-type: application/json" http://10.23.70.116:35357/v2.0/tokens | python -mjson.tool

 tempauth: curl -k -v -H 'X-Storage-User: vtc:vtc' -H 'X-Storage-Pass: transcode' http://10.121.56.114:8080/auth/v1.0


存储状态查询

接口名称：

 
存储状态查询

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id} \
     -X HEAD \
     -D -\
     -H "X-Auth-Token: { Token_id}"
 

传入参数定义：

 
Tenant_id：租户id
Token_id：租户对应的token的id

返回结果：

  返回当前租户容器和对象数量

协议：

 
http

示例：

 
curl -s http://10.23.70.117:80/v1/AUTH_5a7bfc63f66c4c6cbdb6c744900c3e09 -X HEAD -D - -H "X-Auth-Token: a3301390309943818d35816fefea50c5"


获取容器列表

接口名称：

 
获取容器列表

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id} \
     -X GET \

           -D -\

     -H "X-Auth-Token: { Token_id}"
如果需要指定输出几个容器可以在加上后缀？limit=number
如果需要指定格式，加上后缀？format=json

传入参数定义：

 
Tenant_id：租户id
Token_id：租户对应的token的id

返回结果：

  返回当前租户下所有的容器

协议：

 
http

示例：

 
 curl -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00 -X GET -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"


创建容器

接口名称：

 
创建容器

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name} \
     -X PUT \

           -D -\

     -H "X-Auth-Token: { Token_id}"
 

传入参数定义：

 
Tenant_id：租户id
Container_name: 所创建的容器名称
Token_id：租户对应的token的id

返回结果：

 
如果创建成功，返回“201 Created”

协议：

 
http

示例：

 
curl -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00/testcontainer2 -X PUT -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"

 查看容器的metadata

接口名称：

 
查看容器的metadata

接口定义：

 
curl -i -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name} \
     -X HEAD \

           -D -\

     -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
返回container的matadata。

协议：

 
http

示例：

 
curl -i -s http://10.23.70.117:80/v1/AUTH_5a7bfc63f66c4c6cbdb6c744900c3e09/codecloud -X HEAD -D - -H "X-Auth-Token: a3301390309943818d35816fefea50c5"


删除容器

接口名称：

 
删除容器

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name} \
     -X DELETE \
     -D - -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
如果删除成功，什么也没返回。可以使用列出容器的api验证。

协议：

 
http

示例：

 
curl -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00/testcontainer2 -X DELETE -D - -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"


列出对象

接口名称：

 
列出容器对象

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_name}[?parm=value] \
     -X GET \
     -D - -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Container_name: 容器名称
Token_id：租户对应的token的id

返回结果：

 
 如果容器中的对象超过10000,则默认返回按字母排序的前10000个对象,关于如何返回后面的对象请参考OpenStack Swift官方API

协议：

 
http

示例：

 
curl -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00/testcontainer -X GET -D - -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"


创建对象

接口名称：

 
创建对象

接口定义：

 
curl –X PUT -i \
    -D - -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 -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00/testcontainer/install.log -T ~/install.log -X PUT -D - -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"


删除对象

接口名称：

 
删除对象

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/{object_name} \
     -X DELETE \
     -D - -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Obj_name：对象名称
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
无返回

协议：

 
http

示例：

 
curl -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00/testcontainer/install.log -X DELETE -D - -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"


下载对象

接口名称：

 
下载对象

接口定义：

 
curl -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/{object_name} >Dest path\
     -X GET -D -\
     -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Obj_name：对象名称
Container_name: 所删除的容器名称
Token_id：租户对应的token的id
Dest path:下载到的目标文件的path

返回结果：

 
无返回

协议：

 
http

示例：

 
curl -s http://10.23.70.116:8080/v1/AUTH_321879173bf44366a76ba34e84d71d00/testcontainer/remi-release-6.rpm>~/backup2/remi-release-6.rpm -X GET -H "X-Auth-Token: 1cb6d6b77ef54274870490b5f1e5e6a3"

查看对象metadata

接口名称：

 
查看对象的metadata

接口定义：

 
curl -k -i -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/{object_name} \
     -X HEAD -D -\
     -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Obj_name：对象名称
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
在HTTP头中返回对象的metadata,自定义的metadata都带有X-Object-Meta前缀

协议：

 
http

示例：

 curl -k -i -s http://10.23.70.117:80/v1/AUTH_5a7bfc63f66c4c6cbdb6c744900c3e09/codecloud/install.log -X HEAD -D - -H "X-Auth-Token: a3301390309943818d35816fefea50c5"

更新对象metadata

接口名称：

 
更新对象的metadata,一个对象的所有metadata总大小不能超过4KB,而且metadata个数不能超过90个

接口定义：

 
curl -k -i -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/{object_name} \
     -X POST \
     -H "X-Object-Meta-metadata_name:new_value" \
     -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Obj_name：对象名称
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
返回202，表示accepted

协议：

 
http

示例：

 curl -k -i -s http://10.23.70.117:80/v1/AUTH_5a7bfc63f66c4c6cbdb6c744900c3e09/codecloud/install.log -H "X-Timestamp:1375243435.75728" -X POST -H "X-Auth-Token: a3301390309943818d35816fefea50c5"

Command的使用

swift提供的命令行接口进行操作。

 command function   example
 stat [container] [object]  获取容器或者对象的状态信息  swift -V 2 -A http://10.23.70.116:5000/v2.0 -U service:root -K passwd stat
 list [options] [container]  获取容器的对象列表  swift -V 2 -A http://10.23.70.116:5000/v2.0 -U service:root -K passwd list codecloud
 upload [options] container file_or_directory [file_or_directory] [...]  上传对象到指定容器  swift -V 2 -A http://10.23.70.116:5000/v2.0 -U service:root -K passwd upload codecloud install.log
 post [options] [container] [object] 对容器，账号和对象的metadata进行修改，如果没有，就会创建一个新容器。    swift -V 2 -A http://10.23.70.116:5000/v2.0 -U service:root -K passwd post codecloudnew
 download --all OR download container [options] [object] [object]  下载对象

 swift -V 2 -A http://10.23.70.116:5000/v2.0 -U service:root -K passwd downlaod codecloud  install.log

 delete [options] --all OR delete container [options] [object] [object] ...  删除对象  swift -V 2 -A http://10.23.70.116:5000/v2.0 -U service:root -K passwd delete codecloud install.log

关于Api更多的细节参考：http://docs.openstack.org/api/openstack-object-storage/1.0/content/

设置匿名读取或者put某个container和下面的object

接口名称：

 
匿名读取container及其下面的object

接口定义：

 
curl -k -i -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/\
     -X PUT \
     -H "X-Container-Read: .r:*"\

           -H "X-Container-Write: .r:*"\

     -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
返回201，表示成功

协议：

 
http

示例：

curl -s http://10.23.70.127:8080/v1/AUTH_f02c22db84c54525927353bab5d36b38/containertest2 -X PUT -H "X-Container-Read: .r:*,.rlistings" -H "X-Auth-Token: ae93a81d50d643d8ae4d8cef67f667fb   

curl -s http://10.153.88.41:8080/v1/AUTH_e24d47652113493686492d2e7c04e601/hotchatting-X PUT -H "X-Container-Write: .r:*" -H "X-Auth-Token: 1ed0e9900cd84ecc9f6b71f3d7b2726c

 


Next, if you use keystone you need(!!!!) to set in /etc/swift/proxy-server.conf

[filter:authtoken]
paste.filter_factory = keystone.middleware.auth_token:filter_factory
# Delaying the auth decision is required to support token-less
# usage for anonymous referrers (‘.r:*’).
delay_auth_decision = 1

 然后可以匿名访问这个容器和下面的对象了

wget http://10.23.70.127:8080/v1/AUTH_f02c22db84c54525927353bab5d36b38/containertest2/setuptools-1.0.tar.gz


设置container读和写的权限

接口名称：

 
设置container读和写的权限(单独设置某一个账号对这个container的读或者写（读）的权限

接口定义：

 
curl -k -i -s http://localhost:8080/v1/AUTH_{Tenant_id}/{Container_id}/\
     -X PUT \
     -H "X-Container-Read: tenant_name:account_name"\

           -H "X-Container-Write:tenant_name:account_name"\

     -H "X-Auth-Token: { Token_id}"

传入参数定义：

 
Tenant_id：租户id
Container_name: 所删除的容器名称
Token_id：租户对应的token的id

返回结果：

 
返回201，表示成功

协议：

 
http

示例：

 curl -k -i -s http://10.23.70.127:8080/v1/AUTH_b9d8185513404fc7a85db0a257e2142a/testcontainer -H 'X-Container-Read: containertest:share1' -X PUT -D - -H "X-Auth-Token: 5d95cfbfe970498188fb0c568ed0670a" #containertest:share1这个账户对testcontainer有读的权限

 

HeyManLeader
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
jazzy生成Swift API文档
C
12-11 400
安装 jazzy sudo gem install jazzy cd 你项目的文件夹（到xcodeproj文件目录） 生成 html 文件在项目目录下 其他 jazzy 命令 jazzy --clean --author MyName --author_url https://mydomain.com/ --xcodebuild-arguments -workspace,My-App.xcworkspace,-scheme,My-App --output docs/swif
swift 2.3中文版文档API
10-31
The Swift Programming Language 中文版 - v2.3
swift-一个API描述文档自动生成Swift执行代码的工具
08-15
一个API描述文档自动生成Swift执行代码的工具
command api
gamer243的专栏
03-26 577
PTSTR GetCommandLine(); 获取一个指向进程的完整的命令行指针。PWSTR * CommandLineToArgvW( PWSTR pszCmdLine,int *pNunArgs) ; 将任何Unicode字符串分解成单独的标记（这个函数只是Unicode版本）。
设计模式之 Command 命令模式：Swift 实现
最新发布
iOS 开发
10-22 160
命令模式的作用在于，将消息的发送者和接收者分离开。接收者和命令相连接，命令和发送者相连接；发送者者发送消息可以直接被接受者收到并且处理。
swift-CommandLine-一个用于创建命令行界面的纯Swift库
08-15
CommandLine - 一个用于创建命令行界面的纯Swift库
Swift 07 命令模式 Command Pattern
KK匡的博客
10-02 246
/* 大宏药业的制药机器有2个按钮，按钮A、按钮B。 机械操作员不需要知道具体的机械操作原理、只需要透过机器界面操作按钮。 机器有2个功能：包装药品、出货药品 把操作发送者和执行接受者的控件解耦、当新增功能、更改操作界面更容易。 */ protocol Operation { func operate() } class Wrap : Operation { func operate()
CommandLine：用于创建命令行界面的纯Swift库
02-06
- **类型安全**：由于是用Swift编写，`CommandLine`库提供了类型安全的API，避免了运行时错误。 4. **使用CommandLine库** - **安装**：可以通过Swift Package Manager（SPM）将`CommandLine`添加到你的项目中，...
swift-iOS中深度API的代码示例
08-15
在Swift编程语言中，iOS深度API（通常指的是Core Image、Metal Performance Shaders和SceneKit等框架）为开发者提供了处理图像、视频以及实现高级图形效果的能力。这些API在游戏开发、实时滤镜应用、增强现实（AR）...
Command-Line-2:在MACOSX命令行中执行其他程序的Swift示例
04-13
在Swift编程语言中，开发人员有时...通过这个库，我们可以轻松地集成系统命令到我们的Swift应用中，从而实现更多系统级别的功能和交互。在实际项目中，理解并熟练使用`ShellOut`能够大大提高开发效率和代码的可维护性。
:spouting_whale:cujira是一个命令行工具，可轻松显示来自Jira的问题列表。-Swift开发
05-27
注册域，用户名和apikey。 域是https：// [此处] .atlassian.net。 用户名是您注册了Jira的电子邮件。 apikey可以从https://id.atlassian.com/manage/api-tokens获得。 请执行这三个命令。 $ cujira注册域XXX $ ...
swift python api，开发swift必备文档
09-12
swift python api，很好的开发指南，对于C C++ java 都是很有利的
Swift设计模式之命令模式
aotian16的专栏
05-12 649
转自 Swift设计模式 原文 Design-Patterns-In-Swift // 命令模式 // 百度百科：一组行为抽象为对象，实现二者之间的松耦合 // 设计模式分类：行为型模式/** * 命令接口 */ protocol LightCommand { /** 执行命令 - returns: 结果 */ func execute() -> S
Sketchup二次开发API之Command类
weixin_33724659的博客
03-14 296
Command类是Sketchup二次开中一个重要的类别，用来向Sketchup添加插件的核心代码，基本用法如下。 cmd = UI::Command.new(""){   UI.messagebox("My Command") } cmd.menu_text = "My Command" UI.menu("Draw").add_item cmd ...
Swift设计模式——Command Pattern
我是小小的搬运工
11-12 501
Command 模式是一种数据驱动的设计模式，属于行为模式类。 通常做法：把请求包含在一个对象中以命令的形式传递给请求者，请求者查找能够处理上述命令的对象，执行相关操作。 DEMO说明： 1、Order 对应上文提到的命令； 2、Stock 对应上文提到的请求； 3、buyStock 和 sellStock 实现Order接口，是实际执行command命令的对象类； 4、Broker 对应上文提到的请求者，确定具体执行哪个类型的命令; func buy(){ print("
SWIFT API 使用文档
ztejiagn的专栏
05-09 3557
http://www.cnblogs.com/lxguidu/archive/2013/04/25/3042137.html 1、背景知识 OpenStack Object Storage (Swift) 是用来创建冗余的、可扩展的对象存储（引擎）的开源软件。 swift使用标准化的服务器存储 PB 级的访问数据。它并不是文件系统或者实时的数据存储系统 ，而是一个用于存储永久类型的
OPENSTACK SWIFT API(中文版本)
做个专家
03-11 4693
使用java代码调用openstack swift接口。需要安装keystone和swift
Ceph分布式存储实践应用之Swift Api配置使用
热门推荐
Mirson - 多一些分享, 多一些进步
04-07 3万+
1. Ceph Swift Api 说明 在ceph的使用上， 之前采用的是fs文件系统， 并编写了相应的api来操作演示。 但在互联网大规模的文件场景下， fs并不能满足生产的使用要求，rados本地化操作也不便于服务的接入与使用, 这里就需要采用Ceph Swift Api 来实现文件的存储管理。 2. Ceph Swift Api 特点 Swift是由Rackspace开发，用来为云计算提供可扩展存储的项目。专注于对象存储， 并提供一套REST风格的Api来访问， 与Ceph强一致性不同， 它是最终
iOS/Swift Rumtime 常用API汇总
lin1109221208的博客
09-03 458
Objective-C Runtime Objective-C runtime是一个运行库，它提供对Objective-C语言的动态属性的支持，因此所有Objective-C应用程序都链接到它。Objective-C运行库支持函数在位于/usr/lib/libobjc.A.dylib的共享库中实现。 在Objective-C中编程时，通常不需要直接使用Objective-C运行时库。此API主要用于开发Objective-C和其他语言之间的桥接层，或用于低级调试。 Objective-C运行库的macO.
使用Swift和SQLite构建iOS数据库应用
6. **Swift与SQLite集成**：深入理解Swift编程语言如何与SQLite数据库进行交互，包括使用Swift的API来执行SQL命令，以及处理查询结果。 7. **高级特性**：探索SQLite的高级特性，如触发器（triggers）和视图（views...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值