

This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::GreengrassV2::Deployment DeploymentComponentUpdatePolicy
<a name="aws-properties-greengrassv2-deployment-deploymentcomponentupdatepolicy"></a>

Contains information about a deployment's policy that defines when components are safe to update.

Each component on a device can report whether or not it's ready to update. After a component and its dependencies are ready, they can apply the update in the deployment. You can configure whether or not the deployment notifies components of an update and waits for a response. You specify the amount of time each component has to respond to the update notification.

## Syntax
<a name="aws-properties-greengrassv2-deployment-deploymentcomponentupdatepolicy-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-greengrassv2-deployment-deploymentcomponentupdatepolicy-syntax.json"></a>

```
{
  "[Action](#cfn-greengrassv2-deployment-deploymentcomponentupdatepolicy-action)" : {{String}},
  "[TimeoutInSeconds](#cfn-greengrassv2-deployment-deploymentcomponentupdatepolicy-timeoutinseconds)" : {{Integer}}
}
```

### YAML
<a name="aws-properties-greengrassv2-deployment-deploymentcomponentupdatepolicy-syntax.yaml"></a>

```
  [Action](#cfn-greengrassv2-deployment-deploymentcomponentupdatepolicy-action): {{String}}
  [TimeoutInSeconds](#cfn-greengrassv2-deployment-deploymentcomponentupdatepolicy-timeoutinseconds): {{Integer}}
```

## Properties
<a name="aws-properties-greengrassv2-deployment-deploymentcomponentupdatepolicy-properties"></a>

`Action`  <a name="cfn-greengrassv2-deployment-deploymentcomponentupdatepolicy-action"></a>
Whether or not to notify components and wait for components to become safe to update. Choose from the following options:  
+ `NOTIFY_COMPONENTS` – The deployment notifies each component before it stops and updates that component. Components can use the [SubscribeToComponentUpdates](https://docs.aws.amazon.com/greengrass/v2/developerguide/interprocess-communication.html#ipc-operation-subscribetocomponentupdates) IPC operation to receive these notifications. Then, components can respond with the [DeferComponentUpdate](https://docs.aws.amazon.com/greengrass/v2/developerguide/interprocess-communication.html#ipc-operation-defercomponentupdate) IPC operation. For more information, see the [Create deployments](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) in the *AWS IoT Greengrass V2 Developer Guide*.
+ `SKIP_NOTIFY_COMPONENTS` – The deployment doesn't notify components or wait for them to be safe to update.
Default: `NOTIFY_COMPONENTS`  
*Required*: No  
*Type*: String  
*Allowed values*: `NOTIFY_COMPONENTS | SKIP_NOTIFY_COMPONENTS`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`TimeoutInSeconds`  <a name="cfn-greengrassv2-deployment-deploymentcomponentupdatepolicy-timeoutinseconds"></a>
The amount of time in seconds that each component on a device has to report that it's safe to update. If the component waits for longer than this timeout, then the deployment proceeds on the device.  
Default: `60`  
*Required*: No  
*Type*: Integer  
*Minimum*: `1`  
*Maximum*: `2147483647`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)