Documentation
¶
Overview ¶
Creates an API key for access without requiring basic authentication.
Index ¶
- Variables
- type CreateApiKey
- func (r CreateApiKey) Do(ctx context.Context) (*Response, error)
- func (r *CreateApiKey) Header(key, value string) *CreateApiKey
- func (r *CreateApiKey) HttpRequest(ctx context.Context) (*http.Request, error)
- func (r CreateApiKey) Perform(ctx context.Context) (*http.Response, error)
- func (r *CreateApiKey) Raw(raw io.Reader) *CreateApiKey
- func (r *CreateApiKey) Refresh(enum refresh.Refresh) *CreateApiKey
- func (r *CreateApiKey) Request(req *Request) *CreateApiKey
- type NewCreateApiKey
- type Request
- type Response
Constants ¶
This section is empty.
Variables ¶
var ErrBuildPath = errors.New("cannot build path, check for missing path parameters")
ErrBuildPath is returned in case of missing parameters within the build of the request.
Functions ¶
This section is empty.
Types ¶
type CreateApiKey ¶
type CreateApiKey struct {
// contains filtered or unexported fields
}
func New ¶
func New(tp elastictransport.Interface) *CreateApiKey
Creates an API key for access without requiring basic authentication.
https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-create-api-key.html
func (CreateApiKey) Do ¶
func (r CreateApiKey) Do(ctx context.Context) (*Response, error)
Do runs the request through the transport, handle the response and returns a createapikey.Response
func (*CreateApiKey) Header ¶
func (r *CreateApiKey) Header(key, value string) *CreateApiKey
Header set a key, value pair in the CreateApiKey headers map.
func (*CreateApiKey) HttpRequest ¶
HttpRequest returns the http.Request object built from the given parameters.
func (CreateApiKey) Perform ¶
Perform runs the http.Request through the provided transport and returns an http.Response.
func (*CreateApiKey) Raw ¶
func (r *CreateApiKey) Raw(raw io.Reader) *CreateApiKey
Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.
func (*CreateApiKey) Refresh ¶
func (r *CreateApiKey) Refresh(enum refresh.Refresh) *CreateApiKey
Refresh If `true` (the default) then refresh 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. API name: refresh
func (*CreateApiKey) Request ¶
func (r *CreateApiKey) Request(req *Request) *CreateApiKey
Request allows to set the request property with the appropriate payload.
type NewCreateApiKey ¶
type NewCreateApiKey func() *CreateApiKey
NewCreateApiKey type alias for index.
func NewCreateApiKeyFunc ¶
func NewCreateApiKeyFunc(tp elastictransport.Interface) NewCreateApiKey
NewCreateApiKeyFunc returns a new instance of CreateApiKey with the provided transport. Used in the index of the library this allows to retrieve every apis in once place.
type Request ¶
type Request struct {
// Expiration Expiration time for the API key. By default, API keys never expire.
Expiration types.Duration `json:"expiration,omitempty"`
// Metadata Arbitrary metadata that you want to associate with the API key. It supports
// nested data structure. Within the metadata object, keys beginning with _ are
// reserved for system usage.
Metadata map[string]json.RawMessage `json:"metadata,omitempty"`
// Name Specifies the name for this API key.
Name *string `json:"name,omitempty"`
// RoleDescriptors An array of role descriptors for this API key. This parameter is optional.
// When it is not specified or is an empty array, then the API key will have a
// point in time snapshot of permissions of the authenticated user. If you
// supply role descriptors then the resultant permissions would be an
// intersection of API keys permissions and authenticated user’s permissions
// thereby limiting the access scope for API keys. The structure of role
// descriptor is the same as the request for create role API. For more details,
// see create or update roles API.
RoleDescriptors map[string]types.RoleDescriptor `json:"role_descriptors,omitempty"`
}
Request holds the request body struct for the package createapikey
type Response ¶
type Response struct {
// ApiKey Generated API key.
ApiKey string `json:"api_key"`
// Encoded API key credentials which is the base64-encoding of
// the UTF-8 representation of `id` and `api_key` joined
// by a colon (`:`).
Encoded string `json:"encoded"`
// Expiration Expiration in milliseconds for the API key.
Expiration *int64 `json:"expiration,omitempty"`
// Id Unique ID for this API key.
Id string `json:"id"`
// Name Specifies the name for this API key.
Name string `json:"name"`
}