KV

Put puts the given key into the key-value store. A put request increments the revision of the key-value store and generates one event in the event history.

post/v3/kv/put

Request

Request body

ignore_leaseboolean

If ignore_lease is set, etcd updates the key using its current lease. Returns an error if the key does not exist.

ignore_valueboolean

If ignore_value is set, etcd updates the key using its current value. Returns an error if the key does not exist.

keystring byte

key is the key, in bytes, to put into the key-value store.

leasestring int64

lease is the lease ID to associate with the key in the key-value store. A lease value of 0 indicates no lease.

prev_kvboolean

If prev_kv is set, etcd gets the previous key-value pair before changing it. The previous key-value pair will be returned in the put response.

valuestring byte

value is the value, in bytes, to associate with the key in the key-value store.

Response

A successful response.

Changes

No recorded changes to this operation across all 1 revision of this API.