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 (CAUTION: this option should
108       be enabled only for testing purposes)
109
110
111       --insecure-transport[=true]
112           disable transport security for client connections
113
114
115       --keepalive-time=2s
116           keepalive time for client connections
117
118
119       --keepalive-timeout=6s
120           keepalive timeout for client connections
121
122
123       --key=""
124           identify secure client using this TLS key file
125
126
127       --password=""
128           password for authentication (if this option is used, --user option
129       shouldn't include password)
130
131
132       --user=""
133           username[:password] for authentication (prompt if password is not
134       supplied)
135
136
137       -w, --write-out="simple"
138           set the output format (fields, json, protobuf, simple, table)
139
140
141

SEE ALSO

143       etcdctl(1)
144
145
146

HISTORY

148       4-Sep-2020 Auto generated by spf13/cobra
149
150
151
152Auto generated by spf13/cobra      Sep 2020                        etcdctl3(1)