Skip to content

Relationships

Schema relationships
graph LR
    CdnDistributions -->|"account"| Accounts
    CdnDistributions -->|"certificate"| Certificates

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

Alternate domain names (CNAMEs) the distribution serves.

certificateobject

The certificate served to viewers, when it is a managed certificate (on AWS: an ACM certificate, always in us-east-1). Null for the provider's default certificate or an IAM server certificate.

idstring

The target's id.

certificate_sourcestring

Where the certificate served to viewers comes from, normalised. certificate_manager: the provider's certificate manager (on AWS: ACM - see certificate). uploaded: uploaded to the provider outside its certificate manager (on AWS: an IAM server certificate). provider_default: the provider's shared default certificate (on AWS: *.cloudfront.net). provider_certificate_source has the provider's term.

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

default_root_objectstring

The object served for the root URL. Read on GET only.

distribution_idstring

The provider's short id for the distribution, verbatim (on AWS: E1U5RQF7T870K0).

domain_namestring

The provider-assigned domain name (on AWS: dxxxx.cloudfront.net).

enabledboolean

Whether the distribution serves traffic.

geo_restriction_typestring

none, whitelist or blacklist, verbatim.

http_versionstring

Highest HTTP version served, verbatim (http1.1, http2, http3, http2and3).

https_requiredboolean

True when the default behavior and every other cache behavior redirect to or require HTTPS (no behavior allows plain HTTP).

ipv6_enabledboolean

Whether IPv6 is enabled.

logging_destinationstring

Where standard access logs go (on AWS: the S3 bucket domain name). Read on GET only.

logging_enabledboolean

Whether standard access logging is on. Read on GET only - see unreadable_fields on the list.

min_tls_versionstring

The lowest TLS version viewers can use, as major.minor (1.0, 1.1, 1.2, 1.3), or ssl3. When the distribution uses the provider's default certificate, this is the provider's fixed policy for it, not tls_policy.

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.

originsobject[]

Where the distribution fetches content from. Custom header VALUES (often an origin-verification secret) are never returned - only header names.

access_controlstring

For s3 origins: origin_access_control, origin_access_identity, or none (the bucket must then be readable by anyone the bucket policy allows).

custom_header_namesstring[]

Names of custom headers sent to the origin. Values are never returned.

domain_namestring

The origin domain name.

idstring

The origin id within the distribution.

origin_typestring

s3, custom or vpc.

protocol_policystring

For custom origins: http-only, match-viewer or https-only, verbatim.

tls_protocolsstring[]

For custom origins: TLS/SSL versions used to the origin, verbatim (SSLv3, TLSv1, TLSv1.1, TLSv1.2).

price_classstring

Edge location price class, verbatim.

providerstring

Which cloud this object was read from.

Possible values:
awsazuregcp
provider_certificate_sourcestring

The provider's own term for the certificate source (on AWS: acm, iam or cloudfront, the values of the deprecated ViewerCertificate.CertificateSource, read from which certificate field is set).

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 deployment state, verbatim (on AWS: Deployed or InProgress).

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.

statusstring

Deployment state, normalised. deploying: a configuration change is still reaching the edge locations (on AWS: InProgress). provider_status has the provider's value verbatim.

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

tls_policystring

The viewer TLS security policy, verbatim (on AWS: MinimumProtocolVersion, e.g. TLSv1.2_2021).

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.

viewer_protocol_policystring

The default behavior's viewer protocol policy, verbatim (on AWS: allow-all, redirect-to-https or https-only).

web_firewall_idstring

The web application firewall attached, verbatim (on AWS: a WAFv2 web ACL ARN or a WAF Classic web ACL id). Null when none.