-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
-
166
-
167
-
168
-
169
-
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
-
178
-
179
-
180
-
181
-
182
-
183
-
184
-
185
-
186
-
187
-
188
-
189
-
190
-
191
-
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
// Copyright 2012-2018 Oliver Eilhard. All rights reserved.
// Use of this source code is governed by a MIT-license.
// See http://olivere.mit-license.org/license.txt for details.
package elastic
import (
"context"
"encoding/json"
"fmt"
"net/http"
"net/url"
"strings"
"github.com/olivere/elastic/v7/uritemplates"
)
// XPackSecurityChangePasswordService changes a native user's password.
//
// See https://www.elastic.co/guide/en/elasticsearch/reference/7.1/security-api-change-password.html.
type XPackSecurityChangePasswordService struct {
client *Client
pretty *bool // pretty format the returned JSON response
human *bool // return human readable values for statistics
errorTrace *bool // include the stack trace of returned errors
filterPath []string // list of filters used to reduce the response
headers http.Header // custom request-level HTTP headers
username string
password string
refresh string
body interface{}
}
// NewXPackSecurityChangePasswordService creates a new XPackSecurityChangePasswordService.
func NewXPackSecurityChangePasswordService(client *Client) *XPackSecurityChangePasswordService {
return &XPackSecurityChangePasswordService{
client: client,
}
}
// Pretty tells Elasticsearch whether to return a formatted JSON response.
func (s *XPackSecurityChangePasswordService) Pretty(pretty bool) *XPackSecurityChangePasswordService {
s.pretty = &pretty
return s
}
// Human specifies whether human readable values should be returned in
// the JSON response, e.g. "7.5mb".
func (s *XPackSecurityChangePasswordService) Human(human bool) *XPackSecurityChangePasswordService {
s.human = &human
return s
}
// ErrorTrace specifies whether to include the stack trace of returned errors.
func (s *XPackSecurityChangePasswordService) ErrorTrace(errorTrace bool) *XPackSecurityChangePasswordService {
s.errorTrace = &errorTrace
return s
}
// FilterPath specifies a list of filters used to reduce the response.
func (s *XPackSecurityChangePasswordService) FilterPath(filterPath ...string) *XPackSecurityChangePasswordService {
s.filterPath = filterPath
return s
}
// Header adds a header to the request.
func (s *XPackSecurityChangePasswordService) Header(name string, value string) *XPackSecurityChangePasswordService {
if s.headers == nil {
s.headers = http.Header{}
}
s.headers.Add(name, value)
return s
}
// Headers specifies the headers of the request.
func (s *XPackSecurityChangePasswordService) Headers(headers http.Header) *XPackSecurityChangePasswordService {
s.headers = headers
return s
}
// Username is name of the user to change.
func (s *XPackSecurityChangePasswordService) Username(username string) *XPackSecurityChangePasswordService {
s.username = username
return s
}
// Password is the new value of the password.
func (s *XPackSecurityChangePasswordService) Password(password string) *XPackSecurityChangePasswordService {
s.password = password
return s
}
// Refresh, if "true" (the default), refreshes the affected shards to make this operation
// visible to search, if "wait_for" then wait for a refresh to make this operation visible
// to search, if "false" then do nothing with refreshes.
func (s *XPackSecurityChangePasswordService) Refresh(refresh string) *XPackSecurityChangePasswordService {
s.refresh = refresh
return s
}
// Body specifies the password. Use a string or a type that will get serialized as JSON.
func (s *XPackSecurityChangePasswordService) Body(body interface{}) *XPackSecurityChangePasswordService {
s.body = body
return s
}
// buildURL builds the URL for the operation.
func (s *XPackSecurityChangePasswordService) buildURL() (string, url.Values, error) {
// Build URL
path, err := uritemplates.Expand("/_xpack/security/user/{username}/_password", map[string]string{
"username": s.username,
})
if err != nil {
return "", url.Values{}, err
}
// Add query string parameters
params := url.Values{}
if v := s.pretty; v != nil {
params.Set("pretty", fmt.Sprint(*v))
}
if v := s.human; v != nil {
params.Set("human", fmt.Sprint(*v))
}
if v := s.errorTrace; v != nil {
params.Set("error_trace", fmt.Sprint(*v))
}
if len(s.filterPath) > 0 {
params.Set("filter_path", strings.Join(s.filterPath, ","))
}
if v := s.refresh; v != "" {
params.Set("refresh", v)
}
return path, params, nil
}
// Validate checks if the operation is valid.
func (s *XPackSecurityChangePasswordService) Validate() error {
var invalid []string
if s.username == "" {
invalid = append(invalid, "Userame")
}
if s.password == "" && s.body == nil {
invalid = append(invalid, "Body")
}
if len(invalid) > 0 {
return fmt.Errorf("missing required fields: %v", invalid)
}
return nil
}
// Do executes the operation.
func (s *XPackSecurityChangePasswordService) Do(ctx context.Context) (*XPackSecurityChangeUserPasswordResponse, error) {
// Check pre-conditions
if err := s.Validate(); err != nil {
return nil, err
}
// Get URL for request
path, params, err := s.buildURL()
if err != nil {
return nil, err
}
var body interface{}
if s.body != nil {
body = s.body
} else {
body = map[string]interface{}{
"password": s.password,
}
}
// Get HTTP response
res, err := s.client.PerformRequest(ctx, PerformRequestOptions{
Method: "POST",
Path: path,
Params: params,
Body: body,
Headers: s.headers,
})
if err != nil {
return nil, err
}
// Return operation response
ret := new(XPackSecurityChangeUserPasswordResponse)
if err := json.Unmarshal(res.Body, ret); err != nil {
return nil, err
}
return ret, nil
}
// XPackSecurityChangeUserPasswordResponse is the response of
// XPackSecurityChangePasswordService.Do.
//
// A successful call returns an empty JSON structure: {}.
type XPackSecurityChangeUserPasswordResponse struct {
}