Put 方法

Put 方法设置指定 key 到键值存储.

Put 方法增加键值存储的修订版本并在事件历史中生成一个事件.

  1. rpc Put(PutRequest) returns (PutResponse) {}

消息体

请求的消息体是 PutRequest：

  1. message PutRequest {
  2.   // byte 数组形式的 key，用来保存到键值对存储
  3.   bytes key = 1;
  5.   // byte 数组形式的 value，在键值对存储中和 key 关联
  6.   bytes value = 2;
  8.   // 在键值存储中和 key 关联的租约id。0代表没有租约。
  9.   int64 lease = 3;
  11.   // 如果 prev_kv 被设置，etcd 获取改变之前的上一个键值对。
  12.   // 上一个键值对将在 put 应答中被返回
  13.   bool prev_kv = 4;
  15.   // 如果 ignore_value 被设置, etcd 使用它当前的 value 更新 key.
  16.   // 如果 key 不存在，返回错误.
  17.   bool ignore_value = 5;
  19.   // 如果 ignore_lease 被设置, etcd 使用它当前的租约更新 key.
  20.   // 如果 key 不存在，返回错误.
  21.   bool ignore_lease = 6;
  22. }

应答的消息体是PutResponse：

  1. message PutResponse {
  2.   ResponseHeader header = 1;
  4.   // 如果请求中的 prev_kv 被设置，将会返回上一个键值对
  5.   mvccpb.KeyValue prev_kv = 2;
  6. }