Grupos de workspaces

Criar uma programação cron

Cria uma nova programação cron para um grupo de workspaces. As programações definem operações automatizadas de energia (START, STOP, RESTART) que são executadas em programações especificadas de acordo com expressões cron e zona horária. As programações START podem incluir opcionalmente um ID de Workspace de dispositivo intermediário para operações Wake on LAN em redes seguras. Se intermediate_device for fornecido, indica que um dispositivo intermediário deve ser usado. O sistema valida que nenhuma programação em conflito exista (mesmo tipo, hora e dia após a conversão 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>"
  }
}

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

Corpo

application/json

cron_expression

string

obrigatório

Expressão cron que define quando o cronograma deve ser executado. Formato: minuto hora dia-do-mês mês dia-da-semana. Exemplos: '0 8 * * 1-5' (8 da manhã em dias de semana), '0 0 * * 0' (meia-noite do domingo), '30 14 * * ' (2:30 da tarde 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 um dispositivo intermediário deve ser usado para operações Wake on LAN. Aplicável apenas a programações START. É usado para ações Wake on LAN em redes seguras. O Workspace deve existir e pertencer à organização.

Maximum string length: 24

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

Exemplo:

"507f1f77bcf86cd799439050"

Resposta

Programação criada corretamente. A resposta contém o recurso de programação criado.

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"

Listar programações cron

Listar grupos de espaços de trabalho

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