Environment

CRUD - Create, Update, Delete

Get Environments

GET https://api.perun.cloud/api/v1/environments

This endpoint allows you to get free cakes.

Headers

Name	Type	Description
Authentication	string	Authentication token

200 Cake successfully retrieved

{
    "environments": []
}

401 token expired or not valid

Get Environment

GET https://api.perun.cloud/api/v1/environment/[env_id]

Headers

Name	Type	Description
Authentication	string	Authentication token

200

{
    "environment": []
}

401

Create environment

post

Header parameters

AuthorizationstringOptional

Content-TypestringRequired

Body

application/json

loggingstringRequired

Responses

200Success

No content

post

/environments

HTTPcURLJavaScriptPython

POST /api/v1/environments HTTP/1.1
Host: api.perun.cloud
Content-Type: application/json
Accept: */*
Content-Length: 876

{
  "environment": {
    "name": "mixed",
    "region": "us-east-2",
    "entryService": "",
    "provider": "AWS",
    "services": [
      {
        "name": "demo",
        "type": "instance",
        "ami_id": "ami-05bd91861c26b1d36",
        "ports": "",
        "cpu": 100,
        "memory": 300,
        "expose": false
      },
      {
        "name": "logger",
        "type": "docker",
        "imageId": "chentex/random-logger:latest",
        "ports": "",
        "cpu": 100,
        "memory": 300,
        "expose": false
      }
    ],
    "stack": [
      {
        "type": "RDS",
        "config~": {
          "rds_engine": "postgres",
          "rds_engine_version": "12.3",
          "rds_instance_class": "db.t3.micro",
          "name": "rds1341",
          "rds_storage_type": "gp2",
          "rds_username": "user1",
          "rds_password": "blablapwd"
        },
        "config": {
          "rds_engine": "postgres",
          "rds_engine_version": "12.3",
          "name": "rds1341"
        },
        "output": {}
      },
      {
        "type": "SQS",
        "run_sequentially": true,
        "config": {
          "name": "q01-20"
        },
        "output": {}
      },
      {
        "type": "S3",
        "config": {
          "name": "bbb20"
        },
        "output": {}
      }
    ],
    "workers": [],
    "cost": "556",
    "isExpanded": false,
    "ttl": "2020-09-30T21:00:00.000Z"
  },
  "logging": "stdout"
}

200Success

No content

Update environment

put

Header parameters

AuthorizationstringOptional

Content-TypestringRequired

Body

application/json

loggingstringRequired

Responses

200Success

No content

put

/environments/609148d2fe28b7b51f5d5539

HTTPcURLJavaScriptPython

PUT /api/v1/environments/609148d2fe28b7b51f5d5539 HTTP/1.1
Host: api.perun.cloud
Content-Type: application/json
Accept: */*
Content-Length: 358

{
  "logging": "stdout",
  "environment": {
    "name": "ttt1",
    "entryService": "ttt1-1",
    "provider": "AWS",
    "services": [
      {
        "name": "wiki02",
        "ports": "5001",
        "cpu": 250,
        "memory": 1250,
        "type": "docker",
        "imageId": "558070116784.dkr.ecr.eu-central-1.amazonaws.com/scraper:latest",
        "isPublic": false
      }
    ],
    "stack": [],
    "workers": [],
    "cost": "556",
    "isExpanded": false,
    "ttl": "2020-09-30T21:00:00.000Z"
  }
}

200Success

No content

Delete environment

delete

Header parameters

AuthorizationstringOptional

Content-TypestringRequired

OriginstringRequired

Responses

200Success

No content

delete

/environments/60a4ea747dd2ce9568e91afb

HTTPcURLJavaScriptPython

DELETE /api/v1/environments/60a4ea747dd2ce9568e91afb HTTP/1.1
Host: api.perun.cloud
Content-Type: text
Origin: text
Accept: */*

200Success

No content