標記維護時段

本節中的主題說明如何在維護時段上使用標籤。

建立包含標籤的維護時段

您可以在建立維護時段時將標籤新增至其中。

如需詳細資訊，請參閱以下主題：

• 建立維護時段 (主控台)

• 教學課程：建立和設定維護時段 (AWS CLI)

將標籤新增至現有的維護時段

您可以使用 AWS Systems Manager 主控台或命令列將標籤新增至您擁有的維護時段。

主題

• 新增標籤至現有的維護時段 (主控台)
• 新增標籤至現有的維護時段 (AWS CLI)
• 標記維護時段 (AWS Tools for PowerShell)。

新增標籤至現有的維護時段 (主控台)

1. 開啟位於 https://console.aws.amazon.com/systems-manager/ 的 AWS Systems Manager 主控台。

2. 在導覽窗格中，選擇 Maintenance Windows。

   -或-

   如果 AWS Systems Manager 首頁先開啟，選擇選單圖示 ( ) 以開啟導覽窗格，然後選擇 Maintenance Windows。

3. 選擇您已建立之維護時段的名稱，然後選擇 Tags (標籤) 索引標籤。

4. 選擇 Edit tag (編輯標籤)，然後選擇 Add tag (新增標籤)。

5. 針對 Key (索引鍵)，輸入標籤的索引鍵，例如 Environment。

6. (選用) 針對 Value (數值)，輸入標籤的數值，例如 Test。

7. 選擇 Save changes (儲存變更)。

新增標籤至現有的維護時段 (AWS CLI)

1. 使用您偏好的命令列工具，執行以下命令來檢視您可以標記的維護時段清單。

   aws ssm describe-maintenance-windows

   記下您要標記的維護時段 ID。

2. 執行以下命令以標記維護時段。將每個範例資源預留位置取代為您自己的資訊。

   Linux & macOS

   aws ssm add-tags-to-resource \
       --resource-type "MaintenanceWindow" \
       --resource-id "window-id" \
       --tags "Key=tag-key,Value=tag-value"

   Windows

   aws ssm add-tags-to-resource ^
       --resource-type "MaintenanceWindow" ^
       --resource-id "window-id" ^
       --tags "Key=tag-key,Value=tag-value"

   如果成功，命令不會有輸出。

3. 執行以下命令以確認維護時段標籤。

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "MaintenanceWindow" \
       --resource-id "window-id"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "MaintenanceWindow" ^
       --resource-id "window-id"

標記維護時段 (AWS Tools for PowerShell)。

1. 執行以下命令以列出您可標記的維護時段。

   Get-SSMMaintenanceWindow

2. 執行以下命令以標記維護時段。

   $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag

   $tag.Key = "tag-key"

   $tag.Value = "tag-value"

   Add-SSMResourceTag `
       -ResourceType "MaintenanceWindow" `
       -ResourceId "window-id" `
       -Tag $tag

   windows-id 是您要標記之維護時段的 ID。

   key 是您所提供之自訂索引鍵的名稱。例如，「環境」或「專案」。

   tag-value 是您想為該索引鍵提供之數值的自訂內容。例如，「生產」或「Q321」。

3. 執行以下命令以確認維護時段標籤。

   Get-SSMResourceTag `
       -ResourceType "MaintenanceWindow" `
       -ResourceId "window-id"

從維護時段移除標籤

您可以使用 Systems Manager 主控台或命令列從維護時段中移除標籤。

主題

• 從維護時段刪除標籤 (主控台)
• 從維護時段移除標籤 (命令列)

從維護時段刪除標籤 (主控台)

1. 開啟位於 https://console.aws.amazon.com/systems-manager/ 的 AWS Systems Manager 主控台。

2. 在導覽窗格中，選擇 Maintenance Windows。

   -或-

   如果 AWS Systems Manager 首頁先開啟，選擇選單圖示 ( ) 以開啟導覽窗格，然後選擇 Maintenance Windows。

3. 選擇要移除標籤的維護時段名稱，然後選擇 Tags (標籤) 索引標籤。

4. 選擇 Edit tags (編輯標籤)，然後選擇不再需要之標籤組旁邊的 Remove tag (移除標籤)。

5. 選擇 Save changes (儲存變更)。

從維護時段移除標籤 (命令列)

1. 使用您偏好的命令列工具，執行以下命令來列出您帳戶中的維護時段。

   Linux & macOS

   aws ssm describe-maintenance-windows

   Windows

   aws ssm describe-maintenance-windows

   PowerShell

   Get-SSMMaintenanceWindows

   記下您要移除標籤的維護時段 ID。

2. 執行以下命令，從維護時段移除標籤。將每個範例資源預留位置取代為您自己的資訊。

   Linux & macOS

   aws ssm remove-tags-from-resource \
       --resource-type "MaintenanceWindow" \
       --resource-id "window-id" \
       --tag-key "tag-key"

   Windows

   aws ssm remove-tags-from-resource ^
       --resource-type "MaintenanceWindow" ^
       --resource-id "window-id" ^
       --tag-key "tag-key"

   PowerShell

   Remove-SSMResourceTag `
       -ResourceType "MaintenanceWindow" `
       -ResourceId "window-id" `
       -TagKey "tag-key

   如果成功，命令不會有輸出。

3. 執行以下命令以確認維護時段標籤。

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "MaintenanceWindow" \
       --resource-id "window-id"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "MaintenanceWindow" ^
       --resource-id "window-id"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "MaintenanceWindow" `
       -ResourceId "window-id"