GetParameters 搭配 CLI 使用 - AWS SDK 程式碼範例

文件 AWS SDK AWS 範例 SDK 儲存庫中有更多可用的 GitHub 範例。

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

GetParameters 搭配 CLI 使用

下列程式碼範例示範如何使用 GetParameters。

CLI
AWS CLI

範例 1：列出參數的值

下列get-parameters範例列出三個指定參數的值。

aws ssm get-parameters \
    --names "MyStringParameter" "MyStringListParameter" "MyInvalidParameterName"

輸出：

{
    "Parameters": [
        {
            "Name": "MyStringListParameter",
            "Type": "StringList",
            "Value": "alpha,beta,gamma",
            "Version": 1,
            "LastModifiedDate": 1582154764.222,
            "ARN": "arn:aws:ssm:us-east-2:111222333444:parameter/MyStringListParameter"
            "DataType": "text"
        },
        {
            "Name": "MyStringParameter",
            "Type": "String",
            "Value": "Vici",
            "Version": 3,
            "LastModifiedDate": 1582156117.545,
            "ARN": "arn:aws:ssm:us-east-2:111222333444:parameter/MyStringParameter"
            "DataType": "text"
        }
    ],
    "InvalidParameters": [
        "MyInvalidParameterName"
    ]
}

如需詳細資訊，請參閱 AWS Systems Manager 使用者指南中的使用參數存放區。

範例 2：使用 ``--query`` 選項列出多個參數的名稱和值

下列get-parameters範例會列出指定參數的名稱和值。

aws ssm get-parameters \
    --names MyStringParameter MyStringListParameter \
    --query "Parameters[*].{Name:Name,Value:Value}"

輸出：

[
    {
        "Name": "MyStringListParameter",
        "Value": "alpha,beta,gamma"
    },
    {
        "Name": "MyStringParameter",
        "Value": "Vidi"
    }
]

如需詳細資訊，請參閱 AWS Systems Manager 使用者指南中的使用參數存放區。

範例 3：使用標籤顯示參數的值

下列get-parameter範例列出具有指定標籤之指定單一參數的值。

aws ssm get-parameter \
    --name "MyParameter:label"

輸出：

{
    "Parameters": [
        {
            "Name": "MyLabelParameter",
            "Type": "String",
            "Value": "parameter by label",
            "Version": 1,
            "Selector": ":label",
            "LastModifiedDate": "2021-07-12T09:49:15.865000-07:00",
            "ARN": "arn:aws:ssm:us-west-2:786973925828:parameter/MyParameter",
            "DataType": "text"
        },
        {
            "Name": "MyVersionParameter",
            "Type": "String",
            "Value": "parameter by version",
            "Version": 2,
            "Selector": ":2",
            "LastModifiedDate": "2021-03-24T16:20:28.236000-07:00",
            "ARN": "arn:aws:ssm:us-west-2:786973925828:parameter/unlabel-param",
            "DataType": "text"
        }
    ],
    "InvalidParameters": []
}

如需詳細資訊，請參閱 AWS Systems Manager 使用者指南中的使用參數標籤。

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 GetParameters。

PowerShell
for PowerShell 工具

範例 1：此範例會列出 參數的值。

Get-SSMParameterValue -Name "Welcome"

輸出：

InvalidParameters Parameters
----------------- ----------
{}                {Welcome}

範例 2：此範例會列出 值的詳細資訊。

(Get-SSMParameterValue -Name "Welcome").Parameters

輸出：

Name    Type   Value
----    ----   -----
Welcome String Good day, Sunshine!

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 GetParameters。