Openstack API 开发快速入门

矫情吗；* 2021-11-10 07:04 319阅读 0赞

## [Openstack API 开发 快速入门][Openstack API _] ##

Openstack 做为流行的开源云计算平台，其最大特性是利用其提供的基础设施ＡＰＩ，让我们可以以软件的方式来动态管理ＩＡＡＳ资源。Openstack 提供的ａｐｉ是流行的Rest ＡＰＩ.

闲话少说，我们来开始使用Openstack API。

前提：搭建Openstack 环境是必须，可以根据参考资料搭建一个单机虚拟机环境.

假设我们搭建的环境信息为：

物理服务器地址: 192.168.1.1
    管理员用户名:admin
    管理员密码:password
    管理员租户ID:3942bfc544a24f748788c06dbc486ffa

做好环境后，我们先验证一下，ＡＰＩ是否正常工作.使用Curl工具验证;

curl -k -X 'POST' -v http://192.168.1.1:5000/v2.0/tokens -d '{"auth":{"passwordCredentials":{"username": "admin", "password":"password"}, "tenantId":"3942bfc544a24f748788c06dbc486ffa"}}' -H 'Content-type: application/json'

返回一串的json字符串:

![ContractedBlock.gif][]

需要的是前面几行：

{"access": {"token": {"expires": "2013-01-23T02:22:40Z", "id": "dba0a6722b86483e83b07e5556bafb02"...

其中的ID一项，即为我们以后认证需要的token，记下来:

X-Auth-Token:dba0a6722b86483e83b07e5556bafb02

其它的server 及region信息，是根据你的keystone配置，会将各个服务的访问地址(endpoint)列出来，你可以从这里获得Image,compute,volume等ＡＰＩ接口访问地址.

**特别提醒：**

认证的请求json字符串正确格式为:

![复制代码][copycode.gif]

{
        "auth":{
            "passwordCredentials":{
                "username":"admin",
                "password":"password"
            },
            "tenantId":"3942bfc544a24f748788c06dbc486ffa"
        }
    }

![复制代码][copycode.gif]

缺少了tenantId选项依然可以获得token ，然而这样的token只能在keystone组件中使用，当使用此token去nova 或者image组件认证时，会失败(401错误)

而截止目前，官方api文档 [http://api.openstack.org/api-ref.html][http_api.openstack.org_api-ref.html] 为

![01120723-15c499b6480a4b529246bc5779e4364b.png][]

tenantName (可选项),按此文档请求会出现token不能在其它组件中认证的情况.

获得正确的的tokens后，便可以参考官方的api参考页面，测试其它的api了.

如instance  列表:

curl -v -H "X-Auth-Token:dba0a6722b86483e83b07e5556bafb02" http://192.168.1.1:8774/v2/3942bfc544a24f748788c06dbc486ffa/servers

curl毕竟是命令行，比较麻烦，大家可以使用rest客户端去操作。这里推存一个JAVA的:

[https://code.google.com/p/rest-client/][https_code.google.com_p_rest-client]

![01120724-a27a0fb403b6436d8a40827e6ec36c34.png][]

下面我们通过API完成创建一个虚拟机的工作.

**第一步：获取镜像列表:**

协议为 GET http://192.168.1.1:9292/v1/images

这里使用Rest-client提交

![01120724-099fb635e2d947c39a4c2c84958cd6d0.png][]

我们选一个镜像id: 03419abb-c27f-4dde-bc74-b8387d1ccb30

**第二步：获取虚拟机创建方案.**

协议为: GET http://192.168.1.1:8774/v2/3942bfc544a24f748788c06dbc486ffa/flavors

使用rest-client请求:

![01120724-542db843e82d4a3f910f7c8711efc364.png][]

选取一个flavorid:100

**第三步，创建虚拟机**

协议:POST http://192.168.1.1:8774/v2/3942bfc544a24f748788c06dbc486ffa/servers

BODY:

![复制代码][copycode.gif]

{
        "server":{
            "flavorRef":"100",
            "imageRef":"03419abb-c27f-4dde-bc74-b8387d1ccb30",
            "metadata":{
                "My Server Name":"Apache1"
            },
            "name":"new-server-test",
            "personality":[
                {
                    "contents":"",
                    "path":"/etc/banner.txt"
                }
            ]
        }
    }

![复制代码][copycode.gif]

restclient 请求:

![01120725-5b126edc33f348de8e3372d6741fc97c.png][]

由于我的虚拟机资源用限，超出容量，所以创建失败了。成功的请求是这样的

![复制代码][copycode.gif]

{
        "server":{
            "adminPass":"MVk5HPrazHcG",
            "id":"5bbcc3c4-1da2-4437-a48a-66f15b1b13f9",
            "links":[
                {
                    "href":"http://openstack.example.com/v2/openstack/servers/5bbcc3c4-1da2-4437-a48a-66f15b1b13f9",
                    "rel":"self"
                },
                {
                    "href":"http://openstack.example.com/openstack/servers/5bbcc3c4-1da2-4437-a48a-66f15b1b13f9",
                    "rel":"bookmark"
                }
            ]
        }
    }

![复制代码][copycode.gif]

结果可以登录http://192.168.1.1

用openstack 的Horizon的验证。

其它的api可以参考Openstack的文档完成了 http://api.openstack.org

常用工具

JSON格式化

<http://www.cnblogs.com/biangbiang/archive/2013/01/11/2856431.html>

Java REST Client

<http://rest-client.googlecode.com/>

Groovy RESTCLIENT (groovyx.net.http.RESTClient)

<http://groovy.codehaus.org/modules/http-builder/doc/rest.html>

HttpClient入门

<http://www.ibm.com/developerworks/cn/opensource/os-httpclient/>

<http://www.ibm.com/developerworks/cn/aix/library/au-aix-systemsdirector/section2.html>

[Openstack API _]: http://www.cnblogs.com/biangbiang/archive/2013/02/01/2888800.html
[ContractedBlock.gif]: /images/20211109/59035e73cd234a1e82c773cb4e6e0e9d.png
[copycode.gif]: /images/20211109/f6a1447138a24a2d86bf217ceeaf319f.png
[http_api.openstack.org_api-ref.html]: http://api.openstack.org/api-ref.html
[01120723-15c499b6480a4b529246bc5779e4364b.png]: /images/20211109/a65ac0b8b9254dcea101a22074e270a5.png
[https_code.google.com_p_rest-client]: https://code.google.com/p/rest-client/
[01120724-a27a0fb403b6436d8a40827e6ec36c34.png]: /images/20211109/a4076260ce2e4c8b9e5f9610f1729dbc.png
[01120724-099fb635e2d947c39a4c2c84958cd6d0.png]: /images/20211109/41af242cd5314fbb91e97aa66a9f7ed9.png
[01120724-542db843e82d4a3f910f7c8711efc364.png]: /images/20211109/ae741eb41cc9494fabe2a51a96dd7dbe.png
[01120725-5b126edc33f348de8e3372d6741fc97c.png]: /images/20211109/a17cd2cc90e14318b8ad4398f6831a45.png