Skills
Log in

Put deployment service

Creates or updates a deployment service.

Required permission

Project > Services > General > Create

Path parameters

    • projectId

      string required
      ID of the project

Request body

  • {object}
    • name

      string required
      The name of the service.
      min length
      3
      max length
      54
      pattern
      ^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
    • description

      string
      A description of the service.
      max length
      200
      pattern
      ^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
    • stageId

      string
      min length
      3
      max length
      100
      pattern
      ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
    • tags

      [array]
      An array of previously defined tags to help identify and group the resource.
      • string
        min length
        3
        max length
        100
        pattern
        ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
    • billing

      {object} required
      • deploymentPlan

        string required
        The ID of the deployment plan to use.
        min length
        3
        max length
        100
        pattern
        ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
      • gpu

        {object}
        • enabled

          boolean
          Whether GPUs are enabled for this workload.
        • configuration

          {object}
          • gpuType

            string required
            The type of GPU to use.
          • gpuCount

            integer
            The number of GPUs to allocate.
          • timesliced

            boolean
            Whether GPU timeslicing is enabled.
    • infrastructure

      {object}
      • architecture

        string
        one of
        x86, arm
    • deployment

      (multiple options: oneOf) required
      Deployment type
      • {object}
        Internal deployment
        • type

          string
          The way the service should be deployed. Either as a deployment (default), or as a stateful set.
          one of
          deployment, statefulSet
        • instances

          integer required
          The number of instances to run the service on.
        • buildpack

          {object}
          Allows for customization of buildpack runtime
          • configType

            string required
            Type of buildpack run configuration
            one of
            default, customProcess, customCommand, customEntrypointCustomCommand, originalEntrypointCustomCommand
          • customProcess

            string
            Custom process which should be run. Required in case where `configType` is `customProcess`
          • customEntrypoint

            string
            Custom entrypoint which should be run. Required in case where `configType` is `customEntrypointCustomCommand`
          • customCommand

            string
            Custom command which should be run. Required in case where `configType` is `customCommand`, `customEntrypointCustomCommand` or `originalEntrypointCustomCommand`
        • docker

          {object}
          Allows for customization of docker runtime
          • configType

            string required
            Type of entrypoint & command override configuration
            one of
            default, customEntrypoint, customCommand, customEntrypointCustomCommand
          • customEntrypoint

            string
            Custom entrypoint which should be used. Required in case where `configType` is `customEntrypoint` or `customEntrypointCustomCommand`
          • customCommand

            string
            Custom command which should be used. Required in case where `configType` is `customCommand` or `customEntrypointCustomCommand`
        • storage

          {object}
          • useHdbStorage

            boolean
          • usePdSsdStorage

            boolean
          • ephemeralStorage

            {object}
            • storageSize

              integer
              Ephemeral storage per container in MB
              min
              1024
          • shmSize

            integer
            Configures the amount of available memory-backed disk space available to /dev/shm
            min
            64
        • strategy

          {object}
          Roll out strategy of the service
          • type

            string
            Configures the instance roll out strategy of your service. Currently only available via feature flag.
            one of
            rollout-steady, rollout-balanced, rollout-fast, custom, recreate
          • settings

            {object}
            • maxSurge

              (multiple options: oneOf) required
              Maximum number or percentage of pods that can be created above the desired count.
              • integer
                A non-negative integer.
              • OR

              • string
                A percentage string in the range 0% to 100%, e.g. `25%`
                pattern
                ^\d+%$
            • maxUnavailable

              (multiple options: anyOf) required
              Maximum number or percentage of pods that can be unavailable during the update.
              • integer
                A non-negative integer.
              • OR

              • string
                A percentage string in the range 0% to 100%, e.g. `25%`
                pattern
                ^\d+%$
        • zonalRedundancy

          {object}
          • type

            string
            Defines scheduling behaviour across different zones within the same region.
            one of
            disabled, preferred, required
          • minZones

            integer
            Defines how many zones are required and will prevent containers from additional scheduling into existing zones. (Only relevant if type is set to "required")
            min
            1
        • gpu

          {object}
          • enabled

            boolean
            Whether GPUs are enabled for this workload.
          • configuration

            {object}
            • gpuType

              string required
              The type of GPU to use.
            • gpuCount

              integer
              The number of GPUs to allocate.
            • timesliced

              boolean
              Whether GPU timeslicing is enabled.
        • gracePeriodSeconds

          integer
          The maximum amount of time the process has to shut down after receiving a SIGTERM signal before it is forcefully shut down SIGKILL by the system. Maximum 1800 seconds for PaaS projects and 86400 seconds for BYOC projects.
          min
          15
          max
          86400
        • gradualRolloutStrategyId

          (multiple options: oneOf)
          The id of the strategy to be attached to service.
          • The id of the strategy to be attached to service.
        • ssh

          {object}
          Controls related to SSH access within the resource.
          • enabled

            boolean required
            Enables SSH access if the resource matches an SSH identity selector.
        • metadata

          {object}
          Allow setting custom labels and annotations for workloads.
          • labels

            {object}
            Specify custom labels for the workload.
            • annotations

              {object}
              Specify custom annotations for the workload as string or object.
            • volumes

              [array]
              Per-replica persistent volumes for a statefulSet service. Each replica receives its own instance of every volume. Only valid when `deployment.type` is `statefulSet`.
              • {object}
                • id

                  string required
                  Slug identifying this volume within the service.
                  min length
                  3
                  max length
                  39
                  pattern
                  ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                • mounts

                  [array] required
                  Array of mounts, containerMountPaths must be unique
                  • {object}
                    • volumeMountPath

                      string
                      Optionally specify the path inside this volume that should be mounted
                      pattern
                      ^((?!\.\.).)*$
                    • containerMountPath

                      string required
                      Specify the path into which the volume should be mounted
                      pattern
                      ^((?!:).)*$
                • spec

                  {object} required
                  Per-replica volume storage schema
            • containerSnapshot

              {object}
              • restoreFrom

                string
                The successful container snapshot to restore the service from.
              • capture

                {object}
                • backupDestinationId

                  string
                  The backup destination for termination snapshots.
                • onTermination

                  boolean
                  Creates a snapshot when a service container terminates, including crashes, rollouts, scale-downs, evictions, and manual restarts.
                • retention

                  {object}
                  • maxSnapshots

                    integer
                    The maximum number of termination snapshots retained for the service.
                    min
                    1
                    max
                    100
            • internal

              {object} required
              • id

                (multiple options: anyOf)
                ID of the build service to deploy
                • string
                  The ID of a build service in the same project
                  min length
                  3
                  max length
                  54
                  pattern
                  ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                • OR

                • string
                  The ID of a build service in another project, in the format `project-id/build-service-id`
              • branch

                string
                Branch to deploy
              • buildSHA

                (multiple options: oneOf)
                Commit SHA to deploy, or 'latest' to deploy the most recent commit
                • string
                  A commit sha.
                  min length
                  40
                  max length
                  40
                • OR

                • string
                  Latest commit.
                  one of
                  latest
              • buildId

                string
                ID of the build that should be deployed

            OR

          • {object}
            External deployment
            • type

              string
              The way the service should be deployed. Either as a deployment (default), or as a stateful set.
              one of
              deployment, statefulSet
            • instances

              integer required
              The number of instances to run the service on.
            • buildpack

              {object}
              Allows for customization of buildpack runtime
              • configType

                string required
                Type of buildpack run configuration
                one of
                default, customProcess, customCommand, customEntrypointCustomCommand, originalEntrypointCustomCommand
              • customProcess

                string
                Custom process which should be run. Required in case where `configType` is `customProcess`
              • customEntrypoint

                string
                Custom entrypoint which should be run. Required in case where `configType` is `customEntrypointCustomCommand`
              • customCommand

                string
                Custom command which should be run. Required in case where `configType` is `customCommand`, `customEntrypointCustomCommand` or `originalEntrypointCustomCommand`
            • docker

              {object}
              Allows for customization of docker runtime
              • configType

                string required
                Type of entrypoint & command override configuration
                one of
                default, customEntrypoint, customCommand, customEntrypointCustomCommand
              • customEntrypoint

                string
                Custom entrypoint which should be used. Required in case where `configType` is `customEntrypoint` or `customEntrypointCustomCommand`
              • customCommand

                string
                Custom command which should be used. Required in case where `configType` is `customCommand` or `customEntrypointCustomCommand`
            • storage

              {object}
              • useHdbStorage

                boolean
              • usePdSsdStorage

                boolean
              • ephemeralStorage

                {object}
                • storageSize

                  integer
                  Ephemeral storage per container in MB
                  min
                  1024
              • shmSize

                integer
                Configures the amount of available memory-backed disk space available to /dev/shm
                min
                64
            • strategy

              {object}
              Roll out strategy of the service
              • type

                string
                Configures the instance roll out strategy of your service. Currently only available via feature flag.
                one of
                rollout-steady, rollout-balanced, rollout-fast, custom, recreate
              • settings

                {object}
                • maxSurge

                  (multiple options: oneOf) required
                  Maximum number or percentage of pods that can be created above the desired count.
                  • integer
                    A non-negative integer.
                  • OR

                  • string
                    A percentage string in the range 0% to 100%, e.g. `25%`
                    pattern
                    ^\d+%$
                • maxUnavailable

                  (multiple options: anyOf) required
                  Maximum number or percentage of pods that can be unavailable during the update.
                  • integer
                    A non-negative integer.
                  • OR

                  • string
                    A percentage string in the range 0% to 100%, e.g. `25%`
                    pattern
                    ^\d+%$
            • zonalRedundancy

              {object}
              • type

                string
                Defines scheduling behaviour across different zones within the same region.
                one of
                disabled, preferred, required
              • minZones

                integer
                Defines how many zones are required and will prevent containers from additional scheduling into existing zones. (Only relevant if type is set to "required")
                min
                1
            • gpu

              {object}
              • enabled

                boolean
                Whether GPUs are enabled for this workload.
              • configuration

                {object}
                • gpuType

                  string required
                  The type of GPU to use.
                • gpuCount

                  integer
                  The number of GPUs to allocate.
                • timesliced

                  boolean
                  Whether GPU timeslicing is enabled.
            • gracePeriodSeconds

              integer
              The maximum amount of time the process has to shut down after receiving a SIGTERM signal before it is forcefully shut down SIGKILL by the system. Maximum 1800 seconds for PaaS projects and 86400 seconds for BYOC projects.
              min
              15
              max
              86400
            • gradualRolloutStrategyId

              (multiple options: oneOf)
              The id of the strategy to be attached to service.
              • The id of the strategy to be attached to service.
            • ssh

              {object}
              Controls related to SSH access within the resource.
              • enabled

                boolean required
                Enables SSH access if the resource matches an SSH identity selector.
            • metadata

              {object}
              Allow setting custom labels and annotations for workloads.
              • labels

                {object}
                Specify custom labels for the workload.
                • annotations

                  {object}
                  Specify custom annotations for the workload as string or object.
                • volumes

                  [array]
                  Per-replica persistent volumes for a statefulSet service. Each replica receives its own instance of every volume. Only valid when `deployment.type` is `statefulSet`.
                  • {object}
                    • id

                      string required
                      Slug identifying this volume within the service.
                      min length
                      3
                      max length
                      39
                      pattern
                      ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                    • mounts

                      [array] required
                      Array of mounts, containerMountPaths must be unique
                      • {object}
                        • volumeMountPath

                          string
                          Optionally specify the path inside this volume that should be mounted
                          pattern
                          ^((?!\.\.).)*$
                        • containerMountPath

                          string required
                          Specify the path into which the volume should be mounted
                          pattern
                          ^((?!:).)*$
                    • spec

                      {object} required
                      Per-replica volume storage schema
                • containerSnapshot

                  {object}
                  • restoreFrom

                    string
                    The successful container snapshot to restore the service from.
                  • capture

                    {object}
                    • backupDestinationId

                      string
                      The backup destination for termination snapshots.
                    • onTermination

                      boolean
                      Creates a snapshot when a service container terminates, including crashes, rollouts, scale-downs, evictions, and manual restarts.
                    • retention

                      {object}
                      • maxSnapshots

                        integer
                        The maximum number of termination snapshots retained for the service.
                        min
                        1
                        max
                        100
                • external

                  {object} required
                  • imagePath

                    string required
                    Image to be deployed. When not deploying from Dockerhub the URL must be specified.
                    pattern
                    ^(?:(?:https?:\/\/)?([a-zA-Z0-9-]+\.[a-zA-Z0-9.\-]+))?(?:\/)?([a-zA-Z/-9.\-_]+)(?::([a-zA-Z/-9.\-_:]+)|@([a-zA-Z/-9.\-_:]+))$
                  • credentials

                    string
                    ID of the saved credentials to use to access this external image.
                    pattern
                    ^[A-Za-z0-9-]+$

                OR

              • {object}
                Image deployment
                • type

                  string
                  The way the service should be deployed. Either as a deployment (default), or as a stateful set.
                  one of
                  deployment, statefulSet
                • instances

                  integer required
                  The number of instances to run the service on.
                • buildpack

                  {object}
                  Allows for customization of buildpack runtime
                  • configType

                    string required
                    Type of buildpack run configuration
                    one of
                    default, customProcess, customCommand, customEntrypointCustomCommand, originalEntrypointCustomCommand
                  • customProcess

                    string
                    Custom process which should be run. Required in case where `configType` is `customProcess`
                  • customEntrypoint

                    string
                    Custom entrypoint which should be run. Required in case where `configType` is `customEntrypointCustomCommand`
                  • customCommand

                    string
                    Custom command which should be run. Required in case where `configType` is `customCommand`, `customEntrypointCustomCommand` or `originalEntrypointCustomCommand`
                • docker

                  {object}
                  Allows for customization of docker runtime
                  • configType

                    string required
                    Type of entrypoint & command override configuration
                    one of
                    default, customEntrypoint, customCommand, customEntrypointCustomCommand
                  • customEntrypoint

                    string
                    Custom entrypoint which should be used. Required in case where `configType` is `customEntrypoint` or `customEntrypointCustomCommand`
                  • customCommand

                    string
                    Custom command which should be used. Required in case where `configType` is `customCommand` or `customEntrypointCustomCommand`
                • storage

                  {object}
                  • useHdbStorage

                    boolean
                  • usePdSsdStorage

                    boolean
                  • ephemeralStorage

                    {object}
                    • storageSize

                      integer
                      Ephemeral storage per container in MB
                      min
                      1024
                  • shmSize

                    integer
                    Configures the amount of available memory-backed disk space available to /dev/shm
                    min
                    64
                • strategy

                  {object}
                  Roll out strategy of the service
                  • type

                    string
                    Configures the instance roll out strategy of your service. Currently only available via feature flag.
                    one of
                    rollout-steady, rollout-balanced, rollout-fast, custom, recreate
                  • settings

                    {object}
                    • maxSurge

                      (multiple options: oneOf) required
                      Maximum number or percentage of pods that can be created above the desired count.
                      • integer
                        A non-negative integer.
                      • OR

                      • string
                        A percentage string in the range 0% to 100%, e.g. `25%`
                        pattern
                        ^\d+%$
                    • maxUnavailable

                      (multiple options: anyOf) required
                      Maximum number or percentage of pods that can be unavailable during the update.
                      • integer
                        A non-negative integer.
                      • OR

                      • string
                        A percentage string in the range 0% to 100%, e.g. `25%`
                        pattern
                        ^\d+%$
                • zonalRedundancy

                  {object}
                  • type

                    string
                    Defines scheduling behaviour across different zones within the same region.
                    one of
                    disabled, preferred, required
                  • minZones

                    integer
                    Defines how many zones are required and will prevent containers from additional scheduling into existing zones. (Only relevant if type is set to "required")
                    min
                    1
                • gpu

                  {object}
                  • enabled

                    boolean
                    Whether GPUs are enabled for this workload.
                  • configuration

                    {object}
                    • gpuType

                      string required
                      The type of GPU to use.
                    • gpuCount

                      integer
                      The number of GPUs to allocate.
                    • timesliced

                      boolean
                      Whether GPU timeslicing is enabled.
                • gracePeriodSeconds

                  integer
                  The maximum amount of time the process has to shut down after receiving a SIGTERM signal before it is forcefully shut down SIGKILL by the system. Maximum 1800 seconds for PaaS projects and 86400 seconds for BYOC projects.
                  min
                  15
                  max
                  86400
                • gradualRolloutStrategyId

                  (multiple options: oneOf)
                  The id of the strategy to be attached to service.
                  • The id of the strategy to be attached to service.
                • ssh

                  {object}
                  Controls related to SSH access within the resource.
                  • enabled

                    boolean required
                    Enables SSH access if the resource matches an SSH identity selector.
                • metadata

                  {object}
                  Allow setting custom labels and annotations for workloads.
                  • labels

                    {object}
                    Specify custom labels for the workload.
                    • annotations

                      {object}
                      Specify custom annotations for the workload as string or object.
                    • volumes

                      [array]
                      Per-replica persistent volumes for a statefulSet service. Each replica receives its own instance of every volume. Only valid when `deployment.type` is `statefulSet`.
                      • {object}
                        • id

                          string required
                          Slug identifying this volume within the service.
                          min length
                          3
                          max length
                          39
                          pattern
                          ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                        • mounts

                          [array] required
                          Array of mounts, containerMountPaths must be unique
                          • {object}
                            • volumeMountPath

                              string
                              Optionally specify the path inside this volume that should be mounted
                              pattern
                              ^((?!\.\.).)*$
                            • containerMountPath

                              string required
                              Specify the path into which the volume should be mounted
                              pattern
                              ^((?!:).)*$
                        • spec

                          {object} required
                          Per-replica volume storage schema
                    • containerSnapshot

                      {object}
                      • restoreFrom

                        string
                        The successful container snapshot to restore the service from.
                      • capture

                        {object}
                        • backupDestinationId

                          string
                          The backup destination for termination snapshots.
                        • onTermination

                          boolean
                          Creates a snapshot when a service container terminates, including crashes, rollouts, scale-downs, evictions, and manual restarts.
                        • retention

                          {object}
                          • maxSnapshots

                            integer
                            The maximum number of termination snapshots retained for the service.
                            min
                            1
                            max
                            100
                    • image

                      {object} required
                      • projectId

                        string
                        min length
                        24
                        max length
                        24
                      • name

                        string required
                        min length
                        1
                      • group

                        string
                        min length
                        1
                      • tag

                        string required
                        min length
                        1

                    OR

                  • {object}
                    Choose later
                    • type

                      string
                      The way the service should be deployed. Either as a deployment (default), or as a stateful set.
                      one of
                      deployment, statefulSet
                    • instances

                      integer required
                      The number of instances to run the service on.
                    • buildpack

                      {object}
                      Allows for customization of buildpack runtime
                      • configType

                        string required
                        Type of buildpack run configuration
                        one of
                        default, customProcess, customCommand, customEntrypointCustomCommand, originalEntrypointCustomCommand
                      • customProcess

                        string
                        Custom process which should be run. Required in case where `configType` is `customProcess`
                      • customEntrypoint

                        string
                        Custom entrypoint which should be run. Required in case where `configType` is `customEntrypointCustomCommand`
                      • customCommand

                        string
                        Custom command which should be run. Required in case where `configType` is `customCommand`, `customEntrypointCustomCommand` or `originalEntrypointCustomCommand`
                    • docker

                      {object}
                      Allows for customization of docker runtime
                      • configType

                        string required
                        Type of entrypoint & command override configuration
                        one of
                        default, customEntrypoint, customCommand, customEntrypointCustomCommand
                      • customEntrypoint

                        string
                        Custom entrypoint which should be used. Required in case where `configType` is `customEntrypoint` or `customEntrypointCustomCommand`
                      • customCommand

                        string
                        Custom command which should be used. Required in case where `configType` is `customCommand` or `customEntrypointCustomCommand`
                    • storage

                      {object}
                      • useHdbStorage

                        boolean
                      • usePdSsdStorage

                        boolean
                      • ephemeralStorage

                        {object}
                        • storageSize

                          integer
                          Ephemeral storage per container in MB
                          min
                          1024
                      • shmSize

                        integer
                        Configures the amount of available memory-backed disk space available to /dev/shm
                        min
                        64
                    • strategy

                      {object}
                      Roll out strategy of the service
                      • type

                        string
                        Configures the instance roll out strategy of your service. Currently only available via feature flag.
                        one of
                        rollout-steady, rollout-balanced, rollout-fast, custom, recreate
                      • settings

                        {object}
                        • maxSurge

                          (multiple options: oneOf) required
                          Maximum number or percentage of pods that can be created above the desired count.
                          • integer
                            A non-negative integer.
                          • OR

                          • string
                            A percentage string in the range 0% to 100%, e.g. `25%`
                            pattern
                            ^\d+%$
                        • maxUnavailable

                          (multiple options: anyOf) required
                          Maximum number or percentage of pods that can be unavailable during the update.
                          • integer
                            A non-negative integer.
                          • OR

                          • string
                            A percentage string in the range 0% to 100%, e.g. `25%`
                            pattern
                            ^\d+%$
                    • zonalRedundancy

                      {object}
                      • type

                        string
                        Defines scheduling behaviour across different zones within the same region.
                        one of
                        disabled, preferred, required
                      • minZones

                        integer
                        Defines how many zones are required and will prevent containers from additional scheduling into existing zones. (Only relevant if type is set to "required")
                        min
                        1
                    • gpu

                      {object}
                      • enabled

                        boolean
                        Whether GPUs are enabled for this workload.
                      • configuration

                        {object}
                        • gpuType

                          string required
                          The type of GPU to use.
                        • gpuCount

                          integer
                          The number of GPUs to allocate.
                        • timesliced

                          boolean
                          Whether GPU timeslicing is enabled.
                    • gracePeriodSeconds

                      integer
                      The maximum amount of time the process has to shut down after receiving a SIGTERM signal before it is forcefully shut down SIGKILL by the system. Maximum 1800 seconds for PaaS projects and 86400 seconds for BYOC projects.
                      min
                      15
                      max
                      86400
                    • gradualRolloutStrategyId

                      (multiple options: oneOf)
                      The id of the strategy to be attached to service.
                      • The id of the strategy to be attached to service.
                    • ssh

                      {object}
                      Controls related to SSH access within the resource.
                      • enabled

                        boolean required
                        Enables SSH access if the resource matches an SSH identity selector.
                    • metadata

                      {object}
                      Allow setting custom labels and annotations for workloads.
                      • labels

                        {object}
                        Specify custom labels for the workload.
                        • annotations

                          {object}
                          Specify custom annotations for the workload as string or object.
                        • volumes

                          [array]
                          Per-replica persistent volumes for a statefulSet service. Each replica receives its own instance of every volume. Only valid when `deployment.type` is `statefulSet`.
                          • {object}
                            • id

                              string required
                              Slug identifying this volume within the service.
                              min length
                              3
                              max length
                              39
                              pattern
                              ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                            • mounts

                              [array] required
                              Array of mounts, containerMountPaths must be unique
                              • {object}
                                • volumeMountPath

                                  string
                                  Optionally specify the path inside this volume that should be mounted
                                  pattern
                                  ^((?!\.\.).)*$
                                • containerMountPath

                                  string required
                                  Specify the path into which the volume should be mounted
                                  pattern
                                  ^((?!:).)*$
                            • spec

                              {object} required
                              Per-replica volume storage schema
                        • containerSnapshot

                          {object}
                          • restoreFrom

                            string
                            The successful container snapshot to restore the service from.
                          • capture

                            {object}
                            • backupDestinationId

                              string
                              The backup destination for termination snapshots.
                            • onTermination

                              boolean
                              Creates a snapshot when a service container terminates, including crashes, rollouts, scale-downs, evictions, and manual restarts.
                            • retention

                              {object}
                              • maxSnapshots

                                integer
                                The maximum number of termination snapshots retained for the service.
                                min
                                1
                                max
                                100
                    • ports

                      [array]
                      • {object}
                        • name

                          string required
                          The name used to identify the port.
                          min length
                          1
                          max length
                          8
                          pattern
                          ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                        • internalPort

                          integer required
                          The port number.
                          min
                          1
                          max
                          65535
                        • public

                          boolean
                          If true, the port will be exposed publicly.
                        • vpcAccessible

                          boolean
                          If true, the port will be exposed on the cluster's private (VPC) load balancer.
                        • security

                          {object}
                          • credentials

                            [array]
                            An array of credentials to access the service.
                            • {object}
                              • username

                                string required
                                The username to access the service
                                min length
                                3
                                max length
                                39
                                pattern
                                ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                              • password

                                string required
                                The password to access the service with this username.
                              • type

                                string required
                                The type of authentication used
                                one of
                                basic-auth
                          • ip

                            [array]
                            An array of IP address policies.
                            • {object}
                              • addresses

                                [array] required
                                An array of IP addresses used for this rule
                                • string
                                  An IP address used by this rule
                              • action

                                string required
                                The action for this rule.
                                one of
                                ALLOW, DENY
                          • policies

                            [array]
                            An array of IP address policies.
                            • {object}
                              • addresses

                                [array] required
                                An array of IP addresses used for this rule
                                • string
                                  An IP address used by this rule
                              • action

                                string required
                                The action for this rule.
                                one of
                                ALLOW, DENY
                          • sso

                            {object}
                            Configure port authentication via SSO
                            • organizationId

                              string
                              ID of the SSO organization that the user will have to be a member of
                            • directoryGroupIds

                              [array]
                              Array of directory groups that will have access
                              • string
                            • allowAnyOrgUsers

                              boolean
                              Allow entire organization to access this service
                            • validateInternalTraffic

                              boolean
                              Enforce internal traffic through SSO authentication flow
                            • setCookieOnRootDomain

                              boolean
                              Set SSO authentication cookie on root domain
                            • noindexRedirect

                              boolean
                              Add an X-Robots-Tag: noindex response header to the SSO authentication redirect
                            • allowInternalTrafficViaPublicDns

                              boolean
                              Allow internal traffic from same or shared projects via public DNS to skip SSO authentication flow
                          • headers

                            [array]
                            List of header authentication settings, it checks the presence of all headers and compares it against the expected value. Wildcard (*) is supported.
                            • (multiple options: anyOf)
                              • {object}
                                Matches provided headers as strings.
                                • regexMode

                                  boolean
                                • name

                                  string required
                                  pattern
                                  ^[a-zA-Z0-9_\-%$+]+$
                                • value

                                  string required

                                OR

                              • {object}
                                Matches provided headers as regex.
                                • regexMode

                                  boolean
                                • name

                                  string required
                                • value

                                  string required
                          • verificationMode

                            string
                            Mode used to verify multiple security features like ip policies and SSO authentication
                            one of
                            or, and
                          • securePathConfiguration

                            {object}
                            • enabled

                              boolean
                              Enable security policies on a path-level style
                            • skipSecurityPoliciesForInternalTrafficViaPublicDns

                              boolean
                              Allow internal traffic from same or shared projects via public DNS to skip all security policies
                            • rules

                              [array]
                              • {object}
                                • paths

                                  [array] required
                                  Array of path objects which represent the paths and their priority for which the security policies will be enforced
                                  • (multiple options: oneOf)
                                    Data about how the path should be handled.
                                    • {object}
                                      Route when the path starts with the provided prefix.
                                      • path

                                        string required
                                        pattern
                                        ^\/([_a-zA-Z0-9-&?=.]*)((\/[_a-zA-Z0-9-&?=.]+)*(\/)?)?$
                                      • routingMode

                                        string required
                                        Mode of the path, determining how the URI will be interpreted.
                                        one of
                                        prefix
                                      • priority

                                        integer required
                                        min
                                        0
                                        max
                                        100

                                      OR

                                    • {object}
                                      Route when the path is an exact match.
                                      • path

                                        string required
                                        pattern
                                        ^\/([_a-zA-Z0-9-&?=.]*)((\/[_a-zA-Z0-9-&?=.]+)*(\/)?)?$
                                      • routingMode

                                        string required
                                        Mode of the path, determining how the URI will be interpreted.
                                        one of
                                        exact
                                      • priority

                                        integer required
                                        min
                                        0
                                        max
                                        100

                                      OR

                                    • {object}
                                      Route when the path matches the provided regex.
                                      • path

                                        string required
                                      • routingMode

                                        string required
                                        Mode of the path, determining how the URI will be interpreted.
                                        one of
                                        regex
                                      • priority

                                        integer required
                                        min
                                        0
                                        max
                                        100
                                • accessMode

                                  string required
                                  Specify the way the path rule will behave when processing policies. This enables an allow-list/deny-list approach for access control on each path
                                  one of
                                  protected, unprotected
                                • securityPolicies

                                  {object}
                                  • orPolicies

                                    {object}
                                    • credentials

                                      [array]
                                      An array of credentials to access the service.
                                      • {object}
                                        • username

                                          string required
                                          The username to access the service
                                          min length
                                          3
                                          max length
                                          39
                                          pattern
                                          ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                        • password

                                          string required
                                          The password to access the service with this username.
                                        • type

                                          string required
                                          The type of authentication used
                                          one of
                                          basic-auth
                                    • ip

                                      [array]
                                      An array of IP address policies.
                                      • {object}
                                        • addresses

                                          [array] required
                                          An array of IP addresses used for this rule
                                          • string
                                            An IP address used by this rule
                                        • action

                                          string required
                                          The action for this rule.
                                          one of
                                          ALLOW, DENY
                                    • policies

                                      [array]
                                      An array of IP address policies.
                                      • {object}
                                        • addresses

                                          [array] required
                                          An array of IP addresses used for this rule
                                          • string
                                            An IP address used by this rule
                                        • action

                                          string required
                                          The action for this rule.
                                          one of
                                          ALLOW, DENY
                                    • sso

                                      {object}
                                      Configure port authentication via SSO
                                      • organizationId

                                        string
                                        ID of the SSO organization that the user will have to be a member of
                                      • directoryGroupIds

                                        [array]
                                        Array of directory groups that will have access
                                        • string
                                      • allowAnyOrgUsers

                                        boolean
                                        Allow entire organization to access this service
                                      • validateInternalTraffic

                                        boolean
                                        Enforce internal traffic through SSO authentication flow
                                      • setCookieOnRootDomain

                                        boolean
                                        Set SSO authentication cookie on root domain
                                      • noindexRedirect

                                        boolean
                                        Add an X-Robots-Tag: noindex response header to the SSO authentication redirect
                                      • allowInternalTrafficViaPublicDns

                                        boolean
                                        Allow internal traffic from same or shared projects via public DNS to skip SSO authentication flow
                                    • headers

                                      [array]
                                      List of header authentication settings, it checks the presence of all headers and compares it against the expected value. Wildcard (*) is supported.
                                      • (multiple options: anyOf)
                                        • {object}
                                          Matches provided headers as strings.
                                          • regexMode

                                            boolean
                                          • name

                                            string required
                                            pattern
                                            ^[a-zA-Z0-9_\-%$+]+$
                                          • value

                                            string required

                                          OR

                                        • {object}
                                          Matches provided headers as regex.
                                          • regexMode

                                            boolean
                                          • name

                                            string required
                                          • value

                                            string required
                                  • requiredPolicies

                                    {object}
                                    • credentials

                                      [array]
                                      An array of credentials to access the service.
                                      • {object}
                                        • username

                                          string required
                                          The username to access the service
                                          min length
                                          3
                                          max length
                                          39
                                          pattern
                                          ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                        • password

                                          string required
                                          The password to access the service with this username.
                                        • type

                                          string required
                                          The type of authentication used
                                          one of
                                          basic-auth
                                    • ip

                                      [array]
                                      An array of IP address policies.
                                      • {object}
                                        • addresses

                                          [array] required
                                          An array of IP addresses used for this rule
                                          • string
                                            An IP address used by this rule
                                        • action

                                          string required
                                          The action for this rule.
                                          one of
                                          ALLOW, DENY
                                    • policies

                                      [array]
                                      An array of IP address policies.
                                      • {object}
                                        • addresses

                                          [array] required
                                          An array of IP addresses used for this rule
                                          • string
                                            An IP address used by this rule
                                        • action

                                          string required
                                          The action for this rule.
                                          one of
                                          ALLOW, DENY
                                    • sso

                                      {object}
                                      Configure port authentication via SSO
                                      • organizationId

                                        string
                                        ID of the SSO organization that the user will have to be a member of
                                      • directoryGroupIds

                                        [array]
                                        Array of directory groups that will have access
                                        • string
                                      • allowAnyOrgUsers

                                        boolean
                                        Allow entire organization to access this service
                                      • validateInternalTraffic

                                        boolean
                                        Enforce internal traffic through SSO authentication flow
                                      • setCookieOnRootDomain

                                        boolean
                                        Set SSO authentication cookie on root domain
                                      • noindexRedirect

                                        boolean
                                        Add an X-Robots-Tag: noindex response header to the SSO authentication redirect
                                      • allowInternalTrafficViaPublicDns

                                        boolean
                                        Allow internal traffic from same or shared projects via public DNS to skip SSO authentication flow
                                    • headers

                                      [array]
                                      List of header authentication settings, it checks the presence of all headers and compares it against the expected value. Wildcard (*) is supported.
                                      • (multiple options: anyOf)
                                        • {object}
                                          Matches provided headers as strings.
                                          • regexMode

                                            boolean
                                          • name

                                            string required
                                            pattern
                                            ^[a-zA-Z0-9_\-%$+]+$
                                          • value

                                            string required

                                          OR

                                        • {object}
                                          Matches provided headers as regex.
                                          • regexMode

                                            boolean
                                          • name

                                            string required
                                          • value

                                            string required
                        • domains

                          [array]
                          An array of domains to redirect to this port. Each domain must first be verified and registered to your account.
                          • string
                            A domain to redirect to this port.
                        • disableNfDomain

                          boolean
                          Disable routing on the default code.run domain for public HTTP ports with custom domains.
                        • advancedOptions

                          {object}
                          • enableTlsPassthrough

                            boolean
                            Whether this port should use pass through mode for TLS
                        • protocol

                          string required
                          The protocol to use for the port.
                          one of
                          HTTP, HTTP/2, TCP, UDP
                    • runtimeEnvironment

                      {object}
                      An object containing the runtime environment to set for the service
                      • runtimeFiles

                        {object}
                        Secret files as JSON object, encrypted at rest. File path must be absolute
                        • healthChecks

                          [array]
                          An array of health checks.
                          • {object}
                            A health check object.
                            • protocol

                              string required
                              The protocol to access the health check with.
                              one of
                              HTTP, CMD, TCP
                            • type

                              string required
                              The type of health check.
                              one of
                              livenessProbe, readinessProbe, startupProbe
                            • path

                              string
                              The path of the health check endpoint. Required when protocol is HTTP.
                              pattern
                              ^\/([a-zA-Z0-9-._]+\/)*[a-zA-Z0-9-._]*((\?([a-zA-Z0-9-._]+(=[a-zA-Z0-9-._]+)?)*)(&([a-zA-Z0-9-._]+(=[a-zA-Z0-9-._]+)?)*)*)?$
                            • cmd

                              string
                              The command to run for the health check. Required when protocol is CMD
                            • port

                              integer
                              Port number for the health check endpoint. Required when protocol is HTTP.
                              min
                              1
                            • initialDelaySeconds

                              integer required
                              Initial delay, in seconds, before the health check is first run.
                              min
                              1
                              max
                              1800
                            • periodSeconds

                              integer required
                              The time between each check, in seconds.
                              min
                              10
                              max
                              600
                            • timeoutSeconds

                              integer required
                              The time to wait for a response before marking the health check as a failure.
                              min
                              1
                              max
                              60
                            • failureThreshold

                              integer required
                              The maximum number of allowed failures.
                              min
                              1
                              max
                              255
                            • successThreshold

                              integer
                              The number of successes required to mark the health check as a success.
                              min
                              1
                              max
                              255
                        • loadBalancing

                          {object}
                          • mode

                            string required
                            one of
                            leastConnection, consistentHash, roundRobin, consistentReplicaRouting
                          • consistentHash

                            {object}
                            • mode

                              string required
                              one of
                              ip, customHeader
                            • header

                              string | null
                          • consistentReplicaRouting

                            {object}
                            • mode

                              string required
                              one of
                              path, header
                        • autoscaling

                          {object}
                          Describes all autoscaling configurations
                          • horizontal

                            {object}
                            Describes the horizontal autoscaling configuration
                            • enabled

                              boolean required
                              Whether horizontal autoscaling should be enabled
                            • minReplicas

                              number required
                              Minimum number of replicas which should be running at any time
                              min
                              1
                            • maxReplicas

                              number required
                              Maximum number of replicas which can be running at any time
                            • cpu

                              {object}
                              • enabled

                                boolean required
                                Whether autoscaling should take into account cpu usage
                              • thresholdPercentage

                                integer required
                                Threshold CPU usage percentage at which the workload will be scaled
                                min
                                10
                                max
                                100
                            • memory

                              {object}
                              • enabled

                                boolean required
                                Whether autoscaling should take into account memory usage
                              • thresholdPercentage

                                integer required
                                Threshold memory usage percentage at which the workload will be scaled
                                min
                                10
                                max
                                100
                            • rps

                              {object}
                              • enabled

                                boolean required
                                Whether autoscaling should take into requests-per-second
                              • thresholdValue

                                integer required
                                Threshold rps value on which the workload will be scaled
                                min
                                1
                            • userMetrics

                              {object}
                              • enabled

                                boolean required
                                Whether to enable handling for custom metrics in the autoscaling configuration
                              • exposedMetricsPath

                                string required
                                Path on which the metrics will be exposed by the service..
                                pattern
                                ^\/([_a-zA-Z0-9-&?=.]*)((\/[_a-zA-Z0-9-&?=.]+)*(\/)?)?$
                              • exposedMetricsPort

                                integer required
                                Port on which the metrics will be exposed by the service.
                              • metrics

                                [array] required
                                Array of custom metrics exposed by the service that will be used by the autoscaling configuration. At least one metric is required.
                                • {object}
                                  • metricName

                                    string required
                                    Name of the custom metric
                                    pattern
                                    [a-zA-Z_:][a-zA-Z0-9_:]*$
                                  • metricType

                                    string required
                                    Type of metric exposed, this will affect how it'll be queried by the autoscaler component: Gauge will be used as is, Counter will be used with rate()
                                    one of
                                    gauge, counter
                                  • thresholdValue

                                    number required
                                    Threshold value on which the workload will be scaled. Represents the average value across all running pods.
                        • createOptions

                          {object}
                          • volumesToAttach

                            [array]
                            • string
                              min length
                              3
                              max length
                              39
                              pattern
                              ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                          • expiryTime

                            integer
                            Number of seconds from creation after which the service should automatically expire. Once reached, the service is paused and scheduled for deletion. Must be between 300 (5 minutes) and 604800 (7 days).
                            min
                            300
                            max
                            604800

                      Response body

                      • {object}
                        Response object.
                        • data

                          {object} required
                          Result data.
                          • name

                            string required
                            The name of the service.
                            min length
                            3
                            max length
                            54
                            pattern
                            ^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
                          • description

                            string
                            A description of the service.
                            max length
                            200
                            pattern
                            ^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
                          • stageId

                            string
                            min length
                            3
                            max length
                            100
                            pattern
                            ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
                          • tags

                            [array]
                            An array of previously defined tags to help identify and group the resource.
                            • string
                              min length
                              3
                              max length
                              100
                              pattern
                              ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
                          • billing

                            {object} required
                            • deploymentPlan

                              string required
                              The ID of the deployment plan to use.
                              min length
                              3
                              max length
                              100
                              pattern
                              ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
                            • gpu

                              {object}
                              • enabled

                                boolean
                                Whether GPUs are enabled for this workload.
                              • configuration

                                {object}
                                • gpuType

                                  string required
                                  The type of GPU to use.
                                • gpuCount

                                  integer
                                  The number of GPUs to allocate.
                                • timesliced

                                  boolean
                                  Whether GPU timeslicing is enabled.
                          • infrastructure

                            {object}
                            • architecture

                              string
                              one of
                              x86, arm
                          • ports

                            [array]
                            • {object}
                              • name

                                string required
                                The name used to identify the port.
                                min length
                                1
                                max length
                                8
                                pattern
                                ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                              • internalPort

                                integer required
                                The port number.
                                min
                                1
                                max
                                65535
                              • public

                                boolean
                                If true, the port will be exposed publicly.
                              • vpcAccessible

                                boolean
                                If true, the port will be exposed on the cluster's private (VPC) load balancer.
                              • security

                                {object}
                                • credentials

                                  [array]
                                  An array of credentials to access the service.
                                  • {object}
                                    • username

                                      string required
                                      The username to access the service
                                      min length
                                      3
                                      max length
                                      39
                                      pattern
                                      ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                    • password

                                      string required
                                      The password to access the service with this username.
                                    • type

                                      string required
                                      The type of authentication used
                                      one of
                                      basic-auth
                                • ip

                                  [array]
                                  An array of IP address policies.
                                  • {object}
                                    • addresses

                                      [array] required
                                      An array of IP addresses used for this rule
                                      • string
                                        An IP address used by this rule
                                    • action

                                      string required
                                      The action for this rule.
                                      one of
                                      ALLOW, DENY
                                • policies

                                  [array]
                                  An array of IP address policies.
                                  • {object}
                                    • addresses

                                      [array] required
                                      An array of IP addresses used for this rule
                                      • string
                                        An IP address used by this rule
                                    • action

                                      string required
                                      The action for this rule.
                                      one of
                                      ALLOW, DENY
                                • sso

                                  {object}
                                  Configure port authentication via SSO
                                  • organizationId

                                    string
                                    ID of the SSO organization that the user will have to be a member of
                                  • directoryGroupIds

                                    [array]
                                    Array of directory groups that will have access
                                    • string
                                  • allowAnyOrgUsers

                                    boolean
                                    Allow entire organization to access this service
                                  • validateInternalTraffic

                                    boolean
                                    Enforce internal traffic through SSO authentication flow
                                  • setCookieOnRootDomain

                                    boolean
                                    Set SSO authentication cookie on root domain
                                  • noindexRedirect

                                    boolean
                                    Add an X-Robots-Tag: noindex response header to the SSO authentication redirect
                                  • allowInternalTrafficViaPublicDns

                                    boolean
                                    Allow internal traffic from same or shared projects via public DNS to skip SSO authentication flow
                                • headers

                                  [array]
                                  List of header authentication settings, it checks the presence of all headers and compares it against the expected value. Wildcard (*) is supported.
                                  • (multiple options: anyOf)
                                    • {object}
                                      Matches provided headers as strings.
                                      • regexMode

                                        boolean
                                      • name

                                        string required
                                        pattern
                                        ^[a-zA-Z0-9_\-%$+]+$
                                      • value

                                        string required

                                      OR

                                    • {object}
                                      Matches provided headers as regex.
                                      • regexMode

                                        boolean
                                      • name

                                        string required
                                      • value

                                        string required
                                • verificationMode

                                  string
                                  Mode used to verify multiple security features like ip policies and SSO authentication
                                  one of
                                  or, and
                                • securePathConfiguration

                                  {object}
                                  • enabled

                                    boolean
                                    Enable security policies on a path-level style
                                  • skipSecurityPoliciesForInternalTrafficViaPublicDns

                                    boolean
                                    Allow internal traffic from same or shared projects via public DNS to skip all security policies
                                  • rules

                                    [array]
                                    • {object}
                                      • paths

                                        [array] required
                                        Array of path objects which represent the paths and their priority for which the security policies will be enforced
                                        • (multiple options: oneOf)
                                          Data about how the path should be handled.
                                          • {object}
                                            Route when the path starts with the provided prefix.
                                            • path

                                              string required
                                              pattern
                                              ^\/([_a-zA-Z0-9-&?=.]*)((\/[_a-zA-Z0-9-&?=.]+)*(\/)?)?$
                                            • routingMode

                                              string required
                                              Mode of the path, determining how the URI will be interpreted.
                                              one of
                                              prefix
                                            • priority

                                              integer required
                                              min
                                              0
                                              max
                                              100

                                            OR

                                          • {object}
                                            Route when the path is an exact match.
                                            • path

                                              string required
                                              pattern
                                              ^\/([_a-zA-Z0-9-&?=.]*)((\/[_a-zA-Z0-9-&?=.]+)*(\/)?)?$
                                            • routingMode

                                              string required
                                              Mode of the path, determining how the URI will be interpreted.
                                              one of
                                              exact
                                            • priority

                                              integer required
                                              min
                                              0
                                              max
                                              100

                                            OR

                                          • {object}
                                            Route when the path matches the provided regex.
                                            • path

                                              string required
                                            • routingMode

                                              string required
                                              Mode of the path, determining how the URI will be interpreted.
                                              one of
                                              regex
                                            • priority

                                              integer required
                                              min
                                              0
                                              max
                                              100
                                      • accessMode

                                        string required
                                        Specify the way the path rule will behave when processing policies. This enables an allow-list/deny-list approach for access control on each path
                                        one of
                                        protected, unprotected
                                      • securityPolicies

                                        {object}
                                        • orPolicies

                                          {object}
                                          • credentials

                                            [array]
                                            An array of credentials to access the service.
                                            • {object}
                                              • username

                                                string required
                                                The username to access the service
                                                min length
                                                3
                                                max length
                                                39
                                                pattern
                                                ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                              • password

                                                string required
                                                The password to access the service with this username.
                                              • type

                                                string required
                                                The type of authentication used
                                                one of
                                                basic-auth
                                          • ip

                                            [array]
                                            An array of IP address policies.
                                            • {object}
                                              • addresses

                                                [array] required
                                                An array of IP addresses used for this rule
                                                • string
                                                  An IP address used by this rule
                                              • action

                                                string required
                                                The action for this rule.
                                                one of
                                                ALLOW, DENY
                                          • policies

                                            [array]
                                            An array of IP address policies.
                                            • {object}
                                              • addresses

                                                [array] required
                                                An array of IP addresses used for this rule
                                                • string
                                                  An IP address used by this rule
                                              • action

                                                string required
                                                The action for this rule.
                                                one of
                                                ALLOW, DENY
                                          • sso

                                            {object}
                                            Configure port authentication via SSO
                                            • organizationId

                                              string
                                              ID of the SSO organization that the user will have to be a member of
                                            • directoryGroupIds

                                              [array]
                                              Array of directory groups that will have access
                                              • string
                                            • allowAnyOrgUsers

                                              boolean
                                              Allow entire organization to access this service
                                            • validateInternalTraffic

                                              boolean
                                              Enforce internal traffic through SSO authentication flow
                                            • setCookieOnRootDomain

                                              boolean
                                              Set SSO authentication cookie on root domain
                                            • noindexRedirect

                                              boolean
                                              Add an X-Robots-Tag: noindex response header to the SSO authentication redirect
                                            • allowInternalTrafficViaPublicDns

                                              boolean
                                              Allow internal traffic from same or shared projects via public DNS to skip SSO authentication flow
                                          • headers

                                            [array]
                                            List of header authentication settings, it checks the presence of all headers and compares it against the expected value. Wildcard (*) is supported.
                                            • (multiple options: anyOf)
                                              • {object}
                                                Matches provided headers as strings.
                                                • regexMode

                                                  boolean
                                                • name

                                                  string required
                                                  pattern
                                                  ^[a-zA-Z0-9_\-%$+]+$
                                                • value

                                                  string required

                                                OR

                                              • {object}
                                                Matches provided headers as regex.
                                                • regexMode

                                                  boolean
                                                • name

                                                  string required
                                                • value

                                                  string required
                                        • requiredPolicies

                                          {object}
                                          • credentials

                                            [array]
                                            An array of credentials to access the service.
                                            • {object}
                                              • username

                                                string required
                                                The username to access the service
                                                min length
                                                3
                                                max length
                                                39
                                                pattern
                                                ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                              • password

                                                string required
                                                The password to access the service with this username.
                                              • type

                                                string required
                                                The type of authentication used
                                                one of
                                                basic-auth
                                          • ip

                                            [array]
                                            An array of IP address policies.
                                            • {object}
                                              • addresses

                                                [array] required
                                                An array of IP addresses used for this rule
                                                • string
                                                  An IP address used by this rule
                                              • action

                                                string required
                                                The action for this rule.
                                                one of
                                                ALLOW, DENY
                                          • policies

                                            [array]
                                            An array of IP address policies.
                                            • {object}
                                              • addresses

                                                [array] required
                                                An array of IP addresses used for this rule
                                                • string
                                                  An IP address used by this rule
                                              • action

                                                string required
                                                The action for this rule.
                                                one of
                                                ALLOW, DENY
                                          • sso

                                            {object}
                                            Configure port authentication via SSO
                                            • organizationId

                                              string
                                              ID of the SSO organization that the user will have to be a member of
                                            • directoryGroupIds

                                              [array]
                                              Array of directory groups that will have access
                                              • string
                                            • allowAnyOrgUsers

                                              boolean
                                              Allow entire organization to access this service
                                            • validateInternalTraffic

                                              boolean
                                              Enforce internal traffic through SSO authentication flow
                                            • setCookieOnRootDomain

                                              boolean
                                              Set SSO authentication cookie on root domain
                                            • noindexRedirect

                                              boolean
                                              Add an X-Robots-Tag: noindex response header to the SSO authentication redirect
                                            • allowInternalTrafficViaPublicDns

                                              boolean
                                              Allow internal traffic from same or shared projects via public DNS to skip SSO authentication flow
                                          • headers

                                            [array]
                                            List of header authentication settings, it checks the presence of all headers and compares it against the expected value. Wildcard (*) is supported.
                                            • (multiple options: anyOf)
                                              • {object}
                                                Matches provided headers as strings.
                                                • regexMode

                                                  boolean
                                                • name

                                                  string required
                                                  pattern
                                                  ^[a-zA-Z0-9_\-%$+]+$
                                                • value

                                                  string required

                                                OR

                                              • {object}
                                                Matches provided headers as regex.
                                                • regexMode

                                                  boolean
                                                • name

                                                  string required
                                                • value

                                                  string required
                              • domains

                                [array]
                                An array of domains to redirect to this port. Each domain must first be verified and registered to your account.
                                • string
                                  A domain to redirect to this port.
                              • disableNfDomain

                                boolean
                                Disable routing on the default code.run domain for public HTTP ports with custom domains.
                              • advancedOptions

                                {object}
                                • enableTlsPassthrough

                                  boolean
                                  Whether this port should use pass through mode for TLS
                              • protocol

                                (multiple options: oneOf) required
                                The protocol to use for the port.
                                • string
                                  one of
                                  HTTP, HTTP/2
                                • OR

                                • (multiple options: oneOf)
                                  • string
                                    one of
                                    HTTP, HTTP/2
                                  • OR

                                  • string
                                    one of
                                    HTTP, HTTP/2, TCP, UDP
                          • runtimeEnvironment

                            {object}
                            An object containing the runtime environment to set for the service
                            • runtimeFiles

                              {object}
                              Secret files as JSON object, encrypted at rest. File path must be absolute
                              • healthChecks

                                [array]
                                An array of health checks.
                                • {object}
                                  A health check object.
                                  • protocol

                                    string required
                                    The protocol to access the health check with.
                                    one of
                                    HTTP, CMD, TCP
                                  • type

                                    string required
                                    The type of health check.
                                    one of
                                    livenessProbe, readinessProbe, startupProbe
                                  • path

                                    string
                                    The path of the health check endpoint. Required when protocol is HTTP.
                                    pattern
                                    ^\/([a-zA-Z0-9-._]+\/)*[a-zA-Z0-9-._]*((\?([a-zA-Z0-9-._]+(=[a-zA-Z0-9-._]+)?)*)(&([a-zA-Z0-9-._]+(=[a-zA-Z0-9-._]+)?)*)*)?$
                                  • cmd

                                    string
                                    The command to run for the health check. Required when protocol is CMD
                                  • port

                                    integer
                                    Port number for the health check endpoint. Required when protocol is HTTP.
                                    min
                                    1
                                  • initialDelaySeconds

                                    integer required
                                    Initial delay, in seconds, before the health check is first run.
                                    min
                                    1
                                    max
                                    1800
                                  • periodSeconds

                                    integer required
                                    The time between each check, in seconds.
                                    min
                                    10
                                    max
                                    600
                                  • timeoutSeconds

                                    integer required
                                    The time to wait for a response before marking the health check as a failure.
                                    min
                                    1
                                    max
                                    60
                                  • failureThreshold

                                    integer required
                                    The maximum number of allowed failures.
                                    min
                                    1
                                    max
                                    255
                                  • successThreshold

                                    integer
                                    The number of successes required to mark the health check as a success.
                                    min
                                    1
                                    max
                                    255
                              • loadBalancing

                                {object}
                                • mode

                                  string required
                                  one of
                                  leastConnection, consistentHash, roundRobin, consistentReplicaRouting
                                • consistentHash

                                  {object}
                                  • mode

                                    string required
                                    one of
                                    ip, customHeader
                                  • header

                                    string | null
                                • consistentReplicaRouting

                                  {object}
                                  • mode

                                    string required
                                    one of
                                    path, header
                              • autoscaling

                                {object}
                                Describes all autoscaling configurations
                                • horizontal

                                  {object}
                                  Describes the horizontal autoscaling configuration
                                  • enabled

                                    boolean required
                                    Whether horizontal autoscaling should be enabled
                                  • minReplicas

                                    number required
                                    Minimum number of replicas which should be running at any time
                                    min
                                    1
                                  • maxReplicas

                                    number required
                                    Maximum number of replicas which can be running at any time
                                  • cpu

                                    {object}
                                    • enabled

                                      boolean required
                                      Whether autoscaling should take into account cpu usage
                                    • thresholdPercentage

                                      integer required
                                      Threshold CPU usage percentage at which the workload will be scaled
                                      min
                                      10
                                      max
                                      100
                                  • memory

                                    {object}
                                    • enabled

                                      boolean required
                                      Whether autoscaling should take into account memory usage
                                    • thresholdPercentage

                                      integer required
                                      Threshold memory usage percentage at which the workload will be scaled
                                      min
                                      10
                                      max
                                      100
                                  • rps

                                    {object}
                                    • enabled

                                      boolean required
                                      Whether autoscaling should take into requests-per-second
                                    • thresholdValue

                                      integer required
                                      Threshold rps value on which the workload will be scaled
                                      min
                                      1
                                  • userMetrics

                                    {object}
                                    • enabled

                                      boolean required
                                      Whether to enable handling for custom metrics in the autoscaling configuration
                                    • exposedMetricsPath

                                      string required
                                      Path on which the metrics will be exposed by the service..
                                      pattern
                                      ^\/([_a-zA-Z0-9-&?=.]*)((\/[_a-zA-Z0-9-&?=.]+)*(\/)?)?$
                                    • exposedMetricsPort

                                      integer required
                                      Port on which the metrics will be exposed by the service.
                                    • metrics

                                      [array] required
                                      Array of custom metrics exposed by the service that will be used by the autoscaling configuration. At least one metric is required.
                                      • {object}
                                        • metricName

                                          string required
                                          Name of the custom metric
                                          pattern
                                          [a-zA-Z_:][a-zA-Z0-9_:]*$
                                        • metricType

                                          string required
                                          Type of metric exposed, this will affect how it'll be queried by the autoscaler component: Gauge will be used as is, Counter will be used with rate()
                                          one of
                                          gauge, counter
                                        • thresholdValue

                                          number required
                                          Threshold value on which the workload will be scaled. Represents the average value across all running pods.
                              • createOptions

                                {object}
                                • volumesToAttach

                                  [array]
                                  • string
                                    min length
                                    3
                                    max length
                                    39
                                    pattern
                                    ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                • expiryTime

                                  integer
                                  Number of seconds from creation after which the service should automatically expire. Once reached, the service is paused and scheduled for deletion. Must be between 300 (5 minutes) and 604800 (7 days).
                                  min
                                  300
                                  max
                                  604800
                              • serviceType

                                string required
                                Type of the service (combined, build or deployment)
                                one of
                                deployment
                              • deployment

                                {object} required
                                • type

                                  string
                                  The way the service should be deployed. Either as a deployment (default), or as a stateful set.
                                  one of
                                  deployment, statefulSet
                                • instances

                                  integer required
                                  The number of instances to run the service on.
                                • buildpack

                                  {object}
                                  Allows for customization of buildpack runtime
                                  • configType

                                    string required
                                    Type of buildpack run configuration
                                    one of
                                    default, customProcess, customCommand, customEntrypointCustomCommand, originalEntrypointCustomCommand
                                  • customProcess

                                    string
                                    Custom process which should be run. Required in case where `configType` is `customProcess`
                                  • customEntrypoint

                                    string
                                    Custom entrypoint which should be run. Required in case where `configType` is `customEntrypointCustomCommand`
                                  • customCommand

                                    string
                                    Custom command which should be run. Required in case where `configType` is `customCommand`, `customEntrypointCustomCommand` or `originalEntrypointCustomCommand`
                                • docker

                                  {object}
                                  Allows for customization of docker runtime
                                  • configType

                                    string required
                                    Type of entrypoint & command override configuration
                                    one of
                                    default, customEntrypoint, customCommand, customEntrypointCustomCommand
                                  • customEntrypoint

                                    string
                                    Custom entrypoint which should be used. Required in case where `configType` is `customEntrypoint` or `customEntrypointCustomCommand`
                                  • customCommand

                                    string
                                    Custom command which should be used. Required in case where `configType` is `customCommand` or `customEntrypointCustomCommand`
                                • storage

                                  {object}
                                  • useHdbStorage

                                    boolean
                                  • usePdSsdStorage

                                    boolean
                                  • ephemeralStorage

                                    {object}
                                    • storageSize

                                      integer
                                      Ephemeral storage per container in MB
                                      min
                                      1024
                                  • shmSize

                                    integer
                                    Configures the amount of available memory-backed disk space available to /dev/shm
                                    min
                                    64
                                • strategy

                                  {object}
                                  Roll out strategy of the service
                                  • type

                                    string
                                    Configures the instance roll out strategy of your service. Currently only available via feature flag.
                                    one of
                                    rollout-steady, rollout-balanced, rollout-fast, custom, recreate
                                  • settings

                                    {object}
                                    • maxSurge

                                      (multiple options: oneOf) required
                                      Maximum number or percentage of pods that can be created above the desired count.
                                      • integer
                                        A non-negative integer.
                                      • OR

                                      • string
                                        A percentage string in the range 0% to 100%, e.g. `25%`
                                        pattern
                                        ^\d+%$
                                    • maxUnavailable

                                      (multiple options: anyOf) required
                                      Maximum number or percentage of pods that can be unavailable during the update.
                                      • integer
                                        A non-negative integer.
                                      • OR

                                      • string
                                        A percentage string in the range 0% to 100%, e.g. `25%`
                                        pattern
                                        ^\d+%$
                                • zonalRedundancy

                                  {object}
                                  • type

                                    string
                                    Defines scheduling behaviour across different zones within the same region.
                                    one of
                                    disabled, preferred, required
                                  • minZones

                                    integer
                                    Defines how many zones are required and will prevent containers from additional scheduling into existing zones. (Only relevant if type is set to "required")
                                    min
                                    1
                                • gpu

                                  {object}
                                  • enabled

                                    boolean
                                    Whether GPUs are enabled for this workload.
                                  • configuration

                                    {object}
                                    • gpuType

                                      string required
                                      The type of GPU to use.
                                    • gpuCount

                                      integer
                                      The number of GPUs to allocate.
                                    • timesliced

                                      boolean
                                      Whether GPU timeslicing is enabled.
                                • gracePeriodSeconds

                                  integer
                                  The maximum amount of time the process has to shut down after receiving a SIGTERM signal before it is forcefully shut down SIGKILL by the system. Maximum 1800 seconds for PaaS projects and 86400 seconds for BYOC projects.
                                  min
                                  15
                                  max
                                  86400
                                • gradualRolloutStrategyId

                                  (multiple options: oneOf)
                                  The id of the strategy to be attached to service.
                                  • The id of the strategy to be attached to service.
                                • ssh

                                  {object}
                                  Controls related to SSH access within the resource.
                                  • enabled

                                    boolean required
                                    Enables SSH access if the resource matches an SSH identity selector.
                                • metadata

                                  {object}
                                  Allow setting custom labels and annotations for workloads.
                                  • labels

                                    {object}
                                    Specify custom labels for the workload.
                                    • annotations

                                      {object}
                                      Specify custom annotations for the workload as string or object.
                                    • volumes

                                      [array]
                                      Per-replica persistent volumes for a statefulSet service. Each replica receives its own instance of every volume. Only valid when `deployment.type` is `statefulSet`.
                                      • {object}
                                        • id

                                          string required
                                          Slug identifying this volume within the service.
                                          min length
                                          3
                                          max length
                                          39
                                          pattern
                                          ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                        • mounts

                                          [array] required
                                          Array of mounts, containerMountPaths must be unique
                                          • {object}
                                            • volumeMountPath

                                              string
                                              Optionally specify the path inside this volume that should be mounted
                                              pattern
                                              ^((?!\.\.).)*$
                                            • containerMountPath

                                              string required
                                              Specify the path into which the volume should be mounted
                                              pattern
                                              ^((?!:).)*$
                                        • spec

                                          {object} required
                                          Per-replica volume storage schema
                                    • containerSnapshot

                                      {object}
                                      • restoreFrom

                                        string
                                        The successful container snapshot to restore the service from.
                                      • capture

                                        {object}
                                        • backupDestinationId

                                          string
                                          The backup destination for termination snapshots.
                                        • onTermination

                                          boolean
                                          Creates a snapshot when a service container terminates, including crashes, rollouts, scale-downs, evictions, and manual restarts.
                                        • retention

                                          {object}
                                          • maxSnapshots

                                            integer
                                            The maximum number of termination snapshots retained for the service.
                                            min
                                            1
                                            max
                                            100
                                    • internal

                                      {object}
                                      • id

                                        (multiple options: anyOf)
                                        ID of the build service to deploy
                                        • string
                                          The ID of a build service in the same project
                                          min length
                                          3
                                          max length
                                          54
                                          pattern
                                          ^[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
                                        • OR

                                        • string
                                          The ID of a build service in another project, in the format `project-id/build-service-id`
                                      • branch

                                        string
                                        Branch to deploy
                                      • buildSHA

                                        (multiple options: oneOf)
                                        Commit SHA to deploy, or 'latest' to deploy the most recent commit
                                        • string
                                          A commit sha.
                                          min length
                                          40
                                          max length
                                          40
                                        • OR

                                        • string
                                          Latest commit.
                                          one of
                                          latest
                                      • buildId

                                        string
                                        ID of the build that should be deployed
                                    • external

                                      {object}
                                      • imagePath

                                        string required
                                        Image to be deployed. When not deploying from Dockerhub the URL must be specified.
                                        pattern
                                        ^(?:(?:https?:\/\/)?([a-zA-Z0-9-]+\.[a-zA-Z0-9.\-]+))?(?:\/)?([a-zA-Z/-9.\-_]+)(?::([a-zA-Z/-9.\-_:]+)|@([a-zA-Z/-9.\-_:]+))$
                                      • credentials

                                        string
                                        ID of the saved credentials to use to access this external image.
                                        pattern
                                        ^[A-Za-z0-9-]+$
                                    • image

                                      {object}
                                      • projectId

                                        string
                                        min length
                                        24
                                        max length
                                        24
                                      • name

                                        string required
                                        min length
                                        1
                                      • group

                                        string
                                        min length
                                        1
                                      • tag

                                        string required
                                        min length
                                        1
                                    • imageUrl

                                      string
                                      Image registry url of the deployed image.
                                  • id

                                    string required
                                    Identifier for the service
                                  • appId

                                    string required
                                    Full identifier used for service deployment
                                  • cluster

                                    {object} required
                                    Cluster information
                                    • id

                                      string required
                                      The id of the cluster associated with this project.
                                    • name

                                      string required
                                      The name of the cluster associated with this project.
                                    • namespace

                                      string
                                      Namespace this resource is located within on the cluster.
                                    • loadBalancers

                                      [array]
                                      Load balancer DNS for the cluster.
                                      • string
                                  • createdAt

                                    string
                                    time of creation
                                  • updatedAt

                                    string
                                    time of update
                                  • expiryTime

                                    string
                                    Absolute time at which the service is scheduled to automatically expire. Resolved from createOptions.expiryTime on creation; cleared once the service has expired.
                                  • expiredAt

                                    string
                                    Time at which the service expired and was paused.
                                  • scheduledDeletion

                                    string
                                    Time at which the expired service is scheduled for deletion.
                                  • status

                                    {object} required
                                    Details about the current service status.
                                    • deployment

                                      {object} required
                                      Details about the current deployment status.
                                      • status

                                        string required
                                        The current status of the deployment.
                                        one of
                                        PENDING, IN_PROGRESS, COMPLETED, FAILED
                                      • reason

                                        string required
                                        The reason the current deployment was started.
                                        one of
                                        SCALING, DEPLOYING
                                      • lastTransitionTime

                                        string
                                        The timestamp of when the deployment reached this status.

                              PUT /v1/projects/{projectId}/services/deployment

                              PUT /v1/teams/{teamId}/projects/{projectId}/services/deployment

                              Example request

                              Request body
                              curl --header "Content-Type: application/json" \
                                --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
                                --request PUT \
                                --data '{"name":"Example Service","description":"A service description","billing":{"deploymentPlan":"nf-compute-20"},"deployment":{"instances":1,"docker":{"configType":"default"},"storage":{"ephemeralStorage":{"storageSize":1024}},"gradualRolloutStrategyId":"strategy-id","internal":{"id":"example-build-service","branch":"master","buildSHA":"latest","buildId":"premium-guide-6393"}},"ports":[{"name":"p01","internalPort":8080,"public":true,"vpcAccessible":false,"security":{"credentials":[{"username":"admin","password":"password123","type":"basic-auth"}],"ip":[{"addresses":["127.0.0.1"],"action":"DENY"}],"policies":[{"addresses":["127.0.0.1"],"action":"DENY"}],"headers":[{"regexMode":false,"name":"headerName","value":"headerValue"}],"securePathConfiguration":{"rules":[{"paths":[{"routingMode":"prefix","priority":80,"path":"/path"}],"accessMode":"protected","securityPolicies":{"orPolicies":{"credentials":[{"username":"admin","password":"password123","type":"basic-auth"}],"ip":[{"addresses":["127.0.0.1"],"action":"DENY"}],"policies":[{"addresses":["127.0.0.1"],"action":"DENY"}],"headers":[{"regexMode":false,"name":"headerName","value":"headerValue"}]},"requiredPolicies":{"credentials":[{"username":"admin","password":"password123","type":"basic-auth"}],"ip":[{"addresses":["127.0.0.1"],"action":"DENY"}],"policies":[{"addresses":["127.0.0.1"],"action":"DENY"}],"headers":[{"regexMode":false,"name":"headerName","value":"headerValue"}]}}}]}},"domains":["app.example.com"],"protocol":"HTTP"}],"runtimeEnvironment":{"VARIABLE_1":"abcdef","VARIABLE_2":"12345"},"runtimeFiles":{"/dir/fileName":{"data":"VGhpcyBpcyBhbiBleGFtcGxlIHdpdGggYSB0ZW1wbGF0ZWQgJHtOT0RFX0VOVn0gdmFyaWFibGU=","encoding":"utf-8"}},"healthChecks":[{"protocol":"HTTP","type":"readinessProbe","path":"/health-check","port":8080,"initialDelaySeconds":10,"periodSeconds":60,"timeoutSeconds":1,"failureThreshold":3,"successThreshold":1}],"autoscaling":{"horizontal":{"enabled":true,"minReplicas":1,"maxReplicas":3,"userMetrics":{"enabled":true,"exposedMetricsPath":"/metrics","exposedMetricsPort":8080,"metrics":[{"metricName":"example-metric","metricType":"gauge","thresholdValue":2}]}}},"createOptions":{"expiryTime":86400}}' \
                                https://api.northflank.com/v1/projects/{projectId}/services/deployment

                              Example response

                              200 OK

                              Details about the created or updated service.

                              JSON

                              {
                                "data": {
                                  "name": "Example Service",
                                  "description": "A service description",
                                  "billing": {
                                    "deploymentPlan": "nf-compute-20"
                                  },
                                  "ports": [
                                    {
                                      "name": "p01",
                                      "internalPort": 8080,
                                      "public": true,
                                      "vpcAccessible": false,
                                      "security": {
                                        "credentials": [
                                          {
                                            "username": "admin",
                                            "password": "password123",
                                            "type": "basic-auth"
                                          }
                                        ],
                                        "ip": [
                                          {
                                            "addresses": [
                                              "127.0.0.1"
                                            ],
                                            "action": "DENY"
                                          }
                                        ],
                                        "policies": [
                                          {
                                            "addresses": [
                                              "127.0.0.1"
                                            ],
                                            "action": "DENY"
                                          }
                                        ],
                                        "headers": [
                                          {
                                            "regexMode": false,
                                            "name": "headerName",
                                            "value": "headerValue"
                                          }
                                        ],
                                        "securePathConfiguration": {
                                          "rules": [
                                            {
                                              "paths": [
                                                {
                                                  "routingMode": "prefix",
                                                  "priority": 80
                                                }
                                              ],
                                              "accessMode": "protected",
                                              "securityPolicies": {
                                                "orPolicies": {
                                                  "credentials": [
                                                    {
                                                      "username": "admin",
                                                      "password": "password123",
                                                      "type": "basic-auth"
                                                    }
                                                  ],
                                                  "ip": [
                                                    {
                                                      "addresses": [
                                                        "127.0.0.1"
                                                      ],
                                                      "action": "DENY"
                                                    }
                                                  ],
                                                  "policies": [
                                                    {
                                                      "addresses": [
                                                        "127.0.0.1"
                                                      ],
                                                      "action": "DENY"
                                                    }
                                                  ],
                                                  "headers": [
                                                    {
                                                      "regexMode": false,
                                                      "name": "headerName",
                                                      "value": "headerValue"
                                                    }
                                                  ]
                                                },
                                                "requiredPolicies": {
                                                  "credentials": [
                                                    {
                                                      "username": "admin",
                                                      "password": "password123",
                                                      "type": "basic-auth"
                                                    }
                                                  ],
                                                  "ip": [
                                                    {
                                                      "addresses": [
                                                        "127.0.0.1"
                                                      ],
                                                      "action": "DENY"
                                                    }
                                                  ],
                                                  "policies": [
                                                    {
                                                      "addresses": [
                                                        "127.0.0.1"
                                                      ],
                                                      "action": "DENY"
                                                    }
                                                  ],
                                                  "headers": [
                                                    {
                                                      "regexMode": false,
                                                      "name": "headerName",
                                                      "value": "headerValue"
                                                    }
                                                  ]
                                                }
                                              }
                                            }
                                          ]
                                        }
                                      },
                                      "domains": [
                                        "app.example.com"
                                      ]
                                    }
                                  ],
                                  "runtimeEnvironment": {
                                    "VARIABLE_1": "abcdef",
                                    "VARIABLE_2": "12345"
                                  },
                                  "runtimeFiles": {
                                    "/dir/fileName": {
                                      "data": "VGhpcyBpcyBhbiBleGFtcGxlIHdpdGggYSB0ZW1wbGF0ZWQgJHtOT0RFX0VOVn0gdmFyaWFibGU=",
                                      "encoding": "utf-8"
                                    }
                                  },
                                  "healthChecks": [
                                    {
                                      "protocol": "HTTP",
                                      "type": "readinessProbe",
                                      "path": "/health-check",
                                      "port": 8080,
                                      "initialDelaySeconds": 10,
                                      "periodSeconds": 60,
                                      "timeoutSeconds": 1,
                                      "failureThreshold": 3,
                                      "successThreshold": 1
                                    }
                                  ],
                                  "autoscaling": {
                                    "horizontal": {
                                      "enabled": true,
                                      "minReplicas": 1,
                                      "maxReplicas": 3,
                                      "userMetrics": {
                                        "enabled": true,
                                        "exposedMetricsPath": "/metrics",
                                        "exposedMetricsPort": 8080,
                                        "metrics": [
                                          {
                                            "metricName": "example-metric",
                                            "metricType": "gauge",
                                            "thresholdValue": 2
                                          }
                                        ]
                                      }
                                    }
                                  },
                                  "createOptions": {
                                    "expiryTime": 86400
                                  },
                                  "serviceType": "deployment",
                                  "deployment": {
                                    "instances": 1,
                                    "docker": {
                                      "configType": "default"
                                    },
                                    "storage": {
                                      "ephemeralStorage": {
                                        "storageSize": 1024
                                      }
                                    },
                                    "gradualRolloutStrategyId": "strategy-id",
                                    "volumes": [
                                      {
                                        "id": "data",
                                        "mounts": [
                                          {
                                            "volumeMountPath": "",
                                            "containerMountPath": "/container"
                                          }
                                        ],
                                        "spec": {
                                          "storageClassName": "nvme",
                                          "storageSize": 6144
                                        }
                                      }
                                    ],
                                    "internal": {
                                      "id": "example-build-service",
                                      "branch": "master",
                                      "buildId": "premium-guide-6393"
                                    },
                                    "external": {
                                      "imagePath": "nginx:latest",
                                      "credentials": "example-credentials"
                                    }
                                  },
                                  "id": "example-service",
                                  "appId": "/example-user/default-project/example-service",
                                  "cluster": {
                                    "id": "nf-europe-west",
                                    "name": "nf-europe-west",
                                    "namespace": "ns-8zy2mcjh9zn2",
                                    "loadBalancers": [
                                      "lb.659200800000000000000000.northflank.com"
                                    ]
                                  },
                                  "expiryTime": "2024-01-01T00:00:00.000Z",
                                  "expiredAt": "2024-01-01T00:00:00.000Z",
                                  "scheduledDeletion": "2024-01-31T00:00:00.000Z",
                                  "status": {
                                    "deployment": {
                                      "status": "COMPLETED",
                                      "reason": "DEPLOYING",
                                      "lastTransitionTime": "2021-11-29T11:47:16.624Z"
                                    }
                                  }
                                }
                              }

                              © 2026 Northflank Ltd. All rights reserved.

                              northflank.com / Terms / Privacy / feedback@northflank.com