Gerenciar camadas de parâmetros

O Parameter Store, um recurso do AWS Systems Manager, inclui parâmetros padrão e parâmetros avançados. Você configura parâmetros individualmente para usar o nível de parâmetros padrão (o padrão) ou o nível de parâmetros avançados.

Você pode transformar um parâmetro padrão em um parâmetro avançado a qualquer momento, mas não pode reverter um parâmetro avançado para um parâmetro padrão. Reverter um parâmetro avançado para um parâmetro padrão resultaria na perda de dados, pois o sistema truncaria o tamanho do parâmetro de 8 KB para 4 KB. A operação de reversão também removeria todas as políticas anexadas ao parâmetro. Além disso, parâmetros avançados usam um formato de criptografia diferente dos parâmetros padrão. Para obter mais informações, consulte Como o AWS Systems Manager   Parameter Store usa o AWS KMS no Guia do desenvolvedor do AWS Key Management Service.

Se você não precisar mais de um parâmetro avançado, ou se não quiser mais ser cobrado por um parâmetro avançado, deverá excluí-lo e recriá-lo como um novo parâmetro padrão.

A tabela a seguir descreve as diferenças entre os níveis.

Especificar um nível de parâmetro padrão

Em solicitações para criar ou atualizar um parâmetro (ou seja, a ação PutParameter), você pode especificar o nível de parâmetro a ser usado na solicitação. Veja a seguir um exemplo de como usar a AWS Command Line Interface (AWS CLI).

Linux & macOS

aws ssm put-parameter \
    --name "default-ami" \
    --type "String" \
    --value "t2.micro" \
    --tier "Standard"

Windows

aws ssm put-parameter ^
    --name "default-ami" ^
    --type "String" ^
    --value "t2.micro" ^
    --tier "Standard"

Sempre que você especifica um nível na solicitação, o Parameter Store cria ou atualiza o parâmetro de acordo com a solicitação. No entanto, se você não especificar explicitamente um nível em uma solicitação, a configuração do nível padrão do Parameter Store determinará o nível em que o parâmetro será criado.

O nível padrão quando você começa a usar o Parameter Store é o nível de parâmetro padrão. Se você usar o nível de parâmetro avançado, poderá especificar um dos seguintes como o padrão:

Benefícios do nível Intelligent-Tiering

Os seguintes motivos podem fazer você escolher o Intelligent-Tiering como o nível padrão.

Controle de custos - o Intelligent-Tiering ajuda a controlar os custos relacionados a parâmetros criando sempre parâmetros padrão, a menos que um parâmetro avançado seja absolutamente necessário.

Atualização automática para o nível de parâmetro avançado - quando você faz uma alteração no código que requer a atualização de um parâmetro padrão para um parâmetro avançado, o Intelligent-Tiering lida com a conversão para você. Você não precisa alterar o código para lidar com a atualização.

Veja alguns exemplos de atualização automática:

As opções que exigem um parâmetro avançado incluem as seguintes:

Opções de nível padrão

As opções de nível que você pode especificar como padrão incluem o seguinte.

Você pode alterar a configuração de nível padrão do Parameter Store a qualquer momento.

Configurar permissões para especificar um nível padrão do Parameter Store

Verifique se você tem permissão no AWS Identity and Access Management (IAM) para alterar o nível de parâmetro padrão no Parameter Store executando uma das seguintes ações:

Conceda as permissões a seguir à entidade do IAM para permitir que um usuário visualize e altere a configuração de nível padrão para parâmetros em uma Região da AWS específica em uma Conta da AWS.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetServiceSetting"                
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:UpdateServiceSetting"
            ],
            "Resource": "arn:aws:ssm:region:account-id:servicesetting/ssm/parameter-store/default-parameter-tier"
        }
    ]
}

Os administradores poderão especificar a permissão de somente leitura ao atribuir as permissões a seguir.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetServiceSetting"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": [
                "ssm:ResetServiceSetting",
                "ssm:UpdateServiceSetting"
            ],
            "Resource": "*"
        }
    ]
}

Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:

Especificar ou alterar o nível padrão do Parameter Store usando o console

O seguinte procedimento mostra como usar o console do Systems Manager para especificar ou alterar o nível de parâmetro padrão para a Conta da AWS e a Região da AWS atuais.

Se você quiser alterar a configuração de nível padrão posteriormente, repita esse procedimento e especifique outra opção de nível padrão.

Especificar ou alterar o nível padrão do Parameter Store usando a AWS CLI

O seguinte procedimento mostra como usar a AWS CLI (Conta da AWS) para alterar a configuração do nível de parâmetro padrão para a conta e a região atuais da Região da AWS.

Se você quiser alterar a configuração do nível padrão novamente, repita esse procedimento e especifique outra opção de SettingValue.

Especificar ou alterar o nível padrão do Parameter Store (PowerShell)

O seguinte procedimento mostra como usar o Tools for Windows PowerShell para alterar a configuração do nível de parâmetro padrão para uma Região da AWS específica em uma conta da Amazon Web Services.

Se você quiser alterar a configuração do nível padrão novamente, repita esse procedimento e especifique outra opção de SettingValue.

Alterar um parâmetro padrão para um parâmetro avançado

Use o procedimento a seguir para transformar um parâmetro padrão em um parâmetro avançado. Para obter informações sobre como criar um novo parâmetro avançado, consulte Criar parâmetros do Parameter Store no Systems Manager.