Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Abiquo 4.4

Skip to end of metadata
Go to start of metadata

Contents:

DatastoreTiers Resource

The DatastoreTier Resource enables you to manage datastore tiers for private cloud. Datastore tiers enable platform owners to grade hypervisor datastore storage and price it according to service levels. Then administrators or cloud users can choose the service level for their VM hard disks. Users can set default datastore service levels for a VM template, virtual datacenter, or VM, and they can select the service level when they create VMs or add hard disks on the hypervisor datastore. Outside of Abiquo, Administrators must configure datastores to provide the appropriate service levels.

Main URI of the Resource

This class operates mainly over the Resource URI: /admin/datacenters/{datacenter}/datastoretiers

Exposed Methods

Create a datastore tier

Create a datastore tier in the given datacenter. 

Synopsis: POST http://example.com/api/admin/datacenters/{datacenter}/datastoretiers
Roles Required: PHYS_DC_RETRIEVE_DETAILS,PHYS_DC_ALLOW_MODIFY_SERVERS,PRICING_VIEW,USERS_MANAGE_ENTERPRISE
Request Headers: Accept: Content-type: application/vnd.abiquo.datastoretier+json; version=4.4; application/vnd.abiquo.datastoretier+xml; version=4.4; ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: DatastoreTiers Media Type
Response Message Body Entity: 
Request Example:

 Click here to show or hide the request example

POST_adm_dcs_X_dstrs_CT_dstr_j_AC_dstr_j.0001.txt

cURL:

curl -X POST http://localhost:9000/api/admin/datacenters/334/datastoretiers \ 
	 -H 'Accept:application/vnd.abiquo.datastoretier+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.datastoretier+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 201

Request payload:

{
  "storageAllocationPolicy": "PROGRESSIVE", 
  "name": "Datastore Tier 1", 
  "links": [], 
  "defaultForDatacenter": true, 
  "defaultAllowed": true, 
  "enabled": true, 
  "description": "description"
}

Response payload:

{
  "storageAllocationPolicy": "PROGRESSIVE", 
  "name": "Datastore Tier 1", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195", 
      "type": "application/vnd.abiquo.datastoretier+json", 
      "rel": "edit", 
      "title": "Datastore Tier 1"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334", 
      "type": "application/vnd.abiquo.datacenter+json", 
      "rel": "datacenter", 
      "title": "6"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195/datastores", 
      "type": "application/vnd.abiquo.datastores+json", 
      "rel": "datastores", 
      "title": "datastores"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195/enterprises", 
      "type": "application/vnd.abiquo.enterprise+json", 
      "rel": "enterprises", 
      "title": "enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195/action/allowallenterprises", 
      "type": "", 
      "rel": "allowallenterprises", 
      "title": "allow all enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195/action/restrictallenterprises", 
      "type": "", 
      "rel": "restrictallenterprises", 
      "title": "restrict all enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195/action/adddatastores", 
      "type": "application/vnd.abiquo.links+json", 
      "rel": "adddatastores", 
      "title": "add datastores to a tier"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/334/datastoretiers/195/action/releasedatastores", 
      "type": "application/vnd.abiquo.links+json", 
      "rel": "releasedatastores", 
      "title": "release datastores from a tier"
    }
  ], 
  "defaultForDatacenter": true, 
  "defaultAllowed": true, 
  "enabled": true, 
  "description": "description"
}

List datastore tiers

