Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
6415 lines (5419 sloc) 197 KB
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package xray
import (
"fmt"
"time"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/awsutil"
"github.com/aws/aws-sdk-go/aws/request"
"github.com/aws/aws-sdk-go/private/protocol"
"github.com/aws/aws-sdk-go/private/protocol/restjson"
)
const opBatchGetTraces = "BatchGetTraces"
// BatchGetTracesRequest generates a "aws/request.Request" representing the
// client's request for the BatchGetTraces operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See BatchGetTraces for more information on using the BatchGetTraces
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the BatchGetTracesRequest method.
// req, resp := client.BatchGetTracesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BatchGetTraces
func (c *XRay) BatchGetTracesRequest(input *BatchGetTracesInput) (req *request.Request, output *BatchGetTracesOutput) {
op := &request.Operation{
Name: opBatchGetTraces,
HTTPMethod: "POST",
HTTPPath: "/Traces",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &BatchGetTracesInput{}
}
output = &BatchGetTracesOutput{}
req = c.newRequest(op, input, output)
return
}
// BatchGetTraces API operation for AWS X-Ray.
//
// Retrieves a list of traces specified by ID. Each trace is a collection of
// segment documents that originates from a single request. Use GetTraceSummaries
// to get a list of trace IDs.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation BatchGetTraces for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BatchGetTraces
func (c *XRay) BatchGetTraces(input *BatchGetTracesInput) (*BatchGetTracesOutput, error) {
req, out := c.BatchGetTracesRequest(input)
return out, req.Send()
}
// BatchGetTracesWithContext is the same as BatchGetTraces with the addition of
// the ability to pass a context and additional request options.
//
// See BatchGetTraces for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) BatchGetTracesWithContext(ctx aws.Context, input *BatchGetTracesInput, opts ...request.Option) (*BatchGetTracesOutput, error) {
req, out := c.BatchGetTracesRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// BatchGetTracesPages iterates over the pages of a BatchGetTraces operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See BatchGetTraces method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a BatchGetTraces operation.
// pageNum := 0
// err := client.BatchGetTracesPages(params,
// func(page *xray.BatchGetTracesOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) BatchGetTracesPages(input *BatchGetTracesInput, fn func(*BatchGetTracesOutput, bool) bool) error {
return c.BatchGetTracesPagesWithContext(aws.BackgroundContext(), input, fn)
}
// BatchGetTracesPagesWithContext same as BatchGetTracesPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) BatchGetTracesPagesWithContext(ctx aws.Context, input *BatchGetTracesInput, fn func(*BatchGetTracesOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *BatchGetTracesInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.BatchGetTracesRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*BatchGetTracesOutput), !p.HasNextPage())
}
return p.Err()
}
const opCreateGroup = "CreateGroup"
// CreateGroupRequest generates a "aws/request.Request" representing the
// client's request for the CreateGroup operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See CreateGroup for more information on using the CreateGroup
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the CreateGroupRequest method.
// req, resp := client.CreateGroupRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/CreateGroup
func (c *XRay) CreateGroupRequest(input *CreateGroupInput) (req *request.Request, output *CreateGroupOutput) {
op := &request.Operation{
Name: opCreateGroup,
HTTPMethod: "POST",
HTTPPath: "/CreateGroup",
}
if input == nil {
input = &CreateGroupInput{}
}
output = &CreateGroupOutput{}
req = c.newRequest(op, input, output)
return
}
// CreateGroup API operation for AWS X-Ray.
//
// Creates a group resource with a name and a filter expression.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation CreateGroup for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/CreateGroup
func (c *XRay) CreateGroup(input *CreateGroupInput) (*CreateGroupOutput, error) {
req, out := c.CreateGroupRequest(input)
return out, req.Send()
}
// CreateGroupWithContext is the same as CreateGroup with the addition of
// the ability to pass a context and additional request options.
//
// See CreateGroup for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) CreateGroupWithContext(ctx aws.Context, input *CreateGroupInput, opts ...request.Option) (*CreateGroupOutput, error) {
req, out := c.CreateGroupRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opCreateSamplingRule = "CreateSamplingRule"
// CreateSamplingRuleRequest generates a "aws/request.Request" representing the
// client's request for the CreateSamplingRule operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See CreateSamplingRule for more information on using the CreateSamplingRule
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the CreateSamplingRuleRequest method.
// req, resp := client.CreateSamplingRuleRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/CreateSamplingRule
func (c *XRay) CreateSamplingRuleRequest(input *CreateSamplingRuleInput) (req *request.Request, output *CreateSamplingRuleOutput) {
op := &request.Operation{
Name: opCreateSamplingRule,
HTTPMethod: "POST",
HTTPPath: "/CreateSamplingRule",
}
if input == nil {
input = &CreateSamplingRuleInput{}
}
output = &CreateSamplingRuleOutput{}
req = c.newRequest(op, input, output)
return
}
// CreateSamplingRule API operation for AWS X-Ray.
//
// Creates a rule to control sampling behavior for instrumented applications.
// Services retrieve rules with GetSamplingRules, and evaluate each rule in
// ascending order of priority for each request. If a rule matches, the service
// records a trace, borrowing it from the reservoir size. After 10 seconds,
// the service reports back to X-Ray with GetSamplingTargets to get updated
// versions of each in-use rule. The updated rule contains a trace quota that
// the service can use instead of borrowing from the reservoir.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation CreateSamplingRule for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// * ErrCodeRuleLimitExceededException "RuleLimitExceededException"
// You have reached the maximum number of sampling rules.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/CreateSamplingRule
func (c *XRay) CreateSamplingRule(input *CreateSamplingRuleInput) (*CreateSamplingRuleOutput, error) {
req, out := c.CreateSamplingRuleRequest(input)
return out, req.Send()
}
// CreateSamplingRuleWithContext is the same as CreateSamplingRule with the addition of
// the ability to pass a context and additional request options.
//
// See CreateSamplingRule for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) CreateSamplingRuleWithContext(ctx aws.Context, input *CreateSamplingRuleInput, opts ...request.Option) (*CreateSamplingRuleOutput, error) {
req, out := c.CreateSamplingRuleRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opDeleteGroup = "DeleteGroup"
// DeleteGroupRequest generates a "aws/request.Request" representing the
// client's request for the DeleteGroup operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See DeleteGroup for more information on using the DeleteGroup
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the DeleteGroupRequest method.
// req, resp := client.DeleteGroupRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/DeleteGroup
func (c *XRay) DeleteGroupRequest(input *DeleteGroupInput) (req *request.Request, output *DeleteGroupOutput) {
op := &request.Operation{
Name: opDeleteGroup,
HTTPMethod: "POST",
HTTPPath: "/DeleteGroup",
}
if input == nil {
input = &DeleteGroupInput{}
}
output = &DeleteGroupOutput{}
req = c.newRequest(op, input, output)
req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
return
}
// DeleteGroup API operation for AWS X-Ray.
//
// Deletes a group resource.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation DeleteGroup for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/DeleteGroup
func (c *XRay) DeleteGroup(input *DeleteGroupInput) (*DeleteGroupOutput, error) {
req, out := c.DeleteGroupRequest(input)
return out, req.Send()
}
// DeleteGroupWithContext is the same as DeleteGroup with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteGroup for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) DeleteGroupWithContext(ctx aws.Context, input *DeleteGroupInput, opts ...request.Option) (*DeleteGroupOutput, error) {
req, out := c.DeleteGroupRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opDeleteSamplingRule = "DeleteSamplingRule"
// DeleteSamplingRuleRequest generates a "aws/request.Request" representing the
// client's request for the DeleteSamplingRule operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See DeleteSamplingRule for more information on using the DeleteSamplingRule
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the DeleteSamplingRuleRequest method.
// req, resp := client.DeleteSamplingRuleRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/DeleteSamplingRule
func (c *XRay) DeleteSamplingRuleRequest(input *DeleteSamplingRuleInput) (req *request.Request, output *DeleteSamplingRuleOutput) {
op := &request.Operation{
Name: opDeleteSamplingRule,
HTTPMethod: "POST",
HTTPPath: "/DeleteSamplingRule",
}
if input == nil {
input = &DeleteSamplingRuleInput{}
}
output = &DeleteSamplingRuleOutput{}
req = c.newRequest(op, input, output)
return
}
// DeleteSamplingRule API operation for AWS X-Ray.
//
// Deletes a sampling rule.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation DeleteSamplingRule for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/DeleteSamplingRule
func (c *XRay) DeleteSamplingRule(input *DeleteSamplingRuleInput) (*DeleteSamplingRuleOutput, error) {
req, out := c.DeleteSamplingRuleRequest(input)
return out, req.Send()
}
// DeleteSamplingRuleWithContext is the same as DeleteSamplingRule with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteSamplingRule for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) DeleteSamplingRuleWithContext(ctx aws.Context, input *DeleteSamplingRuleInput, opts ...request.Option) (*DeleteSamplingRuleOutput, error) {
req, out := c.DeleteSamplingRuleRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opGetEncryptionConfig = "GetEncryptionConfig"
// GetEncryptionConfigRequest generates a "aws/request.Request" representing the
// client's request for the GetEncryptionConfig operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetEncryptionConfig for more information on using the GetEncryptionConfig
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetEncryptionConfigRequest method.
// req, resp := client.GetEncryptionConfigRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetEncryptionConfig
func (c *XRay) GetEncryptionConfigRequest(input *GetEncryptionConfigInput) (req *request.Request, output *GetEncryptionConfigOutput) {
op := &request.Operation{
Name: opGetEncryptionConfig,
HTTPMethod: "POST",
HTTPPath: "/EncryptionConfig",
}
if input == nil {
input = &GetEncryptionConfigInput{}
}
output = &GetEncryptionConfigOutput{}
req = c.newRequest(op, input, output)
return
}
// GetEncryptionConfig API operation for AWS X-Ray.
//
// Retrieves the current encryption configuration for X-Ray data.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetEncryptionConfig for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetEncryptionConfig
func (c *XRay) GetEncryptionConfig(input *GetEncryptionConfigInput) (*GetEncryptionConfigOutput, error) {
req, out := c.GetEncryptionConfigRequest(input)
return out, req.Send()
}
// GetEncryptionConfigWithContext is the same as GetEncryptionConfig with the addition of
// the ability to pass a context and additional request options.
//
// See GetEncryptionConfig for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetEncryptionConfigWithContext(ctx aws.Context, input *GetEncryptionConfigInput, opts ...request.Option) (*GetEncryptionConfigOutput, error) {
req, out := c.GetEncryptionConfigRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opGetGroup = "GetGroup"
// GetGroupRequest generates a "aws/request.Request" representing the
// client's request for the GetGroup operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetGroup for more information on using the GetGroup
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetGroupRequest method.
// req, resp := client.GetGroupRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetGroup
func (c *XRay) GetGroupRequest(input *GetGroupInput) (req *request.Request, output *GetGroupOutput) {
op := &request.Operation{
Name: opGetGroup,
HTTPMethod: "POST",
HTTPPath: "/GetGroup",
}
if input == nil {
input = &GetGroupInput{}
}
output = &GetGroupOutput{}
req = c.newRequest(op, input, output)
return
}
// GetGroup API operation for AWS X-Ray.
//
// Retrieves group resource details.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetGroup for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetGroup
func (c *XRay) GetGroup(input *GetGroupInput) (*GetGroupOutput, error) {
req, out := c.GetGroupRequest(input)
return out, req.Send()
}
// GetGroupWithContext is the same as GetGroup with the addition of
// the ability to pass a context and additional request options.
//
// See GetGroup for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetGroupWithContext(ctx aws.Context, input *GetGroupInput, opts ...request.Option) (*GetGroupOutput, error) {
req, out := c.GetGroupRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opGetGroups = "GetGroups"
// GetGroupsRequest generates a "aws/request.Request" representing the
// client's request for the GetGroups operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetGroups for more information on using the GetGroups
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetGroupsRequest method.
// req, resp := client.GetGroupsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetGroups
func (c *XRay) GetGroupsRequest(input *GetGroupsInput) (req *request.Request, output *GetGroupsOutput) {
op := &request.Operation{
Name: opGetGroups,
HTTPMethod: "POST",
HTTPPath: "/Groups",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetGroupsInput{}
}
output = &GetGroupsOutput{}
req = c.newRequest(op, input, output)
return
}
// GetGroups API operation for AWS X-Ray.
//
// Retrieves all active group details.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetGroups for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetGroups
func (c *XRay) GetGroups(input *GetGroupsInput) (*GetGroupsOutput, error) {
req, out := c.GetGroupsRequest(input)
return out, req.Send()
}
// GetGroupsWithContext is the same as GetGroups with the addition of
// the ability to pass a context and additional request options.
//
// See GetGroups for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetGroupsWithContext(ctx aws.Context, input *GetGroupsInput, opts ...request.Option) (*GetGroupsOutput, error) {
req, out := c.GetGroupsRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetGroupsPages iterates over the pages of a GetGroups operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetGroups method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetGroups operation.
// pageNum := 0
// err := client.GetGroupsPages(params,
// func(page *xray.GetGroupsOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetGroupsPages(input *GetGroupsInput, fn func(*GetGroupsOutput, bool) bool) error {
return c.GetGroupsPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetGroupsPagesWithContext same as GetGroupsPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetGroupsPagesWithContext(ctx aws.Context, input *GetGroupsInput, fn func(*GetGroupsOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetGroupsInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetGroupsRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetGroupsOutput), !p.HasNextPage())
}
return p.Err()
}
const opGetSamplingRules = "GetSamplingRules"
// GetSamplingRulesRequest generates a "aws/request.Request" representing the
// client's request for the GetSamplingRules operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetSamplingRules for more information on using the GetSamplingRules
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetSamplingRulesRequest method.
// req, resp := client.GetSamplingRulesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetSamplingRules
func (c *XRay) GetSamplingRulesRequest(input *GetSamplingRulesInput) (req *request.Request, output *GetSamplingRulesOutput) {
op := &request.Operation{
Name: opGetSamplingRules,
HTTPMethod: "POST",
HTTPPath: "/GetSamplingRules",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetSamplingRulesInput{}
}
output = &GetSamplingRulesOutput{}
req = c.newRequest(op, input, output)
return
}
// GetSamplingRules API operation for AWS X-Ray.
//
// Retrieves all sampling rules.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetSamplingRules for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetSamplingRules
func (c *XRay) GetSamplingRules(input *GetSamplingRulesInput) (*GetSamplingRulesOutput, error) {
req, out := c.GetSamplingRulesRequest(input)
return out, req.Send()
}
// GetSamplingRulesWithContext is the same as GetSamplingRules with the addition of
// the ability to pass a context and additional request options.
//
// See GetSamplingRules for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetSamplingRulesWithContext(ctx aws.Context, input *GetSamplingRulesInput, opts ...request.Option) (*GetSamplingRulesOutput, error) {
req, out := c.GetSamplingRulesRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetSamplingRulesPages iterates over the pages of a GetSamplingRules operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetSamplingRules method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetSamplingRules operation.
// pageNum := 0
// err := client.GetSamplingRulesPages(params,
// func(page *xray.GetSamplingRulesOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetSamplingRulesPages(input *GetSamplingRulesInput, fn func(*GetSamplingRulesOutput, bool) bool) error {
return c.GetSamplingRulesPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetSamplingRulesPagesWithContext same as GetSamplingRulesPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetSamplingRulesPagesWithContext(ctx aws.Context, input *GetSamplingRulesInput, fn func(*GetSamplingRulesOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetSamplingRulesInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetSamplingRulesRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetSamplingRulesOutput), !p.HasNextPage())
}
return p.Err()
}
const opGetSamplingStatisticSummaries = "GetSamplingStatisticSummaries"
// GetSamplingStatisticSummariesRequest generates a "aws/request.Request" representing the
// client's request for the GetSamplingStatisticSummaries operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetSamplingStatisticSummaries for more information on using the GetSamplingStatisticSummaries
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetSamplingStatisticSummariesRequest method.
// req, resp := client.GetSamplingStatisticSummariesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetSamplingStatisticSummaries
func (c *XRay) GetSamplingStatisticSummariesRequest(input *GetSamplingStatisticSummariesInput) (req *request.Request, output *GetSamplingStatisticSummariesOutput) {
op := &request.Operation{
Name: opGetSamplingStatisticSummaries,
HTTPMethod: "POST",
HTTPPath: "/SamplingStatisticSummaries",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetSamplingStatisticSummariesInput{}
}
output = &GetSamplingStatisticSummariesOutput{}
req = c.newRequest(op, input, output)
return
}
// GetSamplingStatisticSummaries API operation for AWS X-Ray.
//
// Retrieves information about recent sampling results for all sampling rules.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetSamplingStatisticSummaries for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetSamplingStatisticSummaries
func (c *XRay) GetSamplingStatisticSummaries(input *GetSamplingStatisticSummariesInput) (*GetSamplingStatisticSummariesOutput, error) {
req, out := c.GetSamplingStatisticSummariesRequest(input)
return out, req.Send()
}
// GetSamplingStatisticSummariesWithContext is the same as GetSamplingStatisticSummaries with the addition of
// the ability to pass a context and additional request options.
//
// See GetSamplingStatisticSummaries for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetSamplingStatisticSummariesWithContext(ctx aws.Context, input *GetSamplingStatisticSummariesInput, opts ...request.Option) (*GetSamplingStatisticSummariesOutput, error) {
req, out := c.GetSamplingStatisticSummariesRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetSamplingStatisticSummariesPages iterates over the pages of a GetSamplingStatisticSummaries operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetSamplingStatisticSummaries method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetSamplingStatisticSummaries operation.
// pageNum := 0
// err := client.GetSamplingStatisticSummariesPages(params,
// func(page *xray.GetSamplingStatisticSummariesOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetSamplingStatisticSummariesPages(input *GetSamplingStatisticSummariesInput, fn func(*GetSamplingStatisticSummariesOutput, bool) bool) error {
return c.GetSamplingStatisticSummariesPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetSamplingStatisticSummariesPagesWithContext same as GetSamplingStatisticSummariesPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetSamplingStatisticSummariesPagesWithContext(ctx aws.Context, input *GetSamplingStatisticSummariesInput, fn func(*GetSamplingStatisticSummariesOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetSamplingStatisticSummariesInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetSamplingStatisticSummariesRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetSamplingStatisticSummariesOutput), !p.HasNextPage())
}
return p.Err()
}
const opGetSamplingTargets = "GetSamplingTargets"
// GetSamplingTargetsRequest generates a "aws/request.Request" representing the
// client's request for the GetSamplingTargets operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetSamplingTargets for more information on using the GetSamplingTargets
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetSamplingTargetsRequest method.
// req, resp := client.GetSamplingTargetsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetSamplingTargets
func (c *XRay) GetSamplingTargetsRequest(input *GetSamplingTargetsInput) (req *request.Request, output *GetSamplingTargetsOutput) {
op := &request.Operation{
Name: opGetSamplingTargets,
HTTPMethod: "POST",
HTTPPath: "/SamplingTargets",
}
if input == nil {
input = &GetSamplingTargetsInput{}
}
output = &GetSamplingTargetsOutput{}
req = c.newRequest(op, input, output)
return
}
// GetSamplingTargets API operation for AWS X-Ray.
//
// Requests a sampling quota for rules that the service is using to sample requests.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetSamplingTargets for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetSamplingTargets
func (c *XRay) GetSamplingTargets(input *GetSamplingTargetsInput) (*GetSamplingTargetsOutput, error) {
req, out := c.GetSamplingTargetsRequest(input)
return out, req.Send()
}
// GetSamplingTargetsWithContext is the same as GetSamplingTargets with the addition of
// the ability to pass a context and additional request options.
//
// See GetSamplingTargets for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetSamplingTargetsWithContext(ctx aws.Context, input *GetSamplingTargetsInput, opts ...request.Option) (*GetSamplingTargetsOutput, error) {
req, out := c.GetSamplingTargetsRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opGetServiceGraph = "GetServiceGraph"
// GetServiceGraphRequest generates a "aws/request.Request" representing the
// client's request for the GetServiceGraph operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetServiceGraph for more information on using the GetServiceGraph
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetServiceGraphRequest method.
// req, resp := client.GetServiceGraphRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetServiceGraph
func (c *XRay) GetServiceGraphRequest(input *GetServiceGraphInput) (req *request.Request, output *GetServiceGraphOutput) {
op := &request.Operation{
Name: opGetServiceGraph,
HTTPMethod: "POST",
HTTPPath: "/ServiceGraph",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetServiceGraphInput{}
}
output = &GetServiceGraphOutput{}
req = c.newRequest(op, input, output)
return
}
// GetServiceGraph API operation for AWS X-Ray.
//
// Retrieves a document that describes services that process incoming requests,
// and downstream services that they call as a result. Root services process
// incoming requests and make calls to downstream services. Root services are
// applications that use the AWS X-Ray SDK. Downstream services can be other
// applications, AWS resources, HTTP web APIs, or SQL databases.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetServiceGraph for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetServiceGraph
func (c *XRay) GetServiceGraph(input *GetServiceGraphInput) (*GetServiceGraphOutput, error) {
req, out := c.GetServiceGraphRequest(input)
return out, req.Send()
}
// GetServiceGraphWithContext is the same as GetServiceGraph with the addition of
// the ability to pass a context and additional request options.
//
// See GetServiceGraph for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetServiceGraphWithContext(ctx aws.Context, input *GetServiceGraphInput, opts ...request.Option) (*GetServiceGraphOutput, error) {
req, out := c.GetServiceGraphRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetServiceGraphPages iterates over the pages of a GetServiceGraph operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetServiceGraph method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetServiceGraph operation.
// pageNum := 0
// err := client.GetServiceGraphPages(params,
// func(page *xray.GetServiceGraphOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetServiceGraphPages(input *GetServiceGraphInput, fn func(*GetServiceGraphOutput, bool) bool) error {
return c.GetServiceGraphPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetServiceGraphPagesWithContext same as GetServiceGraphPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetServiceGraphPagesWithContext(ctx aws.Context, input *GetServiceGraphInput, fn func(*GetServiceGraphOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetServiceGraphInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetServiceGraphRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetServiceGraphOutput), !p.HasNextPage())
}
return p.Err()
}
const opGetTimeSeriesServiceStatistics = "GetTimeSeriesServiceStatistics"
// GetTimeSeriesServiceStatisticsRequest generates a "aws/request.Request" representing the
// client's request for the GetTimeSeriesServiceStatistics operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetTimeSeriesServiceStatistics for more information on using the GetTimeSeriesServiceStatistics
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetTimeSeriesServiceStatisticsRequest method.
// req, resp := client.GetTimeSeriesServiceStatisticsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTimeSeriesServiceStatistics
func (c *XRay) GetTimeSeriesServiceStatisticsRequest(input *GetTimeSeriesServiceStatisticsInput) (req *request.Request, output *GetTimeSeriesServiceStatisticsOutput) {
op := &request.Operation{
Name: opGetTimeSeriesServiceStatistics,
HTTPMethod: "POST",
HTTPPath: "/TimeSeriesServiceStatistics",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetTimeSeriesServiceStatisticsInput{}
}
output = &GetTimeSeriesServiceStatisticsOutput{}
req = c.newRequest(op, input, output)
return
}
// GetTimeSeriesServiceStatistics API operation for AWS X-Ray.
//
// Get an aggregation of service statistics defined by a specific time range.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetTimeSeriesServiceStatistics for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTimeSeriesServiceStatistics
func (c *XRay) GetTimeSeriesServiceStatistics(input *GetTimeSeriesServiceStatisticsInput) (*GetTimeSeriesServiceStatisticsOutput, error) {
req, out := c.GetTimeSeriesServiceStatisticsRequest(input)
return out, req.Send()
}
// GetTimeSeriesServiceStatisticsWithContext is the same as GetTimeSeriesServiceStatistics with the addition of
// the ability to pass a context and additional request options.
//
// See GetTimeSeriesServiceStatistics for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetTimeSeriesServiceStatisticsWithContext(ctx aws.Context, input *GetTimeSeriesServiceStatisticsInput, opts ...request.Option) (*GetTimeSeriesServiceStatisticsOutput, error) {
req, out := c.GetTimeSeriesServiceStatisticsRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetTimeSeriesServiceStatisticsPages iterates over the pages of a GetTimeSeriesServiceStatistics operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetTimeSeriesServiceStatistics method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetTimeSeriesServiceStatistics operation.
// pageNum := 0
// err := client.GetTimeSeriesServiceStatisticsPages(params,
// func(page *xray.GetTimeSeriesServiceStatisticsOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetTimeSeriesServiceStatisticsPages(input *GetTimeSeriesServiceStatisticsInput, fn func(*GetTimeSeriesServiceStatisticsOutput, bool) bool) error {
return c.GetTimeSeriesServiceStatisticsPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetTimeSeriesServiceStatisticsPagesWithContext same as GetTimeSeriesServiceStatisticsPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetTimeSeriesServiceStatisticsPagesWithContext(ctx aws.Context, input *GetTimeSeriesServiceStatisticsInput, fn func(*GetTimeSeriesServiceStatisticsOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetTimeSeriesServiceStatisticsInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetTimeSeriesServiceStatisticsRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetTimeSeriesServiceStatisticsOutput), !p.HasNextPage())
}
return p.Err()
}
const opGetTraceGraph = "GetTraceGraph"
// GetTraceGraphRequest generates a "aws/request.Request" representing the
// client's request for the GetTraceGraph operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetTraceGraph for more information on using the GetTraceGraph
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetTraceGraphRequest method.
// req, resp := client.GetTraceGraphRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceGraph
func (c *XRay) GetTraceGraphRequest(input *GetTraceGraphInput) (req *request.Request, output *GetTraceGraphOutput) {
op := &request.Operation{
Name: opGetTraceGraph,
HTTPMethod: "POST",
HTTPPath: "/TraceGraph",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetTraceGraphInput{}
}
output = &GetTraceGraphOutput{}
req = c.newRequest(op, input, output)
return
}
// GetTraceGraph API operation for AWS X-Ray.
//
// Retrieves a service graph for one or more specific trace IDs.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetTraceGraph for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceGraph
func (c *XRay) GetTraceGraph(input *GetTraceGraphInput) (*GetTraceGraphOutput, error) {
req, out := c.GetTraceGraphRequest(input)
return out, req.Send()
}
// GetTraceGraphWithContext is the same as GetTraceGraph with the addition of
// the ability to pass a context and additional request options.
//
// See GetTraceGraph for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetTraceGraphWithContext(ctx aws.Context, input *GetTraceGraphInput, opts ...request.Option) (*GetTraceGraphOutput, error) {
req, out := c.GetTraceGraphRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetTraceGraphPages iterates over the pages of a GetTraceGraph operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetTraceGraph method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetTraceGraph operation.
// pageNum := 0
// err := client.GetTraceGraphPages(params,
// func(page *xray.GetTraceGraphOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetTraceGraphPages(input *GetTraceGraphInput, fn func(*GetTraceGraphOutput, bool) bool) error {
return c.GetTraceGraphPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetTraceGraphPagesWithContext same as GetTraceGraphPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetTraceGraphPagesWithContext(ctx aws.Context, input *GetTraceGraphInput, fn func(*GetTraceGraphOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetTraceGraphInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetTraceGraphRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetTraceGraphOutput), !p.HasNextPage())
}
return p.Err()
}
const opGetTraceSummaries = "GetTraceSummaries"
// GetTraceSummariesRequest generates a "aws/request.Request" representing the
// client's request for the GetTraceSummaries operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See GetTraceSummaries for more information on using the GetTraceSummaries
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the GetTraceSummariesRequest method.
// req, resp := client.GetTraceSummariesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSummaries
func (c *XRay) GetTraceSummariesRequest(input *GetTraceSummariesInput) (req *request.Request, output *GetTraceSummariesOutput) {
op := &request.Operation{
Name: opGetTraceSummaries,
HTTPMethod: "POST",
HTTPPath: "/TraceSummaries",
Paginator: &request.Paginator{
InputTokens: []string{"NextToken"},
OutputTokens: []string{"NextToken"},
LimitToken: "",
TruncationToken: "",
},
}
if input == nil {
input = &GetTraceSummariesInput{}
}
output = &GetTraceSummariesOutput{}
req = c.newRequest(op, input, output)
return
}
// GetTraceSummaries API operation for AWS X-Ray.
//
// Retrieves IDs and metadata for traces available for a specified time frame
// using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.
//
// A filter expression can target traced requests that hit specific service
// nodes or edges, have errors, or come from a known user. For example, the
// following filter expression targets traces that pass through api.example.com:
//
// service("api.example.com")
//
// This filter expression finds traces that have an annotation named account
// with the value 12345:
//
// annotation.account = "12345"
//
// For a full list of indexed fields and keywords that you can use in filter
// expressions, see Using Filter Expressions (https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html)
// in the AWS X-Ray Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation GetTraceSummaries for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSummaries
func (c *XRay) GetTraceSummaries(input *GetTraceSummariesInput) (*GetTraceSummariesOutput, error) {
req, out := c.GetTraceSummariesRequest(input)
return out, req.Send()
}
// GetTraceSummariesWithContext is the same as GetTraceSummaries with the addition of
// the ability to pass a context and additional request options.
//
// See GetTraceSummaries for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetTraceSummariesWithContext(ctx aws.Context, input *GetTraceSummariesInput, opts ...request.Option) (*GetTraceSummariesOutput, error) {
req, out := c.GetTraceSummariesRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// GetTraceSummariesPages iterates over the pages of a GetTraceSummaries operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See GetTraceSummaries method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a GetTraceSummaries operation.
// pageNum := 0
// err := client.GetTraceSummariesPages(params,
// func(page *xray.GetTraceSummariesOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
func (c *XRay) GetTraceSummariesPages(input *GetTraceSummariesInput, fn func(*GetTraceSummariesOutput, bool) bool) error {
return c.GetTraceSummariesPagesWithContext(aws.BackgroundContext(), input, fn)
}
// GetTraceSummariesPagesWithContext same as GetTraceSummariesPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) GetTraceSummariesPagesWithContext(ctx aws.Context, input *GetTraceSummariesInput, fn func(*GetTraceSummariesOutput, bool) bool, opts ...request.Option) error {
p := request.Pagination{
NewRequest: func() (*request.Request, error) {
var inCpy *GetTraceSummariesInput
if input != nil {
tmp := *input
inCpy = &tmp
}
req, _ := c.GetTraceSummariesRequest(inCpy)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return req, nil
},
}
cont := true
for p.Next() && cont {
cont = fn(p.Page().(*GetTraceSummariesOutput), !p.HasNextPage())
}
return p.Err()
}
const opPutEncryptionConfig = "PutEncryptionConfig"
// PutEncryptionConfigRequest generates a "aws/request.Request" representing the
// client's request for the PutEncryptionConfig operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See PutEncryptionConfig for more information on using the PutEncryptionConfig
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the PutEncryptionConfigRequest method.
// req, resp := client.PutEncryptionConfigRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutEncryptionConfig
func (c *XRay) PutEncryptionConfigRequest(input *PutEncryptionConfigInput) (req *request.Request, output *PutEncryptionConfigOutput) {
op := &request.Operation{
Name: opPutEncryptionConfig,
HTTPMethod: "POST",
HTTPPath: "/PutEncryptionConfig",
}
if input == nil {
input = &PutEncryptionConfigInput{}
}
output = &PutEncryptionConfigOutput{}
req = c.newRequest(op, input, output)
return
}
// PutEncryptionConfig API operation for AWS X-Ray.
//
// Updates the encryption configuration for X-Ray data.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation PutEncryptionConfig for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutEncryptionConfig
func (c *XRay) PutEncryptionConfig(input *PutEncryptionConfigInput) (*PutEncryptionConfigOutput, error) {
req, out := c.PutEncryptionConfigRequest(input)
return out, req.Send()
}
// PutEncryptionConfigWithContext is the same as PutEncryptionConfig with the addition of
// the ability to pass a context and additional request options.
//
// See PutEncryptionConfig for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) PutEncryptionConfigWithContext(ctx aws.Context, input *PutEncryptionConfigInput, opts ...request.Option) (*PutEncryptionConfigOutput, error) {
req, out := c.PutEncryptionConfigRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opPutTelemetryRecords = "PutTelemetryRecords"
// PutTelemetryRecordsRequest generates a "aws/request.Request" representing the
// client's request for the PutTelemetryRecords operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See PutTelemetryRecords for more information on using the PutTelemetryRecords
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the PutTelemetryRecordsRequest method.
// req, resp := client.PutTelemetryRecordsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTelemetryRecords
func (c *XRay) PutTelemetryRecordsRequest(input *PutTelemetryRecordsInput) (req *request.Request, output *PutTelemetryRecordsOutput) {
op := &request.Operation{
Name: opPutTelemetryRecords,
HTTPMethod: "POST",
HTTPPath: "/TelemetryRecords",
}
if input == nil {
input = &PutTelemetryRecordsInput{}
}
output = &PutTelemetryRecordsOutput{}
req = c.newRequest(op, input, output)
req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
return
}
// PutTelemetryRecords API operation for AWS X-Ray.
//
// Used by the AWS X-Ray daemon to upload telemetry.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation PutTelemetryRecords for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTelemetryRecords
func (c *XRay) PutTelemetryRecords(input *PutTelemetryRecordsInput) (*PutTelemetryRecordsOutput, error) {
req, out := c.PutTelemetryRecordsRequest(input)
return out, req.Send()
}
// PutTelemetryRecordsWithContext is the same as PutTelemetryRecords with the addition of
// the ability to pass a context and additional request options.
//
// See PutTelemetryRecords for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) PutTelemetryRecordsWithContext(ctx aws.Context, input *PutTelemetryRecordsInput, opts ...request.Option) (*PutTelemetryRecordsOutput, error) {
req, out := c.PutTelemetryRecordsRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opPutTraceSegments = "PutTraceSegments"
// PutTraceSegmentsRequest generates a "aws/request.Request" representing the
// client's request for the PutTraceSegments operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See PutTraceSegments for more information on using the PutTraceSegments
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the PutTraceSegmentsRequest method.
// req, resp := client.PutTraceSegmentsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTraceSegments
func (c *XRay) PutTraceSegmentsRequest(input *PutTraceSegmentsInput) (req *request.Request, output *PutTraceSegmentsOutput) {
op := &request.Operation{
Name: opPutTraceSegments,
HTTPMethod: "POST",
HTTPPath: "/TraceSegments",
}
if input == nil {
input = &PutTraceSegmentsInput{}
}
output = &PutTraceSegmentsOutput{}
req = c.newRequest(op, input, output)
return
}
// PutTraceSegments API operation for AWS X-Ray.
//
// Uploads segment documents to AWS X-Ray. The X-Ray SDK generates segment documents
// and sends them to the X-Ray daemon, which uploads them in batches. A segment
// document can be a completed segment, an in-progress segment, or an array
// of subsegments.
//
// Segments must include the following fields. For the full segment document
// schema, see AWS X-Ray Segment Documents (https://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html)
// in the AWS X-Ray Developer Guide.
//
// Required Segment Document Fields
//
// * name - The name of the service that handled the request.
//
// * id - A 64-bit identifier for the segment, unique among segments in the
// same trace, in 16 hexadecimal digits.
//
// * trace_id - A unique identifier that connects all segments and subsegments
// originating from a single client request.
//
// * start_time - Time the segment or subsegment was created, in floating
// point seconds in epoch time, accurate to milliseconds. For example, 1480615200.010
// or 1.480615200010E9.
//
// * end_time - Time the segment or subsegment was closed. For example, 1480615200.090
// or 1.480615200090E9. Specify either an end_time or in_progress.
//
// * in_progress - Set to true instead of specifying an end_time to record
// that a segment has been started, but is not complete. Send an in progress
// segment when your application receives a request that will take a long
// time to serve, to trace the fact that the request was received. When the
// response is sent, send the complete segment to overwrite the in-progress
// segment.
//
// A trace_id consists of three numbers separated by hyphens. For example, 1-58406520-a006649127e371903a2de979.
// This includes:
//
// Trace ID Format
//
// * The version number, i.e. 1.
//
// * The time of the original request, in Unix epoch time, in 8 hexadecimal
// digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200
// seconds, or 58406520 in hexadecimal.
//
// * A 96-bit identifier for the trace, globally unique, in 24 hexadecimal
// digits.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation PutTraceSegments for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTraceSegments
func (c *XRay) PutTraceSegments(input *PutTraceSegmentsInput) (*PutTraceSegmentsOutput, error) {
req, out := c.PutTraceSegmentsRequest(input)
return out, req.Send()
}
// PutTraceSegmentsWithContext is the same as PutTraceSegments with the addition of
// the ability to pass a context and additional request options.
//
// See PutTraceSegments for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) PutTraceSegmentsWithContext(ctx aws.Context, input *PutTraceSegmentsInput, opts ...request.Option) (*PutTraceSegmentsOutput, error) {
req, out := c.PutTraceSegmentsRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opUpdateGroup = "UpdateGroup"
// UpdateGroupRequest generates a "aws/request.Request" representing the
// client's request for the UpdateGroup operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See UpdateGroup for more information on using the UpdateGroup
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the UpdateGroupRequest method.
// req, resp := client.UpdateGroupRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateGroup
func (c *XRay) UpdateGroupRequest(input *UpdateGroupInput) (req *request.Request, output *UpdateGroupOutput) {
op := &request.Operation{
Name: opUpdateGroup,
HTTPMethod: "POST",
HTTPPath: "/UpdateGroup",
}
if input == nil {
input = &UpdateGroupInput{}
}
output = &UpdateGroupOutput{}
req = c.newRequest(op, input, output)
return
}
// UpdateGroup API operation for AWS X-Ray.
//
// Updates a group resource.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation UpdateGroup for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateGroup
func (c *XRay) UpdateGroup(input *UpdateGroupInput) (*UpdateGroupOutput, error) {
req, out := c.UpdateGroupRequest(input)
return out, req.Send()
}
// UpdateGroupWithContext is the same as UpdateGroup with the addition of
// the ability to pass a context and additional request options.
//
// See UpdateGroup for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) UpdateGroupWithContext(ctx aws.Context, input *UpdateGroupInput, opts ...request.Option) (*UpdateGroupOutput, error) {
req, out := c.UpdateGroupRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opUpdateSamplingRule = "UpdateSamplingRule"
// UpdateSamplingRuleRequest generates a "aws/request.Request" representing the
// client's request for the UpdateSamplingRule operation. The "output" return
// value will be populated with the request's response once the request completes
// successfully.
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See UpdateSamplingRule for more information on using the UpdateSamplingRule
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the UpdateSamplingRuleRequest method.
// req, resp := client.UpdateSamplingRuleRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateSamplingRule
func (c *XRay) UpdateSamplingRuleRequest(input *UpdateSamplingRuleInput) (req *request.Request, output *UpdateSamplingRuleOutput) {
op := &request.Operation{
Name: opUpdateSamplingRule,
HTTPMethod: "POST",
HTTPPath: "/UpdateSamplingRule",
}
if input == nil {
input = &UpdateSamplingRuleInput{}
}
output = &UpdateSamplingRuleOutput{}
req = c.newRequest(op, input, output)
return
}
// UpdateSamplingRule API operation for AWS X-Ray.
//
// Modifies a sampling rule's configuration.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for AWS X-Ray's
// API operation UpdateSamplingRule for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInvalidRequestException "InvalidRequestException"
// The request is missing required parameters or has invalid parameters.
//
// * ErrCodeThrottledException "ThrottledException"
// The request exceeds the maximum number of requests per second.
//
// See also, https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateSamplingRule
func (c *XRay) UpdateSamplingRule(input *UpdateSamplingRuleInput) (*UpdateSamplingRuleOutput, error) {
req, out := c.UpdateSamplingRuleRequest(input)
return out, req.Send()
}
// UpdateSamplingRuleWithContext is the same as UpdateSamplingRule with the addition of
// the ability to pass a context and additional request options.
//
// See UpdateSamplingRule for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *XRay) UpdateSamplingRuleWithContext(ctx aws.Context, input *UpdateSamplingRuleInput, opts ...request.Option) (*UpdateSamplingRuleOutput, error) {
req, out := c.UpdateSamplingRuleRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
// An alias for an edge.
type Alias struct {
_ struct{} `type:"structure"`
// The canonical name of the alias.
Name *string `type:"string"`
// A list of names for the alias, including the canonical name.
Names []*string `type:"list"`
// The type of the alias.
Type *string `type:"string"`
}
// String returns the string representation
func (s Alias) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s Alias) GoString() string {
return s.String()
}
// SetName sets the Name field's value.
func (s *Alias) SetName(v string) *Alias {
s.Name = &v
return s
}
// SetNames sets the Names field's value.
func (s *Alias) SetNames(v []*string) *Alias {
s.Names = v
return s
}
// SetType sets the Type field's value.
func (s *Alias) SetType(v string) *Alias {
s.Type = &v
return s
}
// Value of a segment annotation. Has one of three value types: Number, Boolean
// or String.
type AnnotationValue struct {
_ struct{} `type:"structure"`
// Value for a Boolean annotation.
BooleanValue *bool `type:"boolean"`
// Value for a Number annotation.
NumberValue *float64 `type:"double"`
// Value for a String annotation.
StringValue *string `type:"string"`
}
// String returns the string representation
func (s AnnotationValue) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s AnnotationValue) GoString() string {
return s.String()
}
// SetBooleanValue sets the BooleanValue field's value.
func (s *AnnotationValue) SetBooleanValue(v bool) *AnnotationValue {
s.BooleanValue = &v
return s
}
// SetNumberValue sets the NumberValue field's value.
func (s *AnnotationValue) SetNumberValue(v float64) *AnnotationValue {
s.NumberValue = &v
return s
}
// SetStringValue sets the StringValue field's value.
func (s *AnnotationValue) SetStringValue(v string) *AnnotationValue {
s.StringValue = &v
return s
}
// A list of availability zones corresponding to the segments in a trace.
type AvailabilityZoneDetail struct {
_ struct{} `type:"structure"`
// The name of a corresponding availability zone.
Name *string `type:"string"`
}
// String returns the string representation
func (s AvailabilityZoneDetail) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s AvailabilityZoneDetail) GoString() string {
return s.String()
}
// SetName sets the Name field's value.
func (s *AvailabilityZoneDetail) SetName(v string) *AvailabilityZoneDetail {
s.Name = &v
return s
}
type BackendConnectionErrors struct {
_ struct{} `type:"structure"`
ConnectionRefusedCount *int64 `type:"integer"`
HTTPCode4XXCount *int64 `type:"integer"`
HTTPCode5XXCount *int64 `type:"integer"`
OtherCount *int64 `type:"integer"`
TimeoutCount *int64 `type:"integer"`
UnknownHostCount *int64 `type:"integer"`
}
// String returns the string representation
func (s BackendConnectionErrors) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s BackendConnectionErrors) GoString() string {
return s.String()
}
// SetConnectionRefusedCount sets the ConnectionRefusedCount field's value.
func (s *BackendConnectionErrors) SetConnectionRefusedCount(v int64) *BackendConnectionErrors {
s.ConnectionRefusedCount = &v
return s
}
// SetHTTPCode4XXCount sets the HTTPCode4XXCount field's value.
func (s *BackendConnectionErrors) SetHTTPCode4XXCount(v int64) *BackendConnectionErrors {
s.HTTPCode4XXCount = &v
return s
}
// SetHTTPCode5XXCount sets the HTTPCode5XXCount field's value.
func (s *BackendConnectionErrors) SetHTTPCode5XXCount(v int64) *BackendConnectionErrors {
s.HTTPCode5XXCount = &v
return s
}
// SetOtherCount sets the OtherCount field's value.
func (s *BackendConnectionErrors) SetOtherCount(v int64) *BackendConnectionErrors {
s.OtherCount = &v
return s
}
// SetTimeoutCount sets the TimeoutCount field's value.
func (s *BackendConnectionErrors) SetTimeoutCount(v int64) *BackendConnectionErrors {
s.TimeoutCount = &v
return s
}
// SetUnknownHostCount sets the UnknownHostCount field's value.
func (s *BackendConnectionErrors) SetUnknownHostCount(v int64) *BackendConnectionErrors {
s.UnknownHostCount = &v
return s
}
type BatchGetTracesInput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `type:"string"`
// Specify the trace IDs of requests for which to retrieve segments.
//
// TraceIds is a required field
TraceIds []*string `type:"list" required:"true"`
}
// String returns the string representation
func (s BatchGetTracesInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s BatchGetTracesInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *BatchGetTracesInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "BatchGetTracesInput"}
if s.TraceIds == nil {
invalidParams.Add(request.NewErrParamRequired("TraceIds"))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetNextToken sets the NextToken field's value.
func (s *BatchGetTracesInput) SetNextToken(v string) *BatchGetTracesInput {
s.NextToken = &v
return s
}
// SetTraceIds sets the TraceIds field's value.
func (s *BatchGetTracesInput) SetTraceIds(v []*string) *BatchGetTracesInput {
s.TraceIds = v
return s
}
type BatchGetTracesOutput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `type:"string"`
// Full traces for the specified requests.
Traces []*Trace `type:"list"`
// Trace IDs of requests that haven't been processed.
UnprocessedTraceIds []*string `type:"list"`
}
// String returns the string representation
func (s BatchGetTracesOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s BatchGetTracesOutput) GoString() string {
return s.String()
}
// SetNextToken sets the NextToken field's value.
func (s *BatchGetTracesOutput) SetNextToken(v string) *BatchGetTracesOutput {
s.NextToken = &v
return s
}
// SetTraces sets the Traces field's value.
func (s *BatchGetTracesOutput) SetTraces(v []*Trace) *BatchGetTracesOutput {
s.Traces = v
return s
}
// SetUnprocessedTraceIds sets the UnprocessedTraceIds field's value.
func (s *BatchGetTracesOutput) SetUnprocessedTraceIds(v []*string) *BatchGetTracesOutput {
s.UnprocessedTraceIds = v
return s
}
type CreateGroupInput struct {
_ struct{} `type:"structure"`
// The filter expression defining criteria by which to group traces.
FilterExpression *string `type:"string"`
// The case-sensitive name of the new group. Default is a reserved name and
// names must be unique.
//
// GroupName is a required field
GroupName *string `min:"1" type:"string" required:"true"`
}
// String returns the string representation
func (s CreateGroupInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s CreateGroupInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *CreateGroupInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "CreateGroupInput"}
if s.GroupName == nil {
invalidParams.Add(request.NewErrParamRequired("GroupName"))
}
if s.GroupName != nil && len(*s.GroupName) < 1 {
invalidParams.Add(request.NewErrParamMinLen("GroupName", 1))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetFilterExpression sets the FilterExpression field's value.
func (s *CreateGroupInput) SetFilterExpression(v string) *CreateGroupInput {
s.FilterExpression = &v
return s
}
// SetGroupName sets the GroupName field's value.
func (s *CreateGroupInput) SetGroupName(v string) *CreateGroupInput {
s.GroupName = &v
return s
}
type CreateGroupOutput struct {
_ struct{} `type:"structure"`
// The group that was created. Contains the name of the group that was created,
// the ARN of the group that was generated based on the group name, and the
// filter expression that was assigned to the group.
Group *Group `type:"structure"`
}
// String returns the string representation
func (s CreateGroupOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s CreateGroupOutput) GoString() string {
return s.String()
}
// SetGroup sets the Group field's value.
func (s *CreateGroupOutput) SetGroup(v *Group) *CreateGroupOutput {
s.Group = v
return s
}
type CreateSamplingRuleInput struct {
_ struct{} `type:"structure"`
// The rule definition.
//
// SamplingRule is a required field
SamplingRule *SamplingRule `type:"structure" required:"true"`
}
// String returns the string representation
func (s CreateSamplingRuleInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s CreateSamplingRuleInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *CreateSamplingRuleInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "CreateSamplingRuleInput"}
if s.SamplingRule == nil {
invalidParams.Add(request.NewErrParamRequired("SamplingRule"))
}
if s.SamplingRule != nil {
if err := s.SamplingRule.Validate(); err != nil {
invalidParams.AddNested("SamplingRule", err.(request.ErrInvalidParams))
}
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetSamplingRule sets the SamplingRule field's value.
func (s *CreateSamplingRuleInput) SetSamplingRule(v *SamplingRule) *CreateSamplingRuleInput {
s.SamplingRule = v
return s
}
type CreateSamplingRuleOutput struct {
_ struct{} `type:"structure"`
// The saved rule definition and metadata.
SamplingRuleRecord *SamplingRuleRecord `type:"structure"`
}
// String returns the string representation
func (s CreateSamplingRuleOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s CreateSamplingRuleOutput) GoString() string {
return s.String()
}
// SetSamplingRuleRecord sets the SamplingRuleRecord field's value.
func (s *CreateSamplingRuleOutput) SetSamplingRuleRecord(v *SamplingRuleRecord) *CreateSamplingRuleOutput {
s.SamplingRuleRecord = v
return s
}
type DeleteGroupInput struct {
_ struct{} `type:"structure"`
// The ARN of the group that was generated on creation.
GroupARN *string `min:"1" type:"string"`
// The case-sensitive name of the group.
GroupName *string `min:"1" type:"string"`
}
// String returns the string representation
func (s DeleteGroupInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s DeleteGroupInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *DeleteGroupInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "DeleteGroupInput"}
if s.GroupARN != nil && len(*s.GroupARN) < 1 {
invalidParams.Add(request.NewErrParamMinLen("GroupARN", 1))
}
if s.GroupName != nil && len(*s.GroupName) < 1 {
invalidParams.Add(request.NewErrParamMinLen("GroupName", 1))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetGroupARN sets the GroupARN field's value.
func (s *DeleteGroupInput) SetGroupARN(v string) *DeleteGroupInput {
s.GroupARN = &v
return s
}
// SetGroupName sets the GroupName field's value.
func (s *DeleteGroupInput) SetGroupName(v string) *DeleteGroupInput {
s.GroupName = &v
return s
}
type DeleteGroupOutput struct {
_ struct{} `type:"structure"`
}
// String returns the string representation
func (s DeleteGroupOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s DeleteGroupOutput) GoString() string {
return s.String()
}
type DeleteSamplingRuleInput struct {
_ struct{} `type:"structure"`
// The ARN of the sampling rule. Specify a rule by either name or ARN, but not
// both.
RuleARN *string `type:"string"`
// The name of the sampling rule. Specify a rule by either name or ARN, but
// not both.
RuleName *string `type:"string"`
}
// String returns the string representation
func (s DeleteSamplingRuleInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s DeleteSamplingRuleInput) GoString() string {
return s.String()
}
// SetRuleARN sets the RuleARN field's value.
func (s *DeleteSamplingRuleInput) SetRuleARN(v string) *DeleteSamplingRuleInput {
s.RuleARN = &v
return s
}
// SetRuleName sets the RuleName field's value.
func (s *DeleteSamplingRuleInput) SetRuleName(v string) *DeleteSamplingRuleInput {
s.RuleName = &v
return s
}
type DeleteSamplingRuleOutput struct {
_ struct{} `type:"structure"`
// The deleted rule definition and metadata.
SamplingRuleRecord *SamplingRuleRecord `type:"structure"`
}
// String returns the string representation
func (s DeleteSamplingRuleOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s DeleteSamplingRuleOutput) GoString() string {
return s.String()
}
// SetSamplingRuleRecord sets the SamplingRuleRecord field's value.
func (s *DeleteSamplingRuleOutput) SetSamplingRuleRecord(v *SamplingRuleRecord) *DeleteSamplingRuleOutput {
s.SamplingRuleRecord = v
return s
}
// Information about a connection between two services.
type Edge struct {
_ struct{} `type:"structure"`
// Aliases for the edge.
Aliases []*Alias `type:"list"`
// The end time of the last segment on the edge.
EndTime *time.Time `type:"timestamp"`
// Identifier of the edge. Unique within a service map.
ReferenceId *int64 `type:"integer"`
// A histogram that maps the spread of client response times on an edge.
ResponseTimeHistogram []*HistogramEntry `type:"list"`
// The start time of the first segment on the edge.
StartTime *time.Time `type:"timestamp"`
// Response statistics for segments on the edge.
SummaryStatistics *EdgeStatistics `type:"structure"`
}
// String returns the string representation
func (s Edge) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s Edge) GoString() string {
return s.String()
}
// SetAliases sets the Aliases field's value.
func (s *Edge) SetAliases(v []*Alias) *Edge {
s.Aliases = v
return s
}
// SetEndTime sets the EndTime field's value.
func (s *Edge) SetEndTime(v time.Time) *Edge {
s.EndTime = &v
return s
}
// SetReferenceId sets the ReferenceId field's value.
func (s *Edge) SetReferenceId(v int64) *Edge {
s.ReferenceId = &v
return s
}
// SetResponseTimeHistogram sets the ResponseTimeHistogram field's value.
func (s *Edge) SetResponseTimeHistogram(v []*HistogramEntry) *Edge {
s.ResponseTimeHistogram = v
return s
}
// SetStartTime sets the StartTime field's value.
func (s *Edge) SetStartTime(v time.Time) *Edge {
s.StartTime = &v
return s
}
// SetSummaryStatistics sets the SummaryStatistics field's value.
func (s *Edge) SetSummaryStatistics(v *EdgeStatistics) *Edge {
s.SummaryStatistics = v
return s
}
// Response statistics for an edge.
type EdgeStatistics struct {
_ struct{} `type:"structure"`
// Information about requests that failed with a 4xx Client Error status code.
ErrorStatistics *ErrorStatistics `type:"structure"`
// Information about requests that failed with a 5xx Server Error status code.
FaultStatistics *FaultStatistics `type:"structure"`
// The number of requests that completed with a 2xx Success status code.
OkCount *int64 `type:"long"`
// The total number of completed requests.
TotalCount *int64 `type:"long"`
// The aggregate response time of completed requests.
TotalResponseTime *float64 `type:"double"`
}
// String returns the string representation
func (s EdgeStatistics) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s EdgeStatistics) GoString() string {
return s.String()
}
// SetErrorStatistics sets the ErrorStatistics field's value.
func (s *EdgeStatistics) SetErrorStatistics(v *ErrorStatistics) *EdgeStatistics {
s.ErrorStatistics = v
return s
}
// SetFaultStatistics sets the FaultStatistics field's value.
func (s *EdgeStatistics) SetFaultStatistics(v *FaultStatistics) *EdgeStatistics {
s.FaultStatistics = v
return s
}
// SetOkCount sets the OkCount field's value.
func (s *EdgeStatistics) SetOkCount(v int64) *EdgeStatistics {
s.OkCount = &v
return s
}
// SetTotalCount sets the TotalCount field's value.
func (s *EdgeStatistics) SetTotalCount(v int64) *EdgeStatistics {
s.TotalCount = &v
return s
}
// SetTotalResponseTime sets the TotalResponseTime field's value.
func (s *EdgeStatistics) SetTotalResponseTime(v float64) *EdgeStatistics {
s.TotalResponseTime = &v
return s
}
// A configuration document that specifies encryption configuration settings.
type EncryptionConfig struct {
_ struct{} `type:"structure"`
// The ID of the customer master key (CMK) used for encryption, if applicable.
KeyId *string `type:"string"`
// The encryption status. While the status is UPDATING, X-Ray may encrypt data
// with a combination of the new and old settings.
Status *string `type:"string" enum:"EncryptionStatus"`
// The type of encryption. Set to KMS for encryption with CMKs. Set to NONE
// for default encryption.
Type *string `type:"string" enum:"EncryptionType"`
}
// String returns the string representation
func (s EncryptionConfig) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s EncryptionConfig) GoString() string {
return s.String()
}
// SetKeyId sets the KeyId field's value.
func (s *EncryptionConfig) SetKeyId(v string) *EncryptionConfig {
s.KeyId = &v
return s
}
// SetStatus sets the Status field's value.
func (s *EncryptionConfig) SetStatus(v string) *EncryptionConfig {
s.Status = &v
return s
}
// SetType sets the Type field's value.
func (s *EncryptionConfig) SetType(v string) *EncryptionConfig {
s.Type = &v
return s
}
// The root cause of a trace summary error.
type ErrorRootCause struct {
_ struct{} `type:"structure"`
// A list of services corresponding to an error. A service identifies a segment
// and it contains a name, account ID, type, and inferred flag.
Services []*ErrorRootCauseService `type:"list"`
}
// String returns the string representation
func (s ErrorRootCause) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s ErrorRootCause) GoString() string {
return s.String()
}
// SetServices sets the Services field's value.
func (s *ErrorRootCause) SetServices(v []*ErrorRootCauseService) *ErrorRootCause {
s.Services = v
return s
}
// A collection of segments and corresponding subsegments associated to a trace
// summary error.
type ErrorRootCauseEntity struct {
_ struct{} `type:"structure"`
// The types and messages of the exceptions.
Exceptions []*RootCauseException `type:"list"`
// The name of the entity.
Name *string `type:"string"`
// A flag that denotes a remote subsegment.
Remote *bool `type:"boolean"`
}
// String returns the string representation
func (s ErrorRootCauseEntity) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s ErrorRootCauseEntity) GoString() string {
return s.String()
}
// SetExceptions sets the Exceptions field's value.
func (s *ErrorRootCauseEntity) SetExceptions(v []*RootCauseException) *ErrorRootCauseEntity {
s.Exceptions = v
return s
}
// SetName sets the Name field's value.
func (s *ErrorRootCauseEntity) SetName(v string) *ErrorRootCauseEntity {
s.Name = &v
return s
}
// SetRemote sets the Remote field's value.
func (s *ErrorRootCauseEntity) SetRemote(v bool) *ErrorRootCauseEntity {
s.Remote = &v
return s
}
// A collection of fields identifying the services in a trace summary error.
type ErrorRootCauseService struct {
_ struct{} `type:"structure"`
// The account ID associated to the service.
AccountId *string `type:"string"`
// The path of root cause entities found on the service.
EntityPath []*ErrorRootCauseEntity `type:"list"`
// A Boolean value indicating if the service is inferred from the trace.
Inferred *bool `type:"boolean"`
// The service name.
Name *string `type:"string"`
// A collection of associated service names.
Names []*string `type:"list"`
// The type associated to the service.
Type *string `type:"string"`
}
// String returns the string representation
func (s ErrorRootCauseService) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s ErrorRootCauseService) GoString() string {
return s.String()
}
// SetAccountId sets the AccountId field's value.
func (s *ErrorRootCauseService) SetAccountId(v string) *ErrorRootCauseService {
s.AccountId = &v
return s
}
// SetEntityPath sets the EntityPath field's value.
func (s *ErrorRootCauseService) SetEntityPath(v []*ErrorRootCauseEntity) *ErrorRootCauseService {
s.EntityPath = v
return s
}
// SetInferred sets the Inferred field's value.
func (s *ErrorRootCauseService) SetInferred(v bool) *ErrorRootCauseService {
s.Inferred = &v
return s
}
// SetName sets the Name field's value.
func (s *ErrorRootCauseService) SetName(v string) *ErrorRootCauseService {
s.Name = &v
return s
}
// SetNames sets the Names field's value.
func (s *ErrorRootCauseService) SetNames(v []*string) *ErrorRootCauseService {
s.Names = v
return s
}
// SetType sets the Type field's value.
func (s *ErrorRootCauseService) SetType(v string) *ErrorRootCauseService {
s.Type = &v
return s
}
// Information about requests that failed with a 4xx Client Error status code.
type ErrorStatistics struct {
_ struct{} `type:"structure"`
// The number of requests that failed with untracked 4xx Client Error status
// codes.
OtherCount *int64 `type:"long"`
// The number of requests that failed with a 419 throttling status code.
ThrottleCount *int64 `type:"long"`
// The total number of requests that failed with a 4xx Client Error status code.
TotalCount *int64 `type:"long"`
}
// String returns the string representation
func (s ErrorStatistics) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s ErrorStatistics) GoString() string {
return s.String()
}
// SetOtherCount sets the OtherCount field's value.
func (s *ErrorStatistics) SetOtherCount(v int64) *ErrorStatistics {
s.OtherCount = &v
return s
}
// SetThrottleCount sets the ThrottleCount field's value.
func (s *ErrorStatistics) SetThrottleCount(v int64) *ErrorStatistics {
s.ThrottleCount = &v
return s
}
// SetTotalCount sets the TotalCount field's value.
func (s *ErrorStatistics) SetTotalCount(v int64) *ErrorStatistics {
s.TotalCount = &v
return s
}
// The root cause information for a trace summary fault.
type FaultRootCause struct {
_ struct{} `type:"structure"`
// A list of corresponding services. A service identifies a segment and it contains
// a name, account ID, type, and inferred flag.
Services []*FaultRootCauseService `type:"list"`
}
// String returns the string representation
func (s FaultRootCause) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s FaultRootCause) GoString() string {
return s.String()
}
// SetServices sets the Services field's value.
func (s *FaultRootCause) SetServices(v []*FaultRootCauseService) *FaultRootCause {
s.Services = v
return s
}
// A collection of segments and corresponding subsegments associated to a trace
// summary fault error.
type FaultRootCauseEntity struct {
_ struct{} `type:"structure"`
// The types and messages of the exceptions.
Exceptions []*RootCauseException `type:"list"`
// The name of the entity.
Name *string `type:"string"`
// A flag that denotes a remote subsegment.
Remote *bool `type:"boolean"`
}
// String returns the string representation
func (s FaultRootCauseEntity) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s FaultRootCauseEntity) GoString() string {
return s.String()
}
// SetExceptions sets the Exceptions field's value.
func (s *FaultRootCauseEntity) SetExceptions(v []*RootCauseException) *FaultRootCauseEntity {
s.Exceptions = v
return s
}
// SetName sets the Name field's value.
func (s *FaultRootCauseEntity) SetName(v string) *FaultRootCauseEntity {
s.Name = &v
return s
}
// SetRemote sets the Remote field's value.
func (s *FaultRootCauseEntity) SetRemote(v bool) *FaultRootCauseEntity {
s.Remote = &v
return s
}
// A collection of fields identifying the services in a trace summary fault.
type FaultRootCauseService struct {
_ struct{} `type:"structure"`
// The account ID associated to the service.
AccountId *string `type:"string"`
// The path of root cause entities found on the service.
EntityPath []*FaultRootCauseEntity `type:"list"`
// A Boolean value indicating if the service is inferred from the trace.
Inferred *bool `type:"boolean"`
// The service name.
Name *string `type:"string"`
// A collection of associated service names.
Names []*string `type:"list"`
// The type associated to the service.
Type *string `type:"string"`
}
// String returns the string representation
func (s FaultRootCauseService) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s FaultRootCauseService) GoString() string {
return s.String()
}
// SetAccountId sets the AccountId field's value.
func (s *FaultRootCauseService) SetAccountId(v string) *FaultRootCauseService {
s.AccountId = &v
return s
}
// SetEntityPath sets the EntityPath field's value.
func (s *FaultRootCauseService) SetEntityPath(v []*FaultRootCauseEntity) *FaultRootCauseService {
s.EntityPath = v
return s
}
// SetInferred sets the Inferred field's value.
func (s *FaultRootCauseService) SetInferred(v bool) *FaultRootCauseService {
s.Inferred = &v
return s
}
// SetName sets the Name field's value.
func (s *FaultRootCauseService) SetName(v string) *FaultRootCauseService {
s.Name = &v
return s
}
// SetNames sets the Names field's value.
func (s *FaultRootCauseService) SetNames(v []*string) *FaultRootCauseService {
s.Names = v
return s
}
// SetType sets the Type field's value.
func (s *FaultRootCauseService) SetType(v string) *FaultRootCauseService {
s.Type = &v
return s
}
// Information about requests that failed with a 5xx Server Error status code.
type FaultStatistics struct {
_ struct{} `type:"structure"`
// The number of requests that failed with untracked 5xx Server Error status
// codes.
OtherCount *int64 `type:"long"`
// The total number of requests that failed with a 5xx Server Error status code.
TotalCount *int64 `type:"long"`
}
// String returns the string representation
func (s FaultStatistics) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s FaultStatistics) GoString() string {
return s.String()
}
// SetOtherCount sets the OtherCount field's value.
func (s *FaultStatistics) SetOtherCount(v int64) *FaultStatistics {
s.OtherCount = &v
return s
}
// SetTotalCount sets the TotalCount field's value.
func (s *FaultStatistics) SetTotalCount(v int64) *FaultStatistics {
s.TotalCount = &v
return s
}
type GetEncryptionConfigInput struct {
_ struct{} `type:"structure"`
}
// String returns the string representation
func (s GetEncryptionConfigInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetEncryptionConfigInput) GoString() string {
return s.String()
}
type GetEncryptionConfigOutput struct {
_ struct{} `type:"structure"`
// The encryption configuration document.
EncryptionConfig *EncryptionConfig `type:"structure"`
}
// String returns the string representation
func (s GetEncryptionConfigOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetEncryptionConfigOutput) GoString() string {
return s.String()
}
// SetEncryptionConfig sets the EncryptionConfig field's value.
func (s *GetEncryptionConfigOutput) SetEncryptionConfig(v *EncryptionConfig) *GetEncryptionConfigOutput {
s.EncryptionConfig = v
return s
}
type GetGroupInput struct {
_ struct{} `type:"structure"`
// The ARN of the group that was generated on creation.
GroupARN *string `min:"1" type:"string"`
// The case-sensitive name of the group.
GroupName *string `min:"1" type:"string"`
}
// String returns the string representation
func (s GetGroupInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetGroupInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *GetGroupInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "GetGroupInput"}
if s.GroupARN != nil && len(*s.GroupARN) < 1 {
invalidParams.Add(request.NewErrParamMinLen("GroupARN", 1))
}
if s.GroupName != nil && len(*s.GroupName) < 1 {
invalidParams.Add(request.NewErrParamMinLen("GroupName", 1))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetGroupARN sets the GroupARN field's value.
func (s *GetGroupInput) SetGroupARN(v string) *GetGroupInput {
s.GroupARN = &v
return s
}
// SetGroupName sets the GroupName field's value.
func (s *GetGroupInput) SetGroupName(v string) *GetGroupInput {
s.GroupName = &v
return s
}
type GetGroupOutput struct {
_ struct{} `type:"structure"`
// The group that was requested. Contains the name of the group, the ARN of
// the group, and the filter expression that assigned to the group.
Group *Group `type:"structure"`
}
// String returns the string representation
func (s GetGroupOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetGroupOutput) GoString() string {
return s.String()
}
// SetGroup sets the Group field's value.
func (s *GetGroupOutput) SetGroup(v *Group) *GetGroupOutput {
s.Group = v
return s
}
type GetGroupsInput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `min:"1" type:"string"`
}
// String returns the string representation
func (s GetGroupsInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetGroupsInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *GetGroupsInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "GetGroupsInput"}
if s.NextToken != nil && len(*s.NextToken) < 1 {
invalidParams.Add(request.NewErrParamMinLen("NextToken", 1))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetNextToken sets the NextToken field's value.
func (s *GetGroupsInput) SetNextToken(v string) *GetGroupsInput {
s.NextToken = &v
return s
}
type GetGroupsOutput struct {
_ struct{} `type:"structure"`
// The collection of all active groups.
Groups []*GroupSummary `type:"list"`
// Pagination token. Not used.
NextToken *string `type:"string"`
}
// String returns the string representation
func (s GetGroupsOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetGroupsOutput) GoString() string {
return s.String()
}
// SetGroups sets the Groups field's value.
func (s *GetGroupsOutput) SetGroups(v []*GroupSummary) *GetGroupsOutput {
s.Groups = v
return s
}
// SetNextToken sets the NextToken field's value.
func (s *GetGroupsOutput) SetNextToken(v string) *GetGroupsOutput {
s.NextToken = &v
return s
}
type GetSamplingRulesInput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `type:"string"`
}
// String returns the string representation
func (s GetSamplingRulesInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetSamplingRulesInput) GoString() string {
return s.String()
}
// SetNextToken sets the NextToken field's value.
func (s *GetSamplingRulesInput) SetNextToken(v string) *GetSamplingRulesInput {
s.NextToken = &v
return s
}
type GetSamplingRulesOutput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `type:"string"`
// Rule definitions and metadata.
SamplingRuleRecords []*SamplingRuleRecord `type:"list"`
}
// String returns the string representation
func (s GetSamplingRulesOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetSamplingRulesOutput) GoString() string {
return s.String()
}
// SetNextToken sets the NextToken field's value.
func (s *GetSamplingRulesOutput) SetNextToken(v string) *GetSamplingRulesOutput {
s.NextToken = &v
return s
}
// SetSamplingRuleRecords sets the SamplingRuleRecords field's value.
func (s *GetSamplingRulesOutput) SetSamplingRuleRecords(v []*SamplingRuleRecord) *GetSamplingRulesOutput {
s.SamplingRuleRecords = v
return s
}
type GetSamplingStatisticSummariesInput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `type:"string"`
}
// String returns the string representation
func (s GetSamplingStatisticSummariesInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetSamplingStatisticSummariesInput) GoString() string {
return s.String()
}
// SetNextToken sets the NextToken field's value.
func (s *GetSamplingStatisticSummariesInput) SetNextToken(v string) *GetSamplingStatisticSummariesInput {
s.NextToken = &v
return s
}
type GetSamplingStatisticSummariesOutput struct {
_ struct{} `type:"structure"`
// Pagination token. Not used.
NextToken *string `type:"string"`
// Information about the number of requests instrumented for each sampling rule.
SamplingStatisticSummaries []*SamplingStatisticSummary `type:"list"`
}
// String returns the string representation
func (s GetSamplingStatisticSummariesOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetSamplingStatisticSummariesOutput) GoString() string {
return s.String()
}
// SetNextToken sets the NextToken field's value.
func (s *GetSamplingStatisticSummariesOutput) SetNextToken(v string) *GetSamplingStatisticSummariesOutput {
s.NextToken = &v
return s
}
// SetSamplingStatisticSummaries sets the SamplingStatisticSummaries field's value.
func (s *GetSamplingStatisticSummariesOutput) SetSamplingStatisticSummaries(v []*SamplingStatisticSummary) *GetSamplingStatisticSummariesOutput {
s.SamplingStatisticSummaries = v
return s
}
type GetSamplingTargetsInput struct {
_ struct{} `type:"structure"`
// Information about rules that the service is using to sample requests.
//
// SamplingStatisticsDocuments is a required field
SamplingStatisticsDocuments []*SamplingStatisticsDocument `type:"list" required:"true"`
}
// String returns the string representation
func (s GetSamplingTargetsInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetSamplingTargetsInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *GetSamplingTargetsInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "GetSamplingTargetsInput"}
if s.SamplingStatisticsDocuments == nil {
invalidParams.Add(request.NewErrParamRequired("SamplingStatisticsDocuments"))
}
if s.SamplingStatisticsDocuments != nil {
for i, v := range s.SamplingStatisticsDocuments {
if v == nil {
continue
}
if err := v.Validate(); err != nil {
invalidParams.AddNested(fmt.Sprintf("%s[%v]", "SamplingStatisticsDocuments", i), err.(request.ErrInvalidParams))
}
}
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetSamplingStatisticsDocuments sets the SamplingStatisticsDocuments field's value.
func (s *GetSamplingTargetsInput) SetSamplingStatisticsDocuments(v []*SamplingStatisticsDocument) *GetSamplingTargetsInput {
s.SamplingStatisticsDocuments = v
return s
}
type GetSamplingTargetsOutput struct {
_ struct{} `type:"structure"`
// The last time a user changed the sampling rule configuration. If the sampling
// rule configuration changed since the service last retrieved it, the service
// should call GetSamplingRules to get the latest version.
LastRuleModification *time.Time `type:"timestamp"`
// Updated rules that the service should use to sample requests.
SamplingTargetDocuments []*SamplingTargetDocument `type:"list"`
// Information about SamplingStatisticsDocument that X-Ray could not process.
UnprocessedStatistics []*UnprocessedStatistics `type:"list"`
}
// String returns the string representation
func (s GetSamplingTargetsOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetSamplingTargetsOutput) GoString() string {
return s.String()
}
// SetLastRuleModification sets the LastRuleModification field's value.
func (s *GetSamplingTargetsOutput) SetLastRuleModification(v time.Time) *GetSamplingTargetsOutput {
s.LastRuleModification = &v
return s
}
// SetSamplingTargetDocuments sets the SamplingTargetDocuments field's value.
func (s *GetSamplingTargetsOutput) SetSamplingTargetDocuments(v []*SamplingTargetDocument) *GetSamplingTargetsOutput {
s.SamplingTargetDocuments = v
return s
}
// SetUnprocessedStatistics sets the UnprocessedStatistics field's value.
func (s *GetSamplingTargetsOutput) SetUnprocessedStatistics(v []*UnprocessedStatistics) *GetSamplingTargetsOutput {
s.UnprocessedStatistics = v
return s
}
type GetServiceGraphInput struct {
_ struct{} `type:"structure"`
// The end of the timeframe for which to generate a graph.
//
// EndTime is a required field
EndTime *time.Time `type:"timestamp" required:"true"`
// The ARN of a group to generate a graph based on.
GroupARN *string `min:"1" type:"string"`
// The name of a group to generate a graph based on.
GroupName *string `min:"1" type:"string"`
// Pagination token. Not used.
NextToken *string `type:"string"`
// The start of the time frame for which to generate a graph.
//
// StartTime is a required field
StartTime *time.Time `type:"timestamp" required:"true"`
}
// String returns the string representation
func (s GetServiceGraphInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetServiceGraphInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *GetServiceGraphInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: