

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# DeploymentWindow
<a name="rule-reference-DeploymentWindow"></a>

创建条件时，可以添加 `DeploymentWindow` 规则。本节提供对规则参数的参考。有关规则和条件的更多信息，请参阅[阶段条件是如何运作的？](concepts-how-it-works-conditions.md)。

**Topics**
+ [规则类型](#rule-reference-DeploymentWindow-type)
+ [配置参数](#rule-reference-DeploymentWindow-config)
+ [规则配置示例](#rule-reference-DeploymentWindow-example)
+ [另请参阅](#rule-reference-DeploymentWindow-links)

## 规则类型
<a name="rule-reference-DeploymentWindow-type"></a>
+ 类别：`Rule`
+ 拥有者：`AWS`
+ 提供方：`DeploymentWindow`
+ 版本：`1`

## 配置参数
<a name="rule-reference-DeploymentWindow-config"></a>

**Cron**  
是否必需：是  
定义允许部署的天数和时间的表达式。Cron 表达式由 6 个必需字段和 1 个可选字段组成，中间用空格隔开。通过 cron 表达式字段，您可以使用 cron 表达式指定计划模式，如下所示。    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/codepipeline/latest/userguide/rule-reference-DeploymentWindow.html)
+ “\$1”字符用于指定所有值。例如，minute 字段中的“\$1”表示“每分钟”。
+ '？' day-of-month和 day-of-week字段允许使用字符。此字符用于指定“无特定值”。当您需要在两个字段中的一个字段指定某些内容，而另一个字段不需要时，此字符非常有用。
+ “-”字符用于指定范围。例如，hour 字段中的“10-12”表示“10、11 和 12 小时”。
+ “,”字符用于指定附加值。例如，该 day-of-week字段中的 “星期一、星期三、星期五” 表示 “星期一、星期三和星期五”。
+ “/”字符用于指定增量。例如，seconds 字段中的“0/15”表示“0、15、30 和 45 秒”。seconds 字段中的“5/15”表示“5、20、35 和 50 秒”。在“/”前指定“\$1”相当于指定 0 为起始值。
+  day-of-month和字段允许使用 'L' day-of-week 字符。此字符是“last”的简写，但在两个字段中含义不同。例如，该 day-of-month字段中的值 “L” 表示 “该月的最后一天” ——1 月为 31 日，非闰年为 2 月，第 28 天。如果在 day-of-week现场单独使用，则仅表示 “7” 或 “SAT”。但是，如果在 day-of-week字段中使用另一个值之后，则表示 “<specified\$1day>该月的最后一天” ——例如，“6L” 表示 “该月的最后一个星期五”。您还可以指定与该月最后一天的偏移量，例如 “L-3”，表示日历月中的某 third-to-last一天。
+ 该字段允许使用 'W' day-of-month 字符。此字符用于指定离给定日期最近的工作日（星期一至星期五）。例如，如果您要指定 “15W” 作为该 day-of-month字段的值，则含义是：“距离该月15日最近的工作日”。因此，如果 15 日是星期六，触发器将在 14 日星期五触发。如果 15 日是星期日，触发器将在 16 日星期一触发。如果 15 日是星期二，那么将在 15 日星期二触发。
+ 也可以将 “L” 和 “W” 字符组合在一起，使 day-of-month表达式生成 “LW”，意思是 “该月的最后一个工作日”。
+ 该字段允许使用 '\$1' day-of-week 字符。此字符用于指定本月的“第 n 个”<specified\$1day> 日。例如，该 day-of-week字段中的 “6 \$13” 值表示该月的第三个星期五（第 6 天 = 星期五，“\$13” = 该月的第三个星期五）。
+ 合法字符以及月份和星期的名称不区分大小写。

**TimeZone**  
必需：否  
部署窗口的时区。正则表达式匹配以下格式的模式：  
+ **Region/City 格式**。该值与格式 Region/City 为 “地区/城市\$1城市” 的时区相匹配。例如，`America/New_York` 或 `Europe/Berlin`。
+ **UTC 格式**。该值与 UTC 字符串相匹配，后面可选择 \$1HH:MM 或 -HH:MM 格式的偏移量。例如 `UTC`、`UTC+05:30` 或 `UTC-03:00`。如果此参数未作其他设置，这是默认格式。
+ **缩写格式**。该值匹配 3 至 5 个字符的时区缩写。例如，`EST` 或 `IST`。

  有关有效 TimeZone ID 值的表，请参阅 [https://docs.oracle.com/middleware/1221/ wcs/tag-ref/MISC/TimeZones](https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html) .html。请注意，某些缩写可以是多种不同词组的缩写，如 CST 表示 Central Standard Time、China Standard Time 和 Cuba Standard Time。

## 规则配置示例
<a name="rule-reference-DeploymentWindow-example"></a>

------
#### [ YAML ]

```
- name: MyDeploymentRule
  ruleTypeId:
    category: Rule
    owner: AWS
    provider: DeploymentWindow
    version: '1'
  configuration:
    Cron: 0 0 9-17 ? * MON-FRI *
    TimeZone: PST
  inputArtifacts: []
  region: us-east-1
```

------
#### [ JSON ]

```
[
                    {
                        "name": "MyDeploymentRule",
                        "ruleTypeId": {
                            "category": "Rule",
                            "owner": "AWS",
                            "provider": "DeploymentWindow",
                            "version": "1"
                        },
                        "configuration": {
                            "Cron": "0 0 9-17 ? * MON-FRI *",
                            "TimeZone": "PST"
                        },
                        "inputArtifacts": [],
                        "region": "us-east-1"
                    }
                ]
```

------

## 另请参阅
<a name="rule-reference-DeploymentWindow-links"></a>

以下相关资源可在您使用此规则时为您提供帮助。
+ [创建“成功时”条件](stage-conditions.md#stage-conditions-onsuccess) – 本节介绍使用部署窗口规则创建“成功时”条件的步骤。
+ [有关规则和条件的更多信息，请参阅 *CodePipeline API 指南[RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)*中的条件和。[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html)