Utilizar GetParameters con una CLI - AWS Systems Manager

AWS Systems Manager Change Manager ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de Change Manager de AWS Systems Manager.

Utilizar GetParameters con una CLI

Los siguientes ejemplos de código muestran cómo utilizar GetParameters.

CLI
AWS CLI

Ejemplo 1: enumeración de los valores de un parámetro

En el siguiente ejemplo de get-parameters se enumeran los valores de los tres parámetros especificados.

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

Salida:

{
    "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"
    ]
}

Para obtener más información, consulte Uso de Parameter Store en la Guía del usuario de AWS Systems Manager.

Ejemplo 2: enumeración de los nombres y valores de varios parámetros mediante la opción “--query”

En el siguiente ejemplo de get-parameters se enumeran los nombres y valores de los parámetros especificados.

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

Salida:

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

Para obtener más información, consulte Uso de Parameter Store en la Guía del usuario de AWS Systems Manager.

Ejemplo 3: visualización del valor de un parámetro mediante etiquetas

En el siguiente ejemplo de get-parameter se enumera el valor del parámetro único especificado con una etiqueta especificada.

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

Salida:

{
    "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": []
}

Para obtener más información, consulte Trabajo con etiquetas de parámetros en la Guía del usuario de AWS Systems Manager.

  • Para obtener información sobre la API, consulte GetParameters en la Referencia de comandos de la AWS CLI.

PowerShell
Herramientas para PowerShell V4

Ejemplo 1: en este ejemplo se enumeran los valores de un parámetro.

Get-SSMParameterValue -Name "Welcome"

Salida:

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

Ejemplo 2: en este ejemplo se enumeran los detalles del valor.

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

Salida:

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

  • Para obtener información sobre la APl, consulte GetParameters en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: en este ejemplo se enumeran los valores de un parámetro.

Get-SSMParameterValue -Name "Welcome"

Salida:

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

Ejemplo 2: en este ejemplo se enumeran los detalles del valor.

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

Salida:

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

  • Para obtener información sobre la APl, consulte GetParameters en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).

Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte Cómo utilizar este servicio con un AWS SDK. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.