Todos os produtos
Search
Central de documentação

Key Management Service:RotateSecret

Última atualização: Jun 28, 2026

Rotaciona imediatamente um segredo.

Descrição da operação

Limites:

• Um segredo de cada conta da Alibaba Cloud pode ser rotacionado no máximo 50 vezes por hora.

• A operação RotateSecret não está disponível para segredos padrão.

Neste exemplo, o segredo RdsSecret/Mysql5.4/MyCred é rotacionado manualmente, e o número da versão do segredo é definido como 000000123 após a rotação do segredo.

Para obter mais informações sobre a política de acesso necessária para que um usuário RAM ou uma função RAM chame esta API, consulte Resource Access Management.

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

VersionId

string

Sim

O número da versão do segredo após a rotação do segredo.

Nota

O número da versão é usado para garantir a idempotência da solicitação. O Secrets Manager usa este número de versão para impedir que seu aplicativo crie a mesma versão do segredo ao repetir uma solicitação. Se o número da versão já existir, o Secrets Manager ignora a solicitação de rotação e retorna uma mensagem de sucesso.

000000123

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

VersionId

string

O número da versão do segredo após a rotação do segredo.

000000123

SecretName

string

O nome do segredo.

RdsSecret/Mysql5.4/MyCred

RequestId

string

O ID da solicitação.

10257c86-269d-43aa-aaf3-90ed4144bb7c

Arn

string

O Alibaba Cloud Resource Name (ARN) do segredo.

acs:kms:cn-hangzhou:154035569884****:secret/RdsSecret/Mysql5.4/MyCred

Exemplos

Resposta de sucesso

JSON formato

{
  "VersionId": "000000123",
  "SecretName": "RdsSecret/Mysql5.4/MyCred",
  "RequestId": "10257c86-269d-43aa-aaf3-90ed4144bb7c",
  "Arn": "acs:kms:cn-hangzhou:154035569884****:secret/RdsSecret/Mysql5.4/MyCred"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.