RESTful Web API (v1)¶

Goals¶

GET /v1/goal¶

Retrieve a list of goals.

Parameters:	marker (`unicode`) – pagination marker for large data sets. limit (`int`) – maximum number of resources to return in a single result. sort_key (`unicode`) – column to sort results by. Default: id. sort_dir (`unicode`) – direction to sort. “asc” or “desc”. Default: asc.
Return type:	`GoalCollection`

GET /v1/goal/(goal)¶

Retrieve information about the given goal.

Parameters:	goal (`unicode`) – UUID or name of the goal.
Return type:	`Goal`

GET /v1/goal/detail¶

Retrieve a list of goals with detail.

Parameters:	marker (`unicode`) – pagination marker for large data sets. limit (`int`) – maximum number of resources to return in a single result. sort_key (`unicode`) – column to sort results by. Default: id. sort_dir (`unicode`) – direction to sort. “asc” or “desc”. Default: asc.
Return type:	`GoalCollection`

type GoalCollection¶

API representation of a collection of goals.

Data samples:

Json

{
    "goals": [
        {
            "display_name": "Dummy strategy",
            "efficacy_specification": [
                {
                    "description": "Dummy indicator",
                    "name": "dummy",
                    "schema": "Range(min=0, max=100, min_included=True, max_included=True, msg=None)",
                    "unit": "%"
                }
            ],
            "links": [
                {
                    "href": "http://localhost:9322/v1/goals/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "self"
                },
                {
                    "href": "http://localhost:9322/goals/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "bookmark"
                }
            ],
            "name": "DUMMY",
            "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
        }
    ]
}

goals¶

Type:	list(Goal)

A list containing goals objects

type Goal¶

API representation of a goal.

This class enforces type checking and value constraints, and converts between the internal object model and the API representation of a goal.

Data samples:

Json

{
    "display_name": "Dummy strategy",
    "efficacy_specification": [
        {
            "description": "Dummy indicator",
            "name": "dummy",
            "schema": "Range(min=0, max=100, min_included=True, max_included=True, msg=None)",
            "unit": "%"
        }
    ],
    "links": [
        {
            "href": "http://localhost:9322/v1/goals/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "self"
        },
        {
            "href": "http://localhost:9322/goals/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "bookmark"
        }
    ],
    "name": "DUMMY",
    "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
}

display_name¶

Type:	unicode

Localized name of the goal

efficacy_specification¶

Type:	json

Efficacy specification for this goal

links¶

Type:	list(Link)

A list containing a self link and associated audit template links

name¶

Type:	unicode

Name of the goal

uuid¶

Type:	uuid

Unique UUID for this goal

Audit Templates¶

GET /v1/audit_templates¶

Retrieve a list of audit templates.

Parameters:

goal (unicode) – goal UUID or name to filter by
strategy (unicode) – strategy UUID or name to filter by
marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc.

Return type:

AuditTemplateCollection

GET /v1/audit_templates/(audit_template)¶

Retrieve information about the given audit template.

Parameters:	audit_template (`unicode`) – UUID or name of an audit template.
Return type:	`AuditTemplate`

POST /v1/audit_templates¶

Create a new audit template.

Parameters:	audit_template_postdata (`AuditTemplatePostType`) – the audit template POST data from the request body.
Return type:	`AuditTemplate`

DELETE /v1/audit_templates¶

Delete a audit template.

Parameters:	template_uuid (audit) – UUID or name of an audit template.

PATCH /v1/audit_templates¶

Update an existing audit template.

Parameters:	template_uuid (audit) – UUID of a audit template. patch (list(`AuditTemplatePatchType`)) – a json PATCH document to apply to this audit template.
Return type:	`AuditTemplate`

GET /v1/audit_templates/detail¶

Retrieve a list of audit templates with detail.

Parameters:

goal (unicode) – goal UUID or name to filter by
strategy (unicode) – strategy UUID or name to filter by
marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc.

Return type:

AuditTemplateCollection

type AuditTemplateCollection¶

API representation of a collection of audit templates.

Data samples:

Json

{
    "audit_templates": [
        {
            "goal_name": null,
            "goal_uuid": null,
            "host_aggregate": 5,
            "links": [
                {
                    "href": "http://localhost:9322/v1/audit_templates/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "self"
                },
                {
                    "href": "http://localhost:9322/audit_templates/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "bookmark"
                }
            ],
            "name": "My Audit Template",
            "strategy_name": null,
            "strategy_uuid": null,
            "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
        }
    ]
}

audit_templates¶

Type:	list(AuditTemplate)

A list containing audit templates objects

