編輯 Security Hub CSPM 資源的標籤 - AWS Security Hub

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

編輯 Security Hub CSPM 資源的標籤

隨著環境或需求隨時間變更，您可以評估 AWS Security Hub CSPM 資源的現有標籤，並視需要變更標籤。標籤是您定義並指派給一或多個 AWS 資源的標籤，包括特定類型的 Macie 資源。每個標籤都包含必要的標籤索引鍵和選用的標籤值。標籤索引鍵是一般標籤，可做為更特定標籤值的類別。標籤值是標籤金鑰的描述項。

標籤可協助您以不同的方式識別、分類和管理資源，例如依用途、擁有者、環境或其他條件。例如，您可以使用標籤來：套用政策、配置成本、區分資源版本，或識別支援特定合規要求或工作流程的資源。

您可以將標籤新增至下列類型的 Security Hub CSPM 資源：

  • 自動化規則

  • 組態政策

  • Hub 資源

若要編輯 Security Hub CSPM 資源的標籤索引鍵或標籤值，您可以使用 Security Hub CSPM API。Security Hub CSPM 主控台目前不支援標籤編輯。

重要

編輯資源的標籤可能會影響對資源的存取。在編輯資源的標籤之前，請檢閱任何可能使用標籤來控制資源存取的 AWS Identity and Access Management (IAM) 政策。

Security Hub CSPM API

編輯 Security Hub CSPM 資源 (API) 的標籤

當您以程式設計方式編輯資源的標籤時，會以新的值覆寫現有的標籤。因此，編輯標籤的最佳方式取決於您要編輯標籤索引鍵、標籤值或兩者。若要編輯標籤索引鍵，請移除目前的標籤並新增標籤。

若要編輯或僅移除與標籤金鑰相關聯的標籤值，請使用 Security Hub CSPM API 的 TagResource 操作覆寫現有的值。如果您使用的是 AWS CLI，請執行 tag-resource 命令。在您的請求中，指定您要編輯或移除其標籤值之資源的 Amazon Resource Name (ARN)。

若要編輯標籤值，請使用 tags 參數來指定您要變更其標籤值的標籤索引鍵。您也應該指定金鑰的新標籤值。例如，下列 AWS CLI 命令ProdTest會將指派給指定自動化規則的標籤金鑰的Environment標籤值從 變更為 。此範例已針對 Linux、macOS 或 Unix 格式化，並使用反斜線 (\) 行接續字元來改善可讀性。

$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags '{"Environment":"Test"}'

其中：

  • resource-arn 指定組態政策的 ARN。

  • Environment 是與要變更的標籤值相關聯的標籤索引鍵。

  • Test 是指定標籤索引鍵 () 的新標籤值Environment。

若要從標籤索引鍵移除標籤值，請勿在 tags 參數中指定索引鍵value引數的值。例如：

$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags '{"Owner":""}'

如果操作成功，Security Hub CSPM 會傳回空的 HTTP 200 回應。否則，Security Hub CSPM 會傳回 HTTP 4xx 或 500 回應，指出操作失敗的原因。