Skip to content

Relationships

Schema relationships
graph LR
    ComputeInstances -->|"account"| Accounts
    ComputeInstances -->|"network_boundary"| NetworkBoundaries
    ComputeInstances -->|"attached_rule_sets"| FirewallRuleSets
    ComputeInstances -->|"image"| MachineImages
    ComputeInstances -->|"managed_instance"| ManagedInstances

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[]

Security groups on the machine and on every one of its network interfaces.

idstring

The target's id.

availability_zonestring

The zone the machine runs in.

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.

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.

has_public_ipboolean

Whether any network interface has a public IPv4 address.

imageobject

The image the machine was launched from. machine_images lists only images the account owns, so an Amazon, Marketplace or other shared image does not resolve there; GET machine_images/{id} still reads it.

idstring

The target's id.

image_idstring

The image the machine was launched from, verbatim (an AMI id on AWS).

instance_idstring

The provider's own identifier for the machine, verbatim (an EC2 i- id, an Azure VM resource id, a GCP instance id).

instance_typestring

The provider's size or machine type, verbatim (t3.micro, Standard_D2s_v3, e2-medium).

ipv6_addressesstring[]

IPv6 addresses on any network interface. These are globally unique; whether they are reachable from the internet depends on routing and firewall rules.

is_managedboolean

Whether a fleet-management service (AWS Systems Manager, Azure Arc or Update Manager, GCP VM Manager) currently registers the machine as a managed node. On AWS, Systems Manager does not report stopped instances, so a stopped instance reads false even when it is registered. Read on GET only.

launched_atstring · date-time

When the machine last started. On AWS this moves on every stop and start, so it is not a creation date.

machine_identity_idstring

The identity the machine runs as, verbatim: on AWS the instance profile ARN (an instance profile holds one IAM role; it is not the role ARN workload_identities is keyed on), on Azure the managed identity, on GCP the service account. Null when the machine has none.

managed_instanceobject

The managed-node record for this machine, when is_managed is true. Read on GET only.

idstring

The target's id.

metadata_serviceobject

The instance metadata service (IMDS) settings. Null when the provider did not return them - see unreadable_fields.

enabledboolean

Whether the metadata endpoint answers at all.

hop_limitinteger

How many network hops a metadata response may travel. Above 1, containers on the host can reach the endpoint.

token_requiredboolean

Whether every metadata request must carry a session token. On AWS true is IMDSv2-only (httpTokens required); false still answers IMDSv1 requests without a token.

namestring

The display name: on AWS the Name tag, which is optional, so null means the instance has no Name tag.

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 VPC / virtual network the machine sits in.

idstring

The target's id.

os_familystring

Operating system family. linux_unix covers Linux and other Unix-like systems; unknown when the provider does not say. The provider's own value is in remote_data.

Possible values:
windowslinux_unixmacosunknown
private_ip_addressesstring[]

Every private IPv4 address on any of the machine's network interfaces.

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.

public_ip_addressesstring[]

Every public IPv4 address on any network interface, including addresses on secondary private IPs. Empty means no public IPv4.

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.

statestring

Lifecycle state, normalised. On AWS shutting-down is 'terminating'. Terminated EC2 instances stay listed for about an hour. The provider's own value is in remote_data.

Possible values:
pendingrunningstoppingstoppedterminatingterminatedunknown
subnet_idstring

The subnet of the primary network interface, verbatim.

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.