Grupos de workspaces

Atualizar uma programação cron

Atualiza uma programação cron existente para um grupo de espaços de trabalho. Devem ser fornecidos todos os campos da programação, pois este endpoint implementa semântica de substituição completa. O sistema valida que não exista uma programação em conflito (mesmo tipo, hora e dia após a conversão de fuso horário), excluindo a programação atual que está sendo atualizada. Para eliminar um dispositivo intermediário de uma programação START, omita o campo dispositivo_intermediário.

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

Autorizações

Authorization

string

header

obrigatório

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

Parâmetros de caminho

organization_id

string

obrigatório

O identificador único da organização

Maximum string length: 24

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

workspace_group_id

string

obrigatório

O identificador único do grupo de workspaces

Maximum string length: 24

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

schedule_id

string

obrigatório

O identificador único da programação a ser atualizada

Maximum string length: 24

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

Corpo

application/json

cron_expression

string

obrigatório

Expressão cron que define quando a programação deve ser executada. Formato: minuto hora dia-do-mês mês dia-da-semana. Exemplos: '0 8 * * 1-5' (8 AM dias úteis), '0 0 * * 0' (meia-noite de domingo), '30 14 * * ' (2:30 PM diariamente). Dia-da-semana: 0=domingo, 1=segunda-feira, ..., 6=sábado. Suporta intervalos (1-5), listas (1,3,5) e curingas (). Deve ser um formato de expressão cron válido com 5 campos separados por espaços.

Exemplo:

"0 8 * * 1-5"

time_zone

string

obrigatório

Zona horária para a execução do cronograma. Suporta identificadores IANA (por exemplo, 'America/New_York') e Windows (por exemplo, 'Pacific Standard Time').

Exemplo:

"Eastern Standard Time"

type

enum<string>

obrigatório

Tipo de operação de energia a ser realizada. START: Liga os Workspaces do grupo. STOP: Desliga os Workspaces do grupo. RESTART: Reinicia os Workspaces do grupo.

Opções disponíveis:

start,

stop,

restart

Exemplo:

"start"

intermediate_device

string

Opcional. O identificador único do Workspace de dispositivo intermediário. Se fornecido, indica que deve ser usado um dispositivo intermediário para operações Wake-on-LAN. Aplica-se apenas a programações START. É usado para ações Wake-on-LAN em redes seguras. O Workspace deve existir e pertencer à organização. Para remover um dispositivo intermediário, omita este campo.

Maximum string length: 24

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

Exemplo:

"507f1f77bcf86cd799439050"

Resposta

Programação atualizada corretamente. A resposta contém o recurso atualizado.

string

obrigatório

O identificador único da programação

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

Exemplo:

"507f1f77bcf86cd799439060"

cron_expression

string

obrigatório

Expressão cron que define quando a programação é executada. Formato: minuto hora dia-do-mês mês dia-da-semana.

Exemplo:

"0 8 * * 1-5"

time_zone

string

obrigatório

Zona horária para a execução do cronograma. Suporta identificadores IANA (por exemplo, 'America/New_York') e Windows (por exemplo, 'Pacific Standard Time').

Exemplo:

"Eastern Standard Time"

type

enum<string>

obrigatório

Tipo de operação de energia: START (liga), STOP (desliga), RESTART (reinicia Workspaces)

Opções disponíveis:

start,

stop,

restart

intermediate_device

string | null

O identificador único do workspace do dispositivo intermediário, se estiver configurado. É usado para ações de Wake on LAN em redes seguras.

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

Exemplo:

"507f1f77bcf86cd799439050"

created_by

string | null

ID do usuário que criou a programação

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

Exemplo:

"507f1f77bcf86cd799439070"

Recuperar uma programação cron

Excluir uma programação cron

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