From 31e4df5090c71b0452e49d0d93e4695d40ed084c Mon Sep 17 00:00:00 2001 From: Peter Matseykanets Date: Tue, 24 Jun 2025 10:53:42 -0400 Subject: [PATCH] Add an important note about kubeconfig content being generated only once --- docs/api/workflows/kubeconfigs.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/api/workflows/kubeconfigs.md b/docs/api/workflows/kubeconfigs.md index f29ae9797d5..5965fccbc5e 100644 --- a/docs/api/workflows/kubeconfigs.md +++ b/docs/api/workflows/kubeconfigs.md @@ -27,6 +27,12 @@ EOF Error from server (Forbidden): error when creating "STDIN": kubeconfigs.ext.cattle.io is forbidden: user system:admin is not a Rancher user ``` +:::note Important: + +The kubeconfig content is generated and returned in the `.status.value` field **only once** when the Kubeconfig is successfully created because it contains secret values for created tokens. Therefore it has to be captured by using an appropriate output options, such as `-o jsonpath='{.status.value}'` or `-o yaml`. + +::: + A kubeconfig can be created for more than one cluster at a time by specifying a list of cluster names in the `spec.clusters` field. Note: Cluster names can be retrieved by listing `clusters.management.cattle.io` resources.