Retrieves the list of datastore tiers in a specified datacenter

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/datastoretiers
Roles Required: PHYS_DC_RETRIEVE_DETAILS,PRICING_VIEW,USERS_MANAGE_ENTERPRISE
Request Headers: Accept: application/vnd.abiquo.datastoretiers+json; version=4.4; application/vnd.abiquo.datastoretiers+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: DatastoreTiers Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_dstrs_AC_dstrs_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/338/datastoretiers \ 
	 -H 'Accept:application/vnd.abiquo.datastoretiers+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "links": [], 
  "collection": [
    {
      "storageAllocationPolicy": "PROGRESSIVE", 
      "name": "Default datastore tier", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200", 
          "type": "application/vnd.abiquo.datastoretier+json", 
          "rel": "edit", 
          "title": "Default datastore tier"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338", 
          "type": "application/vnd.abiquo.datacenter+json", 
          "rel": "datacenter", 
          "title": "73"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200/datastores", 
          "type": "application/vnd.abiquo.datastores+json", 
          "rel": "datastores", 
          "title": "datastores"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200/enterprises", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprises", 
          "title": "enterprises"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200/action/allowallenterprises", 
          "type": "", 
          "rel": "allowallenterprises", 
          "title": "allow all enterprises"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200/action/restrictallenterprises", 
          "type": "", 
          "rel": "restrictallenterprises", 
          "title": "restrict all enterprises"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200/action/adddatastores", 
          "type": "application/vnd.abiquo.links+json", 
          "rel": "adddatastores", 
          "title": "add datastores to a tier"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/338/datastoretiers/200/action/releasedatastores", 
          "type": "application/vnd.abiquo.links+json", 
          "rel": "releasedatastores", 
          "title": "release datastores from a tier"
        }
      ], 
      "defaultForDatacenter": true, 
      "defaultAllowed": true, 
      "enabled": true, 
      "description": "75"
    }
  ]
}

Get a datastore tier

Retrieve a datastore tier. The tier object has links to the datastores that belong to the tier.

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}
Roles Required: PHYS_DC_RETRIEVE_DETAILS,PRICING_VIEW,USERS_MANAGE_ENTERPRISE
Request Headers: Accept: application/vnd.abiquo.datastoretier+json; version=4.4; application/vnd.abiquo.datastoretier+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: DatastoreTier Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_dstrs_X_AC_dstr_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/308/datastoretiers/169 \ 
	 -H 'Accept:application/vnd.abiquo.datastoretier+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "storageAllocationPolicy": "PROGRESSIVE", 
  "name": "Datastore Tier 1", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169", 
      "type": "application/vnd.abiquo.datastoretier+json", 
      "rel": "edit", 
      "title": "Datastore Tier 1"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308", 
      "type": "application/vnd.abiquo.datacenter+json", 
      "rel": "datacenter", 
      "title": "1165"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169/datastores", 
      "type": "application/vnd.abiquo.datastores+json", 
      "rel": "datastores", 
      "title": "datastores"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169/enterprises", 
      "type": "application/vnd.abiquo.enterprise+json", 
      "rel": "enterprises", 
      "title": "enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169/action/allowallenterprises", 
      "type": "", 
      "rel": "allowallenterprises", 
      "title": "allow all enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169/action/restrictallenterprises", 
      "type": "", 
      "rel": "restrictallenterprises", 
      "title": "restrict all enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169/action/adddatastores", 
      "type": "application/vnd.abiquo.links+json", 
      "rel": "adddatastores", 
      "title": "add datastores to a tier"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/308/datastoretiers/169/action/releasedatastores", 
      "type": "application/vnd.abiquo.links+json", 
      "rel": "releasedatastores", 
      "title": "release datastores from a tier"
    }
  ], 
  "defaultForDatacenter": false, 
  "defaultAllowed": true, 
  "enabled": true, 
  "description": "1168"
}

Update a datastore tier

Update a datastore tier to change details, including set the tier as the default and enable or disable the tier. See other specific methods to add (including move from other tiers) or remove datastores from the tier.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}
Roles Required: PHYS_DC_ALLOW_MODIFY_SERVERS
Request Headers: Accept: application/vnd.abiquo.datastoretier+json; version=4.4; application/vnd.abiquo.datastoretier+xml; version=4.4;  Content-type:  application/vnd.abiquo.datastoretier+json; version=4.4; application/vnd.abiquo.datastoretier+xml; version=4.4;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: DatastoreTier Media Type
Response Message Body Entity: DatastoreTier Media Type 
Request Example: 

 Click here to show or hide the request example

