Grups de Workspaces

Crear una programació cron

Crea una nova programació cron per a un grup de workspaces. Les programacions defineixen operacions automatitzades d’energia (START, STOP, RESTART) que es executen en programacions especificades segons expressions cron i zona horària. Les programacions START poden incloure opcionalment un ID de Workspace de dispositiu intermedi per operacions Wake on LAN en xarxes segures. Si es proporciona intermediate_device, indica que s’ha d’utilitzar un dispositiu intermedi. El sistema valida que no existeixi una programació en conflicte (mateix tipus, hora i dia després de la conversió de zona horària).

POST

organizations

{organization_id}

workspace-groups

{workspace_group_id}

schedules

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cron_expression": "0 8 * * 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>"
  }
}

Autoritzacions

Authorization

string

header

requerit

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

Paràmetres de ruta

organization_id

string

requerit

El identificador únic de l'organització

Maximum string length: 24

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

workspace_group_id

string

requerit

L'identificador únic del grup de workspaces

Maximum string length: 24

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

Cos

application/json

cron_expression

string

requerit

Expressió cron que defineix quan s'ha d'executar la programació. Format: minut hora dia-del-mes mes dia-de-la-setmana. Exemples: '0 8 * * 1-5' (8 AM en dies laborables), '0 0 * * 0' (mitjanit del diumenge), '30 14 * * ' (2:30 PM diàriament). Dia-de-la-setmana: 0=diumenge, 1=dilluns, ..., 6=dissabte. Admet rangs (1-5), llistes (1,3,5) i comodins (). Ha de ser un format d'expressió cron vàlid amb 5 camps separats per espais.

Exemple:

"0 8 * * 1-5"

time_zone

string

requerit

Zona horària per a l'execució de la programació. Admet identificadors IANA (per exemple, 'America/New_York') i Windows (per exemple, 'Pacific Standard Time').

Exemple:

"Eastern Standard Time"

type

enum<string>

requerit

Tipus d'operació d'energia a realitzar. START: Encén els Workspaces del grup. STOP: Apaga els Workspaces del grup. RESTART: Reinicia els Workspaces del grup.

Opcions disponibles:

start,

stop,

restart

Exemple:

"start"

intermediate_device

string

Opcional. L'identificador únic del Workspace de dispositiu intermedi. Si es proporciona, indica que s'ha d'utilitzar un dispositiu intermedi per operacions Wake on LAN. Només aplicable a programacions START. S'utilitza per a accions Wake on LAN en xarxes segures. El Workspace ha d'existir i pertànyer a l'organització.

Maximum string length: 24

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

Exemple:

"507f1f77bcf86cd799439050"

Resposta

Programació creada correctament. La resposta conté el recurs de programació creat.

string

requerit

L'identificador únic de la programació

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

Exemple:

"507f1f77bcf86cd799439060"

cron_expression

string

requerit

Expressió cron que defineix quan es executa la programació. Format: minut hora dia-del-mes mes dia-de-la-setmana.

Exemple:

"0 8 * * 1-5"

time_zone

string

requerit

Zona horària per a l'execució de la programació. Admet identificadors IANA (per exemple, 'America/New_York') i Windows (per exemple, 'Pacific Standard Time').

Exemple:

"Eastern Standard Time"

type

enum<string>

requerit

Tipus d'operació d'energia: START (encén), STOP (apaga), RESTART (reinicia Workspaces)

Opcions disponibles:

start,

stop,

restart

intermediate_device

string | null

L'identificador únic del Workspace del dispositiu intermedi, si està configurat. S'utilitza per a accions de Wake on LAN en xarxes segures.

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

Exemple:

"507f1f77bcf86cd799439050"

created_by

string | null

ID d'usuari que va crear la programació

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

Exemple:

"507f1f77bcf86cd799439070"

Llistar programacions cron

Llistar grups d'espais de treball

Següent

⌘I

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cron_expression": "0 8 * * 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>"
  }
}