openstack api快速入门

noel0217

　　 原文:http://my.oschina.net/guol/blog/105430
　　openstack官方有提供api供开发者使用，可以使用api做一些外围的小工具，用来简化对openstack的管理。
　　    api-quickstart:http://docs.openstack.org/api/quick-start/content/index.html
　　    api-doc:http://api.openstack.org/api-ref.html
　　    环境：ubuntu12.10(10.1.1.186)
　　    如果你看了官方的quickstart，他会让你先生成一个X-Auth-Token值，然后使用这个认证的值调用相关的api接口。如下过程：
　　

1	curl-k -X 'POST' -v http://10.1.1.186:5000/v2.0/tokens-d '{"auth":{"passwordCredentials":{"username":"guol", "password":"123456"}}}' -H 'Content-type:application/json' |python -mjson.tool

输出结果如下：　　

01

{

02	"access":{

03	"serviceCatalog":{},

04	"token":{

05	"expires": "2013-01-27T04:55:35Z",

06	"id": "a4b6a871ff2f41a797c0b7d45c69f81e"

07

},

08	"user":{

09	"id": "4c1a6122fc874a8bb541a34be3b316ad",

10	"name": "guol",

11	"roles":[],

12	"roles_links":[],

13	"username": "guol"

14

}

15

}

16

}

然后使用token id调用你使用的api　　

1	curl-X 'GET' -H  "X-Auth-Token:a4b6a871ff2f41a797c0b7d45c69f81e" -v http://10.1.1.186:5000/v2.0/tenants| python -mjson.tool

输出的结果如下：　　

01

{

02	"tenants":[

03

{

04	"description": "\u4e91\u5e73\u53f0\u7ba1\u7406\u5458,\u5168\u5c40\u7ba1\u7406\u6240\u6709\u9879\u76ee",

05	"enabled": true,

06	"id": "3a3613f83183435d9c47aa362261f720",

07	"name": "admin"

08

}

09

],

10	"tenants_links":[]

11

}

　　    当你按照api-doc接着调用compute、image、volume等下面的api接口时，会发现统统没有返回值，经过一段时间的摸索，发现对下剩下的api接口是需要使用认证过的token才能使用的，下面的方法才是王道。
　　获取认证token值
　　

1	curl-X POST -d  '{"auth":{"tenantName": "VM", "passwordCredentials":{"username": "admin", "password": "123456"}}}' -H "Content-type:application/json" http://10.1.1.186:35357/v2.0/tokens| python -mjson.tool

　　返回值如下：

001

{

002	"access":{

003	"metadata":{

004	"is_admin":0,

005	"roles":[

006	"141927156f7a47d98858e51febaea8cf"

007

]

008

},

009	"serviceCatalog":[

010

{

011	"endpoints":[

012

{

013	"adminURL": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671",

014	"id": "e02aaf58a24641049fddfe7385ce9399",

015	"internalURL": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671",

016	"publicURL": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671",

017	"region": "RegionOne"

018

}

019

],

020	"endpoints_links":[],

021	"name": "nova",

022	"type": "compute"

023

},

024

{

025	"endpoints":[

026

{

027	"adminURL": "http://10.1.1.186:9292/v1",

028	"id": "7c48fa4d876d44e0a3cb324a45a14931",

029	"internalURL": "http://10.1.1.186:9292/v1",

030	"publicURL": "http://10.1.1.186:9292/v1",

031	"region": "RegionOne"

032

}

033

],

034	"endpoints_links":[],

035	"name": "glance",

036	"type": "image"

037

},

038

{

039	"endpoints":[

040

{

041	"adminURL": "http://10.1.1.186:8776/v1/170bf7acb88646bc9147085d426c4671",

042	"id": "c08114987bc0443d879436db6290dd08",

043	"internalURL": "http://10.1.1.186:8776/v1/170bf7acb88646bc9147085d426c4671",

044	"publicURL": "http://10.1.1.186:8776/v1/170bf7acb88646bc9147085d426c4671",

045	"region": "RegionOne"

046

}

047

],

048	"endpoints_links":[],

049	"name": "volume",

050	"type": "volume"

051

},

052

{

053	"endpoints":[

054

{

055	"adminURL": "http://10.1.1.186:8773/services/Admin",

056	"id": "cd6c3c2ac44340d6a78cb903ec9bcab3",

057	"internalURL": "http://10.1.1.186:8773/services/Cloud",

058	"publicURL": "http://10.1.1.186:8773/services/Cloud",

059	"region": "RegionOne"

060

}

061

],

062	"endpoints_links":[],

063	"name": "ec2",

064	"type": "ec2"

065

},

066

{

067	"endpoints":[

068

{

069	"adminURL": "http://10.1.1.186:8080/v1",

070	"id": "a75755093500441ea954f4874ccecf15",

071	"internalURL": "http://10.1.1.186:8080/v1/AUTH_170bf7acb88646bc9147085d426c4671",

072	"publicURL": "http://10.1.1.186:8080/v1/AUTH_170bf7acb88646bc9147085d426c4671",

073	"region": "RegionOne"

074

}

075

],

076	"endpoints_links":[],

077	"name": "swift",

078	"type": "object-store"

079

},

080

{

081	"endpoints":[

082

{

083	"adminURL": "http://10.1.1.186:35357/v2.0",

084	"id": "196e553f9bcc4c8fa425bc0fa28a144b",

085	"internalURL": "http://10.1.1.186:5000/v2.0",

086	"publicURL": "http://10.1.1.186:5000/v2.0",

087	"region": "RegionOne"

088

}

089

],

090	"endpoints_links":[],

091	"name": "keystone",

092	"type": "identity"

093

}

094

],

095	"token":{

096	"expires": "2013-01-27T05:06:50Z",

097	"id": "71fb5b7816804febbd89ed315fe67c94",

098	"tenant":{

099	"description": "\u6240\u6709\u516c\u53f8\u81ea\u4e3b\u6e38\u620f\u7684\u524d\u7aef\u53d1\u5e03\u673a,\u5982\u8d5b\u5c14\u53f7,\u529f\u592b\u7b49",

100	"enabled": true,

101	"id": "170bf7acb88646bc9147085d426c4671",

102	"name": "VM"

103

}

104

},

105	"user":{

106	"id": "24a2251c32504957ad2647c2448ffac3",

107	"name": "admin",

108	"roles":[

109

{

110	"name": "\u524d\u7aef\u6e38\u620f"

111

}

112

],

113	"roles_links":[],

114	"username": "admin"

115

}

116

}

117

}

