1. Infinispan REST API

team@openapitools.org 16.2.0-SNAPSHOT :toc: left :numbered: :toclevels: 4 :source-highlighter: highlightjs :keywords: openapi, rest, Infinispan REST API :specDir: :snippetDir: :generator-template: v1 2019-12-20 :info-url: https://openapi-generator.tech :app-name: Infinispan REST API

Abstract
Infinispan OpenAPI descriptor

1.1. Endpoints

1.1.1. Cache

addSourceConnection

POST /rest/v3/caches/{cacheName}/rolling-upgrade/source-connection

Adds a source cluster connection for cache data migration

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Body Parameter
Name Description Required Default Pattern

body

The remote store configuration [object]

X

Return Type

-

Content Type
  • text/plain

Responses
Table 1. HTTP Response Codes
Code Message Datatype

400

Illegal argument values

[String]

404

Cache not found

[String]

204

The source connection was added

<<>>

Samples
assignCacheAlias

POST /rest/v3/caches/{cacheName}/_assign-alias

-

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Query Parameters
Name Description Required Default Pattern

alias

Assign an alias to a cache

X

null

Return Type
Content Type
  • text/plain

Responses
Table 2. HTTP Response Codes
Code Message Datatype

400

Illegal argument values

[String]

404

Cache not found

[String]

200

Alias assigned

[String]

Samples
cacheExists

HEAD /rest/v3/caches/{cacheName}

Determines if a cache exists

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 3. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

The cache exists

<<>>

Samples
clearCache

POST /rest/v3/caches/{cacheName}/_clear

Clears a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 4. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

The cache was cleared

<<>>

Samples
compareCacheConfig

POST /rest/v3/_cache-config-compare

Compare cache configurations

Description
Parameters
Return Type

-

Responses
Table 5. HTTP Response Codes
Code Message Datatype
Samples
convertCacheConfig

POST /rest/v3/_cache-config-convert

Convert cache configurations between formats

Description
Parameters
Body Parameter
Name Description Required Default Pattern

body

Cache configuration [string]

X

Return Type

-

Responses
Table 6. HTTP Response Codes
Code Message Datatype
Samples
deleteByQuery

POST /rest/v3/caches/{cacheName}/_delete-by-query

Delete entries from a cache matching an Ickle query

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Body Parameter
Name Description Required Default Pattern

JsonQueryRequest

The query request object JsonQueryRequest

X

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 7. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The number of deleted entries

[Long]

Samples
deleteByQueryDelete

DELETE /rest/v3/caches/{cacheName}/_delete-by-query

Delete entries from a cache matching an Ickle query (DELETE)

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Body Parameter
Name Description Required Default Pattern

JsonQueryRequest

The query request object JsonQueryRequest

X

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 8. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The number of deleted entries

[Long]

Samples
deleteCache

DELETE /rest/v3/caches/{cacheName}

Deletes a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

Responses
Table 9. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The cache was removed

[String]

Samples
deleteCacheEntry

DELETE /rest/v3/caches/{cacheName}/entries/{cacheKey}

Delete an entry from a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

cacheKey

cacheKey

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 10. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

Entry was deleted

<<>>

Samples
disableCacheRebalancing

POST /rest/v3/caches/{cacheName}/_rebalancing-disable

Disable rebalancing for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 11. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

Rebalancing was disabled

<<>>

Samples
enableCacheRebalancing

POST /rest/v3/caches/{cacheName}/_rebalancing-enable

Enable rebalancing for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 12. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

Rebalancing was enabled

<<>>

Samples
getAllCacheAttributes

GET /rest/v3/caches/{cacheName}/config/attributes

Retrieve all mutable configuration attributes for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Query Parameters
Name Description Required Default Pattern

full

Retrieve all mutable attributes and their values

-

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 13. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Mutable cache attributes

[String]

Samples
getAllCacheEntries

GET /rest/v3/caches/{cacheName}/entries

Retrieve all entries from a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 14. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

All cache entries

[String]

Samples
getAllCacheKeys

GET /rest/v3/caches/{cacheName}/keys

Retrieve all keys from a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 15. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

All cache keys

List[[string]]

Samples
getCacheAttribute

GET /rest/v3/caches/{cacheName}/config/attributes/{attribute}

Retrieve the value of a single mutable configuration attribute for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

attribute

attribute

X

null

Return Type
Content Type
  • text/plain

Responses
Table 16. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The value of the requested cache configuration attribute

[String]

Samples
getCacheAvailability

GET /rest/v3/caches/{cacheName}/_availability

Retrieves the cache availability

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

Responses
Table 17. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The cache availability status

[String]

Samples
getCacheConfig

GET /rest/v3/caches/{cacheName}/config

Retrieve cache configuration

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/xml

  • application/json

  • application/yaml

