api

Documentation

Overview

Package api groups packages simplifying Dynatrace API access.

Notably it contains the following packages

• github.com/dynatrace/dynatrace-configuration-as-code-core/api/rest containing an extended rest client with optional features like rate-limiting, request logging, etc.
• github.com/dynatrace/dynatrace-configuration-as-code-core/api/auth containing methods for creating authenticated rest clients
• github.com/dynatrace/dynatrace-configuration-as-code-core/api/clients containing client implementations for specific Dynatrace APIs

Index

• func DecodeJSON[T any](r Response) (T, error)
• func DecodeJSONObjects[T any](r ListResponse) ([]T, error)
• func DecodePaginatedJSONObjects[T any](p PagedListResponse) ([]T, error)
• func NewAPIErrorFromResponse(resp *http.Response) error
• func NewRequestInfoFromRequest(request *http.Request) rest.RequestInfo
• type APIError
  • func NewAPIErrorFromResponseAndBody(resp *http.Response, body []byte) APIError
  • func (r APIError) Error() string
  • func (r APIError) Is4xxError() bool
  • func (r APIError) Is5xxError() bool
• type ListResponse
• type MultipartResponse
  • func NewMultipartResponse(resp *http.Response, parts ...Part) *MultipartResponse
  • func (mr *MultipartResponse) GetPartWithName(name string) (Part, bool)
  • func (mr *MultipartResponse) IsSuccess() bool
• type PagedListResponse
  • func (p PagedListResponse) All() [][]byte
  • func (p PagedListResponse) AsAPIError() (APIError, bool)
• type Part
• type Response
  • func AsResponseOrError(resp *http.Response, err error) (*Response, error)
  • func NewResponseFromHTTPResponseAndBody(resp *http.Response, body []byte) Response
  • func (r Response) AsAPIError() (APIError, bool)
  • func (r Response) Is4xxError() bool
  • func (r Response) Is5xxError() bool
  • func (r Response) IsSuccess() bool

Functions

func DecodeJSON

func DecodeJSON[T any](r Response) (T, error)

DecodeJSON tries to unmarshal the Response.Data of the given Response r into an object of T.

func DecodeJSONObjects

func DecodeJSONObjects[T any](r ListResponse) ([]T, error)

DecodeJSONObjects unmarshalls Objects contained in the given ListResponse into a slice of T. To decode the full JSON response contained in ListResponse use Response.DecodeJSON.

func DecodePaginatedJSONObjects

func DecodePaginatedJSONObjects[T any](p PagedListResponse) ([]T, error)

DecodePaginatedJSONObjects unmarshalls all objects contained in the given PagedListResponse into a slice of T. Alternative ways to access data are to use PagedListResponse as a []ListResponse and decode each ListResponse or to access and decode the entries as []byte via PagedListResponse.All.

func NewAPIErrorFromResponse

func NewAPIErrorFromResponse(resp *http.Response) error

func NewRequestInfoFromRequest

func NewRequestInfoFromRequest(request *http.Request) rest.RequestInfo

Types

type APIError

type APIError struct {
	StatusCode int              `json:"statusCode"` // StatusCode is the HTTP response status code returned by the API.
	Body       []byte           `json:"body"`       // Body is the HTTP payload returned by the API.
	Request    rest.RequestInfo `json:"request"`    // Request is information about the original request that led to this response error.
}

APIError represents an error returned by an API with associated information.

func NewAPIErrorFromResponseAndBody

func NewAPIErrorFromResponseAndBody(resp *http.Response, body []byte) APIError

func (APIError) Error

func (r APIError) Error() string

Error returns a string representation of the APIError, providing details about the failed API request. It includes the HTTP method, URL, status code, and response body.

Returns: - string: A string representing the error message.

func (APIError) Is4xxError

func (r APIError) Is4xxError() bool

func (APIError) Is5xxError

func (r APIError) Is5xxError() bool

type ListResponse

type ListResponse struct {
	Response
	Objects [][]byte `json:"-"`
}

ListResponse represents a multi-object API response It contains both the full JSON Data, and a slice of Objects for more convenient access

type MultipartResponse

type MultipartResponse struct {
	StatusCode int
	Parts      []Part
	Request    rest.RequestInfo
}

MultipartResponse represent an HTTP multipart response. Each field part of a multipart content is in the map indexed with the name of the part.

func NewMultipartResponse

func NewMultipartResponse(resp *http.Response, parts ...Part) *MultipartResponse

func (*MultipartResponse) GetPartWithName

func (mr *MultipartResponse) GetPartWithName(name string) (Part, bool)

func (*MultipartResponse) IsSuccess

func (mr *MultipartResponse) IsSuccess() bool

type PagedListResponse

type PagedListResponse []ListResponse

PagedListResponse is a list of ListResponse values. It is used by return values of APIs that support pagination. Each ListResponse entry possibly contains multiple objects of the fetched resource type. To get all response objects in a single slice of []byte you can call All().

In case of any individual API request being unsuccessful, PagedListResponse will contain only that failed ListResponse.

func (PagedListResponse) All

func (p PagedListResponse) All() [][]byte

All returns all objects of a PagedListResponse in one slice

func (PagedListResponse) AsAPIError

func (p PagedListResponse) AsAPIError() (APIError, bool)

AsAPIError converts a PagedListResponse pointer to an APIError if it represents a 4xx or 5xx error. If the PagedListResponse does not represent an error, it returns an empty APIError and false. Unlike a normal Response, a PagedListResponse represents several individual API responses as a slice. In case of any response being unsuccessful, PagedListResponse will contain only that response by convention - this fact is used by this method.

Parameters: - [ (PagedListResponse): The PagedListResponse object to convert to an APIError.

Returns:

• (APIError, bool): An APIError containing error information and a boolean indicating whether the conversion was successful (true for errors, false otherwise).

type Part

type Part struct {
	FormName, FileName string
	Content            []byte
}

type Response

type Response struct {
	StatusCode int `json:"-"`
	Header     http.Header
	Data       []byte           `json:"-"`
	Request    rest.RequestInfo `json:"-"`
}

Response represents an API response

func AsResponseOrError

func AsResponseOrError(resp *http.Response, err error) (*Response, error)

AsResponseOrError is a helper function to convert an http.Response or error to a Response or error. It ensures that the response body is always read to completion and closed. Any non-successful (i.e. not 2xx) status code results in an APIError.

func NewResponseFromHTTPResponseAndBody

func NewResponseFromHTTPResponseAndBody(resp *http.Response, body []byte) Response

func (Response) AsAPIError

func (r Response) AsAPIError() (APIError, bool)

AsAPIError converts a Response object to an APIError if it represents a 4xx or 5xx error. If the Response does not represent an error, it returns an empty APIError and false.

Parameters: - r (Response): The Response object to convert to an APIError.

Returns:

• (APIError, bool): An APIError containing error information and a boolean indicating whether the conversion was successful (true for errors, false otherwise).

func (Response) Is4xxError

func (r Response) Is4xxError() bool

Is4xxError returns true if the response indicates a 4xx client error HTTP status code. A status code between 400 and 499 (inclusive) is considered a client error.

func (Response) Is5xxError

func (r Response) Is5xxError() bool

Is5xxError returns true if the response indicates a 5xx server error HTTP status code. A status code between 500 and 599 (inclusive) is considered a server error.

func (Response) IsSuccess

func (r Response) IsSuccess() bool

IsSuccess returns true if the response indicates a successful HTTP status code. A status code between 200 and 299 (inclusive) is considered a success.