Settings API - Connection settings schema table
Connection settings (builtin:cloud.kubernetes)
Connect to Kubernetes or OpenShift for enhanced observability. Learn more about Kubernetes or OpenShift in our documentation.
| Schema ID | Schema groups | Scope |
|---|---|---|
builtin:cloud.kubernetes | - | KUBERNETES_CLUSTER - Kubernetes cluster |
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:cloud.kubernetes |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:cloud.kubernetes | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:cloud.kubernetes |
Authentication
To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Property | Type | Description | Required |
|---|---|---|---|
Enabledenabled | boolean | - | required |
Namelabel | text | Renaming the cluster breaks configurations that are based on its name (e.g., management zones, and alerting). | required |
Connect containerized ActiveGate to local Kubernetes API endpointclusterIdEnabled | boolean | For more information on local Kubernetes API monitoring, see the documentation. Enable this toggle when the ActiveGate is deployed to the same Kubernetes clusters you want to monitor. Disable it if you want to monitor a different Kubernetes cluster. | required |
Kubernetes cluster IDclusterId | text | Unique ID of the cluster, the containerized ActiveGate is deployed to. Defaults to the UUID of the kube-system namespace. The cluster ID of containerized ActiveGates is shown on the Deployment status screen. | required |
Kubernetes API URL TargetendpointUrl | text | Get the API URL for Kubernetes or OpenShift. | required |
Kubernetes Bearer TokenauthToken | secret | Create a bearer token for Kubernetes or OpenShift. | required |
ActiveGate GroupactiveGateGroup | text | - | optional |
Require valid certificates for communication with API server (recommended)certificateCheckEnabled | boolean | - | required |
Verify hostname in certificate against Kubernetes API URLhostnameVerificationEnabled | boolean | - | required |