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:
|