標記 Systems Manager 文件 - AWS Systems Manager
建立包含標籤的文件新增標籤至現有文件從 SSM 文件移除標籤

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

標記 Systems Manager 文件

本節中的主題說明如何在 Systems Manager 文件 (SSM 文件) 上使用標籤。

建立包含標籤的文件

您可以在建立自訂 SSM 文件時將標籤新增至其中。

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

新增標籤至現有文件

您可以使用 Systems Manager 主控台或命令列將標籤新增至您擁有的自訂 SSM 文件。

將標籤新增到現有的 SSM 文件 (主控台)

  1. 開啟主 AWS Systems Manager 控台，網址為 https://console.aws.amazon.com/systems-manager/。

  2. 在導覽窗格中，選擇 Documents (文件)。

  3. 選擇 Owned by me (我所擁有) 索引標籤。

  4. 選擇要新增標籤的文件名稱，然後選擇 Details (詳細資訊) 索引標籤。

  5. 在 Tags (標籤) 區段中，選擇 Edit (編輯)，然後新增一或多個鍵值標籤組。

  6. 選擇儲存。

將標籤新增至現有的 SSM 文件 (命令列)

若要將標籤新增至現有的 SSM 文件 (命令列)

  1. 使用您偏好的命令列工具，執行以下命令來檢視您可以標記的文件。

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList

    請記下您要標記之文件的名稱。

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

    Linux & macOS
    aws ssm add-tags-to-resource \
    --resource-type "Document" \
    --resource-id "document-name" \
    --tags "Key=tag-key,Value=tag-value"
    Windows
    aws ssm add-tags-to-resource ^
    --resource-type "Document" ^
    --resource-id "document-name" ^
    --tags "Key=tag-key,Value=tag-value"
    PowerShell
    $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag
    $tag.Key = "tag-key"
    $tag.Value = "tag-value"
    Add-SSMResourceTag `
    -ResourceType "Document" `
    -ResourceId "document-name" `
    -Tag $tag `
    -Force

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

  3. 執行以下命令來驗證文件標記。

    Linux & macOS
    aws ssm list-tags-for-resource \
    --resource-type "Document" \
    --resource-id "document-name"
    Windows
    aws ssm list-tags-for-resource ^
    --resource-type "Document" ^
    --resource-id "document-name"
    PowerShell
    Get-SSMResourceTag `
    -ResourceType "Document" `
    -ResourceId "document-name"

從 SSM 文件移除標籤

您可以使用 Systems Manager 主控台或命令列從 SSM 文件中移除標籤。

從 SSM 文件移除標籤 (主控台)

  1. 開啟主 AWS Systems Manager 控台，網址為 https://console.aws.amazon.com/systems-manager/。

  2. 在導覽窗格中，選擇 Documents (文件)。

  3. 選擇 Owned by me (我所擁有) 索引標籤。

  4. 選擇要移除標籤的文件名稱，然後選擇 Details (詳細資訊) 索引標籤。

  5. 在 Tags (標籤) 區段中，選擇 Edit (編輯)，然後選擇不再需要之標籤組旁邊的 Remove (移除)。

  6. 選擇儲存。

從 SSM 文件移除標籤 (命令列)

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

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList

    記下您要從中移除標籤的文件名稱。

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

    Linux & macOS
    aws ssm remove-tags-from-resource \
    --resource-type "Document" \
    --resource-id "document-name" \
    --tag-key "tag-key"
    Windows
    aws ssm remove-tags-from-resource ^
    --resource-type "Document" ^
    --resource-id "document-name" ^
    --tag-key "tag-key"
    PowerShell
    Remove-SSMResourceTag `
    -ResourceId "document-name" `
    -ResourceType "Document" `
    -TagKey "tag-key" `
    -Force

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

  3. 執行以下命令來驗證文件標記。

    Linux & macOS
    aws ssm list-tags-for-resource \
    --resource-type "Document" \
    --resource-id "document-name"
    Windows
    aws ssm list-tags-for-resource ^
    --resource-type "Document" ^
    --resource-id "document-name"
    PowerShell
    Get-SSMResourceTag `
    -ResourceType "Document" `
    -ResourceId "document-name"