Atualização do status da versão de um segredo
Função
Essa API é usada para atualizar o status da versão de um segredo.
Restrições
- Uma tag de status pode ser usada para apenas uma versão de cada segredo. Por exemplo, se você adicionar a tag de status usada pela versão A à versão B, a tag será movida da versão A para a versão B. Versões sem nenhum status são consideradas versões obsoletas e podem ser excluídas automaticamente pelo CSMS.
- Um segredo pode ter até 12 status de versão. Um status pode ser usado para apenas uma versão. SYSCURRENT e SYSPREVIOUS são os status de segredo pré-configurados de um serviço.
URI
PUT /v1/{project_id}/secrets/{secret_name}/stages/{stage_name}
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto |
secret_name |
Sim |
String |
Nome de segredo |
stage_name |
Sim |
String |
Nome do status de uma versão de segredo. |
Parâmetro de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. Ele pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho da resposta). |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
version_id |
Sim |
String |
ID da versão de segredo |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
stage |
Stage object |
Status de segredo |
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
String |
Nome do status de uma versão de segredo. Restrição: comprimento de 1 a 64 caracteres |
update_time |
Long |
Carimbo de data/hora da atualização de versão de segredo. O carimbo de data/hora indica o total de segundos após o início da data da época (1º de janeiro de 1970). |
secret_name |
String |
Nome de segredo |
version_id |
String |
ID da versão de segredo |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro |
error_msg |
String |
Descrição do erro |
Exemplo de solicitação
{ "version_id" : "version_id" }
Exemplo de resposta
Código de status: 200
O pedido foi bem-sucedido.
{ "stage" : { "name" : "name", "version_id" : "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e", "update_time" : 1581507580000, "secret_name" : "secret-name-demo" } }
Código de status
Código de status |
Descrição |
---|---|
200 |
O pedido foi bem-sucedido. |
400 |
Erro na solicitação. |
Código de erro
Para obter detalhes, consulte Códigos de erro.