api.indices.simulate_template.go 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255
  1. // Licensed to Elasticsearch B.V. under one or more contributor
  2. // license agreements. See the NOTICE file distributed with
  3. // this work for additional information regarding copyright
  4. // ownership. Elasticsearch B.V. licenses this file to you under
  5. // the Apache License, Version 2.0 (the "License"); you may
  6. // not use this file except in compliance with the License.
  7. // You may obtain a copy of the License at
  8. //
  9. // http://www.apache.org/licenses/LICENSE-2.0
  10. //
  11. // Unless required by applicable law or agreed to in writing,
  12. // software distributed under the License is distributed on an
  13. // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  14. // KIND, either express or implied. See the License for the
  15. // specific language governing permissions and limitations
  16. // under the License.
  17. //
  18. // Code generated from specification version 7.17.10: DO NOT EDIT
  19. package esapi
  20. import (
  21. "context"
  22. "io"
  23. "net/http"
  24. "strconv"
  25. "strings"
  26. "time"
  27. )
  28. func newIndicesSimulateTemplateFunc(t Transport) IndicesSimulateTemplate {
  29. return func(o ...func(*IndicesSimulateTemplateRequest)) (*Response, error) {
  30. var r = IndicesSimulateTemplateRequest{}
  31. for _, f := range o {
  32. f(&r)
  33. }
  34. return r.Do(r.ctx, t)
  35. }
  36. }
  37. // ----- API Definition -------------------------------------------------------
  38. // IndicesSimulateTemplate simulate resolving the given template name or body
  39. //
  40. // See full documentation at https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html.
  41. type IndicesSimulateTemplate func(o ...func(*IndicesSimulateTemplateRequest)) (*Response, error)
  42. // IndicesSimulateTemplateRequest configures the Indices Simulate Template API request.
  43. type IndicesSimulateTemplateRequest struct {
  44. Body io.Reader
  45. Name string
  46. Cause string
  47. Create *bool
  48. MasterTimeout time.Duration
  49. Pretty bool
  50. Human bool
  51. ErrorTrace bool
  52. FilterPath []string
  53. Header http.Header
  54. ctx context.Context
  55. }
  56. // Do executes the request and returns response or error.
  57. func (r IndicesSimulateTemplateRequest) Do(ctx context.Context, transport Transport) (*Response, error) {
  58. var (
  59. method string
  60. path strings.Builder
  61. params map[string]string
  62. )
  63. method = "POST"
  64. path.Grow(1 + len("_index_template") + 1 + len("_simulate") + 1 + len(r.Name))
  65. path.WriteString("/")
  66. path.WriteString("_index_template")
  67. path.WriteString("/")
  68. path.WriteString("_simulate")
  69. if r.Name != "" {
  70. path.WriteString("/")
  71. path.WriteString(r.Name)
  72. }
  73. params = make(map[string]string)
  74. if r.Cause != "" {
  75. params["cause"] = r.Cause
  76. }
  77. if r.Create != nil {
  78. params["create"] = strconv.FormatBool(*r.Create)
  79. }
  80. if r.MasterTimeout != 0 {
  81. params["master_timeout"] = formatDuration(r.MasterTimeout)
  82. }
  83. if r.Pretty {
  84. params["pretty"] = "true"
  85. }
  86. if r.Human {
  87. params["human"] = "true"
  88. }
  89. if r.ErrorTrace {
  90. params["error_trace"] = "true"
  91. }
  92. if len(r.FilterPath) > 0 {
  93. params["filter_path"] = strings.Join(r.FilterPath, ",")
  94. }
  95. req, err := newRequest(method, path.String(), r.Body)
  96. if err != nil {
  97. return nil, err
  98. }
  99. if len(params) > 0 {
  100. q := req.URL.Query()
  101. for k, v := range params {
  102. q.Set(k, v)
  103. }
  104. req.URL.RawQuery = q.Encode()
  105. }
  106. if len(r.Header) > 0 {
  107. if len(req.Header) == 0 {
  108. req.Header = r.Header
  109. } else {
  110. for k, vv := range r.Header {
  111. for _, v := range vv {
  112. req.Header.Add(k, v)
  113. }
  114. }
  115. }
  116. }
  117. if r.Body != nil && req.Header.Get(headerContentType) == "" {
  118. req.Header[headerContentType] = headerContentTypeJSON
  119. }
  120. if ctx != nil {
  121. req = req.WithContext(ctx)
  122. }
  123. res, err := transport.Perform(req)
  124. if err != nil {
  125. return nil, err
  126. }
  127. response := Response{
  128. StatusCode: res.StatusCode,
  129. Body: res.Body,
  130. Header: res.Header,
  131. }
  132. return &response, nil
  133. }
  134. // WithContext sets the request context.
  135. func (f IndicesSimulateTemplate) WithContext(v context.Context) func(*IndicesSimulateTemplateRequest) {
  136. return func(r *IndicesSimulateTemplateRequest) {
  137. r.ctx = v
  138. }
  139. }
  140. // WithBody - New index template definition to be simulated, if no index template name is specified.
  141. func (f IndicesSimulateTemplate) WithBody(v io.Reader) func(*IndicesSimulateTemplateRequest) {
  142. return func(r *IndicesSimulateTemplateRequest) {
  143. r.Body = v
  144. }
  145. }
  146. // WithName - the name of the index template.
  147. func (f IndicesSimulateTemplate) WithName(v string) func(*IndicesSimulateTemplateRequest) {
  148. return func(r *IndicesSimulateTemplateRequest) {
  149. r.Name = v
  150. }
  151. }
  152. // WithCause - user defined reason for dry-run creating the new template for simulation purposes.
  153. func (f IndicesSimulateTemplate) WithCause(v string) func(*IndicesSimulateTemplateRequest) {
  154. return func(r *IndicesSimulateTemplateRequest) {
  155. r.Cause = v
  156. }
  157. }
  158. // WithCreate - whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one.
  159. func (f IndicesSimulateTemplate) WithCreate(v bool) func(*IndicesSimulateTemplateRequest) {
  160. return func(r *IndicesSimulateTemplateRequest) {
  161. r.Create = &v
  162. }
  163. }
  164. // WithMasterTimeout - specify timeout for connection to master.
  165. func (f IndicesSimulateTemplate) WithMasterTimeout(v time.Duration) func(*IndicesSimulateTemplateRequest) {
  166. return func(r *IndicesSimulateTemplateRequest) {
  167. r.MasterTimeout = v
  168. }
  169. }
  170. // WithPretty makes the response body pretty-printed.
  171. func (f IndicesSimulateTemplate) WithPretty() func(*IndicesSimulateTemplateRequest) {
  172. return func(r *IndicesSimulateTemplateRequest) {
  173. r.Pretty = true
  174. }
  175. }
  176. // WithHuman makes statistical values human-readable.
  177. func (f IndicesSimulateTemplate) WithHuman() func(*IndicesSimulateTemplateRequest) {
  178. return func(r *IndicesSimulateTemplateRequest) {
  179. r.Human = true
  180. }
  181. }
  182. // WithErrorTrace includes the stack trace for errors in the response body.
  183. func (f IndicesSimulateTemplate) WithErrorTrace() func(*IndicesSimulateTemplateRequest) {
  184. return func(r *IndicesSimulateTemplateRequest) {
  185. r.ErrorTrace = true
  186. }
  187. }
  188. // WithFilterPath filters the properties of the response body.
  189. func (f IndicesSimulateTemplate) WithFilterPath(v ...string) func(*IndicesSimulateTemplateRequest) {
  190. return func(r *IndicesSimulateTemplateRequest) {
  191. r.FilterPath = v
  192. }
  193. }
  194. // WithHeader adds the headers to the HTTP request.
  195. func (f IndicesSimulateTemplate) WithHeader(h map[string]string) func(*IndicesSimulateTemplateRequest) {
  196. return func(r *IndicesSimulateTemplateRequest) {
  197. if r.Header == nil {
  198. r.Header = make(http.Header)
  199. }
  200. for k, v := range h {
  201. r.Header.Add(k, v)
  202. }
  203. }
  204. }
  205. // WithOpaqueID adds the X-Opaque-Id header to the HTTP request.
  206. func (f IndicesSimulateTemplate) WithOpaqueID(s string) func(*IndicesSimulateTemplateRequest) {
  207. return func(r *IndicesSimulateTemplateRequest) {
  208. if r.Header == nil {
  209. r.Header = make(http.Header)
  210. }
  211. r.Header.Set("X-Opaque-Id", s)
  212. }
  213. }