PUT_adm_dcs_X_dstrs_X_CT_dstr_j_AC_dstr_j.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/317/datastoretiers/185 \ 
	 -H 'Accept:application/vnd.abiquo.datastoretier+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.datastoretier+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

{
  "storageAllocationPolicy": "PROGRESSIVE", 
  "name": "Datastore Tier 1", 
  "links": [], 
  "defaultForDatacenter": false, 
  "defaultAllowed": false, 
  "enabled": true, 
  "description": "1338"
}

Response payload:

{
  "storageAllocationPolicy": "PROGRESSIVE", 
  "name": "Datastore Tier 1", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185", 
      "type": "application/vnd.abiquo.datastoretier+json", 
      "rel": "edit", 
      "title": "Datastore Tier 1"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317", 
      "type": "application/vnd.abiquo.datacenter+json", 
      "rel": "datacenter", 
      "title": "1335"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185/datastores", 
      "type": "application/vnd.abiquo.datastores+json", 
      "rel": "datastores", 
      "title": "datastores"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185/enterprises", 
      "type": "application/vnd.abiquo.enterprise+json", 
      "rel": "enterprises", 
      "title": "enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185/action/allowallenterprises", 
      "type": "", 
      "rel": "allowallenterprises", 
      "title": "allow all enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185/action/restrictallenterprises", 
      "type": "", 
      "rel": "restrictallenterprises", 
      "title": "restrict all enterprises"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185/action/adddatastores", 
      "type": "application/vnd.abiquo.links+json", 
      "rel": "adddatastores", 
      "title": "add datastores to a tier"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/317/datastoretiers/185/action/releasedatastores", 
      "type": "application/vnd.abiquo.links+json", 
      "rel": "releasedatastores", 
      "title": "release datastores from a tier"
    }
  ], 
  "defaultForDatacenter": false, 
  "defaultAllowed": false, 
  "enabled": true, 
  "description": "1338"
}

 

Add datastores to a datastore tier

Add datastores to a datastore tier. This method accepts a collection of links to datastores.

Also use this method to change datastores from another tier to the desired tier.

If a datastore has managed virtual machines, it cannot be added and a 409 conflict error is thrown.

All instances of a shared datastore must always be in the same tier. When you add the datastore instance for one physical machine, the platform will attempt to add all the other instances. If any of the instances has managed virtual machines, the shared datastore cannot be added and a 409 conflict error is thrown.

You can obtain a list of datastores to add from the list datastores method in the datacenter resource using the "availabletoadd" parameter with the ID of the datastore tier.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}/action/adddatastores
Roles Required: PHYS_DC_ALLOW_MODIFY_SERVERS
Request Headers: Accept:  Content-type: application/vnd.abiquo.links+json; version=4.4; application/vnd.abiquo.links+xml; version=4.4; ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: Links Media Type
Response Message Body Entity:
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_dstrs_X_act_adddstrs_CT_lnks_j.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/275/datastoretiers/150/action/adddatastores \ 
	 -H 'Accept:application/vnd.abiquo.links+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.links+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

{
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/275/racks/125/machines/130/datastores/124", 
      "rel": "datastore"
    }
  ]
}

Response payload:

--none--

Release datastores from a datastore tier

Release datastores from a datastore tier. This method accepts a collection of links to datastores. 

Use this method when you do not want to add the datastores to another tier. Use the Add datastores method to change datastores from another tier to the desired tier.

If a datastore has managed virtual machines, it cannot be released and a 409 conflict error is thrown.

All instances of a shared datastore must always be in the same tier. When you release the datastore instance for one physical machine, the platform will attempt to release all the other instances. If any of the instances has managed virtual machines, the shared datastore cannot be released and a 409 conflict error is thrown.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}/action/releasedatastores
Roles Required: PHYS_DC_ALLOW_MODIFY_SERVERS
Request Headers: Accept:  Content-type: application/vnd.abiquo.links+json; version=4.4; application/vnd.abiquo.links+xml; version=4.4; ; 
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: Links Media Type 
Response Message Body Entity: 
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_dstrs_X_act_releasedstrs_CT_lnks_j.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/322/datastoretiers/192/action/releasedatastores \ 
	 -H 'Accept:application/vnd.abiquo.links+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.links+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

{
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/322/racks/135/machines/140/datastores/135", 
      "rel": "datastore"
    }
  ]
}

Response payload:

--none--

 

{  
   "links":[  
      {  
         "title":"ABQ_186ddd52-8c9f-48bb-be4e-a5781a995189",
         "rel":"datastore",
         "type":"application/vnd.abiquo.datastore+json",
         "href":"https://demotesting.bcn.abiquo.com:443/api/admin/datacenters/1/racks/1/machines/1/datastores/3"
      }
   ]
}

List datastores in a datastore tier

Retrieve a list of datastores by datastore tier.

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}/datastores
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.datastores+json; version=4.4; application/vnd.abiquo.datastores+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: Datastores Media Type
Request Example:

 Click here to show or hide the request example


GET_adm_dcs_X_dstrs_X_dstrs_AC_dstrs_j.0002.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/311/datastoretiers/173/datastores \ 
	 -H 'Accept:application/vnd.abiquo.datastores+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "totalSize": 2, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/311/datastoretiers/173/datastores?limit=25&by=name&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/311/datastoretiers/173/datastores?startwith=0&limit=25&by=name&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "name": "1197", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/racks/133/machines/138/datastores/132", 
          "type": "application/vnd.abiquo.datastore+json", 
          "rel": "edit", 
          "title": "1197"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/racks/133/machines/138/datastores/132/disks", 
          "type": "application/vnd.abiquo.harddisks+json", 
          "rel": "disks", 
          "title": "datastore disks"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/racks/133/machines/138", 
          "type": "application/vnd.abiquo.machine+json", 
          "rel": "machine", 
          "title": "1193"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/datastoretiers/173", 
          "type": "application/vnd.abiquo.datastoretier+json", 
          "rel": "datastoretier", 
          "title": "Datastore Tier 1"
        }, 
        {
          "href": "http://localhost:9009/api/admin/rules/datastoreloadlevel/1", 
          "type": "application/vnd.abiquo.datastoreloadrule+json", 
          "rel": "loadleveldatastore", 
          "title": "80"
        }
      ], 
      "datastoreUUID": "e7aa770e-77b2-4c1b-a4a2-20b70563665d", 
      "usedSize": 0, 
      "enabled": true, 
      "rootPath": "ds1RootPath", 
      "directory": "1196", 
      "id": 132, 
      "size": 241013719040
    }, 
    {
      "name": "1200", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/racks/133/machines/138/datastores/133", 
          "type": "application/vnd.abiquo.datastore+json", 
          "rel": "edit", 
          "title": "1200"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/racks/133/machines/138/datastores/133/disks", 
          "type": "application/vnd.abiquo.harddisks+json", 
          "rel": "disks", 
          "title": "datastore disks"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/racks/133/machines/138", 
          "type": "application/vnd.abiquo.machine+json", 
          "rel": "machine", 
          "title": "1193"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/311/datastoretiers/173", 
          "type": "application/vnd.abiquo.datastoretier+json", 
          "rel": "datastoretier", 
          "title": "Datastore Tier 1"
        }, 
        {
          "href": "http://localhost:9009/api/admin/rules/datastoreloadlevel/2", 
          "type": "application/vnd.abiquo.datastoreloadrule+json", 
          "rel": "loadleveldatastore", 
          "title": "50"
        }
      ], 
      "datastoreUUID": "41bcfb21-3bf0-4943-bffe-b88d8f5edd8f", 
      "usedSize": 0, 
      "enabled": true, 
      "rootPath": "ds2RootPath", 
      "directory": "1199", 
      "id": 133, 
      "size": 241013719040
    }
  ]
}

 

List enterprises that are allowed to use a datastore tier

Retrieve the list of enterprises that are allowed to access the given tier.

Paging Method

This method works with paging. Check out Basic Behaviors for information about how it works

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}/enterprises
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.enterprises+json; version=4.4; application/vnd.abiquo.enterprises+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

startwith

false

0

first element to retrieve

limit

false

25

number of elements to return

by

false

name

ordering the request.

has

false

 

filter the request. With this parameter the response just contains the elements
which name matches the filter value.

asc

false

true

Order ascending or descending. By default the sort mode is ascending.

Request Message Body Entity:
Response Message Body Entity: Enterprises Media Type
Request Example:

 Click here to show or hide the request example

This example uses the startwith and limit parameters to retrieve only one example.

GET_adm_dcs_X_dstrs_X_ents_AC_ents_j_startw_lmt.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/315/datastoretiers/181/enterprises?startwith=0&limit=1 \ 
	 -H 'Accept:application/vnd.abiquo.enterprises+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "totalSize": 2, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/315/datastoretiers/181/enterprises?limit=1&by=name&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/315/datastoretiers/181/enterprises?startwith=1&limit=1&by=name&asc=true", 
      "rel": "next"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/315/datastoretiers/181/enterprises?startwith=1&limit=1&by=name&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "ramHard": 1316, 
      "isReservationRestricted": false, 
      "twoFactorAuthenticationMandatory": false, 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/enterprises/400", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "edit", 
          "title": "1315"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/users", 
          "type": "application/vnd.abiquo.users+json", 
          "rel": "users", 
          "title": "users"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/properties", 
          "type": "application/vnd.abiquo.enterpriseproperties+json", 
          "rel": "properties", 
          "title": "properties"
        }, 
        {
          "href": "http://localhost:9009/api/admin/scopes/253", 
          "type": "application/vnd.abiquo.scope+json", 
          "rel": "scope", 
          "title": "Global scope"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/appslib/templateDefinitionLists", 
          "type": "application/vnd.abiquo.templatedefinitionlists+json", 
          "rel": "appslib/templateDefinitionLists", 
          "title": "template definitions lists"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/appslib/templateDefinitions", 
          "type": "application/vnd.abiquo.templatedefinitions+json", 
          "rel": "appslib/templateDefinitions", 
          "title": "template defintion paths"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/datacenterrepositories", 
          "type": "application/vnd.abiquo.datacenterrepositories+json", 
          "rel": "datacenterrepositories", 
          "title": "repositories"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/virtualmachines", 
          "type": "application/vnd.abiquo.virtualmachines+json", 
          "rel": "virtualmachines", 
          "title": "virtual machines"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/virtualappliances", 
          "type": "application/vnd.abiquo.virtualappliances+json", 
          "rel": "virtualappliances", 
          "title": "virtual appliances"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/ips", 
          "type": "application/vnd.abiquo.privateips+json", 
          "rel": "ips", 
          "title": "ips"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/virtualdatacenters", 
          "type": "application/vnd.abiquo.virtualdatacenters+json", 
          "rel": "cloud/virtualdatacenters", 
          "title": "virtual datacenters"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/reservedmachines", 
          "type": "application/vnd.abiquo.machines+json", 
          "rel": "reservedmachines", 
          "title": "reserved machines"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/limits", 
          "type": "application/vnd.abiquo.limits+json", 
          "rel": "limits", 
          "title": "limits"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/volumes", 
          "type": "application/vnd.abiquo.volumes+json", 
          "rel": "volumes", 
          "title": "volumes"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/externalnetworks", 
          "type": "application/vnd.abiquo.vlans+json", 
          "rel": "externalnetworks", 
          "title": "external networks"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/action/pendingtasks", 
          "type": "application/vnd.abiquo.tasks+json", 
          "rel": "pendingtasks", 
          "title": "pending tasks"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/credentials", 
          "type": "application/vnd.abiquo.publiccloudcredentialslist+json", 
          "rel": "credentials", 
          "title": "credentials"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/400/vappspecs", 
          "type": "application/vnd.abiquo.virtualappliancespecs+json", 
          "rel": "vappspecs", 
          "title": "virtual appliances specs"
        }
      ], 
      "workflow": false, 
      "vlansHard": 0, 
      "storageHardInMb": 0, 
      "repositorySoftInMb": 0, 
      "publicIpsSoft": 0, 
      "vlansSoft": 0, 
      "ramSoft": 1316, 
      "diskSoftLimitInMb": 1316, 
      "id": 400, 
      "diskHardLimitInMb": 1316, 
      "name": "1315", 
      "cpuHard": 1316, 
      "storageSoftInMb": 0, 
      "publicIpsHard": 0, 
      "repositoryHardInMb": 0, 
      "cpuSoft": 1316
    }
  ]
}

