1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. cloudfront
  5. getContinuousDeploymentPolicy

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi

aws-native.cloudfront.getContinuousDeploymentPolicy

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi

Creates a continuous deployment policy that routes a subset of production traffic from a primary distribution to a staging distribution. After you create and update a staging distribution, you can use a continuous deployment policy to incrementally move traffic to the staging distribution. This enables you to test changes to a distribution’s configuration before moving all of your production traffic to the new configuration. For more information, see Using CloudFront continuous deployment to safely test CDN configuration changes in the Amazon CloudFront Developer Guide.

Using getContinuousDeploymentPolicy

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getContinuousDeploymentPolicy(args: GetContinuousDeploymentPolicyArgs, opts?: InvokeOptions): Promise<GetContinuousDeploymentPolicyResult>
function getContinuousDeploymentPolicyOutput(args: GetContinuousDeploymentPolicyOutputArgs, opts?: InvokeOptions): Output<GetContinuousDeploymentPolicyResult>
Copy
def get_continuous_deployment_policy(id: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetContinuousDeploymentPolicyResult
def get_continuous_deployment_policy_output(id: Optional[pulumi.Input[str]] = None,
                                     opts: Optional[InvokeOptions] = None) -> Output[GetContinuousDeploymentPolicyResult]
Copy
func LookupContinuousDeploymentPolicy(ctx *Context, args *LookupContinuousDeploymentPolicyArgs, opts ...InvokeOption) (*LookupContinuousDeploymentPolicyResult, error)
func LookupContinuousDeploymentPolicyOutput(ctx *Context, args *LookupContinuousDeploymentPolicyOutputArgs, opts ...InvokeOption) LookupContinuousDeploymentPolicyResultOutput
Copy

> Note: This function is named LookupContinuousDeploymentPolicy in the Go SDK.

public static class GetContinuousDeploymentPolicy 
{
    public static Task<GetContinuousDeploymentPolicyResult> InvokeAsync(GetContinuousDeploymentPolicyArgs args, InvokeOptions? opts = null)
    public static Output<GetContinuousDeploymentPolicyResult> Invoke(GetContinuousDeploymentPolicyInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetContinuousDeploymentPolicyResult> getContinuousDeploymentPolicy(GetContinuousDeploymentPolicyArgs args, InvokeOptions options)
public static Output<GetContinuousDeploymentPolicyResult> getContinuousDeploymentPolicy(GetContinuousDeploymentPolicyArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: aws-native:cloudfront:getContinuousDeploymentPolicy
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Id This property is required. string
The identifier of the cotinuous deployment policy.
Id This property is required. string
The identifier of the cotinuous deployment policy.
id This property is required. String
The identifier of the cotinuous deployment policy.
id This property is required. string
The identifier of the cotinuous deployment policy.
id This property is required. str
The identifier of the cotinuous deployment policy.
id This property is required. String
The identifier of the cotinuous deployment policy.

getContinuousDeploymentPolicy Result

The following output properties are available:

ContinuousDeploymentPolicyConfig Pulumi.AwsNative.CloudFront.Outputs.ContinuousDeploymentPolicyConfig
Contains the configuration for a continuous deployment policy.
Id string
The identifier of the cotinuous deployment policy.
LastModifiedTime string
The date and time when the continuous deployment policy was last modified.
ContinuousDeploymentPolicyConfig ContinuousDeploymentPolicyConfig
Contains the configuration for a continuous deployment policy.
Id string
The identifier of the cotinuous deployment policy.
LastModifiedTime string
The date and time when the continuous deployment policy was last modified.
continuousDeploymentPolicyConfig ContinuousDeploymentPolicyConfig
Contains the configuration for a continuous deployment policy.
id String
The identifier of the cotinuous deployment policy.
lastModifiedTime String
The date and time when the continuous deployment policy was last modified.
continuousDeploymentPolicyConfig ContinuousDeploymentPolicyConfig
Contains the configuration for a continuous deployment policy.
id string
The identifier of the cotinuous deployment policy.
lastModifiedTime string
The date and time when the continuous deployment policy was last modified.
continuous_deployment_policy_config ContinuousDeploymentPolicyConfig
Contains the configuration for a continuous deployment policy.
id str
The identifier of the cotinuous deployment policy.
last_modified_time str
The date and time when the continuous deployment policy was last modified.
continuousDeploymentPolicyConfig Property Map
Contains the configuration for a continuous deployment policy.
id String
The identifier of the cotinuous deployment policy.
lastModifiedTime String
The date and time when the continuous deployment policy was last modified.

Supporting Types

ContinuousDeploymentPolicyConfig

Enabled This property is required. bool
A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is true, this policy is enabled and in effect. When this value is false, this policy is not enabled and has no effect.
StagingDistributionDnsNames This property is required. List<string>
The CloudFront domain name of the staging distribution. For example: d111111abcdef8.cloudfront.net.
SingleHeaderPolicyConfig Pulumi.AwsNative.CloudFront.Inputs.ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties
This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
SingleWeightPolicyConfig Pulumi.AwsNative.CloudFront.Inputs.ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties
This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
TrafficConfig Pulumi.AwsNative.CloudFront.Inputs.ContinuousDeploymentPolicyTrafficConfig
Contains the parameters for routing production traffic from your primary to staging distributions.
Type Pulumi.AwsNative.CloudFront.ContinuousDeploymentPolicyConfigType
The type of traffic configuration.
Enabled This property is required. bool
A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is true, this policy is enabled and in effect. When this value is false, this policy is not enabled and has no effect.
StagingDistributionDnsNames This property is required. []string
The CloudFront domain name of the staging distribution. For example: d111111abcdef8.cloudfront.net.
SingleHeaderPolicyConfig ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties
This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
SingleWeightPolicyConfig ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties
This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
TrafficConfig ContinuousDeploymentPolicyTrafficConfig
Contains the parameters for routing production traffic from your primary to staging distributions.
Type ContinuousDeploymentPolicyConfigType
The type of traffic configuration.
enabled This property is required. Boolean
A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is true, this policy is enabled and in effect. When this value is false, this policy is not enabled and has no effect.
stagingDistributionDnsNames This property is required. List<String>
The CloudFront domain name of the staging distribution. For example: d111111abcdef8.cloudfront.net.
singleHeaderPolicyConfig ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties
This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
singleWeightPolicyConfig ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties
This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
trafficConfig ContinuousDeploymentPolicyTrafficConfig
Contains the parameters for routing production traffic from your primary to staging distributions.
type ContinuousDeploymentPolicyConfigType
The type of traffic configuration.
enabled This property is required. boolean
A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is true, this policy is enabled and in effect. When this value is false, this policy is not enabled and has no effect.
stagingDistributionDnsNames This property is required. string[]
The CloudFront domain name of the staging distribution. For example: d111111abcdef8.cloudfront.net.
singleHeaderPolicyConfig ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties
This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
singleWeightPolicyConfig ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties
This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
trafficConfig ContinuousDeploymentPolicyTrafficConfig
Contains the parameters for routing production traffic from your primary to staging distributions.
type ContinuousDeploymentPolicyConfigType
The type of traffic configuration.
enabled This property is required. bool
A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is true, this policy is enabled and in effect. When this value is false, this policy is not enabled and has no effect.
staging_distribution_dns_names This property is required. Sequence[str]
The CloudFront domain name of the staging distribution. For example: d111111abcdef8.cloudfront.net.
single_header_policy_config ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties
This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
single_weight_policy_config ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties
This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
traffic_config ContinuousDeploymentPolicyTrafficConfig
Contains the parameters for routing production traffic from your primary to staging distributions.
type ContinuousDeploymentPolicyConfigType
The type of traffic configuration.
enabled This property is required. Boolean
A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is true, this policy is enabled and in effect. When this value is false, this policy is not enabled and has no effect.
stagingDistributionDnsNames This property is required. List<String>
The CloudFront domain name of the staging distribution. For example: d111111abcdef8.cloudfront.net.
singleHeaderPolicyConfig Property Map
This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
singleWeightPolicyConfig Property Map
This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
trafficConfig Property Map
Contains the parameters for routing production traffic from your primary to staging distributions.
type "SingleWeight" | "SingleHeader"
The type of traffic configuration.

ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties

Header This property is required. string
Value This property is required. string
Header This property is required. string
Value This property is required. string
header This property is required. String
value This property is required. String
header This property is required. string
value This property is required. string
header This property is required. str
value This property is required. str
header This property is required. String
value This property is required. String

ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties

weight This property is required. Number
sessionStickinessConfig Property Map

ContinuousDeploymentPolicyConfigType

ContinuousDeploymentPolicySessionStickinessConfig

IdleTtl This property is required. int
The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
MaximumTtl This property is required. int
The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).
IdleTtl This property is required. int
The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
MaximumTtl This property is required. int
The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).
idleTtl This property is required. Integer
The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
maximumTtl This property is required. Integer
The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).
idleTtl This property is required. number
The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
maximumTtl This property is required. number
The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).
idle_ttl This property is required. int
The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
maximum_ttl This property is required. int
The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).
idleTtl This property is required. Number
The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
maximumTtl This property is required. Number
The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).

