Common operations

The common operations supported by the REST protocol are described in the following table.

Note: Both the Javascript and the Java clients have been designed to help you execute these operations.

See Also
Creating Collaborative Widgets Using Storage Service
Storage type scopes
How clients communicate with the Storage Service

Operation

Description

AGGREGATE

Returns aggregated values applied to the key.

The possible operations are COUNT, MIN, MAX, AVG, SUM.

The value must be a number except for COUNT which works with everything (numbers, alphanumerical strings, etc.)

GET

Gets all values associated with a single key.

GET_MANY

Gets many keys and all their corresponding values simultaneously.

ENUMERATE

Prefixed get.

Provides a prefix and gets all pairs matching that prefix.

For example, an enumerate query ‘france_paris_’ would get all values associated with ‘france_paris_chatelet, france_paris_montmartre, etc.’

SET

Adds a key/value pair to the storage. If the key exists, it is replaced or appended (whether it is single or multi-valued).

SET_MANY

Sets many values for a given key and replaces existing ones by the new ones. See also PUT_MANY.

PUT

Adds a key/value pair to the storage. If the key exists, an error is returned and the value is left untouched.

PUT_MANY

Adds several values to a given key and keeps existing ones.

DELETE

Deletes a single key with its associated values