The URI for the Terracotta Management Service
The typical URI used to connect to the Terracotta management service has the following format:
<scheme>://<host>[:<port>]/<path>?<query>
These URIs use the standard scheme and domain, with “http” assumed as the scheme. HTTP operations access the REST API through URIs. The URI allows query strings under certain circumstances.
The URI Path
The <path> portion of the URI specifies resource locations using the following hierarchy:
1. Agent IDs – List of the desired clients using unique identifiers. If the connection is to a TMS and no IDs are given, all known clients are accessed. If the connection is made directly to a Terracotta client or the TSA (to a standalone REST service), then no ID is used because these are identified by a host:port address. All standalone (including TSA) REST interfaces return the agent ID “embedded”.
2. CacheManager names – List of the CacheManagers using their configured names. If “cacheManagers” is specified in the URI but no names are given, all CacheManagers for the specified clients are accessed.
3. Cache names – List of the caches using their configured names. If “caches” is specified in the URI but no names are given, all caches belonging to the accessed CacheManagers are accessed. In the case where access is broad, a substantial amount of data might be returned by a GET operation.
The structure of the path takes the following form:
/agents[;ids={comma_sep_agent_ids}]/cacheManagers[;names={
comma_sep_cache_manager_names}]/caches[;names={comma_sep_cache_names}
Agent IDs are not required.
Contact Support
|
Community
|
Feedback