Interface Origin.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<Origin.Builder,
,Origin> SdkBuilder<Origin.Builder,
,Origin> SdkPojo
- Enclosing class:
Origin
-
Method Summary
Modifier and TypeMethodDescriptionconnectionAttempts
(Integer connectionAttempts) The number of times that CloudFront attempts to connect to the origin.connectionTimeout
(Integer connectionTimeout) The number of seconds that CloudFront waits when trying to establish a connection to the origin.default Origin.Builder
customHeaders
(Consumer<CustomHeaders.Builder> customHeaders) A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.customHeaders
(CustomHeaders customHeaders) A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.default Origin.Builder
customOriginConfig
(Consumer<CustomOriginConfig.Builder> customOriginConfig) Use this type to specify an origin that is not an Amazon S3 bucket, with one exception.customOriginConfig
(CustomOriginConfig customOriginConfig) Use this type to specify an origin that is not an Amazon S3 bucket, with one exception.domainName
(String domainName) The domain name for the origin.A unique identifier for the origin.originAccessControlId
(String originAccessControlId) The unique identifier of an origin access control for this origin.originPath
(String originPath) An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin.default Origin.Builder
originShield
(Consumer<OriginShield.Builder> originShield) CloudFront Origin Shield.originShield
(OriginShield originShield) CloudFront Origin Shield.default Origin.Builder
s3OriginConfig
(Consumer<S3OriginConfig.Builder> s3OriginConfig) Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting.s3OriginConfig
(S3OriginConfig s3OriginConfig) Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
id
A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the
TargetOriginId
in aCacheBehavior
orDefaultCacheBehavior
.- Parameters:
id
- A unique identifier for the origin. This value must be unique within the distribution.Use this value to specify the
TargetOriginId
in aCacheBehavior
orDefaultCacheBehavior
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
domainName
The domain name for the origin.
For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- Parameters:
domainName
- The domain name for the origin.For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
originPath
An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin.
For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- Parameters:
originPath
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin.For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customHeaders
A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.
For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- Parameters:
customHeaders
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customHeaders
A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.
For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
This is a convenience method that creates an instance of theCustomHeaders.Builder
avoiding the need to create one manually viaCustomHeaders.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocustomHeaders(CustomHeaders)
.- Parameters:
customHeaders
- a consumer that will call methods onCustomHeaders.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
s3OriginConfig
Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the
CustomOriginConfig
type instead.- Parameters:
s3OriginConfig
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use theCustomOriginConfig
type instead.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
s3OriginConfig
Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the
This is a convenience method that creates an instance of theCustomOriginConfig
type instead.S3OriginConfig.Builder
avoiding the need to create one manually viaS3OriginConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tos3OriginConfig(S3OriginConfig)
.- Parameters:
s3OriginConfig
- a consumer that will call methods onS3OriginConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
customOriginConfig
Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the
S3OriginConfig
type instead.- Parameters:
customOriginConfig
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use theS3OriginConfig
type instead.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customOriginConfig
Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the
This is a convenience method that creates an instance of theS3OriginConfig
type instead.CustomOriginConfig.Builder
avoiding the need to create one manually viaCustomOriginConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocustomOriginConfig(CustomOriginConfig)
.- Parameters:
customOriginConfig
- a consumer that will call methods onCustomOriginConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
connectionAttempts
The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3.
For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout.
For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- Parameters:
connectionAttempts
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3.For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout.
For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
connectionTimeout
The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds.
For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- Parameters:
connectionTimeout
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds.For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
originShield
CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin.
For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- Parameters:
originShield
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin.For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
originShield
CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin.
For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
This is a convenience method that creates an instance of theOriginShield.Builder
avoiding the need to create one manually viaOriginShield.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tooriginShield(OriginShield)
.- Parameters:
originShield
- a consumer that will call methods onOriginShield.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
originAccessControlId
The unique identifier of an origin access control for this origin.
For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- Parameters:
originAccessControlId
- The unique identifier of an origin access control for this origin.For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-