On this page:

Server

URI Templates

HTTP Action	Media Type	URI Templates	Description
GET	application/json	server	Information about REST API internal state

JSON Representation

Properties

Description

type

Occurs

href

Auto reference

URI

1

name

"Server"

String

1

startDate

Starting date of the server

Date

1

memory

Statistics about memory usage (mega-bytes)

Structure

1

memory.totalInitialMemory

Total memory according to the JVM in mega-bytes, before initializing memory cache

Integer

1

memory.totalMemory

Total memory according to the JVM in mega-bytes

Integer

1

memory.freeMemory

Free memory according to the JVM in mega-bytes

Integer

1

memory.usedMemory

Total memory - Free memory

Integer

1

requests

Statistics about requests

Structure

1

requests.totalCounter

Total number of requests

Integer

1

requests.errorsCounter

Total number of requests in errors

Integer

1

requests.totalTime

Total elapsed time of requests milliseconds

Integer

1

requests.averageTime

Total elapsed time of requests in milliseconds

Integer

1

requests.maxTime

Longest elapsed time of all requests in milliseconds

Integer

1

status

Server status either "LOADING" or "READY"

String

1

loadDate

Date of Memory cache update. This date is set at start time of

the server or when a reload is requested.

Date

1

abortedDomains

Array of aborted domains. An aborted domain is a domain for which loading has failed.

Array

1

abortedDomains[]

An aborted domain

Structure

0..1

abortedDomains[].name

Domain name

String

1

abortedDomains[].loadingDate

Date of loading start when the loading has been failed

String

1

license.status

License status regarding access to Central Bases

Use Case	Status	Description
No License	NO_LICENSE_KEY	License key was not found
	INVALID_LICENSE_KEY	License key is not valid
	CANNOT_ACCESS_LICENSE_KEY	License key file is not readable
	INVALID_LICENSE_FILE	Cannot find license key file
Restricted License	RESTRICTED_LICENSE	License is a restricted license
	GLOBAL_ACCESS_TOKENS_EXCEEDED	License is a restricted license, and quota of global access tokens is exceeded
	UNIT_ACCESS_TOKENS_EXCEEDED	License is a restricted license, and quota of unit access tokens is exceeded
Unrestricted License	UNRESTRICTED_LICENSE	License is an unrestricted license

String

1

domainsLocations

Get data source name and schema name for each domain. The ADMINISTRATOR role is required.

Structure

0..1

recommendedDbVersion

The preferred version of AIP (for compliancy with database schema)

securityMode

This is the configuration value of property security.mode from the security.properties file:

"default": authentication based of configuration files
"ldap": authentication base on LDAP protocol
"saml": authentication based on SAML protocol

String

1

samlSingleLogout

This is the configuration value of security.saml.single.logout property from security.properties file.

"true": logout action is enabled for "saml" security mode
"false": logout action is disabled for "saml" security mode

Boolean

1

languages

Installed translations

JSON Example

{
	"href": "server",
	"name": "Server",
    "startDate": {
		"time": 1381912989379
	},
	"memory": {
		"totalInitialMemory": 15,
		"totalMemory": 31,
		"freeMemory": 9,
		"usedMemory": 21
	},
	"requests": {
		"totalCounter": 2,
		"errorsCounter": 0,
		"totalTime": 22,
		"averageTime": 11,
		"maxTime": 21
	}
}

Server Cache Management

Administrator role is required.

REST server stores portfolio objects, configuration, and snapshots in a memory cache. This memory cache is loaded as soon as the REST Server is started.

An URL allows to reload all domains in memory cache. This action may be required when a new snapshot has been added, and can be performed from a command line with a tool such as "curl":

C:> curl –u admin:cast -H "Accept: application/json" http: //localhost:9999/testContext/rest/server/reload

For each domain, and for each application an Index file is created for Lucene library. This index allows to search for a components. Lucene index files are created at start time and reload time if this option is enabled:

<context-param>
    <param-name>rebuildComponentsSearchIndexesOnStart</param-name>
    <param-value>true</param-value>
</context-param>

URI Templates

HTTP Action	Media Type	URI Templates	Description
GET	application/json	server/reload	Information about REST API internal state

Parameters

URI Parameter	Description	Values	Default value
domain	Specify a single domain to reload (for example to refresh a domain after a snapshot)	a string	$all

