使用云种子

CloudFeed系统使用时需要基本理解RESTAPS
本节描述如何使用云源RESTAPI执行
API基础运维

警告

华体会联盟hth本节假设你使用基于符号认证并成功验证反拉克空间云API并获取验证令牌令牌认证.

请确认记录令牌,因为您需要它来完成本章中的练习信息使用基本认证使用API调用使用基本认证验证.

读进料

取回已贴载的Atom或Atom项时提交获取请求使用下列语法 :

s/endpointURL/feedName/events/

占位符定义于下表

语法元素

云源cURL请求

华体会联盟hthcurl -H "X-Auth-Token: authenticationToken" -X GET https://dfw.feeds.api.rackspacecloud.com/nova/events/tenantID

请求返回25新星反馈自DFW数据中心为使返回事件格式化更容易读取,您可提交下列请求:

华体会联盟hthslackspacecloud.com/nova/events/

信息学

控件和违法字符必须在 URL 中逃避

导航进料

成功响应Get请求获取回馈链路帮助你浏览Feed中的Atom项云源响应返回下链路

• 使用当前链接节点转到当前fe
• 使用倒数链接转到数据库中Atom项最后页以获取指定的种子使用上链路可用于查找给定种子的第一个原子注意云源使用模拟上链路标记帮助部分重查询调离fe头号调用
• 使用自定义链接带回当前查看项if feed用无选项打入 Atom新项已输入后,这些项也出现
• 使用下一个链接逐页浏览Atom项下一页获取端线后,此链路不再存在
• 使用前一逐页导航前页Atom项偶数链路进进信头链接不是进料页眉中,如果进料为空上端提供并跟踪此链接时,空提供回报,除非自上次民调以来出现新项进料显示从新到老顺序

下图显示云源工作方式

警告

web浏览器或web工具如Chrome贴画时,开机程序字符链接返回为HTMLampersand字符代码web浏览器或Poster等Web工具中要跟踪链路,你必须把每个HTMLampersand字符 '开机程序.举例说, web浏览器浏览时,fe返回下链路

跟踪网络浏览器链路时,你必须修改每个实例并修改为

华体会联盟hthhttps://ord.feeds.api.rackspacecloud.com/namespace/feed/events/tenantID/?marker=urn:uuid:676f3860-447c-40a3-8f61-9791819cc82f&limit=25&> search=&direction=forward

问题使用 XML解析器时不引起关注

云源查询参数

可使用查询参数定制分录和分录查询参数是URL的一部分,作为API请求的一部分传递服务器向API请求添加查询参数时,会以特定方式修改结果,例如精化查询或排序输出

内含查询参数的典型URL看起来像下列URL:

http://server/program/path/?query_string

查询字符串由一个或多个使用下列格式的字段值对组成:

• 字段内对值内字段名称和值用等值符号分离

• 数列对数由ampersand(和)分离,如下示例所示:

  field1=value1&field2=value2&field3=value3...

下表汇总查询参数可指定云源

查询参数

信息学

上头启动at参数无法与标识符参数化if启动at参数使用无方向选择参数后假设前向

使用标记参数过滤项

可使用标识符参数表示前用项if指针获取请求中,您也可以指定值方向选择参数化if you不指定值方向选择参数默认值前向使用中 。

下示例显示标识符参数指定方向选择参数集前向:

华体会联盟hthhttps://ord.feeds.api.rackspacecloud.com/feed/events/tenantID/?marker=urn:uuid:8439541b-b40e-4c23-b290-2820bd64257d&direction=forward

下示例显示标识符参数指定方向选择参数集向后:

华体会联盟hthhttps://ord.feeds.api.rackspacecloud.com/feed/events/tenantID/?marker=urn:uuid:8439541b-b40e-4c23-b290-2820bd64257d&direction=backward

可使用限值参数指定返回项数默认限制设为25最小限值为1,最大限值为1,000

下示例显示标识符参数指定限值参数设置为50,分页向前

华体会联盟hthhttps://atom.staging.ord1.us.ci.rackspace.net/namespace/feed/events/tenantID/?marker=urn:uuid:8439541b-b40e-4c23-b290-2820bd64257d&direction=forward&limit=50

下示例显示标记集和限值定为50,分页向后

