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/ Consulta del estado de una versión de secreto

Actualización más reciente 2022-11-03 GMT+08:00

Ver PDF

Consulta del estado de una versión de secreto

Función

Esta API se utiliza para consultar el estado de una versión de secreto especificada.

URI

GET /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).

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
stage	Stage object	Estado de secreto.

**Tabla 4** 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 5** 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

Ninguno

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"
  }
}