情報 API

インストールされた X-Pack 機能に関する一般情報を提供します。

リクエスト

GET /_xpack

前提条件

  • Elasticsearch のセキュリティ機能が有効になっている場合、この API を使用するには monitor または manage クラスター権限 が必要です。

説明

この API によって提供される情報には次のものが含まれます:

  • ビルド情報 - ビルド番号とタイムスタンプを含む。
  • ライセンス情報 - 現在インストールされているライセンスに関する基本情報。
  • 機能情報 - 現在のライセンスの下で有効で利用可能な機能。

パスパラメータ

  • categories
  • (オプション、リスト) レスポンスに含める情報カテゴリのカンマ区切りリスト。例えば、build,license,features
  • human
  • (オプション、ブール値) レスポンスに追加の人間可読情報が含まれるかどうかを定義します。特に、説明とタグラインが追加されます。デフォルト値は true です。

次の例は情報 API をクエリします:

Python

  1. resp = client.xpack.info()
  2. print(resp)

Ruby

  1. response = client.xpack.info
  2. puts response

Js

  1. const response = await client.xpack.info();
  2. console.log(response);

コンソール

  1. GET /_xpack

例のレスポンス:

コンソール-結果

  1. {
  2. "build" : {
  3. "hash" : "2798b1a3ce779b3611bb53a0082d4d741e4d3168",
  4. "date" : "2015-04-07T13:34:42Z"
  5. },
  6. "license" : {
  7. "uid" : "893361dc-9749-4997-93cb-xxx",
  8. "type" : "trial",
  9. "mode" : "trial",
  10. "status" : "active",
  11. "expiry_date_in_millis" : 1542665112332
  12. },
  13. "features" : {
  14. "ccr" : {
  15. "available" : true,
  16. "enabled" : true
  17. },
  18. "aggregate_metric" : {
  19. "available" : true,
  20. "enabled" : true
  21. },
  22. "analytics" : {
  23. "available" : true,
  24. "enabled" : true
  25. },
  26. "archive" : {
  27. "available" : true,
  28. "enabled" : true
  29. },
  30. "enrich" : {
  31. "available" : true,
  32. "enabled" : true
  33. },
  34. "frozen_indices" : {
  35. "available" : true,
  36. "enabled" : true
  37. },
  38. "graph" : {
  39. "available" : true,
  40. "enabled" : true
  41. },
  42. "ilm" : {
  43. "available" : true,
  44. "enabled" : true
  45. },
  46. "logstash" : {
  47. "available" : true,
  48. "enabled" : true
  49. },
  50. "ml" : {
  51. "available" : true,
  52. "enabled" : true
  53. },
  54. "esql" : {
  55. "available" : true,
  56. "enabled" : true
  57. },
  58. "monitoring" : {
  59. "available" : true,
  60. "enabled" : true
  61. },
  62. "rollup": {
  63. "available": true,
  64. "enabled": true
  65. },
  66. "searchable_snapshots" : {
  67. "available" : true,
  68. "enabled" : true
  69. },
  70. "security" : {
  71. "available" : true,
  72. "enabled" : true
  73. },
  74. "slm" : {
  75. "available" : true,
  76. "enabled" : true
  77. },
  78. "spatial" : {
  79. "available" : true,
  80. "enabled" : true
  81. },
  82. "eql" : {
  83. "available" : true,
  84. "enabled" : true
  85. },
  86. "sql" : {
  87. "available" : true,
  88. "enabled" : true
  89. },
  90. "transform" : {
  91. "available" : true,
  92. "enabled" : true
  93. },
  94. "voting_only" : {
  95. "available" : true,
  96. "enabled" : true
  97. },
  98. "watcher" : {
  99. "available" : true,
  100. "enabled" : true
  101. },
  102. "data_streams" : {
  103. "available" : true,
  104. "enabled" : true
  105. },
  106. "data_tiers" : {
  107. "available" : true,
  108. "enabled" : true
  109. },
  110. "enterprise_search": {
  111. "available": true,
  112. "enabled": true
  113. },
  114. "universal_profiling": {
  115. "available": true,
  116. "enabled": true
  117. }
  118. },
  119. "tagline" : "You know, for X"
  120. }

次の例はビルドと機能情報のみを返します:

Python

  1. resp = client.xpack.info(
  2. categories="build,features",
  3. )
  4. print(resp)

Ruby

  1. response = client.xpack.info(
  2. categories: 'build,features'
  3. )
  4. puts response

Js

  1. const response = await client.xpack.info({
  2. categories: "build,features",
  3. });
  4. console.log(response);

コンソール

  1. GET /_xpack?categories=build,features

次の例はレスポンスから説明を削除します:

Python

  1. resp = client.xpack.info(
  2. human=False,
  3. )
  4. print(resp)

Ruby

  1. response = client.xpack.info(
  2. human: false
  3. )
  4. puts response

Js

  1. const response = await client.xpack.info({
  2. human: "false",
  3. });
  4. console.log(response);

コンソール

  1. GET /_xpack?human=false