costexplorer

package
v1.14.29 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 18, 2018 License: Apache-2.0 Imports: 6 Imported by: 0

Documentation

Overview

Package costexplorer provides the client and types for making API requests to AWS Cost Explorer Service.

The Cost Explorer API allows you to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data, such as the number of daily write operations for Amazon DynamoDB database tables in your production environment.

Service Endpoint

The Cost Explorer API provides the following endpoint:

For information about costs associated with the Cost Explorer API, see AWS Cost Management Pricing (https://aws.amazon.com/aws-cost-management/pricing/).

See https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25 for more information on this service.

See costexplorer package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/costexplorer/

Using the Client

To contact AWS Cost Explorer Service with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the AWS Cost Explorer Service client CostExplorer for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/costexplorer/#New

Index

Constants

View Source 
const (
	// AccountScopePayer is a AccountScope enum value
	AccountScopePayer = "PAYER"

	// AccountScopeLinked is a AccountScope enum value
	AccountScopeLinked = "LINKED"
)
View Source 
const (
	// ContextCostAndUsage is a Context enum value
	ContextCostAndUsage = "COST_AND_USAGE"

	// ContextReservations is a Context enum value
	ContextReservations = "RESERVATIONS"
)
View Source 
const (
	// DimensionAz is a Dimension enum value
	DimensionAz = "AZ"

	// DimensionInstanceType is a Dimension enum value
	DimensionInstanceType = "INSTANCE_TYPE"

	// DimensionLinkedAccount is a Dimension enum value
	DimensionLinkedAccount = "LINKED_ACCOUNT"

	// DimensionOperation is a Dimension enum value
	DimensionOperation = "OPERATION"

	// DimensionPurchaseType is a Dimension enum value
	DimensionPurchaseType = "PURCHASE_TYPE"

	// DimensionRegion is a Dimension enum value
	DimensionRegion = "REGION"

	// DimensionService is a Dimension enum value
	DimensionService = "SERVICE"

	// DimensionUsageType is a Dimension enum value
	DimensionUsageType = "USAGE_TYPE"

	// DimensionUsageTypeGroup is a Dimension enum value
	DimensionUsageTypeGroup = "USAGE_TYPE_GROUP"

	// DimensionRecordType is a Dimension enum value
	DimensionRecordType = "RECORD_TYPE"

	// DimensionOperatingSystem is a Dimension enum value
	DimensionOperatingSystem = "OPERATING_SYSTEM"

	// DimensionTenancy is a Dimension enum value
	DimensionTenancy = "TENANCY"

	// DimensionScope is a Dimension enum value
	DimensionScope = "SCOPE"

	// DimensionPlatform is a Dimension enum value
	DimensionPlatform = "PLATFORM"

	// DimensionSubscriptionId is a Dimension enum value
	DimensionSubscriptionId = "SUBSCRIPTION_ID"

	// DimensionLegalEntityName is a Dimension enum value
	DimensionLegalEntityName = "LEGAL_ENTITY_NAME"

	// DimensionDeploymentOption is a Dimension enum value
	DimensionDeploymentOption = "DEPLOYMENT_OPTION"

	// DimensionDatabaseEngine is a Dimension enum value
	DimensionDatabaseEngine = "DATABASE_ENGINE"

	// DimensionCacheEngine is a Dimension enum value
	DimensionCacheEngine = "CACHE_ENGINE"

	// DimensionInstanceTypeFamily is a Dimension enum value
	DimensionInstanceTypeFamily = "INSTANCE_TYPE_FAMILY"
)
View Source 
const (
	// GranularityDaily is a Granularity enum value
	GranularityDaily = "DAILY"

	// GranularityMonthly is a Granularity enum value
	GranularityMonthly = "MONTHLY"
)
View Source 
const (
	// GroupDefinitionTypeDimension is a GroupDefinitionType enum value
	GroupDefinitionTypeDimension = "DIMENSION"

	// GroupDefinitionTypeTag is a GroupDefinitionType enum value
	GroupDefinitionTypeTag = "TAG"
)
View Source 
const (
	// LookbackPeriodInDaysSevenDays is a LookbackPeriodInDays enum value
	LookbackPeriodInDaysSevenDays = "SEVEN_DAYS"

	// LookbackPeriodInDaysThirtyDays is a LookbackPeriodInDays enum value
	LookbackPeriodInDaysThirtyDays = "THIRTY_DAYS"

	// LookbackPeriodInDaysSixtyDays is a LookbackPeriodInDays enum value
	LookbackPeriodInDaysSixtyDays = "SIXTY_DAYS"
)
View Source 
const (
	// OfferingClassStandard is a OfferingClass enum value
	OfferingClassStandard = "STANDARD"

	// OfferingClassConvertible is a OfferingClass enum value
	OfferingClassConvertible = "CONVERTIBLE"
)
View Source 
const (
	// PaymentOptionNoUpfront is a PaymentOption enum value
	PaymentOptionNoUpfront = "NO_UPFRONT"

	// PaymentOptionPartialUpfront is a PaymentOption enum value
	PaymentOptionPartialUpfront = "PARTIAL_UPFRONT"

	// PaymentOptionAllUpfront is a PaymentOption enum value
	PaymentOptionAllUpfront = "ALL_UPFRONT"

	// PaymentOptionLightUtilization is a PaymentOption enum value
	PaymentOptionLightUtilization = "LIGHT_UTILIZATION"

	// PaymentOptionMediumUtilization is a PaymentOption enum value
	PaymentOptionMediumUtilization = "MEDIUM_UTILIZATION"

	// PaymentOptionHeavyUtilization is a PaymentOption enum value
	PaymentOptionHeavyUtilization = "HEAVY_UTILIZATION"
)
View Source 
const (
	// TermInYearsOneYear is a TermInYears enum value
	TermInYearsOneYear = "ONE_YEAR"

	// TermInYearsThreeYears is a TermInYears enum value
	TermInYearsThreeYears = "THREE_YEARS"
)
View Source 
const (

	// ErrCodeBillExpirationException for service response error code
	// "BillExpirationException".
	//
	// The requested report expired. Update the date interval and try again.
	ErrCodeBillExpirationException = "BillExpirationException"

	// ErrCodeDataUnavailableException for service response error code
	// "DataUnavailableException".
	//
	// The requested data is unavailable.
	ErrCodeDataUnavailableException = "DataUnavailableException"

	// ErrCodeInvalidNextTokenException for service response error code
	// "InvalidNextTokenException".
	//
	// The pagination token is invalid. Try again without a pagination token.
	ErrCodeInvalidNextTokenException = "InvalidNextTokenException"

	// ErrCodeLimitExceededException for service response error code
	// "LimitExceededException".
	//
	// You made too many calls in a short period of time. Try again later.
	ErrCodeLimitExceededException = "LimitExceededException"

	// ErrCodeRequestChangedException for service response error code
	// "RequestChangedException".
	//
	// Your request parameters changed between pages. Try again with the old parameters
	// or without a pagination token.
	ErrCodeRequestChangedException = "RequestChangedException"
)
View Source 
const (
	ServiceName = "ce"            // Name of service.
	EndpointsID = ServiceName     // ID to lookup a service endpoint with.
	ServiceID   = "Cost Explorer" // ServiceID is a unique identifer of a specific service.
)

Service information constants

Variables

This section is empty.

Functions

This section is empty.

Types

type 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.

func New 

func New(p client.ConfigProvider, cfgs ...*aws.Config) *CostExplorer

New creates a new instance of the CostExplorer client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example: 

// Create a CostExplorer client from just a session.
svc := costexplorer.New(mySession)

// Create a CostExplorer client with additional configuration
svc := costexplorer.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*CostExplorer) 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 (http://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

func (*CostExplorer) 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 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 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

func (*CostExplorer) 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.

func (*CostExplorer) 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

func (*CostExplorer) 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 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 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

func (*CostExplorer) 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.

func (*CostExplorer) GetReservationCoverage added in v1.13.3 

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

GetReservationCoverage API operation for AWS Cost Explorer Service.

Retrieves the reservation coverage for your account. This allows 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

func (*CostExplorer) GetReservationCoverageRequest added in v1.13.3 

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 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 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

func (*CostExplorer) GetReservationCoverageWithContext added in v1.13.3 

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.

func (*CostExplorer) GetReservationPurchaseRecommendation added in v1.13.17 

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 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

func (*CostExplorer) GetReservationPurchaseRecommendationRequest added in v1.13.17 

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 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 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

func (*CostExplorer) GetReservationPurchaseRecommendationWithContext added in v1.13.17 

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.

func (*CostExplorer) 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

func (*CostExplorer) 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 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 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

func (*CostExplorer) 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.

func (*CostExplorer) 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

func (*CostExplorer) 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 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 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

func (*CostExplorer) 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.

type Coverage added in v1.13.3 

type Coverage struct {

	// The amount of instance usage that a reservation covered, in hours.
	CoverageHours *CoverageHours `type:"structure"`
	// contains filtered or unexported fields
}

The amount of instance usage that a reservation covered.

func (Coverage) GoString added in v1.13.3 

func (s Coverage) GoString() string

GoString returns the string representation

func (*Coverage) SetCoverageHours added in v1.13.3 

func (s *Coverage) SetCoverageHours(v *CoverageHours) *Coverage

SetCoverageHours sets the CoverageHours field's value.

func (Coverage) String added in v1.13.3 

func (s Coverage) String() string

String returns the string representation

type CoverageByTime added in v1.13.3 

type CoverageByTime struct {

	// The groups of instances that are covered by a reservation.
	Groups []*ReservationCoverageGroup `type:"list"`

	// The period over which this coverage was used.
	TimePeriod *DateInterval `type:"structure"`

	// The total reservation coverage, in hours.
	Total *Coverage `type:"structure"`
	// contains filtered or unexported fields
}

Reservation coverage for a specified period, in hours.

func (CoverageByTime) GoString added in v1.13.3 

func (s CoverageByTime) GoString() string

GoString returns the string representation

func (*CoverageByTime) SetGroups added in v1.13.3 

func (s *CoverageByTime) SetGroups(v []*ReservationCoverageGroup) *CoverageByTime

SetGroups sets the Groups field's value.

func (*CoverageByTime) SetTimePeriod added in v1.13.3 

func (s *CoverageByTime) SetTimePeriod(v *DateInterval) *CoverageByTime

SetTimePeriod sets the TimePeriod field's value.

func (*CoverageByTime) SetTotal added in v1.13.3 

func (s *CoverageByTime) SetTotal(v *Coverage) *CoverageByTime

SetTotal sets the Total field's value.

func (CoverageByTime) String added in v1.13.3 

func (s CoverageByTime) String() string

String returns the string representation

type CoverageHours added in v1.13.3 

type CoverageHours struct {

	// The percentage of instance hours that are covered by a reservation.
	CoverageHoursPercentage *string `type:"string"`

	// The number of instance running hours that are covered by On-Demand Instances.
	OnDemandHours *string `type:"string"`

	// The number of instance running hours that are covered by reservations.
	ReservedHours *string `type:"string"`

	// The total instance usage, in hours.
	TotalRunningHours *string `type:"string"`
	// contains filtered or unexported fields
}

How long a running instance either used a reservation or was On-Demand.

func (CoverageHours) GoString added in v1.13.3 

func (s CoverageHours) GoString() string

GoString returns the string representation

func (*CoverageHours) SetCoverageHoursPercentage added in v1.13.3 

func (s *CoverageHours) SetCoverageHoursPercentage(v string) *CoverageHours

SetCoverageHoursPercentage sets the CoverageHoursPercentage field's value.

func (*CoverageHours) SetOnDemandHours added in v1.13.3 

func (s *CoverageHours) SetOnDemandHours(v string) *CoverageHours

SetOnDemandHours sets the OnDemandHours field's value.

func (*CoverageHours) SetReservedHours added in v1.13.3 

func (s *CoverageHours) SetReservedHours(v string) *CoverageHours

SetReservedHours sets the ReservedHours field's value.

func (*CoverageHours) SetTotalRunningHours added in v1.13.3 

func (s *CoverageHours) SetTotalRunningHours(v string) *CoverageHours

SetTotalRunningHours sets the TotalRunningHours field's value.

func (CoverageHours) String added in v1.13.3 

func (s CoverageHours) String() string

String returns the string representation

type DateInterval 

type DateInterval struct {

	// The end of the time period that you want the usage and costs for. The end
	// date is exclusive. For example, if end is 2017-05-01, AWS retrieves cost
	// and usage data from the start date up to, but not including, 2017-05-01.
	//
	// End is a required field
	End *string `type:"string" required:"true"`

	// The beginning of the time period that you want the usage and costs for. The
	// start date is inclusive. For example, if start is 2017-01-01, AWS retrieves
	// cost and usage data starting at 2017-01-01 up to the end date.
	//
	// Start is a required field
	Start *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

The time period that you want the usage and costs for.

func (DateInterval) GoString 

func (s DateInterval) GoString() string

GoString returns the string representation

func (*DateInterval) SetEnd 

func (s *DateInterval) SetEnd(v string) *DateInterval

SetEnd sets the End field's value.

func (*DateInterval) SetStart 

func (s *DateInterval) SetStart(v string) *DateInterval

SetStart sets the Start field's value.

func (DateInterval) String 

func (s DateInterval) String() string

String returns the string representation

func (*DateInterval) Validate 

func (s *DateInterval) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DimensionValues 

type DimensionValues struct {

	// The names of the metadata types that you can use to filter and group your
	// results. For example, AZ returns a list of Availability Zones.
	Key *string `type:"string" enum:"Dimension"`

	// The metadata values that you can use to filter and group your results. You
	// can use GetDimensionValues to find specific values.
	Values []*string `type:"list"`
	// contains filtered or unexported fields
}

The metadata that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

func (DimensionValues) GoString 

func (s DimensionValues) GoString() string

GoString returns the string representation

func (*DimensionValues) SetKey 

func (s *DimensionValues) SetKey(v string) *DimensionValues

SetKey sets the Key field's value.

func (*DimensionValues) SetValues 

func (s *DimensionValues) SetValues(v []*string) *DimensionValues

SetValues sets the Values field's value.

func (DimensionValues) String 

func (s DimensionValues) String() string

String returns the string representation

type DimensionValuesWithAttributes 

type DimensionValuesWithAttributes struct {

	// The attribute that applies to a specific Dimension.
	Attributes map[string]*string `type:"map"`

	// The value of a dimension with a specific attribute.
	Value *string `type:"string"`
	// contains filtered or unexported fields
}

The metadata of a specific type that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

func (DimensionValuesWithAttributes) GoString 

func (s DimensionValuesWithAttributes) GoString() string

GoString returns the string representation

func (*DimensionValuesWithAttributes) SetAttributes 

func (s *DimensionValuesWithAttributes) SetAttributes(v map[string]*string) *DimensionValuesWithAttributes

SetAttributes sets the Attributes field's value.

func (*DimensionValuesWithAttributes) SetValue 

func (s *DimensionValuesWithAttributes) SetValue(v string) *DimensionValuesWithAttributes

SetValue sets the Value field's value.

func (DimensionValuesWithAttributes) String 

func (s DimensionValuesWithAttributes) String() string

String returns the string representation

type EC2InstanceDetails added in v1.13.17 

type EC2InstanceDetails struct {

	// The Availability Zone of the recommended reservation.
	AvailabilityZone *string `type:"string"`

	// Whether the recommendation is for a current generation instance.
	CurrentGeneration *bool `type:"boolean"`

	// The instance family of the recommended reservation.
	Family *string `type:"string"`

	// The type of instance that AWS recommends.
	InstanceType *string `type:"string"`

	// The platform of the recommended reservation. The platform is the specific
	// combination of operating system, license model, and software on an instance.
	Platform *string `type:"string"`

	// The AWS Region of the recommended reservation.
	Region *string `type:"string"`

	// Whether the recommended reservation is size flexible.
	SizeFlexEligible *bool `type:"boolean"`

	// Whether the recommended reservation is dedicated or shared.
	Tenancy *string `type:"string"`
	// contains filtered or unexported fields
}

Details about the EC2 instances that AWS recommends that you purchase.

func (EC2InstanceDetails) GoString added in v1.13.17 

func (s EC2InstanceDetails) GoString() string

GoString returns the string representation

func (*EC2InstanceDetails) SetAvailabilityZone added in v1.13.17 

func (s *EC2InstanceDetails) SetAvailabilityZone(v string) *EC2InstanceDetails

SetAvailabilityZone sets the AvailabilityZone field's value.

func (*EC2InstanceDetails) SetCurrentGeneration added in v1.13.17 

func (s *EC2InstanceDetails) SetCurrentGeneration(v bool) *EC2InstanceDetails

SetCurrentGeneration sets the CurrentGeneration field's value.

func (*EC2InstanceDetails) SetFamily added in v1.13.17 

func (s *EC2InstanceDetails) SetFamily(v string) *EC2InstanceDetails

SetFamily sets the Family field's value.

func (*EC2InstanceDetails) SetInstanceType added in v1.13.17 

func (s *EC2InstanceDetails) SetInstanceType(v string) *EC2InstanceDetails

SetInstanceType sets the InstanceType field's value.

func (*EC2InstanceDetails) SetPlatform added in v1.13.17 

func (s *EC2InstanceDetails) SetPlatform(v string) *EC2InstanceDetails

SetPlatform sets the Platform field's value.

func (*EC2InstanceDetails) SetRegion added in v1.13.17 

func (s *EC2InstanceDetails) SetRegion(v string) *EC2InstanceDetails

SetRegion sets the Region field's value.

func (*EC2InstanceDetails) SetSizeFlexEligible added in v1.13.17 

func (s *EC2InstanceDetails) SetSizeFlexEligible(v bool) *EC2InstanceDetails

SetSizeFlexEligible sets the SizeFlexEligible field's value.

func (*EC2InstanceDetails) SetTenancy added in v1.13.17 

func (s *EC2InstanceDetails) SetTenancy(v string) *EC2InstanceDetails

SetTenancy sets the Tenancy field's value.

func (EC2InstanceDetails) String added in v1.13.17 

func (s EC2InstanceDetails) String() string

String returns the string representation

type EC2Specification added in v1.13.17 

type EC2Specification struct {

	// Whether you want a recommendation for standard or convertible reservations.
	OfferingClass *string `type:"string" enum:"OfferingClass"`
	// contains filtered or unexported fields
}

The EC2 hardware specifications that you want AWS to provide recommendations for.

func (EC2Specification) GoString added in v1.13.17 

func (s EC2Specification) GoString() string

GoString returns the string representation

func (*EC2Specification) SetOfferingClass added in v1.13.17 

func (s *EC2Specification) SetOfferingClass(v string) *EC2Specification

SetOfferingClass sets the OfferingClass field's value.

func (EC2Specification) String added in v1.13.17 

func (s EC2Specification) String() string

String returns the string representation

type ESInstanceDetails added in v1.14.25 

type ESInstanceDetails struct {

	// Whether the recommendation is for a current generation instance.
	CurrentGeneration *bool `type:"boolean"`

	// The class of instance that AWS recommends.
	InstanceClass *string `type:"string"`

	// The size of instance that AWS recommends.
	InstanceSize *string `type:"string"`

	// The AWS Region of the recommended reservation.
	Region *string `type:"string"`

	// Whether the recommended reservation is size flexible.
	SizeFlexEligible *bool `type:"boolean"`
	// contains filtered or unexported fields
}

Details about the ES instances that AWS recommends that you purchase.

func (ESInstanceDetails) GoString added in v1.14.25 

func (s ESInstanceDetails) GoString() string

GoString returns the string representation

func (*ESInstanceDetails) SetCurrentGeneration added in v1.14.25 

func (s *ESInstanceDetails) SetCurrentGeneration(v bool) *ESInstanceDetails

SetCurrentGeneration sets the CurrentGeneration field's value.

func (*ESInstanceDetails) SetInstanceClass added in v1.14.25 

func (s *ESInstanceDetails) SetInstanceClass(v string) *ESInstanceDetails

SetInstanceClass sets the InstanceClass field's value.

func (*ESInstanceDetails) SetInstanceSize added in v1.14.25 

func (s *ESInstanceDetails) SetInstanceSize(v string) *ESInstanceDetails

SetInstanceSize sets the InstanceSize field's value.

func (*ESInstanceDetails) SetRegion added in v1.14.25 

func (s *ESInstanceDetails) SetRegion(v string) *ESInstanceDetails

SetRegion sets the Region field's value.

func (*ESInstanceDetails) SetSizeFlexEligible added in v1.14.25 

func (s *ESInstanceDetails) SetSizeFlexEligible(v bool) *ESInstanceDetails

SetSizeFlexEligible sets the SizeFlexEligible field's value.

func (ESInstanceDetails) String added in v1.14.25 

func (s ESInstanceDetails) String() string

String returns the string representation

type ElastiCacheInstanceDetails added in v1.14.25 

type ElastiCacheInstanceDetails struct {

	// Whether the recommendation is for a current generation instance.
	CurrentGeneration *bool `type:"boolean"`

	// The instance family of the recommended reservation.
	Family *string `type:"string"`

	// The type of node that AWS recommends.
	NodeType *string `type:"string"`

	// The description of the recommended reservation.
	ProductDescription *string `type:"string"`

	// The AWS Region of the recommended reservation.
	Region *string `type:"string"`

	// Whether the recommended reservation is size flexible.
	SizeFlexEligible *bool `type:"boolean"`
	// contains filtered or unexported fields
}

Details about the ElastiCache instances that AWS recommends that you purchase.

func (ElastiCacheInstanceDetails) GoString added in v1.14.25 

func (s ElastiCacheInstanceDetails) GoString() string

GoString returns the string representation

func (*ElastiCacheInstanceDetails) SetCurrentGeneration added in v1.14.25 

func (s *ElastiCacheInstanceDetails) SetCurrentGeneration(v bool) *ElastiCacheInstanceDetails

SetCurrentGeneration sets the CurrentGeneration field's value.

func (*ElastiCacheInstanceDetails) SetFamily added in v1.14.25 

func (s *ElastiCacheInstanceDetails) SetFamily(v string) *ElastiCacheInstanceDetails

SetFamily sets the Family field's value.

func (*ElastiCacheInstanceDetails) SetNodeType added in v1.14.25 

func (s *ElastiCacheInstanceDetails) SetNodeType(v string) *ElastiCacheInstanceDetails

SetNodeType sets the NodeType field's value.

func (*ElastiCacheInstanceDetails) SetProductDescription added in v1.14.25 

func (s *ElastiCacheInstanceDetails) SetProductDescription(v string) *ElastiCacheInstanceDetails

SetProductDescription sets the ProductDescription field's value.

func (*ElastiCacheInstanceDetails) SetRegion added in v1.14.25 

func (s *ElastiCacheInstanceDetails) SetRegion(v string) *ElastiCacheInstanceDetails

SetRegion sets the Region field's value.

func (*ElastiCacheInstanceDetails) SetSizeFlexEligible added in v1.14.25 

func (s *ElastiCacheInstanceDetails) SetSizeFlexEligible(v bool) *ElastiCacheInstanceDetails

SetSizeFlexEligible sets the SizeFlexEligible field's value.

func (ElastiCacheInstanceDetails) String added in v1.14.25 

func (s ElastiCacheInstanceDetails) String() string

String returns the string representation

type Expression 

type Expression struct {

	// Return results that match both Dimension objects.
	And []*Expression `type:"list"`

	// The specific Dimension to use for Expression.
	Dimensions *DimensionValues `type:"structure"`

	// Return results that don't match a Dimension object.
	Not *Expression `type:"structure"`

	// Return results that match either Dimension object.
	Or []*Expression `type:"list"`

	// The specific Tag to use for Expression.
	Tags *TagValues `type:"structure"`
	// contains filtered or unexported fields
}

Use Expression to filter by cost or by usage. There are two patterns:

  • Simple dimension values - You can set the dimension name and values for the filters that you plan to use. For example, you can filter for INSTANCE_TYPE==m4.xlarge OR INSTANCE_TYPE==c4.large. The Expression for that looks like this:

{ "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "m4.xlarge", “c4.large” 

] } }

