queryapikeys

package
v8.16.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 14, 2024 License: Apache-2.0 Imports: 12 Imported by: 4

Documentation

Overview

Find API keys with a query.

Get a paginated list of API keys and their information. You can optionally filter the results with a query.

Index

Constants

This section is empty.

Variables

View Source 
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 NewQueryApiKeys 

type NewQueryApiKeys func() *QueryApiKeys

NewQueryApiKeys type alias for index.

func NewQueryApiKeysFunc 

func NewQueryApiKeysFunc(tp elastictransport.Interface) NewQueryApiKeys

NewQueryApiKeysFunc returns a new instance of QueryApiKeys with the provided transport. Used in the index of the library this allows to retrieve every apis in once place.

type QueryApiKeys 

type QueryApiKeys struct {
	// contains filtered or unexported fields
}

func New 

func New(tp elastictransport.Interface) *QueryApiKeys

Find API keys with a query.

Get a paginated list of API keys and their information. You can optionally filter the results with a query.

https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-query-api-key.html

func (*QueryApiKeys) Aggregations added in v8.13.0 

func (r *QueryApiKeys) Aggregations(aggregations map[string]types.ApiKeyAggregationContainer) *QueryApiKeys

Aggregations Any aggregations to run over the corpus of returned API keys. Aggregations and queries work together. Aggregations are computed only on the API keys that match the query. This supports only a subset of aggregation types, namely: `terms`, `range`, `date_range`, `missing`, `cardinality`, `value_count`, `composite`, `filter`, and `filters`. Additionally, aggregations only run over the same subset of fields that query works with. API name: aggregations

func (QueryApiKeys) Do 

func (r QueryApiKeys) Do(providedCtx context.Context) (*Response, error)

Do runs the request through the transport, handle the response and returns a queryapikeys.Response

func (*QueryApiKeys) ErrorTrace added in v8.14.0 

func (r *QueryApiKeys) ErrorTrace(errortrace bool) *QueryApiKeys

ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errors when they occur. API name: error_trace

func (*QueryApiKeys) FilterPath added in v8.14.0 

func (r *QueryApiKeys) FilterPath(filterpaths ...string) *QueryApiKeys

FilterPath Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch. API name: filter_path

func (*QueryApiKeys) From added in v8.9.0 

func (r *QueryApiKeys) From(from int) *QueryApiKeys

From Starting document offset. By default, you cannot page through more than 10,000 hits using the from and size parameters. To page through more hits, use the `search_after` parameter. API name: from

func (*QueryApiKeys) Header 

func (r *QueryApiKeys) Header(key, value string) *QueryApiKeys

Header set a key, value pair in the QueryApiKeys headers map.

func (*QueryApiKeys) HttpRequest 

func (r *QueryApiKeys) HttpRequest(ctx context.Context) (*http.Request, error)

HttpRequest returns the http.Request object built from the given parameters.

func (*QueryApiKeys) Human added in v8.14.0 

func (r *QueryApiKeys) Human(human bool) *QueryApiKeys

Human When set to `true` will return statistics in a format suitable for humans. For example `"exists_time": "1h"` for humans and `"eixsts_time_in_millis": 3600000` for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines. API name: human

func (QueryApiKeys) Perform added in v8.7.0 

func (r QueryApiKeys) Perform(providedCtx context.Context) (*http.Response, error)

Perform runs the http.Request through the provided transport and returns an http.Response.

func (*QueryApiKeys) Pretty added in v8.14.0 

func (r *QueryApiKeys) Pretty(pretty bool) *QueryApiKeys

Pretty If set to `true` the returned JSON will be "pretty-formatted". Only use this option for debugging only. API name: pretty

func (*QueryApiKeys) Query added in v8.9.0 

func (r *QueryApiKeys) Query(query *types.ApiKeyQueryContainer) *QueryApiKeys

Query A query to filter which API keys to return. If the query parameter is missing, it is equivalent to a `match_all` query. The query supports a subset of query types, including `match_all`, `bool`, `term`, `terms`, `match`, `ids`, `prefix`, `wildcard`, `exists`, `range`, and `simple_query_string`. You can query the following public information associated with an API key: `id`, `type`, `name`, `creation`, `expiration`, `invalidated`, `invalidation`, `username`, `realm`, and `metadata`. API name: query

func (*QueryApiKeys) Raw 

func (r *QueryApiKeys) Raw(raw io.Reader) *QueryApiKeys

Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.

func (*QueryApiKeys) Request 

func (r *QueryApiKeys) Request(req *Request) *QueryApiKeys

Request allows to set the request property with the appropriate payload.

func (*QueryApiKeys) SearchAfter added in v8.9.0 

func (r *QueryApiKeys) SearchAfter(sortresults ...types.FieldValue) *QueryApiKeys

SearchAfter Search after definition API name: search_after

func (*QueryApiKeys) Size added in v8.9.0 

func (r *QueryApiKeys) Size(size int) *QueryApiKeys

