標記維護時段 - AWS Systems Manager

標記維護時段

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

建立包含標籤的維護時段

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

如需詳細資訊,請參閱以下主題:

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

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

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

  1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的 主控台。https://console.aws.amazon.com/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"

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

    windows-id 是您要標記之維護時段的 ID,例如 mw-0c50858d01EXAMPLE。

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

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

  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. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的 主控台。https://console.aws.amazon.com/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

    windows-id 是您要移除標籤之維護時段的 ID,例如 mw-0c50858d01EXAMPLE。

    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"