ContinuousDeploymentPolicySingleHeaderConfig

Header This property is required. string
The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix aws-cf-cd-.
Value This property is required. string
The request header value.
Header This property is required. string
The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix aws-cf-cd-.
Value This property is required. string
The request header value.
header This property is required. String
The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix aws-cf-cd-.
value This property is required. String
The request header value.
header This property is required. string
The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix aws-cf-cd-.
value This property is required. string
The request header value.
header This property is required. str
The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix aws-cf-cd-.
value This property is required. str
The request header value.
header This property is required. String
The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix aws-cf-cd-.
value This property is required. String
The request header value.

ContinuousDeploymentPolicySingleWeightConfig

Weight This property is required. double
The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
SessionStickinessConfig Pulumi.AwsNative.CloudFront.Inputs.ContinuousDeploymentPolicySessionStickinessConfig
Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
Weight This property is required. float64
The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
SessionStickinessConfig ContinuousDeploymentPolicySessionStickinessConfig
Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
weight This property is required. Double
The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
sessionStickinessConfig ContinuousDeploymentPolicySessionStickinessConfig
Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
weight This property is required. number
The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
sessionStickinessConfig ContinuousDeploymentPolicySessionStickinessConfig
Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
weight This property is required. float
The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
session_stickiness_config ContinuousDeploymentPolicySessionStickinessConfig
Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
weight This property is required. Number
The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
sessionStickinessConfig Property Map
Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.