For a really big example, see

GET_adm_dcs_X_dstrs_X_ents_AC_ents_j_lmt

 

Allow all enterprises to use a datastore tier

This action allows the datastore tier to be used by all enterprises that use the tier's
datacenter. But if a datacenter limit does not exist between enterprise and
this datacenter, the enterprise won't be allowed to use the tier. The value of the enabled property
does not affect to this feature - the tier will be allowed independently if it's enabled
or disabled, and the enabled property will be a second level of restriction. Similarly the value
of the default allowed property does not affect this property.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}/action/allowallenterprises
Roles Required: PHYS_DC_ALLOW_MODIFY_SERVERS
Request Headers: Accept: ; Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity:
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_dstrs_X_act_allowallents.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/221/datastoretiers/124/action/allowallenterprises \ 
	 -H 'Accept:text/json,application/json' \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

--none--

Response payload:

--none--

 

Restrict all enterprises from using a datastore tier

This action restricts access to the datastore tier for all enterprises. This means that the tier cannot be used by any enterprise. This action supports the use of parameter force. If the force parameter is false and some enterprises have hard disks in the datastore tier, then a list of errors will be returned and no action will be executed. If it's true and some enterprises have hard disks in the datastore tier, then a list of errors will be returned but the enterprises without hard disks will be restricted, so they cannot to use this tier. If the request is successful, the parameter does not modify the result and a 204 (NO CONTENT) response code will be returned

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}/action/restrictallenterprises
Roles Required: PHYS_DC_ALLOW_MODIFY_SERVERS
Request Headers: Accept: ; Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

force

false

false

force

 

 

 

 

Request Message Body Entity:
Response Message Body Entity:
Request Example:

 Click here to show or hide the request example

Restrict all enterprises from using a tier with force = true

PUT_adm_dcs_X_dstrs_X_act_restallents_force_T.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/260/datastoretiers/138/action/restrictallenterprises?force=true \ 
	 -H 'Accept:text/json,application/json' \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

--none--

Response payload:

--none--

 

Delete a datastore tier

Delete a datastore tier. You cannot delete the default tier. You cannot delete tiers that contain shared datastores or datastores that contain hard disks.

Synopsis: DELETE http://example.com/api/admin/datacenters/{datacenter}/datastoretiers/{datastoretier}
Roles Required: PHYS_DC_RETRIEVE_DETAILS,PHYS_DC_ALLOW_MODIFY_SERVERS,PRICING_VIEW,USERS_MANAGE_ENTERPRISE
Request Headers: Accept:  Content-type: 
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: 
Response Message Body Entity: 
Request Example: 

 Click here to show or hide the request example

DELETE_adm_dcs_X_dstrs_X.0001.txt

cURL:

curl -X DELETE http://localhost:9000/api/admin/datacenters/295/datastoretiers/159 \ 
	 -H 'Accept:text/json,application/json' \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

--none--

Response payload:

--none--