Responses
Table 18. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Cache configuration as XML

[String]

Samples
getCacheDetails

GET /rest/v3/caches/{cacheName}/details

Retrieves details about a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 19. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

Samples
getCacheDistribution

GET /rest/v3/caches/{cacheName}/_distribution

-

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 20. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The cache distribution

[String]

Samples
getCacheEntry

GET /rest/v3/caches/{cacheName}/entries/{cacheKey}

Retrieve an entry from a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

cacheKey

cacheKey

X

null

Header Parameters
Name Description Required Default Pattern

extended

Whether to return additional information about the entry in the response headers

-

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 21. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Entry value

[String]

Samples
getCacheEvents

GET /rest/v3/caches/{cacheName}/_listen

Receive events from a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • text/event-stream

Responses
Table 22. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Cache events

[String]

Samples
getCacheHealth

GET /rest/v3/caches/{cacheName}/_health

Retrieve the cache health

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

Responses
Table 23. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Cache health status

[String]

Samples
getCacheList

GET /rest/v3/caches

List available caches

Description
Parameters
Return Type
Content Type
  • application/json

  • text/html

Responses
Table 24. HTTP Response Codes
Code Message Datatype

200

Cache list as a JSON array

List[[string]]

Samples
getCacheSize

GET /rest/v3/caches/{cacheName}/_size

Retrieves the number of entries in the cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • application/json

Responses
Table 25. HTTP Response Codes
Code Message Datatype

200

The number of entries in the cace

[Long]

Samples
getCacheStats

GET /rest/v3/caches/{cacheName}/_stats

Retrieve cache statistics

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 26. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The cache statistics

[String]

Samples
getDetailedCacheList

GET /rest/v3/meta/caches/_detailed

List available caches with details

Description
Parameters
Return Type
Content Type
  • application/json

Responses
Table 27. HTTP Response Codes
Code Message Datatype

200

Detailed cache list with metadata

[String]

Samples
getKeyDistribution

GET /rest/v3/caches/{cacheName}/_distribution/{cacheKey}

Retrieve key distribution

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

cacheKey

cacheKey

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 28. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

The key distribution

[String]

Samples
getRoleAccessibleCaches

GET /rest/v3/meta/caches/_role-accessible

List caches accessible by a specific role

Description
Parameters
Query Parameters
Name Description Required Default Pattern

role

The role name

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 29. HTTP Response Codes
Code Message Datatype

404

Role not found

[String]

400

Role parameter is missing

[String]

200

Caches accessible by the role, separated into secured and non-secured

[String]

Samples
getSourceConnection

GET /rest/v3/caches/{cacheName}/rolling-upgrade/source-connection

Retrieves a source cluster connection for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 30. HTTP Response Codes
Code Message Datatype

404

The cache does not exist or is not connected to a source cluster

[String]

200

The remote store configuration for the source cluster

[Object]

Samples
headCacheConfig

HEAD /rest/v3/caches/{cacheName}/config

Retrieve cache configuration

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

  • application/xml

  • application/json

  • application/yaml

Responses
Table 31. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Cache configuration as XML

[String]

Samples
headCacheEntry

HEAD /rest/v3/caches/{cacheName}/entries/{cacheKey}

Retrieve an entry from a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

cacheKey

cacheKey

X

null

Header Parameters
Name Description Required Default Pattern

extended

Whether to return additional information about the entry in the response headers

-

null

Return Type
Content Type
  • text/plain

  • application/json

Responses
Table 32. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

200

Entry value

[String]

Samples
initializeCache

POST /rest/v3/caches/{cacheName}/_initialize

Initialize cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Query Parameters
Name Description Required Default Pattern

force

Force use of the current topology

-

null

Return Type

-

Content Type
  • text/plain

Responses
Table 33. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

400

Illegal state

[String]

204

Cache was initialized

<<>>

Samples
postCache

POST /rest/v3/caches/{cacheName}

Creates a cache or updates its configuration

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Body Parameter
Name Description Required Default Pattern

body

The cache configuration [object]

X

Return Type
Content Type
  • text/plain

Responses
Table 34. HTTP Response Codes
Code Message Datatype

400

Illegal argument values

[String]

200

The cache was created or its configuration updated

[String]

Samples
postCacheAttribute

POST /rest/v3/caches/{cacheName}/config/attributes/{attribute}

Sets the value of a single mutable configuration attribute for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

attribute

attribute

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 35. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

The cache configuration attribute was successfully changed

<<>>

Samples
postCacheAvailability

POST /rest/v3/caches/{cacheName}/_availability

Sets the cache availability

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 36. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

The cache availability status was set

<<>>

Samples
postCacheEntry

POST /rest/v3/caches/{cacheName}/entries/{cacheKey}

