Upstash

使用说明

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

工具

`upstash_redis_get`

Get the value of a key from Upstash Redis.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to retrieve

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to set
`value`	string	是	The value to store
`ex`	number	否	Expiration time in seconds (optional)

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to delete

输出

参数	类型	描述
`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 (*).

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`pattern`	string	否	Pattern to match keys (e.g., "user:"). Defaults to "" for all keys.

输出

参数	类型	描述
`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., [

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`command`	string	是	Redis command as a JSON array (e.g., ["HSET", "myhash", "field1", "value1"]) or a simple command string (e.g., "PING")

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The hash key
`field`	string	是	The field name within the hash
`value`	string	是	The value to store in the hash field

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The hash key
`field`	string	是	The field name to retrieve

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The hash key

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to increment

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to set expiration on
`seconds`	number	是	Timeout in seconds

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to check TTL for

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The list key
`value`	string	是	The value to prepend to the list

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The list key
`start`	number	是	Start index (0-based, negative values count from end)
`stop`	number	是	Stop index (inclusive, -1 for last element)

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to check

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to set
`value`	string	是	The value to store if the key does not exist

输出

参数	类型	描述
`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.

输入

参数	类型	必填	描述
`restUrl`	string	是	Upstash Redis REST URL
`restToken`	string	是	Upstash Redis REST Token
`key`	string	是	The key to increment
`increment`	number	是	Amount to increment by (use negative value to decrement)

输出

参数	类型	描述
`key`	string	The key that was incremented
`value`	number	The new value after incrementing

Upstash

On this page