This topic describes the put command in gfsh, the VMware Tanzu GemFire command-line interface.

Use this command to add or update a region entry.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

put --key=value --value=value --region=value [--key-class=value] 
[--value-class=value] [--if-not-exists(=value)]
Name Description Default Value
‑‑key Required. String or JSON text from which to create the key. For example: “James”, “100L” and “('id':'l34s')”.  
‑‑value Required. String or JSON text from which to create the value. For example: “James”, “100L” and “('id':'l34s')”.  
‑‑region Required. Region into which the entry will be put.  
‑‑key-class Fully qualified class name of the key’s type. java.lang.String
‑‑value-class Fully qualified class name of the value’s type. The type may not be an internal PDX class. java.lang.String
‑‑value-class Fully qualified class name of the value’s type. The type may not be an internal PDX class. java.lang.String
‑‑if-not-exists Skip the put operation when an entry with the same key already exists. false

Example Commands:

put --key=('id':'133abg125') --value="('firstname':'James','lastname':'Gosling')"
--region=/region1 --key-class=data.ProfileKey --value-class=data.ProfileDetails

put --key=('133abg124') --value="('Hello World!!')" --region=/region2

put --key=('100F') --value=('2146547689879658564') --region=/region1/region12
--key-class=java.lang.Float --value-class=java.lang.Long

Sample Output:

gfsh>put --key=('123abc') --value="('Hello World!!')" --region=region2
Result      : true
Key Class   : java.lang.String
Key         : ('123abc')
Value Class : java.lang.String
Old Value   : <NULL>

Error Messages:

"Region name is either empty or Null";
"Key is either empty or Null";
"Value is either empty or Null";
"Region <{0}> not found in any of the members";
"Region <{0}> Not Found";
"Key is not present in the region";
check-circle-line exclamation-circle-line close-line
Scroll to top icon