Grups de Workspaces

Actualitzar una programació cron

Actualitza una programació cron existent per a un grup de workspaces. S’han de proporcionar tots els camps de la programació, ja que aquest endpoint implementa semàntica de reemplaç complet. El sistema valida que no existeixi una programació en conflicte (mateix tipus, hora i dia després de la conversió de zona horària), excloent la programació actual que s’està actualitzant. Per eliminar un dispositiu intermedi d’una programació START, omet el camp intermediate_device.

PUT

organizations

{organization_id}

workspace-groups

{workspace_group_id}

schedules

{schedule_id}

curl --request PUT \
  --url https://api.flexxible.net/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>"
  }
}

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

schedule_id

string

requerit

L'identificador únic de la programació a actualitzar

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 entre setmana), '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 a operacions de Wake-on-LAN. Només aplica a programacions START. S'utilitza per a accions de Wake-on-LAN en xarxes segures. El Workspace ha d'existir i pertànyer a l'organització. Per eliminar un dispositiu intermedi, omet aquest camp.

Maximum string length: 24

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

Exemple:

"507f1f77bcf86cd799439050"

Resposta

Programació actualitzada correctament. La resposta conté el recurs actualitzat.

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"

Recuperar una programació cron

Eliminar una programació cron

Següent

⌘I

curl --request PUT \
  --url https://api.flexxible.net/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>"
  }
}