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

# AWS::CloudWatch::LogAlarm ScheduleConfiguration
<a name="aws-properties-cloudwatch-logalarm-scheduleconfiguration"></a>

The schedule and time-range offset configuration for the underlying scheduled query.

## Syntax
<a name="aws-properties-cloudwatch-logalarm-scheduleconfiguration-syntax"></a>

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

### JSON
<a name="aws-properties-cloudwatch-logalarm-scheduleconfiguration-syntax.json"></a>

```
{
  "[EndTimeOffset](#cfn-cloudwatch-logalarm-scheduleconfiguration-endtimeoffset)" : {{Integer}},
  "[ScheduleExpression](#cfn-cloudwatch-logalarm-scheduleconfiguration-scheduleexpression)" : {{String}},
  "[StartTimeOffset](#cfn-cloudwatch-logalarm-scheduleconfiguration-starttimeoffset)" : {{Integer}}
}
```

### YAML
<a name="aws-properties-cloudwatch-logalarm-scheduleconfiguration-syntax.yaml"></a>

```
  [EndTimeOffset](#cfn-cloudwatch-logalarm-scheduleconfiguration-endtimeoffset): {{Integer}}
  [ScheduleExpression](#cfn-cloudwatch-logalarm-scheduleconfiguration-scheduleexpression): {{String}}
  [StartTimeOffset](#cfn-cloudwatch-logalarm-scheduleconfiguration-starttimeoffset): {{Integer}}
```

## Properties
<a name="aws-properties-cloudwatch-logalarm-scheduleconfiguration-properties"></a>

`EndTimeOffset`  <a name="cfn-cloudwatch-logalarm-scheduleconfiguration-endtimeoffset"></a>
The offset, in seconds, before the scheduled execution time at which the query time range ends. Must be non-negative and less than `StartTimeOffset`. The default is 0.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ScheduleExpression`  <a name="cfn-cloudwatch-logalarm-scheduleconfiguration-scheduleexpression"></a>
The schedule expression that defines how often the underlying CloudWatch Logs scheduled query runs. Specify a `rate()` expression, for example `rate(5 minutes)`.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`StartTimeOffset`  <a name="cfn-cloudwatch-logalarm-scheduleconfiguration-starttimeoffset"></a>
The offset, in seconds, before the scheduled execution time at which the query time range begins. For example, an offset of 360 (6 minutes) on a query running at 12:05:00 starts the query time range at 11:59:00.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)