Create, update or delete Services or Volumes belonging to a Stack

PATCH/stacks/{stackId}/

API version

v2

Request method

PATCH

Operation ID

container-update-stack

---

Request

• stackIdstring (uuid)

  required

  ID of the Stack to create, update or delete Services or Volumes for.

Responses

Format

application/json

Beschreibung

OK

Schema-Dokumentation

• descriptionstring

  required
• disabledboolean

  required
• idstring (uuid)

  required
• prefixstring

  required

  Prefix for all service-names in this stack.

• projectIdstring (uuid)

  required
• servicesarray of object
  • Array[
  • *object
    • deployedStateobject

      required
      • commandarray of string
        • Array[
        • *string
        ]
    • entrypointarray of string
      • Array[
      • *string
      ]
  • envsobject
    • *string
  • imagestring

    required
  • portsarray of string
    • Array[
    • *string
    ]
• volumesarray of string
  • Array[
  • *string
  ]

descriptionstring

required

idstring (uuid)

required

pendingStateobject

required

• commandarray of string
  • Array[
  • *string
  ]

entrypointarray of string

• Array[
• *string
]

envsobject

• *string

imagestring

required

portsarray of string

• Array[
• *string
]

volumesarray of string

• Array[
• *string
]

projectIdstring (uuid)

required

serviceNamestring

required

stackIdstring (uuid)

required

statusstring (one of: running, stopped, restarting, error, creating, starting)

required

]

volumesarray of object

• Array[
• *object
  • idstring (uuid)

    required
  • namestring

    required
  • orphanedboolean

    required

    Whether the Volume is attached to a Stack.

  • stackIdstring (uuid)

    required
  • storageUsageInBytesinteger

    required
  • storageUsageInBytesSetAtstring (date-time)

    required
]

Beispiel

{
  "description": "string",
  "disabled": true,
  "id": "f0f86186-0a5a-45b2-aa33-502777496347",
  "prefix": "string",
  "projectId": "f0f86186-0a5a-45b2-aa33-502777496347",
  "services": [
    {
      "deployedState": {
        "command": [
          "string"
        ],
        "entrypoint": [
          "string"
        ],
        "envs": {
          "string": "string"
        },
        "image": "string",
        "ports": [
          "string"
        ],
        "volumes": [
          "string"
        ]
      },
      "description": "MySQL DB",
      "id": "f0f86186-0a5a-45b2-aa33-502777496347",
      "pendingState": {
        "command": [
          "string"
        ],
        "entrypoint": [
          "string"
        ],
        "envs": {
          "string": "string"
        },
        "image": "string",
        "ports": [
          "string"
        ],
        "volumes": [
          "string"
        ]
      },
      "projectId": "f0f86186-0a5a-45b2-aa33-502777496347",
      "serviceName": "mysql-db",
      "stackId": "f0f86186-0a5a-45b2-aa33-502777496347",
      "status": "running"
    }
  ],
  "volumes": [
    {
      "id": "f0f86186-0a5a-45b2-aa33-502777496347",
      "name": "string",
      "orphaned": true,
      "stackId": "f0f86186-0a5a-45b2-aa33-502777496347",
      "storageUsageInBytes": 123,
      "storageUsageInBytesSetAt": "2024-11-08T18:11:33.015Z"
    }
  ]
}

JSON Schema

{
  "properties": {
    "description": {
      "type": "string"
    },
    "disabled": {
      "type": "boolean"
    },
    "id": {
      "format": "uuid",
      "type": "string"
    },
    "prefix": {
      "description": "Prefix for all service-names in this stack.",
      "type": "string"
    },
    "projectId": {
      "format": "uuid",
      "type": "string"
    },
    "services": {
      "items": {
        "properties": {
          "deployedState": {
            "properties": {
              "command": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "entrypoint": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "envs": {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              "image": {
                "type": "string"
              },
              "ports": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "volumes": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "required": [
              "image"
            ],
            "type": "object"
          },
          "description": {
            "example": "MySQL DB",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "pendingState": {
            "properties": {
              "command": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "entrypoint": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "envs": {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              "image": {
                "type": "string"
              },
              "ports": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "volumes": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "required": [
              "image"
            ],
            "type": "object"
          },
          "projectId": {
            "format": "uuid",
            "type": "string"
          },
          "serviceName": {
            "example": "mysql-db",
            "type": "string"
          },
          "stackId": {
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "enum": [
              "running",
              "stopped",
              "restarting",
              "error",
              "creating",
              "starting"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "stackId",
          "projectId",
          "description",
          "serviceName",
          "pendingState",
          "deployedState",
          "status"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "volumes": {
      "items": {
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "orphaned": {
            "description": "Whether the Volume is attached to a Stack.",
            "type": "boolean"
          },
          "stackId": {
            "format": "uuid",
            "type": "string"
          },
          "storageUsageInBytes": {
            "type": "integer"
          },
          "storageUsageInBytesSetAt": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "stackId",
          "name",
          "orphaned",
          "storageUsageInBytes",
          "storageUsageInBytesSetAt"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "projectId",
    "description",
    "disabled",
    "prefix"
  ],
  "type": "object"
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -X PATCH \
    -d '{"services":{"string":{"command":["mysqld"],"description":"MySQL DB","entrypoint":["docker-entrypoint.sh"],"envs":{"MYSQL_DATABASE":"my_db","MYSQL_PASSWORD":"my_password","MYSQL_ROOT_PASSWORD":"my_root_password","MYSQL_USER":"my_user"},"image":"mysql","ports":["3306:3306/tcp"],"volumes":["data:/var/lib/mysql"]}},"volumes":{"string":{"name":"mysql-volume"}}}' \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    -H 'Content-Type: application/json' \
    https://api.mittwald.de/v2/stacks/f0f86186-0a5a-45b2-aa33-502777496347

JavaScript SDK

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.container.updateStack({
  "stackId": "f0f86186-0a5a-45b2-aa33-502777496347",
  "data": {
    "services": {
      "string": {
        "command": [
          "mysqld"
        ],
        "description": "MySQL DB",
        "entrypoint": [
          "docker-entrypoint.sh"
        ],
        "envs": {
          "MYSQL_DATABASE": "my_db",
          "MYSQL_PASSWORD": "my_password",
          "MYSQL_ROOT_PASSWORD": "my_root_password",
          "MYSQL_USER": "my_user"
        },
        "image": "mysql",
        "ports": [
          "3306:3306/tcp"
        ],
        "volumes": [
          "data:/var/lib/mysql"
        ]
      }
    },
    "volumes": {
      "string": {
        "name": "mysql-volume"
      }
    }
  }
});

assertStatus(response, 200);
  

PHP SDK

use \Mittwald\ApiClient\Generated\V2\Clients\Container\UpdateStack\UpdateStackRequest;
use \Mittwald\ApiClient\Generated\V2\Clients\Container\UpdateStack\UpdateStackRequestBody;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

// TODO: Please consult the properties and constructor signature of
// UpdateStackRequestBody to learn how to construct a valid instance
$body = new UpdateStackRequestBody(/* TODO: ... */);

$request = (new UpdateStackRequest(
  stackId: "f0f86186-0a5a-45b2-aa33-502777496347",
  body: $body
));
$response = $client->container()->updateStack($request);

var_dump($response->getBody();