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.