华体会联盟hthhttps://ord.feeds.api.rackspacecloud.com/namespace/feed/events/tenantID/?marker=urn:uuid:8439541b-b40e-4c23-b290-2820bd64257d&direction=backward&limit=50

按类别过滤

可使用获取请求筛选某些类型事件 通过定义特定搜索类别从种子获取通过添加指定搜索类别搜索URL尾端输入URL并指定类别或项目供搜索下示例显示如何获取所有事件类型cloudsites.metered.site.usage类别 :

华体会联盟hthcurl -H "X-Auth-Token: authenticationToken" -X GET https://ord.feeds.api.rackspacecloud.com/sites/events/tenantID/?search=(cat=type:cloudsites.metered.site.usage)

高级滤波使用

CloudFeeds使用AND、OR和NOT运算符及其组合支持高级滤波

下示例显示如何使用AND语句筛选多类 :

使用AND语句过滤多类

华体会联盟hthhttp://ord.feeds.api.rackspacecloud.com/namespace/feed/tenantID/?search=(AND(cat=CAT1)(cat=CAT2))

下示例显示如何使用OR说明筛选多类 :

多类滤波使用OR语句

华体会联盟hthhttp://ord.feeds.api.rackspacecloud.com/namespace/feed/tenantID/?search=(OR(cat=CAT1)(cat=CAT2))

下示例显示如何筛选非输入类别CAT1使用NOT语句

使用NOT语句过滤单类

华体会联盟hthhttp://ord.feeds.api.rackspacecloud.com/namespace/feed/tenantID/?search=(NOT(cat=CAT1))

AND、OR和NOT运算符可合并筛选多重类别

下示例显示如何查找输入类别CAT1并CAT2或CAT3)但非CAT4:

多类滤波使用AND语句

华体会联盟hthhttp://ord.feeds.api.rackspacecloud.com/namespace/namespace/feed/tenantID/?search=(AND(cat=CAT1)(OR(cat=CAT2)(cat=CAT3))(NOT(cat=CAT4)))

时间戳滤波

可使用启动at查询参数过滤从一定时间印章启动的进料项参数取ISO8601日期时间格式并必须包含时段,例如2014-03-10T06.00.000Z

URL显示如何取出带比2014-03-1000.00.000UTC更新时间戳的条目

华体会联盟hthhttp://ord.feeds.api.rackspacecloud.com/namespace/feed/tenantID/?startingAt=2014-03-10T00:00:00.000Z

URL显示如何通过设置时间戳取列2014-03-10:00-00.000方向选择参数切换向后:

华体会联盟hthhttp://ord.feeds.api.rackspacecloud.com/namespace/feed/tenantID/?startingAt=2014-03-10T00:00:00.000Z&direction=backward

信息学

上头启动at参数无法与标识符参数化

if启动at参数使用无方向选择参数后前向方向假设如果要从时间段取回回文,则需使用时间戳中指定时间段方向选择并发参数向后描述像下文方向选择集至向后.

支持弱ETags

云源支持弱实体标签ETag识别专用进料版内容变换时分配不同的ETGTETGs提供有效检验前处理馈送是否变换的方法弱ETags发回HTTP头板并命名ETag

微弱ETag实例中包含多原子项的fe

W/"4ec07c96e1399298d48db885c014703b"

ETags在下列情况下不返回:

• feed为空
• 使用标识符参数向前指定方向
  标记后没有条目

面向消费者的最佳做法

下表描述消费者阅读种子时可坚持的一些最佳做法

向前行进fe

读进取最佳性能时,从上项成功读取,向进取头向前行使用以下格式替换值 , 并 .

https:// / 标识符 &direction=forward&limit=1000

分批阅读1000使用限查询参数

越少调用云源处理越少处理CloudFeeds允许您一次读取1000项使用
限查询参数使用下列格式(连同推荐方向参数)替代值 , 并 .

https:// / 标识符 &direction=forward&limit=1000

发布远程数据中心请求时使用压缩

云源压缩信息体可减少响应时间,特别是当远程数据中心端点交互时向请求添加以下页眉,指示云播送压缩输出HTTP客户端解压缩输出

接受编码:gzi

使用搜索查询参数时使用高性能分类

过滤带搜索查询参数的种子时,两种类型提供比其他类型更好的性能,特别是当搜索类别在种子中稀有时。

类别前缀