Skip to main content
ZStack
Monitoring & Collection/Zaku

BatchNormalize

Batch normalize multiple pod specs in a single request

POST/api/v1/zaku/normalize/batch

Operation ID

BatchNormalize

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • pods
    ListRequired

    The pods value

    Example: (nested array)

    • name
      String

      Name of the pod

      Example: nginx-deployment-abc123

    • namespace
      String

      Kubernetes namespace of the pod

      Example: default

    • labels
      LinkedHashMap

      Key-value labels attached to this resource

      Example: (nested object)

    • annotations
      LinkedHashMap

      Arbitrary key-value annotations for metadata

      Example: (nested object)

    • containerCount
      Integer

      Number of containers in the pod

      Example: 2

    • nodeName
      String

      Name of the node the pod is scheduled on

      Example: k8s-node-01

    • status
      String

      Current phase of the pod lifecycle

      Example: Running

  • opts
    ObjectRequired

    The opts value

    • batchSize
      Integer

      Number of pods to process per batch

      Example: 100

    • maxErrors
      Integer

      Maximum number of errors before aborting the batch

      Example: 10

    • strictMode
      Boolean

      If true, abort on first validation error; if false, skip and continue

      Example: false

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • successful
    Integer

    Number of pods successfully normalized

    Example: 95

  • failed
    Integer

    Number of pods that failed normalization

    Example: 3

  • skipped
    Integer

    Number of pods skipped due to filter rules

    Example: 2

  • errors
    List

    Errors for this resource

    Example: (nested array)

    • podName
      String

      Name of the pod that caused the error

      Example: bad-pod-001

    • error
      String

      Error message describing the normalization failure

      Example: label value exceeds max length of 63

  • durationMs
    String

    Total time taken for the batch in milliseconds

    Example: 1250