Skip to content

Relationships

Schema relationships
graph LR
    KubernetesClusters -->|"account"| Accounts
    KubernetesClusters -->|"secrets_encryption_key"| ManagedKeys
    KubernetesClusters -->|"network_boundary"| NetworkBoundaries
    KubernetesClusters -->|"attached_rule_sets"| FirewallRuleSets
    KubernetesClusters -->|"service_role"| WorkloadIdentities

Properties

idstring
required·

Truto's stable unified identifier for this object. Opaque; use provider_id to address the object in the provider's own console or API.

accountstring

The account, subscription or project this object belongs to.

References: Accounts → id
attached_rule_setsobject[]

The firewall rule sets (security groups) on the control plane network interfaces, including the cluster security group the provider creates.

idstring

The target's id.

authentication_modestring

How the cluster authenticates IAM principals, verbatim (on AWS EKS: API, API_AND_CONFIG_MAP or CONFIG_MAP).

collected_atstring · date-time

When Truto actually read this object from the provider, in UTC ISO 8601 with the offset present — not the request time, and not a provider timestamp.

control_plane_log_typesstring[]

Control-plane log types that are being exported, verbatim (on AWS EKS: api, audit, authenticator, controllerManager, scheduler). Empty means none.

created_atstring · date-time

When the object was created at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.

deletion_protectionboolean

Whether the cluster is protected against deletion.

endpoint_private_accessboolean

Whether the Kubernetes API endpoint is reachable from inside the cluster's network.

endpoint_public_accessboolean

Whether the Kubernetes API endpoint is reachable from the internet. Reachability still depends on public_access_cidrs.

health_issue_codesstring[]

Codes of the provider's current health issues for the cluster. Empty means healthy.

kubernetes_versionstring

The Kubernetes minor version of the control plane, verbatim (for example 1.31).

namestring

The cluster name, verbatim.

native_typestring

The provider's own type string, unmodified — for example 'AWS::S3::Bucket', 'aws_iam_role', 'Microsoft.Sql/servers'. Used for display and drill-down.

network_boundaryobject

The network the cluster runs in.

idstring

The target's id.

oidc_issuerstring

The OIDC issuer URL for workload identity federation.

platform_versionstring

The provider's own platform revision of the control plane, verbatim (on AWS: eks.N).

providerstring

Which cloud this object was read from.

Possible values:
awsazuregcp
provider_idstring

The provider's own identifier, passed through verbatim — a full ARN, resource id, or self-link. Never truncated, prefixed, or normalized.

provider_statusstring

The provider's own lifecycle state string, verbatim (on AWS EKS: CREATING, ACTIVE, DELETING, FAILED, UPDATING, PENDING).

public_access_cidrsstring[]

CIDR blocks allowed to reach the public endpoint. ["0.0.0.0/0"] means any address.

regionstring

Where the object is located. 'global' denotes genuinely global resources (e.g. IAM, GCP VPC networks) rather than a guessed region. A substituted region (when none is derivable) is flagged in unreadable_fields.

remote_dataRecord<string, any>

Raw data returned from the remote API call.

secrets_encryption_enabledboolean

Whether Kubernetes secrets are envelope-encrypted with a key the customer controls (on AWS: an encryptionConfig covering "secrets").

secrets_encryption_keyobject

The key that envelope-encrypts Kubernetes secrets. Null when secrets encryption is off.

References: ManagedKeys → id
idstring

The target's id.

service_roleobject

The role the control plane uses to manage provider resources.

idstring

The target's id.

statusstring

Lifecycle state, normalised. pending: a cluster registered from outside the provider that has not connected yet (on AWS: EKS Connector). provider_status has the provider's value verbatim.

Possible values:
creatingactiveupdatingdeletingfailedpendingunknown
subnet_idsstring[]

Subnets the control plane places its network interfaces in.

tagsobject

Key-value pairs exactly as the customer set them: no case folding, key/value normalization, or merging of separate provider concepts. An empty object means no tags; tags that could not be read appear in unreadable_fields instead.

unreadable_fieldsobject[]

Fields on this object that could not be read, and why. An empty array means everything was read. Use this to tell a real value from a missing one.

detailstring

Explanation of the reason, where one adds anything.

fieldstring

The property on this resource that could not be read.

reasonstring

Why the field could not be read. available_on_get: Not read on list to keep the list fast; call GET for this resource's id to get it.

Possible values:
not_supported_by_providernot_configuredpermission_deniednot_collectedcollection_errorpartially_collectedavailable_on_get
updated_atstring · date-time

When the object was last modified at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.

version_support_typestring

The provider's support tier for the Kubernetes version, verbatim (on AWS EKS: STANDARD or EXTENDED - EXTENDED is billed extended support after standard support ends).