DBMS Warm-up Service

Administrator role is required.

This service fetches data (results, components, violations) for domains hosted in central bases, in order to pre load data in memory afer a DBMS cold restart.

It avoids to penalize first user fetching data.

This service loops on each domain hosted by a central base, and trigger some queries on components, violations and assessment results.

C:> curl –u admin:cast  http: //localhost:9999/testContext/rest/server/warmup

URI Templates

HTTP Action	Media Type	URI Templates	Description
GET	application/json	server/warmup	Warm up DBMS after a cold restart (central base hosts only)

Lucene Index File

For each domain, and for each application an Index file is created for Lucene library. This index allows to search for a components.

URI Templates

HTTP Action

Media Type

URI Templates

Description

PUT

application/json

{Domain}/components-index

Create or overwrite the components search index for a domain

Administrator role is required.

GET

application/json

{Domain}/components-index

Get index status for a domain

JSON Representation

Properties	Description	type	Occurs
href	Auto reference	URI	1
name	Name	String	1
status	upToDate : Index is up to date N/A : not applicable, no index toUpdate : last snapshot is more recent than the index date, an index rebuild is required	String	1
date	Index file date	Date	0..1
lastSnapshotDate	Last Snapshot date	Date	0..1
size	Index file size	Integer	0..1

JSON Example

{
	"href": "ENDTOEND83/components-index",
	"name": "Components search index for applications of ENDTOEND83",
	"status": "upToDate",
	"date": {
		"time": 1496752452859,
		"isoDate": "2017-06-06"
	},
	"lastSnapshotDate": {
		"time": 1493778823000,
		"isoDate": "2017-05-03"
	},
	"size": 4145870
}

Domains Bindings

A Domain binding associates a domain name with a data source name and a schema name.

This resource is based on the use of domains.properties file.

URI Templates

HTTP Action

Media Type

URI Templates

Description

GET

application/json

server/domains-bindings

Get all domains bindings

Administrator role is required.

PUT

application/json

server/domains-bindings

Update the database binding for a list of domains, or create some new domains with their own bindings.

This web service triggers the "reload" service for the domains listed in he payload, in order to update the server memory cache and Lucene index files.

This Web service overwrites the domains.properties file.

This service accepts the "Authorization" HTTP header to transmit user's credentials, so that a prior call to the login "service" is not required. Thus, we can start the Web Server with an empty list of domains, and bypass the "login" service that prevents connection when no domain is defined.

In case of exception when writing this file, an HTTP Status "403 Forbidden" is returned. Check the permissions of this file.

Administrator role is required.

Example:

Assuming there are two existing domains AED1, AED2, add a new domain:

[
	{
		"name": "AED3",
		"dataSource": "DEV_CSS2",
		"schema": "appli1_central"
	}
]

Assuming there are three existing domains AED1, AED2, AED3, change schemas for domains AED1, AED2:

[
	{
		"name": "AED1",
		"dataSource": "DEV_CSS2",
		"schema": "appliA_central"
	},
	{
		"name": "AED2",
		"dataSource": "DEV_CSS2",
		"schema": "appliB_central"
	}
]

DELETE

application/json

server/domains-bindings

Update the database binding for a list of domains, or create some new domains with their own bindings.

This web service does not need to trigger the "reload".

This Web service overwrites the domains.properties file.

This service accepts the "Authorization" HTTP header to transmit user's credentials, so that a prior call to the login "service" is not required. Thus, we can start the Web Server with an empty list of domains, and bypass the "login" service that prevents connection when no domain is defined.

In case of exception when writing this file, an HTTP Status "403 Forbidden" is returned. Check the permissions of this file.

Administrator role is required.

Example:

Assuming there are two existing domains AED1, AED2, remove domain AED2

[
	{
		"name": "AED2"
	}
]

JSON Representation

Properties	Description	type	Occurs
name	Domain name	String	1
dataSource	Data source name	String	1
schema	Schema Name	String	1

JSON Example

[
	{
		"name": "AED1",
		"dataSource": "DEV_CSS2",
		"schema": "appli1_central"
	},
	{
		"name": "AED2",
		"dataSource": "DEV_CSS2",
		"schema": "appli2_central"
	}
]