Create an Instance Type

POST

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/instance/type

POST

/v2/org/:org/nico/instance/type

$ curl -X POST https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/instance/type \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "x3.large",
>   "siteId": "8d97fa69-9199-49ff-bcf3-168c62d3874e",
>   "description": "Part of X family, the X3 Large features increased compute power",
>   "labels": {
>     "region": "portland",
>     "env": "staging"
>   },
>   "machineCapabilities": [
>     {
>       "type": "CPU",
>       "name": "Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz",
>       "frequency": "3.0GHz",
>       "count": 2
>     },
>     {
>       "type": "Memory",
>       "name": "Corsair Vengeance LPX",
>       "capacity": "32GB",
>       "count": 4
>     }
>   ]
> }'

1 {
2   "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
3   "name": "x3.large",
4   "description": "Part of X family, the X3 Large features increased compute power",
5   "infrastructureProviderId": "5f2cc306-76e9-4fca-9186-950c9ef9a74e",
6   "siteId": "72771e6a-6f5e-4de4-a5b9-1266c4197811",
7   "labels": {
8     "region": "portland",
9     "env": "staging"
10   },
11   "machineCapabilities": [
12     {
13       "type": "CPU",
14       "name": "Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz",
15       "frequency": "3.0GHz",
16       "cores": 18,
17       "threads": 36,
18       "count": 2
19     },
20     {
21       "type": "Memory",
22       "name": "Corsair Vengeance LPX",
23       "capacity": "32GB",
24       "count": 4
25     }
26   ],
27   "status": "Pending",
28   "statusHistory": [
29     {
30       "status": "Pending",
31       "message": "Request received, pending processing",
32       "created": "2019-08-24T14:15:22Z",
33       "updated": "2019-08-24T14:15:22Z"
34     }
35   ],
36   "deprecations": [
37     {
38       "queryParam": "includeMachineAssociation",
39       "replacedBy": "includeMachineAssignment",
40       "takeActionBy": "2023-07-26T00:00:00Z",
41       "notice": "'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."
42     },
43     {
44       "attribute": "displayName",
45       "takeActionBy": "2024-10-30T00:00:00Z",
46       "notice": "'displayName' has been deprecated. Please take action immediately."
47     }
48   ],
49   "created": "2019-08-24T14:15:22Z",
50   "updated": "2019-08-24T14:15:22Z"
51 }

Create an Instance Type for Infrastructure Provider.

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

Request

This endpoint expects an object.

namestringRequired2-256 characters

Name of the Instance Type

siteIdstringRequiredformat: "uuid"

ID of the site

descriptionstring or nullOptional

Description of the Instance Type

labelsmap from strings to stringsOptional

User-defined key-value labels for the Instance Type

controllerMachineTypestring or nullOptional

Site Controller assigned Machine type

machineCapabilitieslist of objectsOptional

List of Machine Capabilities to match

Response

Created

idstringRead-onlyformat: "uuid"

Unique UUID v4 identifier for the Instance Type

namestring2-256 characters

Name of the Instance Type

descriptionstring or null

Description of the Instance Type

controllerMachineTypestring or null

Machine type assigned by Site Controller

infrastructureProviderIdstringformat: "uuid"

ID of the Infrastructure Provider that owns the Instance Type

siteIdstringformat: "uuid"

ID of the Site that owns the Instance Type

labelsmap from strings to strings

User-defined key-value labels for the Instance Type

machineCapabilitieslist of objects

List of capabilities that are supported by the Machine's of this Instance Type

machineInstanceTypeslist of objects

Available only for Providers

allocationStatsobject

summary of machine counts by allocation status

statusenum

Status of the Instance Type

statusHistorylist of objects

Chronological status history for the Instance Type

deprecationslist of objects

Deprecation notices for fields returned by this resource

createddatetimeRead-only

Date/time when the InstanceType was created

updateddatetimeRead-only

Date/time when the InstanceType was last updated

Errors

400

Bad Request Error

403

Forbidden Error