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
- type CostExplorer
- func (c *CostExplorer) GetCostAndUsage(input *GetCostAndUsageInput) (*GetCostAndUsageOutput, error)
- func (c *CostExplorer) GetCostAndUsageRequest(input *GetCostAndUsageInput) (req *request.Request, output *GetCostAndUsageOutput)
- func (c *CostExplorer) GetCostAndUsageWithContext(ctx aws.Context, input *GetCostAndUsageInput, opts ...request.Option) (*GetCostAndUsageOutput, error)
- func (c *CostExplorer) GetDimensionValues(input *GetDimensionValuesInput) (*GetDimensionValuesOutput, error)
- func (c *CostExplorer) GetDimensionValuesRequest(input *GetDimensionValuesInput) (req *request.Request, output *GetDimensionValuesOutput)
- func (c *CostExplorer) GetDimensionValuesWithContext(ctx aws.Context, input *GetDimensionValuesInput, opts ...request.Option) (*GetDimensionValuesOutput, error)
- func (c *CostExplorer) GetReservationCoverage(input *GetReservationCoverageInput) (*GetReservationCoverageOutput, error)
- func (c *CostExplorer) GetReservationCoverageRequest(input *GetReservationCoverageInput) (req *request.Request, output *GetReservationCoverageOutput)
- func (c *CostExplorer) GetReservationCoverageWithContext(ctx aws.Context, input *GetReservationCoverageInput, opts ...request.Option) (*GetReservationCoverageOutput, error)
- func (c *CostExplorer) GetReservationPurchaseRecommendation(input *GetReservationPurchaseRecommendationInput) (*GetReservationPurchaseRecommendationOutput, error)
- func (c *CostExplorer) GetReservationPurchaseRecommendationRequest(input *GetReservationPurchaseRecommendationInput) (req *request.Request, output *GetReservationPurchaseRecommendationOutput)
- func (c *CostExplorer) GetReservationPurchaseRecommendationWithContext(ctx aws.Context, input *GetReservationPurchaseRecommendationInput, ...) (*GetReservationPurchaseRecommendationOutput, error)
- func (c *CostExplorer) GetReservationUtilization(input *GetReservationUtilizationInput) (*GetReservationUtilizationOutput, error)
- func (c *CostExplorer) GetReservationUtilizationRequest(input *GetReservationUtilizationInput) (req *request.Request, output *GetReservationUtilizationOutput)
- func (c *CostExplorer) GetReservationUtilizationWithContext(ctx aws.Context, input *GetReservationUtilizationInput, opts ...request.Option) (*GetReservationUtilizationOutput, error)
- func (c *CostExplorer) GetTags(input *GetTagsInput) (*GetTagsOutput, error)
- func (c *CostExplorer) GetTagsRequest(input *GetTagsInput) (req *request.Request, output *GetTagsOutput)
- func (c *CostExplorer) GetTagsWithContext(ctx aws.Context, input *GetTagsInput, opts ...request.Option) (*GetTagsOutput, error)
- type Coverage
- type CoverageByTime
- type CoverageHours
- func (s CoverageHours) GoString() string
- func (s *CoverageHours) SetCoverageHoursPercentage(v string) *CoverageHours
- func (s *CoverageHours) SetOnDemandHours(v string) *CoverageHours
- func (s *CoverageHours) SetReservedHours(v string) *CoverageHours
- func (s *CoverageHours) SetTotalRunningHours(v string) *CoverageHours
- func (s CoverageHours) String() string
- type DateInterval
- type DimensionValues
- type DimensionValuesWithAttributes
- func (s DimensionValuesWithAttributes) GoString() string
- func (s *DimensionValuesWithAttributes) SetAttributes(v map[string]*string) *DimensionValuesWithAttributes
- func (s *DimensionValuesWithAttributes) SetValue(v string) *DimensionValuesWithAttributes
- func (s DimensionValuesWithAttributes) String() string
- type EC2InstanceDetails
- func (s EC2InstanceDetails) GoString() string
- func (s *EC2InstanceDetails) SetAvailabilityZone(v string) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetCurrentGeneration(v bool) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetFamily(v string) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetInstanceType(v string) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetPlatform(v string) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetRegion(v string) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetSizeFlexEligible(v bool) *EC2InstanceDetails
- func (s *EC2InstanceDetails) SetTenancy(v string) *EC2InstanceDetails
- func (s EC2InstanceDetails) String() string
- type EC2Specification
- type Expression
- func (s Expression) GoString() string
- func (s *Expression) SetAnd(v []*Expression) *Expression
- func (s *Expression) SetDimensions(v *DimensionValues) *Expression
- func (s *Expression) SetNot(v *Expression) *Expression
- func (s *Expression) SetOr(v []*Expression) *Expression
- func (s *Expression) SetTags(v *TagValues) *Expression
- func (s Expression) String() string
- type GetCostAndUsageInput
- func (s GetCostAndUsageInput) GoString() string
- func (s *GetCostAndUsageInput) SetFilter(v *Expression) *GetCostAndUsageInput
- func (s *GetCostAndUsageInput) SetGranularity(v string) *GetCostAndUsageInput
- func (s *GetCostAndUsageInput) SetGroupBy(v []*GroupDefinition) *GetCostAndUsageInput
- func (s *GetCostAndUsageInput) SetMetrics(v []*string) *GetCostAndUsageInput
- func (s *GetCostAndUsageInput) SetNextPageToken(v string) *GetCostAndUsageInput
- func (s *GetCostAndUsageInput) SetTimePeriod(v *DateInterval) *GetCostAndUsageInput
- func (s GetCostAndUsageInput) String() string
- func (s *GetCostAndUsageInput) Validate() error
- type GetCostAndUsageOutput
- func (s GetCostAndUsageOutput) GoString() string
- func (s *GetCostAndUsageOutput) SetGroupDefinitions(v []*GroupDefinition) *GetCostAndUsageOutput
- func (s *GetCostAndUsageOutput) SetNextPageToken(v string) *GetCostAndUsageOutput
- func (s *GetCostAndUsageOutput) SetResultsByTime(v []*ResultByTime) *GetCostAndUsageOutput
- func (s GetCostAndUsageOutput) String() string
- type GetDimensionValuesInput
- func (s GetDimensionValuesInput) GoString() string
- func (s *GetDimensionValuesInput) SetContext(v string) *GetDimensionValuesInput
- func (s *GetDimensionValuesInput) SetDimension(v string) *GetDimensionValuesInput
- func (s *GetDimensionValuesInput) SetNextPageToken(v string) *GetDimensionValuesInput
- func (s *GetDimensionValuesInput) SetSearchString(v string) *GetDimensionValuesInput
- func (s *GetDimensionValuesInput) SetTimePeriod(v *DateInterval) *GetDimensionValuesInput
- func (s GetDimensionValuesInput) String() string
- func (s *GetDimensionValuesInput) Validate() error
- type GetDimensionValuesOutput
- func (s GetDimensionValuesOutput) GoString() string
- func (s *GetDimensionValuesOutput) SetDimensionValues(v []*DimensionValuesWithAttributes) *GetDimensionValuesOutput
- func (s *GetDimensionValuesOutput) SetNextPageToken(v string) *GetDimensionValuesOutput
- func (s *GetDimensionValuesOutput) SetReturnSize(v int64) *GetDimensionValuesOutput
- func (s *GetDimensionValuesOutput) SetTotalSize(v int64) *GetDimensionValuesOutput
- func (s GetDimensionValuesOutput) String() string
- type GetReservationCoverageInput
- func (s GetReservationCoverageInput) GoString() string
- func (s *GetReservationCoverageInput) SetFilter(v *Expression) *GetReservationCoverageInput
- func (s *GetReservationCoverageInput) SetGranularity(v string) *GetReservationCoverageInput
- func (s *GetReservationCoverageInput) SetGroupBy(v []*GroupDefinition) *GetReservationCoverageInput
- func (s *GetReservationCoverageInput) SetNextPageToken(v string) *GetReservationCoverageInput
- func (s *GetReservationCoverageInput) SetTimePeriod(v *DateInterval) *GetReservationCoverageInput
- func (s GetReservationCoverageInput) String() string
- func (s *GetReservationCoverageInput) Validate() error
- type GetReservationCoverageOutput
- func (s GetReservationCoverageOutput) GoString() string
- func (s *GetReservationCoverageOutput) SetCoveragesByTime(v []*CoverageByTime) *GetReservationCoverageOutput
- func (s *GetReservationCoverageOutput) SetNextPageToken(v string) *GetReservationCoverageOutput
- func (s *GetReservationCoverageOutput) SetTotal(v *Coverage) *GetReservationCoverageOutput
- func (s GetReservationCoverageOutput) String() string
- type GetReservationPurchaseRecommendationInput
- func (s GetReservationPurchaseRecommendationInput) GoString() string
- func (s *GetReservationPurchaseRecommendationInput) SetAccountId(v string) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetAccountScope(v string) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetLookbackPeriodInDays(v string) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetNextPageToken(v string) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetPageSize(v int64) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetPaymentOption(v string) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetService(v string) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetServiceSpecification(v *ServiceSpecification) *GetReservationPurchaseRecommendationInput
- func (s *GetReservationPurchaseRecommendationInput) SetTermInYears(v string) *GetReservationPurchaseRecommendationInput
- func (s GetReservationPurchaseRecommendationInput) String() string
- func (s *GetReservationPurchaseRecommendationInput) Validate() error
- type GetReservationPurchaseRecommendationOutput
- func (s GetReservationPurchaseRecommendationOutput) GoString() string
- func (s *GetReservationPurchaseRecommendationOutput) SetMetadata(v *ReservationPurchaseRecommendationMetadata) *GetReservationPurchaseRecommendationOutput
- func (s *GetReservationPurchaseRecommendationOutput) SetNextPageToken(v string) *GetReservationPurchaseRecommendationOutput
- func (s *GetReservationPurchaseRecommendationOutput) SetRecommendations(v []*ReservationPurchaseRecommendation) *GetReservationPurchaseRecommendationOutput
- func (s GetReservationPurchaseRecommendationOutput) String() string
- type GetReservationUtilizationInput
- func (s GetReservationUtilizationInput) GoString() string
- func (s *GetReservationUtilizationInput) SetFilter(v *Expression) *GetReservationUtilizationInput
- func (s *GetReservationUtilizationInput) SetGranularity(v string) *GetReservationUtilizationInput
- func (s *GetReservationUtilizationInput) SetGroupBy(v []*GroupDefinition) *GetReservationUtilizationInput
- func (s *GetReservationUtilizationInput) SetNextPageToken(v string) *GetReservationUtilizationInput
- func (s *GetReservationUtilizationInput) SetTimePeriod(v *DateInterval) *GetReservationUtilizationInput
- func (s GetReservationUtilizationInput) String() string
- func (s *GetReservationUtilizationInput) Validate() error
- type GetReservationUtilizationOutput
- func (s GetReservationUtilizationOutput) GoString() string
- func (s *GetReservationUtilizationOutput) SetNextPageToken(v string) *GetReservationUtilizationOutput
- func (s *GetReservationUtilizationOutput) SetTotal(v *ReservationAggregates) *GetReservationUtilizationOutput
- func (s *GetReservationUtilizationOutput) SetUtilizationsByTime(v []*UtilizationByTime) *GetReservationUtilizationOutput
- func (s GetReservationUtilizationOutput) String() string
- type GetTagsInput
- func (s GetTagsInput) GoString() string
- func (s *GetTagsInput) SetNextPageToken(v string) *GetTagsInput
- func (s *GetTagsInput) SetSearchString(v string) *GetTagsInput
- func (s *GetTagsInput) SetTagKey(v string) *GetTagsInput
- func (s *GetTagsInput) SetTimePeriod(v *DateInterval) *GetTagsInput
- func (s GetTagsInput) String() string
- func (s *GetTagsInput) Validate() error
- type GetTagsOutput
- func (s GetTagsOutput) GoString() string
- func (s *GetTagsOutput) SetNextPageToken(v string) *GetTagsOutput
- func (s *GetTagsOutput) SetReturnSize(v int64) *GetTagsOutput
- func (s *GetTagsOutput) SetTags(v []*string) *GetTagsOutput
- func (s *GetTagsOutput) SetTotalSize(v int64) *GetTagsOutput
- func (s GetTagsOutput) String() string
- type Group
- type GroupDefinition
- type InstanceDetails
- type MetricValue
- type RDSInstanceDetails
- func (s RDSInstanceDetails) GoString() string
- func (s *RDSInstanceDetails) SetCurrentGeneration(v bool) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetDatabaseEngine(v string) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetDeploymentOption(v string) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetFamily(v string) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetInstanceType(v string) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetLicenseModel(v string) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetRegion(v string) *RDSInstanceDetails
- func (s *RDSInstanceDetails) SetSizeFlexEligible(v bool) *RDSInstanceDetails
- func (s RDSInstanceDetails) String() string
- type ReservationAggregates
- func (s ReservationAggregates) GoString() string
- func (s *ReservationAggregates) SetPurchasedHours(v string) *ReservationAggregates
- func (s *ReservationAggregates) SetTotalActualHours(v string) *ReservationAggregates
- func (s *ReservationAggregates) SetUnusedHours(v string) *ReservationAggregates
- func (s *ReservationAggregates) SetUtilizationPercentage(v string) *ReservationAggregates
- func (s ReservationAggregates) String() string
- type ReservationCoverageGroup
- type ReservationPurchaseRecommendation
- func (s ReservationPurchaseRecommendation) GoString() string
- func (s *ReservationPurchaseRecommendation) SetAccountScope(v string) *ReservationPurchaseRecommendation
- func (s *ReservationPurchaseRecommendation) SetLookbackPeriodInDays(v string) *ReservationPurchaseRecommendation
- func (s *ReservationPurchaseRecommendation) SetPaymentOption(v string) *ReservationPurchaseRecommendation
- func (s *ReservationPurchaseRecommendation) SetRecommendationDetails(v []*ReservationPurchaseRecommendationDetail) *ReservationPurchaseRecommendation
- func (s *ReservationPurchaseRecommendation) SetRecommendationSummary(v *ReservationPurchaseRecommendationSummary) *ReservationPurchaseRecommendation
- func (s *ReservationPurchaseRecommendation) SetServiceSpecification(v *ServiceSpecification) *ReservationPurchaseRecommendation
- func (s *ReservationPurchaseRecommendation) SetTermInYears(v string) *ReservationPurchaseRecommendation
- func (s ReservationPurchaseRecommendation) String() string
- type ReservationPurchaseRecommendationDetail
- func (s ReservationPurchaseRecommendationDetail) GoString() string
- func (s *ReservationPurchaseRecommendationDetail) SetAverageNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetAverageNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetAverageUtilization(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetCurrencyCode(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetEstimatedBreakEvenInMonths(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlyOnDemandCost(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsAmount(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsPercentage(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetEstimatedReservationCostForLookbackPeriod(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetInstanceDetails(v *InstanceDetails) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetMaximumNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetMaximumNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetMinimumNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetMinimumNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetRecommendedNormalizedUnitsToPurchase(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetRecommendedNumberOfInstancesToPurchase(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetRecurringStandardMonthlyCost(v string) *ReservationPurchaseRecommendationDetail
- func (s *ReservationPurchaseRecommendationDetail) SetUpfrontCost(v string) *ReservationPurchaseRecommendationDetail
- func (s ReservationPurchaseRecommendationDetail) String() string
- type ReservationPurchaseRecommendationMetadata
- func (s ReservationPurchaseRecommendationMetadata) GoString() string
- func (s *ReservationPurchaseRecommendationMetadata) SetGenerationTimestamp(v string) *ReservationPurchaseRecommendationMetadata
- func (s *ReservationPurchaseRecommendationMetadata) SetRecommendationId(v string) *ReservationPurchaseRecommendationMetadata
- func (s ReservationPurchaseRecommendationMetadata) String() string
- type ReservationPurchaseRecommendationSummary
- func (s ReservationPurchaseRecommendationSummary) GoString() string
- func (s *ReservationPurchaseRecommendationSummary) SetCurrencyCode(v string) *ReservationPurchaseRecommendationSummary
- func (s *ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsAmount(v string) *ReservationPurchaseRecommendationSummary
- func (s *ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsPercentage(v string) *ReservationPurchaseRecommendationSummary
- func (s ReservationPurchaseRecommendationSummary) String() string
- type ReservationUtilizationGroup
- func (s ReservationUtilizationGroup) GoString() string
- func (s *ReservationUtilizationGroup) SetAttributes(v map[string]*string) *ReservationUtilizationGroup
- func (s *ReservationUtilizationGroup) SetKey(v string) *ReservationUtilizationGroup
- func (s *ReservationUtilizationGroup) SetUtilization(v *ReservationAggregates) *ReservationUtilizationGroup
- func (s *ReservationUtilizationGroup) SetValue(v string) *ReservationUtilizationGroup
- func (s ReservationUtilizationGroup) String() string
- type ResultByTime
- func (s ResultByTime) GoString() string
- func (s *ResultByTime) SetEstimated(v bool) *ResultByTime
- func (s *ResultByTime) SetGroups(v []*Group) *ResultByTime
- func (s *ResultByTime) SetTimePeriod(v *DateInterval) *ResultByTime
- func (s *ResultByTime) SetTotal(v map[string]*MetricValue) *ResultByTime
- func (s ResultByTime) String() string
- type ServiceSpecification
- type TagValues
- type UtilizationByTime
- func (s UtilizationByTime) GoString() string
- func (s *UtilizationByTime) SetGroups(v []*ReservationUtilizationGroup) *UtilizationByTime
- func (s *UtilizationByTime) SetTimePeriod(v *DateInterval) *UtilizationByTime
- func (s *UtilizationByTime) SetTotal(v *ReservationAggregates) *UtilizationByTime
- func (s UtilizationByTime) String() string
Constants ¶
const ( // ContextCostAndUsage is a Context enum value ContextCostAndUsage = "COST_AND_USAGE" // ContextReservations is a Context enum value ContextReservations = "RESERVATIONS" )
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" )
const ( // GranularityDaily is a Granularity enum value GranularityDaily = "DAILY" // GranularityMonthly is a Granularity enum value GranularityMonthly = "MONTHLY" )
const ( // GroupDefinitionTypeDimension is a GroupDefinitionType enum value GroupDefinitionTypeDimension = "DIMENSION" // GroupDefinitionTypeTag is a GroupDefinitionType enum value GroupDefinitionTypeTag = "TAG" )
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" )
const ( // OfferingClassStandard is a OfferingClass enum value OfferingClassStandard = "STANDARD" // OfferingClassConvertible is a OfferingClass enum value OfferingClassConvertible = "CONVERTIBLE" )
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" )
const ( // TermInYearsOneYear is a TermInYears enum value TermInYearsOneYear = "ONE_YEAR" // TermInYearsThreeYears is a TermInYears enum value TermInYearsThreeYears = "THREE_YEARS" )
const ( // ErrCodeBillExpirationException for service response error code // "BillExpirationException". // // The requested report expired. Update the date interval and try again. ErrCodeBillExpirationException = "BillExpirationException" // "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" )
const ( ServiceName = "ce" // Service endpoint prefix API calls made to. EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata. )
Service information constants
const (
// AccountScopePayer is a AccountScope enum value
AccountScopePayer = "PAYER"
)
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type CostExplorer ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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) SetCoverageHours ¶
func (s *Coverage) SetCoverageHours(v *CoverageHours) *Coverage
SetCoverageHours sets the CoverageHours field's value.
type CoverageByTime ¶
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 ¶
func (s CoverageByTime) GoString() string
GoString returns the string representation
func (*CoverageByTime) SetGroups ¶
func (s *CoverageByTime) SetGroups(v []*ReservationCoverageGroup) *CoverageByTime
SetGroups sets the Groups field's value.
func (*CoverageByTime) SetTimePeriod ¶
func (s *CoverageByTime) SetTimePeriod(v *DateInterval) *CoverageByTime
SetTimePeriod sets the TimePeriod field's value.
func (*CoverageByTime) SetTotal ¶
func (s *CoverageByTime) SetTotal(v *Coverage) *CoverageByTime
SetTotal sets the Total field's value.
func (CoverageByTime) String ¶
func (s CoverageByTime) String() string
String returns the string representation
type CoverageHours ¶
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 ¶
func (s CoverageHours) GoString() string
GoString returns the string representation
func (*CoverageHours) SetCoverageHoursPercentage ¶
func (s *CoverageHours) SetCoverageHoursPercentage(v string) *CoverageHours
SetCoverageHoursPercentage sets the CoverageHoursPercentage field's value.
func (*CoverageHours) SetOnDemandHours ¶
func (s *CoverageHours) SetOnDemandHours(v string) *CoverageHours
SetOnDemandHours sets the OnDemandHours field's value.
func (*CoverageHours) SetReservedHours ¶
func (s *CoverageHours) SetReservedHours(v string) *CoverageHours
SetReservedHours sets the ReservedHours field's value.
func (*CoverageHours) SetTotalRunningHours ¶
func (s *CoverageHours) SetTotalRunningHours(v string) *CoverageHours
SetTotalRunningHours sets the TotalRunningHours field's value.
func (CoverageHours) String ¶
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 ¶
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 ¶
func (s EC2InstanceDetails) GoString() string
GoString returns the string representation
func (*EC2InstanceDetails) SetAvailabilityZone ¶
func (s *EC2InstanceDetails) SetAvailabilityZone(v string) *EC2InstanceDetails
SetAvailabilityZone sets the AvailabilityZone field's value.
func (*EC2InstanceDetails) SetCurrentGeneration ¶
func (s *EC2InstanceDetails) SetCurrentGeneration(v bool) *EC2InstanceDetails
SetCurrentGeneration sets the CurrentGeneration field's value.
func (*EC2InstanceDetails) SetFamily ¶
func (s *EC2InstanceDetails) SetFamily(v string) *EC2InstanceDetails
SetFamily sets the Family field's value.
func (*EC2InstanceDetails) SetInstanceType ¶
func (s *EC2InstanceDetails) SetInstanceType(v string) *EC2InstanceDetails
SetInstanceType sets the InstanceType field's value.
func (*EC2InstanceDetails) SetPlatform ¶
func (s *EC2InstanceDetails) SetPlatform(v string) *EC2InstanceDetails
SetPlatform sets the Platform field's value.
func (*EC2InstanceDetails) SetRegion ¶
func (s *EC2InstanceDetails) SetRegion(v string) *EC2InstanceDetails
SetRegion sets the Region field's value.
func (*EC2InstanceDetails) SetSizeFlexEligible ¶
func (s *EC2InstanceDetails) SetSizeFlexEligible(v bool) *EC2InstanceDetails
SetSizeFlexEligible sets the SizeFlexEligible field's value.
func (*EC2InstanceDetails) SetTenancy ¶
func (s *EC2InstanceDetails) SetTenancy(v string) *EC2InstanceDetails
SetTenancy sets the Tenancy field's value.
func (EC2InstanceDetails) String ¶
func (s EC2InstanceDetails) String() string
String returns the string representation
type EC2Specification ¶
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 ¶
func (s EC2Specification) GoString() string
GoString returns the string representation
func (*EC2Specification) SetOfferingClass ¶
func (s *EC2Specification) SetOfferingClass(v string) *EC2Specification
SetOfferingClass sets the OfferingClass field's value.
func (EC2Specification) String ¶
func (s EC2Specification) 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" ] }}, {"Tag": { "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 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 ¶
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. 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 ¶
func (s GetReservationCoverageInput) GoString() string
GoString returns the string representation
func (*GetReservationCoverageInput) SetFilter ¶
func (s *GetReservationCoverageInput) SetFilter(v *Expression) *GetReservationCoverageInput
SetFilter sets the Filter field's value.
func (*GetReservationCoverageInput) SetGranularity ¶
func (s *GetReservationCoverageInput) SetGranularity(v string) *GetReservationCoverageInput
SetGranularity sets the Granularity field's value.
func (*GetReservationCoverageInput) SetGroupBy ¶
func (s *GetReservationCoverageInput) SetGroupBy(v []*GroupDefinition) *GetReservationCoverageInput
SetGroupBy sets the GroupBy field's value.
func (*GetReservationCoverageInput) SetNextPageToken ¶
func (s *GetReservationCoverageInput) SetNextPageToken(v string) *GetReservationCoverageInput
SetNextPageToken sets the NextPageToken field's value.
func (*GetReservationCoverageInput) SetTimePeriod ¶
func (s *GetReservationCoverageInput) SetTimePeriod(v *DateInterval) *GetReservationCoverageInput
SetTimePeriod sets the TimePeriod field's value.
func (GetReservationCoverageInput) String ¶
func (s GetReservationCoverageInput) String() string
String returns the string representation
func (*GetReservationCoverageInput) Validate ¶
func (s *GetReservationCoverageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetReservationCoverageOutput ¶
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 ¶
func (s GetReservationCoverageOutput) GoString() string
GoString returns the string representation
func (*GetReservationCoverageOutput) SetCoveragesByTime ¶
func (s *GetReservationCoverageOutput) SetCoveragesByTime(v []*CoverageByTime) *GetReservationCoverageOutput
SetCoveragesByTime sets the CoveragesByTime field's value.
func (*GetReservationCoverageOutput) SetNextPageToken ¶
func (s *GetReservationCoverageOutput) SetNextPageToken(v string) *GetReservationCoverageOutput
SetNextPageToken sets the NextPageToken field's value.
func (*GetReservationCoverageOutput) SetTotal ¶
func (s *GetReservationCoverageOutput) SetTotal(v *Coverage) *GetReservationCoverageOutput
SetTotal sets the Total field's value.
func (GetReservationCoverageOutput) String ¶
func (s GetReservationCoverageOutput) String() string
String returns the string representation
type GetReservationPurchaseRecommendationInput ¶
type GetReservationPurchaseRecommendationInput struct { // The account ID that is associated with the recommendation. AccountId *string `type:"string"` // The account scope that you want recommendations for. The only valid value // is Payer. This means that AWS includes the master account and any member // accounts when it calculates its recommendations. 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 ¶
func (s GetReservationPurchaseRecommendationInput) GoString() string
GoString returns the string representation
func (*GetReservationPurchaseRecommendationInput) SetAccountId ¶
func (s *GetReservationPurchaseRecommendationInput) SetAccountId(v string) *GetReservationPurchaseRecommendationInput
SetAccountId sets the AccountId field's value.
func (*GetReservationPurchaseRecommendationInput) SetAccountScope ¶
func (s *GetReservationPurchaseRecommendationInput) SetAccountScope(v string) *GetReservationPurchaseRecommendationInput
SetAccountScope sets the AccountScope field's value.
func (*GetReservationPurchaseRecommendationInput) SetLookbackPeriodInDays ¶
func (s *GetReservationPurchaseRecommendationInput) SetLookbackPeriodInDays(v string) *GetReservationPurchaseRecommendationInput
SetLookbackPeriodInDays sets the LookbackPeriodInDays field's value.
func (*GetReservationPurchaseRecommendationInput) SetNextPageToken ¶
func (s *GetReservationPurchaseRecommendationInput) SetNextPageToken(v string) *GetReservationPurchaseRecommendationInput
SetNextPageToken sets the NextPageToken field's value.
func (*GetReservationPurchaseRecommendationInput) SetPageSize ¶
func (s *GetReservationPurchaseRecommendationInput) SetPageSize(v int64) *GetReservationPurchaseRecommendationInput
SetPageSize sets the PageSize field's value.
func (*GetReservationPurchaseRecommendationInput) SetPaymentOption ¶
func (s *GetReservationPurchaseRecommendationInput) SetPaymentOption(v string) *GetReservationPurchaseRecommendationInput
SetPaymentOption sets the PaymentOption field's value.
func (*GetReservationPurchaseRecommendationInput) SetService ¶
func (s *GetReservationPurchaseRecommendationInput) SetService(v string) *GetReservationPurchaseRecommendationInput
SetService sets the Service field's value.
func (*GetReservationPurchaseRecommendationInput) SetServiceSpecification ¶
func (s *GetReservationPurchaseRecommendationInput) SetServiceSpecification(v *ServiceSpecification) *GetReservationPurchaseRecommendationInput
SetServiceSpecification sets the ServiceSpecification field's value.
func (*GetReservationPurchaseRecommendationInput) SetTermInYears ¶
func (s *GetReservationPurchaseRecommendationInput) SetTermInYears(v string) *GetReservationPurchaseRecommendationInput
SetTermInYears sets the TermInYears field's value.
func (GetReservationPurchaseRecommendationInput) String ¶
func (s GetReservationPurchaseRecommendationInput) String() string
String returns the string representation
func (*GetReservationPurchaseRecommendationInput) Validate ¶
func (s *GetReservationPurchaseRecommendationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetReservationPurchaseRecommendationOutput ¶
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 ¶
func (s GetReservationPurchaseRecommendationOutput) GoString() string
GoString returns the string representation
func (*GetReservationPurchaseRecommendationOutput) SetMetadata ¶
func (s *GetReservationPurchaseRecommendationOutput) SetMetadata(v *ReservationPurchaseRecommendationMetadata) *GetReservationPurchaseRecommendationOutput
SetMetadata sets the Metadata field's value.
func (*GetReservationPurchaseRecommendationOutput) SetNextPageToken ¶
func (s *GetReservationPurchaseRecommendationOutput) SetNextPageToken(v string) *GetReservationPurchaseRecommendationOutput
SetNextPageToken sets the NextPageToken field's value.
func (*GetReservationPurchaseRecommendationOutput) SetRecommendations ¶
func (s *GetReservationPurchaseRecommendationOutput) SetRecommendations(v []*ReservationPurchaseRecommendation) *GetReservationPurchaseRecommendationOutput
SetRecommendations sets the Recommendations field's value.
func (GetReservationPurchaseRecommendationOutput) String ¶
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) SetMetrics ¶
func (s *Group) SetMetrics(v map[string]*MetricValue) *Group
SetMetrics sets the Metrics field's value.
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 ¶
type InstanceDetails struct { // The EC2 instances that AWS recommends that you purchase. EC2InstanceDetails *EC2InstanceDetails `type:"structure"` // The RDS instances that AWS recommends that you purchase. RDSInstanceDetails *RDSInstanceDetails `type:"structure"` // contains filtered or unexported fields }
Details about the instances that AWS recommends that you purchase.
func (InstanceDetails) GoString ¶
func (s InstanceDetails) GoString() string
GoString returns the string representation
func (*InstanceDetails) SetEC2InstanceDetails ¶
func (s *InstanceDetails) SetEC2InstanceDetails(v *EC2InstanceDetails) *InstanceDetails
SetEC2InstanceDetails sets the EC2InstanceDetails field's value.
func (*InstanceDetails) SetRDSInstanceDetails ¶
func (s *InstanceDetails) SetRDSInstanceDetails(v *RDSInstanceDetails) *InstanceDetails
SetRDSInstanceDetails sets the RDSInstanceDetails field's value.
func (InstanceDetails) String ¶
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 ¶
type RDSInstanceDetails struct { // Whether the recommendation is for a current generation instance. CurrentGeneration *bool `type:"boolean"` // 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 ¶
func (s RDSInstanceDetails) GoString() string
GoString returns the string representation
func (*RDSInstanceDetails) SetCurrentGeneration ¶
func (s *RDSInstanceDetails) SetCurrentGeneration(v bool) *RDSInstanceDetails
SetCurrentGeneration sets the CurrentGeneration field's value.
func (*RDSInstanceDetails) SetDatabaseEngine ¶
func (s *RDSInstanceDetails) SetDatabaseEngine(v string) *RDSInstanceDetails
SetDatabaseEngine sets the DatabaseEngine field's value.
func (*RDSInstanceDetails) SetDeploymentOption ¶
func (s *RDSInstanceDetails) SetDeploymentOption(v string) *RDSInstanceDetails
SetDeploymentOption sets the DeploymentOption field's value.
func (*RDSInstanceDetails) SetFamily ¶
func (s *RDSInstanceDetails) SetFamily(v string) *RDSInstanceDetails
SetFamily sets the Family field's value.
func (*RDSInstanceDetails) SetInstanceType ¶
func (s *RDSInstanceDetails) SetInstanceType(v string) *RDSInstanceDetails
SetInstanceType sets the InstanceType field's value.
func (*RDSInstanceDetails) SetLicenseModel ¶
func (s *RDSInstanceDetails) SetLicenseModel(v string) *RDSInstanceDetails
SetLicenseModel sets the LicenseModel field's value.
func (*RDSInstanceDetails) SetRegion ¶
func (s *RDSInstanceDetails) SetRegion(v string) *RDSInstanceDetails
SetRegion sets the Region field's value.
func (*RDSInstanceDetails) SetSizeFlexEligible ¶
func (s *RDSInstanceDetails) SetSizeFlexEligible(v bool) *RDSInstanceDetails
SetSizeFlexEligible sets the SizeFlexEligible field's value.
func (RDSInstanceDetails) String ¶
func (s RDSInstanceDetails) String() string
String returns the string representation
type ReservationAggregates ¶
type ReservationAggregates struct { // 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 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 RI usage.
func (ReservationAggregates) GoString ¶
func (s ReservationAggregates) GoString() string
GoString returns the string representation
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) 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 ¶
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 ¶
func (s ReservationCoverageGroup) GoString() string
GoString returns the string representation
func (*ReservationCoverageGroup) SetAttributes ¶
func (s *ReservationCoverageGroup) SetAttributes(v map[string]*string) *ReservationCoverageGroup
SetAttributes sets the Attributes field's value.
func (*ReservationCoverageGroup) SetCoverage ¶
func (s *ReservationCoverageGroup) SetCoverage(v *Coverage) *ReservationCoverageGroup
SetCoverage sets the Coverage field's value.
func (ReservationCoverageGroup) String ¶
func (s ReservationCoverageGroup) String() string
String returns the string representation
type ReservationPurchaseRecommendation ¶
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 takes into consideration 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 ¶
func (s ReservationPurchaseRecommendation) GoString() string
GoString returns the string representation
func (*ReservationPurchaseRecommendation) SetAccountScope ¶
func (s *ReservationPurchaseRecommendation) SetAccountScope(v string) *ReservationPurchaseRecommendation
SetAccountScope sets the AccountScope field's value.
func (*ReservationPurchaseRecommendation) SetLookbackPeriodInDays ¶
func (s *ReservationPurchaseRecommendation) SetLookbackPeriodInDays(v string) *ReservationPurchaseRecommendation
SetLookbackPeriodInDays sets the LookbackPeriodInDays field's value.
func (*ReservationPurchaseRecommendation) SetPaymentOption ¶
func (s *ReservationPurchaseRecommendation) SetPaymentOption(v string) *ReservationPurchaseRecommendation
SetPaymentOption sets the PaymentOption field's value.
func (*ReservationPurchaseRecommendation) SetRecommendationDetails ¶
func (s *ReservationPurchaseRecommendation) SetRecommendationDetails(v []*ReservationPurchaseRecommendationDetail) *ReservationPurchaseRecommendation
SetRecommendationDetails sets the RecommendationDetails field's value.
func (*ReservationPurchaseRecommendation) SetRecommendationSummary ¶
func (s *ReservationPurchaseRecommendation) SetRecommendationSummary(v *ReservationPurchaseRecommendationSummary) *ReservationPurchaseRecommendation
SetRecommendationSummary sets the RecommendationSummary field's value.
func (*ReservationPurchaseRecommendation) SetServiceSpecification ¶
func (s *ReservationPurchaseRecommendation) SetServiceSpecification(v *ServiceSpecification) *ReservationPurchaseRecommendation
SetServiceSpecification sets the ServiceSpecification field's value.
func (*ReservationPurchaseRecommendation) SetTermInYears ¶
func (s *ReservationPurchaseRecommendation) SetTermInYears(v string) *ReservationPurchaseRecommendation
SetTermInYears sets the TermInYears field's value.
func (ReservationPurchaseRecommendation) String ¶
func (s ReservationPurchaseRecommendation) String() string
String returns the string representation
type ReservationPurchaseRecommendationDetail ¶
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 ¶
func (s ReservationPurchaseRecommendationDetail) GoString() string
GoString returns the string representation
func (*ReservationPurchaseRecommendationDetail) SetAverageNormalizedUnitsUsedPerHour ¶
func (s *ReservationPurchaseRecommendationDetail) SetAverageNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
SetAverageNormalizedUnitsUsedPerHour sets the AverageNormalizedUnitsUsedPerHour field's value.
func (*ReservationPurchaseRecommendationDetail) SetAverageNumberOfInstancesUsedPerHour ¶
func (s *ReservationPurchaseRecommendationDetail) SetAverageNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
SetAverageNumberOfInstancesUsedPerHour sets the AverageNumberOfInstancesUsedPerHour field's value.
func (*ReservationPurchaseRecommendationDetail) SetAverageUtilization ¶
func (s *ReservationPurchaseRecommendationDetail) SetAverageUtilization(v string) *ReservationPurchaseRecommendationDetail
SetAverageUtilization sets the AverageUtilization field's value.
func (*ReservationPurchaseRecommendationDetail) SetCurrencyCode ¶
func (s *ReservationPurchaseRecommendationDetail) SetCurrencyCode(v string) *ReservationPurchaseRecommendationDetail
SetCurrencyCode sets the CurrencyCode field's value.
func (*ReservationPurchaseRecommendationDetail) SetEstimatedBreakEvenInMonths ¶
func (s *ReservationPurchaseRecommendationDetail) SetEstimatedBreakEvenInMonths(v string) *ReservationPurchaseRecommendationDetail
SetEstimatedBreakEvenInMonths sets the EstimatedBreakEvenInMonths field's value.
func (*ReservationPurchaseRecommendationDetail) SetEstimatedMonthlyOnDemandCost ¶
func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlyOnDemandCost(v string) *ReservationPurchaseRecommendationDetail
SetEstimatedMonthlyOnDemandCost sets the EstimatedMonthlyOnDemandCost field's value.
func (*ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsAmount ¶
func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsAmount(v string) *ReservationPurchaseRecommendationDetail
SetEstimatedMonthlySavingsAmount sets the EstimatedMonthlySavingsAmount field's value.
func (*ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsPercentage ¶
func (s *ReservationPurchaseRecommendationDetail) SetEstimatedMonthlySavingsPercentage(v string) *ReservationPurchaseRecommendationDetail
SetEstimatedMonthlySavingsPercentage sets the EstimatedMonthlySavingsPercentage field's value.
func (*ReservationPurchaseRecommendationDetail) SetEstimatedReservationCostForLookbackPeriod ¶
func (s *ReservationPurchaseRecommendationDetail) SetEstimatedReservationCostForLookbackPeriod(v string) *ReservationPurchaseRecommendationDetail
SetEstimatedReservationCostForLookbackPeriod sets the EstimatedReservationCostForLookbackPeriod field's value.
func (*ReservationPurchaseRecommendationDetail) SetInstanceDetails ¶
func (s *ReservationPurchaseRecommendationDetail) SetInstanceDetails(v *InstanceDetails) *ReservationPurchaseRecommendationDetail
SetInstanceDetails sets the InstanceDetails field's value.
func (*ReservationPurchaseRecommendationDetail) SetMaximumNormalizedUnitsUsedPerHour ¶
func (s *ReservationPurchaseRecommendationDetail) SetMaximumNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
SetMaximumNormalizedUnitsUsedPerHour sets the MaximumNormalizedUnitsUsedPerHour field's value.
func (*ReservationPurchaseRecommendationDetail) SetMaximumNumberOfInstancesUsedPerHour ¶
func (s *ReservationPurchaseRecommendationDetail) SetMaximumNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
SetMaximumNumberOfInstancesUsedPerHour sets the MaximumNumberOfInstancesUsedPerHour field's value.
func (*ReservationPurchaseRecommendationDetail) SetMinimumNormalizedUnitsUsedPerHour ¶
func (s *ReservationPurchaseRecommendationDetail) SetMinimumNormalizedUnitsUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
SetMinimumNormalizedUnitsUsedPerHour sets the MinimumNormalizedUnitsUsedPerHour field's value.
func (*ReservationPurchaseRecommendationDetail) SetMinimumNumberOfInstancesUsedPerHour ¶
func (s *ReservationPurchaseRecommendationDetail) SetMinimumNumberOfInstancesUsedPerHour(v string) *ReservationPurchaseRecommendationDetail
SetMinimumNumberOfInstancesUsedPerHour sets the MinimumNumberOfInstancesUsedPerHour field's value.
func (*ReservationPurchaseRecommendationDetail) SetRecommendedNormalizedUnitsToPurchase ¶
func (s *ReservationPurchaseRecommendationDetail) SetRecommendedNormalizedUnitsToPurchase(v string) *ReservationPurchaseRecommendationDetail
SetRecommendedNormalizedUnitsToPurchase sets the RecommendedNormalizedUnitsToPurchase field's value.
func (*ReservationPurchaseRecommendationDetail) SetRecommendedNumberOfInstancesToPurchase ¶
func (s *ReservationPurchaseRecommendationDetail) SetRecommendedNumberOfInstancesToPurchase(v string) *ReservationPurchaseRecommendationDetail
SetRecommendedNumberOfInstancesToPurchase sets the RecommendedNumberOfInstancesToPurchase field's value.
func (*ReservationPurchaseRecommendationDetail) SetRecurringStandardMonthlyCost ¶
func (s *ReservationPurchaseRecommendationDetail) SetRecurringStandardMonthlyCost(v string) *ReservationPurchaseRecommendationDetail
SetRecurringStandardMonthlyCost sets the RecurringStandardMonthlyCost field's value.
func (*ReservationPurchaseRecommendationDetail) SetUpfrontCost ¶
func (s *ReservationPurchaseRecommendationDetail) SetUpfrontCost(v string) *ReservationPurchaseRecommendationDetail
SetUpfrontCost sets the UpfrontCost field's value.
func (ReservationPurchaseRecommendationDetail) String ¶
func (s ReservationPurchaseRecommendationDetail) String() string
String returns the string representation
type ReservationPurchaseRecommendationMetadata ¶
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 ¶
func (s ReservationPurchaseRecommendationMetadata) GoString() string
GoString returns the string representation
func (*ReservationPurchaseRecommendationMetadata) SetGenerationTimestamp ¶
func (s *ReservationPurchaseRecommendationMetadata) SetGenerationTimestamp(v string) *ReservationPurchaseRecommendationMetadata
SetGenerationTimestamp sets the GenerationTimestamp field's value.
func (*ReservationPurchaseRecommendationMetadata) SetRecommendationId ¶
func (s *ReservationPurchaseRecommendationMetadata) SetRecommendationId(v string) *ReservationPurchaseRecommendationMetadata
SetRecommendationId sets the RecommendationId field's value.
func (ReservationPurchaseRecommendationMetadata) String ¶
func (s ReservationPurchaseRecommendationMetadata) String() string
String returns the string representation
type ReservationPurchaseRecommendationSummary ¶
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 you could save, and the total amount of reservation to purchase.
func (ReservationPurchaseRecommendationSummary) GoString ¶
func (s ReservationPurchaseRecommendationSummary) GoString() string
GoString returns the string representation
func (*ReservationPurchaseRecommendationSummary) SetCurrencyCode ¶
func (s *ReservationPurchaseRecommendationSummary) SetCurrencyCode(v string) *ReservationPurchaseRecommendationSummary
SetCurrencyCode sets the CurrencyCode field's value.
func (*ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsAmount ¶
func (s *ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsAmount(v string) *ReservationPurchaseRecommendationSummary
SetTotalEstimatedMonthlySavingsAmount sets the TotalEstimatedMonthlySavingsAmount field's value.
func (*ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsPercentage ¶
func (s *ReservationPurchaseRecommendationSummary) SetTotalEstimatedMonthlySavingsPercentage(v string) *ReservationPurchaseRecommendationSummary
SetTotalEstimatedMonthlySavingsPercentage sets the TotalEstimatedMonthlySavingsPercentage field's value.
func (ReservationPurchaseRecommendationSummary) String ¶
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 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 ¶
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 ¶
func (s ServiceSpecification) GoString() string
GoString returns the string representation
func (*ServiceSpecification) SetEC2Specification ¶
func (s *ServiceSpecification) SetEC2Specification(v *EC2Specification) *ServiceSpecification
SetEC2Specification sets the EC2Specification field's value.
func (ServiceSpecification) String ¶
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.
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
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. |