Update a pod mutation.

patch

https://api.cast.ai/patching-engine/v1beta/organizations/{organizationId}/clusters/{clusterId}/pod-mutations/{id}

Updates a pod mutation.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

organizationId

string

required

The organization ID.

clusterId

string

required

The cluster ID.

string

required

The ID of the pod mutation.

Body Params

PodMutation represents a mutation that can be applied to pods in a cluster.

name

string

The name of the pod mutation.

enabled

boolean

Indicates whether the pod mutation is enabled.

objectFilter

object

deprecated

ObjectFilter represents a filter for Kubernetes objects.

objectFilterV2

object

ObjectFilterV2 represents an advanced filter for Kubernetes objects with support for exact and regex matching.

labels

object

Labels to add to the pods.

annotations

object

Annotations to add to the pods.

nodeSelector

object

PatchOptions represents a set of key-value pairs to add or remove.

tolerations

array of objects

Tolerations to apply to the pods.

tolerations

affinity

object

Affinity represents the affinity settings for the pod mutation.

spotType

string

enum

The type of spot instance to use.

Allowed:

nodeTemplatesToConsolidate

array of strings

Node template names to consolidate

nodeTemplatesToConsolidate

restartMatchingWorkloads

boolean

Restart matching workloads when the pod mutation is applied.

spotDistributionPercentage

int32

The percentage of pods (0-100) that receive spot scheduling constraints. The specific spot scheduling constraints depend on the selected SpotType. At least the remaining percentage will be scheduled on on-demand instances. This field applies only if SpotType is specified.

patch

array of objects

Optional patching field that allows mutation of pod definitions using the standard JSON patch mechanism. All preceding mutations have a priority, and the patch is applied at the end. Setting this field does not guarantee that it won't override mutations set in previous fields. For example, if a label is added via the labels field and then removed by the patch, the label will be removed. For more detailed explanation read JSON patching section in kubernetes documentation: https://kubernetes.io/docs/reference/kubectl/generated/kubectl_patch/

patch

distributionGroups

array of objects

Distribution groups allow percentage-based distribution of configurations across pods. Each group defines a percentage of pods that should receive specific configurations. This enables scenarios like "70% of pods get label A, 30% get label B" or "20% consolidate to node template A, 80% to template B".

Validation rules (enforced by service logic):

Sum of all distribution group percentages must not exceed 100
Distribution group names must be unique within this pod mutation

distributionGroups

podEviction

object

PodEviction defines eviction settings for enforcement of pod mutations.

Responses

200OK

defaultDefault error response