Skip to main content

Machines

Cost-optimized machine series up to 32 vCPUs with up to 128 GB of memory with a maximum of 8 GB per vCPU.

Get the available machines for a Provider and Region​

Provide the API with both provider and region to get the available machines.

curl -X 'GET' \
  'https://api.gigapipe.com/v1/machines?provider={provider_id}&region={region_id}' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <your_access_token>'
# Payload response ::Array[Dictionary]
[
  {
    "ram": 8,
    "cpu": 2,
    "id": 1,
    "price": 0.00336,
    "name": "m5_large",
    "provider": {
      "id": 2,
      "name": "AWS"
    },
    "region": {
      "id": 4,
      "name": "Ashburn, Virginia",
      "code": "us-east-1"
    },
    "ram_unit": "Binary"
  }
  ...
]

Get a single machine​

Provide the API with the machine ID to get the full object.

curl -X 'GET' \
  'https://api.gigapipe.com/v1/machines/{id}' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <your_access_token>'
# Payload response ::Dictionary
{
  "ram": 8,
  "cpu": 2,
  "id": 1,
  "price": 0.00336,
  "name": "m5_large",
  "provider": {
    "id": 2,
    "name": "AWS"
  },
  "region": {
    "id": 4,
    "name": "Ashburn, Virginia",
    "code": "us-east-1"
  },
  "ram_unit": "Binary"
}

Parameters​

Attributes​

provider  ::Integer

The provider id which you want to get the machines for

region  ::Integer

The region id which you want to get the machines for

The Machine Object​

Attributes​

id  ::Integer

The id of the region on Gigapipe

name  ::String

The name of the machine according to its provider

ram  ::Integer

The machine RAM memory (GB/GiB)

cpu  ::Integer

The number of cores the CPU has

price  ::Float

The machine price per minute

ram_unit  ::String

Binary stands for GiB/TiB, whereas Decimal means GB/TB

provider  ::Provider

The gigapipe provider object

region  ::Region

The gigapipe region object