參數存放區參考

參數是存放在 中的任何資料片段Parameter Store，例如文字區塊、名稱清單、AMIID、商家 ID 或其他組態值。您可以在指令碼、命令和 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 用於需要加密的組態值，例如服務端點和帳戶識別符。對於資料庫登入資料、API 金鑰或字符等秘密，我們建議提供專門建置的安全控制 AWS Secrets Manager，包括自動輪換和跨區域複寫。

只有 參數值會加密。參數名稱、描述和其他中繼資料不會加密。

Parameter Store 使用 AWS KMS 金鑰加密和解密SecureString參數值。您可以使用 AWS 受管金鑰 的預設值Parameter Store或客戶受管金鑰。當您需要限制哪些委託人可以解密特定參數時，請使用客戶受管金鑰。如需詳細資訊，請參閱使用 AWS KMS 金鑰加密和解密參數。

您可以搭配其他 使用SecureString參數 AWS 服務。下列 Lambda 函數會從 /myapp/dev/vendor/merchant-id 參數擷取加密的商家 ID。函數使用 值，而不將其寫入函數日誌或在回應中傳回。

import json
import boto3

ssm = boto3.client("ssm", region_name="us-east-1")

def lambda_handler(event, context):
    response = ssm.get_parameter(
        Name="/myapp/dev/vendor/merchant-id",
        WithDecryption=True
    )

    merchant_id = response["Parameter"]["Value"]

    # Use merchant_id when communicating with the vendor system.
    # Don't write the value to logs or include it in the response.

    return {
        "statusCode": 200,
        "body": json.dumps("Vendor configuration retrieved.")
    }

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 \
    --region us-east-1 \
    --key-id alias/aws/ssm

參數名稱限制條件

使用此主題中的資訊，在建立參數時協助您為參數名稱指定有效的值。

此資訊可補充 AWS Systems Manager API 參考中 PutParameter 主題的詳細資訊，它還提供有關 AllowedPattern (允許的模式)、Description (說明)、KeyId (金鑰 ID)、Overwrite (覆寫)、Type (類型) 以及 Value (值) 等值的資訊。

參數名稱的要求和條件約束包含下列項目：