Interface IOriginOptions

Options to define an Origin.

Namespace: Amazon.CDK.AWS.CloudFront

Assembly: Amazon.CDK.Lib.dll

Syntax (csharp)

public interface IOriginOptions

Syntax (vb)

Public Interface IOriginOptions

Remarks

ExampleMetadata: fixture=_generated

Examples

// The code below shows an example of how to instantiate this type.
            // The values are placeholders you should change.
            using Amazon.CDK;
            using Amazon.CDK.AWS.CloudFront;

            var originOptions = new OriginOptions {
                ConnectionAttempts = 123,
                ConnectionTimeout = Duration.Minutes(30),
                CustomHeaders = new Dictionary<string, string> {
                    { "customHeadersKey", "customHeaders" }
                },
                OriginAccessControlId = "originAccessControlId",
                OriginId = "originId",
                OriginShieldEnabled = false,
                OriginShieldRegion = "originShieldRegion"
            };

Synopsis

Properties

ConnectionAttempts	The number of times that CloudFront attempts to connect to the origin;
ConnectionTimeout	The number of seconds that CloudFront waits when trying to establish a connection to the origin.
CustomHeaders	A list of HTTP header names and values that CloudFront adds to requests it sends to the origin.
OriginAccessControlId	The unique identifier of an origin access control for this origin.
OriginId	A unique identifier for the origin.
OriginShieldEnabled	Origin Shield is enabled by setting originShieldRegion to a valid region, after this to disable Origin Shield again you must set this flag to false.
OriginShieldRegion	When you enable Origin Shield in the AWS Region that has the lowest latency to your origin, you can get better network performance.

Properties

ConnectionAttempts

The number of times that CloudFront attempts to connect to the origin;

double? ConnectionAttempts { get; }

Property Value

double?

Remarks

valid values are 1, 2, or 3 attempts.

Default: 3

ConnectionTimeout

The number of seconds that CloudFront waits when trying to establish a connection to the origin.

Duration? ConnectionTimeout { get; }

Property Value

Duration

Remarks

Valid values are 1-10 seconds, inclusive.

Default: Duration.seconds(10)

CustomHeaders

A list of HTTP header names and values that CloudFront adds to requests it sends to the origin.

IDictionary<string, string>? CustomHeaders { get; }

Property Value

IDictionary<string, string>

Remarks

Default: {}

OriginAccessControlId

The unique identifier of an origin access control for this origin.

string? OriginAccessControlId { get; }

Property Value

string

Remarks

Default: - no origin access control

OriginId

A unique identifier for the origin.

string? OriginId { get; }

Property Value

string

Remarks

This value must be unique within the distribution.

Default: - an originid will be generated for you

OriginShieldEnabled

Origin Shield is enabled by setting originShieldRegion to a valid region, after this to disable Origin Shield again you must set this flag to false.

bool? OriginShieldEnabled { get; }

Property Value

bool?

Remarks

Default: - true

OriginShieldRegion

When you enable Origin Shield in the AWS Region that has the lowest latency to your origin, you can get better network performance.

string? OriginShieldRegion { get; }

Property Value

string

Remarks

Default: - origin shield not enabled

See: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html