etcd的API2和API3命令详解

API2

`命令`
#备份etcd目录
backup
#检查etcd群集的运行状况
cluster-health
#用给定的值生成一个新key值
mk 
#创建新目录       
mkdir   
#删除密钥或目录 
rm   
#如果密钥是空目录或键值对，rmdir将删除该密钥   
rmdir  
#获取key的值  
get    
#检索目录   
ls   
#设置key的值     
set 
#创建一个键目录，无论存在与否      
setdir  
#更新一个已存在的key的值  
update  
#更新一个已经存在的目录，如果不存在，则抛出异常  
updatedir 
#观察key值的变化
watch  
#监视一个键的变化并执行一个可执行文件   
exec-watch
#通过list、add、remove命令列出、添加、删除etcd实例到etcd集群中
member 
#通过add, grant and revoke命令添加用户，给用户授权，移除权限   
user  
#通过add, grant and revoke命令添加角色，给角色授权，移除权限   
role   
#验证总体验证控件   
auth      

`全局参数`
#输出可用于重新生成请求的curl命令
--debug 
发送请求前不同步群集信息                       
--no-sync 
#以给定格式（simple、`extended`或`json`）输出响应（默认值：“simple”）                     
--output simple, -o simple   
#要查询描述群集端点的SRV记录的域名  
--discovery-srv value, -D value
#接受描述群集终结点的不安全SRV记录
--insecure-discovery  
#群集中以逗号分隔的计算机地址列表（默认值：http://127.0.0.1:2379,http://127.0.0.1:4001")              
--endpoints value   
#使用此SSL证书文件标识HTTPS客户端           
--cert-file value 
#使用此SSL密钥文件标识HTTPS客户端             
--key-file value 
#使用此CA捆绑包验证启用HTTPS的服务器的证书              
--ca-file value  
#提供用户名[：password]并在未提供密码时提示           
--username value, -u value  
#每个请求的连接超时（默认值：2s）   
--timeout value 
#命令执行超时（watch除外）（默认值：5s）               
--total-timeout value          
#输出etcd和API版本                   
--version, -v                  

API3

`命令`
#获取key值或者所以一系列值
get
#给key赋值			          
put	
#删除对应的key值		          
del	
#Txn处理一个事务中的所有请求		          
txn	
#压缩etcd中的事件历史记录		          
compaction	
#解除所有警报	      
alarm disarm
#列出解除所有警报		  
alarm list	
#对具有给定终结点的etcd成员的存储进行碎片整理	      
defrag	
#检查“-endpoints”标志中指定的终结点的运行状况		      
endpoint health	
#输出在“-endpoints”标志中指定的端点的状态	  
endpoint status	
#输出--endpoints中每个端点的KV历史哈希	  
endpoint hashkv	
#将leader权转移到另一个etcd集群成员	  
move-leader
#监视键或前缀上的事件流		      
watch
#输出etcd和API版本			      
version	
#创建租约		      
lease grant
#移除租约		      
lease revoke
#获取租约信息	      
lease timetolive
#获取所有的活跃租约列表      
lease list	
#保持租约有效（续订）	      
lease keep-alive  
#将成员添加到群集    
member add
#将成员从群集移除		      
member remove
#将群集中的成员更新    
member update
#列出集群中的成员列表	      
member list	
#将etcd节点后端快照存储到给定文件	      
snapshot save	
#将etcd成员快照还原到etcd目录      
snapshot restore 
#获取给定文件的后端快照状态     
snapshot status	
#在目标etcd群集上生成镜像      
make-mirror	
#将v2存储中的密钥迁移到mvcc存储	      
migrate	
#获取命名锁		      
lock
#获得提名并参加leader选举			      
elect
#启用身份验证			      
auth enable
#关闭身份验证		      
auth disable
#添加用户	      
user add	
#删除用户	      
user delete	
#查看某个用户信息	      
user get	
#查看用户列表	      
user list
#修改用户密码		      
user passwd	
#给用户添加角色	      
user grant-role	  
#去除用户的角色    
user revoke-role 
#添加角色     
role add	
#删除角色	      
role delete	
#查看某个角色信息	      
role get
#查看角色列表		      
role list
#给角色授权		      
role grant-permission
#收回角色的权限
role revoke-permission
#检查etcd群集的性能
check perf		      

`全局参数`
#使用此CA捆绑包验证启用HTTPS的服务器的证书
--cacert=""	
#使用此SSL密钥文件标识HTTPS客户端			        
--cert=""	
短时间运行命令超时（不包括拨号超时）				        
--command-timeout=5s	
#启用客户端调试日志记录	        
--debug[=false]	
#客户端连接的拨号超时		        
--dial-timeout=2s
#用于查询描述群集终结点的SRV记录的域名			        
-d, --discovery-srv=""	
#gRPC端点	        
--endpoints=[127.0.0.1:2379]
#将字节字符串打印为十六进制编码字符串		
--hex[=false]
#接受描述群集终结点的不安全SRV记录				        
--insecure-discovery[=true]	
#跳过服务器证书验证	
--insecure-skip-tls-verify[=false]
#禁用客户端连接的传输安全
--insecure-transport[=true]	
#保持客户端连接的可用时间	
--keepalive-time=2s	
#客户端连接的keepalive超时		    
--keepalive-timeout=6s
#使用此SSL密钥文件标识HTTPS客户端			
--key=""	
#用于身份验证的用户名[：密码]（如果未提供密码，则提示				        
--user=""	
#设置输出格式（fields、json、protobuf、simple、table）				        
-w, --write-out="simple"