Khái niệm: Một giao diện lập trình ứng dụng (tiếng anh Application Programming Interface hay API) là một giao diện mà một hệ thống máy tính hay ứng dụng cung cấp để cho phép các yêu cầu dịch vụ có thể được tạo ra từ các chương trình máy tính khác, và hoặc cho phép dữ liệu có thể được trao đổi qua lại giữa chúng. Cũng giống như bàn phím là một thiết bị giao tiếp giữa người dùng và máy tính.

Sử dụng API của Openstack có thể tạo máy ảo, tạo image và các hoạt động khác trong Openstack.

Để gửi các yêu cầu đến API, ta có thể sử dụng các cách thức sau:

• cURL: là một công cụ dòng lệnh mà cho phép bạn gửi các yêu cầu và nhận phản hồi theo http.

• Openstack command-line clients: Mỗi một project của Openstack cung cấp một command-line client mà cho phép bạn truy xuất vào API một cách dễ dàng.

• REST clients: Cả Mozilla và Google đều cung cấp giao diện đồ họa dựa trên trình duyệt cho REST.

• Openstack Python Software Development Kit (SDK): Sử dụng SDK để viết một script tự động Python mà tạo và quản lý tài nguyên trong cloud Openstack. SDK triển khai Python liên kết với Openstack API, nó cho phép bạn thực hiện các nhiệm vụ tự động trong python bởi gọi đến các objects python hơn là gọi đến REST trực tiếp. Tất cả các tools được triển khai bởi sử dung Python SDK.

Vào web store của chrome, tìm kiếm và cài đặt ứng dụng Advanced RESTclient cho trình duyệt.

Giao diện của ứng dụng:

1. Địa chỉ url

2. Advanced RESTClient hỗ trợ các giao thức GET, POST, PUT, PATCH, DELETE, HEAD

3. Với các giao thức POST hoặc PUT ta cần thêm data khi gửi yêu cầu, ta thêm data ở ô số 3 này cũng dưới dạng raw hoặc form

4. Các option của ứng dụng

Openstack gồm có Block Storage API, Indentify API ... bạn có thể tham khảo theo link sau:

http://developer.openstack.org/api-ref.html

Quá trình xác thực: Mỗi một yêu cầu mà gửi đến API đều yêu cầu có X-Auth-Token header. Các máy client sẽ chứa tokens này, sử dụng để gửi đến các dịch vụ khác. Qúa trình xác thực được thể hiện ở đây:

Trong phần này mình sẽ demo cách list ra các tenants trong Openstack

B1: Lấy tokens hệ thống

1. URL gồm có địa chỉ của controller, port keystone service và API v2
2. Yêu cầu sử dụng giao thức POST
3. Chèn data gồm có username, password, tennantname

    {
    
        "auth": {
        
            "tenantName": "admin",
            
            "passwordCredentials": {
            
            "username": "admin",
            
            "password": "password123"
            
          }
        
          }
        } 

4. Thiết lập Set "Content-Type" header
5. Gửi yêu cầu

Phản hồi về 400 hoặc 401 HTTP có nghĩa là request sai URL hoặc data sai định dạng, phản hồi 200 HTTP là xác thực thành công và trả về file json chứa các thông tin các service của dịch vụ và token của user admin

Nếu thành công ta sẽ nhận được tokens của user như hình ảnh dưới đây:

B2: List các tenant

Để list các tenants thì tokens mà lấy từ bước phải là tokens của user có quyền admin.

Xem mô tả lại API của list tenants

Sử dụng Advaned REST Client lấy về danh sách các tenant:

1. URL (ô số 1) gồm địa chỉ của controller, API v2.0/tenants
2. List tenant sử dụng phương thức GET
3. Thêm header cho yêu cầu với Key là X-Auth-Token giá trị tokens id lấy ở bước 1.

Nếu gửi yêu cầu thành công sẽ nhận được phản hồi như sau:

Để sử dụng python gửi các yêu cầu HTTP ta sử dụng library request được viết bởi python

Để sử dụng library request ta chỉ cần import thư viện này vào đầu đoạn script

import request

Dưới đây là đoạn code mình viết bằng python để lấy tokens của openstack.

import requests
import json

def gettoken():
    url ='http://172.16.69.70:35357/v2.0/tokens'
    data = {"auth": {"tenantName":"admin","passwordCredentials":{"username":"admin","password":"Welcome123"}}}
    a = requests.post(url,json.dumps(data),headers = {'Content-Type':'application/json'})
    if a.status_code !=200:
	    raise Exception("Platform9 login returned %d, body: %s" %(a.status_code, a.text))
    else:
	    response = a.json()
	    return response

respon = gettoken()
token =  respon['access']['token']['id']
printf token

Trong đoạn code này mình sẽ in ra màn hình token của user admin

Hàm thực hiện list các tenant:

def listtenant():
    url ='http://172.16.69.70:35357/v2.0/tenants'
    respon = gettoken()
    token = respon['access']['token']['id']
    c = requests.get(url,headers = {'X-Auth-Token':b,'Content-Type':'application/json'})
    return c.json()['tenants']

API Openstack:

http://developer.openstack.org/api-ref-identity-v2.html

http://docs.openstack.org/api/openstack-identity-service/2.0/content/POST_addUser_v2.0_users_User_Operations_OS-KSADM.html

Python và API Openstack

http://docs.platform9.com/#a-idservice-endpointa-terminology

Library request:

http://www.pythonforbeginners.com/requests/using-requests-in-python

Tham khảo tiếng việt

https://github.com/thanhha123/How-to-test-OpenStack-API-using-Advanced-RESTClient-Chrome

Sẽ tiếp tục update thêm