AWS SDK for Go (PILOT)
API Reference

PREVIEW DOCUMENTATION - This is a preview of a new format for the AWS SDK for Go API Reference documentation. For the current AWS SDK for Go API Reference, see https://docs.aws.amazon.com/sdk-for-go/api/.

We welcome your feedback on this new version of the documentation. Send your comments to aws-sdkdocs-feedback@amazon.com.

PI

import "github.com/aws/aws-sdk-go/service/pi"

type PI struct { *client.Client }

PI provides the API operation methods for making requests to AWS Performance Insights. See this package's package overview docs for details on the service.

PI methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

Client

Type: *client.Client

Method

DescribeDimensionKeys

func (c *PI) DescribeDimensionKeys(input *DescribeDimensionKeysInput) (*DescribeDimensionKeysOutput, error)

DescribeDimensionKeys API operation for AWS Performance Insights.

For a specific time period, retrieve the top N dimension keys for a metric.

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 Performance Insights's API operation DescribeDimensionKeys for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidArgumentException "InvalidArgumentException" One of the arguments provided is invalid for this request.

  • ErrCodeInternalServiceError "InternalServiceError" The request failed due to an unknown error.

  • ErrCodeNotAuthorizedException "NotAuthorizedException" The user is not authorized to perform this request.

See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DescribeDimensionKeys

DescribeDimensionKeysRequest

func (c *PI) DescribeDimensionKeysRequest(input *DescribeDimensionKeysInput) (req *request.Request, output *DescribeDimensionKeysOutput)

DescribeDimensionKeysRequest generates a "aws/request.Request" representing the client's request for the DescribeDimensionKeys 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 DescribeDimensionKeys for more information on using the DescribeDimensionKeys 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 DescribeDimensionKeysRequest method. req, resp := client.DescribeDimensionKeysRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DescribeDimensionKeys

DescribeDimensionKeysWithContext

func (c *PI) DescribeDimensionKeysWithContext(ctx aws.Context, input *DescribeDimensionKeysInput, opts ...request.Option) (*DescribeDimensionKeysOutput, error)

DescribeDimensionKeysWithContext is the same as DescribeDimensionKeys with the addition of the ability to pass a context and additional request options.

See DescribeDimensionKeys 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.

See Also

For more information about using this API, see AWS API Documentation.

GetResourceMetrics

func (c *PI) GetResourceMetrics(input *GetResourceMetricsInput) (*GetResourceMetricsOutput, error)

GetResourceMetrics API operation for AWS Performance Insights.

Retrieve Performance Insights metrics for a set of data sources, over a time period. You can provide specific dimension groups and dimensions, and provide aggregation and filtering criteria for each group.

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 Performance Insights's API operation GetResourceMetrics for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidArgumentException "InvalidArgumentException" One of the arguments provided is invalid for this request.

  • ErrCodeInternalServiceError "InternalServiceError" The request failed due to an unknown error.

  • ErrCodeNotAuthorizedException "NotAuthorizedException" The user is not authorized to perform this request.

See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetResourceMetrics

GetResourceMetricsRequest

func (c *PI) GetResourceMetricsRequest(input *GetResourceMetricsInput) (req *request.Request, output *GetResourceMetricsOutput)

GetResourceMetricsRequest generates a "aws/request.Request" representing the client's request for the GetResourceMetrics 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 GetResourceMetrics for more information on using the GetResourceMetrics 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 GetResourceMetricsRequest method. req, resp := client.GetResourceMetricsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetResourceMetrics

GetResourceMetricsWithContext

func (c *PI) GetResourceMetricsWithContext(ctx aws.Context, input *GetResourceMetricsInput, opts ...request.Option) (*GetResourceMetricsOutput, error)

GetResourceMetricsWithContext is the same as GetResourceMetrics with the addition of the ability to pass a context and additional request options.

See GetResourceMetrics 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.

See Also

For more information about using this API, see AWS API Documentation.

On this page: