Mode is the configuration for how to expose metadata to
workloads running on the node.
NodeMetadata
NodeMetadata(value)
NodeMetadata is the configuration for if and how to expose
the node metadata to the workload running on the node.
Metadata concealment is a temporary security
solution available while the bootstrapping
process for cluster nodes is being redesigned
with significant security improvements. This
feature is scheduled to be deprecated in the
future and later removed.
EXPOSE (2):
Expose all VM metadata to pods.
GKE_METADATA_SERVER (3):
Run the GKE Metadata Server on this node. The
GKE Metadata Server exposes a metadata API to
workloads that is compatible with the V1 Compute
Metadata APIs exposed by the Compute Engine and
App Engine Metadata Servers. This feature can
only be enabled if Workload Identity is enabled
at the cluster level.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Class WorkloadMetadataConfig (2.59.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.59.0 (latest)](/python/docs/reference/container/latest/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.58.0](/python/docs/reference/container/2.58.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.57.0](/python/docs/reference/container/2.57.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.56.1](/python/docs/reference/container/2.56.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.55.1](/python/docs/reference/container/2.55.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.54.0](/python/docs/reference/container/2.54.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.53.0](/python/docs/reference/container/2.53.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.52.0](/python/docs/reference/container/2.52.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.50.0](/python/docs/reference/container/2.50.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.49.0](/python/docs/reference/container/2.49.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.48.0](/python/docs/reference/container/2.48.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.47.1](/python/docs/reference/container/2.47.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.46.0](/python/docs/reference/container/2.46.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.45.0](/python/docs/reference/container/2.45.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.44.0](/python/docs/reference/container/2.44.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.43.0](/python/docs/reference/container/2.43.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.42.0](/python/docs/reference/container/2.42.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.41.0](/python/docs/reference/container/2.41.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.40.0](/python/docs/reference/container/2.40.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.39.0](/python/docs/reference/container/2.39.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.38.0](/python/docs/reference/container/2.38.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.37.0](/python/docs/reference/container/2.37.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.36.0](/python/docs/reference/container/2.36.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.35.0](/python/docs/reference/container/2.35.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.34.0](/python/docs/reference/container/2.34.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.33.0](/python/docs/reference/container/2.33.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.32.0](/python/docs/reference/container/2.32.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.31.0](/python/docs/reference/container/2.31.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.30.0](/python/docs/reference/container/2.30.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.29.0](/python/docs/reference/container/2.29.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.28.0](/python/docs/reference/container/2.28.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.27.0](/python/docs/reference/container/2.27.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.26.0](/python/docs/reference/container/2.26.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.25.0](/python/docs/reference/container/2.25.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.24.0](/python/docs/reference/container/2.24.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.23.0](/python/docs/reference/container/2.23.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.22.0](/python/docs/reference/container/2.22.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.21.0](/python/docs/reference/container/2.21.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.20.0](/python/docs/reference/container/2.20.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.19.0](/python/docs/reference/container/2.19.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.18.0](/python/docs/reference/container/2.18.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.17.4](/python/docs/reference/container/2.17.4/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.16.0](/python/docs/reference/container/2.16.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.15.0](/python/docs/reference/container/2.15.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.14.0](/python/docs/reference/container/2.14.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.13.0](/python/docs/reference/container/2.13.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.12.2](/python/docs/reference/container/2.12.2/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.11.2](/python/docs/reference/container/2.11.2/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.10.8](/python/docs/reference/container/2.10.8/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.9.0](/python/docs/reference/container/2.9.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.8.1](/python/docs/reference/container/2.8.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.7.1](/python/docs/reference/container/2.7.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.6.1](/python/docs/reference/container/2.6.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.5.0](/python/docs/reference/container/2.5.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.4.1](/python/docs/reference/container/2.4.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.3.1](/python/docs/reference/container/2.3.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.2.0](/python/docs/reference/container/2.2.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.1.0](/python/docs/reference/container/2.1.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [2.0.1](/python/docs/reference/container/2.0.1/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [1.0.3](/python/docs/reference/container/1.0.3/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [0.5.0](/python/docs/reference/container/0.5.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [0.4.0](/python/docs/reference/container/0.4.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig)\n- [0.3.0](/python/docs/reference/container/0.3.0/google.cloud.container_v1beta1.types.WorkloadMetadataConfig) \n\n WorkloadMetadataConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nWorkloadMetadataConfig defines the metadata configuration to\nexpose to workloads on the node pool.\n\nClasses\n-------\n\n### Mode\n\n Mode(value)\n\nMode is the configuration for how to expose metadata to\nworkloads running on the node.\n\n### NodeMetadata\n\n NodeMetadata(value)\n\nNodeMetadata is the configuration for if and how to expose\nthe node metadata to the workload running on the node. \n\n Metadata concealment is a temporary security\n solution available while the bootstrapping\n process for cluster nodes is being redesigned\n with significant security improvements. This\n feature is scheduled to be deprecated in the\n future and later removed.\n EXPOSE (2):\n Expose all VM metadata to pods.\n GKE_METADATA_SERVER (3):\n Run the GKE Metadata Server on this node. The\n GKE Metadata Server exposes a metadata API to\n workloads that is compatible with the V1 Compute\n Metadata APIs exposed by the Compute Engine and\n App Engine Metadata Servers. This feature can\n only be enabled if Workload Identity is enabled\n at the cluster level."]]