You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::CloudFront::Types::CustomOriginConfig

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing CustomOriginConfig as input to an Aws::Client method, you can use a vanilla Hash:

{
  http_port: 1, # required
  https_port: 1, # required
  origin_protocol_policy: "http-only", # required, accepts http-only, match-viewer, https-only
  origin_ssl_protocols: {
    quantity: 1, # required
    items: ["SSLv3"], # required, accepts SSLv3, TLSv1, TLSv1.1, TLSv1.2
  },
  origin_read_timeout: 1,
  origin_keepalive_timeout: 1,
}

A custom origin. A custom origin is any origin that is not an Amazon S3 bucket, with one exception. An Amazon S3 bucket that is configured with static website hosting is a custom origin.

Returned by:

Instance Attribute Summary collapse

Instance Attribute Details

#http_portInteger

The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.

Returns:

  • (Integer)

    The HTTP port that CloudFront uses to connect to the origin.

#https_portInteger

The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.

Returns:

  • (Integer)

    The HTTPS port that CloudFront uses to connect to the origin.

#origin_keepalive_timeoutInteger

Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 60 seconds, and the default (if you don’t specify otherwise) is 5 seconds.

For more information, see Origin Keep-alive Timeout in the Amazon CloudFront Developer Guide.

Returns:

  • (Integer)

    Specifies how long, in seconds, CloudFront persists its connection to the origin.

#origin_protocol_policyString

Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:

  • http-only – CloudFront always uses HTTP to connect to the origin.

  • match-viewer – CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.

  • https-only – CloudFront always uses HTTPS to connect to the origin.

    Possible values:

    • http-only
    • match-viewer
    • https-only

Returns:

  • (String)

    Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin.

#origin_read_timeoutInteger

Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 60 seconds, and the default (if you don’t specify otherwise) is 30 seconds.

For more information, see Origin Response Timeout in the Amazon CloudFront Developer Guide.

Returns:

  • (Integer)

    Specifies how long, in seconds, CloudFront waits for a response from the origin.

#origin_ssl_protocolsTypes::OriginSslProtocols

Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3, TLSv1, TLSv1.1, and TLSv1.2.

For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.

Returns:

  • (Types::OriginSslProtocols)

    Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS.