copyright: years: 2025, 2025 lastupdated: "2025-07-14"
keywords: , nhc009, IAM token exchange failed
subcollection: openshift
content-type: troubleshoot
Why does the Network status show an NHC009
error?
Virtual Private Cloud
When you check the status of your cluster's network components by running the ibmcloud ocks cluster health issues --cluster <CLUSTER_ID>
, you see an error similar to the following example.
ID Component Severity Description
NHC009 Network Error The IAM token exchange request failed.
VPC operations rely on IAM API keys for authentication. If the used API key is invalid, expired, or disabled, that can lead to this error.
Review and update your IAM API key.
-
Find out which API key is used. Check the resource group of your cluster.
ibmcloud ks cluster get --cluster <Cluster_ID>
-
Use the resource group ID to find the associated API key.
ibmcloud iam api-key --uuid containers-kubernetes-key
-
Verify whether the key is disabled.
ibmcloud iam api-key --activity <ApiKey_ID>
-
If necessary, reset your Kubernetes.
ibmcloud ks api-key reset
-
Or, if the API key disabled, enable it.
ibmcloud iam api-key-enable <ApiKey_ID>
-
For detailed steps, see Setting the cluster credentials and Managing IAM access, API keys, trusted profiles, service IDs, and access groups.
-
Wait 30 minutes, then check if the warning is resolved.
-
If the issue persists, contact support for further assistance. Open a support case. In the case details, be sure to include any relevant log files, error messages, or command outputs.