Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Data Encryption Workshop/ Referencia de la API/ APIs/ API de gestión de secreto/ Gestión de estado de versión de secreto/ Actualización del estado de la versión de un secreto
Actualización más reciente 2022-11-03 GMT+08:00
Ver PDF
Compartir

Actualización del estado de la versión de un secreto

Función

Esta API se utiliza para actualizar el estado de versión de un secreto.

Restricciones

  • Una etiqueta de estado solo se puede usar para una versión de cada secreto. Por ejemplo, si agrega la etiqueta de estado utilizada por la versión A a la versión B, la etiqueta se moverá de la versión A a la versión B. Las versiones sin ningún estado se consideran versiones obsoletas y pueden ser eliminadas automáticamente por CSMS.
  • Un secreto puede tener hasta 12 estados de versión. Un estado solo se puede usar para una versión. SYSCURRENT y SYSPREVIOUS son los estados secretos preconfigurados de un servicio.

URI

PUT /v1/{project_id}/secrets/{secret_name}/stages/{stage_name}

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto

secret_name

Sí

String

Nombre de secreto

stage_name

Sí

String

Nombre de un estado de versión secreta.

Parámetro de solicitud

Tabla 2 Parámetro de header de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).
Tabla 3 Parámetro del cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

version_id

Sí

String

ID de versión de secreto

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

stage

Stage object

Estado de secreto.
Tabla 5 Stage

Parámetro

Tipo

Descripción

name

String

Nombre de un estado de versión secreta.

Restricción: de 1 a 64 caracteres

update_time

Long

Marca de tiempo de actualización de versión secreta. La marca de tiempo indica el total de segundos después del inicio de la fecha de época (1 de enero de 1970).

secret_name

String

Nombre de secreto

version_id

String

ID de versión de secreto

Código de estado: 400

Tabla 6 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error

error_msg

String

Descripción del error

Solicitud de ejemplo

{
  "version_id" : "version_id"
}

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{
  "stage" : {
    "name" : "name",
    "version_id" : "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e",
    "update_time" : 1581507580000,
    "secret_name" : "secret-name-demo"
  }
}

Código de estado

Código de estado

Descripción

200

La solicitud se ha realizado correctamente.

400

Error de solicitud.

Códigos de error

Consulte Códigos de error.