API de respuesta

Aislar equipos

Aísla una lista de equipos de la red para evitar la propagación de las amenazas y /o la comunicación y extracción de información confidencial.

Petición

Comando	POST
URL	/api/v1/applications/remediations/muids/isolate
Parámetros requeridos en el cuerpo del mensaje HTTP	JSON con la lista de MUIDs de los equipos a aislar. MUIDs: lista de MUIDs.
Cabeceras	Accept: application/json Content-Type: application/json-patch+json
Formato de la llamada para aislar equipos

Respuesta

Lista de JSONs, cada uno de ellos con el resultado de la operación.

Campo del JSON	Descripción
MUID	MUID del equipo referido en la petición.
devideId	Campo obsoleto.
requestAccepted	True
errorCode	“null”
errorMessage	“null”
JSON de respuesta al aislamiento de equipos

Quitar el aislamiento de equipos

Saca del estado del aislamiento los equipos de la red una vez resuelta la posibilidad de propagación de las amenazas y / o la comunicación y extracción de información confidencial.

Petición

Comando	POST
URL	/api/v1/applications/remediations/muids/deisolate
Parámetros requeridos en el cuerpo del mensaje HTTP	JSON con la lista de MUIDs de los equipos a sacar del aislamento. MUIDs: lista de MUIDs.
Cabeceras	Accept: application/json Content-Type: application/json-patch+json
Formato de la llamada para quitar el aislamiento

Respuesta

Lista de JSONs, cada uno de ellos con el resultado de la operación.

Campo del JSON	Descripción
MUID	MUID del equipo referido en la respuesta.
devideId	Campo obsoleto.
requestAccepted	True
errorCode	“null”
errorMessage	“null”
JSON de respuesta al aislamiento de equipos

Reinicio

Inicia la secuencia de reinicio de una lista de equipos para completar una actualización de software o para corregir un mal funcionamiento del equipo.

Petición

Comando	POST
URL	/api/v1/applications/remediations/muids/reboot
Parámetros requeridos en el cuerpo del mensaje HTTP	JSON con la lista de MUIDs de los equipos a reiniciar. MUIDs: lista de MUIDs.
Cabeceras	Accept: application/json Content-Type: application/json-patch+json
Formato de la llamada para reiniciar equipos

Respuesta

Lista de JSONs, cada uno de ellos con el resultado de la operación.

Campo del JSON	Descripción
MUID	MUID del equipo referido en la respuesta.
devideId	Campo obsoleto.
requestAccepted	True
errorCode	“null”
errorMessage	“null”
JSON de respuesta al reinicio de equipos

Ejemplo de llamada a la API para aislar, quitar el aislamiento y reiniciar equipos

El siguiente ejemplo aísla, quita el aislamiento y reinicia los equipos de MUIDs “3333-4444” y “5555-6666”.

#cabeceras para la llamada a la API incluyendo el token de acceso

h_request_remediation = {

'Authorization': f'Bearer {token_access}',

'Accept': 'application/json',

'Content-Type': 'application/json-patch+json'

}

#JSON con la lista de muids

muids_data={'muids':['3333-4444','5555-6666']}

#Objetivo: aísla una lista de equipos

#URL de la llamada

url_isolate = f'https://api.orion.cytomic.ai/api/v1/applications/remediations/muids/isolate'

r = requests.post(url_isolate, headers=h_request_remediation, json=muids_data, verify=False)

#devuelve un JSON con el resultado de la operación

isolate=r.json()

#Objetivo: retira el estado de aislamiento de una lista de equipos

#URL de la llamada

url_deisolate = f'https://api.orion.cytomic.ai/api/v1/applications/remediations/muids/deisolate'

r = requests.post(url_deisolate, headers=h_request_remediation, json=muids_data, verify=False)

#devuelve un JSON con el resultado de la operación

deisolate=r.json()

#Objetivo: reinicia una lista de equipos

#URL de la llamada

url_reboot = f'https://api.orion.cytomic.ai/api/v1/applications/remediations/muids/reboot'

r = requests.post(url_reboot, headers=h_request_remediation, json=muids_data, verify=False)

#devuelve un JSON con el resultado de la operación

reboot=r.json()