Skip to main content
API Explorer|API Explorer
Monitoring & Collection/Zaku
POSTZakuSince 1.0SynchronousAuth Required

NormalizePod

Normalize a single raw pod spec into a canonical ZCF representation

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

Body Fields

  • nameStringRequired

    Name of the pod

    Example: nginx-deployment-abc123

  • namespaceStringRequired

    Kubernetes namespace of the pod

    Example: default

  • labelsLinkedHashMapRequired

    Key-value labels attached to this resource

    Example: (nested object)

  • annotationsLinkedHashMapRequired

    Arbitrary key-value annotations for metadata

    Example: (nested object)

  • containerCountIntegerRequired

    Number of containers in the pod

    Example: 2

Responses

200 OK

On success, this API returns the following response structure.

  • nameString

    Normalized name of the pod

    Example: nginx-deployment-abc123

  • namespaceString

    Kubernetes namespace of the pod

    Example: default

  • labelsLinkedHashMap

    Key-value labels attached to this resource

    Example: (nested object)

  • annotationsLinkedHashMap

    Arbitrary key-value annotations for metadata

    Example: (nested object)

  • containerCountInteger

    Number of containers after normalization

    Example: 2

  • nodeNameString

    Name of the node the pod is scheduled on

    Example: k8s-node-01

  • statusString

    Current phase of the pod lifecycle

    Example: Running

  • truncatedBoolean

    Whether any fields were truncated during normalization

    Example: false

  • warningsList

    List of normalization warning messages

    Example: item1,item2

Endpoint

POST/api/v1/zaku/normalize/pod

/api/v1/zaku/normalize/pod

Operation ID

NormalizePod

Permalink

Request Example

curl -X POST '{host}/api/v1/zaku/normalize/pod' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"nginx-deployment-abc123","namespace":"default","labels":"(nested object)","annotations":"(nested object)","containerCount":2,"nodeName":"k8s-node-01","status":"Running"}'

Response Example

200
{
  "name": "nginx-deployment-abc123",
  "namespace": "default",
  "labels": null,
  "annotations": null,
  "containerCount": 2,
  "nodeName": "k8s-node-01",
  "status": "Running",
  "truncated": false
}

Change History

This API has no change history records yet.

View all change history