Upstash

Instrucciones de uso

Connect to Upstash Redis to perform key-value, hash, list, and utility operations via the REST API.

Herramientas

`upstash_redis_get`

Get the value of a key from Upstash Redis.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to retrieve

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was retrieved
`value`	json	The value of the key (string), or null if not found

`upstash_redis_set`

Set the value of a key in Upstash Redis with an optional expiration time in seconds.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to set
`value`	string	Sí	The value to store
`ex`	number	No	Expiration time in seconds (optional)

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was set
`result`	string	The result of the SET operation (typically "OK")

`upstash_redis_delete`

Delete a key from Upstash Redis.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to delete

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was deleted
`deletedCount`	number	Number of keys deleted (0 if key did not exist, 1 if deleted)

`upstash_redis_keys`

List keys matching a pattern in Upstash Redis. Defaults to listing all keys (*).

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`pattern`	string	No	Pattern to match keys (e.g., "user:"). Defaults to "" for all keys.

Salida

Parámetro	Tipo	Descripción
`pattern`	string	The pattern used to match keys
`keys`	array	List of keys matching the pattern
`count`	number	Number of keys found

`upstash_redis_command`

Execute an arbitrary Redis command against Upstash Redis. Pass the full command as a JSON array (e.g., [

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`command`	string	Sí	Redis command as a JSON array (e.g., ["HSET", "myhash", "field1", "value1"]) or a simple command string (e.g., "PING")

Salida

Parámetro	Tipo	Descripción
`command`	string	The command that was executed
`result`	json	The result of the Redis command

`upstash_redis_hset`

Set a field in a hash stored at a key in Upstash Redis.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The hash key
`field`	string	Sí	The field name within the hash
`value`	string	Sí	The value to store in the hash field

Salida

Parámetro	Tipo	Descripción
`key`	string	The hash key
`field`	string	The field that was set
`result`	number	Number of new fields added (0 if field was updated, 1 if new)

`upstash_redis_hget`

Get the value of a field in a hash stored at a key in Upstash Redis.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The hash key
`field`	string	Sí	The field name to retrieve

Salida

Parámetro	Tipo	Descripción
`key`	string	The hash key
`field`	string	The field that was retrieved
`value`	json	The value of the hash field (string), or null if not found

`upstash_redis_hgetall`

Get all fields and values of a hash stored at a key in Upstash Redis.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The hash key

Salida

Parámetro	Tipo	Descripción
`key`	string	The hash key
`fields`	object	All field-value pairs in the hash, keyed by field name
`fieldCount`	number	Number of fields in the hash

`upstash_redis_incr`

Atomically increment the integer value of a key by one in Upstash Redis. If the key does not exist, it is set to 0 before incrementing.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to increment

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was incremented
`value`	number	The new value after incrementing

`upstash_redis_expire`

Set a timeout on a key in Upstash Redis. After the timeout, the key is deleted.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to set expiration on
`seconds`	number	Sí	Timeout in seconds

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that expiration was set on
`result`	number	1 if the timeout was set, 0 if the key does not exist

`upstash_redis_ttl`

Get the remaining time to live of a key in Upstash Redis. Returns -1 if the key has no expiration, -2 if the key does not exist.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to check TTL for

Salida

Parámetro	Tipo	Descripción
`key`	string	The key checked
`ttl`	number	Remaining TTL in seconds. Positive integer if the key has a TTL set, -1 if the key exists with no expiration, -2 if the key does not exist.

`upstash_redis_lpush`

Prepend a value to the beginning of a list in Upstash Redis. Creates the list if it does not exist.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The list key
`value`	string	Sí	The value to prepend to the list

Salida

Parámetro	Tipo	Descripción
`key`	string	The list key
`length`	number	The length of the list after the push

`upstash_redis_lrange`

Get a range of elements from a list in Upstash Redis. Use 0 and -1 for start and stop to get all elements.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The list key
`start`	number	Sí	Start index (0-based, negative values count from end)
`stop`	number	Sí	Stop index (inclusive, -1 for last element)

Salida

Parámetro	Tipo	Descripción
`key`	string	The list key
`values`	array	List of elements in the specified range
`count`	number	Number of elements returned

`upstash_redis_exists`

Check if a key exists in Upstash Redis. Returns true if the key exists, false otherwise.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to check

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was checked
`exists`	boolean	Whether the key exists (true) or not (false)

`upstash_redis_setnx`

Set the value of a key only if it does not already exist. Returns true if the key was set, false if it already existed.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to set
`value`	string	Sí	The value to store if the key does not exist

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was attempted to set
`wasSet`	boolean	Whether the key was set (true) or already existed (false)

`upstash_redis_incrby`

Increment the integer value of a key by a given amount. Use a negative value to decrement. If the key does not exist, it is set to 0 before the operation.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`restUrl`	string	Sí	Upstash Redis REST URL
`restToken`	string	Sí	Upstash Redis REST Token
`key`	string	Sí	The key to increment
`increment`	number	Sí	Amount to increment by (use negative value to decrement)

Salida

Parámetro	Tipo	Descripción
`key`	string	The key that was incremented
`value`	number	The new value after incrementing

Upstash

On this page