View a markdown version of this page

Especificar um nível de parâmetro padrão - AWS Systems Manager

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

Ao criar ou atualizar um parâmetro usando a operação PutParameter, você pode especificar o nível de parâmetro. Veja um exemplo da 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"

Quando você especifica um nível em uma solicitação de criação ou atualização, o Parameter Store usa esse nível. Se nenhum nível for especificado, o nível a ser usado será determinado pela configuração de nível padrão.

Por padrão, o Parameter Store usa o nível de parâmetro padrão. Se o nível de parâmetro avançado estiver habilitado, você pode definir uma das opções a seguir como padrão:

  • Avançado: todos os parâmetros são criados como avançados.

  • Intelligent-Tiering: o Parameter Store avalia cada solicitação e seleciona o nível apropriado.

    Com o Intelligent-Tiering, o Parameter Store cria um parâmetro no nível padrão, a menos que a solicitação inclua opções que exijam o nível avançado. Se houver a solicitação de atributos avançados, o parâmetro será criado como avançado.

Sobre o nível de parâmetro padrão

Por padrão, quando um novo parâmetro é criado, o Parameter Store atribui a ele o nível Padrão. Os parâmetros padrão estão disponíveis gratuitamente, mas há restrições de tamanho e atributos, conforme descrito em Parâmetros padrão e avançado. Se seus casos de uso não forem compatíveis com os parâmetros padrão, defina o nível Avançado como padrão. O nível Avançado oferece limites mais altos e atributos extras a um determinado custo. (Para obter mais informações, consulte Preços do AWS Systems Manager para Parameter Store.)

Para maximizar a eficiência e reduzir os custos, você pode definir o Intelligent-Tiering como padrão. Esse atributo determina se o nível Padrão ou Avançado deve ser usado com base no conteúdo da solicitação. Por exemplo, se você executar um comando para criar um parâmetro que atenda a todos os critérios de um parâmetro padrão, o Intelligent-Tiering cria o parâmetro no nível Padrão. Se você executar um comando para criar um parâmetro em que um ou mais critérios não atendam aos requisitos do nível Padrão, o Intelligent-Tiering cria o parâmetro no nível Avançado.

O Intelligent-Tiering oferece os seguintes benefícios:

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:

  • Os modelos do AWS CloudFormation provisionam vários parâmetros quando são executados. Quando esse processo faz com que você atinja a cota de 10.000 parâmetros no nível de parâmetro padrão, o Intelligent-Tiering atualiza automaticamente você para o nível de parâmetro avançado, e os processos do CloudFormation não são interrompidos.

  • Você armazena um valor de certificado em um parâmetro, alterna o valor do certificado regularmente, e o conteúdo é inferior à cota de 4 KB do nível de parâmetro padrão. Se o valor de um certificado de substituição exceder 4 KB, o Intelligent-Tiering atualizará automaticamente o parâmetro para o nível de parâmetro avançado.

  • Você deseja associar vários parâmetros padrão existentes a uma política de parâmetros, que requer o nível de parâmetro avançado. Em vez de incluir a opção --tier Advanced nas chamadas para atualizar os parâmetros, o Intelligent-Tiering atualiza automaticamente os parâmetros para o nível Avançado.

O Intelligent-Tiering atualiza os parâmetros do nível Padrão para o Avançado sempre que os critérios do nível de parâmetro avançado forem introduzidos.

nota

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