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

# 在 AWS Managed Services Resource Scheduler 中使用期間和排程
<a name="res-sched-periods"></a>

您可以使用 AMS Resource Scheduler 在 AMS Accelerate 帳戶中新增、更新或刪除排程或期間。

## 在 AMS Resource Scheduler 中新增或更新期間
<a name="res-sched-add-period"></a>

新增或更新 AMS 帳戶中的資源排程器期間。

**您需要的資料：**
+ **動作**：要執行的操作類型。如果您想要新增期間，請使用「新增」；如果您想要更新現有期間，請使用「更新」。
+ **名稱**：期間的名稱。如果您要新增期間，則必須指定唯一的值。
+ **AutomationAssumeRole**：允許 Runbook 代表您新增或更新期間之 AWS Identity and Access Management (IAM) 角色的 ARN。將角色指定為 `ams_resource_scheduler_ssm_automation_role`。
+ **描述** （選用）：期間有意義的描述。
+ **BeginTime** （選用）：您想要啟動資源的時間，以 HH：MM 格式顯示。
+ **EndTime** （選用）：您想要停止資源的時間，採用 HH：MM 格式。
+ **月 **（選用）：以逗號分隔的月清單或連字號的月範圍，在此期間資源應執行。
+ **MonthDays** （選用）：以逗號分隔的月份天數清單，或資源應執行的連字號天數範圍。
+ **WeekDays** （選用）：以逗號分隔的一週內天數清單，或資源應執行的一週內天數範圍。

**如何執行：**
+ 在 [ AWSManagedServices-AddOrUpdatePeriod](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-AddOrUpdatePeriod) 中檢視文件 （您可能必須選擇加入的區域）。

  在**輸入參數**區段中指定需求，然後選擇**執行**。操作完成後，請在**輸出**索引標籤中檢視結果。
+ AWS CLI：

  執行下列命令來啟動自動化。將{{預留位置}}取代為您自己的資訊。

  ```
  aws ssm start-automation-execution --document-name "AWSManagedServices-AddOrUpdatePeriod" --document-version "\$DEFAULT" 
       --parameters '{"Action":["{{add}}" or "{{update}}"], "Name":["{{NAME}}"], 
      "Description":["{{DESCRIPTION}}"],"BeginTime":["{{TIME}}"], "EndTime":["{{TIME}}"],
      "Months":["{{MONTH}}"],"MonthDays":["{{DAY}}"], "WeekDays":["{{DAY}}"], 
      "AutomationAssumeRole" : ["arn:aws:iam::{{ACCOUNTID}}:role/ams_resource_scheduler_ssm_automation_role"] }' --region {{ONBOARDED_REGION}}
  ```

**範例**：

下列範例示範如何使用 AWS Systems Manager 主控台新增期間。我們已命名 **period-Name**，並設定每月前 15 天從週一到週五上午 9AM-6PM。

1. 在 [ AWSManagedServices-AddOrUpdatePeriod](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-AddOrUpdatePeriod) 檢視 AWS Systems Manager 自動化文件 （您可能必須選擇加入的區域）。  
![加速為資源排程器新增期間。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedAddPeriod.png)

1. 提供參數的值。  
![加速資源排程器的期間設定。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedAddPeriodParams.png)

1. 按一下**執行**並等待自動化完成。

## 在 AMS Resource Scheduler 中新增或更新排程
<a name="res-sched-add-sched"></a>

在 AMS Accelerate 帳戶中新增或更新資源排程器排程。

