

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 個必要欄位和一個以空格分隔的選用欄位組成。cron 表達式欄位可讓您指定具有 cron 表達式的排程模式，如下所示。    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/codepipeline/latest/userguide/rule-reference-DeploymentWindow.html)
+ '\$1' 字元用於指定所有值。例如，分鐘欄位中的「\$1」表示「每分鐘」。
+ '？' 字元允許用於day-of-month和day-of-week欄位。它用於指定「無特定值」。當您需要指定兩個欄位中的其中一個，而不是另一個欄位，這會很有用。
+ '-' 字元用於指定範圍 例如，小時欄位中的「10-12」表示「小時 10、11 和 12」。
+ '，' 字元用於指定其他值。例如，day-of-week欄位中的「MON、WED、FRI」表示「星期一、星期三和星期五的天數」。
+ '/' 字元用於指定增量。例如，秒欄位中的「0/15」表示「秒 0、15、30 和 45」。秒欄位中的「5/15」表示「秒 5、20、35 和 50」。在 '/' 等於指定 0 之前指定 '\$1' 是開頭的值。
+ 'L' 字元允許用於day-of-month和day-of-week欄位。此字元是「最後」的速記，但兩個欄位各有不同的意義。例如，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**  
必要：否  
部署時段的時區。規則表達式符合下列格式的模式：  
+ **區域/城市格式**。此值符合區域/城市或區域/城市\$1城市格式的時區。例如 `America/New_York` 或 `Europe/Berlin`。
+ **UTC 格式**。此值符合字串 UTC，選擇性後面接著的偏移，格式為 \$1HH：MM 或 -HH：MM。 例如，`UTC`、 `UTC+05:30`或 `UTC-03:00`。如果未設定 參數，則此為預設格式。
+ **縮寫格式**。此值符合時區的 3 到 5 個字元縮寫。例如 `EST` 或 `IST`。

  如需有效 TimeZoneID 值的資料表，請參閱 https：//[https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html](https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html)。請注意，某些縮寫是重複的縮寫，例如中部標準時間、中國標準時間和古巴標準時間的 CST。

## 範例規則組態
<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) – 本節提供使用部署時段規則建立 On Success 條件的步驟。
+ 如需規則和條件的詳細資訊，請參閱 *CodePipeline API 指南*中的 [Condition](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html)、[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html) 和 [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)。