Overview

The Create Tier API creates a new tier on an existing workload. You can user tiers to group and organize servers within a workload. 

You can use the Get Workloads API to find the workload ID (id). 

Sample request

POST https://api.armor.com/apps/1/tiers

{
 "name": "New Tier 3"
}

Input

API Call / URLMethod / Type
/apps/{appId}/tiers POST


ParameterDescriptionRequired or optionalTypeExample
appIdThe ID of the workload that you want to add a tier toRequiredInteger1
tierDtoThe name of the new tierRequiredObjectNew Tier 3



Sample return

StatusResponse
200
{
 "id": 1,
 "name": "string",
 "location": null,
 "zone": null,
 "status": 8,
 "deployed": false,
 "tierCount": 4,
 "vmCount": 13,
 "totalCpu": 1,
 "totalMemory": 2048,
 "totalStorage": 30720,
 "tiers": [
   {
     "id": 5,
     "name": "New Tier 1",
     "vms": []
   },
   {
     "id": 6,
     "name": "New Tier 2",
     "vms": []
   },
   {
     "id": 7,
     "name": "New Tier 3",
     "vms": []
   }
 ],
 "notes": null,
 "health": 0,
 "tags": []
}



Output

ReturnTypeDescriptionPossible valuesExample
statusIntegerThe state of the objectA range of numbers from -1 to 19 (See Note below for possible values)
8