Put/update an entry in a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

cacheKey

cacheKey

X

null

Body Parameter
Name Description Required Default Pattern

body

Entry value [object]

X

Header Parameters
Name Description Required Default Pattern

key-content-type

The content type for the key

-

null

timeToLiveSeconds

The time-to-live (TTL) of the entry in seconds

-

null

maxIdleTimeSeconds

The maximum idle time in seconds

-

null

Return Type

-

Content Type
  • text/plain

Responses
Table 37. HTTP Response Codes
Code Message Datatype

204

Entry was stored

<<>>

409

ETag conflict

[String]

Samples
postQueryCache

POST /rest/v3/caches/{cacheName}/_search

Performs an Ickle query on a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Body Parameter
Name Description Required Default Pattern

JsonQueryRequest

The query request object JsonQueryRequest

X

Return Type
Content Type
  • application/json

Responses
Table 38. HTTP Response Codes
Code Message Datatype

200

The results of the query

JsonQueryResponse

Samples
putCache

PUT /rest/v3/caches/{cacheName}

Creates a cache or updates its configuration

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Body Parameter
Name Description Required Default Pattern

body

The cache configuration [object]

X

Return Type
Content Type
  • text/plain

Responses
Table 39. HTTP Response Codes
Code Message Datatype

400

Illegal argument values

[String]

200

The cache was created or its configuration updated

[String]

Samples
putCacheEntry

PUT /rest/v3/caches/{cacheName}/entries/{cacheKey}

Put/update an entry in a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

cacheKey

cacheKey

X

null

Body Parameter
Name Description Required Default Pattern

body

Entry value [object]

X

Header Parameters
Name Description Required Default Pattern

key-content-type

The content type for the key

-

null

timeToLiveSeconds

The time-to-live (TTL) of the entry in seconds

-

null

maxIdleTimeSeconds

The maximum idle time in seconds

-

null

Return Type

-

Content Type
  • text/plain

Responses
Table 40. HTTP Response Codes
Code Message Datatype

204

Entry was stored

<<>>

409

ETag conflict

[String]

Samples
queryCache

GET /rest/v3/caches/{cacheName}/_search

Performs an Ickle query on a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Query Parameters
Name Description Required Default Pattern

query

The Ickle query

X

null

offset

The offset

-

null

max_results

The maximum number of results

-

null

hit_count_accuracy

The hit count accuracy

-

null

Return Type
Content Type
  • application/json

Responses
Table 41. HTTP Response Codes
Code Message Datatype

200

The results of the query

JsonQueryResponse

Samples
removeSourceConnection

DELETE /rest/v3/caches/{cacheName}/rolling-upgrade/source-connection

Deletes a source cluster connection for cache data migration

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 42. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

304

No change was made

[String]

204

The source cluster was disconnected

<<>>

Samples
resetCacheStats

POST /rest/v3/caches/{cacheName}/_stats-reset

Reset cache statistics

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type

-

Content Type
  • text/plain

Responses
Table 43. HTTP Response Codes
Code Message Datatype

404

Cache not found

[String]

204

The cache statistics were reset

<<>>

Samples
sourceConnectionExists

HEAD /rest/v3/caches/{cacheName}/rolling-upgrade/source-connection

Checks whether a source cluster connection exists for a cache

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Return Type
Content Type
  • text/plain

Responses
Table 44. HTTP Response Codes
Code Message Datatype

404

The cache does not exists or is not connected to a source cluster

[String]

200

The cache is connected to a source cluster

[String]

Samples
syncData

POST /rest/v3/caches/{cacheName}/_sync-data

Synchronizes data between the source and target clusters

Description
Parameters
Path Parameters
Name Description Required Default Pattern

cacheName

cacheName

X

null

Query Parameters
Name Description Required Default Pattern

read-batch

Read batch size. Defaults to 10000.

-

null

threads

Number of threads to use for synchronization. Defaults to the number of available cores.

-

null

Return Type
Content Type
  • text/plain

Responses
Table 45. HTTP Response Codes
Code Message Datatype

400

Illegal argument values

[String]

200

Data was synchronized successfully

[String]

Samples

1.1.2. Openapi

restV3OpenapiGet

GET /rest/v3/openapi

-

Description
Parameters
Return Type
Content Type
  • application/json

Responses
Table 46. HTTP Response Codes
Code Message Datatype

200

OpenAPI descriptor

[Object]

Samples

1.2. Models

1.2.1. JsonQueryRequest

Field Name Required Nullable Type Description Format

query

String

start_offset

Integer

int32

max_results

Integer

int32

hit_count_accuracy

Integer

int32

1.2.2. JsonQueryResponse

Field Name Required Nullable Type Description Format

hit_count

Integer

int32

hit_count_exact

Boolean