TiersResource


List tiers


GET https://example.com/api/admin/datacenters/{datacenter}/storage/tiers

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS, ROLE_VDC_MANAGE_STORAGE, ROLE_VAPP_CREATE_STATEFUL, ROLE_PRICING_VIEW, ROLE_USERS_MANAGE_ENTERPRISE]

Accept : tiers

Error Codes

  • DC-0 - The requested datacenter does not exist

Example

Get a tier


GET https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS, ROLE_VDC_MANAGE_STORAGE, ROLE_VAPP_CREATE_STATEFUL, ROLE_PRICING_VIEW, ROLE_USERS_MANAGE_ENTERPRISE]

Accept : tier

Error Codes

  • TIER-0 - The requested storage tier does not exist

Example

Update a tier


PUT https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}

Roles : [ROLE_PHYS_DC_ALLOW_MODIFY_STORAGE]

Content-Type : tier Accept : tier

Error Codes

  • CONSTR-NOTNULL - The property 'storageAllocationPolicy' may not be null.
  • TIER-10 - The supplied storage allocation policy is not of a valid type

Example

Allow a tier to all enteprises


This action allows the tier to be used by all enterprises that use the tier's datacenter. The value of the enabled attribute does not affect this functionality, because a tier will be allowed to all enterprises independently of whether it is enabled or disabled, which will be a second level of restriction. Similarly the value of the defaultAllowed attribute of the tier does not affect this functionality.

PUT https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}/action/allowallenterprises

Roles : [ROLE_PHYS_DC_ALLOW_MODIFY_STORAGE]

Example

Restrict a tier to all enteprises


This action restricts the tier for all enterprises. This means that the tier cannot be used by any enterprise. This action supports the use of the force parameter.
If the request is successful, i.e. no enterprises have volumes in the tier, then the force parameter does not modify the result and a 204 (NO CONTENT) response code will be returned.

If the force parameter is not specified as ''true''and some enterprises have volumes in the tier, then a list of errors will be returned and no action will be taken.

PUT https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}/action/restrictallenterprises

Roles : [ROLE_PHYS_DC_ALLOW_MODIFY_STORAGE]

Parameter Type Default Value Description
force boolean false If true and some enterprises have volumes in the tier, then a list of errors will be returned but the enterprises without volumes will be restricted, so they cannot use this tier.

Example

List enterprises allowed for a tier


Retrieve enterprises that are allowed to access a tier.

GET https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}/enterprises

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS]

Parameter Type Default Value Description
startwith Integer 0 The first element to be retrieved of the filtered search
limit Integer 25 The number of entities to retrieve
by String name Order by
has String If present filter to apply in the search.
asc Boolean true If the value of the 'by' parameter must be sorted in ascending order (true) or descending order (false)

Accept : enterprises

Example

List storage pools of a tier


GET https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}/pools

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS, ROLE_VAPP_CREATE_STATEFUL]

Accept : storagepools

List storage pools of a tier with storage device


GET https://example.com/api/admin/datacenters/{datacenter}/storage/tiers/{tier}/pools

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS, ROLE_VAPP_CREATE_STATEFUL]

Example