The list of dimension values are OR'd together to retrieve cost or usage 

data. You can create Expression and DimensionValues objects using either
with* methods or set* methods in multiple lines.

* Compound dimension values with logical operations - You can use multiple
Expression types and the logical operators AND/OR/NOT to create a list
of one or more Expression objects. This allows you to filter on more advanced
options. For example, you can filter on ((INSTANCE_TYPE == m4.large OR
INSTANCE_TYPE == m3.large) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
DataTransfer). The Expression for that looks like this:

{ "And": [ {"Or": [ {"Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ 

"m4.x.large", "c4.large" ] }}, {"Tags": { "Key": "TagName", "Values":
["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
["DataTransfer"] }}} ] }

Because each Expression can have only one operator, the service returns an 

  error if more than one is specified. The following example shows an Expression
  object that creates an error.

{ "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE", "Values":
  [ "DataTransfer" ] } }

func (Expression) GoString 

func (s Expression) GoString() string

GoString returns the string representation

func (*Expression) SetAnd 

func (s *Expression) SetAnd(v []*Expression) *Expression

SetAnd sets the And field's value.

func (*Expression) SetDimensions 

func (s *Expression) SetDimensions(v *DimensionValues) *Expression

SetDimensions sets the Dimensions field's value.

func (*Expression) SetNot 