Size The number of hits to return. By default, you cannot page through more than 10,000 hits using the `from` and `size` parameters. To page through more hits, use the `search_after` parameter. API name: size

func (*QueryApiKeys) Sort added in v8.9.0 

func (r *QueryApiKeys) Sort(sorts ...types.SortCombinations) *QueryApiKeys

Sort Other than `id`, all public fields of an API key are eligible for sorting. In addition, sort can also be applied to the `_doc` field to sort by index order. API name: sort

func (*QueryApiKeys) TypedKeys added in v8.13.1 

func (r *QueryApiKeys) TypedKeys(typedkeys bool) *QueryApiKeys

TypedKeys Determines whether aggregation names are prefixed by their respective types in the response. API name: typed_keys

func (*QueryApiKeys) WithLimitedBy added in v8.5.0 

func (r *QueryApiKeys) WithLimitedBy(withlimitedby bool) *QueryApiKeys

WithLimitedBy Return the snapshot of the owner user's role descriptors associated with the API key. An API key's actual permission is the intersection of its assigned role descriptors and the owner user's role descriptors. API name: with_limited_by

func (*QueryApiKeys) WithProfileUid added in v8.14.0 

func (r *QueryApiKeys) WithProfileUid(withprofileuid bool) *QueryApiKeys

WithProfileUid Determines whether to also retrieve the profile uid, for the API key owner principal, if it exists. API name: with_profile_uid

type Request 

type Request struct {

	// Aggregations Any aggregations to run over the corpus of returned API keys.
	// Aggregations and queries work together. Aggregations are computed only on the
	// API keys that match the query.
	// This supports only a subset of aggregation types, namely: `terms`, `range`,
	// `date_range`, `missing`,
	// `cardinality`, `value_count`, `composite`, `filter`, and `filters`.
	// Additionally, aggregations only run over the same subset of fields that query
	// works with.
	Aggregations map[string]types.ApiKeyAggregationContainer `json:"aggregations,omitempty"`
	// From Starting document offset.
	// By default, you cannot page through more than 10,000 hits using the from and
	// size parameters.
	// To page through more hits, use the `search_after` parameter.
	From *int `json:"from,omitempty"`
	// Query A query to filter which API keys to return.
	// If the query parameter is missing, it is equivalent to a `match_all` query.
	// The query supports a subset of query types, including `match_all`, `bool`,
	// `term`, `terms`, `match`,
	// `ids`, `prefix`, `wildcard`, `exists`, `range`, and `simple_query_string`.
	// You can query the following public information associated with an API key:
	// `id`, `type`, `name`,
	// `creation`, `expiration`, `invalidated`, `invalidation`, `username`, `realm`,
	// and `metadata`.
	Query *types.ApiKeyQueryContainer `json:"query,omitempty"`
	// SearchAfter Search after definition
	SearchAfter []types.FieldValue `json:"search_after,omitempty"`
	// Size The number of hits to return.
	// By default, you cannot page through more than 10,000 hits using the `from`
	// and `size` parameters.
	// To page through more hits, use the `search_after` parameter.
	Size *int `json:"size,omitempty"`
	// Sort Other than `id`, all public fields of an API key are eligible for sorting.
	// In addition, sort can also be applied to the `_doc` field to sort by index
	// order.
	Sort []types.SortCombinations `json:"sort,omitempty"`
}

Request holds the request body struct for the package queryapikeys

https://github.com/elastic/elasticsearch-specification/blob/4fcf747dfafc951e1dcf3077327e3dcee9107db3/specification/security/query_api_keys/QueryApiKeysRequest.ts#L26-L101

func NewRequest added in v8.5.0 

func NewRequest() *Request

NewRequest returns a Request

func (*Request) FromJSON added in v8.5.0 

func (r *Request) FromJSON(data string) (*Request, error)

FromJSON allows to load an arbitrary json into the request structure

func (*Request) UnmarshalJSON added in v8.12.1 

func (s *Request) UnmarshalJSON(data []byte) error

type Response added in v8.7.0 

type Response struct {

	// Aggregations The aggregations result, if requested.
	Aggregations map[string]types.ApiKeyAggregate `json:"aggregations,omitempty"`
	// ApiKeys A list of API key information.
	ApiKeys []types.ApiKey `json:"api_keys"`
	// Count The number of API keys returned in the response.
	Count int `json:"count"`
	// Total The total number of API keys found.
	Total int `json:"total"`
}

Response holds the response body struct for the package queryapikeys

https://github.com/elastic/elasticsearch-specification/blob/4fcf747dfafc951e1dcf3077327e3dcee9107db3/specification/security/query_api_keys/QueryApiKeysResponse.ts#L26-L45

func NewResponse added in v8.7.0 

func NewResponse() *Response

NewResponse returns a Response

func (*Response) UnmarshalJSON added in v8.13.0 

func (s *Response) UnmarshalJSON(data []byte) error

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.