Difference between revisions of "Blazar/REST API"

Revision as of 09:39, 3 February 2014

General API information

This page contains base information about the Climate REST API design, including operations with different Climate resource types and examples of possible requests and responses. Climate supports JSON data serialization format, which means that requests with non empty body have to contain "application/json" Content-Type header or it should be added ".json" extension to the resource name in the request.

This should look like the following:

   GET /v1/{tenant_id}/leases.json

or

   GET /v1/{tenant_id}/leases
   Accept: application/json

Leases

Lease is the main abstraction for the user in the Climate case. Lease means some kind of contract where start time, end time and resources to be reserved are mentioned.

Lease ops

GET

/v1/leases 

POST 

/v1/leases 

GET 

/v1/leases/{lease_id}

PUT 

/v1/leases/{lease_id}

DELETE

/v1/leases/{lease_id}

List all leases

 /v1/leases

• Normal Response Code: 200 (OK)
• Returns the list of all leases.
• Does not require a request body.

Example

Request:

  GET http://climate_node:1234/v1/leases

Response:

   HTTP/1.1 200 OK
   Content-Type: application/json

{
   "leases": [
       {
           "id": "aaaa-bbbb-cccc-dddd",
           "name": "lease_foo_1",
           "start_date": "1234",
           "end_date": "2345",
           "reservations": [{...}],
           "events": [{...}]
       },
       {
           "id": "eeee-ffff-gggg-hhhh",
           "name": "lease_foo_2",
           "start_date": "1234",
           "end_date": "2345",
           "reservations": [{...}],
           "events": [{...}]
       }
   ]
}

Create new lease

   /v1/leases

• Normal Response Code: 202 (ACCEPTED)
• Returns the information about created lease.
• Requires a request body.

Example

Request:

   POST http://climate/v1/leases

{
   "name": "lease_foo",
   "start_date": "1234",
   "end_date": "2345",
   "reservations": [
       {
           "resource_id": "1234-1234-1234",
           "resource_type": "virtual:instance",
           "status": "Reserved"
       }
   ]
}

Response:

   HTTP/1.1 202 ACCEPTED
   Content-Type: application/json

 {
   "id": "aaaa-bbbb-cccc-dddd",
   "name": "lease_foo",
   "start_date": "1234",
   "end_date": "2345",
   "reservations": [
       {
           "id": "fake_resource_id",
           "resource_id": "1234-1234-1234",
           "resource_type": "virtual:instance",
           "status": "Reserved"
       }
   ],
   "events": [
       {
           "id": "fake_event_id",
           "event_type": "start_lease",
           "event_date": "1234"
       },
       {
           "id": "fake_event_id",
           "event_type": "end_lease",
           "event_date": "2345"
       }
   ]
}