本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
標籤有助於識別和組織您的 AWS 資源。您可以在建立 KMS 金鑰時將標籤新增至客戶受管金鑰,或將標籤新增至現有的 KMS 金鑰。您無法標記 AWS 受管金鑰。
下列程序示範如何使用 主控台和 AWS KMS API 將 AWS KMS 標籤新增至客戶受管金鑰。 AWS KMS API 範例使用 AWS Command Line Interface (AWS CLI)
建立 KMS 金鑰時新增標籤
當您使用 AWS KMS 主控台或 CreateKey 操作建立金鑰時,您可以將標籤新增至 KMS 金鑰。若要在建立 KMS 金鑰時新增標籤,除了建立 KMS 金鑰所需的kms:TagResource
許可之外,您還必須在 IAM 政策中擁有許可。此許可至少必須涵蓋帳戶和區域中的所有 KMS 金鑰。如需詳細資訊,請參閱 控制對標籤的存取。
若要在主控台中建立 KMS 金鑰時新增標籤,除了標記和建立 KMS 金鑰所需的許可之外,您還必須擁有在主控台中檢視 KMS 金鑰所需的許可。此許可至少必須涵蓋帳戶和區域中的所有 KMS 金鑰。
-
登入 AWS Management Console ,並在 https://https://console.aws.amazon.com/kms
開啟 AWS Key Management Service (AWS KMS) 主控台。 -
若要變更 AWS 區域,請使用頁面右上角的區域選擇器。
-
在導覽窗格中,選擇 Customer managed keys (客戶受管金鑰)。(您無法管理 AWS 受管金鑰的標籤)
-
選擇金鑰類型,然後選擇 Next (下一頁)。
-
輸入別名和選用描述。
-
輸入標籤索引鍵和選用的標籤值。若要新增其他標籤,請選擇 Add tag (新增標籤)。若要移除標籤,請選擇 Remove (移除)。標記完新的 KMS 金鑰後,選擇 Next (下一頁)。
-
完成建立 KMS 金鑰。
若要在使用 CreateKey 操作建立金鑰時指定標籤,請使用 操作的 Tags
參數。
CreateKey
的 Tags
參數值是區分大小寫的標籤鍵和標籤值對的集合。KMS 金鑰上的每個標籤必須有不同的標籤名稱。標籤值可以為 null 或空字串。
例如,以下 AWS CLI 命令會建立具有Project:Alpha
標籤的對稱加密 KMS 金鑰。指定多個索引鍵/值組時,請使用空格來分隔每一組。
$
aws kms create-key --tags TagKey=Project,TagValue=Alpha
此命令成功時,會傳回包含新 KMS 金鑰相關資訊的 KeyMetadata
物件。但是,KeyMetadata
不包含標籤。若要取得標籤,請使用 ListResourceTags 操作。
將標籤新增至現有的 KMS 金鑰
您可以在 AWS KMS 主控台或使用 TagResource 操作,將標籤新增至現有的客戶受管 KMS 金鑰。若要新增標籤,您需要在 KMS 金鑰上標記許可。您可以從 KMS 金鑰的金鑰政策取得此許可,或者如果金鑰政策允許,則從包含 KMS 金鑰的 IAM 政策取得此許可。
-
登入 AWS Management Console ,並在 https://https://console.aws.amazon.com/kms
開啟 AWS Key Management Service (AWS KMS) 主控台。 -
若要變更 AWS 區域,請使用頁面右上角的區域選擇器。
-
在導覽窗格中,選擇 Customer managed keys (客戶受管金鑰)。(您無法管理 AWS 受管金鑰的標籤)
-
您可以使用資料表篩選器,只顯示具有特定標籤的 KMS 金鑰。如需詳細資訊,請參閱使用 AWS KMS 主控台檢視標籤。
-
選取 KMS 金鑰別名旁的核取方塊。
-
選擇 Key actions (金鑰動作)、Add or edit tags (新增或編輯標籤)。
-
在 KMS 金鑰的詳細資訊頁面上,選擇 Tags (標籤) 索引標籤。
-
若要建立您的第一個標籤,請選擇 Cretate tag (建立標籤),輸入標籤索引鍵 (必要) 和標籤值 (選用),然後選擇 Save (儲存)。
如果您將標籤值保留空白,則實際標籤值為 null 或空字串。
-
若要新增標籤,請選擇 Edit (編輯),選擇 Add tag (新增標籤),輸入標籤索引鍵和標籤值,然後選擇 Save (儲存)。
-
-
若要儲存您所做的變更,請選擇 Save changes (儲存變更)。
TagResource 操作會新增一或多個標籤至 KMS 金鑰。您無法使用此操作在不同的 中新增標籤 AWS 帳戶。您也可以使用 TagResource 操作來編輯現有的標籤。如需詳細資訊,請參閱編輯與 KMS 金鑰相關聯的標籤。
若要新增標籤,請指定新標籤索引鍵和標籤值。KMS 金鑰上的每個標籤必須有不同的標籤索引鍵。標籤值可以為 null 或空字串。
例如,下列命令會將 Purpose
和 Department
標籤新增至範例 KMS 金鑰。
$
aws kms tag-resource \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --tags TagKey=Purpose,TagValue=Pretest TagKey=Department,TagValue=Finance
當此命令成功時,不會傳回任何輸出。若要檢視 KMS 金鑰上的標籤,請使用 ListResourceTags 操作。