**您需要的資料：**
+ **動作**：要執行的操作類型。如果您想要新增排程，請使用「新增」；如果您想要更新現有的排程，請使用「更新」。
+ **名稱**：排程的名稱。如果您要新增排程，則必須指定唯一的值。
+ **AutomationAssumeRole**：允許 Runbook 代表您新增或更新排程的 AWS Identity and Access Management (IAM) 角色 ARN。指定角色 `ams_resource_scheduler_ssm_automation_role`。
+ **描述** （選用）：排程的有意義的描述。
+ **期間 **（選用）：指定要與此排程搭配使用的期間逗號分隔清單。必須已建立每個期間。
+ **RetainRunning** （選用）：指定「true」，以防止資源排程器在執行期間結束時停止執行中的資源，如果資源是在執行操作開始之前手動啟動。根據預設，Resource Scheduler 會停止資源。
+ **StopNewInstances** （選用）：指定「false」，以防止資源排程器在執行期間之外執行時，第一次標記資源時停止資源。根據預設，Resource Scheduler 會停止資源。
+ **SSMMaintenanceWindow** （選用）：指定要新增為排程執行期間之 AWS Systems Manager (SSM) 維護時段的逗號分隔清單。您還必須將 "UseMaintenanceWindow" 屬性指定為 "true"。
+ **TimeZone** （選用）：指定您希望資源排程器使用的時區。根據預設，Resource Scheduler 會使用 UTC。
+ **UseMaintenanceWindow** （選用）：如果您想要 Resource Scheduler 將 Amazon Relational Database Service (RDS) 維護時段視為 Amazon RDS 執行個體排程的執行期間，或將 AWS Systems Manager (SSM) 維護時段新增為 Amazon EC2 執行個體排程的執行期間，請指定「true」。
+ **UseMetrics** （選用）：指定「true」以在排程層級啟用 CloudWatch 指標，並指定「false」停用 CloudWatch 指標。指定此屬性會覆寫堆疊層級設定的 CloudWatch 指標設定。

**執行方式：**
+ 在 [ AWSManagedServices-AddOrUpdateSchedule](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-AddOrUpdateSchedule) 中檢視文件 （您可能需要選擇加入的區域）。

  在**輸入參數**區段中指定需求，然後選擇**執行**。操作完成後，請在**輸出**索引標籤中檢視結果。
+ AWS CLI：

  執行下列命令來啟動自動化。將{{預留位置}}取代為您自己的資訊。

  ```
  aws ssm start-automation-execution --document-name "AWSManagedServices-AddOrUpdateSchedule" --document-version "\$DEFAULT" 
       --parameters '{"Action":[{{"add" or "update"}}], "Name":["{{NAME}}"], "Description":["{{DESCRIPTION}}"],
      "Hibernate":["{{true}} or {{false}}"],"Enforced":["{{true}} or {{false}}"],
      "OverrideStatus":["{{running}} or {{stopped}}"],"Periods":["{{PERIOD-A}}, {{PERIOD-B}}"],
      "RetainRunning":["{{true}} or {{false}}"],"StopNewInstances":["{{true}} or {{false}}"],
      "SSMMaintenanceWindow":["{{WINDOW-NAME}}"],"TimeZone":["{{TIMEZONE}}"], 
      "UseMaintenanceWindow":["{{true}} or {{false}}"],"UseMetrics":["{{true}} or {{false}}"], 
      "AutomationAssumeRole" : ["arn:aws:iam::{{ACCOUNTID}}:role/ams_resource_scheduler_ssm_automation_role"] }' --region {{ONBOARDED_REGION}}
  ```

**範例**：

下列範例顯示如何新增 AMS Resource Scheduler 的排程。在此範例中，您會使用 CustomPeriod 新增名為 CustomSchedule 的排程。 CustomPeriod

1. 在 [ AWSManagedServices-AddOrUpdateSchedule](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-AddOrUpdateSchedule) 中檢視 AWS Systems Manager 自動化文件 （您可能需要選擇加入的區域）。  
![加速新增資源排程器的排程。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedAddOrUpdateSchedule.png)

1. 提供參數的值。  
![加速設定資源排程器的排程設定。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedAddScheduleParams.png)

1. 按一下**執行**並等待自動化完成。

## 在 AMS Resource Scheduler 中刪除期間或排程
<a name="res-sched-delete-period"></a>

