Todos os produtos
Search
Central de documentação

Key Management Service:UpdateSecretRotationPolicy

Última atualização: Jun 28, 2026

Atualiza a política de rotação de um segredo.

Descrição da operação

Após a rotação automática ser ativada, o Secrets Manager agenda a primeira rotação automática adicionando o intervalo de rotação predefinido ao timestamp da última rotação.

Limites: a operação UpdateSecretRotationPolicy não pode ser usada para atualizar a política de rotação de segredos genéricos.

Neste exemplo, a política de rotação do segredo RdsSecret/Mysql5.4/MyCred é atualizada. As seguintes configurações são modificadas:

  • O parâmetro EnableAutomaticRotation é definido como true, o que indica que a rotação automática está ativada.

  • O parâmetro RotationInterval é definido como 30d, o que indica que o intervalo para rotação automática é de 30 dias.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SecretName

string

Sim

O nome do segredo.

RdsSecret/Mysql5.4/MyCred

EnableAutomaticRotation

boolean

Sim

Especifica se a rotação automática deve ser ativada. Valores válidos:

  • true: ativa a rotação automática.

  • false: não ativa a rotação automática. Este é o valor padrão.

true

RotationInterval

string

Não

O intervalo para rotação automática. Valores válidos: de 6 horas a 8.760 horas (365 dias).

O valor está no formato integer[unit].

A unidade pode ser d (dia), h (hora), m (minuto) ou s (segundo). Por exemplo, tanto 7d quanto 604800s indicam um intervalo de sete dias.

Nota

Este parâmetro é obrigatório se você definir o parâmetro EnableAutomaticRotation como true. Este parâmetro é ignorado se você definir o parâmetro EnableAutomaticRotation como false ou não especificar o parâmetro EnableAutomaticRotation.

30d

Para obter mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

SecretName

string

O nome do segredo.

RdsSecret/Mysql5.4/MyCred

RequestId

string

O ID da solicitação, que é usado para localizar e solucionar problemas.

2c124f6f-4210-499f-b88a-69f54004d2d8

Exemplos

Resposta de sucesso

JSON formato

{
  "SecretName": "RdsSecret/Mysql5.4/MyCred",
  "RequestId": "2c124f6f-4210-499f-b88a-69f54004d2d8"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.