func (s *Expression) SetNot(v *Expression) *Expression

SetNot sets the Not field's value.

func (*Expression) SetOr 

func (s *Expression) SetOr(v []*Expression) *Expression

SetOr sets the Or field's value.

func (*Expression) SetTags 

func (s *Expression) SetTags(v *TagValues) *Expression

SetTags sets the Tags field's value.

func (Expression) String 

func (s Expression) String() string

String returns the string representation

type GetCostAndUsageInput 

type GetCostAndUsageInput struct {

	// Filters AWS costs by different dimensions. For example, you can specify SERVICE
	// and LINKED_ACCOUNT and get the costs that are associated with that account's
	// usage of that service. You can nest Expression objects to define any combination
	// of dimension filters. For more information, see Expression (http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html).
	Filter *Expression `type:"structure"`

	// Sets the AWS cost granularity to MONTHLY or DAILY. If Granularity isn't set,
	// the response object doesn't include the Granularity, either MONTHLY or DAILY.
	Granularity *string `type:"string" enum:"Granularity"`

	// You can group AWS costs using up to two different groups, either dimensions,
	// tag keys, or both.
	//
	// When you group by tag key, you get all tag values, including empty strings.
	//
	// Valid values are AZ, INSTANCE_TYPE, LEGAL_ENTITY_NAME, LINKED_ACCOUNT, OPERATION,
	// PLATFORM, PURCHASE_TYPE, SERVICE, TAGS, TENANCY, and USAGE_TYPE.
	GroupBy []*GroupDefinition `type:"list"`

	// Which metrics are returned in the query. For more information about blended
	// and unblended rates, see Why does the "blended" annotation appear on some
	// line items in my bill? (https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/).
	//
	// Valid values are AmortizedCost, BlendedCost, UnblendedCost, and UsageQuantity.
	//
	// If you return the UsageQuantity metric, the service aggregates all usage
	// numbers without taking into account the units. For example, if you aggregate
	// usageQuantity across all of EC2, the results aren't meaningful because EC2
	// compute hours and data transfer are measured in different units (for example,
	// hours vs. GB). To get more meaningful UsageQuantity metrics, filter by UsageType
	// or UsageTypeGroups.
	//
	// Metrics is required for GetCostAndUsage requests.
	Metrics []*string `type:"list"`

	// The token to retrieve the next set of results. AWS provides the token when
	// the response from a previous call has more results than the maximum page
	// size.
	NextPageToken *string `type:"string"`

	// Sets the start and end dates for retrieving AWS costs. The start date is
	// inclusive, but the end date is exclusive. For example, if start is 2017-01-01
	// and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01
	// up to and including 2017-04-30 but not including 2017-05-01.
	TimePeriod *DateInterval `type:"structure"`
	// contains filtered or unexported fields
}

func (GetCostAndUsageInput) GoString 

func (s GetCostAndUsageInput) GoString() string

GoString returns the string representation

func (*GetCostAndUsageInput) SetFilter 

func (s *GetCostAndUsageInput) SetFilter(v *Expression) *GetCostAndUsageInput

SetFilter sets the Filter field's value.

func (*GetCostAndUsageInput) SetGranularity 

func (s *GetCostAndUsageInput) SetGranularity(v string) *GetCostAndUsageInput

SetGranularity sets the Granularity field's value.

func (*GetCostAndUsageInput) SetGroupBy 

func (s *GetCostAndUsageInput) SetGroupBy(v []*GroupDefinition) *GetCostAndUsageInput

SetGroupBy sets the GroupBy field's value.

func (*GetCostAndUsageInput) SetMetrics 

func (s *GetCostAndUsageInput) SetMetrics(v []*string) *GetCostAndUsageInput

SetMetrics sets the Metrics field's value.

func (*GetCostAndUsageInput) SetNextPageToken 

func (s *GetCostAndUsageInput) SetNextPageToken(v string) *GetCostAndUsageInput

SetNextPageToken sets the NextPageToken field's value.

func (*GetCostAndUsageInput) SetTimePeriod 

func (s *GetCostAndUsageInput) SetTimePeriod(v *DateInterval) *GetCostAndUsageInput

SetTimePeriod sets the TimePeriod field's value.

func (GetCostAndUsageInput) String 

func (s GetCostAndUsageInput) String() string

String returns the string representation

func (*GetCostAndUsageInput) Validate 

