Preparing to predict a result

Ops Center Analyzer REST API Reference Guide

Version

11.0.x

Audience

anonymous

Part Number

MK-99ANA003-20

Following is the initial step required to predict a result.

Execution permission

Admin, Modify

Request line

GET baseURL/v1/services/PredictionTask/actions/execute

Request body

Not applicable.

Response body

The structure of the response body and the object attributes is as follows:

Action

{
        "name":"...",
        "href":"...",
        "method":"...",
        "type":"...",
        "parameters":["...", ...]
}

Action (Type: Action)

Attribute	Type	Description
name	string	Name of the action.
href	string	URL for the action.
method	string	Name of the method.
type	string	Data format for the object.
parameters	anyType[]	A list of PredictionExecParam objects necessary to execute an operation. For details, see the table below.

PredictionExecParam

{
        "reportID":"...",
        "profileIDs":["...", ...],
        "targetConds":[{
            "nodeType":"...",
            "resourceIDs":["...", ...],
            "withRelated":"..."
        },
        :
        ],
        "metrics":[{
            "metricType":"...",
            "threshold":"...",
            "proportion":"..."
        },
        :
        ],
        "withRelated":"...",
        "predictionPeriod":"...",
        "calculationPeriod":"..."
}

PredictionExecParam (Type: PredictionExecParam)

Attribute	Type	Description
reportID	string	ID of the predictive risk report.
profileIDs	string[]	List of predictive risk profile IDs.
targetConds	PredictionTargetCond[]	Target condition list.
metrics	PredictionMetric[]	Target metric information list.
withRelated	boolean	Whether or not the related resources are included in the targets.
predictionPeriod	long	Time period of the predictive result.
calculationPeriod	long	Time period it took to predict the result.

targetConds (Type: PredictionTargetCond)

Attribute	Type	Description
nodeType	enum	Node type. (For details about the valid values, see the table E2ENodeType in List of enumerators.)
resourceIDs	string[]	Resource ID list.
withRelated	boolean	Indicates whether the related resource is the same as the target.

Attribute

Type

Description

nodeType

enum

Node type.

(For details about the valid values, see the table E2ENodeType in List of enumerators.)

resourceIDs

string[]

Resource ID list.

withRelated

boolean

Indicates whether the related resource is the same as the target.

metrics (Type: PredictionMetric)

Attribute	Type	Description
metricType	enum	Metric type. (For details about the valid values, see the table MetricType in List of enumerators.)
threshold	float	A threshold value.
proportion	boolean	Direction of threshold.

Attribute

Type

Description

metricType

enum

Metric type.

(For details about the valid values, see the table MetricType in List of enumerators.)

threshold

float

A threshold value.

proportion

boolean

Direction of threshold.

Status codes

Status code	Reason phrase	Description
200	OK	Success.
401	Unauthorized	No login privilege.
403	Forbidden	No reference privilege.
412	Precondition Failed	The server is not available.
500	Internal Server Error	Server processing error.