type AuditTemplate¶

API representation of a audit template.

This class enforces type checking and value constraints, and converts between the internal object model and the API representation of an audit template.

Data samples:

Json

{
    "created_at": "2016-10-25T11:03:00.503949",
    "deleted_at": null,
    "description": "Description of my audit template",
    "extra": {
        "automatic": true
    },
    "goal_name": null,
    "goal_uuid": null,
    "host_aggregate": 5,
    "links": [
        {
            "href": "http://localhost:9322/v1/audit_templates/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "self"
        },
        {
            "href": "http://localhost:9322/audit_templates/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "bookmark"
        }
    ],
    "name": "My Audit Template",
    "strategy_name": null,
    "strategy_uuid": null,
    "updated_at": "2016-10-25T11:03:00.503951",
    "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
}

audits¶

Type:	list(Link)

Links to the collection of audits contained in this audit template

deadline¶

Type:	datetime

deadline of the audit template

description¶

Type:	unicode

Short description of this audit template

extra¶

Type:	dict(unicode: json)

The metadata of the audit template

goal_name¶

Type:	unicode

The name of the goal this audit template refers to

goal_uuid¶

Type:	unicode

Goal UUID the audit template refers to

host_aggregate¶

Type:	integer

ID of the Nova host aggregate targeted by the audit template

links¶

Type:	list(Link)

A list containing a self link and associated audit template links

name¶

Type:	unicode

Name of this audit template

strategy_name¶

Type:	unicode

The name of the strategy this audit template refers to

strategy_uuid¶

Type:	unicode

Strategy UUID the audit template refers to

uuid¶

Type:	uuid

Unique UUID for this audit template

version¶

Type:	unicode

Internal version of the audit template

Audits¶

GET /v1/audits¶

Retrieve a list of audits.

Parameters:

marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc. id.
goal (unicode) – goal UUID or name to filter by
strategy (unicode) – strategy UUID or name to filter by
host_aggregate (int) – Optional host_aggregate

Return type:

AuditCollection

GET /v1/audits/(audit_uuid)¶

Retrieve information about the given audit.

Parameters:	audit_uuid (`uuid`) – UUID of a audit.
Return type:	`Audit`

POST /v1/audits¶

Create a new audit.

Parameters:	audit_p (`AuditPostType`) – a audit within the request body.
Return type:	`Audit`

DELETE /v1/audits¶

Delete a audit.

Parameters:	audit_uuid (`uuid`) – UUID of a audit.

PATCH /v1/audits¶

Update an existing audit.

Parameters:	audit_uuid (`uuid`) – UUID of a audit. patch (list(`AuditPatchType`)) – a json PATCH document to apply to this audit.
Return type:	`Audit`

GET /v1/audits/detail¶

Retrieve a list of audits with detail.

Parameters:	goal (`unicode`) – goal UUID or name to filter by marker (`uuid`) – pagination marker for large data sets. limit (`int`) – maximum number of resources to return in a single result. sort_key (`unicode`) – column to sort results by. Default: id. sort_dir (`unicode`) – direction to sort. “asc” or “desc”. Default: asc.
Return type:	`AuditCollection`

type AuditCollection¶

API representation of a collection of audits.

Data samples:

Json

{
    "audits": [
        {
            "audit_type": "ONESHOT",
            "deadline": null,
            "goal_name": null,
            "goal_uuid": null,
            "host_aggregate": 1,
            "interval": 7200,
            "links": [
                {
                    "href": "http://localhost:9322/v1/audits/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "self"
                },
                {
                    "href": "http://localhost:9322/audits/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "bookmark"
                }
            ],
            "state": "PENDING",
            "strategy_name": null,
            "strategy_uuid": null,
            "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
        }
    ]
}

audits¶

Type:	list(Audit)

A list containing audits objects

type Audit¶

API representation of a audit.

This class enforces type checking and value constraints, and converts between the internal object model and the API representation of a audit.

Data samples:

Json

{
    "audit_type": "ONESHOT",
    "created_at": "2016-10-25T11:03:00.565943",
    "deadline": null,
    "deleted_at": null,
    "goal_name": null,
    "goal_uuid": null,
    "host_aggregate": 1,
    "interval": 7200,
    "links": [
        {
            "href": "http://localhost:9322/v1/audits/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "self"
        },
        {
            "href": "http://localhost:9322/audits/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "bookmark"
        }
    ],
    "state": "PENDING",
    "strategy_name": null,
    "strategy_uuid": null,
    "updated_at": "2016-10-25T11:03:00.565945",
    "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
}

audit_type¶

Type:	unicode

Type of this audit

deadline¶

Type:	datetime

deadline of the audit

goal_name¶

Type:	unicode

The name of the goal this audit template refers to

goal_uuid¶

Type:	unicode

Goal UUID the audit template refers to

host_aggregate¶

Type:	integer

ID of the Nova host aggregate targeted by the audit template

interval¶

Type:	int

Launch audit periodically (in seconds)

links¶

Type:	list(Link)

A list containing a self link and associated audit links

parameters¶

Type:	dict(unicode: json)

The strategy parameters for this audit

state¶

Type:	unicode

This audit state

strategy_name¶

Type:	unicode

The name of the strategy this audit template refers to

strategy_uuid¶

Type:	unicode

Strategy UUID the audit template refers to

uuid¶

Type:	uuid

Unique UUID for this audit

Links¶

type Link¶

A link representation.

Data samples:

Json

{
    "href": "http://localhost:6385/chassis/eaaca217-e7d8-47b4-bb41-3f99f20eed89",
    "rel": "bookmark"
}

href¶

Type:	unicode

The url of a link.

rel¶

Type:	unicode

The name of a link.

type¶

Type:	unicode

Indicates the type of document/link.

Action Plans¶

GET /v1/action_plans¶

Retrieve a list of action plans.

Parameters:

marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc.
audit_uuid (uuid) – Optional UUID of an audit, to get only actions for that audit.
strategy (unicode) – strategy UUID or name to filter by

Return type:

ActionPlanCollection

GET /v1/action_plans/(action_plan_uuid)¶

Retrieve information about the given action plan.

Parameters:	action_plan_uuid (`uuid`) – UUID of a action plan.
Return type:	`ActionPlan`

DELETE /v1/action_plans¶

Delete an action plan.

Parameters:	action_plan_uuid (`uuid`) – UUID of a action.

PATCH /v1/action_plans¶

Update an existing action plan.

Parameters:	action_plan_uuid (`uuid`) – UUID of a action plan. patch (list(`ActionPlanPatchType`)) – a json PATCH document to apply to this action plan.
Return type:	`ActionPlan`

GET /v1/action_plans/detail¶

Retrieve a list of action_plans with detail.

Parameters:

marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc.
audit_uuid (uuid) – Optional UUID of an audit, to get only actions for that audit.
strategy (unicode) – strategy UUID or name to filter by

Return type:

ActionPlanCollection

type ActionPlanCollection¶

API representation of a collection of action_plans.

Data samples:

Json

{
    "action_plans": [
        {
            "audit_uuid": "abcee106-14d3-4515-b744-5a26885cf6f6",
            "efficacy_indicators": [
                {
                    "description": "Test indicator",
                    "name": "test_indicator",
                    "unit": "%"
                }
            ],
            "first_action_uuid": "57eaf9ab-5aaa-4f7e-bdf7-9a140ac7a720",
            "links": [
                {
                    "href": "http://localhost:9322/v1/action_plans/9ef4d84c-41e8-4418-9220-ce55be0436af",
                    "rel": "self"
                },
                {
                    "href": "http://localhost:9322/action_plans/9ef4d84c-41e8-4418-9220-ce55be0436af",
                    "rel": "bookmark"
                }
            ],
            "state": "ONGOING",
            "strategy_name": null,
            "strategy_uuid": null,
            "updated_at": "2016-10-25T11:03:00.626944",
            "uuid": "9ef4d84c-41e8-4418-9220-ce55be0436af"
        }
    ]
}

action_plans¶

Type:	list(ActionPlan)

A list containing action_plans objects

type ActionPlan¶

API representation of a action plan.

This class enforces type checking and value constraints, and converts between the internal object model and the API representation of an action plan.

Data samples:

Json

{
    "audit_uuid": "abcee106-14d3-4515-b744-5a26885cf6f6",
    "created_at": "2016-10-25T11:03:00.636467",
    "deleted_at": null,
    "efficacy_indicators": [
        {
            "description": "Test indicator",
            "name": "test_indicator",
            "unit": "%"
        }
    ],
    "first_action_uuid": "57eaf9ab-5aaa-4f7e-bdf7-9a140ac7a720",
    "links": [
        {
            "href": "http://localhost:9322/v1/action_plans/9ef4d84c-41e8-4418-9220-ce55be0436af",
            "rel": "self"
        },
        {
            "href": "http://localhost:9322/action_plans/9ef4d84c-41e8-4418-9220-ce55be0436af",
            "rel": "bookmark"
        }
    ],
    "state": "ONGOING",
    "strategy_name": null,
    "strategy_uuid": null,
    "updated_at": "2016-10-25T11:03:00.636469",
    "uuid": "9ef4d84c-41e8-4418-9220-ce55be0436af"
}

