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.

CostExplorer

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

type CostExplorer struct { *client.Client }

CostExplorer provides the API operation methods for making requests to AWS Cost Explorer Service. See this package's package overview docs for details on the service.

CostExplorer 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

GetCostAndUsage

func (c *CostExplorer) GetCostAndUsage(input *GetCostAndUsageInput) (*GetCostAndUsageOutput, error)

GetCostAndUsage API operation for AWS Cost Explorer Service.

Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html) operation. Master accounts in an organization in AWS Organizations have access to all member accounts.

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 Cost Explorer Service's API operation GetCostAndUsage for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeBillExpirationException "BillExpirationException" The requested report expired. Update the date interval and try again.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

  • ErrCodeInvalidNextTokenException "InvalidNextTokenException" The pagination token is invalid. Try again without a pagination token.

  • ErrCodeRequestChangedException "RequestChangedException" Your request parameters changed between pages. Try again with the old parameters or without a pagination token.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostAndUsage

GetCostAndUsageRequest

func (c *CostExplorer) GetCostAndUsageRequest(input *GetCostAndUsageInput) (req *request.Request, output *GetCostAndUsageOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostAndUsage

GetCostAndUsageWithContext

func (c *CostExplorer) GetCostAndUsageWithContext(ctx aws.Context, input *GetCostAndUsageInput, opts ...request.Option) (*GetCostAndUsageOutput, error)

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

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

GetCostForecast

func (c *CostExplorer) GetCostForecast(input *GetCostForecastInput) (*GetCostForecastOutput, error)

GetCostForecast API operation for AWS Cost Explorer Service.

Retrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs.

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 Cost Explorer Service's API operation GetCostForecast for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostForecast

GetCostForecastRequest

func (c *CostExplorer) GetCostForecastRequest(input *GetCostForecastInput) (req *request.Request, output *GetCostForecastOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostForecast

GetCostForecastWithContext

func (c *CostExplorer) GetCostForecastWithContext(ctx aws.Context, input *GetCostForecastInput, opts ...request.Option) (*GetCostForecastOutput, error)

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

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

GetDimensionValues

func (c *CostExplorer) GetDimensionValues(input *GetDimensionValuesInput) (*GetDimensionValuesOutput, error)

GetDimensionValues API operation for AWS Cost Explorer Service.

Retrieves all available filter values for a specified filter over a period of time. You can search the dimension values for an arbitrary string.

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 Cost Explorer Service's API operation GetDimensionValues for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeBillExpirationException "BillExpirationException" The requested report expired. Update the date interval and try again.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

  • ErrCodeInvalidNextTokenException "InvalidNextTokenException" The pagination token is invalid. Try again without a pagination token.

  • ErrCodeRequestChangedException "RequestChangedException" Your request parameters changed between pages. Try again with the old parameters or without a pagination token.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetDimensionValues

GetDimensionValuesRequest

func (c *CostExplorer) GetDimensionValuesRequest(input *GetDimensionValuesInput) (req *request.Request, output *GetDimensionValuesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetDimensionValues

GetDimensionValuesWithContext

func (c *CostExplorer) GetDimensionValuesWithContext(ctx aws.Context, input *GetDimensionValuesInput, opts ...request.Option) (*GetDimensionValuesOutput, error)

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

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

GetReservationCoverage

func (c *CostExplorer) GetReservationCoverage(input *GetReservationCoverageInput) (*GetReservationCoverageOutput, error)

GetReservationCoverage API operation for AWS Cost Explorer Service.

Retrieves the reservation coverage for your account. This enables you to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation. An organization's master account can see the coverage of the associated member accounts. For any time period, you can filter data about reservation usage by the following dimensions:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • SERVICE

  • TAG

  • TENANCY

To determine valid values for a dimension, use the GetDimensionValues operation.

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 Cost Explorer Service's API operation GetReservationCoverage for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

  • ErrCodeInvalidNextTokenException "InvalidNextTokenException" The pagination token is invalid. Try again without a pagination token.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverage

GetReservationCoverageRequest

func (c *CostExplorer) GetReservationCoverageRequest(input *GetReservationCoverageInput) (req *request.Request, output *GetReservationCoverageOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverage

GetReservationCoverageWithContext

func (c *CostExplorer) GetReservationCoverageWithContext(ctx aws.Context, input *GetReservationCoverageInput, opts ...request.Option) (*GetReservationCoverageOutput, error)

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

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

GetReservationPurchaseRecommendation

func (c *CostExplorer) GetReservationPurchaseRecommendation(input *GetReservationPurchaseRecommendationInput) (*GetReservationPurchaseRecommendationOutput, error)

GetReservationPurchaseRecommendation API operation for AWS Cost Explorer Service.

Gets recommendations for which reservations to purchase. These recommendations could help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

AWS generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After AWS has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of RI to purchase to maximize your estimated savings.

For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. AWS recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible RI. AWS also shows the equal number of normalized units so that you can purchase any instance size that you want. For this example, your RI recommendation would be for c4.large because that is the smallest size instance in the c4 instance family.

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 Cost Explorer Service's API operation GetReservationPurchaseRecommendation for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

  • ErrCodeInvalidNextTokenException "InvalidNextTokenException" The pagination token is invalid. Try again without a pagination token.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation

GetReservationPurchaseRecommendationRequest

func (c *CostExplorer) GetReservationPurchaseRecommendationRequest(input *GetReservationPurchaseRecommendationInput) (req *request.Request, output *GetReservationPurchaseRecommendationOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation

GetReservationPurchaseRecommendationWithContext

func (c *CostExplorer) GetReservationPurchaseRecommendationWithContext(ctx aws.Context, input *GetReservationPurchaseRecommendationInput, opts ...request.Option) (*GetReservationPurchaseRecommendationOutput, error)

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

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

GetReservationUtilization

func (c *CostExplorer) GetReservationUtilization(input *GetReservationUtilizationInput) (*GetReservationUtilizationOutput, error)

GetReservationUtilization API operation for AWS Cost Explorer Service.

Retrieves the reservation utilization for your account. Master accounts in an organization have access to member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

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 Cost Explorer Service's API operation GetReservationUtilization for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

  • ErrCodeInvalidNextTokenException "InvalidNextTokenException" The pagination token is invalid. Try again without a pagination token.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationUtilization

GetReservationUtilizationRequest

func (c *CostExplorer) GetReservationUtilizationRequest(input *GetReservationUtilizationInput) (req *request.Request, output *GetReservationUtilizationOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationUtilization

GetReservationUtilizationWithContext

func (c *CostExplorer) GetReservationUtilizationWithContext(ctx aws.Context, input *GetReservationUtilizationInput, opts ...request.Option) (*GetReservationUtilizationOutput, error)

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

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

GetTags

func (c *CostExplorer) GetTags(input *GetTagsInput) (*GetTagsOutput, error)

GetTags API operation for AWS Cost Explorer Service.

Queries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.

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 Cost Explorer Service's API operation GetTags for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededException "LimitExceededException" You made too many calls in a short period of time. Try again later.

  • ErrCodeBillExpirationException "BillExpirationException" The requested report expired. Update the date interval and try again.

  • ErrCodeDataUnavailableException "DataUnavailableException" The requested data is unavailable.

  • ErrCodeInvalidNextTokenException "InvalidNextTokenException" The pagination token is invalid. Try again without a pagination token.

  • ErrCodeRequestChangedException "RequestChangedException" Your request parameters changed between pages. Try again with the old parameters or without a pagination token.

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetTags

GetTagsRequest

func (c *CostExplorer) GetTagsRequest(input *GetTagsInput) (req *request.Request, output *GetTagsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetTags

GetTagsWithContext

func (c *CostExplorer) GetTagsWithContext(ctx aws.Context, input *GetTagsInput, opts ...request.Option) (*GetTagsOutput, error)

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

See GetTags 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: