Skip to main content

List Services belonging to a Project

GET/projects/{projectId}/services/
v2
GET
container-list-services

Request

  • projectIdstring (uuid)
    required

    ID of the Project to list Services for.

Responses

Response headers

  • X-Pagination-Limitinteger

    The limit used to select the resources for the response

  • X-Pagination-Skipinteger

    The number of skipped items

  • X-Pagination-Pagenumber

    The calculate page of the list response. Refer to parameters to learn more.

  • X-Pagination-TotalCountinteger

    The total amount of items available in the remote ressource. Use this value in combination with the limit to calculate the available pages.

application/json

OK

  • Array[
  • *object
    • deployedStateobject
      required

      The actual state of the container that is currently deployed.

      • commandarray of string

        The container command (equivalent to the Docker cmd). When omitted, this defaults to the command defined in the image.

        • Array[
        • *string
        • ]
    • entrypointarray of string

      The container entrypoint (equivalent to the Docker entrypoint). When omitted, this defaults to the entrypoint defined in the image.

      • Array[
      • *string
      • ]
  • envsobject

    Key-value map of environment variables that should be passed into the container.

    • *string
  • imagestring
    required

    The image to run, in the usual format also used by docker run and docker compose. When the image is pulled from a private registry, make sure to create it first, using the container-create-registry endpoint. The appropriate registry is matched by hostname.

  • imageDigeststring
  • portsarray of string

    Exposed ports. Follows the format <public-port>:<container-port>/<protocol>. Exposed ports can be accessed from other containers (or managed apps) within the same project. To expose a port publicly, connect it with an ingress resource.

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

    Volume mounts for this container. These items always follow the format <volume>:<mountpoint>. The <volume> may either be a named volume, or a file path in the (always present) project file system (which is shared among containers and managed apps within a project).

    • Array[
    • *string
    • ]
  • descriptionstring
    required
  • idstring (uuid)
    required
  • messagestring

    Message explaining the current state of the container. This may contain information about the current state of the container, or errors that occurred during deployment.

  • pendingStateobject
    required

    The desired state that is waiting to be reconciled.

    • commandarray of string

      The container command (equivalent to the Docker cmd). When omitted, this defaults to the command defined in the image.

      • Array[
      • *string
      • ]
  • entrypointarray of string

    The container entrypoint (equivalent to the Docker entrypoint). When omitted, this defaults to the entrypoint defined in the image.

    • Array[
    • *string
    • ]
  • envsobject

    Key-value map of environment variables that should be passed into the container.

    • *string
  • imagestring
    required

    The image to run, in the usual format also used by docker run and docker compose. When the image is pulled from a private registry, make sure to create it first, using the container-create-registry endpoint. The appropriate registry is matched by hostname.

  • imageDigeststring
  • portsarray of string

    Exposed ports. Follows the format <public-port>:<container-port>/<protocol>. Exposed ports can be accessed from other containers (or managed apps) within the same project. To expose a port publicly, connect it with an ingress resource.

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

    Volume mounts for this container. These items always follow the format <volume>:<mountpoint>. The <volume> may either be a named volume, or a file path in the (always present) project file system (which is shared among containers and managed apps within a project).

    • Array[
    • *string
    • ]
  • requiresRecreateboolean
    required
  • serviceNamestring
    required
  • shortIdstring
    required

    A short ID of the container. This is a unique identifier for the container within the project, and can be used to reference it in other API calls, or for SSH connections.

  • statusstring (one of: running, stopped, restarting, error, creating, starting)
    required
  • statusSetAtstring (date-time)
    required
  • ]

    Usage examples

    $ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/projects/f0f86186-0a5a-45b2-aa33-502777496347/services?stackId=f0f86186-0a5a-45b2-aa33-502777496347&status=running&requiresRecreate=true&searchTerm=string&sortOrder=descriptionAsc&limit=50&page=1