barbican/doc/source/api/reference/orders.rst

Orders API - Reference

GET /v1/orders

Lists a project's orders.

The list of orders can be filtered by the parameters passed in via the URL.

Parameters

Name	Type	Description
offset	integer	The starting index within the total list of the orders that you would like to retrieve. (Default is 0)
limit	integer	The maximum number of records to return (up to 100). (Default is 10)

Request:

GET /v1/orders
Headers:
    Content-Type: application/json
    X-Auth-Token: {token}

Response:

200 Success

{
    "orders": [
    {
        "created": "2015-10-20T18:38:44",
        "creator_id": "40540f978fbd45c1af18910e3e02b63f",
        "meta": {
            "algorithm": "AES",
            "bit_length": 256,
            "expiration": null,
            "mode": "cbc",
            "name": "secretname",
            "payload_content_type": "application/octet-stream"
        },
        "order_ref": "http://localhost:9311/v1/orders/2284ba6f-f964-4de7-b61e-c413df5d1e47",
        "secret_ref": "http://localhost:9311/v1/secrets/15dcf8e4-3138-4360-be9f-fc4bc2e64a19",
        "status": "ACTIVE",
        "sub_status": "Unknown",
        "sub_status_message": "Unknown",
        "type": "key",
        "updated": "2015-10-20T18:38:44"
    },
    {
        "created": "2015-10-20T18:38:47",
        "creator_id": "40540f978fbd45c1af18910e3e02b63f",
        "meta": {
            "algorithm": "AES",
            "bit_length": 256,
            "expiration": null,
            "mode": "cbc",
            "name": "secretname",
            "payload_content_type": "application/octet-stream"
        },
        "order_ref": "http://localhost:9311/v1/orders/87b7169e-3aa2-4cb1-8800-b5aadf6babd1",
        "secret_ref": "http://localhost:9311/v1/secrets/80183f4b-c0de-4a94-91ad-6d55251acee2",
        "status": "ACTIVE",
        "sub_status": "Unknown",
        "sub_status_message": "Unknown",
        "type": "key",
        "updated": "2015-10-20T18:38:47"
    }
    ],
    "total": 2
}

Response Attributes

Name	Type	Description
orders	list	Contains a list of dictionaries filled with order metadata.
total	integer	The total number of orders available to the user.
next	string	A HATEOS URL to retrieve the next set of objects based on the offset and limit parameters. This attribute is only available when the total number of objects is greater than offset and limit parameter combined.
previous	string	A HATEOS URL to retrieve the previous set of objects based on the offset and limit parameters. This attribute is only available when the request offset is greater than 0.

HTTP Status Codes

Code	Description
200	Successful Request
401	Invalid X-Auth-Token or the token doesn't have permissions to this resource

POST /v1/orders

Creates an order

Parameters

Attribute Name	Type	Description	Default
type	string	The type of key to be generated. Valid types are key and asymmetric	None
meta	dict	Dictionary containing the secret metadata used to generate the secret.	None

Request:

POST /v1/orders
Headers:
    Content-Type: application/json
    X-Auth-Token: {token}

Content:
{
    "type":"key",
    "meta":
        {
            "name":"secretname",
            "algorithm": "AES",
            "bit_length": 256,
            "mode": "cbc",
            "payload_content_type":"application/octet-stream"
        }
}

Response:

202 Created

{
    "order_ref": "http://{barbican_host}/v1/orders/{order_uuid}"
}

Response Attributes

Name	Type	Description
order_ref	string	Order reference

HTTP Status Codes

Code	Description
202	Successfully created an order
400	Bad Request
401	Invalid X-Auth-Token or the token doesn't have permissions to this resource
415	Unsupported media-type

GET /v1/orders/{uuid}

Retrieves an order's metadata

Request:

GET /v1/orders/{order_uuid}
Headers:
    Accept: application/json
    X-Auth-Token: {token}

Parameters

None

Response:

200 Success

{
    "created": "2015-10-20T18:49:02",
    "creator_id": "40540f978fbd45c1af18910e3e02b63f",
    "meta": {
        "algorithm": "AES",
        "bit_length": 256,
        "expiration": null,
        "mode": "cbc",
        "name": "secretname",
        "payload_content_type": "application/octet-stream"
    },
    "order_ref": "http://localhost:9311/v1/orders/5443d349-fe0c-4bfd-bd9d-99c4a9770638",
    "secret_ref": "http://localhost:9311/v1/secrets/16f8d4f3-d3dd-4160-a5bd-8e5095a42613",
    "status": "ACTIVE",
    "sub_status": "Unknown",
    "sub_status_message": "Unknown",
    "type": "key",
    "updated": "2015-10-20T18:49:02"
}

Response Attributes

Name	Type	Description
created	string	Timestamp in ISO8601 format of when the order was created
creator_id	string	Keystone Id of the user who created the order
meta	dict	Secret metadata used for informational purposes
order_ref	string	Order href associated with the order
secret_ref	string	Secret href associated with the order
status	string	Current status of the order
sub_status	string	Metadata associated with the order
sub_status_message	string	Metadata associated with the order
type	string	Indicates the type of order
updated	string	Timestamp in ISO8601 format of the last time the order was updated.

HTTP Status Codes

Code	Description
200	Successfully retrieved the order
400	Bad Request
401	Invalid X-Auth-Token or the token doesn't have permissions to this resource
404	Not Found

DELETE /v1/orders/{uuid}

Delete an order

Request:

DELETE /v1/orders/{order_uuid}
Headers:
    X-Auth-Token: {token}

Parameters

None

Response:

204 Success

HTTP Status Codes

Code	Description
204	Successfully deleted the order
400	Bad Request
401	Invalid X-Auth-Token or the token doesn't have permissions to this resource
404	Not Found