Operacions

Crear operacions

Crea una o diverses operacions en base a l’abast i objectius enviats.

Tipus d’operació disponibles actualment: execute_microservice, delete_workspaces, shutdown_workspaces i restart_workspaces.

Compatibilitat de paràmetres per a execute_microservice

payload.parameters només s’aplica a execucions de microserveis PowerShell a Windows i només és suportat en dispositius amb el nou agent instal·lat.

Els valors enviats en payload.parameters es transmeten com a text (string). La interpretació de tipus depèn de la definició de paràmetres i del parseig implementat en el script del microservei.

Per a aquest context, tipus de dades dels paràmetres recomanats:

string, integer, double, decimal i datetime.
Per a double i decimal, useu notació amb punt decimal (.).
Per a datetime, useu format ISO 8601 (per exemple: 2026-07-09T10:30:00Z).
Quan s’executa al destí, els valors datetime poden representar-se en hora local.
L’execució correcta també depèn de la qualitat i validacions de l’script.

POST

organizations

{organization_id}

operations

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/operations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "execute_microservice",
  "target": {
    "type": "workspaces",
    "ids": [
      "507f1f77bcf86cd799439011",
      "507f1f77bcf86cd799439012"
    ]
  },
  "expiration_in_seconds": 600,
  "payload": {
    "microservice_id": "507f1f77bcf86cd799439015",
    "parameters": {
      "mode": "safe"
    }
  }
}
'

{
  "ids": [
    {
      "organization_id": "507f1f77bcf86cd799439011",
      "operation_id": "507f1f77bcf86cd799439031"
    }
  ]
}

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

Identificador únic de l'organització.

Maximum string length: 24

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

Cos

application/json

type

enum<string>

requerit

Tipus de comandament d'operació.

Opcions disponibles:

execute_microservice,

delete_workspaces,

shutdown_workspaces,

restart_workspaces,

suspend_workspaces

target

object

requerit

Objecte d'abast i objectius.

Show child attributes

expiration_in_seconds

integer

Expiració personalitzada en segons. Si s'ometeix s'utilitza el valor per defecte del comandament.

Rang requerit: 600 <= x <= 84600

payload

object

Càrrega específica del tipus d'operació. Per a delete_workspaces/shutdown_workspaces/restart_workspaces/suspend_workspaces no es permet càrrega útil.

Resposta

Operacions creades correctament.

ids

object[]

requerit

Identificadors d'operacions creades en el mateix ordre de creació.

Minimum array length: 1

Show child attributes

⌘I

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/operations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "execute_microservice",
  "target": {
    "type": "workspaces",
    "ids": [
      "507f1f77bcf86cd799439011",
      "507f1f77bcf86cd799439012"
    ]
  },
  "expiration_in_seconds": 600,
  "payload": {
    "microservice_id": "507f1f77bcf86cd799439015",
    "parameters": {
      "mode": "safe"
    }
  }
}
'

{
  "ids": [
    {
      "organization_id": "507f1f77bcf86cd799439011",
      "operation_id": "507f1f77bcf86cd799439031"
    }
  ]
}

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

API Gen 2

Recursos API Gen 2 - v2

Recursos API Gen 2 - v1

Crear operacions

Autoritzacions

Paràmetres de ruta

Cos

Resposta