若要刪除 AMS Accelerate 帳戶中的資源排程器期間或排程，您需要下列資料：
+ **ConfigurationType**：您要刪除的組態類型。如果您想要刪除期間，請使用「期間」；如果您要刪除排程，請使用「排程」。
+ **名稱**：您要刪除的排程或期間的名稱。
+ **AutomationAssumeRole**：允許 Runbook 代表您刪除排程或期間之 AWS Identity and Access Management (IAM) 角色的 ARN。指定角色 `ams_resource_scheduler_ssm_automation_role`。

**如何執行：**
+ 在 [ AWSManagedServices-DeleteScheduleOrPeriod](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-DeleteScheduleOrPeriod) 中檢視文件 （您可能3必須選擇加入的區域）。

  在**輸入參數**區段中指定需求，然後選擇**執行**。操作完成後，請在**輸出**索引標籤中檢視結果。
+ AWS CLI：

  執行下列命令來啟動自動化。將{{預留位置}}取代為您自己的資訊。

  ```
  aws ssm start-automation-execution --document-name "AWSManagedServices-DeleteScheduleOrPeriod" --document-version "\$DEFAULT"
  --parameters '{"ConfigurationType":[{{"period" or "schedule"}}],"Name":["{{NAME}}"],
      "AutomationAssumeRole":["arn:aws:iam::{{ACCOUNTID}}:role/ams_resource_scheduler_ssm_automation_role"]}' --region {{ONBOARDED_REGION}}
  ```

**範例**：

下列範例示範如何使用 AWS Systems Manager 主控台刪除期間。

1. 在 [ AWSManagedServices-DeleteScheduleOrPeriod](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-DeleteScheduleOrPeriod) 中檢視 AWS Systems Manager 自動化文件 （您可能需要選擇加入的區域）。  
![加速刪除資源排程器的期間。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedDeleteSchedOrPeriod.png)

1. 提供參數的值。  
![加速資源排程器的期間刪除設定。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedDeletePeriodParams.png)

1. 按一下**執行**並等待自動化完成。

## 在 AMS Resource Scheduler 中描述期間或排程
<a name="res-sched-describe-period"></a>

若要在 AMS Accelerate 帳戶中描述 （檢視詳細資訊） 資源排程器期間或排程，您需要下列資料：
+ **ConfigurationType**：您要描述的組態類型。如果您想要描述所有期間，請使用「期間」；如果您想要描述所有排程，請使用「排程」。
+ **AutomationAssumeRole**： AWS Identity and Access Management (IAM) 角色的 ARN，允許 Runbook 代表您描述排程或期間。指定角色 `ams_resource_scheduler_ssm_automation_role`。

**如何執行：**
+ 在 [ AWSManagedServices-DescribeScheduleOrPeriods](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-DescribeScheduleOrPeriods) 中檢視文件 （您可能需要選擇加入的區域）：

  1. 在**輸入參數**區段中指定需求，然後選擇**執行**。

  1. 操作完成後，請在**輸出**索引標籤中檢視結果。
+ AWS CLI：

  1. 執行下列命令來啟動自動化。將{{預留位置}}取代為您自己的資訊。

     ```
     aws ssm start-automation-execution --document-name "AWSManagedServices-DescribeScheduleOrPeriods" --document-version "\$DEFAULT" 
                     --parameters '{"ConfigurationType":[{{"period" or "schedule"}}],"AutomationAssumeRole":["arn:aws:iam::{{ACCOUNTID}}:role/ams_resource_scheduler_ssm_automation_role"]}' 
                     --region {{ONBOARDED_REGION}}
     ```

**範例**：

下列範例顯示如何使用 AWS Systems Manager 主控台描述期間。

1. 在 [ AWSManagedServices-DescribeScheduleOrPeriods](https://console.aws.amazon.com/systems-manager/automation/execute/AWSManagedServices-DescribeScheduleOrPeriods) 中檢視 AWS Systems Manager 自動化文件 （您可能需要選擇加入的區域）。  
![加速描述資源排程器的期間。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedDescribePeriod.png)

1. 提供參數的值。  
![加速設定期間描述資源排程器的設定。](http://docs.aws.amazon.com/zh_tw/managedservices/latest/accelerate-guide/images/accResSchedDescribePeriodParams.png)

1. 按一下**執行**並等待自動化完成。