Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Data Encryption Workshop/ Referência de API/ APIs/ APIs de gerenciamento de segredo/ Gerenciamento do status da versão de segredos/ Atualização do status da versão de um segredo
Atualizado em 2023-02-28 GMT+08:00
Ver PDF
Compartilhar

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}

Tabela 1 Parâmetros de URI

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

Tabela 2 Parâmetro de cabeçalho 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).
Tabela 3 Parâmetro do corpo da solicitação

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

Tabela 4 Parâmetro do corpo da resposta

Parâmetro

Tipo

Descrição

stage

Stage object

Status de segredo
Tabela 5 Etapa

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

Tabela 6 Parâmetros de corpo da resposta

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.