VMs

Create VM

post

Create VM

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Instance Rent Request

vmTypeIdinteger · int32Required

machine model type id

regionstringRequired

region

regionIdinteger · int32Optional

nickNamestring · min: 1 · max: 255Required

isSpotinteger · int32Required

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/openapi/v1/vms/create

HTTPcURLJavaScriptPython

POST /openapi/v1/vms/create HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "vmTypeId": 1,
  "region": "text",
  "regionId": 1,
  "nickName": "text",
  "isSpot": 1
}

{
  "message": "text",
  "code": 1,
  "data": {
    "id": 1,
    "orgId": "text",
    "nickname": "text",
    "gpuDisplayName": "text",
    "ipAddress": "text",
    "domainName": "text",
    "cpuCores": 1,
    "memoryInGb": "text",
    "gpuCount": 1,
    "gpuMemoryInGb": "text",
    "region": "text",
    "storageInGb": "text",
    "notebookUrl": "text",
    "sshTemplate": "text",
    "status": "text",
    "createdAt": 1,
    "terminatedAt": 1,
    "updatedAt": 1,
    "osInfo": "text",
    "gpuType": "text",
    "isSpot": 1
  }
}

Get Org VM list

post

Get Org VM list

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Yotta Page Request

pageNumberinteger · int64 · min: 1Required

Yotta pageNumber

pageSizeinteger · int64 · min: 1Required

Yotta pageSize

pageMarkinteger · int64Optional

Yotta pageMark for cursor-based pagination

totalPageinteger · int64Optional

Yotta totalPage

totalRowinteger · int64Optional

Yotta totalRow

nextPagebooleanOptional

Next Page

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/openapi/v1/vms/list

HTTPcURLJavaScriptPython

POST /openapi/v1/vms/list HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "search": {
    "status": "text"
  },
  "pageNumber": 1,
  "pageSize": 1,
  "pageMark": 1,
  "totalPage": 1,
  "totalRow": 1,
  "nextPage": true
}

{
  "message": "text",
  "code": 1,
  "data": {
    "records": [
      {
        "id": 1,
        "orgId": "text",
        "nickname": "text",
        "gpuDisplayName": "text",
        "ipAddress": "text",
        "domainName": "text",
        "cpuCores": 1,
        "memoryInGb": "text",
        "gpuCount": 1,
        "gpuMemoryInGb": "text",
        "region": "text",
        "storageInGb": "text",
        "notebookUrl": "text",
        "sshTemplate": "text",
        "status": "text",
        "createdAt": 1,
        "terminatedAt": 1,
        "updatedAt": 1,
        "osInfo": "text",
        "gpuType": "text",
        "isSpot": 1
      }
    ],
    "pageNumber": 1,
    "pageSize": 1,
    "totalPage": 1,
    "totalRow": 1
  }
}

Get VM details

get

Get VM details

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vmIdinteger · int64Required

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

get

/openapi/v1/vms/{vmId}

HTTPcURLJavaScriptPython

GET /openapi/v1/vms/{vmId} HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": {
    "id": 1,
    "orgId": "text",
    "nickname": "text",
    "gpuDisplayName": "text",
    "ipAddress": "text",
    "domainName": "text",
    "cpuCores": 1,
    "memoryInGb": "text",
    "gpuCount": 1,
    "gpuMemoryInGb": "text",
    "region": "text",
    "storageInGb": "text",
    "notebookUrl": "text",
    "sshTemplate": "text",
    "status": "text",
    "createdAt": 1,
    "terminatedAt": 1,
    "updatedAt": 1,
    "osInfo": "text",
    "gpuType": "text",
    "isSpot": 1
  }
}

Get available Instance ModelType

get

Get available Instance ModelType

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

*/*

400

Bad Request

*/*

404

Not Found

*/*

500

Internal Server Error

*/*

get

/openapi/v1/vms/type

HTTPcURLJavaScriptPython

GET /openapi/v1/vms/type HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": [
    {
      "gpuType": "text",
      "regions": [
        {
          "region": "text",
          "types": [
            {
              "vmTypeId": 1,
              "gpuCount": 1,
              "pricePerHour": "text",
              "supportSpot": 1,
              "spotPricePerHour": "text",
              "currency": "text",
              "displayName": "text",
              "cpuCores": 1,
              "memoryInGb": "text",
              "gpuMemoryInGb": "text",
              "gpuTotalMemoryInGb": "text",
              "storageType": "text",
              "storageCapacityInGb": "text",
              "osName": "text",
              "osVersion": "text",
              "supportOnDemand": 1,
              "ondemandAvailable": 1,
              "spotAvailable": 1
            }
          ]
        }
      ]
    }
  ]
}

Terminate VM

delete

Terminate VM

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vmIdinteger · int64Required

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

11000

Instance not exist

*/*

11001

Instance status invalid

*/*

11002

No terminate instance permissions

*/*

12001

Resource status invalid

*/*

delete

/openapi/v1/vms/{vmId}/terminate

HTTPcURLJavaScriptPython

DELETE /openapi/v1/vms/{vmId}/terminate HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": null
}