We recommend new projects start with resources from the AWS provider.
aws-native.cloudfront.ContinuousDeploymentPolicy
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
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.
Create ContinuousDeploymentPolicy Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ContinuousDeploymentPolicy(name: string, args: ContinuousDeploymentPolicyArgs, opts?: CustomResourceOptions);
@overload
def ContinuousDeploymentPolicy(resource_name: str,
args: ContinuousDeploymentPolicyArgs,
opts: Optional[ResourceOptions] = None)
@overload
def ContinuousDeploymentPolicy(resource_name: str,
opts: Optional[ResourceOptions] = None,
continuous_deployment_policy_config: Optional[ContinuousDeploymentPolicyConfigArgs] = None)
func NewContinuousDeploymentPolicy(ctx *Context, name string, args ContinuousDeploymentPolicyArgs, opts ...ResourceOption) (*ContinuousDeploymentPolicy, error)
public ContinuousDeploymentPolicy(string name, ContinuousDeploymentPolicyArgs args, CustomResourceOptions? opts = null)
public ContinuousDeploymentPolicy(String name, ContinuousDeploymentPolicyArgs args)
public ContinuousDeploymentPolicy(String name, ContinuousDeploymentPolicyArgs args, CustomResourceOptions options)
type: aws-native:cloudfront:ContinuousDeploymentPolicy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ContinuousDeploymentPolicyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ContinuousDeploymentPolicyArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ContinuousDeploymentPolicyArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ContinuousDeploymentPolicyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ContinuousDeploymentPolicyArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
ContinuousDeploymentPolicy Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The ContinuousDeploymentPolicy resource accepts the following input properties:
- Continuous
Deployment Pulumi.Policy Config Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Config - Contains the configuration for a continuous deployment policy.
- Continuous
Deployment ContinuousPolicy Config Deployment Policy Config Args - Contains the configuration for a continuous deployment policy.
- continuous
Deployment ContinuousPolicy Config Deployment Policy Config - Contains the configuration for a continuous deployment policy.
- continuous
Deployment ContinuousPolicy Config Deployment Policy Config - Contains the configuration for a continuous deployment policy.
- continuous_
deployment_ Continuouspolicy_ config Deployment Policy Config Args - Contains the configuration for a continuous deployment policy.
- continuous
Deployment Property MapPolicy Config - Contains the configuration for a continuous deployment policy.
Outputs
All input properties are implicitly available as output properties. Additionally, the ContinuousDeploymentPolicy resource produces the following output properties:
- Aws
Id string - The identifier of the cotinuous deployment policy.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Modified stringTime - The date and time when the continuous deployment policy was last modified.
- Aws
Id string - The identifier of the cotinuous deployment policy.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Modified stringTime - The date and time when the continuous deployment policy was last modified.
- aws
Id String - The identifier of the cotinuous deployment policy.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Modified StringTime - The date and time when the continuous deployment policy was last modified.
- aws
Id string - The identifier of the cotinuous deployment policy.
- id string
- The provider-assigned unique ID for this managed resource.
- last
Modified stringTime - The date and time when the continuous deployment policy was last modified.
- aws_
id str - The identifier of the cotinuous deployment policy.
- id str
- The provider-assigned unique ID for this managed resource.
- last_
modified_ strtime - The date and time when the continuous deployment policy was last modified.
- aws
Id String - The identifier of the cotinuous deployment policy.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Modified StringTime - The date and time when the continuous deployment policy was last modified.
Supporting Types
ContinuousDeploymentPolicyConfig, ContinuousDeploymentPolicyConfigArgs
- Enabled 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 isfalse
, this policy is not enabled and has no effect. - Staging
Distribution List<string>Dns Names - The CloudFront domain name of the staging distribution. For example:
d111111abcdef8.cloudfront.net
. - Single
Header Pulumi.Policy Config Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Config Single Header Policy Config Properties - 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 Pulumi.Policy Config Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Config Single Weight Policy Config Properties - This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
- Traffic
Config Pulumi.Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Traffic Config - Contains the parameters for routing production traffic from your primary to staging distributions.
- Type
Pulumi.
Aws Native. Cloud Front. Continuous Deployment Policy Config Type - The type of traffic configuration.
- Enabled 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 isfalse
, this policy is not enabled and has no effect. - Staging
Distribution []stringDns Names - The CloudFront domain name of the staging distribution. For example:
d111111abcdef8.cloudfront.net
. - Single
Header ContinuousPolicy Config Deployment Policy Config Single Header Policy Config Properties - 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 ContinuousPolicy Config Deployment Policy Config Single Weight Policy Config Properties - This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
- Traffic
Config ContinuousDeployment Policy Traffic Config - Contains the parameters for routing production traffic from your primary to staging distributions.
- Type
Continuous
Deployment Policy Config Type - The type of traffic configuration.
- enabled 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 isfalse
, this policy is not enabled and has no effect. - staging
Distribution List<String>Dns Names - The CloudFront domain name of the staging distribution. For example:
d111111abcdef8.cloudfront.net
. - single
Header ContinuousPolicy Config Deployment Policy Config Single Header Policy Config Properties - 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 ContinuousPolicy Config Deployment Policy Config Single Weight Policy Config Properties - This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
- traffic
Config ContinuousDeployment Policy Traffic Config - Contains the parameters for routing production traffic from your primary to staging distributions.
- type
Continuous
Deployment Policy Config Type - The type of traffic configuration.
- enabled 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 isfalse
, this policy is not enabled and has no effect. - staging
Distribution string[]Dns Names - The CloudFront domain name of the staging distribution. For example:
d111111abcdef8.cloudfront.net
. - single
Header ContinuousPolicy Config Deployment Policy Config Single Header Policy Config Properties - 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 ContinuousPolicy Config Deployment Policy Config Single Weight Policy Config Properties - This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
- traffic
Config ContinuousDeployment Policy Traffic Config - Contains the parameters for routing production traffic from your primary to staging distributions.
- type
Continuous
Deployment Policy Config Type - The type of traffic configuration.
- enabled 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 isfalse
, this policy is not enabled and has no effect. - staging_
distribution_ Sequence[str]dns_ names - The CloudFront domain name of the staging distribution. For example:
d111111abcdef8.cloudfront.net
. - single_
header_ Continuouspolicy_ config Deployment Policy Config Single Header Policy Config Properties - 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_ Continuouspolicy_ config Deployment Policy Config Single Weight Policy Config Properties - This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
- traffic_
config ContinuousDeployment Policy Traffic Config - Contains the parameters for routing production traffic from your primary to staging distributions.
- type
Continuous
Deployment Policy Config Type - The type of traffic configuration.
- enabled 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 isfalse
, this policy is not enabled and has no effect. - staging
Distribution List<String>Dns Names - The CloudFront domain name of the staging distribution. For example:
d111111abcdef8.cloudfront.net
. - single
Header Property MapPolicy Config - 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 Property MapPolicy Config - This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
- traffic
Config Property Map - Contains the parameters for routing production traffic from your primary to staging distributions.
- type
"Single
Weight" | "Single Header" - The type of traffic configuration.
ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigProperties, ContinuousDeploymentPolicyConfigSingleHeaderPolicyConfigPropertiesArgs
ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigProperties, ContinuousDeploymentPolicyConfigSingleWeightPolicyConfigPropertiesArgs
ContinuousDeploymentPolicyConfigType, ContinuousDeploymentPolicyConfigTypeArgs
- Single
Weight - SingleWeight
- Single
Header - SingleHeader
- Continuous
Deployment Policy Config Type Single Weight - SingleWeight
- Continuous
Deployment Policy Config Type Single Header - SingleHeader
- Single
Weight - SingleWeight
- Single
Header - SingleHeader
- Single
Weight - SingleWeight
- Single
Header - SingleHeader
- SINGLE_WEIGHT
- SingleWeight
- SINGLE_HEADER
- SingleHeader
- "Single
Weight" - SingleWeight
- "Single
Header" - SingleHeader
ContinuousDeploymentPolicySessionStickinessConfig, ContinuousDeploymentPolicySessionStickinessConfigArgs
- Idle
Ttl 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 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).
- Idle
Ttl 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 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).
- idle
Ttl 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).
- maximum
Ttl 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).
- idle
Ttl 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).
- maximum
Ttl 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 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 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).
- idle
Ttl 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).
- maximum
Ttl 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, ContinuousDeploymentPolicySingleHeaderConfigArgs
ContinuousDeploymentPolicySingleWeightConfig, ContinuousDeploymentPolicySingleWeightConfigArgs
- Weight 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.
- Session
Stickiness Pulumi.Config Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Session Stickiness Config - 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 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.
- Session
Stickiness ContinuousConfig Deployment Policy Session Stickiness Config - 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 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.
- session
Stickiness ContinuousConfig Deployment Policy Session Stickiness Config - 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 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.
- session
Stickiness ContinuousConfig Deployment Policy Session Stickiness Config - 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 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_ Continuousconfig Deployment Policy Session Stickiness Config - 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 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.
- session
Stickiness Property MapConfig - 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, ContinuousDeploymentPolicyTrafficConfigArgs
- Type
Pulumi.
Aws Native. Cloud Front. Continuous Deployment Policy Traffic Config Type - The type of traffic configuration.
- Single
Header Pulumi.Config Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Single Header Config - Determines which HTTP requests are sent to the staging distribution.
- Single
Weight Pulumi.Config Aws Native. Cloud Front. Inputs. Continuous Deployment Policy Single Weight Config - Contains the percentage of traffic to send to the staging distribution.
- Type
Continuous
Deployment Policy Traffic Config Type - The type of traffic configuration.
- Single
Header ContinuousConfig Deployment Policy Single Header Config - Determines which HTTP requests are sent to the staging distribution.
- Single
Weight ContinuousConfig Deployment Policy Single Weight Config - Contains the percentage of traffic to send to the staging distribution.
- type
Continuous
Deployment Policy Traffic Config Type - The type of traffic configuration.
- single
Header ContinuousConfig Deployment Policy Single Header Config - Determines which HTTP requests are sent to the staging distribution.
- single
Weight ContinuousConfig Deployment Policy Single Weight Config - Contains the percentage of traffic to send to the staging distribution.
- type
Continuous
Deployment Policy Traffic Config Type - The type of traffic configuration.
- single
Header ContinuousConfig Deployment Policy Single Header Config - Determines which HTTP requests are sent to the staging distribution.
- single
Weight ContinuousConfig Deployment Policy Single Weight Config - Contains the percentage of traffic to send to the staging distribution.
- type
Continuous
Deployment Policy Traffic Config Type - The type of traffic configuration.
- single_
header_ Continuousconfig Deployment Policy Single Header Config - Determines which HTTP requests are sent to the staging distribution.
- single_
weight_ Continuousconfig Deployment Policy Single Weight Config - Contains the percentage of traffic to send to the staging distribution.
- type
"Single
Weight" | "Single Header" - The type of traffic configuration.
- single
Header Property MapConfig - Determines which HTTP requests are sent to the staging distribution.
- single
Weight Property MapConfig - Contains the percentage of traffic to send to the staging distribution.
ContinuousDeploymentPolicyTrafficConfigType, ContinuousDeploymentPolicyTrafficConfigTypeArgs
- Single
Weight - SingleWeight
- Single
Header - SingleHeader
- Continuous
Deployment Policy Traffic Config Type Single Weight - SingleWeight
- Continuous
Deployment Policy Traffic Config Type Single Header - SingleHeader
- Single
Weight - SingleWeight
- Single
Header - SingleHeader
- Single
Weight - SingleWeight
- Single
Header - SingleHeader
- SINGLE_WEIGHT
- SingleWeight
- SINGLE_HEADER
- SingleHeader
- "Single
Weight" - SingleWeight
- "Single
Header" - SingleHeader
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.