GET /api/compute_resources
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"description": "yourcompute",
"url": "eu-west-1",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 928692541,
"name": "amazon123",
"provider": "EC2",
"provider_friendly_name": "EC2",
"access_key": "MyString",
"region": "eu-west-1"
},
{
"description": "yourcompute",
"url": "eu-west-1",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 304431216,
"name": "another-ec2",
"provider": "EC2",
"provider_friendly_name": "EC2",
"access_key": "MyString",
"region": "eu-west-1"
},
{
"description": "MyString",
"url": "qemu://stam/system",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 980190962,
"name": "bigcompute",
"provider": "Libvirt",
"provider_friendly_name": "Libvirt",
"display_type": "vnc",
"set_console_password": true
},
{
"description": "yourcompute",
"url": "us-central1-a",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 30517511,
"name": "gce123",
"provider": "GCE",
"provider_friendly_name": "Google",
"email": null,
"zone": "us-central1-a",
"project": "foo",
"key_path": null
},
{
"description": "mycompute",
"url": "test:///default",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 367690737,
"name": "mycompute",
"provider": "Libvirt",
"provider_friendly_name": "Libvirt",
"display_type": "vnc",
"set_console_password": true
},
{
"description": "computeresource",
"url": "test:///default/v2.0",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 628705878,
"name": "openstackcr",
"provider": "Openstack",
"provider_friendly_name": "OpenStack",
"user": "MyString",
"tenant": null,
"domain": null
},
{
"description": "ovirt resource",
"url": "https://myovirt/api",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 510899777,
"name": "Ovirt",
"provider": "Ovirt",
"provider_friendly_name": "oVirt",
"user": "MyString",
"datacenter": "1234567891011",
"use_v4": false,
"ovirt_quota": null
},
{
"description": "vmware resource",
"url": "https://myvmware/api",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 305613588,
"name": "Vmware",
"provider": "Vmware",
"provider_friendly_name": "VMware",
"user": "MyString",
"datacenter": "1234567891011",
"server": "https://myvmware/api",
"set_console_password": true,
"caching_enabled": true,
"display_type": "vmrc"
},
{
"description": "yourcompute",
"url": "test:///default",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 932571420,
"name": "yourcompute",
"provider": "Libvirt",
"provider_friendly_name": "Libvirt",
"display_type": "vnc",
"set_console_password": true
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
search optional |
filter results Validations:
|
|
order optional |
Sort field and order, eg. ‘id DESC’ Validations:
|
|
page optional |
paginate results Validations:
|
|
per_page optional |
number of entries per request Validations:
|
| Field name | Type | Possible values |
|---|---|---|
| id | integer | |
| location | string | |
| location_id | integer | |
| name | string | |
| organization | string | |
| organization_id | integer | |
| type | string |
GET /api/compute_resources/367690737-mycompute
200
{
"description": "mycompute",
"url": "test:///default",
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"id": 367690737,
"name": "mycompute",
"provider": "Libvirt",
"provider_friendly_name": "Libvirt",
"display_type": "vnc",
"set_console_password": true,
"images": [],
"compute_attributes": [],
"locations": [
{
"id": 255093256,
"name": "Location 1",
"title": "Location 1",
"description": null
}
],
"organizations": [
{
"id": 447626438,
"name": "Organization 1",
"title": "Organization 1",
"description": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
POST /api/compute_resources
{
"compute_resource": {
"name": "libvirt_compute",
"provider": "libvirt",
"organization_ids": [
114267492
],
"location_ids": [
447626471,
447626472,
447626473
],
"url": "qemu+ssh://root@libvirt.example.com/system"
}
}
201
{
"description": null,
"url": "qemu+ssh://root@libvirt.example.com/system",
"created_at": "2019-02-20 13:25:44 UTC",
"updated_at": "2019-02-20 13:25:44 UTC",
"id": 980190966,
"name": "libvirt_compute",
"provider": "Libvirt",
"provider_friendly_name": "Libvirt",
"display_type": "vnc",
"set_console_password": true,
"images": [],
"compute_attributes": [],
"locations": [
{
"id": 447626471,
"name": "loc146",
"title": "loc146",
"description": null
},
{
"id": 447626472,
"name": "loc147",
"title": "loc147",
"description": null
},
{
"id": 447626473,
"name": "loc148",
"title": "loc148",
"description": null
}
],
"organizations": [
{
"id": 114267492,
"name": "Empty Organization",
"title": "Empty Organization",
"description": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
compute_resource required |
Validations:
|
|
compute_resource[name] required |
Validations:
|
|
compute_resource[provider] optional , nil allowed |
Providers include Libvirt, Ovirt, EC2, Vmware, Openstack, Rackspace, GCE Validations:
|
|
compute_resource[url] optional , nil allowed |
URL for Libvirt, oVirt, OpenStack and Rackspace Validations:
|
|
compute_resource[description] optional , nil allowed |
Validations:
|
|
compute_resource[user] optional , nil allowed |
Username for oVirt, EC2, VMware, OpenStack. Access Key for EC2. Validations:
|
|
compute_resource[password] optional , nil allowed |
Password for oVirt, EC2, VMware, OpenStack. Secret key for EC2 Validations:
|
|
compute_resource[uuid] optional , nil allowed |
Deprecated, please use datacenter Validations:
|
|
compute_resource[datacenter] optional , nil allowed |
for oVirt, VMware Datacenter Validations:
|
|
compute_resource[use_v4] optional , nil allowed |
for oVirt only Validations:
|
|
compute_resource[ovirt_quota] optional , nil allowed |
for oVirt only, ID of quota to use Validations:
|
|
compute_resource[public_key] optional , nil allowed |
for oVirt only Validations:
|
|
compute_resource[region] optional , nil allowed |
for EC2 only, use ‘us-gov-west-1’ for GovCloud region Validations:
|
|
compute_resource[tenant] optional , nil allowed |
for OpenStack only Validations:
|
|
compute_resource[domain] optional , nil allowed |
for OpenStack only Validations:
|
|
compute_resource[server] optional , nil allowed |
for VMware Validations:
|
|
compute_resource[set_console_password] optional , nil allowed |
for Libvirt and VMware only Validations:
|
|
compute_resource[display_type] optional , nil allowed |
for Libvirt only Validations:
|
|
compute_resource[caching_enabled] optional , nil allowed |
enable caching, for VMware only Validations:
|
|
compute_resource[location_ids] optional , nil allowed |
REPLACE locations with given ids Validations:
|
|
compute_resource[organization_ids] optional , nil allowed |
REPLACE organizations with given ids. Validations:
|
PUT /api/compute_resources/367690737
{
"compute_resource": {
"location_ids": [
447626474,
447626475,
447626476
]
}
}
200
{
"description": "mycompute",
"url": "test:///default",
"created_at": "2019-02-20 13:25:27 UTC",
"updated_at": "2019-02-20 13:25:27 UTC",
"id": 367690737,
"name": "mycompute",
"provider": "Libvirt",
"provider_friendly_name": "Libvirt",
"display_type": "vnc",
"set_console_password": true,
"images": [],
"compute_attributes": [],
"locations": [
{
"id": 447626474,
"name": "loc149",
"title": "loc149",
"description": null
},
{
"id": 447626475,
"name": "loc150",
"title": "loc150",
"description": null
},
{
"id": 447626476,
"name": "loc151",
"title": "loc151",
"description": null
}
],
"organizations": [
{
"id": 447626438,
"name": "Organization 1",
"title": "Organization 1",
"description": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
compute_resource required |
Validations:
|
|
compute_resource[name] optional |
Validations:
|
|
compute_resource[provider] optional , nil allowed |
Providers include Libvirt, Ovirt, EC2, Vmware, Openstack, Rackspace, GCE Validations:
|
|
compute_resource[url] optional , nil allowed |
URL for Libvirt, oVirt, OpenStack and Rackspace Validations:
|
|
compute_resource[description] optional , nil allowed |
Validations:
|
|
compute_resource[user] optional , nil allowed |
Username for oVirt, EC2, VMware, OpenStack. Access Key for EC2. Validations:
|
|
compute_resource[password] optional , nil allowed |
Password for oVirt, EC2, VMware, OpenStack. Secret key for EC2 Validations:
|
|
compute_resource[uuid] optional , nil allowed |
Deprecated, please use datacenter Validations:
|
|
compute_resource[datacenter] optional , nil allowed |
for oVirt, VMware Datacenter Validations:
|
|
compute_resource[use_v4] optional , nil allowed |
for oVirt only Validations:
|
|
compute_resource[ovirt_quota] optional , nil allowed |
for oVirt only, ID of quota to use Validations:
|
|
compute_resource[public_key] optional , nil allowed |
for oVirt only Validations:
|
|
compute_resource[region] optional , nil allowed |
for EC2 only, use ‘us-gov-west-1’ for GovCloud region Validations:
|
|
compute_resource[tenant] optional , nil allowed |
for OpenStack only Validations:
|
|
compute_resource[domain] optional , nil allowed |
for OpenStack only Validations:
|
|
compute_resource[server] optional , nil allowed |
for VMware Validations:
|
|
compute_resource[set_console_password] optional , nil allowed |
for Libvirt and VMware only Validations:
|
|
compute_resource[display_type] optional , nil allowed |
for Libvirt only Validations:
|
|
compute_resource[caching_enabled] optional , nil allowed |
enable caching, for VMware only Validations:
|
|
compute_resource[location_ids] optional , nil allowed |
REPLACE locations with given ids Validations:
|
|
compute_resource[organization_ids] optional , nil allowed |
REPLACE organizations with given ids. Validations:
|
DELETE /api/compute_resources/932571420
{
"compute_resource": {}
}
200
{
"id": 932571420,
"name": "yourcompute",
"description": "yourcompute",
"url": "test:///default",
"user": "MyString",
"password": "1234567",
"uuid": "yourcompute",
"created_at": "2019-02-20T13:29:14.049Z",
"updated_at": "2019-02-20T13:29:14.049Z",
"attrs": {},
"caching_enabled": true,
"domain": null,
"http_proxy_id": null
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
GET /api/compute_resources/928692541-amazon123/available_images
200
[
{
"name": "some_image",
"uuid": "123"
}
]
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
GET /api/compute_resources/305613588-Vmware/available_clusters
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_vmware_object",
"id": "my11-test35-uuid99"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
GET /api/compute_resources/928692541-amazon123/available_flavors
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_ec2_object",
"id": "123"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
GET /api/compute_resources/305613588-Vmware/available_folders
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_vmware_object",
"id": "my11-test35-uuid99"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
GET /api/compute_resources/928692541-amazon123/available_zones
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_ec2_object"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
GET /api/compute_resources/305613588-Vmware/available_clusters/123-456-789/available_networks
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_vmware_object",
"id": "my11-test35-uuid99"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
cluster_id optional |
Validations:
|
GET /api/compute_resources/305613588-Vmware/available_clusters/123-456-789/available_resource_pools
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_vmware_object",
"id": "my11-test35-uuid99"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
cluster_id required |
Validations:
|
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
storage_domain_id required |
Validations:
|
GET /api/compute_resources/305613588-Vmware/available_storage_domains
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_vmware_object",
"id": "my11-test35-uuid99"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
cluster_id optional |
Validations:
|
|
storage_domain optional |
Validations:
|
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
storage_pod_id required |
Validations:
|
GET /api/compute_resources/305613588-Vmware/available_storage_pods
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_vmware_object",
"id": "my11-test35-uuid99"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
|
cluster_id optional |
Validations:
|
|
storage_pod optional |
Validations:
|
GET /api/compute_resources/928692541-amazon123/available_security_groups
200
{
"total": 9,
"subtotal": 9,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"name": "test_ec2_object",
"group_id": "123"
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
PUT /api/compute_resources/980190963-compute_resource293/associate
{
"compute_resource": {}
}
200
{
"total": 10,
"subtotal": 10,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"ip": null,
"ip6": null,
"environment_id": null,
"environment_name": null,
"last_report": null,
"mac": null,
"realm_id": null,
"realm_name": null,
"sp_mac": null,
"sp_ip": null,
"sp_name": null,
"domain_id": null,
"domain_name": null,
"architecture_id": null,
"architecture_name": null,
"operatingsystem_id": null,
"operatingsystem_name": null,
"subnet_id": null,
"subnet_name": null,
"subnet6_id": null,
"subnet6_name": null,
"sp_subnet_id": null,
"ptable_id": null,
"ptable_name": null,
"medium_id": null,
"medium_name": null,
"pxe_loader": null,
"build": false,
"comment": null,
"disk": null,
"installed_at": null,
"model_id": null,
"hostgroup_id": null,
"owner_id": 135138680,
"owner_name": "Admin User",
"owner_type": "User",
"enabled": true,
"managed": false,
"use_image": null,
"image_file": "",
"uuid": "2eeec255-baa3-4065-8835-4a8e36b66e45",
"compute_resource_id": 980190963,
"compute_resource_name": "compute_resource293",
"compute_profile_id": null,
"compute_profile_name": null,
"capabilities": [
"image",
"key_pair"
],
"provision_method": "image",
"certname": "host1494",
"image_id": null,
"image_name": null,
"created_at": "2019-02-20 13:29:14 UTC",
"updated_at": "2019-02-20 13:29:14 UTC",
"last_compile": null,
"global_status": 0,
"global_status_label": "OK",
"organization_id": 447626438,
"organization_name": "Organization 1",
"location_id": 255093256,
"location_name": "Location 1",
"puppet_status": 0,
"model_name": null,
"name": "host1494",
"id": 2,
"puppet_proxy_id": null,
"puppet_proxy_name": null,
"puppet_ca_proxy_id": null,
"puppet_ca_proxy_name": null,
"puppet_proxy": null,
"puppet_ca_proxy": null,
"hostgroup_name": null,
"hostgroup_title": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|
PUT /api/compute_resources/305613588-Vmware/refresh_cache
{
"compute_resource": {}
}
200
{
"message": "Successfully refreshed the cache."
}
| Param name | Description |
|---|---|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
id required |
Validations:
|