View a markdown version of this page

Escolha dos níveis de parâmetros no Parameter Store - AWS Systems Manager

Escolha dos níveis de parâmetros no Parameter Store

Para controlar os atributos de armazenamento de parâmetros, o Parameter Store inclui parâmetros padrão e parâmetros avançados. Você configura cada parâmetro individualmente para uma conta e região. A camada de parâmetros determina o tamanho máximo de um valor de parâmetro, o número de parâmetros em uma camada específica que você pode criar, se você pode usar políticas de parâmetros e se as cobranças se aplicam.

Os níveis de parâmetros são diferentes da taxa de throughput de parâmetros. Os níveis controlam os atributos de armazenamento dos parâmetros, enquanto o throughput controla a frequência das solicitações.

Níveis de parâmetros padrão e avançado

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

A tabela a seguir descreve as diferenças entre os níveis de parâmetros.

Recurso ou caso de uso Standard Advanced (Avançado)

Caso de uso

Ideal para a maioria dos dados de configuração e workloads de baixa escala. Esse é o padrão.

É a melhor opção quando você precisa de limites mais altos, valores maiores ou políticas de parâmetros.

Máximo de parâmetros

(por Conta da AWS e Região da AWS)

10.000

100.000

Tamanho máximo do valor

4 KB

8 KB

Políticas de parâmetros

Não compatível

Compatível

Para obter mais informações, consulte Atribuir políticas de parâmetros no Parameter Store.

Capacidade de compartilhamento em Contas da AWS

Não compatível

Compatível

Para obter mais informações, consulte Trabalhar com parâmetros compartilhados no Parameter Store.

Capacidade de upgrade e downgrade

Com possibilidade de upgrade

Sem possibilidade de downgrade

Custo

Sem custos adicionais

Cobranças são aplicáveis

(Para obter mais informações, consulte Preços do AWS Systems Manager para Parameter Store.)

Para obter uma lista completa de cotas e limites do Parameter Store, consulte Endpoints e cotas do AWS Systems Manager na Referência geral da AWS.

Configurações padrão de nível e de parâmetros individuais

O Parameter Store é compatível com as seguintes configurações relacionadas:

  • Nível de parâmetros padrão para sua Conta da AWS e sua região

    Essa configuração determina qual nível será usado pelo Parameter Store quando você criar um novo parâmetro e não especificar explicitamente um nível. Você pode definir o padrão como Standard, Advanced ou Intelligent-Tiering.

  • Nível para um parâmetro específico

    É possível especificar o nível ao criar ou atualizar um parâmetro individual. É possível alterar um parâmetro padrão para um parâmetro avançado, mas não é possível alterar um parâmetro avançado para um parâmetro padrão.

O nível padrão dos parâmetros é distinto do nível de um parâmetro individual. A alteração do nível padrão dos parâmetros afeta apenas os novos parâmetros criados sem a especificação de um nível. Os parâmetros existentes não são afetados.

Visualizar as configurações dos níveis de parâmetros

Você pode visualizar a configuração de nível padrão para sua Conta da AWS e região e a configuração de nível para cada parâmetro individual.

Visualizar o nível de parâmetros padrão

Para visualizar o nível de parâmetros padrão para sua Conta da AWS e região, utilize a ação . O exemplo a seguir recupera o nível padrão de parâmetros.

aws ssm get-service-setting \ --region us-east-1 \ --setting-id arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/default-parameter-tier

O exemplo a seguir mostra uma saída.

{ "ServiceSetting": { "SettingId": "/ssm/parameter-store/default-parameter-tier", "SettingValue": "Standard", "Status": "Default" } }

Visualizar o nível de um parâmetro específico

Para visualizar o nível de um parâmetro específico, utilize a ação . O exemplo a seguir retorna o nível do parâmetro /myapp/dev/log-level.

aws ssm describe-parameters \ --region us-east-1 \ --parameter-filters "Key=Name,Option=Equals,Values=/myapp/dev/log-level" \ --query "Parameters[0].Tier" \ --output text

O comando retorna o nível do parâmetro, como Standard ou Advanced.

Limitações à alteração de níveis para parâmetros individuais

É possível trocar um parâmetro padrão por um parâmetro avançado a qualquer momento. Não é possível trocar um parâmetro avançado por um parâmetro padrão pelos seguintes motivos:

  • Alterar o parâmetro para o nível padrão truncaria o valor do parâmetro de 8 KB para 4 KB, resultando em perda de dados.

  • Alterar o parâmetro para o nível padrão removeria quaisquer políticas associadas a ele.

  • Os parâmetros avançados e padrão utilizam formas diferentes de criptografia.

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.

O nível de parâmetros padrão é uma configuração separada. Você pode alterar o nível de parâmetros padrão de uma Conta da AWS e Região de Standard para Advanced e, em seguida, alterá-lo novamente para Standard. A configuração de camada padrão afeta somente os novos parâmetros que você cria sem especificar um nível. Os parâmetros existentes não são afetados.

Por exemplo, você pode criar parâmetros enquanto o nível padrão for Standard e, em seguida, definir o nível de parâmetros padrão como Advanced. Novos parâmetros que você cria sem especificar um nível usam o nível Advanced. Posteriormente, você pode alterar o nível padrão de volta para Standard sem alterar o nível dos parâmetros existentes.

Parâmetros avançados incorrem em cobranças. (Para obter mais informações, consulte Preços do AWS Systems Manager para Parameter Store.)