API de Servidor de Preparación Optimizada

Llamadas de API para publicar y verificar el estado de publicación de servidores de preparación de entornos.

Publicación Optimizada

La publicación optimizada ofrece más control sobre el proceso de publicación de imágenes del servidor de preparación.

Publicar imagen de forma optimizada

POST /environments/{amb_uuid}/servers/template/optimized-publish/

Parámetros de Path

Parámetro	Obligatorio	Descripción
amb_uuid	Si	UUID del entorno

Cuerpo de la Solicitud

Campo	Tipo	Descripción
stop_server	boolean	Si el servidor de preparación debe ser detenido durante la creación de la imagen.
notify_list	array	Lista de correos electrónicos a ser notificados al finalizar la publicación.
replace_instances	object	Configuraciones de publicación.
replace_instances.block_instances	boolean	Si las instancias con versiones anteriores deben ser bloqueadas después de la publicación.
replace_instances.block_users	boolean	Si se debe solicitar la reconexión de los usuarios (requiere block_instances: true)
replace_instances.block_users_message	string	Mensaje de advertencia de reconexión (cuando block_users: true)
replace_instances.block_users_seconds	number	Tiempo de desconexión en segundos (cuando block_users: true)

Valores aceptados para block_users_seconds

Valor	Equivalente
300	5 minutos
600	10 minutos
900	15 minutos
1200	20 minutos
1500	25 minutos
1800	30 minutos

Modos de Publicación

Modo 1 - Predeterminado

Se inician las instancias actualizadas, no se bloquean las instancias anteriores y no se desconectan los usuarios.

{
    "stop_server": false,
    "notify_list": ["[e-mail]"],
    "replace_instances": {
        "block_instances": false,
        "block_users": false
    }
}

Modo 2 - Mantener usuarios conectados

Modo 3 - Solicitar reconexión de usuarios

Opción: Detener el servidor durante la creación

Respuesta

Status: 202 Accepted

{
    "status": 202,
    "message": "Publicación iniciada con éxito.",
    "request_id": "149cbd70-5241-4e62-88a7-c87bcdf2eecc"
}

Verificar status de publicación optimizada

Verifica el estado de la publicación de la imagen para la solicitud especificada.

GET /environments/{amb_uuid}/servers/template/optimized-publish/{request_id}/

Parámetros de Path

Parámetro	Obligatorio	Descripción
amb_uuid	Si	UUID del entorno
request_id	Si	UUID de la solicitud de publicación

Respuesta

Status: 200 OK

{
    "status": 200,
    "image_publication_status": "PUBLISHING",
    "message": "Publicación en curso."
}

Valores posibles de image_publication_status

Valor	Descripción
PUBLISHING	Publicación en curso
PUBLISHED	Publicación completada
ERROR	Publicación completada