Skip to main content

Kubernetes

Type ID: kubernetes  ·  Kind: Action  ·  Ports: 1 in, 1 out

List namespaces and resources in a Kubernetes cluster (read-only).

Credentials​

Kubernetes (Service Account Token)

{
"credentials": {
"name": "kubernetes_token",
"id": "<credential-id>"
}
}

Resources & operations​

  • Cluster (cluster)
    • List Namespaces (listNamespaces) - List the namespaces in the cluster
  • Resource (resource)
    • List (list) - List resources of any kind, in one namespace, across all namespaces, or cluster-wide

Properties​

Common​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ResourceresourceoptionsYesclusterCluster (cluster), Resource (resource)-
OperationoperationoptionsYeslistNamespacesList Namespaces (listNamespaces)resource = cluster
OperationoperationoptionsYeslistList (list)resource = resource

Cluster → List Namespaces​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Label SelectorlabelSelectorstringNo''e.g. environment=production,tier=frontendresource = cluster, operation = listNamespaces
Field SelectorfieldSelectorstringNo''e.g. status.phase=Activeresource = cluster, operation = listNamespaces
Return AllreturnAllbooleanNofalseFetch all pages automaticallyresource = cluster, operation = listNamespaces
LimitlimitnumberNo100Max items per pageresource = cluster, operation = listNamespaces, returnAll = false
Max ItemsmaxItemsnumberNo1000Max total items to fetch across all pagesresource = cluster, operation = listNamespaces, returnAll = true
Continue TokencontinueTokenstringNo''Token for the next page of resultsresource = cluster, operation = listNamespaces, returnAll = false
Output FormatoutputFormatoptionsNofullFull (full), Table (table)resource = cluster, operation = listNamespaces

Resource → List​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
API VersionapiVersionstringYesv1v1 for core resources (pods, services, configmaps...), or group/version, e.g. apps/v1, batch/v1, networking.k8s.io/v1resource = resource, operation = list
Resource TyperesourceTypestringYespodsPlural, lowercase resource name as used in the API path, e.g. pods, deployments, nodes, ingressesresource = resource, operation = list
NamespacenamespacestringNo''Leave empty to list across all namespaces (or for cluster-scoped types like nodes)resource = resource, operation = list
Label SelectorlabelSelectorstringNo''e.g. environment=production,tier=frontendresource = resource, operation = list
Field SelectorfieldSelectorstringNo''e.g. status.phase=Runningresource = resource, operation = list
Return AllreturnAllbooleanNofalseFetch all pages automaticallyresource = resource, operation = list
LimitlimitnumberNo100Max items per pageresource = resource, operation = list, returnAll = false
Max ItemsmaxItemsnumberNo1000Max total items to fetch across all pagesresource = resource, operation = list, returnAll = true
Continue TokencontinueTokenstringNo''Token for the next page of resultsresource = resource, operation = list, returnAll = false
Output FormatoutputFormatoptionsNofullFull (full), Table (table)resource = resource, operation = list

Notes​

  • Output Format: full returns the raw Kubernetes API response. table returns a simplified array of objects with common fields extracted.