Grupos de workspaces

Actualizar una programación cron

Actualiza una programación cron existente para un grupo de workspaces. Se deben proporcionar todos los campos de la programación, ya que este endpoint implementa semántica de reemplazo completo. El sistema valida que no exista una programación en conflicto (mismo tipo, hora y día después de la conversión de zona horaria), excluyendo la programación actual que se está actualizando. Para eliminar un dispositivo intermedio de una programación START, omita el campo intermediate_device.

PUT

organizations

{organization_id}

workspace-groups

{workspace_group_id}

schedules

{schedule_id}

curl --request PUT \
  --url https://api.staging.flxwvdexternal.com/v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules/{schedule_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cron_expression": "0 9 * * 1-5",
  "time_zone": "Eastern Standard Time",
  "type": "start"
}
'

{
  "id": "507f1f77bcf86cd799439060",
  "cron_expression": "0 8 * * 1-5",
  "time_zone": "Eastern Standard Time",
  "intermediate_device": "507f1f77bcf86cd799439050",
  "created_by": "507f1f77bcf86cd799439070"
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

organization_id

string

requerido

El identificador único de la organización

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

workspace_group_id

string

requerido

El identificador único del grupo de workspaces

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

schedule_id

string

requerido

El identificador único de la programación a actualizar

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Cuerpo

application/json

cron_expression

string

requerido

Expresión cron que define cuándo debe ejecutarse la programación. Formato: minuto hora día-del-mes mes día-de-la-semana. Ejemplos: '0 8 * * 1-5' (8 AM entre semana), '0 0 * * 0' (medianoche del domingo), '30 14 * * ' (2:30 PM diariamente). Día-de-la-semana: 0=domingo, 1=lunes, ..., 6=sábado. Admite rangos (1-5), listas (1,3,5) y comodines (). Debe ser un formato de expresión cron válido con 5 campos separados por espacios.

Ejemplo:

"0 8 * * 1-5"

time_zone

string

requerido

Zona horaria para la ejecución de la programación. Admite identificadores IANA (p. ej., 'America/New_York') y Windows (p. ej., 'Pacific Standard Time').

Ejemplo:

"Eastern Standard Time"

type

enum<string>

requerido

Tipo de operación de energía a realizar. START: Enciende los Workspaces del grupo. STOP: Apaga los Workspaces del grupo. RESTART: Reinicia los Workspaces del grupo.

Opciones disponibles:

start,

stop,

restart

Ejemplo:

"start"

intermediate_device

string

Opcional. El identificador único del Workspace de dispositivo intermedio. Si se proporciona, indica que debe usarse un dispositivo intermedio para operaciones de Wake-on-LAN. Solo aplica a programaciones START. Se usa para acciones de Wake-on-LAN en redes seguras. El Workspace debe existir y pertenecer a la organización. Para eliminar un dispositivo intermedio, omita este campo.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Ejemplo:

"507f1f77bcf86cd799439050"

Respuesta

Programación actualizada correctamente. La respuesta contiene el recurso actualizado.

string

requerido

El identificador único de la programación

Pattern: ^[0-9a-f]{24}$

Ejemplo:

"507f1f77bcf86cd799439060"

cron_expression

string

requerido

Expresión cron que define cuándo se ejecuta la programación. Formato: minuto hora día-del-mes mes día-de-la-semana.

Ejemplo:

"0 8 * * 1-5"

time_zone

string

requerido

Zona horaria para la ejecución de la programación. Admite identificadores IANA (p. ej., 'America/New_York') y Windows (p. ej., 'Pacific Standard Time').

Ejemplo:

"Eastern Standard Time"

type

enum<string>

requerido

Tipo de operación de energía: START (enciende), STOP (apaga), RESTART (reinicia Workspaces)

Opciones disponibles:

start,

stop,

restart

intermediate_device

string | null

El identificador único del workspace del dispositivo intermedio, si está configurado. Se usa para acciones de Wake on LAN en redes seguras.

Pattern: ^[0-9a-f]{24}$

Ejemplo:

"507f1f77bcf86cd799439050"

created_by

string | null

ID de usuario que creó la programación

Pattern: ^[0-9a-f]{24}$

Ejemplo:

"507f1f77bcf86cd799439070"

Recuperar una programación cron

Eliminar una programación cron

⌘I

curl --request PUT \
  --url https://api.staging.flxwvdexternal.com/v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules/{schedule_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cron_expression": "0 9 * * 1-5",
  "time_zone": "Eastern Standard Time",
  "type": "start"
}
'

{
  "id": "507f1f77bcf86cd799439060",
  "cron_expression": "0 8 * * 1-5",
  "time_zone": "Eastern Standard Time",
  "intermediate_device": "507f1f77bcf86cd799439050",
  "created_by": "507f1f77bcf86cd799439070"
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}