func (s *GetCostAndUsageInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetCostAndUsageOutput 

type GetCostAndUsageOutput struct {

	// The groups that are specified by the Filter or GroupBy parameters in the
	// request.
	GroupDefinitions []*GroupDefinition `type:"list"`

	// The token for the next set of retrievable results. AWS provides the token
	// when the response from a previous call has more results than the maximum
	// page size.
	NextPageToken *string `type:"string"`

	// The time period that is covered by the results in the response.
	ResultsByTime []*ResultByTime `type:"list"`
	// contains filtered or unexported fields
}

func (GetCostAndUsageOutput) GoString 

func (s GetCostAndUsageOutput) GoString() string

GoString returns the string representation

func (*GetCostAndUsageOutput) SetGroupDefinitions 

func (s *GetCostAndUsageOutput) SetGroupDefinitions(v []*GroupDefinition) *GetCostAndUsageOutput

SetGroupDefinitions sets the GroupDefinitions field's value.

func (*GetCostAndUsageOutput) SetNextPageToken 

func (s *GetCostAndUsageOutput) SetNextPageToken(v string) *GetCostAndUsageOutput

SetNextPageToken sets the NextPageToken field's value.

func (*GetCostAndUsageOutput) SetResultsByTime 

func (s *GetCostAndUsageOutput) SetResultsByTime(v []*ResultByTime) *GetCostAndUsageOutput

SetResultsByTime sets the ResultsByTime field's value.

func (GetCostAndUsageOutput) String 

func (s GetCostAndUsageOutput) String() string

String returns the string representation

type GetDimensionValuesInput 

type GetDimensionValuesInput struct {

	// The context for the call to GetDimensionValues. This can be RESERVATIONS
	// or COST_AND_USAGE. The default value is COST_AND_USAGE. If the context is
	// set to RESERVATIONS, the resulting dimension values can be used in the GetReservationUtilization
	// operation. If the context is set to COST_AND_USAGE the resulting dimension
	// values can be used in the GetCostAndUsage operation.
	//
	// If you set the context to COST_AND_USAGE, you can use the following dimensions
	// for searching:
	//
	//    * AZ - The Availability Zone. An example is us-east-1a.
	//
	//    * DATABASE_ENGINE - The Amazon Relational Database Service database. Examples
	//    are Aurora or MySQL.
	//
	//    * INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.
	//
	//    * LEGAL_ENTITY_NAME - The name of the organization that sells you AWS
	//    services, such as Amazon Web Services.
	//
	//    * LINKED_ACCOUNT - The description in the attribute map that includes
	//    the full name of the member account. The value field contains the AWS
	//    ID of the member account.
	//
	//    * OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.
	//
	//    * OPERATION - The action performed. Examples include RunInstance and CreateBucket.
	//
	//    * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
	//
	//    * PURCHASE_TYPE - The reservation type of the purchase to which this usage
	//    is related. Examples include On-Demand Instances and Standard Reserved
	//    Instances.
	//
	//    * SERVICE - The AWS service such as Amazon DynamoDB.
	//
	//    * USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes.
	//    The response for the GetDimensionValues operation includes a unit attribute.
	//    Examples include GB and Hrs.
	//
	//    * USAGE_TYPE_GROUP - The grouping of common usage types. An example is
	//    EC2: CloudWatch – Alarms. The response for this operation includes a unit
	//    attribute.
	//
	//    * RECORD_TYPE - The different types of charges such as RI fees, usage
	//    costs, tax refunds, and credits.
	//
	// If you set the context to RESERVATIONS, you can use the following dimensions
	// for searching:
	//
	//    * AZ - The Availability Zone. An example is us-east-1a.
	//
	//    * CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are
	//    Windows or Linux.
	//
	//    * DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service
	//    deployments. Valid values are SingleAZ and MultiAZ.
	//
	//    * INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.
	//
	//    * LINKED_ACCOUNT - The description in the attribute map that includes
	//    the full name of the member account. The value field contains the AWS
	//    ID of the member account.
	//
	//    * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
	//
	//    * REGION - The AWS Region.
	//
	//    * SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values
	//    are regional or a single Availability Zone.
	//
	//    * TAG (Coverage only) - The tags that are associated with a Reserved Instance
	//    (RI).
	//
	//    * TENANCY - The tenancy of a resource. Examples are shared or dedicated.
	Context *string `type:"string" enum:"Context"`

	// The name of the dimension. Each Dimension is available for different a Context.
	// For more information, see Context.
	//
	// Dimension is a required field
	Dimension *string `type:"string" required:"true" enum:"Dimension"`

	// The token to retrieve the next set of results. AWS provides the token when
	// the response from a previous call has more results than the maximum page
	// size.
	NextPageToken *string `type:"string"`

	// The value that you want to search the filter values for.
	SearchString *string `type:"string"`

	// The start and end dates for retrieving the dimension values. The start date
	// is inclusive, but the end date is exclusive. For example, if start is 2017-01-01
	// and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01
	// up to and including 2017-04-30 but not including 2017-05-01.
	//
	// TimePeriod is a required field
	TimePeriod *DateInterval `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (GetDimensionValuesInput) GoString 

func (s GetDimensionValuesInput) GoString() string

GoString returns the string representation

func (*GetDimensionValuesInput) SetContext 

func (s *GetDimensionValuesInput) SetContext(v string) *GetDimensionValuesInput

SetContext sets the Context field's value.

func (*GetDimensionValuesInput) SetDimension 

func (s *GetDimensionValuesInput) SetDimension(v string) *GetDimensionValuesInput

SetDimension sets the Dimension field's value.

func (*GetDimensionValuesInput) SetNextPageToken 

func (s *GetDimensionValuesInput) SetNextPageToken(v string) *GetDimensionValuesInput

SetNextPageToken sets the NextPageToken field's value.

func (*GetDimensionValuesInput) SetSearchString 

func (s *GetDimensionValuesInput) SetSearchString(v string) *GetDimensionValuesInput

SetSearchString sets the SearchString field's value.

func (*GetDimensionValuesInput) SetTimePeriod 

func (s *GetDimensionValuesInput) SetTimePeriod(v *DateInterval) *GetDimensionValuesInput

SetTimePeriod sets the TimePeriod field's value.

func (GetDimensionValuesInput) String 

func (s GetDimensionValuesInput) String() string

String returns the string representation

func (*GetDimensionValuesInput) Validate 

func (s *GetDimensionValuesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetDimensionValuesOutput 

type GetDimensionValuesOutput struct {

	// The filters that you used to filter your request. Some dimensions are available
	// only for a specific context:
	//
	// If you set the context to COST_AND_USAGE, you can use the following dimensions
	// for searching:
	//
	//    * AZ - The Availability Zone. An example is us-east-1a.
	//
	//    * DATABASE_ENGINE - The Amazon Relational Database Service database. Examples
	//    are Aurora or MySQL.
	//
	//    * INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.
	//
	//    * LEGAL_ENTITY_NAME - The name of the organization that sells you AWS
	//    services, such as Amazon Web Services.
	//
	//    * LINKED_ACCOUNT - The description in the attribute map that includes
	//    the full name of the member account. The value field contains the AWS
	//    ID of the member account.
	//
	//    * OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.
	//
	//    * OPERATION - The action performed. Examples include RunInstance and CreateBucket.
	//
	//    * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
	//
	//    * PURCHASE_TYPE - The reservation type of the purchase to which this usage
	//    is related. Examples include On-Demand Instances and Standard Reserved
	//    Instances.
	//
	//    * SERVICE - The AWS service such as Amazon DynamoDB.
	//
	//    * USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes.
	//    The response for the GetDimensionValues operation includes a unit attribute.
	//    Examples include GB and Hrs.
	//
	//    * USAGE_TYPE_GROUP - The grouping of common usage types. An example is
	//    EC2: CloudWatch – Alarms. The response for this operation includes a unit
	//    attribute.
	//
	//    * RECORD_TYPE - The different types of charges such as RI fees, usage
	//    costs, tax refunds, and credits.
	//
	// If you set the context to RESERVATIONS, you can use the following dimensions
	// for searching:
	//
	//    * AZ - The Availability Zone. An example is us-east-1a.
	//
	//    * CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are
	//    Windows or Linux.
	//
	//    * DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service
	//    deployments. Valid values are SingleAZ and MultiAZ.
	//
	//    * INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.
	//
	//    * LINKED_ACCOUNT - The description in the attribute map that includes
	//    the full name of the member account. The value field contains the AWS
	//    ID of the member account.
	//
	//    * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
	//
	//    * REGION - The AWS Region.
	//
	//    * SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values
	//    are regional or a single Availability Zone.
	//
	//    * TAG (Coverage only) - The tags that are associated with a Reserved Instance
	//    (RI).
	//
	//    * TENANCY - The tenancy of a resource. Examples are shared or dedicated.
	//
	// DimensionValues is a required field
	DimensionValues []*DimensionValuesWithAttributes `type:"list" required:"true"`

	// The token for the next set of retrievable results. AWS provides the token
	// when the response from a previous call has more results than the maximum
	// page size.
	NextPageToken *string `type:"string"`

	// The number of results that AWS returned at one time.
	//
	// ReturnSize is a required field
	ReturnSize *int64 `type:"integer" required:"true"`

	// The total number of search results.
	//
	// TotalSize is a required field
	TotalSize *int64 `type:"integer" required:"true"`
	// contains filtered or unexported fields
}

func (GetDimensionValuesOutput) GoString 

func (s GetDimensionValuesOutput) GoString() string

GoString returns the string representation

func (*GetDimensionValuesOutput) SetDimensionValues 

func (s *GetDimensionValuesOutput) SetDimensionValues(v []*DimensionValuesWithAttributes) *GetDimensionValuesOutput

SetDimensionValues sets the DimensionValues field's value.

func (*GetDimensionValuesOutput) SetNextPageToken 

func (s *GetDimensionValuesOutput) SetNextPageToken(v string) *GetDimensionValuesOutput

SetNextPageToken sets the NextPageToken field's value.

func (*GetDimensionValuesOutput) SetReturnSize 

func (s *GetDimensionValuesOutput) SetReturnSize(v int64) *GetDimensionValuesOutput

SetReturnSize sets the ReturnSize field's value.

func (*GetDimensionValuesOutput) SetTotalSize 

func (s *GetDimensionValuesOutput) SetTotalSize(v int64) *GetDimensionValuesOutput

SetTotalSize sets the TotalSize field's value.

func (GetDimensionValuesOutput) String 

func (s GetDimensionValuesOutput) String() string

String returns the string representation

type GetReservationCoverageInput added in v1.13.3 

type GetReservationCoverageInput struct {

	// Filters utilization data by dimensions. You can filter by the following dimensions:
	//
	//    * AZ
	//
	//    * CACHE_ENGINE
	//
	//    * DATABASE_ENGINE
	//
	//    * DEPLOYMENT_OPTION
	//
	//    * INSTANCE_TYPE
	//
	//    * LINKED_ACCOUNT
	//
	//    * OPERATING_SYSTEM
	//
	//    * PLATFORM
	//
	//    * REGION
	//
	//    * SERVICE
	//
	//    * TAG
	//
	//    * TENANCY
	//
	// GetReservationCoverage uses the same Expression (http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html)
	// object as the other operations, but only AND is supported among each dimension.
	// You can nest only one level deep. If there are multiple values for a dimension,
	// they are OR'd together.
	//
	// If you don't provide a SERVICE filter, Cost Explorer defaults to EC2.
	Filter *Expression `type:"structure"`

	// The granularity of the AWS cost data for the reservation. Valid values are
	// MONTHLY and DAILY.
	//
	// If GroupBy is set, Granularity can't be set. If Granularity isn't set, the
	// response object doesn't include Granularity, either MONTHLY or DAILY.
	Granularity *string `type:"string" enum:"Granularity"`

	// You can group the data by the following attributes:
	//
	//    * AZ
	//
	//    * CACHE_ENGINE
	//
	//    * DATABASE_ENGINE
	//
	//    * DEPLOYMENT_OPTION
	//
	//    * INSTANCE_TYPE
	//
	//    * LINKED_ACCOUNT
	//
	//    * OPERATING_SYSTEM
	//
	//    * PLATFORM
	//
	//    * REGION
	//
	//    * TAG
	//
	//    * TENANCY
	GroupBy []*GroupDefinition `type:"list"`

	// The token to retrieve the next set of results. AWS provides the token when
	// the response from a previous call has more results than the maximum page
	// size.
	NextPageToken *string `type:"string"`

	// The start and end dates of the period for which you want to retrieve data
	// about reservation coverage. You can retrieve data for a maximum of 13 months:
	// the last 12 months and the current month. The start date is inclusive, but
	// the end date is exclusive. For example, if start is 2017-01-01 and end is
	// 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up
	// to and including 2017-04-30 but not including 2017-05-01.
	//
	// TimePeriod is a required field
	TimePeriod *DateInterval `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

You can use the following request parameters to query for how much of your instance usage is covered by a reservation.

func (GetReservationCoverageInput) GoString added in v1.13.3 

func (s GetReservationCoverageInput) GoString() string

GoString returns the string representation

func (*GetReservationCoverageInput) SetFilter added in v1.13.3 

func (s *GetReservationCoverageInput) SetFilter(v *Expression) *GetReservationCoverageInput

SetFilter sets the Filter field's value.

func (*GetReservationCoverageInput) SetGranularity added in v1.13.3 

func (s *GetReservationCoverageInput) SetGranularity(v string) *GetReservationCoverageInput

SetGranularity sets the Granularity field's value.

func (*GetReservationCoverageInput) SetGroupBy added in v1.13.3 

func (s *GetReservationCoverageInput) SetGroupBy(v []*GroupDefinition) *GetReservationCoverageInput

SetGroupBy sets the GroupBy field's value.

func (*GetReservationCoverageInput) SetNextPageToken added in v1.13.3 

func (s *GetReservationCoverageInput) SetNextPageToken(v string) *GetReservationCoverageInput

SetNextPageToken sets the NextPageToken field's value.

func (*GetReservationCoverageInput) SetTimePeriod added in v1.13.3 

func (s *GetReservationCoverageInput) SetTimePeriod(v *DateInterval) *GetReservationCoverageInput

SetTimePeriod sets the TimePeriod field's value.

func (GetReservationCoverageInput) String added in v1.13.3 

func (s GetReservationCoverageInput) String() string

String returns the string representation

func (*GetReservationCoverageInput) Validate added in v1.13.3 

func (s *GetReservationCoverageInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetReservationCoverageOutput added in v1.13.3 

type GetReservationCoverageOutput struct {

	// The amount of time that your reservations covered.
	//
	// CoveragesByTime is a required field
	CoveragesByTime []*CoverageByTime `type:"list" required:"true"`

	// The token for the next set of retrievable results. AWS provides the token
	// when the response from a previous call has more results than the maximum
	// page size.
	NextPageToken *string `type:"string"`

	// The total amount of instance usage that is covered by a reservation.
	Total *Coverage `type:"structure"`
	// contains filtered or unexported fields
}

func (GetReservationCoverageOutput) GoString added in v1.13.3 

func (s GetReservationCoverageOutput) GoString() string

GoString returns the string representation

func (*GetReservationCoverageOutput) SetCoveragesByTime added in v1.13.3 

func (s *GetReservationCoverageOutput) SetCoveragesByTime(v []*CoverageByTime) *GetReservationCoverageOutput

SetCoveragesByTime sets the CoveragesByTime field's value.

func (*GetReservationCoverageOutput) SetNextPageToken added in v1.13.3 

func (s *GetReservationCoverageOutput) SetNextPageToken(v string) *GetReservationCoverageOutput

SetNextPageToken sets the NextPageToken field's value.

func (*GetReservationCoverageOutput) SetTotal added in v1.13.3 

func (s *GetReservationCoverageOutput) SetTotal(v *Coverage) *GetReservationCoverageOutput

SetTotal sets the Total field's value.

func (GetReservationCoverageOutput) String added in v1.13.3 

func (s GetReservationCoverageOutput) String() string

String returns the string representation

type GetReservationPurchaseRecommendationInput added in v1.13.17 

type GetReservationPurchaseRecommendationInput struct {

	// The account ID that is associated with the recommendation.
	AccountId *string `type:"string"`

	// The account scope that you want recommendations for. PAYER means that AWS
	// includes the master account and any member accounts when it calculates its
	// recommendations. LINKED means that AWS includes only member accounts when
	// it calculates its recommendations.
	//
	// Valid values are PAYER and LINKED.
	AccountScope *string `type:"string" enum:"AccountScope"`

	// The number of previous days that you want AWS to consider when it calculates
	// your recommendations.
	LookbackPeriodInDays *string `type:"string" enum:"LookbackPeriodInDays"`

	// The pagination token that indicates the next set of results that you want
	// to retrieve.
	NextPageToken *string `type:"string"`

	// The number of recommendations that you want returned in a single response
	// object.
	PageSize *int64 `type:"integer"`

	// The reservation purchase option that you want recommendations for.
	PaymentOption *string `type:"string" enum:"PaymentOption"`

	// The specific service that you want recommendations for.
	//
	// Service is a required field
	Service *string `type:"string" required:"true"`

	// The hardware specifications for the service instances that you want recommendations
	// for, such as standard or convertible EC2 instances.
	ServiceSpecification *ServiceSpecification `type:"structure"`

	// The reservation term that you want recommendations for.
	TermInYears *string `type:"string" enum:"TermInYears"`
	// contains filtered or unexported fields
}

func (GetReservationPurchaseRecommendationInput) GoString added in v1.13.17 

func (s GetReservationPurchaseRecommendationInput) GoString() string

GoString returns the string representation

func (*GetReservationPurchaseRecommendationInput) SetAccountId added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetAccountId(v string) *GetReservationPurchaseRecommendationInput

SetAccountId sets the AccountId field's value.

func (*GetReservationPurchaseRecommendationInput) SetAccountScope added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetAccountScope(v string) *GetReservationPurchaseRecommendationInput

SetAccountScope sets the AccountScope field's value.

func (*GetReservationPurchaseRecommendationInput) SetLookbackPeriodInDays added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetLookbackPeriodInDays(v string) *GetReservationPurchaseRecommendationInput

SetLookbackPeriodInDays sets the LookbackPeriodInDays field's value.

func (*GetReservationPurchaseRecommendationInput) SetNextPageToken added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetNextPageToken(v string) *GetReservationPurchaseRecommendationInput

SetNextPageToken sets the NextPageToken field's value.

func (*GetReservationPurchaseRecommendationInput) SetPageSize added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetPageSize(v int64) *GetReservationPurchaseRecommendationInput

SetPageSize sets the PageSize field's value.

func (*GetReservationPurchaseRecommendationInput) SetPaymentOption added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetPaymentOption(v string) *GetReservationPurchaseRecommendationInput

SetPaymentOption sets the PaymentOption field's value.

func (*GetReservationPurchaseRecommendationInput) SetService added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetService(v string) *GetReservationPurchaseRecommendationInput

SetService sets the Service field's value.

func (*GetReservationPurchaseRecommendationInput) SetServiceSpecification added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetServiceSpecification(v *ServiceSpecification) *GetReservationPurchaseRecommendationInput

SetServiceSpecification sets the ServiceSpecification field's value.

func (*GetReservationPurchaseRecommendationInput) SetTermInYears added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) SetTermInYears(v string) *GetReservationPurchaseRecommendationInput

SetTermInYears sets the TermInYears field's value.

func (GetReservationPurchaseRecommendationInput) String added in v1.13.17 

func (s GetReservationPurchaseRecommendationInput) String() string

String returns the string representation

func (*GetReservationPurchaseRecommendationInput) Validate added in v1.13.17 

func (s *GetReservationPurchaseRecommendationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetReservationPurchaseRecommendationOutput added in v1.13.17 

type GetReservationPurchaseRecommendationOutput struct {

	// Information about this specific recommendation call, such as the time stamp
	// for when Cost Explorer generated this recommendation.
	Metadata *ReservationPurchaseRecommendationMetadata `type:"structure"`

	// The pagination token for the next set of retrievable results.
	NextPageToken *string `type:"string"`

	// Recommendations for reservations to purchase.
	Recommendations []*ReservationPurchaseRecommendation `type:"list"`
	// contains filtered or unexported fields
}

func (GetReservationPurchaseRecommendationOutput) GoString added in v1.13.17 

func (s GetReservationPurchaseRecommendationOutput) GoString() string

GoString returns the string representation

func (*GetReservationPurchaseRecommendationOutput) SetMetadata added in v1.13.17 

func (s *GetReservationPurchaseRecommendationOutput) SetMetadata(v *ReservationPurchaseRecommendationMetadata) *GetReservationPurchaseRecommendationOutput

SetMetadata sets the Metadata field's value.

func (*GetReservationPurchaseRecommendationOutput) SetNextPageToken added in v1.13.17 

func (s *GetReservationPurchaseRecommendationOutput) SetNextPageToken(v string) *GetReservationPurchaseRecommendationOutput

SetNextPageToken sets the NextPageToken field's value.

func (*GetReservationPurchaseRecommendationOutput) SetRecommendations added in v1.13.17 

func (s *GetReservationPurchaseRecommendationOutput) SetRecommendations(v []*ReservationPurchaseRecommendation) *GetReservationPurchaseRecommendationOutput

SetRecommendations sets the Recommendations field's value.

func (GetReservationPurchaseRecommendationOutput) String added in v1.13.17 

func (s GetReservationPurchaseRecommendationOutput) String() string

String returns the string representation

type GetReservationUtilizationInput 

type GetReservationUtilizationInput struct {

	// Filters utilization data by dimensions. You can filter by the following dimensions:
	//
	//    * AZ
	//
	//    * CACHE_ENGINE
	//
	//    * DATABASE_ENGINE
	//
	//    * DEPLOYMENT_OPTION
	//
	//    * INSTANCE_TYPE
	//
	//    * LINKED_ACCOUNT
	//
	//    * OPERATING_SYSTEM
	//
	//    * PLATFORM
	//
	//    * REGION
	//
	//    * SERVICE
	//
	//    * SCOPE
	//
	//    * TENANCY
	//
	// GetReservationUtilization uses the same Expression (http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html)
	// object as the other operations, but only AND is supported among each dimension,
	// and nesting is supported up to only one level deep. If there are multiple
	// values for a dimension, they are OR'd together.
	Filter *Expression `type:"structure"`

	// If GroupBy is set, Granularity can't be set. If Granularity isn't set, the
	// response object doesn't include Granularity, either MONTHLY or DAILY. If
	// both GroupBy and Granularity aren't set, GetReservationUtilization defaults
	// to DAILY.
	Granularity *string `type:"string" enum:"Granularity"`

	// Groups only by SUBSCRIPTION_ID. Metadata is included.
	GroupBy []*GroupDefinition `type:"list"`

	// The token to retrieve the next set of results. AWS provides the token when
	// the response from a previous call has more results than the maximum page
	// size.
	NextPageToken *string `type:"string"`

	// Sets the start and end dates for retrieving Reserved Instance (RI) utilization.
	// The start date is inclusive, but the end date is exclusive. For example,
	// if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data
	// is retrieved from 2017-01-01 up to and including 2017-04-30 but not including
	// 2017-05-01.
	//
	// TimePeriod is a required field
	TimePeriod *DateInterval `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (GetReservationUtilizationInput) GoString 

func (s GetReservationUtilizationInput) GoString() string

GoString returns the string representation

func (*GetReservationUtilizationInput) SetFilter 

func (s *GetReservationUtilizationInput) SetFilter(v *Expression) *GetReservationUtilizationInput

SetFilter sets the Filter field's value.

func (*GetReservationUtilizationInput) SetGranularity 

func (s *GetReservationUtilizationInput) SetGranularity(v string) *GetReservationUtilizationInput

SetGranularity sets the Granularity field's value.

func (*GetReservationUtilizationInput) SetGroupBy 

func (s *GetReservationUtilizationInput) SetGroupBy(v []*GroupDefinition) *GetReservationUtilizationInput

SetGroupBy sets the GroupBy field's value.

func (*GetReservationUtilizationInput) SetNextPageToken 

func (s *GetReservationUtilizationInput) SetNextPageToken(v string) *GetReservationUtilizationInput

SetNextPageToken sets the NextPageToken field's value.

func (*GetReservationUtilizationInput) SetTimePeriod 

func (s *GetReservationUtilizationInput) SetTimePeriod(v *DateInterval) *GetReservationUtilizationInput

SetTimePeriod sets the TimePeriod field's value.

func (GetReservationUtilizationInput) String 

func (s GetReservationUtilizationInput) String() string

String returns the string representation

func (*GetReservationUtilizationInput) Validate 

func (s *GetReservationUtilizationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetReservationUtilizationOutput 

type GetReservationUtilizationOutput struct {

	// The token for the next set of retrievable results. AWS provides the token
	// when the response from a previous call has more results than the maximum
	// page size.
	NextPageToken *string `type:"string"`

	// The total amount of time that you utilized your RIs.
	Total *ReservationAggregates `type:"structure"`

	// The amount of time that you utilized your RIs.
	//
	// UtilizationsByTime is a required field
	UtilizationsByTime []*UtilizationByTime `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (GetReservationUtilizationOutput) GoString 

func (s GetReservationUtilizationOutput) GoString() string

GoString returns the string representation

func (*GetReservationUtilizationOutput) SetNextPageToken 

func (s *GetReservationUtilizationOutput) SetNextPageToken(v string) *GetReservationUtilizationOutput

SetNextPageToken sets the NextPageToken field's value.

func (*GetReservationUtilizationOutput) SetTotal 

func (s *GetReservationUtilizationOutput) SetTotal(v *ReservationAggregates) *GetReservationUtilizationOutput

SetTotal sets the Total field's value.

func (*GetReservationUtilizationOutput) SetUtilizationsByTime 

func (s *GetReservationUtilizationOutput) SetUtilizationsByTime(v []*UtilizationByTime) *GetReservationUtilizationOutput

SetUtilizationsByTime sets the UtilizationsByTime field's value.

func (GetReservationUtilizationOutput) String 

func (s GetReservationUtilizationOutput) String() string

String returns the string representation

type GetTagsInput 

type GetTagsInput struct {

	// The token to retrieve the next set of results. AWS provides the token when
	// the response from a previous call has more results than the maximum page
	// size.
	NextPageToken *string `type:"string"`

	// The value that you want to search for.
	SearchString *string `type:"string"`

	// The key of the tag that you want to return values for.
	TagKey *string `type:"string"`

	// The start and end dates for retrieving the dimension values. The start date
	// is inclusive, but the end date is exclusive. For example, if start is 2017-01-01
	// and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01
	// up to and including 2017-04-30 but not including 2017-05-01.
	//
	// TimePeriod is a required field
	TimePeriod *DateInterval `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (GetTagsInput) GoString 

func (s GetTagsInput) GoString() string

GoString returns the string representation

func (*GetTagsInput) SetNextPageToken 

func (s *GetTagsInput) SetNextPageToken(v string) *GetTagsInput

SetNextPageToken sets the NextPageToken field's value.

func (*GetTagsInput) SetSearchString 

func (s *GetTagsInput) SetSearchString(v string) *GetTagsInput

SetSearchString sets the SearchString field's value.

func (*GetTagsInput) SetTagKey 

func (s *GetTagsInput) SetTagKey(v string) *GetTagsInput

SetTagKey sets the TagKey field's value.

func (*GetTagsInput) SetTimePeriod 

func (s *GetTagsInput) SetTimePeriod(v *DateInterval) *GetTagsInput

SetTimePeriod sets the TimePeriod field's value.

func (GetTagsInput) String 

func (s GetTagsInput) String() string

String returns the string representation

func (*GetTagsInput) Validate 

func (s *GetTagsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetTagsOutput 

type GetTagsOutput struct {

	// The token for the next set of retrievable results. AWS provides the token
	// when the response from a previous call has more results than the maximum
	// page size.
	NextPageToken *string `type:"string"`

	// The number of query results that AWS returns at a time.
	//
	// ReturnSize is a required field
	ReturnSize *int64 `type:"integer" required:"true"`

	// The tags that match your request.
	//
	// Tags is a required field
	Tags []*string `type:"list" required:"true"`

	// The total number of query results.
	//
	// TotalSize is a required field
	TotalSize *int64 `type:"integer" required:"true"`
	// contains filtered or unexported fields
}

func (GetTagsOutput) GoString 

func (s GetTagsOutput) GoString() string

GoString returns the string representation

func (*GetTagsOutput) SetNextPageToken 

func (s *GetTagsOutput) SetNextPageToken(v string) *GetTagsOutput

SetNextPageToken sets the NextPageToken field's value.

func (*GetTagsOutput) SetReturnSize 

func (s *GetTagsOutput) SetReturnSize(v int64) *GetTagsOutput

SetReturnSize sets the ReturnSize field's value.

func (*GetTagsOutput) SetTags 

func (s *GetTagsOutput) SetTags(v []*string) *GetTagsOutput

SetTags sets the Tags field's value.

func (*GetTagsOutput) SetTotalSize 

func (s *GetTagsOutput) SetTotalSize(v int64) *GetTagsOutput

SetTotalSize sets the TotalSize field's value.

func (GetTagsOutput) String 

func (s GetTagsOutput) String() string

String returns the string representation

type Group 

type Group struct {

	// The keys that are included in this group.
	Keys []*string `type:"list"`

	// The metrics that are included in this group.
	Metrics map[string]*MetricValue `type:"map"`
	// contains filtered or unexported fields
}

One level of grouped data within the results.

func (Group) GoString 

func (s Group) GoString() string

GoString returns the string representation

func (*Group) SetKeys 

func (s *Group) SetKeys(v []*string) *Group

SetKeys sets the Keys field's value.

func (*Group) SetMetrics 

func (s *Group) SetMetrics(v map[string]*MetricValue) *Group

SetMetrics sets the Metrics field's value.

func (Group) String 

func (s Group) String() string

String returns the string representation

type GroupDefinition 

type GroupDefinition struct {

	// The string that represents a key for a specified group.
	Key *string `type:"string"`

	// The string that represents the type of group.
	Type *string `type:"string" enum:"GroupDefinitionType"`
	// contains filtered or unexported fields
}

Represents a group when you specify a group by criteria, or in the response to a query with a specific grouping.

func (GroupDefinition) GoString 

func (s GroupDefinition) GoString() string

GoString returns the string representation

func (*GroupDefinition) SetKey 

func (s *GroupDefinition) SetKey(v string) *GroupDefinition

SetKey sets the Key field's value.

func (*GroupDefinition) SetType 

func (s *GroupDefinition) SetType(v string) *GroupDefinition

SetType sets the Type field's value.

func (GroupDefinition) String 

func (s GroupDefinition) String() string

String returns the string representation

type InstanceDetails added in v1.13.17 

type InstanceDetails struct {

	// The EC2 instances that AWS recommends that you purchase.
	EC2InstanceDetails *EC2InstanceDetails `type:"structure"`

	// The Amazon ES instances that AWS recommends that you purchase.
	ESInstanceDetails *ESInstanceDetails `type:"structure"`

	// The ElastiCache instances that AWS recommends that you purchase.
	ElastiCacheInstanceDetails *ElastiCacheInstanceDetails `type:"structure"`

	// The RDS instances that AWS recommends that you purchase.
	RDSInstanceDetails *RDSInstanceDetails `type:"structure"`

	// The Amazon Redshift instances that AWS recommends that you purchase.
	RedshiftInstanceDetails *RedshiftInstanceDetails `type:"structure"`
	// contains filtered or unexported fields
}

Details about the instances that AWS recommends that you purchase.

func (InstanceDetails) GoString added in v1.13.17 

func (s InstanceDetails) GoString() string

GoString returns the string representation

func (*InstanceDetails) SetEC2InstanceDetails added in v1.13.17 

func (s *InstanceDetails) SetEC2InstanceDetails(v *EC2InstanceDetails) *InstanceDetails

SetEC2InstanceDetails sets the EC2InstanceDetails field's value.

func (*InstanceDetails) SetESInstanceDetails added in v1.14.25 

func (s *InstanceDetails) SetESInstanceDetails(v *ESInstanceDetails) *InstanceDetails

SetESInstanceDetails sets the ESInstanceDetails field's value.

func (*InstanceDetails) SetElastiCacheInstanceDetails added in v1.14.25 

func (s *InstanceDetails) SetElastiCacheInstanceDetails(v *ElastiCacheInstanceDetails) *InstanceDetails

SetElastiCacheInstanceDetails sets the ElastiCacheInstanceDetails field's value.

func (*InstanceDetails) SetRDSInstanceDetails added in v1.13.33 

func (s *InstanceDetails) SetRDSInstanceDetails(v *RDSInstanceDetails) *InstanceDetails

SetRDSInstanceDetails sets the RDSInstanceDetails field's value.

func (*InstanceDetails) SetRedshiftInstanceDetails added in v1.14.25 

func (s *InstanceDetails) SetRedshiftInstanceDetails(v *RedshiftInstanceDetails) *InstanceDetails

SetRedshiftInstanceDetails sets the RedshiftInstanceDetails field's value.

func (InstanceDetails) String added in v1.13.17 

func (s InstanceDetails) String() string

String returns the string representation

type MetricValue 

type MetricValue struct {

	// The actual number that represents the metric.
	Amount *string `type:"string"`

	// The unit that the metric is given in.
	Unit *string `type:"string"`
	// contains filtered or unexported fields
}

The aggregated value for a metric.

func (MetricValue) GoString 

func (s MetricValue) GoString() string

GoString returns the string representation

func (*MetricValue) SetAmount 

func (s *MetricValue) SetAmount(v string) *MetricValue

SetAmount sets the Amount field's value.

func (*MetricValue) SetUnit 

func (s *MetricValue) SetUnit(v string) *MetricValue

SetUnit sets the Unit field's value.

func (MetricValue) String 

func (s MetricValue) String() string

String returns the string representation

type RDSInstanceDetails added in v1.13.33 

type RDSInstanceDetails struct {

	// Whether the recommendation is for a current generation instance.
	CurrentGeneration *bool `type:"boolean"`

	// The database edition that the recommended reservation supports.
	DatabaseEdition *string `type:"string"`

	// The database engine that the recommended reservation supports.
	DatabaseEngine *string `type:"string"`

	// Whether the recommendation is for a reservation in a single Availability
	// Zone or a reservation with a backup in a second Availability Zone.
	DeploymentOption *string `type:"string"`

	// The instance family of the recommended reservation.
	Family *string `type:"string"`

	// The type of instance that AWS recommends.
	InstanceType *string `type:"string"`

	// The license model that the recommended reservation supports.
	LicenseModel *string `type:"string"`

	// The AWS Region of the recommended reservation.
	Region *string `type:"string"`

	// Whether the recommended reservation is size flexible.
	SizeFlexEligible *bool `type:"boolean"`
	// contains filtered or unexported fields
}

Details about the RDS instances that AWS recommends that you purchase.

func (RDSInstanceDetails) GoString added in v1.13.33 

func (s RDSInstanceDetails) GoString() string

GoString returns the string representation

func (*RDSInstanceDetails) SetCurrentGeneration added in v1.13.33 

func (s *RDSInstanceDetails) SetCurrentGeneration(v bool) *RDSInstanceDetails

SetCurrentGeneration sets the CurrentGeneration field's value.

func (*RDSInstanceDetails) SetDatabaseEdition added in v1.14.22 

func (s *RDSInstanceDetails) SetDatabaseEdition(v string) *RDSInstanceDetails

SetDatabaseEdition sets the DatabaseEdition field's value.

func (*RDSInstanceDetails) SetDatabaseEngine added in v1.13.33 

func (s *RDSInstanceDetails) SetDatabaseEngine(v string) *RDSInstanceDetails

SetDatabaseEngine sets the DatabaseEngine field's value.

func (*RDSInstanceDetails) SetDeploymentOption added in v1.13.33 

func (s *RDSInstanceDetails) SetDeploymentOption(v string) *RDSInstanceDetails

SetDeploymentOption sets the DeploymentOption field's value.

func (*RDSInstanceDetails) SetFamily added in v1.13.33 

func (s *RDSInstanceDetails) SetFamily(v string) *RDSInstanceDetails

SetFamily sets the Family field's value.

func (*RDSInstanceDetails) SetInstanceType added in v1.13.33 

func (s *RDSInstanceDetails) SetInstanceType(v string) *RDSInstanceDetails

SetInstanceType sets the InstanceType field's value.

func (*RDSInstanceDetails) SetLicenseModel added in v1.13.33 

func (s *RDSInstanceDetails) SetLicenseModel(v string) *RDSInstanceDetails

SetLicenseModel sets the LicenseModel field's value.

func (*RDSInstanceDetails) SetRegion added in v1.13.33 

func (s *RDSInstanceDetails) SetRegion(v string) *RDSInstanceDetails

SetRegion sets the Region field's value.

func (*RDSInstanceDetails) SetSizeFlexEligible added in v1.13.33 

func (s *RDSInstanceDetails) SetSizeFlexEligible(v bool) *RDSInstanceDetails

SetSizeFlexEligible sets the SizeFlexEligible field's value.

func (RDSInstanceDetails) String added in v1.13.33 

func (s RDSInstanceDetails) String() string

String returns the string representation

type RedshiftInstanceDetails added in v1.14.25 

type RedshiftInstanceDetails struct {

	// Whether the recommendation is for a current generation instance.
	CurrentGeneration *bool `type:"boolean"`

	// The instance family of the recommended reservation.
	Family *string `type:"string"`

	// The type of node that AWS recommends.
	NodeType *string `type:"string"`

	// The AWS Region of the recommended reservation.
	Region *string `type:"string"`

	// Whether the recommended reservation is size flexible.
	SizeFlexEligible *bool `type:"boolean"`
	// contains filtered or unexported fields
}

Details about the Amazon Redshift instances that AWS recommends that you purchase.

func (RedshiftInstanceDetails) GoString added in v1.14.25 

func (s RedshiftInstanceDetails) GoString() string

GoString returns the string representation

func (*RedshiftInstanceDetails) SetCurrentGeneration added in v1.14.25 

func (s *RedshiftInstanceDetails) SetCurrentGeneration(v bool) *RedshiftInstanceDetails

SetCurrentGeneration sets the CurrentGeneration field's value.

func (*RedshiftInstanceDetails) SetFamily added in v1.14.25 

func (s *RedshiftInstanceDetails) SetFamily(v string) *RedshiftInstanceDetails

SetFamily sets the Family field's value.

func (*RedshiftInstanceDetails) SetNodeType added in v1.14.25 

func (s *RedshiftInstanceDetails) SetNodeType(v string) *RedshiftInstanceDetails

SetNodeType sets the NodeType field's value.

func (*RedshiftInstanceDetails) SetRegion added in v1.14.25 

func (s *RedshiftInstanceDetails) SetRegion(v string) *RedshiftInstanceDetails

SetRegion sets the Region field's value.

func (*RedshiftInstanceDetails) SetSizeFlexEligible added in v1.14.25 

func (s *RedshiftInstanceDetails) SetSizeFlexEligible(v bool) *RedshiftInstanceDetails

SetSizeFlexEligible sets the SizeFlexEligible field's value.

func (RedshiftInstanceDetails) String added in v1.14.25 

func (s RedshiftInstanceDetails) String() string

String returns the string representation

type ReservationAggregates 

type ReservationAggregates struct {

	// The monthly cost of your RI, amortized over the RI period.
	AmortizedRecurringFee *string `type:"string"`

	// The upfront cost of your RI, amortized over the RI period.
	AmortizedUpfrontFee *string `type:"string"`

	// How much you saved due to purchasing and utilizing RIs. AWS calculates this
	// by subtracting TotalAmortizedFee from OnDemandCostOfRIHoursUsed.
	NetRISavings *string `type:"string"`

	// How much your RIs would cost if charged On-Demand rates.
	OnDemandCostOfRIHoursUsed *string `type:"string"`

	// How many RI hours that you purchased.
	PurchasedHours *string `type:"string"`

	// The total number of RI hours that you used.
	TotalActualHours *string `type:"string"`

	// The total cost of your RI, amortized over the RI period.
	TotalAmortizedFee *string `type:"string"`

	// How much you could save if you use your entire reservation.
	TotalPotentialRISavings *string `type:"string"`

	// The number of RI hours that you didn't use.
	UnusedHours *string `type:"string"`

	// The percentage of RI time that you used.
	UtilizationPercentage *string `type:"string"`
	// contains filtered or unexported fields
}

The aggregated numbers for your Reserved Instance (RI) usage.

func (ReservationAggregates) GoString 

func (s ReservationAggregates) GoString() string

GoString returns the string representation

func (*ReservationAggregates) SetAmortizedRecurringFee added in v1.14.1 

func (s *ReservationAggregates) SetAmortizedRecurringFee(v string) *ReservationAggregates

SetAmortizedRecurringFee sets the AmortizedRecurringFee field's value.

func (*ReservationAggregates) SetAmortizedUpfrontFee added in v1.14.1 

func (s *ReservationAggregates) SetAmortizedUpfrontFee(v string) *ReservationAggregates

SetAmortizedUpfrontFee sets the AmortizedUpfrontFee field's value.

func (*ReservationAggregates) SetNetRISavings added in v1.14.1 

func (s *ReservationAggregates) SetNetRISavings(v string) *ReservationAggregates

SetNetRISavings sets the NetRISavings field's value.

func (*ReservationAggregates) SetOnDemandCostOfRIHoursUsed added in v1.14.1 

func (s *ReservationAggregates) SetOnDemandCostOfRIHoursUsed(v string) *ReservationAggregates

SetOnDemandCostOfRIHoursUsed sets the OnDemandCostOfRIHoursUsed field's value.

func (*ReservationAggregates) SetPurchasedHours 

func (s *ReservationAggregates) SetPurchasedHours(v string) *ReservationAggregates

SetPurchasedHours sets the PurchasedHours field's value.

func (*ReservationAggregates) SetTotalActualHours 

func (s *ReservationAggregates) SetTotalActualHours(v string) *ReservationAggregates

SetTotalActualHours sets the TotalActualHours field's value.

func (*ReservationAggregates) SetTotalAmortizedFee added in v1.14.1 

func (s *ReservationAggregates) SetTotalAmortizedFee(v string) *ReservationAggregates

SetTotalAmortizedFee sets the TotalAmortizedFee field's value.

func (*ReservationAggregates) SetTotalPotentialRISavings added in v1.14.1 

func (s *ReservationAggregates) SetTotalPotentialRISavings(v string) *ReservationAggregates

SetTotalPotentialRISavings sets the TotalPotentialRISavings field's value.

func (*ReservationAggregates) SetUnusedHours 

func (s *ReservationAggregates) SetUnusedHours(v string) *ReservationAggregates

SetUnusedHours sets the UnusedHours field's value.

func (*ReservationAggregates) SetUtilizationPercentage 

func (s *ReservationAggregates) SetUtilizationPercentage(v string) *ReservationAggregates

SetUtilizationPercentage sets the UtilizationPercentage field's value.

func (ReservationAggregates) String 

func (s ReservationAggregates) String() string

String returns the string representation

type ReservationCoverageGroup added in v1.13.3 

type ReservationCoverageGroup struct {

	// The attributes for this group of reservations.
	Attributes map[string]*string `type:"map"`

	// How much instance usage this group of reservations covered.
	Coverage *Coverage `type:"structure"`
	// contains filtered or unexported fields
}

A group of reservations that share a set of attributes.

func (ReservationCoverageGroup) GoString added in v1.13.3 

func (s ReservationCoverageGroup) GoString() string

GoString returns the string representation

func (*ReservationCoverageGroup) SetAttributes added in v1.13.3 

func (s *ReservationCoverageGroup) SetAttributes(v map[string]*string) *ReservationCoverageGroup

SetAttributes sets the Attributes field's value.

func (*ReservationCoverageGroup) SetCoverage added in v1.13.3 

func (s *ReservationCoverageGroup) SetCoverage(v *Coverage) *ReservationCoverageGroup

SetCoverage sets the Coverage field's value.

func (ReservationCoverageGroup) String added in v1.13.3 

func (s ReservationCoverageGroup) String() string

String returns the string representation

type ReservationPurchaseRecommendation added in v1.13.17 

type ReservationPurchaseRecommendation struct {

	// The account scope that AWS recommends that you purchase this instance for.
	// For example, you can purchase this reservation for an entire organization
	// in AWS Organizations.
	AccountScope *string `type:"string" enum:"AccountScope"`

	// How many days of previous usage that AWS considers when making this recommendation.
	LookbackPeriodInDays *string `type:"string" enum:"LookbackPeriodInDays"`

	// The payment option for the reservation. For example, AllUpfront or NoUpfront.
	PaymentOption *string `type:"string" enum:"PaymentOption"`

	// Details about the recommended purchases.
	RecommendationDetails []*ReservationPurchaseRecommendationDetail `type:"list"`

	// A summary about the recommended purchase.
	RecommendationSummary *ReservationPurchaseRecommendationSummary `type:"structure"`

	// Hardware specifications for the service that you want recommendations for.
	ServiceSpecification *ServiceSpecification `type:"structure"`

	// The term of the reservation that you want recommendations for, in years.
	TermInYears *string `type:"string" enum:"TermInYears"`
	// contains filtered or unexported fields
}

A specific reservation that AWS recommends for purchase.

func (ReservationPurchaseRecommendation) GoString added in v1.13.17 

func (s ReservationPurchaseRecommendation) GoString() string

GoString returns the string representation

func (*ReservationPurchaseRecommendation) SetAccountScope added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetAccountScope(v string) *ReservationPurchaseRecommendation

SetAccountScope sets the AccountScope field's value.

func (*ReservationPurchaseRecommendation) SetLookbackPeriodInDays added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetLookbackPeriodInDays(v string) *ReservationPurchaseRecommendation

SetLookbackPeriodInDays sets the LookbackPeriodInDays field's value.

func (*ReservationPurchaseRecommendation) SetPaymentOption added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetPaymentOption(v string) *ReservationPurchaseRecommendation

SetPaymentOption sets the PaymentOption field's value.

func (*ReservationPurchaseRecommendation) SetRecommendationDetails added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetRecommendationDetails(v []*ReservationPurchaseRecommendationDetail) *ReservationPurchaseRecommendation

SetRecommendationDetails sets the RecommendationDetails field's value.

func (*ReservationPurchaseRecommendation) SetRecommendationSummary added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetRecommendationSummary(v *ReservationPurchaseRecommendationSummary) *ReservationPurchaseRecommendation

SetRecommendationSummary sets the RecommendationSummary field's value.

func (*ReservationPurchaseRecommendation) SetServiceSpecification added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetServiceSpecification(v *ServiceSpecification) *ReservationPurchaseRecommendation

SetServiceSpecification sets the ServiceSpecification field's value.

func (*ReservationPurchaseRecommendation) SetTermInYears added in v1.13.17 

func (s *ReservationPurchaseRecommendation) SetTermInYears(v string) *ReservationPurchaseRecommendation

SetTermInYears sets the TermInYears field's value.

func (ReservationPurchaseRecommendation) String added in v1.13.17 

func (s ReservationPurchaseRecommendation) String() string

String returns the string representation

type ReservationPurchaseRecommendationDetail added in v1.13.17 

type ReservationPurchaseRecommendationDetail struct {

	// The average number of normalized units that you used in an hour during the
	// historical period. AWS uses this to calculate your recommended reservation
	// purchases.
	AverageNormalizedUnitsUsedPerHour *string `type:"string"`

	// The average number of instances that you used in an hour during the historical
	// period. AWS uses this to calculate your recommended reservation purchases.
	AverageNumberOfInstancesUsedPerHour *string `type:"string"`

	// The average utilization of your instances. AWS uses this to calculate your
	// recommended reservation purchases.
	AverageUtilization *string `type:"string"`

	// The currency code that AWS used to calculate the costs for this instance.
	CurrencyCode *string `type:"string"`

	// How long AWS estimates that it takes for this instance to start saving you
	// money, in months.
	EstimatedBreakEvenInMonths *string `type:"string"`

	// How much AWS estimates that you spend on On-Demand Instances in a month.
	EstimatedMonthlyOnDemandCost *string `type:"string"`

	// How much AWS estimates that this specific recommendation could save you in
	// a month.
	EstimatedMonthlySavingsAmount *string `type:"string"`

	// How much AWS estimates that this specific recommendation could save you in
	// a month, as a percentage of your overall costs.
	EstimatedMonthlySavingsPercentage *string `type:"string"`

	// How much AWS estimates that you would have spent for all usage during the
	// specified historical period if you had had a reservation.
	EstimatedReservationCostForLookbackPeriod *string `type:"string"`

	// Details about the instances that AWS recommends that you purchase.
	InstanceDetails *InstanceDetails `type:"structure"`

	// The maximum number of normalized units that you used in an hour during the
	// historical period. AWS uses this to calculate your recommended reservation
	// purchases.
	MaximumNormalizedUnitsUsedPerHour *string `type:"string"`

	// The maximum number of instances that you used in an hour during the historical
	// period. AWS uses this to calculate your recommended reservation purchases.
	MaximumNumberOfInstancesUsedPerHour *string `type:"string"`

	// The minimum number of hours that you used in an hour during the historical
	// period. AWS uses this to calculate your recommended reservation purchases.
	MinimumNormalizedUnitsUsedPerHour *string `type:"string"`

	// The minimum number of instances that you used in an hour during the historical
	// period. AWS uses this to calculate your recommended reservation purchases.
	MinimumNumberOfInstancesUsedPerHour *string `type:"string"`

	// The number of normalized units that AWS recommends that you purchase.
	RecommendedNormalizedUnitsToPurchase *string `type:"string"`

	// The number of instances that AWS recommends that you purchase.
	RecommendedNumberOfInstancesToPurchase *string `type:"string"`

	// How much purchasing this instance costs you on a monthly basis.
	RecurringStandardMonthlyCost *string `type:"string"`

	// How much purchasing this instance costs you upfront.
	UpfrontCost *string `type:"string"`
	// contains filtered or unexported fields
}

Details about your recommended reservation purchase.

func (ReservationPurchaseRecommendationDetail) GoString added in v1.13.17 

func (s ReservationPurchaseRecommendationDetail) GoString() string

GoString returns the string representation

func (*ReservationPurchaseRecommendationDetail) SetAverageNormalizedUnitsUsedPerHour added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetAverageNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail

SetAverageNormalizedUnitsUsedPerHour sets the AverageNormalizedUnitsUsedPerHour field's value.

func (*ReservationPurchaseRecommendationDetail) SetAverageNumberOfInstancesUsedPerHour added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetAverageNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail

SetAverageNumberOfInstancesUsedPerHour sets the AverageNumberOfInstancesUsedPerHour field's value.

func (*ReservationPurchaseRecommendationDetail) SetAverageUtilization added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetAverageUtilization(v string) *ReservationPurchaseRecommendationDetail

SetAverageUtilization sets the AverageUtilization field's value.

func (*ReservationPurchaseRecommendationDetail) SetCurrencyCode added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetCurrencyCode(v string) *ReservationPurchaseRecommendationDetail

SetCurrencyCode sets the CurrencyCode field's value.

func (*ReservationPurchaseRecommendationDetail) SetEstimatedBreakEvenInMonths added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetEstimatedBreakEvenInMonths(v string) *ReservationPurchaseRecommendationDetail

SetEstimatedBreakEvenInMonths sets the EstimatedBreakEvenInMonths field's value.

func (*ReservationPurchaseRecommendationDetail) SetEstimatedMonthlyOnDemandCost added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlyOnDemandCost(v string) *ReservationPurchaseRecommendationDetail

SetEstimatedMonthlyOnDemandCost sets the EstimatedMonthlyOnDemandCost field's value.

func (*ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsAmount added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsAmount(v string) *ReservationPurchaseRecommendationDetail

SetEstimatedMonthlySavingsAmount sets the EstimatedMonthlySavingsAmount field's value.

func (*ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsPercentage added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsPercentage(v string) *ReservationPurchaseRecommendationDetail

SetEstimatedMonthlySavingsPercentage sets the EstimatedMonthlySavingsPercentage field's value.

func (*ReservationPurchaseRecommendationDetail) SetEstimatedReservationCostForLookbackPeriod added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetEstimatedReservationCostForLookbackPeriod(v string) *ReservationPurchaseRecommendationDetail

SetEstimatedReservationCostForLookbackPeriod sets the EstimatedReservationCostForLookbackPeriod field's value.

func (*ReservationPurchaseRecommendationDetail) SetInstanceDetails added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetInstanceDetails(v *InstanceDetails) *ReservationPurchaseRecommendationDetail

SetInstanceDetails sets the InstanceDetails field's value.

func (*ReservationPurchaseRecommendationDetail) SetMaximumNormalizedUnitsUsedPerHour added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetMaximumNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail

SetMaximumNormalizedUnitsUsedPerHour sets the MaximumNormalizedUnitsUsedPerHour field's value.

func (*ReservationPurchaseRecommendationDetail) SetMaximumNumberOfInstancesUsedPerHour added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetMaximumNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail

SetMaximumNumberOfInstancesUsedPerHour sets the MaximumNumberOfInstancesUsedPerHour field's value.

func (*ReservationPurchaseRecommendationDetail) SetMinimumNormalizedUnitsUsedPerHour added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetMinimumNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail

SetMinimumNormalizedUnitsUsedPerHour sets the MinimumNormalizedUnitsUsedPerHour field's value.

func (*ReservationPurchaseRecommendationDetail) SetMinimumNumberOfInstancesUsedPerHour added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetMinimumNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail

SetMinimumNumberOfInstancesUsedPerHour sets the MinimumNumberOfInstancesUsedPerHour field's value.

func (*ReservationPurchaseRecommendationDetail) SetRecommendedNormalizedUnitsToPurchase added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetRecommendedNormalizedUnitsToPurchase(v string) *ReservationPurchaseRecommendationDetail

SetRecommendedNormalizedUnitsToPurchase sets the RecommendedNormalizedUnitsToPurchase field's value.

func (*ReservationPurchaseRecommendationDetail) SetRecommendedNumberOfInstancesToPurchase added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetRecommendedNumberOfInstancesToPurchase(v string) *ReservationPurchaseRecommendationDetail

SetRecommendedNumberOfInstancesToPurchase sets the RecommendedNumberOfInstancesToPurchase field's value.

func (*ReservationPurchaseRecommendationDetail) SetRecurringStandardMonthlyCost added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetRecurringStandardMonthlyCost(v string) *ReservationPurchaseRecommendationDetail

SetRecurringStandardMonthlyCost sets the RecurringStandardMonthlyCost field's value.

func (*ReservationPurchaseRecommendationDetail) SetUpfrontCost added in v1.13.17 

func (s *ReservationPurchaseRecommendationDetail) SetUpfrontCost(v string) *ReservationPurchaseRecommendationDetail

SetUpfrontCost sets the UpfrontCost field's value.

func (ReservationPurchaseRecommendationDetail) String added in v1.13.17 

func (s ReservationPurchaseRecommendationDetail) String() string

String returns the string representation

type ReservationPurchaseRecommendationMetadata added in v1.13.17 

type ReservationPurchaseRecommendationMetadata struct {

	// The time stamp for when AWS made this recommendation.
	GenerationTimestamp *string `type:"string"`

	// The ID for this specific recommendation.
	RecommendationId *string `type:"string"`
	// contains filtered or unexported fields
}

Information about this specific recommendation, such as the time stamp for when AWS made a specific recommendation.

func (ReservationPurchaseRecommendationMetadata) GoString added in v1.13.17 

func (s ReservationPurchaseRecommendationMetadata) GoString() string

GoString returns the string representation

func (*ReservationPurchaseRecommendationMetadata) SetGenerationTimestamp added in v1.13.17 

func (s *ReservationPurchaseRecommendationMetadata) SetGenerationTimestamp(v string) *ReservationPurchaseRecommendationMetadata

SetGenerationTimestamp sets the GenerationTimestamp field's value.

func (*ReservationPurchaseRecommendationMetadata) SetRecommendationId added in v1.13.17 

func (s *ReservationPurchaseRecommendationMetadata) SetRecommendationId(v string) *ReservationPurchaseRecommendationMetadata

SetRecommendationId sets the RecommendationId field's value.

func (ReservationPurchaseRecommendationMetadata) String added in v1.13.17 

func (s ReservationPurchaseRecommendationMetadata) String() string

String returns the string representation

type ReservationPurchaseRecommendationSummary added in v1.13.17 

type ReservationPurchaseRecommendationSummary struct {

	// The currency code used for this recommendation.
	CurrencyCode *string `type:"string"`

	// The total amount that AWS estimates that this recommendation could save you
	// in a month.
	TotalEstimatedMonthlySavingsAmount *string `type:"string"`

	// The total amount that AWS estimates that this recommendation could save you
	// in a month, as a percentage of your costs.
	TotalEstimatedMonthlySavingsPercentage *string `type:"string"`
	// contains filtered or unexported fields
}

A summary about this recommendation, such as the currency code, the amount that AWS estimates that you could save, and the total amount of reservation to purchase.

func (ReservationPurchaseRecommendationSummary) GoString added in v1.13.17 

func (s ReservationPurchaseRecommendationSummary) GoString() string

GoString returns the string representation

func (*ReservationPurchaseRecommendationSummary) SetCurrencyCode added in v1.13.17 

func (s *ReservationPurchaseRecommendationSummary) SetCurrencyCode(v string) *ReservationPurchaseRecommendationSummary

SetCurrencyCode sets the CurrencyCode field's value.

func (*ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsAmount added in v1.13.17 

func (s *ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsAmount(v string) *ReservationPurchaseRecommendationSummary

SetTotalEstimatedMonthlySavingsAmount sets the TotalEstimatedMonthlySavingsAmount field's value.

func (*ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsPercentage added in v1.13.17 

func (s *ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsPercentage(v string) *ReservationPurchaseRecommendationSummary

SetTotalEstimatedMonthlySavingsPercentage sets the TotalEstimatedMonthlySavingsPercentage field's value.

func (ReservationPurchaseRecommendationSummary) String added in v1.13.17 

func (s ReservationPurchaseRecommendationSummary) String() string

String returns the string representation

type ReservationUtilizationGroup 

type ReservationUtilizationGroup struct {

	// The attributes for this group of RIs.
	Attributes map[string]*string `type:"map"`

	// The key for a specific RI attribute.
	Key *string `type:"string"`

	// How much you used this group of RIs.
	Utilization *ReservationAggregates `type:"structure"`

	// The value of a specific RI attribute.
	Value *string `type:"string"`
	// contains filtered or unexported fields
}

A group of Reserved Instances (RIs) that share a set of attributes.

func (ReservationUtilizationGroup) GoString 

func (s ReservationUtilizationGroup) GoString() string

GoString returns the string representation

func (*ReservationUtilizationGroup) SetAttributes 

func (s *ReservationUtilizationGroup) SetAttributes(v map[string]*string) *ReservationUtilizationGroup

SetAttributes sets the Attributes field's value.

func (*ReservationUtilizationGroup) SetKey 

func (s *ReservationUtilizationGroup) SetKey(v string) *ReservationUtilizationGroup

SetKey sets the Key field's value.

func (*ReservationUtilizationGroup) SetUtilization 

func (s *ReservationUtilizationGroup) SetUtilization(v *ReservationAggregates) *ReservationUtilizationGroup

SetUtilization sets the Utilization field's value.

func (*ReservationUtilizationGroup) SetValue 

func (s *ReservationUtilizationGroup) SetValue(v string) *ReservationUtilizationGroup

SetValue sets the Value field's value.

func (ReservationUtilizationGroup) String 

func (s ReservationUtilizationGroup) String() string

String returns the string representation

type ResultByTime 

type ResultByTime struct {

	// Whether this result is estimated.
	Estimated *bool `type:"boolean"`

	// The groups that are included in this time period.
	Groups []*Group `type:"list"`

	// The time period covered by a result.
	TimePeriod *DateInterval `type:"structure"`

	// The total amount of cost or usage accrued during the time period.
	Total map[string]*MetricValue `type:"map"`
	// contains filtered or unexported fields
}

The result that is associated with a time period.

func (ResultByTime) GoString 

func (s ResultByTime) GoString() string

GoString returns the string representation

func (*ResultByTime) SetEstimated 

func (s *ResultByTime) SetEstimated(v bool) *ResultByTime

SetEstimated sets the Estimated field's value.

func (*ResultByTime) SetGroups 

func (s *ResultByTime) SetGroups(v []*Group) *ResultByTime

SetGroups sets the Groups field's value.

func (*ResultByTime) SetTimePeriod 

func (s *ResultByTime) SetTimePeriod(v *DateInterval) *ResultByTime

SetTimePeriod sets the TimePeriod field's value.

func (*ResultByTime) SetTotal 

func (s *ResultByTime) SetTotal(v map[string]*MetricValue) *ResultByTime

SetTotal sets the Total field's value.

func (ResultByTime) String 

func (s ResultByTime) String() string

String returns the string representation

type ServiceSpecification added in v1.13.17 

type ServiceSpecification struct {

	// The EC2 hardware specifications that you want AWS to provide recommendations
	// for.
	EC2Specification *EC2Specification `type:"structure"`
	// contains filtered or unexported fields
}

Hardware specifications for the service that you want recommendations for.

func (ServiceSpecification) GoString added in v1.13.17 

func (s ServiceSpecification) GoString() string

GoString returns the string representation

func (*ServiceSpecification) SetEC2Specification added in v1.13.17 

func (s *ServiceSpecification) SetEC2Specification(v *EC2Specification) *ServiceSpecification

SetEC2Specification sets the EC2Specification field's value.

func (ServiceSpecification) String added in v1.13.17 

func (s ServiceSpecification) String() string

String returns the string representation

type TagValues 

type TagValues struct {

	// The key for a tag.
	Key *string `type:"string"`

	// The specific value of a tag.
	Values []*string `type:"list"`
	// contains filtered or unexported fields
}

The values that are available for a tag.

func (TagValues) GoString 

func (s TagValues) GoString() string

GoString returns the string representation

func (*TagValues) SetKey 

func (s *TagValues) SetKey(v string) *TagValues

SetKey sets the Key field's value.

func (*TagValues) SetValues 

func (s *TagValues) SetValues(v []*string) *TagValues

SetValues sets the Values field's value.

func (TagValues) String 

func (s TagValues) String() string

String returns the string representation

type UtilizationByTime 

type UtilizationByTime struct {

	// The groups that are included in this utilization result.
	Groups []*ReservationUtilizationGroup `type:"list"`

	// The period of time over which this utilization was used.
	TimePeriod *DateInterval `type:"structure"`

	// The total number of RI hours that were used.
	Total *ReservationAggregates `type:"structure"`
	// contains filtered or unexported fields
}

The amount of utilization, in hours.

func (UtilizationByTime) GoString 

func (s UtilizationByTime) GoString() string

GoString returns the string representation

func (*UtilizationByTime) SetGroups 

func (s *UtilizationByTime) SetGroups(v []*ReservationUtilizationGroup) *UtilizationByTime

SetGroups sets the Groups field's value.

func (*UtilizationByTime) SetTimePeriod 

func (s *UtilizationByTime) SetTimePeriod(v *DateInterval) *UtilizationByTime

SetTimePeriod sets the TimePeriod field's value.

func (*UtilizationByTime) SetTotal 

func (s *UtilizationByTime) SetTotal(v *ReservationAggregates) *UtilizationByTime

SetTotal sets the Total field's value.

func (UtilizationByTime) String 

func (s UtilizationByTime) String() string

String returns the string representation

Source Files

View all Source files

Directories

Path Synopsis
Package costexploreriface provides an interface to enable mocking the AWS Cost Explorer Service service client for testing your code.
 Package costexploreriface provides an interface to enable mocking the AWS Cost Explorer Service service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.