了解參數類型

參數是存放在 中的任何資料片段Parameter Store，例如文字區塊、名稱清單、AMIID、授權金鑰等。您可以集中、安全地在您的指令碼、命令和 SSM 文件中參考這項資料。

當您參考參數時，您可以使用下列慣例指定參數名稱。

{{ssm:parameter-name}}

Parameter Store支援三種參數：String、StringList 和 SecureString。

除了一個例外狀況，當您建立或更新參數時，將參數值輸入為純文字，並且 Parameter Store 不對輸入的文字執行驗證。但是，對於 String 參數，您可以將資料類型指定為 aws:ec2:image，而 Parameter Store 便會驗證您輸入的數值是否為 Amazon EC2 AMI 的正確格式；例如：ami-12345abcdeEXAMPLE。

參數類型：String

依預設，String 參數的值由您輸入的任何文字區塊組成。例如：

參數類型：StringList

StringList 參數的值包含以逗號分隔的值清單，如下列範例所示。

Monday,Wednesday,Friday

CSV,TSV,CLF,ELF,JSON

參數類型：SecureString

SecureString 參數的值是需要以安全方式存放和參考的任何敏感資料。如果您有不希望使用者以純文字更改或參考的資料，例如輕量型秘密或授權金鑰，請使用 SecureString資料類型建立這些參數。

在以下情況中，我們建議使用 SecureString 參數。

您可以針對想要加密的文字資料使用 SecureString 參數類型，例如不需要輪換的輕量型秘密、機密組態資料，或您想要保護的任何其他資料類型。 SecureString 資料會使用 AWS KMS 金鑰加密和解密。您可以使用 提供的預設 KMS 金鑰， AWS 或建立和使用您自己的金鑰 AWS KMS key。(如果想限制使用者對 SecureString 參數的存取，請使用您自己的 AWS KMS key 。如需詳細資訊，請參閱 使用 AWS 預設金鑰和客戶受管金鑰的 IAM 許可。)

您也可以將SecureString參數與其他 參數搭配使用 AWS 服務。在下列範例中，Lambda 函數使用 GetParameters API 擷取 SecureString 參數。

import json
import boto3
ssm = boto3.client('ssm', 'us-east-2')
def get_parameters():
    response = ssm.get_parameters(
        Names=['LambdaSecureString'],WithDecryption=True
    )
    for parameter in response['Parameters']:
        return parameter['Value']
        
def lambda_handler(event, context):
    value = get_parameters()
    print("value1 = " + value)
    return value  # Echo back the first key value

AWS KMS 加密和定價

如果您在建立SecureString參數時選擇 參數類型，Systems Manager 會使用 AWS KMS 來加密參數值。

Parameter Store 建立SecureString參數無需支付 的費用，但使用 AWS KMS 加密的費用確實適用。如需相關資訊，請參閱 AWS Key Management Service 定價。

如需 AWS 受管金鑰 和客戶受管金鑰的詳細資訊，請參閱《 AWS Key Management Service 開發人員指南》中的AWS Key Management Service 概念。如需 Parameter Store和 AWS KMS 加密的詳細資訊，請參閱 AWS Systems Manager Parameter Store如何使用 AWS KMS。

aws kms describe-key --key-id alias/aws/ssm