　　使用返回的token id和tenant id调用api返回该tenant下的servers

1	curl-X GET -H "X-Auth-Token:71fb5b7816804febbd89ed315fe67c94" -H "Content-type:application/json" http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671/servers| python -mjson.tool

返回结果如下　　

01

{

02	"servers":[

03

{

04	"id": "ac561829-dffa-443e-a321-260d48f4cba3",

05	"links":[

06

{

07	"href": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671/servers/ac561829-dffa-443e-a321-260d48f4cba3",

08	"rel": "self"

09

},

10

{

11	"href": "http://10.1.1.186:8774/170bf7acb88646bc9147085d426c4671/servers/ac561829-dffa-443e-a321-260d48f4cba3",

12	"rel": "bookmark"

13

}

14

],

15	"name": "VM1"

16

},

17

{

18	"id": "e3b84378-7598-48c8-8a1d-bd555c4c1f90",

19	"links":[

20

{

21	"href": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671/servers/e3b84378-7598-48c8-8a1d-bd555c4c1f90",

22	"rel": "self"

23

},

24

{

25	"href": "http://10.1.1.186:8774/170bf7acb88646bc9147085d426c4671/servers/e3b84378-7598-48c8-8a1d-bd555c4c1f90",

26	"rel": "bookmark"

27

}

28

],

29	"name": "VM2"

30

},

31

{

32	"id": "beafef2e-26c4-4320-9b45-70006e71785c",

33	"links":[

34

{

35	"href": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671/servers/beafef2e-26c4-4320-9b45-70006e71785c",

36	"rel": "self"

37

},

38

{

39	"href": "http://10.1.1.186:8774/170bf7acb88646bc9147085d426c4671/servers/beafef2e-26c4-4320-9b45-70006e71785c",

40	"rel": "bookmark"

41

}

42

],

43	"name": "VM3"

44

},

45

{

46	"id": "f8450270-9d96-4dba-b1c2-8ebcef1ff012",

47	"links":[

48

{

49	"href": "http://10.1.1.186:8774/v2/170bf7acb88646bc9147085d426c4671/servers/f8450270-9d96-4dba-b1c2-8ebcef1ff012",

50	"rel": "self"

51

},

52

{

53	"href": "http://10.1.1.186:8774/170bf7acb88646bc9147085d426c4671/servers/f8450270-9d96-4dba-b1c2-8ebcef1ff012",

54	"rel": "bookmark"

55

}

56

],

57	"name": "VM4"

58

}

59

]

60

}

通过返回值可以看到vm tenant中共包含VM1 VM2 VM3 VM4四台实例。