mirror of https://github.com/tidwall/tile38.git
2217 lines
67 KiB
Go
2217 lines
67 KiB
Go
|
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||
|
|
|
||
|
|
package xray
|
||
|
|
|
||
|
|
import (
|
||
|
|
"time"
|
||
|
|
|
||
|
|
"github.com/aws/aws-sdk-go/aws"
|
||
|
|
"github.com/aws/aws-sdk-go/aws/awsutil"
|
||
|
|
"github.com/aws/aws-sdk-go/aws/request"
|
||
|
|
)
|
||
|
|
|
||
|
|
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 complets
|
||
|
|
// successfuly.
|
||
|
|
//
|
||
|
|
// 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)
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// Please also see 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",
|
||
|
|
}
|
||
|
|
|
||
|
|
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.
|
||
|
|
//
|
||
|
|
// Please also see 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()
|
||
|
|
}
|
||
|
|
|
||
|
|
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 complets
|
||
|
|
// successfuly.
|
||
|
|
//
|
||
|
|
// 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)
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// Please also see 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",
|
||
|
|
}
|
||
|
|
|
||
|
|
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.
|
||
|
|
//
|
||
|
|
// Please also see 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()
|
||
|
|
}
|
||
|
|
|
||
|
|
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 complets
|
||
|
|
// successfuly.
|
||
|
|
//
|
||
|
|
// 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)
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// Please also see 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",
|
||
|
|
}
|
||
|
|
|
||
|
|
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.
|
||
|
|
//
|
||
|
|
// Please also see 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()
|
||
|
|
}
|
||
|
|
|
||
|
|
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 complets
|
||
|
|
// successfuly.
|
||
|
|
//
|
||
|
|
// 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)
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// Please also see 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",
|
||
|
|
}
|
||
|
|
|
||
|
|
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 (http://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.
|
||
|
|
//
|
||
|
|
// Please also see 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()
|
||
|
|
}
|
||
|
|
|
||
|
|
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 complets
|
||
|
|
// successfuly.
|
||
|
|
//
|
||
|
|
// 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)
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// Please also see 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)
|
||
|
|
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.
|
||
|
|
//
|
||
|
|
// Please also see 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 complets
|
||
|
|
// successfuly.
|
||
|
|
//
|
||
|
|
// 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)
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// Please also see 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 (http://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.
|
||
|
|
//
|
||
|
|
// Please also see 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()
|
||
|
|
}
|
||
|
|
|
||
|
|
// An alias for an edge.
|
||
|
|
// Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Alias
|
||
|
|
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.
|
||
|
|