ContinuousDeploymentPolicyTrafficConfig

Type This property is required. Pulumi.AwsNative.CloudFront.ContinuousDeploymentPolicyTrafficConfigType
The type of traffic configuration.
SingleHeaderConfig Pulumi.AwsNative.CloudFront.Inputs.ContinuousDeploymentPolicySingleHeaderConfig
Determines which HTTP requests are sent to the staging distribution.
SingleWeightConfig Pulumi.AwsNative.CloudFront.Inputs.ContinuousDeploymentPolicySingleWeightConfig
Contains the percentage of traffic to send to the staging distribution.
Type This property is required. ContinuousDeploymentPolicyTrafficConfigType
The type of traffic configuration.
SingleHeaderConfig ContinuousDeploymentPolicySingleHeaderConfig
Determines which HTTP requests are sent to the staging distribution.
SingleWeightConfig ContinuousDeploymentPolicySingleWeightConfig
Contains the percentage of traffic to send to the staging distribution.
type This property is required. ContinuousDeploymentPolicyTrafficConfigType
The type of traffic configuration.
singleHeaderConfig ContinuousDeploymentPolicySingleHeaderConfig
Determines which HTTP requests are sent to the staging distribution.
singleWeightConfig ContinuousDeploymentPolicySingleWeightConfig
Contains the percentage of traffic to send to the staging distribution.
type This property is required. ContinuousDeploymentPolicyTrafficConfigType
The type of traffic configuration.
singleHeaderConfig ContinuousDeploymentPolicySingleHeaderConfig
Determines which HTTP requests are sent to the staging distribution.
singleWeightConfig ContinuousDeploymentPolicySingleWeightConfig
Contains the percentage of traffic to send to the staging distribution.
type This property is required. ContinuousDeploymentPolicyTrafficConfigType
The type of traffic configuration.
single_header_config ContinuousDeploymentPolicySingleHeaderConfig
Determines which HTTP requests are sent to the staging distribution.
single_weight_config ContinuousDeploymentPolicySingleWeightConfig
Contains the percentage of traffic to send to the staging distribution.
type This property is required. "SingleWeight" | "SingleHeader"
The type of traffic configuration.
singleHeaderConfig Property Map
Determines which HTTP requests are sent to the staging distribution.
singleWeightConfig Property Map
Contains the percentage of traffic to send to the staging distribution.

ContinuousDeploymentPolicyTrafficConfigType

Package Details

Repository
AWS Native pulumi/pulumi-aws-native
License
Apache-2.0

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi