This page documents the language specification for the fastly package. If you're looking for help working with the inputs, outputs, or functions of fastly resources in a Pulumi program, please see the resource documentation for examples and API reference.

Pulumi Fastly

This provider is a derived work of the Terraform Provider distributed under MPL 2.0. If you encounter a bug or missing feature, first check the pulumi/pulumi-fastly repo; however, if that doesn’t turn up anything, please consult the source terraform-providers/terraform-provider-fastly repo.

class pulumi_fastly.AwaitableGetFastlyIpRangesResult(cidr_blocks=None, id=None, ipv6_cidr_blocks=None)
class pulumi_fastly.GetFastlyIpRangesResult(cidr_blocks=None, id=None, ipv6_cidr_blocks=None)

A collection of values returned by getFastlyIpRanges.

cidr_blocks = None

The lexically ordered list of ipv4 CIDR blocks.

id = None

The provider-assigned unique ID for this managed resource.

ipv6_cidr_blocks = None

The lexically ordered list of ipv6 CIDR blocks.

class pulumi_fastly.Provider(resource_name, opts=None, api_key=None, base_url=None, __props__=None, __name__=None, __opts__=None)

The provider type for the fastly package. By default, resources use package-wide configuration settings, however an explicit Provider instance may be created and passed during resource construction to achieve fine-grained programmatic control over provider settings. See the documentation for more information.

Parameters
translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_fastly.ServiceACLEntriesv1(resource_name, opts=None, acl_id=None, entries=None, service_id=None, __props__=None, __name__=None, __opts__=None)

Defines a set of Fastly ACL entries that can be used to populate a service ACL. This resource will populate an ACL with the entries and will track their state.

import pulumi
import pulumi_fastly as fastly

config = pulumi.Config()
myacl_name = config.get("myaclName")
if myacl_name is None:
    myacl_name = "My ACL"
myservice = fastly.Servicev1("myservice",
    domain=[{
        "name": "demo.notexample.com",
        "comment": "demo",
    }],
    backend=[{
        "address": "demo.notexample.com.s3-website-us-west-2.amazonaws.com",
        "name": "AWS S3 hosting",
        "port": 80,
    }],
    acl=[{
        "name": myacl_name,
    }],
    force_destroy=True)
entries = fastly.ServiceACLEntriesv1("entries",
    service_id=myservice.id,
    acl_id=myservice.acls.apply(lambda acls: {d["name"]: d["acl_id"] for d in acls}[myacl_name]),
    entry=[{
        "ip": "127.0.0.1",
        "subnet": "24",
        "negated": False,
        "comment": "ALC Entry 1",
    }])
import pulumi
import pulumi_fastly as fastly

acl_name = "my_acl"
acl_entries = [
    {
        "ip": "1.2.3.4",
        "comment": "acl_entry_1",
    },
    {
        "ip": "1.2.3.5",
        "comment": "acl_entry_2",
    },
    {
        "ip": "1.2.3.6",
        "comment": "acl_entry_3",
    },
]
myservice = fastly.Servicev1("myservice",
    domain=[{
        "name": "demo.notexample.com",
        "comment": "demo",
    }],
    backend=[{
        "address": "1.2.3.4",
        "name": "localhost",
        "port": 80,
    }],
    acl=[{
        "name": acl_name,
    }],
    force_destroy=True)
entries = fastly.ServiceACLEntriesv1("entries",
    service_id=myservice.id,
    acl_id=myservice.acls.apply(lambda acls: {d["name"]: d["acl_id"] for d in acls}[acl_name]),
    dynamic=[{
        "forEach": [{
            "ip": e["ip"],
            "comment": e["comment"],
        } for e in acl_entries],
        "content": [{
            "ip": entry["value"]["ip"],
            "subnet": 22,
            "comment": entry["value"]["comment"],
            "negated": False,
        }],
    }])
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • acl_id (pulumi.Input[str]) – The ID of the ACL that the items belong to

  • entries (pulumi.Input[list]) – A Set ACL entries that are applied to the service. Defined below

  • service_id (pulumi.Input[str]) – The ID of the Service that the ACL belongs to

The entries object supports the following:

  • comment (pulumi.Input[str]) - A personal freeform descriptive note

  • id (pulumi.Input[str])

  • ip (pulumi.Input[str]) - An IP address that is the focus for the ACL

  • negated (pulumi.Input[bool]) - A boolean that will negate the match if true

  • subnet (pulumi.Input[str]) - An optional subnet mask applied to the IP address

acl_id: pulumi.Output[str] = None

The ID of the ACL that the items belong to

entries: pulumi.Output[list] = None

A Set ACL entries that are applied to the service. Defined below

  • comment (str) - A personal freeform descriptive note

  • id (str)

  • ip (str) - An IP address that is the focus for the ACL

  • negated (bool) - A boolean that will negate the match if true

  • subnet (str) - An optional subnet mask applied to the IP address

service_id: pulumi.Output[str] = None

The ID of the Service that the ACL belongs to

static get(resource_name, id, opts=None, acl_id=None, entries=None, service_id=None)

Get an existing ServiceACLEntriesv1 resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • acl_id (pulumi.Input[str]) – The ID of the ACL that the items belong to

  • entries (pulumi.Input[list]) – A Set ACL entries that are applied to the service. Defined below

  • service_id (pulumi.Input[str]) – The ID of the Service that the ACL belongs to

The entries object supports the following:

  • comment (pulumi.Input[str]) - A personal freeform descriptive note

  • id (pulumi.Input[str])

  • ip (pulumi.Input[str]) - An IP address that is the focus for the ACL

  • negated (pulumi.Input[bool]) - A boolean that will negate the match if true

  • subnet (pulumi.Input[str]) - An optional subnet mask applied to the IP address

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_fastly.ServiceDictionaryItemsv1(resource_name, opts=None, dictionary_id=None, items=None, service_id=None, __props__=None, __name__=None, __opts__=None)

Defines a map of Fastly dictionary items that can be used to populate a service dictionary. This resource will populate a dictionary with the items and will track their state.

import pulumi
import pulumi_fastly as fastly

config = pulumi.Config()
mydict_name = config.get("mydictName")
if mydict_name is None:
    mydict_name = "My Dictionary"
myservice = fastly.Servicev1("myservice",
    domain=[{
        "name": "demo.notexample.com",
        "comment": "demo",
    }],
    backend=[{
        "address": "demo.notexample.com.s3-website-us-west-2.amazonaws.com",
        "name": "AWS S3 hosting",
        "port": 80,
    }],
    dictionary=[{
        "name": mydict_name,
    }],
    force_destroy=True)
items = fastly.ServiceDictionaryItemsv1("items",
    service_id=myservice.id,
    dictionary_id=myservice.dictionaries.apply(lambda dictionaries: {s["name"]: s["dictionary_id"] for s in dictionaries}[mydict_name]),
    items={
        "key1": "value1",
        "key2": "value2",
    })
import pulumi
import pulumi_fastly as fastly

config = pulumi.Config()
mydict = config.get_object("mydict")
if mydict is None:
    mydict = {
        "name": "My Dictionary",
        "items": {
            "key1": "value1x",
            "key2": "value2x",
        },
    }
myservice = fastly.Servicev1("myservice",
    domain=[{
        "name": "demo.notexample.com",
        "comment": "demo",
    }],
    backend=[{
        "address": "demo.notexample.com.s3-website-us-west-2.amazonaws.com",
        "name": "AWS S3 hosting",
        "port": 80,
    }],
    dictionary=[{
        "name": mydict["name"],
    }],
    force_destroy=True)
items = fastly.ServiceDictionaryItemsv1("items",
    service_id=myservice.id,
    dictionary_id=myservice.dictionaries.apply(lambda dictionaries: {d["name"]: d["dictionary_id"] for d in dictionaries}[mydict["name"]]),
    items=mydict["items"])
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • dictionary_id (pulumi.Input[str]) – The ID of the dictionary that the items belong to

  • items (pulumi.Input[dict]) – A map representing an entry in the dictionary, (key/value)

  • service_id (pulumi.Input[str]) – The ID of the service that the dictionary belongs to

dictionary_id: pulumi.Output[str] = None

The ID of the dictionary that the items belong to

items: pulumi.Output[dict] = None

A map representing an entry in the dictionary, (key/value)

service_id: pulumi.Output[str] = None

The ID of the service that the dictionary belongs to

static get(resource_name, id, opts=None, dictionary_id=None, items=None, service_id=None)

Get an existing ServiceDictionaryItemsv1 resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • dictionary_id (pulumi.Input[str]) – The ID of the dictionary that the items belong to

  • items (pulumi.Input[dict]) – A map representing an entry in the dictionary, (key/value)

  • service_id (pulumi.Input[str]) – The ID of the service that the dictionary belongs to

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_fastly.ServiceDynamicSnippetContentv1(resource_name, opts=None, content=None, service_id=None, snippet_id=None, __props__=None, __name__=None, __opts__=None)

Defines content that represents blocks of VCL logic that is inserted into your service. This resource will populate the content of a dynamic snippet and allow it to be manged without the creation of a new service verison.

import pulumi
import pulumi_fastly as fastly

myservice = fastly.Servicev1("myservice",
    domain=[{
        "name": "snippet.fastlytestdomain.com",
        "comment": "snippet test",
    }],
    backend=[{
        "address": "tftesting.tftesting.net.s3-website-us-west-2.amazonaws.com",
        "name": "AWS S3 hosting",
        "port": 80,
    }],
    dynamicsnippet=[{
        "name": "My Dynamic Snippet",
        "type": "recv",
        "priority": 110,
    }],
    default_host="tftesting.tftesting.net.s3-website-us-west-2.amazonaws.com",
    force_destroy=True)
