Retrieve an Instance Type

GET

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

GET

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

curl https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/instance/type/instanceTypeId \
     -H "Authorization: Bearer <token>"

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "x3.large",
  "description": "Part of X family, the X3 Large features increased compute power",
  "infrastructureProviderId": "5f2cc306-76e9-4fca-9186-950c9ef9a74e",
  "siteId": "72771e6a-6f5e-4de4-a5b9-1266c4197811",
  "labels": {
    "env": "staging",
    "region": "portland"
  },
  "machineCapabilities": [
    {
      "type": "CPU",
      "name": "Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz",
      "frequency": "3.0GHz",
      "cores": 18,
      "threads": 36,
      "count": 2
    }
  ],
  "allocationStats": {
    "assigned": 30,
    "total": 10,
    "used": 3,
    "unused": 7,
    "unusedUsable": 7,
    "maxAllocatable": 20
  },
  "status": "Pending",
  "statusHistory": [
    {
      "status": "Pending",
      "message": "Request received, pending processing",
      "created": "2019-08-24T14:15:22Z",
      "updated": "2019-08-24T14:15:22Z"
    }
  ],
  "created": "2019-08-24T14:15:22Z",
  "updated": "2019-08-24T14:15:22Z"
}

Get an Instance Type by ID.

If the org has an Infrastructure Provider entity that owns the Instance Type, then the Instance Type detail is returned. User must have authorization role with PROVIDER_ADMIN suffix.

If the org has a Tenant entity and it has a Tenant Account with the Infrastructure Provider of the Instance Type, then the Instance Type detail is returned. User must have authorization role with TENANT_ADMIN suffix.

Get an Instance Type by ID. If the org has an Infrastructure Provider entity that owns the Instance Type, then the Instance Type detail is returned. User must have authorization role with `PROVIDER_ADMIN` suffix. If the org has a Tenant entity and it has a Tenant Account with the Infrastructure Provider of the Instance Type, then the Instance Type detail is returned. User must have authorization role with `TENANT_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

instanceTypeIdstringRequiredformat: "uuid"

ID of the Instance Type

Query parameters

includeMachineAssociationbooleanOptional

Include Machine associations for each Instance Type. Can only be requested by Provider

includeAllocationStatsbooleanOptional

Include Allocation stats. Currently can only be requested by Tenant

includeRelationenumOptional

Related entity to expand

Allowed values:

Response

idstringOptionalRead-onlyformat: "uuid"

Unique UUID v4 identifier for the Instance Type

namestringOptional2-256 characters

Name of the Instance Type

descriptionstring or nullOptional

Description of the Instance Type

controllerMachineTypestring or nullOptional

Machine type assigned by Site Controller

infrastructureProviderIdstringOptionalformat: "uuid"

ID of the Infrastructure Provider that owns the Instance Type

siteIdstringOptionalformat: "uuid"

ID of the Site that owns the Instance Type

labelsmap from strings to stringsOptional

User-defined key-value labels for the Instance Type

machineCapabilitieslist of objectsOptional

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

machineInstanceTypeslist of objectsOptional

Available only for Providers

allocationStatsobjectOptional

summary of machine counts by allocation status

statusenumOptional

Status of the Instance Type

statusHistorylist of objectsOptional

Chronological status history for the Instance Type

deprecationslist of objectsOptional

Deprecations active for this resource. Returned only if there are active deprecations.

createddatetimeOptionalRead-only

Date/time when the InstanceType was created

updateddatetimeOptionalRead-only

Date/time when the InstanceType was last updated

Errors

403

Forbidden Error