Create or modify user-defined SaaS cloud application definition

post

http://127.0.0.1:8080/applicationDefinition/saasClassification

Creates or modifies a user-defined SaaS (Software as a Service) cloud application definition. Set saasId to -1 in both query parameter and request body to create a new application. User-defined applications must have ID >= 25000. Silver Peak predefined SaaS applications (ID < 25000) cannot be modified. After successful creation/update, the merged data and hashcode are automatically updated for synchronization with appliances.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

integer

required

≥ -1

SaaS application ID. Use -1 to create a new application. For existing applications, must be >= 25000 (user-defined) and match the saasId in request body.

Body Params

saasId

integer

required

≥ -1

Unique identifier for the SaaS application. Use -1 to create a new application. User-defined applications must have ID >= 25000.

application

string

required

length ≤ 31

^[a-zA-Z0-9_-]{1,31}$

Name of the SaaS cloud application. Must contain only alphanumeric characters, hyphens, or underscores. Maximum 31 characters.

domains

array of strings

required

length ≥ 1

Array of domain names associated with this SaaS application. Required and cannot be empty. Supports wildcards (e.g., *.example.com).

domains*

addresses

array of objects

required

length ≥ 1

Array of subnet entries defining IP ranges for this SaaS application. Required and cannot be empty.

addresses*

IP subnet information for a cloud application, including reachability probe configuration.

subnet

string

Cloud application IP subnet in CIDR notation (e.g., 173.240.103.64/26).

reachableIp

string

First known reachable IP address from the subnet for connectivity probing.

pingMethod

string

enum

Protocol used to probe reachability of the subnet. Valid values: TCP, UDP.

Allowed:

pingPort

number

Port number used for reachability probing (e.g., 80, 443).

threshold

string

Defaults to 10

RTT (Round Trip Time) threshold value in milliseconds for SaaS performance monitoring.

ports

array of strings

Defaults to 80,443

Array of port numbers as strings associated with this SaaS application.

ports

enabled

boolean

Defaults to false

Internal flag indicating if the SaaS application is enabled. Typically set to false for user-defined applications.

200SaaS application definition successfully created or updated. The merged data and hashcode are updated for appliance synchronization.

400Bad request due to validation errors or invalid parameters

500Internal server error while processing the request