my_dyn_content = fastly.ServiceDynamicSnippetContentv1("myDynContent",
    service_id=myservice.id,
    snippet_id=myservice.dynamicsnippets.apply(lambda dynamicsnippets: {s["name"]: s["snippet_id"] for s in dynamicsnippets}["My Dynamic Snippet"]),
    content="""if ( req.url ) {
 set req.http.my-snippet-test-header = "true";
}""")
import pulumi
import pulumi_fastly as fastly

myservice = fastly.Servicev1("myservice",
    domain=[{
        "name": "snippet.fastlytestdomain.com",
        "comment": "snippet test",
    }],
    backend=[{
        "address": "tftesting.tftesting.net.s3-website-us-west-2.amazonaws.com",
        "name": "AWS S3 hosting",
        "port": 80,
    }],
    dynamicsnippet=[
        {
            "name": "My Dynamic Snippet One",
            "type": "recv",
            "priority": 110,
        },
        {
            "name": "My Dynamic Snippet Two",
            "type": "recv",
            "priority": 110,
        },
    ],
    default_host="tftesting.tftesting.net.s3-website-us-west-2.amazonaws.com",
    force_destroy=True)
my_dyn_content_one = fastly.ServiceDynamicSnippetContentv1("myDynContentOne",
    service_id=myservice.id,
    snippet_id=myservice.dynamicsnippets.apply(lambda dynamicsnippets: {s["name"]: s["snippet_id"] for s in dynamicsnippets}["My Dynamic Snippet One"]),
    content="""if ( req.url ) {
 set req.http.my-snippet-test-header-one = "true";
}""")
my_dyn_content_two = fastly.ServiceDynamicSnippetContentv1("myDynContentTwo",
    service_id=myservice.id,
    snippet_id=myservice.dynamicsnippets.apply(lambda dynamicsnippets: {s["name"]: s["snippet_id"] for s in dynamicsnippets}["My Dynamic Snippet Two"]),
    content="""if ( req.url ) {
 set req.http.my-snippet-test-header-two = "true";
}""")
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • content (pulumi.Input[str]) – The VCL code that specifies exactly what the snippet does.

  • service_id (pulumi.Input[str]) – The ID of the service that the dynamic snippet belongs to

  • snippet_id (pulumi.Input[str]) – The ID of the dynamic snippet that the content belong to

content: pulumi.Output[str] = None

The VCL code that specifies exactly what the snippet does.

service_id: pulumi.Output[str] = None

The ID of the service that the dynamic snippet belongs to

snippet_id: pulumi.Output[str] = None

The ID of the dynamic snippet that the content belong to

static get(resource_name, id, opts=None, content=None, service_id=None, snippet_id=None)

Get an existing ServiceDynamicSnippetContentv1 resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • content (pulumi.Input[str]) – The VCL code that specifies exactly what the snippet does.

  • service_id (pulumi.Input[str]) – The ID of the service that the dynamic snippet belongs to

  • snippet_id (pulumi.Input[str]) – The ID of the dynamic snippet that the content belong to

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_fastly.Servicev1(resource_name, opts=None, acls=None, activate=None, backends=None, bigqueryloggings=None, blobstorageloggings=None, cache_settings=None, comment=None, conditions=None, default_host=None, default_ttl=None, dictionaries=None, directors=None, domains=None, dynamicsnippets=None, force_destroy=None, gcsloggings=None, gzips=None, headers=None, healthchecks=None, httpsloggings=None, logentries=None, logging_datadogs=None, logging_elasticsearches=None, logging_ftps=None, logging_googlepubsubs=None, logging_kafkas=None, logging_logglies=None, logging_newrelics=None, logging_scalyrs=None, logging_sftps=None, name=None, papertrails=None, request_settings=None, response_objects=None, s3loggings=None, snippets=None, splunks=None, sumologics=None, syslogs=None, vcls=None, version_comment=None, __props__=None, __name__=None, __opts__=None)

Provides a Fastly Service, representing the configuration for a website, app, API, or anything else to be served through Fastly. A Service encompasses Domains and Backends.

The Service resource requires a domain name that is correctly set up to direct traffic to the Fastly service. See Fastly’s guide on [Adding CNAME Records][fastly-cname] on their documentation site for guidance.

import pulumi
import pulumi_fastly as fastly

demo = fastly.Servicev1("demo",
    backends=[{
        "address": "127.0.0.1",
        "name": "localhost",
        "port": 80,
    }],
    domains=[{
        "comment": "demo",
        "name": "demo.notexample.com",
    }],
    force_destroy=True)
import pulumi
import pulumi_fastly as fastly

demo = fastly.Servicev1("demo",
    backends=[{
        "address": "127.0.0.1",
        "name": "localhost",
        "port": 80,
    }],
    domains=[{
        "comment": "demo",
        "name": "demo.notexample.com",
    }],
    force_destroy=True,
    vcls=[
        {
            "content": (lambda path: open(path).read())(f"{path['module']}/my_custom_main.vcl"),
            "main": True,
            "name": "my_custom_main_vcl",
        },
        {
            "content": (lambda path: open(path).read())(f"{path['module']}/my_custom_library.vcl"),
            "name": "my_custom_library_vcl",
        },
    ])
import pulumi
import pulumi_fastly as fastly

demo = fastly.Servicev1("demo",
    backends=[
        {
            "address": "127.0.0.1",
            "name": "origin1",
            "port": 80,
        },
        {
            "address": "127.0.0.2",
            "name": "origin2",
            "port": 80,
        },
    ],
    directors=[{
        "backends": [
            "origin1",
            "origin2",
        ],
        "name": "mydirector",
        "quorum": 0,
        "type": 3,
    }],
    domains=[{
        "comment": "demo",
        "name": "demo.notexample.com",
    }],
    force_destroy=True)
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • acls (pulumi.Input[list]) – A set of ACL configuration blocks. Defined below.

  • activate (pulumi.Input[bool]) – Conditionally prevents the Service from being activated. The apply step will continue to create a new draft version but will not activate it if this is set to false. Default true.

  • backends (pulumi.Input[list]) – A set of Backends to service requests from your Domains. Defined below. Backends must be defined in this argument, or defined in the vcl argument below

  • bigqueryloggings (pulumi.Input[list]) – A BigQuery endpoint to send streaming logs too. Defined below.

  • blobstorageloggings (pulumi.Input[list]) – An Azure Blob Storage endpoint to send streaming logs too. Defined below.

  • cache_settings (pulumi.Input[list]) – A set of Cache Settings, allowing you to override

  • comment (pulumi.Input[str]) – An optional comment about the Director.

  • conditions (pulumi.Input[list]) – A set of conditions to add logic to any basic configuration object in this service. Defined below.

  • default_host (pulumi.Input[str]) – Sets the host header.

  • default_ttl (pulumi.Input[float]) – The default Time-to-live (TTL) for requests.

  • dictionaries (pulumi.Input[list]) – A set of dictionaries that allow the storing of key values pair for use within VCL functions. Defined below.

  • directors (pulumi.Input[list]) – A director to allow more control over balancing traffic over backends. when an item is not to be cached based on an above condition. Defined below

  • domains (pulumi.Input[list]) – If you created the S3 bucket outside of us-east-1, then specify the corresponding bucket endpoint. Example: s3-us-west-2.amazonaws.com.

  • dynamicsnippets (pulumi.Input[list]) – A set of custom, “dynamic” VCL Snippet configuration blocks. Defined below.

  • force_destroy (pulumi.Input[bool]) – Services that are active cannot be destroyed. In order to destroy the Service, set force_destroy to true. Default false.

  • gcsloggings (pulumi.Input[list]) – A gcs endpoint to send streaming logs too. Defined below.

  • gzips (pulumi.Input[list]) – A set of gzip rules to control automatic gzipping of content. Defined below.

  • headers (pulumi.Input[list]) – A set of Headers to manipulate for each request. Defined below.

  • healthchecks (pulumi.Input[list]) – Name of a defined healthcheck to assign to this backend.

  • httpsloggings (pulumi.Input[list]) – An HTTPS endpoint to send streaming logs to. Defined below.

  • logentries (pulumi.Input[list]) – A logentries endpoint to send streaming logs too. Defined below.

  • logging_datadogs (pulumi.Input[list]) – A Datadog endpoint to send streaming logs to. Defined below.

  • logging_elasticsearches (pulumi.Input[list]) – An Elasticsearch endpoint to send streaming logs to. Defined below.

  • logging_ftps (pulumi.Input[list]) – An FTP endpoint to send streaming logs to. Defined below.

  • logging_googlepubsubs (pulumi.Input[list]) – A Google Cloud Pub/Sub endpoint to send streaming logs to. Defined below.

  • logging_kafkas (pulumi.Input[list]) – A Kafka endpoint to send streaming logs to. Defined below.

  • logging_logglies (pulumi.Input[list]) – A Loggly endpoint to send streaming logs to. Defined below.

  • logging_newrelics (pulumi.Input[list]) – A New Relic endpoint to send streaming logs to. Defined below.

  • logging_scalyrs (pulumi.Input[list]) – A Scalyr endpoint to send streaming logs to. Defined below.

  • logging_sftps (pulumi.Input[list]) – An SFTP endpoint to send streaming logs to. Defined below.

  • name (pulumi.Input[str]) – A unique name to identify this dictionary.

  • papertrails (pulumi.Input[list]) – A Papertrail endpoint to send streaming logs too. Defined below.

  • request_settings (pulumi.Input[list]) – A set of Request modifiers. Defined below

  • response_objects (pulumi.Input[list]) – Allows you to create synthetic responses that exist entirely on the varnish machine. Useful for creating error or maintenance pages that exists outside the scope of your datacenter. Best when used with Condition objects.

  • s3loggings (pulumi.Input[list]) – A set of S3 Buckets to send streaming logs too. Defined below.

  • snippets (pulumi.Input[list]) – A set of custom, “regular” (non-dynamic) VCL Snippet configuration blocks. Defined below.

  • splunks (pulumi.Input[list]) – A Splunk endpoint to send streaming logs too. Defined below.

  • sumologics (pulumi.Input[list]) – A Sumologic endpoint to send streaming logs too. Defined below.

  • syslogs (pulumi.Input[list]) – A syslog endpoint to send streaming logs too. Defined below.

  • vcls (pulumi.Input[list]) – A set of custom VCL configuration blocks. See the Fastly documentation for more information on using custom VCL.

  • version_comment (pulumi.Input[str]) – Description field for the version.

The acls object supports the following:

  • acl_id (pulumi.Input[str]) - The ID of the ACL.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

The backends object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • autoLoadbalance (pulumi.Input[bool]) - Denotes if this Backend should be included in the pool of backends that requests are load balanced against. Default true.

  • betweenBytesTimeout (pulumi.Input[float]) - How long to wait between bytes in milliseconds. Default 10000.

  • connectTimeout (pulumi.Input[float]) - How long to wait for a timeout in milliseconds. Default 1000

  • errorThreshold (pulumi.Input[float]) - Number of errors to allow before the Backend is marked as down. Default 0.

  • firstByteTimeout (pulumi.Input[float]) - How long to wait for the first bytes in milliseconds. Default 15000.

  • healthcheck (pulumi.Input[str]) - Name of a defined healthcheck to assign to this backend.

  • maxConn (pulumi.Input[float]) - Maximum number of connections for this Backend. Default 200.

  • maxTlsVersion (pulumi.Input[str]) - Maximum allowed TLS version on SSL connections to this backend.

  • minTlsVersion (pulumi.Input[str]) - Minimum allowed TLS version on SSL connections to this backend.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • overrideHost (pulumi.Input[str]) - The hostname to override the Host header.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • shield (pulumi.Input[str]) - Selected POP to serve as a “shield” for backends. Valid values for shield are included in the ``GET /datacenters` <https://developer.fastly.com/reference/api/utils/datacenter/>`_ API response.

  • sslCaCert (pulumi.Input[str]) - CA certificate attached to origin.

  • sslCertHostname (pulumi.Input[str]) - Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.

  • sslCheckCert (pulumi.Input[bool]) - Be strict about checking SSL certs. Default true.

  • sslCiphers (pulumi.Input[str]) - Comma separated list of OpenSSL Ciphers to try when negotiating to the backend.

  • sslClientCert (pulumi.Input[str]) - Client certificate attached to origin. Used when connecting to the backend.

  • sslClientKey (pulumi.Input[str]) - Client key attached to origin. Used when connecting to the backend.

  • sslHostname (pulumi.Input[str]) - Used for both SNI during the TLS handshake and to validate the cert.

  • sslSniHostname (pulumi.Input[str]) - Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.

  • useSsl (pulumi.Input[bool]) - Whether or not to use SSL to reach the backend. Default false.

  • weight (pulumi.Input[float]) - The portion of traffic to send to this Backend. Each Backend receives weight / total of the traffic. Default 100.

The bigqueryloggings object supports the following:

  • dataset (pulumi.Input[str]) - The ID of your BigQuery dataset.

  • email (pulumi.Input[str]) - The email for the service account with write access to your BigQuery dataset. If not provided, this will be pulled from a FASTLY_BQ_EMAIL environment variable.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • projectId (pulumi.Input[str]) - The ID of your Google Cloud Platform project.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • table (pulumi.Input[str]) - The ID of your BigQuery table.

  • template (pulumi.Input[str]) - Big query table name suffix template. If set will be interpreted as a strftime compatible string and used as the Template Suffix for your table.

The blobstorageloggings object supports the following:

  • accountName (pulumi.Input[str]) - The unique Azure Blob Storage namespace in which your data objects are stored.

  • container (pulumi.Input[str]) - The name of the Azure Blob Storage container in which to store logs.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • sasToken (pulumi.Input[str]) - The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

The cache_settings object supports the following:

  • action (pulumi.Input[str]) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • staleTtl (pulumi.Input[float]) - Max “Time To Live” for stale (unreachable) objects.

  • ttl (pulumi.Input[float]) - The Time-To-Live (TTL) for the object.

The conditions object supports the following:

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • statement (pulumi.Input[str]) - The statement used to determine if the condition is met.

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The dictionaries object supports the following:

  • dictionary_id (pulumi.Input[str]) - The ID of the dictionary.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • writeOnly (pulumi.Input[bool]) - If true, the dictionary is a private dictionary, and items are not readable in the UI or via API. Default is false. It is important to note that changing this attribute will delete and recreate the dictionary, discard the current items in the dictionary. Using a write-only/private dictionary should only be done if the items are managed outside of the provider.

The directors object supports the following:

  • backends (pulumi.Input[list]) - Names of defined backends to map the director to. Example: [ "origin1", "origin2" ]

  • capacity (pulumi.Input[float]) - Load balancing weight for the backends. Default 100.

  • comment (pulumi.Input[str]) - An optional comment about the Director.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • quorum (pulumi.Input[float]) - Percentage of capacity that needs to be up for the director itself to be considered up. Default 75.

  • retries (pulumi.Input[float]) - How many backends to search if it fails. Default 5.

  • shield (pulumi.Input[str]) - Selected POP to serve as a “shield” for backends. Valid values for shield are included in the ``GET /datacenters` <https://developer.fastly.com/reference/api/utils/datacenter/>`_ API response.

  • type (pulumi.Input[float]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The domains object supports the following:

  • comment (pulumi.Input[str]) - An optional comment about the Director.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

The dynamicsnippets object supports the following:

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • snippet_id (pulumi.Input[str]) - The ID of the dynamic snippet.

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The gcsloggings object supports the following:

  • bucketName (pulumi.Input[str]) - The name of the bucket in which to store the logs.

  • email (pulumi.Input[str]) - The email for the service account with write access to your BigQuery dataset. If not provided, this will be pulled from a FASTLY_BQ_EMAIL environment variable.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

The gzips object supports the following:

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • contentTypes (pulumi.Input[list]) - The content-type for each type of content you wish to have dynamically gzip’ed. Example: ["text/html", "text/css"].

  • extensions (pulumi.Input[list]) - File extensions for each file type to dynamically gzip. Example: ["css", "js"].

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

The headers object supports the following:

  • action (pulumi.Input[str]) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • destination (pulumi.Input[str]) - The name of the header that is going to be affected by the Action.

  • ignoreIfSet (pulumi.Input[bool]) - Do not add the header if it is already present. (Only applies to the set action.). Default false.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • regex (pulumi.Input[str]) - Regular expression to use (Only applies to the regex and regex_repeat actions.)

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • source (pulumi.Input[str]) - Variable to be used as a source for the header content. (Does not apply to the delete action.)

  • substitution (pulumi.Input[str]) - Value to substitute in place of regular expression. (Only applies to the regex and regex_repeat actions.)

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The healthchecks object supports the following:

  • checkInterval (pulumi.Input[float]) - How often to run the Healthcheck in milliseconds. Default 5000.

  • expectedResponse (pulumi.Input[float]) - The status code expected from the host. Default 200.

  • host (pulumi.Input[str]) - The Host header to send for this Healthcheck.

  • httpVersion (pulumi.Input[str]) - Whether to use version 1.0 or 1.1 HTTP. Default 1.1.

  • initial (pulumi.Input[float]) - When loading a config, the initial number of probes to be seen as OK. Default 2.

  • method (pulumi.Input[str]) - HTTP method used for request. Can be either POST or PUT. Default POST.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • threshold (pulumi.Input[float]) - How many Healthchecks must succeed to be considered healthy. Default 3.

  • timeout (pulumi.Input[float]) - Timeout in milliseconds. Default 500.

  • window (pulumi.Input[float]) - The number of most recent Healthcheck queries to keep for this Healthcheck. Default 5.

The httpsloggings object supports the following:

  • contentType (pulumi.Input[str]) - The MIME type of the content.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • headerName (pulumi.Input[str]) - Custom header sent with the request.

  • headerValue (pulumi.Input[str]) - Value of the custom header sent with the request.

  • jsonFormat (pulumi.Input[str]) - Formats log entries as JSON. Can be either disabled (0), array of json (1), or newline delimited json (2).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • method (pulumi.Input[str]) - HTTP method used for request. Can be either POST or PUT. Default POST.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requestMaxBytes (pulumi.Input[float]) - The maximum number of bytes sent in one request. Defaults to 0 for unbounded.

  • requestMaxEntries (pulumi.Input[float]) - The maximum number of logs sent in one request. Defaults to 0 for unbounded.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

The logentries object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

  • useTls (pulumi.Input[bool]) - Whether to use TLS for secure logging. Can be either true or false.

The logging_datadogs object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • region (pulumi.Input[str]) - The region that log data will be sent to. One of US or EU. Defaults to US if undefined.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_elasticsearches object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • index (pulumi.Input[str]) - The name of the Elasticsearch index to send documents (logs) to.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • password (pulumi.Input[str]) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • pipeline (pulumi.Input[str]) - The ID of the Elasticsearch ingest pipeline to apply pre-process transformations to before indexing.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requestMaxBytes (pulumi.Input[float]) - The maximum number of bytes sent in one request. Defaults to 0 for unbounded.

  • requestMaxEntries (pulumi.Input[float]) - The maximum number of logs sent in one request. Defaults to 0 for unbounded.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The logging_ftps object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • password (pulumi.Input[str]) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The logging_googlepubsubs object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • projectId (pulumi.Input[str]) - The ID of your Google Cloud Platform project.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • topic (pulumi.Input[str]) - The Kafka topic to send logs to.

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The logging_kafkas object supports the following:

  • brokers (pulumi.Input[str]) - A comma-separated list of IP addresses or hostnames of Kafka brokers.

  • compressionCodec (pulumi.Input[str]) - The codec used for compression of your logs. One of: gzip, snappy, lz4.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requiredAcks (pulumi.Input[str]) - The Number of acknowledgements a leader must receive before a write is considered successful. One of: 1 (default) One server needs to respond. 0 No servers need to respond. -1 Wait for all in-sync replicas to respond.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • topic (pulumi.Input[str]) - The Kafka topic to send logs to.

  • useTls (pulumi.Input[bool]) - Whether to use TLS for secure logging. Can be either true or false.

The logging_logglies object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_newrelics object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_scalyrs object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • region (pulumi.Input[str]) - The region that log data will be sent to. One of US or EU. Defaults to US if undefined.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_sftps object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • password (pulumi.Input[str]) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • sshKnownHosts (pulumi.Input[str]) - A list of host keys for all hosts we can connect to over SFTP.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The papertrails object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

The request_settings object supports the following:

  • action (pulumi.Input[str]) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • bypassBusyWait (pulumi.Input[bool]) - Disable collapsed forwarding, so you don’t wait for other objects to origin.

  • default_host (pulumi.Input[str]) - Sets the host header.

  • forceMiss (pulumi.Input[bool]) - Force a cache miss for the request. If specified, can be true or false.

  • forceSsl (pulumi.Input[bool]) - Forces the request to use SSL (Redirects a non-SSL request to SSL).

  • geoHeaders (pulumi.Input[bool]) - Injects Fastly-Geo-Country, Fastly-Geo-City, and Fastly-Geo-Region into the request headers.

  • hashKeys (pulumi.Input[str]) - Comma separated list of varnish request object fields that should be in the hash key.

  • maxStaleAge (pulumi.Input[float]) - How old an object is allowed to be to serve stale-if-error or stale-while-revalidate, in seconds.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • timerSupport (pulumi.Input[bool]) - Injects the X-Timer info into the request for viewing origin fetch durations.

  • xff (pulumi.Input[str]) - X-Forwarded-For, should be clear, leave, append, append_all, or overwrite. Default append.

The response_objects object supports the following:

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • content (pulumi.Input[str]) - The custom VCL code to upload.

  • contentType (pulumi.Input[str]) - The MIME type of the content.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • response (pulumi.Input[str]) - The HTTP Response. Default Ok.

  • status (pulumi.Input[float]) - The HTTP Status Code. Default 200.

The s3loggings object supports the following:

  • bucketName (pulumi.Input[str]) - The name of the bucket in which to store the logs.

  • domain (pulumi.Input[str]) - If you created the S3 bucket outside of us-east-1, then specify the corresponding bucket endpoint. Example: s3-us-west-2.amazonaws.com.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • redundancy (pulumi.Input[str]) - The S3 redundancy level. Should be formatted; one of: standard, reduced_redundancy or null. Default null.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • s3AccessKey (pulumi.Input[str]) - AWS Access Key of an account with the required permissions to post logs. It is strongly recommended you create a separate IAM user with permissions to only operate on this Bucket. This key will be not be encrypted. You can provide this key via an environment variable, FASTLY_S3_ACCESS_KEY.

  • s3SecretKey (pulumi.Input[str]) - AWS Secret Key of an account with the required permissions to post logs. It is strongly recommended you create a separate IAM user with permissions to only operate on this Bucket. This secret will be not be encrypted. You can provide this secret via an environment variable, FASTLY_S3_SECRET_KEY.

  • serverSideEncryption (pulumi.Input[str])

  • serverSideEncryptionKmsKeyId (pulumi.Input[str])

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

The snippets object supports the following:

  • content (pulumi.Input[str]) - The custom VCL code to upload.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The splunks object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

The sumologics object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

The syslogs object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

  • useTls (pulumi.Input[bool]) - Whether to use TLS for secure logging. Can be either true or false.

The vcls object supports the following:

  • content (pulumi.Input[str]) - The custom VCL code to upload.

  • main (pulumi.Input[bool]) - If true, use this block as the main configuration. If false, use this block as an includable library. Only a single VCL block can be marked as the main block. Default is false.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

acls: pulumi.Output[list] = None

A set of ACL configuration blocks. Defined below.

  • acl_id (str) - The ID of the ACL.

  • name (str) - A unique name to identify this dictionary.

activate: pulumi.Output[bool] = None

Conditionally prevents the Service from being activated. The apply step will continue to create a new draft version but will not activate it if this is set to false. Default true.

active_version: pulumi.Output[float] = None

The currently active version of your Fastly Service.

backends: pulumi.Output[list] = None

A set of Backends to service requests from your Domains. Defined below. Backends must be defined in this argument, or defined in the vcl argument below

  • address (str) - The SFTP address to stream logs to.

  • autoLoadbalance (bool) - Denotes if this Backend should be included in the pool of backends that requests are load balanced against. Default true.

  • betweenBytesTimeout (float) - How long to wait between bytes in milliseconds. Default 10000.

  • connectTimeout (float) - How long to wait for a timeout in milliseconds. Default 1000

  • errorThreshold (float) - Number of errors to allow before the Backend is marked as down. Default 0.

  • firstByteTimeout (float) - How long to wait for the first bytes in milliseconds. Default 15000.

  • healthcheck (str) - Name of a defined healthcheck to assign to this backend.

  • maxConn (float) - Maximum number of connections for this Backend. Default 200.

  • maxTlsVersion (str) - Maximum allowed TLS version on SSL connections to this backend.

  • minTlsVersion (str) - Minimum allowed TLS version on SSL connections to this backend.

  • name (str) - A unique name to identify this dictionary.

  • overrideHost (str) - The hostname to override the Host header.

  • port (float) - The port the SFTP service listens on. (Default: 22).

  • requestCondition (str) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • shield (str) - Selected POP to serve as a “shield” for backends. Valid values for shield are included in the ``GET /datacenters` <https://developer.fastly.com/reference/api/utils/datacenter/>`_ API response.

  • sslCaCert (str) - CA certificate attached to origin.

  • sslCertHostname (str) - Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.

  • sslCheckCert (bool) - Be strict about checking SSL certs. Default true.

  • sslCiphers (str) - Comma separated list of OpenSSL Ciphers to try when negotiating to the backend.

  • sslClientCert (str) - Client certificate attached to origin. Used when connecting to the backend.

  • sslClientKey (str) - Client key attached to origin. Used when connecting to the backend.

  • sslHostname (str) - Used for both SNI during the TLS handshake and to validate the cert.

  • sslSniHostname (str) - Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.

  • useSsl (bool) - Whether or not to use SSL to reach the backend. Default false.

  • weight (float) - The portion of traffic to send to this Backend. Each Backend receives weight / total of the traffic. Default 100.

bigqueryloggings: pulumi.Output[list] = None

A BigQuery endpoint to send streaming logs too. Defined below.

  • dataset (str) - The ID of your BigQuery dataset.

  • email (str) - The email for the service account with write access to your BigQuery dataset. If not provided, this will be pulled from a FASTLY_BQ_EMAIL environment variable.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • projectId (str) - The ID of your Google Cloud Platform project.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • secretKey (str) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • table (str) - The ID of your BigQuery table.

  • template (str) - Big query table name suffix template. If set will be interpreted as a strftime compatible string and used as the Template Suffix for your table.

blobstorageloggings: pulumi.Output[list] = None

An Azure Blob Storage endpoint to send streaming logs too. Defined below.

  • accountName (str) - The unique Azure Blob Storage namespace in which your data objects are stored.

  • container (str) - The name of the Azure Blob Storage container in which to store logs.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (float) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (str) - A unique name to identify this dictionary.

  • path (str) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (float) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • publicKey (str) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • sasToken (str) - The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work.

  • timestampFormat (str) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

cache_settings: pulumi.Output[list] = None

A set of Cache Settings, allowing you to override

  • action (str) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • cacheCondition (str) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • name (str) - A unique name to identify this dictionary.

  • staleTtl (float) - Max “Time To Live” for stale (unreachable) objects.

  • ttl (float) - The Time-To-Live (TTL) for the object.

cloned_version: pulumi.Output[float] = None

The latest cloned version by the provider. The value gets only set after running pulumi up.

comment: pulumi.Output[str] = None

An optional comment about the Director.

conditions: pulumi.Output[list] = None

A set of conditions to add logic to any basic configuration object in this service. Defined below.

  • name (str) - A unique name to identify this dictionary.

  • priority (float) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • statement (str) - The statement used to determine if the condition is met.

  • type (str) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

default_host: pulumi.Output[str] = None

Sets the host header.

default_ttl: pulumi.Output[float] = None

The default Time-to-live (TTL) for requests.

dictionaries: pulumi.Output[list] = None

A set of dictionaries that allow the storing of key values pair for use within VCL functions. Defined below.

  • dictionary_id (str) - The ID of the dictionary.

  • name (str) - A unique name to identify this dictionary.

  • writeOnly (bool) - If true, the dictionary is a private dictionary, and items are not readable in the UI or via API. Default is false. It is important to note that changing this attribute will delete and recreate the dictionary, discard the current items in the dictionary. Using a write-only/private dictionary should only be done if the items are managed outside of the provider.

directors: pulumi.Output[list] = None

A director to allow more control over balancing traffic over backends. when an item is not to be cached based on an above condition. Defined below

  • backends (list) - Names of defined backends to map the director to. Example: [ "origin1", "origin2" ]

  • capacity (float) - Load balancing weight for the backends. Default 100.

  • comment (str) - An optional comment about the Director.

  • name (str) - A unique name to identify this dictionary.

  • quorum (float) - Percentage of capacity that needs to be up for the director itself to be considered up. Default 75.

  • retries (float) - How many backends to search if it fails. Default 5.

  • shield (str) - Selected POP to serve as a “shield” for backends. Valid values for shield are included in the ``GET /datacenters` <https://developer.fastly.com/reference/api/utils/datacenter/>`_ API response.

  • type (float) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

domains: pulumi.Output[list] = None

If you created the S3 bucket outside of us-east-1, then specify the corresponding bucket endpoint. Example: s3-us-west-2.amazonaws.com.

  • comment (str) - An optional comment about the Director.

  • name (str) - A unique name to identify this dictionary.

dynamicsnippets: pulumi.Output[list] = None

A set of custom, “dynamic” VCL Snippet configuration blocks. Defined below.

  • name (str) - A unique name to identify this dictionary.

  • priority (float) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • snippet_id (str) - The ID of the dynamic snippet.

  • type (str) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

force_destroy: pulumi.Output[bool] = None

Services that are active cannot be destroyed. In order to destroy the Service, set force_destroy to true. Default false.

gcsloggings: pulumi.Output[list] = None

A gcs endpoint to send streaming logs too. Defined below.

  • bucketName (str) - The name of the bucket in which to store the logs.

  • email (str) - The email for the service account with write access to your BigQuery dataset. If not provided, this will be pulled from a FASTLY_BQ_EMAIL environment variable.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • gzipLevel (float) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (str) - A unique name to identify this dictionary.

  • path (str) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (float) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • secretKey (str) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • timestampFormat (str) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

gzips: pulumi.Output[list] = None

A set of gzip rules to control automatic gzipping of content. Defined below.

  • cacheCondition (str) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • contentTypes (list) - The content-type for each type of content you wish to have dynamically gzip’ed. Example: ["text/html", "text/css"].

  • extensions (list) - File extensions for each file type to dynamically gzip. Example: ["css", "js"].

  • name (str) - A unique name to identify this dictionary.

headers: pulumi.Output[list] = None

A set of Headers to manipulate for each request. Defined below.

  • action (str) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • cacheCondition (str) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • destination (str) - The name of the header that is going to be affected by the Action.

  • ignoreIfSet (bool) - Do not add the header if it is already present. (Only applies to the set action.). Default false.

  • name (str) - A unique name to identify this dictionary.

  • priority (float) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • regex (str) - Regular expression to use (Only applies to the regex and regex_repeat actions.)

  • requestCondition (str) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • source (str) - Variable to be used as a source for the header content. (Does not apply to the delete action.)

  • substitution (str) - Value to substitute in place of regular expression. (Only applies to the regex and regex_repeat actions.)

  • type (str) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

healthchecks: pulumi.Output[list] = None

Name of a defined healthcheck to assign to this backend.

  • checkInterval (float) - How often to run the Healthcheck in milliseconds. Default 5000.

  • expectedResponse (float) - The status code expected from the host. Default 200.

  • host (str) - The Host header to send for this Healthcheck.

  • httpVersion (str) - Whether to use version 1.0 or 1.1 HTTP. Default 1.1.

  • initial (float) - When loading a config, the initial number of probes to be seen as OK. Default 2.

  • method (str) - HTTP method used for request. Can be either POST or PUT. Default POST.

  • name (str) - A unique name to identify this dictionary.

  • path (str) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • threshold (float) - How many Healthchecks must succeed to be considered healthy. Default 3.

  • timeout (float) - Timeout in milliseconds. Default 500.

  • window (float) - The number of most recent Healthcheck queries to keep for this Healthcheck. Default 5.

httpsloggings: pulumi.Output[list] = None

An HTTPS endpoint to send streaming logs to. Defined below.

  • contentType (str) - The MIME type of the content.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • headerName (str) - Custom header sent with the request.

  • headerValue (str) - Value of the custom header sent with the request.

  • jsonFormat (str) - Formats log entries as JSON. Can be either disabled (0), array of json (1), or newline delimited json (2).

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • method (str) - HTTP method used for request. Can be either POST or PUT. Default POST.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requestMaxBytes (float) - The maximum number of bytes sent in one request. Defaults to 0 for unbounded.

  • requestMaxEntries (float) - The maximum number of logs sent in one request. Defaults to 0 for unbounded.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (str) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (str) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (str) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (str) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • url (str) - The Elasticsearch URL to stream logs to.

logentries: pulumi.Output[list] = None

A logentries endpoint to send streaming logs too. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (float) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

  • useTls (bool) - Whether to use TLS for secure logging. Can be either true or false.

logging_datadogs: pulumi.Output[list] = None

A Datadog endpoint to send streaming logs to. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • region (str) - The region that log data will be sent to. One of US or EU. Defaults to US if undefined.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

logging_elasticsearches: pulumi.Output[list] = None

An Elasticsearch endpoint to send streaming logs to. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • index (str) - The name of the Elasticsearch index to send documents (logs) to.

  • name (str) - A unique name to identify this dictionary.

  • password (str) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • pipeline (str) - The ID of the Elasticsearch ingest pipeline to apply pre-process transformations to before indexing.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requestMaxBytes (float) - The maximum number of bytes sent in one request. Defaults to 0 for unbounded.

  • requestMaxEntries (float) - The maximum number of logs sent in one request. Defaults to 0 for unbounded.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (str) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (str) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (str) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (str) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • url (str) - The Elasticsearch URL to stream logs to.

  • user (str) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

logging_ftps: pulumi.Output[list] = None

An FTP endpoint to send streaming logs to. Defined below.

  • address (str) - The SFTP address to stream logs to.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (float) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • name (str) - A unique name to identify this dictionary.

  • password (str) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • path (str) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (float) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (float) - The port the SFTP service listens on. (Default: 22).

  • publicKey (str) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • timestampFormat (str) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

  • user (str) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

logging_googlepubsubs: pulumi.Output[list] = None

A Google Cloud Pub/Sub endpoint to send streaming logs to. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • projectId (str) - The ID of your Google Cloud Platform project.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • secretKey (str) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • topic (str) - The Kafka topic to send logs to.

  • user (str) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

logging_kafkas: pulumi.Output[list] = None

A Kafka endpoint to send streaming logs to. Defined below.

  • brokers (str) - A comma-separated list of IP addresses or hostnames of Kafka brokers.

  • compressionCodec (str) - The codec used for compression of your logs. One of: gzip, snappy, lz4.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requiredAcks (str) - The Number of acknowledgements a leader must receive before a write is considered successful. One of: 1 (default) One server needs to respond. 0 No servers need to respond. -1 Wait for all in-sync replicas to respond.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (str) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (str) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (str) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (str) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • topic (str) - The Kafka topic to send logs to.

  • useTls (bool) - Whether to use TLS for secure logging. Can be either true or false.

logging_logglies: pulumi.Output[list] = None

A Loggly endpoint to send streaming logs to. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

logging_newrelics: pulumi.Output[list] = None

A New Relic endpoint to send streaming logs to. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

logging_scalyrs: pulumi.Output[list] = None

A Scalyr endpoint to send streaming logs to. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • region (str) - The region that log data will be sent to. One of US or EU. Defaults to US if undefined.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

logging_sftps: pulumi.Output[list] = None

An SFTP endpoint to send streaming logs to. Defined below.

  • address (str) - The SFTP address to stream logs to.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (float) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (str) - A unique name to identify this dictionary.

  • password (str) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • path (str) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (float) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (float) - The port the SFTP service listens on. (Default: 22).

  • publicKey (str) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • secretKey (str) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • sshKnownHosts (str) - A list of host keys for all hosts we can connect to over SFTP.

  • timestampFormat (str) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

  • user (str) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

name: pulumi.Output[str] = None

A unique name to identify this dictionary.

papertrails: pulumi.Output[list] = None

A Papertrail endpoint to send streaming logs too. Defined below.

  • address (str) - The SFTP address to stream logs to.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (float) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

request_settings: pulumi.Output[list] = None

A set of Request modifiers. Defined below

  • action (str) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • bypassBusyWait (bool) - Disable collapsed forwarding, so you don’t wait for other objects to origin.

  • default_host (str) - Sets the host header.

  • forceMiss (bool) - Force a cache miss for the request. If specified, can be true or false.

  • forceSsl (bool) - Forces the request to use SSL (Redirects a non-SSL request to SSL).

  • geoHeaders (bool) - Injects Fastly-Geo-Country, Fastly-Geo-City, and Fastly-Geo-Region into the request headers.

  • hashKeys (str) - Comma separated list of varnish request object fields that should be in the hash key.

  • maxStaleAge (float) - How old an object is allowed to be to serve stale-if-error or stale-while-revalidate, in seconds.

  • name (str) - A unique name to identify this dictionary.

  • requestCondition (str) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • timerSupport (bool) - Injects the X-Timer info into the request for viewing origin fetch durations.

  • xff (str) - X-Forwarded-For, should be clear, leave, append, append_all, or overwrite. Default append.

response_objects: pulumi.Output[list] = None

Allows you to create synthetic responses that exist entirely on the varnish machine. Useful for creating error or maintenance pages that exists outside the scope of your datacenter. Best when used with Condition objects.

  • cacheCondition (str) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • content (str) - The custom VCL code to upload.

  • contentType (str) - The MIME type of the content.

  • name (str) - A unique name to identify this dictionary.

  • requestCondition (str) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • response (str) - The HTTP Response. Default Ok.

  • status (float) - The HTTP Status Code. Default 200.

s3loggings: pulumi.Output[list] = None

A set of S3 Buckets to send streaming logs too. Defined below.

  • bucketName (str) - The name of the bucket in which to store the logs.

  • domain (str) - If you created the S3 bucket outside of us-east-1, then specify the corresponding bucket endpoint. Example: s3-us-west-2.amazonaws.com.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (float) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (str) - A unique name to identify this dictionary.

  • path (str) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (float) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • publicKey (str) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • redundancy (str) - The S3 redundancy level. Should be formatted; one of: standard, reduced_redundancy or null. Default null.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • s3AccessKey (str) - AWS Access Key of an account with the required permissions to post logs. It is strongly recommended you create a separate IAM user with permissions to only operate on this Bucket. This key will be not be encrypted. You can provide this key via an environment variable, FASTLY_S3_ACCESS_KEY.

  • s3SecretKey (str) - AWS Secret Key of an account with the required permissions to post logs. It is strongly recommended you create a separate IAM user with permissions to only operate on this Bucket. This secret will be not be encrypted. You can provide this secret via an environment variable, FASTLY_S3_SECRET_KEY.

  • serverSideEncryption (str)

  • serverSideEncryptionKmsKeyId (str)

  • timestampFormat (str) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

snippets: pulumi.Output[list] = None

A set of custom, “regular” (non-dynamic) VCL Snippet configuration blocks. Defined below.

  • content (str) - The custom VCL code to upload.

  • name (str) - A unique name to identify this dictionary.

  • priority (float) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • type (str) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

splunks: pulumi.Output[list] = None

A Splunk endpoint to send streaming logs too. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (str) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsHostname (str) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

  • url (str) - The Elasticsearch URL to stream logs to.

sumologics: pulumi.Output[list] = None

A Sumologic endpoint to send streaming logs too. Defined below.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • url (str) - The Elasticsearch URL to stream logs to.

syslogs: pulumi.Output[list] = None

A syslog endpoint to send streaming logs too. Defined below.

  • address (str) - The SFTP address to stream logs to.

  • format (str) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (float) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • messageType (str) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (str) - A unique name to identify this dictionary.

  • placement (str) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (float) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (str) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (str) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (str) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (str) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (str) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • token (str) - The token to use for authentication (https://www.scalyr.com/keys).

  • useTls (bool) - Whether to use TLS for secure logging. Can be either true or false.

vcls: pulumi.Output[list] = None

A set of custom VCL configuration blocks. See the Fastly documentation for more information on using custom VCL.

  • content (str) - The custom VCL code to upload.

  • main (bool) - If true, use this block as the main configuration. If false, use this block as an includable library. Only a single VCL block can be marked as the main block. Default is false.

  • name (str) - A unique name to identify this dictionary.

version_comment: pulumi.Output[str] = None

Description field for the version.

static get(resource_name, id, opts=None, acls=None, activate=None, active_version=None, backends=None, bigqueryloggings=None, blobstorageloggings=None, cache_settings=None, cloned_version=None, comment=None, conditions=None, default_host=None, default_ttl=None, dictionaries=None, directors=None, domains=None, dynamicsnippets=None, force_destroy=None, gcsloggings=None, gzips=None, headers=None, healthchecks=None, httpsloggings=None, logentries=None, logging_datadogs=None, logging_elasticsearches=None, logging_ftps=None, logging_googlepubsubs=None, logging_kafkas=None, logging_logglies=None, logging_newrelics=None, logging_scalyrs=None, logging_sftps=None, name=None, papertrails=None, request_settings=None, response_objects=None, s3loggings=None, snippets=None, splunks=None, sumologics=None, syslogs=None, vcls=None, version_comment=None)

Get an existing Servicev1 resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • acls (pulumi.Input[list]) – A set of ACL configuration blocks. Defined below.

  • activate (pulumi.Input[bool]) – Conditionally prevents the Service from being activated. The apply step will continue to create a new draft version but will not activate it if this is set to false. Default true.

  • active_version (pulumi.Input[float]) – The currently active version of your Fastly Service.

  • backends (pulumi.Input[list]) – A set of Backends to service requests from your Domains. Defined below. Backends must be defined in this argument, or defined in the vcl argument below

  • bigqueryloggings (pulumi.Input[list]) – A BigQuery endpoint to send streaming logs too. Defined below.

  • blobstorageloggings (pulumi.Input[list]) – An Azure Blob Storage endpoint to send streaming logs too. Defined below.

  • cache_settings (pulumi.Input[list]) – A set of Cache Settings, allowing you to override

  • cloned_version (pulumi.Input[float]) – The latest cloned version by the provider. The value gets only set after running pulumi up.

  • comment (pulumi.Input[str]) – An optional comment about the Director.

  • conditions (pulumi.Input[list]) – A set of conditions to add logic to any basic configuration object in this service. Defined below.

  • default_host (pulumi.Input[str]) – Sets the host header.

  • default_ttl (pulumi.Input[float]) – The default Time-to-live (TTL) for requests.

  • dictionaries (pulumi.Input[list]) – A set of dictionaries that allow the storing of key values pair for use within VCL functions. Defined below.

  • directors (pulumi.Input[list]) – A director to allow more control over balancing traffic over backends. when an item is not to be cached based on an above condition. Defined below

  • domains (pulumi.Input[list]) – If you created the S3 bucket outside of us-east-1, then specify the corresponding bucket endpoint. Example: s3-us-west-2.amazonaws.com.

  • dynamicsnippets (pulumi.Input[list]) – A set of custom, “dynamic” VCL Snippet configuration blocks. Defined below.

  • force_destroy (pulumi.Input[bool]) – Services that are active cannot be destroyed. In order to destroy the Service, set force_destroy to true. Default false.

  • gcsloggings (pulumi.Input[list]) – A gcs endpoint to send streaming logs too. Defined below.

  • gzips (pulumi.Input[list]) – A set of gzip rules to control automatic gzipping of content. Defined below.

  • headers (pulumi.Input[list]) – A set of Headers to manipulate for each request. Defined below.

  • healthchecks (pulumi.Input[list]) – Name of a defined healthcheck to assign to this backend.

  • httpsloggings (pulumi.Input[list]) – An HTTPS endpoint to send streaming logs to. Defined below.

  • logentries (pulumi.Input[list]) – A logentries endpoint to send streaming logs too. Defined below.

  • logging_datadogs (pulumi.Input[list]) – A Datadog endpoint to send streaming logs to. Defined below.

  • logging_elasticsearches (pulumi.Input[list]) – An Elasticsearch endpoint to send streaming logs to. Defined below.

  • logging_ftps (pulumi.Input[list]) – An FTP endpoint to send streaming logs to. Defined below.

  • logging_googlepubsubs (pulumi.Input[list]) – A Google Cloud Pub/Sub endpoint to send streaming logs to. Defined below.

  • logging_kafkas (pulumi.Input[list]) – A Kafka endpoint to send streaming logs to. Defined below.

  • logging_logglies (pulumi.Input[list]) – A Loggly endpoint to send streaming logs to. Defined below.

  • logging_newrelics (pulumi.Input[list]) – A New Relic endpoint to send streaming logs to. Defined below.

  • logging_scalyrs (pulumi.Input[list]) – A Scalyr endpoint to send streaming logs to. Defined below.

  • logging_sftps (pulumi.Input[list]) – An SFTP endpoint to send streaming logs to. Defined below.

  • name (pulumi.Input[str]) – A unique name to identify this dictionary.

  • papertrails (pulumi.Input[list]) – A Papertrail endpoint to send streaming logs too. Defined below.

  • request_settings (pulumi.Input[list]) – A set of Request modifiers. Defined below

  • response_objects (pulumi.Input[list]) – Allows you to create synthetic responses that exist entirely on the varnish machine. Useful for creating error or maintenance pages that exists outside the scope of your datacenter. Best when used with Condition objects.

  • s3loggings (pulumi.Input[list]) – A set of S3 Buckets to send streaming logs too. Defined below.

  • snippets (pulumi.Input[list]) – A set of custom, “regular” (non-dynamic) VCL Snippet configuration blocks. Defined below.

  • splunks (pulumi.Input[list]) – A Splunk endpoint to send streaming logs too. Defined below.

  • sumologics (pulumi.Input[list]) – A Sumologic endpoint to send streaming logs too. Defined below.

  • syslogs (pulumi.Input[list]) – A syslog endpoint to send streaming logs too. Defined below.

  • vcls (pulumi.Input[list]) –

    A set of custom VCL configuration blocks. See the Fastly documentation for more information on using custom VCL.

  • version_comment (pulumi.Input[str]) – Description field for the version.

The acls object supports the following:

  • acl_id (pulumi.Input[str]) - The ID of the ACL.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

The backends object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • autoLoadbalance (pulumi.Input[bool]) - Denotes if this Backend should be included in the pool of backends that requests are load balanced against. Default true.

  • betweenBytesTimeout (pulumi.Input[float]) - How long to wait between bytes in milliseconds. Default 10000.

  • connectTimeout (pulumi.Input[float]) - How long to wait for a timeout in milliseconds. Default 1000

  • errorThreshold (pulumi.Input[float]) - Number of errors to allow before the Backend is marked as down. Default 0.

  • firstByteTimeout (pulumi.Input[float]) - How long to wait for the first bytes in milliseconds. Default 15000.

  • healthcheck (pulumi.Input[str]) - Name of a defined healthcheck to assign to this backend.

  • maxConn (pulumi.Input[float]) - Maximum number of connections for this Backend. Default 200.

  • maxTlsVersion (pulumi.Input[str]) - Maximum allowed TLS version on SSL connections to this backend.

  • minTlsVersion (pulumi.Input[str]) - Minimum allowed TLS version on SSL connections to this backend.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • overrideHost (pulumi.Input[str]) - The hostname to override the Host header.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • shield (pulumi.Input[str]) - Selected POP to serve as a “shield” for backends. Valid values for shield are included in the ``GET /datacenters` <https://developer.fastly.com/reference/api/utils/datacenter/>`_ API response.

  • sslCaCert (pulumi.Input[str]) - CA certificate attached to origin.

  • sslCertHostname (pulumi.Input[str]) - Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.

  • sslCheckCert (pulumi.Input[bool]) - Be strict about checking SSL certs. Default true.

  • sslCiphers (pulumi.Input[str]) - Comma separated list of OpenSSL Ciphers to try when negotiating to the backend.

  • sslClientCert (pulumi.Input[str]) - Client certificate attached to origin. Used when connecting to the backend.

  • sslClientKey (pulumi.Input[str]) - Client key attached to origin. Used when connecting to the backend.

  • sslHostname (pulumi.Input[str]) - Used for both SNI during the TLS handshake and to validate the cert.

  • sslSniHostname (pulumi.Input[str]) - Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.

  • useSsl (pulumi.Input[bool]) - Whether or not to use SSL to reach the backend. Default false.

  • weight (pulumi.Input[float]) - The portion of traffic to send to this Backend. Each Backend receives weight / total of the traffic. Default 100.

The bigqueryloggings object supports the following:

  • dataset (pulumi.Input[str]) - The ID of your BigQuery dataset.

  • email (pulumi.Input[str]) - The email for the service account with write access to your BigQuery dataset. If not provided, this will be pulled from a FASTLY_BQ_EMAIL environment variable.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • projectId (pulumi.Input[str]) - The ID of your Google Cloud Platform project.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • table (pulumi.Input[str]) - The ID of your BigQuery table.

  • template (pulumi.Input[str]) - Big query table name suffix template. If set will be interpreted as a strftime compatible string and used as the Template Suffix for your table.

The blobstorageloggings object supports the following:

  • accountName (pulumi.Input[str]) - The unique Azure Blob Storage namespace in which your data objects are stored.

  • container (pulumi.Input[str]) - The name of the Azure Blob Storage container in which to store logs.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • sasToken (pulumi.Input[str]) - The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

The cache_settings object supports the following:

  • action (pulumi.Input[str]) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • staleTtl (pulumi.Input[float]) - Max “Time To Live” for stale (unreachable) objects.

  • ttl (pulumi.Input[float]) - The Time-To-Live (TTL) for the object.

The conditions object supports the following:

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • statement (pulumi.Input[str]) - The statement used to determine if the condition is met.

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The dictionaries object supports the following:

  • dictionary_id (pulumi.Input[str]) - The ID of the dictionary.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • writeOnly (pulumi.Input[bool]) - If true, the dictionary is a private dictionary, and items are not readable in the UI or via API. Default is false. It is important to note that changing this attribute will delete and recreate the dictionary, discard the current items in the dictionary. Using a write-only/private dictionary should only be done if the items are managed outside of the provider.

The directors object supports the following:

  • backends (pulumi.Input[list]) - Names of defined backends to map the director to. Example: [ "origin1", "origin2" ]

  • capacity (pulumi.Input[float]) - Load balancing weight for the backends. Default 100.

  • comment (pulumi.Input[str]) - An optional comment about the Director.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • quorum (pulumi.Input[float]) - Percentage of capacity that needs to be up for the director itself to be considered up. Default 75.

  • retries (pulumi.Input[float]) - How many backends to search if it fails. Default 5.

  • shield (pulumi.Input[str]) - Selected POP to serve as a “shield” for backends. Valid values for shield are included in the ``GET /datacenters` <https://developer.fastly.com/reference/api/utils/datacenter/>`_ API response.

  • type (pulumi.Input[float]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The domains object supports the following:

  • comment (pulumi.Input[str]) - An optional comment about the Director.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

The dynamicsnippets object supports the following:

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • snippet_id (pulumi.Input[str]) - The ID of the dynamic snippet.

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The gcsloggings object supports the following:

  • bucketName (pulumi.Input[str]) - The name of the bucket in which to store the logs.

  • email (pulumi.Input[str]) - The email for the service account with write access to your BigQuery dataset. If not provided, this will be pulled from a FASTLY_BQ_EMAIL environment variable.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

The gzips object supports the following:

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • contentTypes (pulumi.Input[list]) - The content-type for each type of content you wish to have dynamically gzip’ed. Example: ["text/html", "text/css"].

  • extensions (pulumi.Input[list]) - File extensions for each file type to dynamically gzip. Example: ["css", "js"].

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

The headers object supports the following:

  • action (pulumi.Input[str]) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • destination (pulumi.Input[str]) - The name of the header that is going to be affected by the Action.

  • ignoreIfSet (pulumi.Input[bool]) - Do not add the header if it is already present. (Only applies to the set action.). Default false.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • regex (pulumi.Input[str]) - Regular expression to use (Only applies to the regex and regex_repeat actions.)

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • source (pulumi.Input[str]) - Variable to be used as a source for the header content. (Does not apply to the delete action.)

  • substitution (pulumi.Input[str]) - Value to substitute in place of regular expression. (Only applies to the regex and regex_repeat actions.)

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The healthchecks object supports the following:

  • checkInterval (pulumi.Input[float]) - How often to run the Healthcheck in milliseconds. Default 5000.

  • expectedResponse (pulumi.Input[float]) - The status code expected from the host. Default 200.

  • host (pulumi.Input[str]) - The Host header to send for this Healthcheck.

  • httpVersion (pulumi.Input[str]) - Whether to use version 1.0 or 1.1 HTTP. Default 1.1.

  • initial (pulumi.Input[float]) - When loading a config, the initial number of probes to be seen as OK. Default 2.

  • method (pulumi.Input[str]) - HTTP method used for request. Can be either POST or PUT. Default POST.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • threshold (pulumi.Input[float]) - How many Healthchecks must succeed to be considered healthy. Default 3.

  • timeout (pulumi.Input[float]) - Timeout in milliseconds. Default 500.

  • window (pulumi.Input[float]) - The number of most recent Healthcheck queries to keep for this Healthcheck. Default 5.

The httpsloggings object supports the following:

  • contentType (pulumi.Input[str]) - The MIME type of the content.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • headerName (pulumi.Input[str]) - Custom header sent with the request.

  • headerValue (pulumi.Input[str]) - Value of the custom header sent with the request.

  • jsonFormat (pulumi.Input[str]) - Formats log entries as JSON. Can be either disabled (0), array of json (1), or newline delimited json (2).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • method (pulumi.Input[str]) - HTTP method used for request. Can be either POST or PUT. Default POST.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requestMaxBytes (pulumi.Input[float]) - The maximum number of bytes sent in one request. Defaults to 0 for unbounded.

  • requestMaxEntries (pulumi.Input[float]) - The maximum number of logs sent in one request. Defaults to 0 for unbounded.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

The logentries object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

  • useTls (pulumi.Input[bool]) - Whether to use TLS for secure logging. Can be either true or false.

The logging_datadogs object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • region (pulumi.Input[str]) - The region that log data will be sent to. One of US or EU. Defaults to US if undefined.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_elasticsearches object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • index (pulumi.Input[str]) - The name of the Elasticsearch index to send documents (logs) to.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • password (pulumi.Input[str]) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • pipeline (pulumi.Input[str]) - The ID of the Elasticsearch ingest pipeline to apply pre-process transformations to before indexing.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requestMaxBytes (pulumi.Input[float]) - The maximum number of bytes sent in one request. Defaults to 0 for unbounded.

  • requestMaxEntries (pulumi.Input[float]) - The maximum number of logs sent in one request. Defaults to 0 for unbounded.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The logging_ftps object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • password (pulumi.Input[str]) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The logging_googlepubsubs object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • projectId (pulumi.Input[str]) - The ID of your Google Cloud Platform project.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • topic (pulumi.Input[str]) - The Kafka topic to send logs to.

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The logging_kafkas object supports the following:

  • brokers (pulumi.Input[str]) - A comma-separated list of IP addresses or hostnames of Kafka brokers.

  • compressionCodec (pulumi.Input[str]) - The codec used for compression of your logs. One of: gzip, snappy, lz4.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • requiredAcks (pulumi.Input[str]) - The Number of acknowledgements a leader must receive before a write is considered successful. One of: 1 (default) One server needs to respond. 0 No servers need to respond. -1 Wait for all in-sync replicas to respond.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • topic (pulumi.Input[str]) - The Kafka topic to send logs to.

  • useTls (pulumi.Input[bool]) - Whether to use TLS for secure logging. Can be either true or false.

The logging_logglies object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_newrelics object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_scalyrs object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • region (pulumi.Input[str]) - The region that log data will be sent to. One of US or EU. Defaults to US if undefined.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

The logging_sftps object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • password (pulumi.Input[str]) - The password for the server. If both password and secret_key are passed, secret_key will be preferred.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • secretKey (pulumi.Input[str]) - Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.

  • sshKnownHosts (pulumi.Input[str]) - A list of host keys for all hosts we can connect to over SFTP.

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

  • user (pulumi.Input[str]) - Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.

The papertrails object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

The request_settings object supports the following:

  • action (pulumi.Input[str]) - Allows you to terminate request handling and immediately perform an action. When set it can be lookup or pass (Ignore the cache completely).

  • bypassBusyWait (pulumi.Input[bool]) - Disable collapsed forwarding, so you don’t wait for other objects to origin.

  • default_host (pulumi.Input[str]) - Sets the host header.

  • forceMiss (pulumi.Input[bool]) - Force a cache miss for the request. If specified, can be true or false.

  • forceSsl (pulumi.Input[bool]) - Forces the request to use SSL (Redirects a non-SSL request to SSL).

  • geoHeaders (pulumi.Input[bool]) - Injects Fastly-Geo-Country, Fastly-Geo-City, and Fastly-Geo-Region into the request headers.

  • hashKeys (pulumi.Input[str]) - Comma separated list of varnish request object fields that should be in the hash key.

  • maxStaleAge (pulumi.Input[float]) - How old an object is allowed to be to serve stale-if-error or stale-while-revalidate, in seconds.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • timerSupport (pulumi.Input[bool]) - Injects the X-Timer info into the request for viewing origin fetch durations.

  • xff (pulumi.Input[str]) - X-Forwarded-For, should be clear, leave, append, append_all, or overwrite. Default append.

The response_objects object supports the following:

  • cacheCondition (pulumi.Input[str]) - Name of already defined condition to check after we have retrieved an object. If the condition passes then deliver this Request Object instead. This condition must be of type CACHE. For detailed information about Conditionals, see [Fastly’s Documentation on Conditionals][fastly-conditionals].

  • content (pulumi.Input[str]) - The custom VCL code to upload.

  • contentType (pulumi.Input[str]) - The MIME type of the content.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • requestCondition (pulumi.Input[str]) - Name of already defined condition to be checked during the request phase. If the condition passes then this object will be delivered. This condition must be of type REQUEST.

  • response (pulumi.Input[str]) - The HTTP Response. Default Ok.

  • status (pulumi.Input[float]) - The HTTP Status Code. Default 200.

The s3loggings object supports the following:

  • bucketName (pulumi.Input[str]) - The name of the bucket in which to store the logs.

  • domain (pulumi.Input[str]) - If you created the S3 bucket outside of us-east-1, then specify the corresponding bucket endpoint. Example: s3-us-west-2.amazonaws.com.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • gzipLevel (pulumi.Input[float]) - What level of GZIP encoding to have when dumping logs (default 0, no compression).

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • path (pulumi.Input[str]) - The path to upload log files to. If the path ends in / then it is treated as a directory.

  • period (pulumi.Input[float]) - How frequently log files are finalized so they can be available for reading (in seconds, default 3600).

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • publicKey (pulumi.Input[str]) - A PGP public key that Fastly will use to encrypt your log files before writing them to disk.

  • redundancy (pulumi.Input[str]) - The S3 redundancy level. Should be formatted; one of: standard, reduced_redundancy or null. Default null.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • s3AccessKey (pulumi.Input[str]) - AWS Access Key of an account with the required permissions to post logs. It is strongly recommended you create a separate IAM user with permissions to only operate on this Bucket. This key will be not be encrypted. You can provide this key via an environment variable, FASTLY_S3_ACCESS_KEY.

  • s3SecretKey (pulumi.Input[str]) - AWS Secret Key of an account with the required permissions to post logs. It is strongly recommended you create a separate IAM user with permissions to only operate on this Bucket. This secret will be not be encrypted. You can provide this secret via an environment variable, FASTLY_S3_SECRET_KEY.

  • serverSideEncryption (pulumi.Input[str])

  • serverSideEncryptionKmsKeyId (pulumi.Input[str])

  • timestampFormat (pulumi.Input[str]) - The strftime specified timestamp formatting (default %Y-%m-%dT%H:%M:%S.000).

The snippets object supports the following:

  • content (pulumi.Input[str]) - The custom VCL code to upload.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • priority (pulumi.Input[float]) - Priority determines the ordering for multiple snippets. Lower numbers execute first. Defaults to 100.

  • type (pulumi.Input[str]) - The location in generated VCL where the snippet should be placed (can be one of init, recv, hit, miss, pass, fetch, error, deliver, log or none).

The splunks object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

The sumologics object supports the following:

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • url (pulumi.Input[str]) - The Elasticsearch URL to stream logs to.

The syslogs object supports the following:

  • address (pulumi.Input[str]) - The SFTP address to stream logs to.

  • format (pulumi.Input[str]) - Apache-style string or VCL variables to use for log formatting.

  • formatVersion (pulumi.Input[float]) - The version of the custom logging format used for the configured endpoint. Can be either 1 or 2. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1. Default 2.

  • messageType (pulumi.Input[str]) - How the message should be formatted. One of: classic (default), loggly, logplex or blank.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

  • placement (pulumi.Input[str]) - The name of an existing condition in the configured endpoint, or leave blank to always execute.

  • port (pulumi.Input[float]) - The port the SFTP service listens on. (Default: 22).

  • responseCondition (pulumi.Input[str]) - The name of the condition to apply. If empty, always execute.

  • tlsCaCert (pulumi.Input[str]) - A secure certificate to authenticate the server with. Must be in PEM format.

  • tlsClientCert (pulumi.Input[str]) - The client certificate used to make authenticated requests. Must be in PEM format.

  • tlsClientKey (pulumi.Input[str]) - The client private key used to make authenticated requests. Must be in PEM format.

  • tlsHostname (pulumi.Input[str]) - The hostname used to verify the server’s certificate. It can either be the Common Name or a Subject Alternative Name (SAN).

  • token (pulumi.Input[str]) - The token to use for authentication (https://www.scalyr.com/keys).

  • useTls (pulumi.Input[bool]) - Whether to use TLS for secure logging. Can be either true or false.

The vcls object supports the following:

  • content (pulumi.Input[str]) - The custom VCL code to upload.

  • main (pulumi.Input[bool]) - If true, use this block as the main configuration. If false, use this block as an includable library. Only a single VCL block can be marked as the main block. Default is false.

  • name (pulumi.Input[str]) - A unique name to identify this dictionary.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_fastly.Userv1(resource_name, opts=None, login=None, name=None, role=None, __props__=None, __name__=None, __opts__=None)

Provides a Fastly User, representing the configuration for a user account for interacting with Fastly.

The User resource requires a login and name, and optionally a role.

import pulumi
import pulumi_fastly as fastly

demo = fastly.Userv1("demo", login="demo@example.com")
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • login (pulumi.Input[str]) – The email address, which is the login name, of the User.

  • name (pulumi.Input[str]) – The real life name of the user.

  • role (pulumi.Input[str]) – The role of this user. Can be user (the default), billing, engineer, or superuser. For detailed information on the abilities granted to each role, see Fastly’s Documentation on User roles.

login: pulumi.Output[str] = None

The email address, which is the login name, of the User.

name: pulumi.Output[str] = None

The real life name of the user.

role: pulumi.Output[str] = None

The role of this user. Can be user (the default), billing, engineer, or superuser. For detailed information on the abilities granted to each role, see Fastly’s Documentation on User roles.

static get(resource_name, id, opts=None, login=None, name=None, role=None)

Get an existing Userv1 resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • login (pulumi.Input[str]) – The email address, which is the login name, of the User.

  • name (pulumi.Input[str]) – The real life name of the user.

  • role (pulumi.Input[str]) –

    The role of this user. Can be user (the default), billing, engineer, or superuser. For detailed information on the abilities granted to each role, see Fastly’s Documentation on User roles.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

pulumi_fastly.get_fastly_ip_ranges(opts=None)

Use this data source to get the IP ranges of Fastly edge nodes.

import pulumi
import pulumi_aws as aws
import pulumi_fastly as fastly

fastly = fastly.get_fastly_ip_ranges()
from_fastly = aws.ec2.SecurityGroup("fromFastly", ingress=[{
    "cidr_blocks": fastly.cidr_blocks,
    "from_port": "443",
    "ipv6_cidr_blocks": fastly.ipv6_cidr_blocks,
    "protocol": "tcp",
    "to_port": "443",
}])