单命令行接口

curator_cli命令允许用户从命令行运行一个单独的支持的操作，而不需要客户端或者操作的 YAML 配置文件（尽管如果你想用的话它也是支持使用客户端配置文件的）。作为一个重要的奖励，命令行选项允许您覆盖curator.yml文件中配置的内容。

重要：尽管配置文件和命令行参数可以一起使用，但是需要重点注意，命令行选项将会覆盖基于文件的配置文件中相同的配置项。

$ curator_cli --help
Usage: curator_cli [OPTIONS] COMMAND [ARGS]...

Options:
  --config PATH                   配置文件路径
  --hosts TEXT                    连接的 Elasticsearch URL 地址
  --cloud_id TEXT                 连接的 Elastic 云实例简称
  --api_token TEXT                base64 编码的 API Key 口令
  --id TEXT                       API Key "id" 值
  --api_key TEXT                  API Key "api_key" 值
  --username TEXT                 创建 "basic_auth" 元组的用户名 
  --password TEXT                 创建 "basic_auth" 元组的密码
  --bearer_auth TEXT
  --opaque_id TEXT
  --request_timeout FLOAT         请求超时秒数
  --http_compress                 启用 HTTP 压缩
  --verify_certs                  验证 SSL/TLS 证书
  --ca_certs TEXT                 CA 证书文件或者目录路径
  --client_cert TEXT              客户端证书文件路径
  --client_key TEXT               客户端证书密钥路径
  --ssl_assert_hostname TEXT      要在节点的证书上验证的主机名或 IP 地址
  --ssl_assert_fingerprint TEXT   节点证书的 SHA-256 格式指纹。如果给出了这个值，那么基于信任 root 的验证将失效，只有节点的证书指纹验证通过才可以。
  --ssl_version TEXT              最小可接受的 TLS/SSL 版本
  --master-only                   只有当提供的单个主机是选定的主机时才运行
  --skip_version_test             不检查主机版本
  --dry-run                       不执行任何改变
  --loglevel [DEBUG|INFO|WARNING|ERROR|CRITICAL]
                                  日志等级
  --logfile TEXT                  日志文件
  --logformat [default|logstash|json|ecs]
                                  Log output format
  --version                       展示版本号并退出
  --help                          展示此信息并退出

Commands:
  alias             向别名 添加/删除 索引
  allocation        分片路由分配
  close             关闭索引
  delete-indices    删除索引
  delete-snapshots  删除快照
  forcemerge        强制合并索引 (减少段数量)
  open              开放索引
  replicas          变更副本数量
  restore           恢复索引
  rollover          通过别名翻转索引关联索引
  show-indices      展示索引
  show-snapshots    展示快照
  shrink            压缩索引至 --number_of_shards 分片数
  snapshot          快照索引

给定命令的选项标志与用于相同操作的选项标志匹配。唯一的区别是如何处理过滤。

命令行过滤

Curator 最新的改进包括模式和设置验证。通过这些改进，如果以 Curator 容易理解的方式传递参数，验证过滤器和他们排列（permutations ）将很容易实现。

--filter_list TEXT  JSON string representing an array of filters.

这意味着过滤器需要以单个对象的方式传递，或者是 JSON 格式的对象数组。

单个对象：

--filter_list '{"filtertype":"none"}'

多个对象：

--filter_list '[{"filtertype":"age","source":"creation_date","direction":"older","unit":"days","unit_count":13},{"filtertype":"pattern","kind":"prefix","value":"logstash"}]'

这保留了链式过滤器的功能，使它们可以在命令行上使用。

注意：在某些平台上，您可能需要转义所有的双引号，例如 PowerShell 之类的 shell 。

对这种方法需要注意的地方:

1. 一次只能带一个操作。
2. 不是所有的操作都有单例模式，例如 Alias 和 Restore 没有单例操作。

展示 索引/快照

一个单命令行能提供而其他命令不能提供的特征是展示系统中的索引和快照。这是一种很好的可视化测试过滤器而又不对系统造成任何损害的方式。

$ curator_cli show-indices --help
Usage: curator_cli show-indices [OPTIONS]

  Show indices

Options:
  --verbose           Show verbose output.
  --header            Print header if --verbose
  --epoch             Print time as epoch if --verbose
  --filter_list TEXT  JSON string representing an array of filters.
                      [required]
  --help              Show this message and exit.

$ curator_cli show-snapshots --help
Usage: curator_cli show-snapshots [OPTIONS]

  Show snapshots

Options:
  --repository TEXT   Snapshot repository name  [required]
  --filter_list TEXT  JSON string representing an array of filters.
                      [required]
  --help              Show this message and exit.

Index               State     Size     Docs Pri Rep   Creation Timestamp
logstash-2016.10.20 close     0.0B        0   5   1 2016-10-20T00:00:03Z
logstash-2016.10.21  open  763.3MB  5860016   5   1 2016-10-21T00:00:03Z
logstash-2016.10.22  open  759.1MB  5858450   5   1 2016-10-22T00:00:04Z
logstash-2016.10.23  open  757.8MB  5857456   5   1 2016-10-23T00:00:04Z
logstash-2016.10.24  open  771.5MB  5859720   5   1 2016-10-24T00:00:00Z
logstash-2016.10.25  open  771.0MB  5860112   5   1 2016-10-25T00:00:01Z
logstash-2016.10.27  open  658.3MB  4872830   5   1 2016-10-27T00:00:03Z
logstash-2016.10.28  open  655.1MB  5237250   5   1 2016-10-28T00:00:00Z

Index               State     Size     Docs Pri Rep creation_date
logstash-2016.10.20 close     0.0B        0   5   1    1476921603
logstash-2016.10.21  open  763.3MB  5860016   5   1    1477008003
logstash-2016.10.22  open  759.1MB  5858450   5   1    1477094404
logstash-2016.10.23  open  757.8MB  5857456   5   1    1477180804
logstash-2016.10.24  open  771.5MB  5859720   5   1    1477267200
logstash-2016.10.25  open  771.0MB  5860112   5   1    1477353601
logstash-2016.10.27  open  658.3MB  4872830   5   1    1477526403
logstash-2016.10.28  open  655.1MB  5237250   5   1    1477612800