audit_uuid¶

Type:	uuid

The UUID of the audit this port belongs to

efficacy_indicators¶

Type:	json

The list of efficacy indicators associated to this action plan

first_action_uuid¶

Type:	uuid

The UUID of the first action this action plans links to

global_efficacy¶

Type:	json

The global efficacy of this action plan

links¶

Type:	list(Link)

A list containing a self link and associated action links

state¶

Type:	unicode

This action plan state

strategy_name¶

Type:	unicode

The name of the strategy this action plan refers to

strategy_uuid¶

Type:	unicode

Strategy UUID the action plan refers to

uuid¶

Type:	uuid

Unique UUID for this action plan

Actions¶

GET /v1/actions¶

Retrieve a list of actions.

Parameters:

marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc.
action_plan_uuid (uuid) – Optional UUID of an action plan, to get only actions for that action plan.
audit_uuid (uuid) – Optional UUID of an audit, to get only actions for that audit.

Return type:

ActionCollection

GET /v1/actions/(action_uuid)¶

Retrieve information about the given action.

Parameters:	action_uuid (`uuid`) – UUID of a action.
Return type:	`Action`

POST /v1/actions¶

Create a new action.

Parameters:	action (`Action`) – a action within the request body.
Return type:	`Action`

DELETE /v1/actions¶

Delete a action.

Parameters:	action_uuid (`uuid`) – UUID of a action.

PATCH /v1/actions¶

Update an existing action.

Parameters:	action_uuid (`uuid`) – UUID of a action. patch (list(`ActionPatchType`)) – a json PATCH document to apply to this action.
Return type:	`Action`

GET /v1/actions/detail¶

Retrieve a list of actions with detail.

Parameters:

marker (uuid) – pagination marker for large data sets.
limit (int) – maximum number of resources to return in a single result.
sort_key (unicode) – column to sort results by. Default: id.
sort_dir (unicode) – direction to sort. “asc” or “desc”. Default: asc.
action_plan_uuid (uuid) – Optional UUID of an action plan, to get only actions for that action plan.
audit_uuid (uuid) – Optional UUID of an audit, to get only actions for that audit.

Return type:

ActionCollection

type ActionCollection¶

API representation of a collection of actions.

Data samples:

Json

{
    "actions": [
        {
            "action_plan_uuid": "7ae81bb3-dec3-4289-8d6c-da80bd8001ae",
            "links": [
                {
                    "href": "http://localhost:9322/v1/actions/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "self"
                },
                {
                    "href": "http://localhost:9322/actions/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
                    "rel": "bookmark"
                }
            ],
            "next_uuid": "7ae81bb3-dec3-4289-8d6c-da80bd8001ae",
            "state": "PENDING",
            "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
        }
    ]
}

actions¶

Type:	list(Action)

A list containing actions objects

type Action¶

API representation of a action.

This class enforces type checking and value constraints, and converts between the internal object model and the API representation of a action.

Data samples:

Json

{
    "action_plan_uuid": "7ae81bb3-dec3-4289-8d6c-da80bd8001ae",
    "created_at": "2016-10-25T11:03:00.689327",
    "deleted_at": null,
    "links": [
        {
            "href": "http://localhost:9322/v1/actions/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "self"
        },
        {
            "href": "http://localhost:9322/actions/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
            "rel": "bookmark"
        }
    ],
    "next_uuid": "7ae81bb3-dec3-4289-8d6c-da80bd8001ae",
    "state": "PENDING",
    "updated_at": "2016-10-25T11:03:00.689330",
    "uuid": "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
}

action_plan_uuid¶

Type:	uuid

The action plan this action belongs to

action_type¶

Type:	unicode

Action type

input_parameters¶

Type:	json

One or more key/value pairs

links¶

Type:	list(Link)

A list containing a self link and associated action links

next_uuid¶

Type:	uuid

This next action UUID

state¶

Type:	unicode

This audit state

uuid¶

Type:	uuid

Unique UUID for this action

OpenStack

RESTful Web API (v1)¶

Goals¶

Audit Templates¶

Audits¶

Links¶

Action Plans¶

Actions¶

Table Of Contents

Previous topic

Next topic

Project Source

This Page

OpenStack

RESTful Web API (v1)¶

Goals¶

Audit Templates¶

Audits¶

Links¶

Action Plans¶

Actions¶

Table Of Contents

Previous topic

Next topic

Project Source

This Page

Quick search

Navigation