1etcdctl3(1)                                                        etcdctl3(1)
2
3
4

NAME

6       etcdctl-put - Puts the given key into the store
7
8
9

SYNOPSIS

11       etcdctl put [options] <key> <value> (<value> can also be given from
12       stdin) [flags]
13
14
15

DESCRIPTION

17       Puts the given key into the store.
18
19
20       When <value> begins with '-', <value> is interpreted as a flag.  Insert
21       '--' for workaround:
22
23
24       $ put <key> -- <value> $ put -- <key> <value>
25
26
27       If <value> isn't given as a command line argument and '--ignore-value'
28       is not specified, this command tries to read the value from standard
29       input.
30
31
32       If <lease> isn't given as a command line argument and '--ignore-lease'
33       is not specified, this command tries to read the value from standard
34       input.
35
36
37       For example, $ cat file | put <key> will store the content of the file
38       to <key>.
39
40
41

OPTIONS

43       -h, --help[=false]
44           help for put
45
46
47       --ignore-lease[=false]
48           updates the key using its current lease
49
50
51       --ignore-value[=false]
52           updates the key using its current value
53
54
55       --lease="0"
56           lease ID (in hexadecimal) to attach to the key
57
58
59       --prev-kv[=false]
60           return the previous key-value pair before modification
61
62
63

OPTIONS INHERITED FROM PARENT COMMANDS

65       --cacert=""
66           verify certificates of TLS-enabled secure servers using this CA
67       bundle
68
69
70       --cert=""
71           identify secure client using this TLS certificate file
72
73
74       --command-timeout=5s
75           timeout for short running command (excluding dial timeout)
76
77
78       --debug[=false]
79           enable client-side debug logging
80
81
82       --dial-timeout=2s
83           dial timeout for client connections
84
85
86       -d, --discovery-srv=""
87           domain name to query for SRV records describing cluster endpoints
88
89
90       --discovery-srv-name=""
91           service name to query when using DNS discovery
92
93
94       --endpoints=[127.0.0.1:2379]
95           gRPC endpoints
96
97
98       --hex[=false]
99           print byte strings as hex encoded strings
100
101
102       --insecure-discovery[=true]
103           accept insecure SRV records describing cluster endpoints
104
105
106       --insecure-skip-tls-verify[=false]
107           skip server certificate verification
108
109
110       --insecure-transport[=true]
111           disable transport security for client connections
112
113
114       --keepalive-time=2s
115           keepalive time for client connections
116
117
118       --keepalive-timeout=6s
119           keepalive timeout for client connections
120
121
122       --key=""
123           identify secure client using this TLS key file
124
125
126       --password=""
127           password for authentication (if this option is used, --user option
128       shouldn't include password)
129
130
131       --user=""
132           username[:password] for authentication (prompt if password is not
133       supplied)
134
135
136       -w, --write-out="simple"
137           set the output format (fields, json, protobuf, simple, table)
138
139
140

SEE ALSO

142       etcdctl(1)
143
144
145

HISTORY

147       5-Apr-2020 Auto generated by spf13/cobra
148
149
150
151Auto generated by spf13/cobra      Apr 2020                        etcdctl3(1)