Skip to content

Relationships

Schema relationships
graph LR
    MachineImages -->|"account"| Accounts

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
architecturestring

Instruction set architecture, verbatim (x86_64, arm64).

boot_modestring

Firmware the image boots with. uefi_preferred: UEFI where the machine type supports it, else BIOS. Null when the image does not set one. The provider's own value is in remote_data.

Possible values:
biosuefiuefi_preferredunknown
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.

deprecated_atstring · date-time

When the image is or was deprecated. Null when no deprecation is set.

descriptionstring

The image's description, verbatim.

encryption_at_restboolean

Whether every disk snapshot in the image is encrypted. Null for an image with no snapshot-backed disk (instance-store).

image_idstring

The provider's own image id, verbatim (an ami- id on AWS).

is_publicboolean

Whether anyone, in any account, can launch the image.

last_launched_atstring · date-time

When a machine was last launched from the image, as the provider records it (on AWS this lags by up to 24 hours).

namestring

The image's 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.

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
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.

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.

requires_metadata_tokenboolean

Whether machines launched from the image require metadata-service session tokens by default (on AWS, imdsSupport v2.0).

root_device_typestring

What the root disk is. block_volume: a persistent block volume (EBS on AWS); instance_store: a disk on the host, lost when the machine stops. The provider's own value is in remote_data.

Possible values:
block_volumeinstance_storeunknown
shared_with_accountsstring[]

Accounts the image is shared with. Not collected on AWS (see unreadable_fields).

source_image_idstring

The image this one was copied from, verbatim. Null when it was not copied.

statestring

Image state, normalised. disabled: kept but cannot be launched; deregistered: deleted (the provider shows it for a short while). The provider's own value is in remote_data.

Possible values:
pendingavailablefaileddisabledderegisteredunknown
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.

virtualization_typestring

Virtualization type, verbatim (hvm, paravirtual on AWS).