Crear operaciones
Crea una o varias operaciones en base al alcance y objetivos enviados.
Tipos de operación disponibles actualmente: execute_microservice, delete_workspaces, shutdown_workspaces y restart_workspaces.
Compatibilidad de parámetros para execute_microservice
payload.parameters solo aplica a ejecuciones de microservicios PowerShell en Windows y solo está soportado en dispositivos con el nuevo agente instalado.
Los valores enviados en payload.parameters se transmiten como texto (string). La interpretación de tipos depende de la definición de parámetros y del parseo implementado en el script del microservicio.
Para ese contexto, tipos de datos de los parámetros recomendados:
string,integer,double,decimalydatetime.- Para
doubleydecimal, use notación con punto decimal (.). - Para
datetime, use formato ISO 8601 (por ejemplo:2026-07-09T10:30:00Z). - Al ejecutarse en el destino, los valores
datetimepueden representarse en hora local. - La ejecución correcta también depende de la calidad y validaciones del script.
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>"
}
}Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros de ruta
Identificador único de la organización.
24^[0-9a-f]{24}$Cuerpo
Tipo de comando de operación.
execute_microservice, delete_workspaces, shutdown_workspaces, restart_workspaces, suspend_workspaces Objeto de alcance y objetivos.
Show child attributes
Show child attributes
Expiración personalizada en segundos. Si se omite se usa el valor por defecto del comando.
600 <= x <= 84600Carga específica del tipo de operación. Para delete_workspaces/shutdown_workspaces/restart_workspaces/suspend_workspaces no se permite payload.
Respuesta
Operaciones creadas correctamente.
Identificadores de operaciones creadas en el mismo orden de creación.
1Show child attributes
Show child attributes
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>"
}
}