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 / URL	Method / Type
/apps/{appId}/tiers	POST

Parameter	Description	Required or optional	Type	Example
appId	The ID of the workload that you want to add a tier to	Required	Integer	1
tierDto	The name of the new tier	Required	Object	New Tier 3

Sample return

Status

Response

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

Return	Type	Description	Possible values	Example
status	Integer	The state of the object	A range of numbers from -1 to 19 (See Note below for possible values)	8