budgets

package
v1.32.11 Latest Latest
Warning

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

 Go to latest Published: Jun 26, 2020 License: Apache-2.0 Imports: 10 Imported by: 63

Documentation

Overview

Package budgets provides the client and types for making API requests to AWS Budgets.

The AWS Budgets API enables you to use AWS Budgets to plan your service usage, service costs, and instance reservations. The API reference provides descriptions, syntax, and usage examples for each of the actions and data types for AWS Budgets.

Budgets provide you with a way to see the following information:

  • How close your plan is to your budgeted amount or to the free tier limits

  • Your usage-to-date, including how much you've used of your Reserved Instances (RIs)

  • Your current estimated charges from AWS, and how much your predicted usage will accrue in charges by the end of the month

  • How much of your budget has been used

AWS updates your budget status several times a day. Budgets track your unblended costs, subscriptions, refunds, and RIs. You can create the following types of budgets:

  • Cost budgets - Plan how much you want to spend on a service.

  • Usage budgets - Plan how much you want to use one or more services.

  • RI utilization budgets - Define a utilization threshold, and receive alerts when your RI usage falls below that threshold. This lets you see if your RIs are unused or under-utilized.

  • RI coverage budgets - Define a coverage threshold, and receive alerts when the number of your instance hours that are covered by RIs fall below that threshold. This lets you see how much of your instance usage is covered by a reservation.

Service Endpoint

The AWS Budgets API provides the following endpoint:

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

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

Using the Client

To contact AWS Budgets 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 Budgets client Budgets for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/budgets/#New

Index

Constants

View Source 
const (
	// BudgetTypeUsage is a BudgetType enum value
	BudgetTypeUsage = "USAGE"

	// BudgetTypeCost is a BudgetType enum value
	BudgetTypeCost = "COST"

	// BudgetTypeRiUtilization is a BudgetType enum value
	BudgetTypeRiUtilization = "RI_UTILIZATION"

	// BudgetTypeRiCoverage is a BudgetType enum value
	BudgetTypeRiCoverage = "RI_COVERAGE"

	// BudgetTypeSavingsPlansUtilization is a BudgetType enum value
	BudgetTypeSavingsPlansUtilization = "SAVINGS_PLANS_UTILIZATION"

	// BudgetTypeSavingsPlansCoverage is a BudgetType enum value
	BudgetTypeSavingsPlansCoverage = "SAVINGS_PLANS_COVERAGE"
)

The type of a budget. It must be one of the following types:

COST, USAGE, RI_UTILIZATION, or RI_COVERAGE.

View Source 
const (
	// ComparisonOperatorGreaterThan is a ComparisonOperator enum value
	ComparisonOperatorGreaterThan = "GREATER_THAN"

	// ComparisonOperatorLessThan is a ComparisonOperator enum value
	ComparisonOperatorLessThan = "LESS_THAN"

	// ComparisonOperatorEqualTo is a ComparisonOperator enum value
	ComparisonOperatorEqualTo = "EQUAL_TO"
)

The comparison operator of a notification. Currently the service supports the following operators:

GREATER_THAN, LESS_THAN, EQUAL_TO

View Source 
const (
	// NotificationStateOk is a NotificationState enum value
	NotificationStateOk = "OK"

	// NotificationStateAlarm is a NotificationState enum value
	NotificationStateAlarm = "ALARM"
)
View Source 
const (
	// NotificationTypeActual is a NotificationType enum value
	NotificationTypeActual = "ACTUAL"

	// NotificationTypeForecasted is a NotificationType enum value
	NotificationTypeForecasted = "FORECASTED"
)

The type of a notification. It must be ACTUAL or FORECASTED.

View Source 
const (
	// SubscriptionTypeSns is a SubscriptionType enum value
	SubscriptionTypeSns = "SNS"

	// SubscriptionTypeEmail is a SubscriptionType enum value
	SubscriptionTypeEmail = "EMAIL"
)

The subscription type of the subscriber. It can be SMS or EMAIL.

View Source 
const (
	// ThresholdTypePercentage is a ThresholdType enum value
	ThresholdTypePercentage = "PERCENTAGE"

	// ThresholdTypeAbsoluteValue is a ThresholdType enum value
	ThresholdTypeAbsoluteValue = "ABSOLUTE_VALUE"
)

The type of threshold for a notification. It can be PERCENTAGE or ABSOLUTE_VALUE.

View Source 
const (
	// TimeUnitDaily is a TimeUnit enum value
	TimeUnitDaily = "DAILY"

	// TimeUnitMonthly is a TimeUnit enum value
	TimeUnitMonthly = "MONTHLY"

	// TimeUnitQuarterly is a TimeUnit enum value
	TimeUnitQuarterly = "QUARTERLY"

	// TimeUnitAnnually is a TimeUnit enum value
	TimeUnitAnnually = "ANNUALLY"
)

The time unit of the budget, such as MONTHLY or QUARTERLY.

View Source 
const (

	// ErrCodeAccessDeniedException for service response error code
	// "AccessDeniedException".
	//
	// You are not authorized to use this operation with the given parameters.
	ErrCodeAccessDeniedException = "AccessDeniedException"

	// ErrCodeCreationLimitExceededException for service response error code
	// "CreationLimitExceededException".
	//
	// You've exceeded the notification or subscriber limit.
	ErrCodeCreationLimitExceededException = "CreationLimitExceededException"

	// ErrCodeDuplicateRecordException for service response error code
	// "DuplicateRecordException".
	//
	// The budget name already exists. Budget names must be unique within an account.
	ErrCodeDuplicateRecordException = "DuplicateRecordException"

	// ErrCodeExpiredNextTokenException for service response error code
	// "ExpiredNextTokenException".
	//
	// The pagination token expired.
	ErrCodeExpiredNextTokenException = "ExpiredNextTokenException"

	// ErrCodeInternalErrorException for service response error code
	// "InternalErrorException".
	//
	// An error on the server occurred during the processing of your request. Try
	// again later.
	ErrCodeInternalErrorException = "InternalErrorException"

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

	// ErrCodeInvalidParameterException for service response error code
	// "InvalidParameterException".
	//
	// An error on the client occurred. Typically, the cause is an invalid input
	// value.
	ErrCodeInvalidParameterException = "InvalidParameterException"

	// ErrCodeNotFoundException for service response error code
	// "NotFoundException".
	//
	// We can’t locate the resource that you specified.
	ErrCodeNotFoundException = "NotFoundException"
)
View Source 
const (
	ServiceName = "budgets"   // Name of service.
	EndpointsID = ServiceName // ID to lookup a service endpoint with.
	ServiceID   = "Budgets"   // ServiceID is a unique identifier of a specific service.
)

Service information constants

Variables

This section is empty.

Functions

This section is empty.

Types

type AccessDeniedException added in v1.28.0 

type AccessDeniedException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

You are not authorized to use this operation with the given parameters.

func (*AccessDeniedException) Code added in v1.28.0 

func (s *AccessDeniedException) Code() string

Code returns the exception type name.

func (*AccessDeniedException) Error added in v1.28.0 

func (s *AccessDeniedException) Error() string

func (AccessDeniedException) GoString added in v1.28.0 

func (s AccessDeniedException) GoString() string

GoString returns the string representation

func (*AccessDeniedException) Message added in v1.28.0 

func (s *AccessDeniedException) Message() string

Message returns the exception's message.

func (*AccessDeniedException) OrigErr added in v1.28.0 

func (s *AccessDeniedException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*AccessDeniedException) RequestID added in v1.28.0 

func (s *AccessDeniedException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*AccessDeniedException) StatusCode added in v1.28.0 

func (s *AccessDeniedException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (AccessDeniedException) String added in v1.28.0 

func (s AccessDeniedException) String() string

String returns the string representation

type Budget 

type Budget struct {

	// The total amount of cost, usage, RI utilization, RI coverage, Savings Plans
	// utilization, or Savings Plans coverage that you want to track with your budget.
	//
	// BudgetLimit is required for cost or usage budgets, but optional for RI or
	// Savings Plans utilization or coverage budgets. RI and Savings Plans utilization
	// or coverage budgets default to 100, which is the only valid value for RI
	// or Savings Plans utilization or coverage budgets. You can't use BudgetLimit
	// with PlannedBudgetLimits for CreateBudget and UpdateBudget actions.
	BudgetLimit *Spend `type:"structure"`

	// The name of a budget. The name must be unique within an account. The : and
	// \ characters aren't allowed in BudgetName.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// Whether this budget tracks costs, usage, RI utilization, RI coverage, Savings
	// Plans utilization, or Savings Plans coverage.
	//
	// BudgetType is a required field
	BudgetType *string `type:"string" required:"true" enum:"BudgetType"`

	// The actual and forecasted cost or usage that the budget tracks.
	CalculatedSpend *CalculatedSpend `type:"structure"`

	// The cost filters, such as service or tag, that are applied to a budget.
	//
	// AWS Budgets supports the following services as a filter for RI budgets:
	//
	//    * Amazon Elastic Compute Cloud - Compute
	//
	//    * Amazon Redshift
	//
	//    * Amazon Relational Database Service
	//
	//    * Amazon ElastiCache
	//
	//    * Amazon Elasticsearch Service
	CostFilters map[string][]*string `type:"map"`

	// The types of costs that are included in this COST budget.
	//
	// USAGE, RI_UTILIZATION, RI_COVERAGE, Savings_Plans_Utilization, and Savings_Plans_Coverage
	// budgets do not have CostTypes.
	CostTypes *CostTypes `type:"structure"`

	// The last time that you updated this budget.
	LastUpdatedTime *time.Time `type:"timestamp"`

	// A map containing multiple BudgetLimit, including current or future limits.
	//
	// PlannedBudgetLimits is available for cost or usage budget and supports monthly
	// and quarterly TimeUnit.
	//
	// For monthly budgets, provide 12 months of PlannedBudgetLimits values. This
	// must start from the current month and include the next 11 months. The key
	// is the start of the month, UTC in epoch seconds.
	//
	// For quarterly budgets, provide 4 quarters of PlannedBudgetLimits value entries
	// in standard calendar quarter increments. This must start from the current
	// quarter and include the next 3 quarters. The key is the start of the quarter,
	// UTC in epoch seconds.
	//
	// If the planned budget expires before 12 months for monthly or 4 quarters
	// for quarterly, provide the PlannedBudgetLimits values only for the remaining
	// periods.
	//
	// If the budget begins at a date in the future, provide PlannedBudgetLimits
	// values from the start date of the budget.
	//
	// After all of the BudgetLimit values in PlannedBudgetLimits are used, the
	// budget continues to use the last limit as the BudgetLimit. At that point,
	// the planned budget provides the same experience as a fixed budget.
	//
	// DescribeBudget and DescribeBudgets response along with PlannedBudgetLimits
	// will also contain BudgetLimit representing the current month or quarter limit
	// present in PlannedBudgetLimits. This only applies to budgets created with
	// PlannedBudgetLimits. Budgets created without PlannedBudgetLimits will only
	// contain BudgetLimit, and no PlannedBudgetLimits.
	PlannedBudgetLimits map[string]*Spend `type:"map"`

	// The period of time that is covered by a budget. The period has a start date
	// and an end date. The start date must come before the end date. The end date
	// must come before 06/15/87 00:00 UTC.
	//
	// If you create your budget and don't specify a start date, AWS defaults to
	// the start of your chosen time period (DAILY, MONTHLY, QUARTERLY, or ANNUALLY).
	// For example, if you created your budget on January 24, 2018, chose DAILY,
	// and didn't set a start date, AWS set your start date to 01/24/18 00:00 UTC.
	// If you chose MONTHLY, AWS set your start date to 01/01/18 00:00 UTC. If you
	// didn't specify an end date, AWS set your end date to 06/15/87 00:00 UTC.
	// The defaults are the same for the AWS Billing and Cost Management console
	// and the API.
	//
	// You can change either date with the UpdateBudget operation.
	//
	// After the end date, AWS deletes the budget and all associated notifications
	// and subscribers.
	TimePeriod *TimePeriod `type:"structure"`

	// The length of time until a budget resets the actual and forecasted spend.
	// DAILY is available only for RI_UTILIZATION, RI_COVERAGE, Savings_Plans_Utilization,
	// and Savings_Plans_Coverage budgets.
	//
	// TimeUnit is a required field
	TimeUnit *string `type:"string" required:"true" enum:"TimeUnit"`
	// contains filtered or unexported fields
}

Represents the output of the CreateBudget operation. The content consists of the detailed metadata and data file information, and the current status of the budget object.

This is the ARN pattern for a budget:

arn:aws:budgetservice::AccountId:budget/budgetName

func (Budget) GoString 

func (s Budget) GoString() string

GoString returns the string representation

func (*Budget) SetBudgetLimit added in v1.5.0 

func (s *Budget) SetBudgetLimit(v *Spend) *Budget

SetBudgetLimit sets the BudgetLimit field's value.

func (*Budget) SetBudgetName added in v1.5.0 

func (s *Budget) SetBudgetName(v string) *Budget

SetBudgetName sets the BudgetName field's value.

func (*Budget) SetBudgetType added in v1.5.0 

func (s *Budget) SetBudgetType(v string) *Budget

SetBudgetType sets the BudgetType field's value.

func (*Budget) SetCalculatedSpend added in v1.5.0 

func (s *Budget) SetCalculatedSpend(v *CalculatedSpend) *Budget

SetCalculatedSpend sets the CalculatedSpend field's value.

func (*Budget) SetCostFilters added in v1.5.0 

func (s *Budget) SetCostFilters(v map[string][]*string) *Budget

SetCostFilters sets the CostFilters field's value.

func (*Budget) SetCostTypes added in v1.5.0 

func (s *Budget) SetCostTypes(v *CostTypes) *Budget

SetCostTypes sets the CostTypes field's value.

func (*Budget) SetLastUpdatedTime added in v1.15.74 

func (s *Budget) SetLastUpdatedTime(v time.Time) *Budget

SetLastUpdatedTime sets the LastUpdatedTime field's value.

func (*Budget) SetPlannedBudgetLimits added in v1.19.36 

func (s *Budget) SetPlannedBudgetLimits(v map[string]*Spend) *Budget

SetPlannedBudgetLimits sets the PlannedBudgetLimits field's value.

func (*Budget) SetTimePeriod added in v1.5.0 

func (s *Budget) SetTimePeriod(v *TimePeriod) *Budget

SetTimePeriod sets the TimePeriod field's value.

func (*Budget) SetTimeUnit added in v1.5.0 

func (s *Budget) SetTimeUnit(v string) *Budget

SetTimeUnit sets the TimeUnit field's value.

func (Budget) String 

func (s Budget) String() string

String returns the string representation

func (*Budget) Validate 

func (s *Budget) Validate() error

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

type BudgetPerformanceHistory added in v1.15.74 

type BudgetPerformanceHistory struct {

	// A string that represents the budget name. The ":" and "\" characters aren't
	// allowed.
	BudgetName *string `min:"1" type:"string"`

	// The type of a budget. It must be one of the following types:
	//
	// COST, USAGE, RI_UTILIZATION, or RI_COVERAGE.
	BudgetType *string `type:"string" enum:"BudgetType"`

	// A list of amounts of cost or usage that you created budgets for, compared
	// to your actual costs or usage.
	BudgetedAndActualAmountsList []*BudgetedAndActualAmounts `type:"list"`

	// The history of the cost filters for a budget during the specified time period.
	CostFilters map[string][]*string `type:"map"`

	// The history of the cost types for a budget during the specified time period.
	CostTypes *CostTypes `type:"structure"`

	// The time unit of the budget, such as MONTHLY or QUARTERLY.
	TimeUnit *string `type:"string" enum:"TimeUnit"`
	// contains filtered or unexported fields
}

A history of the state of a budget at the end of the budget's specified time period.

func (BudgetPerformanceHistory) GoString added in v1.15.74 

func (s BudgetPerformanceHistory) GoString() string

GoString returns the string representation

func (*BudgetPerformanceHistory) SetBudgetName added in v1.15.74 

func (s *BudgetPerformanceHistory) SetBudgetName(v string) *BudgetPerformanceHistory

SetBudgetName sets the BudgetName field's value.

func (*BudgetPerformanceHistory) SetBudgetType added in v1.15.74 

func (s *BudgetPerformanceHistory) SetBudgetType(v string) *BudgetPerformanceHistory

SetBudgetType sets the BudgetType field's value.

func (*BudgetPerformanceHistory) SetBudgetedAndActualAmountsList added in v1.15.74 

func (s *BudgetPerformanceHistory) SetBudgetedAndActualAmountsList(v []*BudgetedAndActualAmounts) *BudgetPerformanceHistory

SetBudgetedAndActualAmountsList sets the BudgetedAndActualAmountsList field's value.

func (*BudgetPerformanceHistory) SetCostFilters added in v1.15.74 

func (s *BudgetPerformanceHistory) SetCostFilters(v map[string][]*string) *BudgetPerformanceHistory

SetCostFilters sets the CostFilters field's value.

func (*BudgetPerformanceHistory) SetCostTypes added in v1.15.74 

func (s *BudgetPerformanceHistory) SetCostTypes(v *CostTypes) *BudgetPerformanceHistory

SetCostTypes sets the CostTypes field's value.

func (*BudgetPerformanceHistory) SetTimeUnit added in v1.15.74 

func (s *BudgetPerformanceHistory) SetTimeUnit(v string) *BudgetPerformanceHistory

SetTimeUnit sets the TimeUnit field's value.

func (BudgetPerformanceHistory) String added in v1.15.74 

func (s BudgetPerformanceHistory) String() string

String returns the string representation

type BudgetedAndActualAmounts added in v1.15.74 

type BudgetedAndActualAmounts struct {

	// Your actual costs or usage for a budget period.
	ActualAmount *Spend `type:"structure"`

	// The amount of cost or usage that you created the budget for.
	BudgetedAmount *Spend `type:"structure"`

	// The time period covered by this budget comparison.
	TimePeriod *TimePeriod `type:"structure"`
	// contains filtered or unexported fields
}

The amount of cost or usage that you created the budget for, compared to your actual costs or usage.

func (BudgetedAndActualAmounts) GoString added in v1.15.74 

func (s BudgetedAndActualAmounts) GoString() string

GoString returns the string representation

func (*BudgetedAndActualAmounts) SetActualAmount added in v1.15.74 

func (s *BudgetedAndActualAmounts) SetActualAmount(v *Spend) *BudgetedAndActualAmounts

SetActualAmount sets the ActualAmount field's value.

func (*BudgetedAndActualAmounts) SetBudgetedAmount added in v1.15.74 

func (s *BudgetedAndActualAmounts) SetBudgetedAmount(v *Spend) *BudgetedAndActualAmounts

SetBudgetedAmount sets the BudgetedAmount field's value.

func (*BudgetedAndActualAmounts) SetTimePeriod added in v1.15.74 

func (s *BudgetedAndActualAmounts) SetTimePeriod(v *TimePeriod) *BudgetedAndActualAmounts

SetTimePeriod sets the TimePeriod field's value.

func (BudgetedAndActualAmounts) String added in v1.15.74 

func (s BudgetedAndActualAmounts) String() string

String returns the string representation

type Budgets 

type Budgets struct {
	*client.Client
}

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

Budgets 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) *Budgets

New creates a new instance of the Budgets 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: 

mySession := session.Must(session.NewSession())

// Create a Budgets client from just a session.
svc := budgets.New(mySession)

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

func (*Budgets) CreateBudget 

func (c *Budgets) CreateBudget(input *CreateBudgetInput) (*CreateBudgetOutput, error)

CreateBudget API operation for AWS Budgets.

Creates a budget and, if included, notifications and subscribers.

Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_CreateBudget.html#API_CreateBudget_Examples) section.

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 Budgets's API operation CreateBudget for usage and error information.

Returned Error Types:

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • CreationLimitExceededException You've exceeded the notification or subscriber limit.

  • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) CreateBudgetRequest 

func (c *Budgets) CreateBudgetRequest(input *CreateBudgetInput) (req *request.Request, output *CreateBudgetOutput)

CreateBudgetRequest generates a "aws/request.Request" representing the client's request for the CreateBudget operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateBudget for more information on using the CreateBudget 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 CreateBudgetRequest method.
req, resp := client.CreateBudgetRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) CreateBudgetWithContext added in v1.8.0 

func (c *Budgets) CreateBudgetWithContext(ctx aws.Context, input *CreateBudgetInput, opts ...request.Option) (*CreateBudgetOutput, error)

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

See CreateBudget 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 (*Budgets) CreateNotification 

func (c *Budgets) CreateNotification(input *CreateNotificationInput) (*CreateNotificationOutput, error)

CreateNotification API operation for AWS Budgets.

Creates a notification. You must create the budget before you create the associated notification.

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 Budgets's API operation CreateNotification for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • CreationLimitExceededException You've exceeded the notification or subscriber limit.

  • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) CreateNotificationRequest 

func (c *Budgets) CreateNotificationRequest(input *CreateNotificationInput) (req *request.Request, output *CreateNotificationOutput)

CreateNotificationRequest generates a "aws/request.Request" representing the client's request for the CreateNotification operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateNotification for more information on using the CreateNotification 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 CreateNotificationRequest method.
req, resp := client.CreateNotificationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) CreateNotificationWithContext added in v1.8.0 

func (c *Budgets) CreateNotificationWithContext(ctx aws.Context, input *CreateNotificationInput, opts ...request.Option) (*CreateNotificationOutput, error)

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

See CreateNotification 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 (*Budgets) CreateSubscriber 

func (c *Budgets) CreateSubscriber(input *CreateSubscriberInput) (*CreateSubscriberOutput, error)

CreateSubscriber API operation for AWS Budgets.

Creates a subscriber. You must create the associated budget and notification before you create the subscriber.

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 Budgets's API operation CreateSubscriber for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • CreationLimitExceededException You've exceeded the notification or subscriber limit.

  • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.

  • NotFoundException We can’t locate the resource that you specified.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) CreateSubscriberRequest 

func (c *Budgets) CreateSubscriberRequest(input *CreateSubscriberInput) (req *request.Request, output *CreateSubscriberOutput)

CreateSubscriberRequest generates a "aws/request.Request" representing the client's request for the CreateSubscriber operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateSubscriber for more information on using the CreateSubscriber 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 CreateSubscriberRequest method.
req, resp := client.CreateSubscriberRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) CreateSubscriberWithContext added in v1.8.0 

func (c *Budgets) CreateSubscriberWithContext(ctx aws.Context, input *CreateSubscriberInput, opts ...request.Option) (*CreateSubscriberOutput, error)

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

See CreateSubscriber 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 (*Budgets) DeleteBudget 

func (c *Budgets) DeleteBudget(input *DeleteBudgetInput) (*DeleteBudgetOutput, error)

DeleteBudget API operation for AWS Budgets.

Deletes a budget. You can delete your budget at any time.

Deleting a budget also deletes the notifications and subscribers that are associated with that budget.

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 Budgets's API operation DeleteBudget for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DeleteBudgetRequest 

func (c *Budgets) DeleteBudgetRequest(input *DeleteBudgetInput) (req *request.Request, output *DeleteBudgetOutput)

DeleteBudgetRequest generates a "aws/request.Request" representing the client's request for the DeleteBudget operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBudget for more information on using the DeleteBudget 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 DeleteBudgetRequest method.
req, resp := client.DeleteBudgetRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DeleteBudgetWithContext added in v1.8.0 

func (c *Budgets) DeleteBudgetWithContext(ctx aws.Context, input *DeleteBudgetInput, opts ...request.Option) (*DeleteBudgetOutput, error)

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

See DeleteBudget 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 (*Budgets) DeleteNotification 

func (c *Budgets) DeleteNotification(input *DeleteNotificationInput) (*DeleteNotificationOutput, error)

DeleteNotification API operation for AWS Budgets.

Deletes a notification.

Deleting a notification also deletes the subscribers that are associated with the notification.

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 Budgets's API operation DeleteNotification for usage and error information.

Returned Error Types:

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • NotFoundException We can’t locate the resource that you specified.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DeleteNotificationRequest 

func (c *Budgets) DeleteNotificationRequest(input *DeleteNotificationInput) (req *request.Request, output *DeleteNotificationOutput)

DeleteNotificationRequest generates a "aws/request.Request" representing the client's request for the DeleteNotification operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteNotification for more information on using the DeleteNotification 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 DeleteNotificationRequest method.
req, resp := client.DeleteNotificationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DeleteNotificationWithContext added in v1.8.0 

func (c *Budgets) DeleteNotificationWithContext(ctx aws.Context, input *DeleteNotificationInput, opts ...request.Option) (*DeleteNotificationOutput, error)

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

See DeleteNotification 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 (*Budgets) DeleteSubscriber 

func (c *Budgets) DeleteSubscriber(input *DeleteSubscriberInput) (*DeleteSubscriberOutput, error)

DeleteSubscriber API operation for AWS Budgets.

Deletes a subscriber.

Deleting the last subscriber to a notification also deletes the notification.

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 Budgets's API operation DeleteSubscriber for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DeleteSubscriberRequest 

func (c *Budgets) DeleteSubscriberRequest(input *DeleteSubscriberInput) (req *request.Request, output *DeleteSubscriberOutput)

DeleteSubscriberRequest generates a "aws/request.Request" representing the client's request for the DeleteSubscriber operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteSubscriber for more information on using the DeleteSubscriber 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 DeleteSubscriberRequest method.
req, resp := client.DeleteSubscriberRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DeleteSubscriberWithContext added in v1.8.0 

func (c *Budgets) DeleteSubscriberWithContext(ctx aws.Context, input *DeleteSubscriberInput, opts ...request.Option) (*DeleteSubscriberOutput, error)

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

See DeleteSubscriber 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 (*Budgets) DescribeBudget 

func (c *Budgets) DescribeBudget(input *DescribeBudgetInput) (*DescribeBudgetOutput, error)

DescribeBudget API operation for AWS Budgets.

Describes a budget.

The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_DescribeBudget.html#API_DescribeBudget_Examples) section.

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 Budgets's API operation DescribeBudget for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DescribeBudgetPerformanceHistory added in v1.15.74 

func (c *Budgets) DescribeBudgetPerformanceHistory(input *DescribeBudgetPerformanceHistoryInput) (*DescribeBudgetPerformanceHistoryOutput, error)

DescribeBudgetPerformanceHistory API operation for AWS Budgets.

Describes the history for DAILY, MONTHLY, and QUARTERLY budgets. Budget history isn't available for ANNUAL budgets.

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 Budgets's API operation DescribeBudgetPerformanceHistory for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • InvalidNextTokenException The pagination token is invalid.

  • ExpiredNextTokenException The pagination token expired.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DescribeBudgetPerformanceHistoryRequest added in v1.15.74 

func (c *Budgets) DescribeBudgetPerformanceHistoryRequest(input *DescribeBudgetPerformanceHistoryInput) (req *request.Request, output *DescribeBudgetPerformanceHistoryOutput)

DescribeBudgetPerformanceHistoryRequest generates a "aws/request.Request" representing the client's request for the DescribeBudgetPerformanceHistory operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeBudgetPerformanceHistory for more information on using the DescribeBudgetPerformanceHistory 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 DescribeBudgetPerformanceHistoryRequest method.
req, resp := client.DescribeBudgetPerformanceHistoryRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DescribeBudgetPerformanceHistoryWithContext added in v1.15.74 

func (c *Budgets) DescribeBudgetPerformanceHistoryWithContext(ctx aws.Context, input *DescribeBudgetPerformanceHistoryInput, opts ...request.Option) (*DescribeBudgetPerformanceHistoryOutput, error)

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

See DescribeBudgetPerformanceHistory 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 (*Budgets) DescribeBudgetRequest 

func (c *Budgets) DescribeBudgetRequest(input *DescribeBudgetInput) (req *request.Request, output *DescribeBudgetOutput)

DescribeBudgetRequest generates a "aws/request.Request" representing the client's request for the DescribeBudget operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeBudget for more information on using the DescribeBudget 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 DescribeBudgetRequest method.
req, resp := client.DescribeBudgetRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DescribeBudgetWithContext added in v1.8.0 

func (c *Budgets) DescribeBudgetWithContext(ctx aws.Context, input *DescribeBudgetInput, opts ...request.Option) (*DescribeBudgetOutput, error)

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

See DescribeBudget 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 (*Budgets) DescribeBudgets 

func (c *Budgets) DescribeBudgets(input *DescribeBudgetsInput) (*DescribeBudgetsOutput, error)

DescribeBudgets API operation for AWS Budgets.

Lists the budgets that are associated with an account.

The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_DescribeBudgets.html#API_DescribeBudgets_Examples) section.

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 Budgets's API operation DescribeBudgets for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • InvalidNextTokenException The pagination token is invalid.

  • ExpiredNextTokenException The pagination token expired.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DescribeBudgetsRequest 

func (c *Budgets) DescribeBudgetsRequest(input *DescribeBudgetsInput) (req *request.Request, output *DescribeBudgetsOutput)

DescribeBudgetsRequest generates a "aws/request.Request" representing the client's request for the DescribeBudgets operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeBudgets for more information on using the DescribeBudgets 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 DescribeBudgetsRequest method.
req, resp := client.DescribeBudgetsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DescribeBudgetsWithContext added in v1.8.0 

func (c *Budgets) DescribeBudgetsWithContext(ctx aws.Context, input *DescribeBudgetsInput, opts ...request.Option) (*DescribeBudgetsOutput, error)

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

See DescribeBudgets 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 (*Budgets) DescribeNotificationsForBudget 

func (c *Budgets) DescribeNotificationsForBudget(input *DescribeNotificationsForBudgetInput) (*DescribeNotificationsForBudgetOutput, error)

DescribeNotificationsForBudget API operation for AWS Budgets.

Lists the notifications that are associated with a budget.

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 Budgets's API operation DescribeNotificationsForBudget for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • InvalidNextTokenException The pagination token is invalid.

  • ExpiredNextTokenException The pagination token expired.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DescribeNotificationsForBudgetRequest 

func (c *Budgets) DescribeNotificationsForBudgetRequest(input *DescribeNotificationsForBudgetInput) (req *request.Request, output *DescribeNotificationsForBudgetOutput)

DescribeNotificationsForBudgetRequest generates a "aws/request.Request" representing the client's request for the DescribeNotificationsForBudget operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeNotificationsForBudget for more information on using the DescribeNotificationsForBudget 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 DescribeNotificationsForBudgetRequest method.
req, resp := client.DescribeNotificationsForBudgetRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DescribeNotificationsForBudgetWithContext added in v1.8.0 

func (c *Budgets) DescribeNotificationsForBudgetWithContext(ctx aws.Context, input *DescribeNotificationsForBudgetInput, opts ...request.Option) (*DescribeNotificationsForBudgetOutput, error)

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

See DescribeNotificationsForBudget 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 (*Budgets) DescribeSubscribersForNotification 

func (c *Budgets) DescribeSubscribersForNotification(input *DescribeSubscribersForNotificationInput) (*DescribeSubscribersForNotificationOutput, error)

DescribeSubscribersForNotification API operation for AWS Budgets.

Lists the subscribers that are associated with a notification.

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 Budgets's API operation DescribeSubscribersForNotification for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • NotFoundException We can’t locate the resource that you specified.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • InvalidNextTokenException The pagination token is invalid.

  • ExpiredNextTokenException The pagination token expired.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) DescribeSubscribersForNotificationRequest 

func (c *Budgets) DescribeSubscribersForNotificationRequest(input *DescribeSubscribersForNotificationInput) (req *request.Request, output *DescribeSubscribersForNotificationOutput)

DescribeSubscribersForNotificationRequest generates a "aws/request.Request" representing the client's request for the DescribeSubscribersForNotification operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeSubscribersForNotification for more information on using the DescribeSubscribersForNotification 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 DescribeSubscribersForNotificationRequest method.
req, resp := client.DescribeSubscribersForNotificationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) DescribeSubscribersForNotificationWithContext added in v1.8.0 

func (c *Budgets) DescribeSubscribersForNotificationWithContext(ctx aws.Context, input *DescribeSubscribersForNotificationInput, opts ...request.Option) (*DescribeSubscribersForNotificationOutput, error)

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

See DescribeSubscribersForNotification 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 (*Budgets) UpdateBudget 

func (c *Budgets) UpdateBudget(input *UpdateBudgetInput) (*UpdateBudgetOutput, error)

UpdateBudget API operation for AWS Budgets.

Updates a budget. You can change every part of a budget except for the budgetName and the calculatedSpend. When you modify a budget, the calculatedSpend drops to zero until AWS has new usage data to use for forecasting.

Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_UpdateBudget.html#API_UpdateBudget_Examples) section.

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 Budgets's API operation UpdateBudget for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) UpdateBudgetRequest 

func (c *Budgets) UpdateBudgetRequest(input *UpdateBudgetInput) (req *request.Request, output *UpdateBudgetOutput)

UpdateBudgetRequest generates a "aws/request.Request" representing the client's request for the UpdateBudget operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateBudget for more information on using the UpdateBudget 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 UpdateBudgetRequest method.
req, resp := client.UpdateBudgetRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) UpdateBudgetWithContext added in v1.8.0 

func (c *Budgets) UpdateBudgetWithContext(ctx aws.Context, input *UpdateBudgetInput, opts ...request.Option) (*UpdateBudgetOutput, error)

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

See UpdateBudget 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 (*Budgets) UpdateNotification 

func (c *Budgets) UpdateNotification(input *UpdateNotificationInput) (*UpdateNotificationOutput, error)

UpdateNotification API operation for AWS Budgets.

Updates a notification.

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 Budgets's API operation UpdateNotification for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) UpdateNotificationRequest 

func (c *Budgets) UpdateNotificationRequest(input *UpdateNotificationInput) (req *request.Request, output *UpdateNotificationOutput)

UpdateNotificationRequest generates a "aws/request.Request" representing the client's request for the UpdateNotification operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateNotification for more information on using the UpdateNotification 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 UpdateNotificationRequest method.
req, resp := client.UpdateNotificationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) UpdateNotificationWithContext added in v1.8.0 

func (c *Budgets) UpdateNotificationWithContext(ctx aws.Context, input *UpdateNotificationInput, opts ...request.Option) (*UpdateNotificationOutput, error)

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

See UpdateNotification 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 (*Budgets) UpdateSubscriber 

func (c *Budgets) UpdateSubscriber(input *UpdateSubscriberInput) (*UpdateSubscriberOutput, error)

UpdateSubscriber API operation for AWS Budgets.

Updates a subscriber.

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 Budgets's API operation UpdateSubscriber for usage and error information.

Returned Error Types:

  • InternalErrorException An error on the server occurred during the processing of your request. Try again later.

  • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.

  • NotFoundException We can’t locate the resource that you specified.

  • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.

  • AccessDeniedException You are not authorized to use this operation with the given parameters.

func (*Budgets) UpdateSubscriberRequest 

func (c *Budgets) UpdateSubscriberRequest(input *UpdateSubscriberInput) (req *request.Request, output *UpdateSubscriberOutput)

UpdateSubscriberRequest generates a "aws/request.Request" representing the client's request for the UpdateSubscriber operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateSubscriber for more information on using the UpdateSubscriber 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 UpdateSubscriberRequest method.
req, resp := client.UpdateSubscriberRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*Budgets) UpdateSubscriberWithContext added in v1.8.0 

func (c *Budgets) UpdateSubscriberWithContext(ctx aws.Context, input *UpdateSubscriberInput, opts ...request.Option) (*UpdateSubscriberOutput, error)

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

See UpdateSubscriber 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 CalculatedSpend 

type CalculatedSpend struct {

	// The amount of cost, usage, or RI units that you have used.
	//
	// ActualSpend is a required field
	ActualSpend *Spend `type:"structure" required:"true"`

	// The amount of cost, usage, or RI units that you are forecasted to use.
	ForecastedSpend *Spend `type:"structure"`
	// contains filtered or unexported fields
}

The spend objects that are associated with this budget. The actualSpend tracks how much you've used, cost, usage, or RI units, and the forecastedSpend tracks how much you are predicted to spend if your current usage remains steady.

For example, if it is the 20th of the month and you have spent 50 dollars on Amazon EC2, your actualSpend is 50 USD, and your forecastedSpend is 75 USD.

func (CalculatedSpend) GoString 

func (s CalculatedSpend) GoString() string

GoString returns the string representation

func (*CalculatedSpend) SetActualSpend added in v1.5.0 

func (s *CalculatedSpend) SetActualSpend(v *Spend) *CalculatedSpend

SetActualSpend sets the ActualSpend field's value.

func (*CalculatedSpend) SetForecastedSpend added in v1.5.0 

func (s *CalculatedSpend) SetForecastedSpend(v *Spend) *CalculatedSpend

SetForecastedSpend sets the ForecastedSpend field's value.

func (CalculatedSpend) String 

func (s CalculatedSpend) String() string

String returns the string representation

func (*CalculatedSpend) Validate 

func (s *CalculatedSpend) Validate() error

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

type CostTypes 

type CostTypes struct {

	// Specifies whether a budget includes credits.
	//
	// The default value is true.
	IncludeCredit *bool `type:"boolean"`

	// Specifies whether a budget includes discounts.
	//
	// The default value is true.
	IncludeDiscount *bool `type:"boolean"`

	// Specifies whether a budget includes non-RI subscription costs.
	//
	// The default value is true.
	IncludeOtherSubscription *bool `type:"boolean"`

	// Specifies whether a budget includes recurring fees such as monthly RI fees.
	//
	// The default value is true.
	IncludeRecurring *bool `type:"boolean"`

	// Specifies whether a budget includes refunds.
	//
	// The default value is true.
	IncludeRefund *bool `type:"boolean"`

	// Specifies whether a budget includes subscriptions.
	//
	// The default value is true.
	IncludeSubscription *bool `type:"boolean"`

	// Specifies whether a budget includes support subscription fees.
	//
	// The default value is true.
	IncludeSupport *bool `type:"boolean"`

	// Specifies whether a budget includes taxes.
	//
	// The default value is true.
	IncludeTax *bool `type:"boolean"`

	// Specifies whether a budget includes upfront RI costs.
	//
	// The default value is true.
	IncludeUpfront *bool `type:"boolean"`

	// Specifies whether a budget uses the amortized rate.
	//
	// The default value is false.
	UseAmortized *bool `type:"boolean"`

	// Specifies whether a budget uses a blended rate.
	//
	// The default value is false.
	UseBlended *bool `type:"boolean"`
	// contains filtered or unexported fields
}

The types of cost that are included in a COST budget, such as tax and subscriptions.

USAGE, RI_UTILIZATION, and RI_COVERAGE budgets do not have CostTypes.

func (CostTypes) GoString 

func (s CostTypes) GoString() string

GoString returns the string representation

func (*CostTypes) SetIncludeCredit added in v1.12.40 

func (s *CostTypes) SetIncludeCredit(v bool) *CostTypes

SetIncludeCredit sets the IncludeCredit field's value.

func (*CostTypes) SetIncludeDiscount added in v1.12.67 

func (s *CostTypes) SetIncludeDiscount(v bool) *CostTypes

SetIncludeDiscount sets the IncludeDiscount field's value.

func (*CostTypes) SetIncludeOtherSubscription added in v1.12.40 

func (s *CostTypes) SetIncludeOtherSubscription(v bool) *CostTypes

SetIncludeOtherSubscription sets the IncludeOtherSubscription field's value.

func (*CostTypes) SetIncludeRecurring added in v1.12.40 

func (s *CostTypes) SetIncludeRecurring(v bool) *CostTypes

SetIncludeRecurring sets the IncludeRecurring field's value.

func (*CostTypes) SetIncludeRefund added in v1.12.40 

func (s *CostTypes) SetIncludeRefund(v bool) *CostTypes

SetIncludeRefund sets the IncludeRefund field's value.

func (*CostTypes) SetIncludeSubscription added in v1.5.0 

func (s *CostTypes) SetIncludeSubscription(v bool) *CostTypes

SetIncludeSubscription sets the IncludeSubscription field's value.

func (*CostTypes) SetIncludeSupport added in v1.12.40 

func (s *CostTypes) SetIncludeSupport(v bool) *CostTypes

SetIncludeSupport sets the IncludeSupport field's value.

func (*CostTypes) SetIncludeTax added in v1.5.0 

func (s *CostTypes) SetIncludeTax(v bool) *CostTypes

SetIncludeTax sets the IncludeTax field's value.

func (*CostTypes) SetIncludeUpfront added in v1.12.40 

func (s *CostTypes) SetIncludeUpfront(v bool) *CostTypes

SetIncludeUpfront sets the IncludeUpfront field's value.

func (*CostTypes) SetUseAmortized added in v1.12.67 

func (s *CostTypes) SetUseAmortized(v bool) *CostTypes

SetUseAmortized sets the UseAmortized field's value.

func (*CostTypes) SetUseBlended added in v1.5.0 

func (s *CostTypes) SetUseBlended(v bool) *CostTypes

SetUseBlended sets the UseBlended field's value.

func (CostTypes) String 

func (s CostTypes) String() string

String returns the string representation

type CreateBudgetInput 

type CreateBudgetInput struct {

	// The accountId that is associated with the budget.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The budget object that you want to create.
	//
	// Budget is a required field
	Budget *Budget `type:"structure" required:"true"`

	// A notification that you want to associate with a budget. A budget can have
	// up to five notifications, and each notification can have one SNS subscriber
	// and up to 10 email subscribers. If you include notifications and subscribers
	// in your CreateBudget call, AWS creates the notifications and subscribers
	// for you.
	NotificationsWithSubscribers []*NotificationWithSubscribers `type:"list"`
	// contains filtered or unexported fields
}

Request of CreateBudget

func (CreateBudgetInput) GoString 

func (s CreateBudgetInput) GoString() string

GoString returns the string representation

func (*CreateBudgetInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*CreateBudgetInput) SetBudget added in v1.5.0 

func (s *CreateBudgetInput) SetBudget(v *Budget) *CreateBudgetInput

SetBudget sets the Budget field's value.

func (*CreateBudgetInput) SetNotificationsWithSubscribers added in v1.5.0 

func (s *CreateBudgetInput) SetNotificationsWithSubscribers(v []*NotificationWithSubscribers) *CreateBudgetInput

SetNotificationsWithSubscribers sets the NotificationsWithSubscribers field's value.

func (CreateBudgetInput) String 

func (s CreateBudgetInput) String() string

String returns the string representation

func (*CreateBudgetInput) Validate 

func (s *CreateBudgetInput) Validate() error

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

type CreateBudgetOutput 

type CreateBudgetOutput struct {
	// contains filtered or unexported fields
}

Response of CreateBudget

func (CreateBudgetOutput) GoString 

func (s CreateBudgetOutput) GoString() string

GoString returns the string representation

func (CreateBudgetOutput) String 

func (s CreateBudgetOutput) String() string

String returns the string representation

type CreateNotificationInput 

type CreateNotificationInput struct {

	// The accountId that is associated with the budget that you want to create
	// a notification for.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget that you want AWS to notify you about. Budget names
	// must be unique within an account.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// The notification that you want to create.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`

	// A list of subscribers that you want to associate with the notification. Each
	// notification can have one SNS subscriber and up to 10 email subscribers.
	//
	// Subscribers is a required field
	Subscribers []*Subscriber `min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

Request of CreateNotification

func (CreateNotificationInput) GoString 

func (s CreateNotificationInput) GoString() string

GoString returns the string representation

func (*CreateNotificationInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*CreateNotificationInput) SetBudgetName added in v1.5.0 

func (s *CreateNotificationInput) SetBudgetName(v string) *CreateNotificationInput

SetBudgetName sets the BudgetName field's value.

func (*CreateNotificationInput) SetNotification added in v1.5.0 

func (s *CreateNotificationInput) SetNotification(v *Notification) *CreateNotificationInput

SetNotification sets the Notification field's value.

func (*CreateNotificationInput) SetSubscribers added in v1.5.0 

func (s *CreateNotificationInput) SetSubscribers(v []*Subscriber) *CreateNotificationInput

SetSubscribers sets the Subscribers field's value.

func (CreateNotificationInput) String 

func (s CreateNotificationInput) String() string

String returns the string representation

func (*CreateNotificationInput) Validate 

func (s *CreateNotificationInput) Validate() error

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

type CreateNotificationOutput 

type CreateNotificationOutput struct {
	// contains filtered or unexported fields
}

Response of CreateNotification

func (CreateNotificationOutput) GoString 

func (s CreateNotificationOutput) GoString() string

GoString returns the string representation

func (CreateNotificationOutput) String 

func (s CreateNotificationOutput) String() string

String returns the string representation

type CreateSubscriberInput 

type CreateSubscriberInput struct {

	// The accountId that is associated with the budget that you want to create
	// a subscriber for.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget that you want to subscribe to. Budget names must be
	// unique within an account.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// The notification that you want to create a subscriber for.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`

	// The subscriber that you want to associate with a budget notification.
	//
	// Subscriber is a required field
	Subscriber *Subscriber `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of CreateSubscriber

func (CreateSubscriberInput) GoString 

func (s CreateSubscriberInput) GoString() string

GoString returns the string representation

func (*CreateSubscriberInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*CreateSubscriberInput) SetBudgetName added in v1.5.0 

func (s *CreateSubscriberInput) SetBudgetName(v string) *CreateSubscriberInput

SetBudgetName sets the BudgetName field's value.

func (*CreateSubscriberInput) SetNotification added in v1.5.0 

func (s *CreateSubscriberInput) SetNotification(v *Notification) *CreateSubscriberInput

SetNotification sets the Notification field's value.

func (*CreateSubscriberInput) SetSubscriber added in v1.5.0 

func (s *CreateSubscriberInput) SetSubscriber(v *Subscriber) *CreateSubscriberInput

SetSubscriber sets the Subscriber field's value.

func (CreateSubscriberInput) String 

func (s CreateSubscriberInput) String() string

String returns the string representation

func (*CreateSubscriberInput) Validate 

func (s *CreateSubscriberInput) Validate() error

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

type CreateSubscriberOutput 

type CreateSubscriberOutput struct {
	// contains filtered or unexported fields
}

Response of CreateSubscriber

func (CreateSubscriberOutput) GoString 

func (s CreateSubscriberOutput) GoString() string

GoString returns the string representation

func (CreateSubscriberOutput) String 

func (s CreateSubscriberOutput) String() string

String returns the string representation

type CreationLimitExceededException added in v1.28.0 

type CreationLimitExceededException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

You've exceeded the notification or subscriber limit.

func (*CreationLimitExceededException) Code added in v1.28.0 

func (s *CreationLimitExceededException) Code() string

Code returns the exception type name.

func (*CreationLimitExceededException) Error added in v1.28.0 

func (s *CreationLimitExceededException) Error() string

func (CreationLimitExceededException) GoString added in v1.28.0 

func (s CreationLimitExceededException) GoString() string

GoString returns the string representation

func (*CreationLimitExceededException) Message added in v1.28.0 

func (s *CreationLimitExceededException) Message() string

Message returns the exception's message.

func (*CreationLimitExceededException) OrigErr added in v1.28.0 

func (s *CreationLimitExceededException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*CreationLimitExceededException) RequestID added in v1.28.0 

func (s *CreationLimitExceededException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*CreationLimitExceededException) StatusCode added in v1.28.0 

func (s *CreationLimitExceededException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (CreationLimitExceededException) String added in v1.28.0 

func (s CreationLimitExceededException) String() string

String returns the string representation

type DeleteBudgetInput 

type DeleteBudgetInput struct {

	// The accountId that is associated with the budget that you want to delete.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget that you want to delete.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Request of DeleteBudget

func (DeleteBudgetInput) GoString 

func (s DeleteBudgetInput) GoString() string

GoString returns the string representation

func (*DeleteBudgetInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DeleteBudgetInput) SetBudgetName added in v1.5.0 

func (s *DeleteBudgetInput) SetBudgetName(v string) *DeleteBudgetInput

SetBudgetName sets the BudgetName field's value.

func (DeleteBudgetInput) String 

func (s DeleteBudgetInput) String() string

String returns the string representation

func (*DeleteBudgetInput) Validate 

func (s *DeleteBudgetInput) Validate() error

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

type DeleteBudgetOutput 

type DeleteBudgetOutput struct {
	// contains filtered or unexported fields
}

Response of DeleteBudget

func (DeleteBudgetOutput) GoString 

func (s DeleteBudgetOutput) GoString() string

GoString returns the string representation

func (DeleteBudgetOutput) String 

func (s DeleteBudgetOutput) String() string

String returns the string representation

type DeleteNotificationInput 

type DeleteNotificationInput struct {

	// The accountId that is associated with the budget whose notification you want
	// to delete.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget whose notification you want to delete.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// The notification that you want to delete.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of DeleteNotification

func (DeleteNotificationInput) GoString 

func (s DeleteNotificationInput) GoString() string

GoString returns the string representation

func (*DeleteNotificationInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DeleteNotificationInput) SetBudgetName added in v1.5.0 

func (s *DeleteNotificationInput) SetBudgetName(v string) *DeleteNotificationInput

SetBudgetName sets the BudgetName field's value.

func (*DeleteNotificationInput) SetNotification added in v1.5.0 

func (s *DeleteNotificationInput) SetNotification(v *Notification) *DeleteNotificationInput

SetNotification sets the Notification field's value.

func (DeleteNotificationInput) String 

func (s DeleteNotificationInput) String() string

String returns the string representation

func (*DeleteNotificationInput) Validate 

func (s *DeleteNotificationInput) Validate() error

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

type DeleteNotificationOutput 

type DeleteNotificationOutput struct {
	// contains filtered or unexported fields
}

Response of DeleteNotification

func (DeleteNotificationOutput) GoString 

func (s DeleteNotificationOutput) GoString() string

GoString returns the string representation

func (DeleteNotificationOutput) String 

func (s DeleteNotificationOutput) String() string

String returns the string representation

type DeleteSubscriberInput 

type DeleteSubscriberInput struct {

	// The accountId that is associated with the budget whose subscriber you want
	// to delete.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget whose subscriber you want to delete.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// The notification whose subscriber you want to delete.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`

	// The subscriber that you want to delete.
	//
	// Subscriber is a required field
	Subscriber *Subscriber `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of DeleteSubscriber

func (DeleteSubscriberInput) GoString 

func (s DeleteSubscriberInput) GoString() string

GoString returns the string representation

func (*DeleteSubscriberInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DeleteSubscriberInput) SetBudgetName added in v1.5.0 

func (s *DeleteSubscriberInput) SetBudgetName(v string) *DeleteSubscriberInput

SetBudgetName sets the BudgetName field's value.

func (*DeleteSubscriberInput) SetNotification added in v1.5.0 

func (s *DeleteSubscriberInput) SetNotification(v *Notification) *DeleteSubscriberInput

SetNotification sets the Notification field's value.

func (*DeleteSubscriberInput) SetSubscriber added in v1.5.0 

func (s *DeleteSubscriberInput) SetSubscriber(v *Subscriber) *DeleteSubscriberInput

SetSubscriber sets the Subscriber field's value.

func (DeleteSubscriberInput) String 

func (s DeleteSubscriberInput) String() string

String returns the string representation

func (*DeleteSubscriberInput) Validate 

func (s *DeleteSubscriberInput) Validate() error

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

type DeleteSubscriberOutput 

type DeleteSubscriberOutput struct {
	// contains filtered or unexported fields
}

Response of DeleteSubscriber

func (DeleteSubscriberOutput) GoString 

func (s DeleteSubscriberOutput) GoString() string

GoString returns the string representation

func (DeleteSubscriberOutput) String 

func (s DeleteSubscriberOutput) String() string

String returns the string representation

type DescribeBudgetInput 

type DescribeBudgetInput struct {

	// The accountId that is associated with the budget that you want a description
	// of.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget that you want a description of.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Request of DescribeBudget

func (DescribeBudgetInput) GoString 

func (s DescribeBudgetInput) GoString() string

GoString returns the string representation

func (*DescribeBudgetInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DescribeBudgetInput) SetBudgetName added in v1.5.0 

func (s *DescribeBudgetInput) SetBudgetName(v string) *DescribeBudgetInput

SetBudgetName sets the BudgetName field's value.

func (DescribeBudgetInput) String 

func (s DescribeBudgetInput) String() string

String returns the string representation

func (*DescribeBudgetInput) Validate 

func (s *DescribeBudgetInput) Validate() error

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

type DescribeBudgetOutput 

type DescribeBudgetOutput struct {

	// The description of the budget.
	Budget *Budget `type:"structure"`
	// contains filtered or unexported fields
}

Response of DescribeBudget

func (DescribeBudgetOutput) GoString 

func (s DescribeBudgetOutput) GoString() string

GoString returns the string representation

func (*DescribeBudgetOutput) SetBudget added in v1.5.0 

func (s *DescribeBudgetOutput) SetBudget(v *Budget) *DescribeBudgetOutput

SetBudget sets the Budget field's value.

func (DescribeBudgetOutput) String 

func (s DescribeBudgetOutput) String() string

String returns the string representation

type DescribeBudgetPerformanceHistoryInput added in v1.15.74 

type DescribeBudgetPerformanceHistoryInput struct {

	// The account ID of the user. It should be a 12-digit number.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// A string that represents the budget name. The ":" and "\" characters aren't
	// allowed.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// An integer that represents how many entries a paginated response contains.
	// The maximum is 100.
	MaxResults *int64 `min:"1" type:"integer"`

	// A generic string.
	NextToken *string `type:"string"`

	// Retrieves how often the budget went into an ALARM state for the specified
	// time period.
	TimePeriod *TimePeriod `type:"structure"`
	// contains filtered or unexported fields
}

func (DescribeBudgetPerformanceHistoryInput) GoString added in v1.15.74 

func (s DescribeBudgetPerformanceHistoryInput) GoString() string

GoString returns the string representation

func (*DescribeBudgetPerformanceHistoryInput) SetAccountId added in v1.15.74 

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

SetAccountId sets the AccountId field's value.

func (*DescribeBudgetPerformanceHistoryInput) SetBudgetName added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryInput) SetBudgetName(v string) *DescribeBudgetPerformanceHistoryInput

SetBudgetName sets the BudgetName field's value.

func (*DescribeBudgetPerformanceHistoryInput) SetMaxResults added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryInput) SetMaxResults(v int64) *DescribeBudgetPerformanceHistoryInput

SetMaxResults sets the MaxResults field's value.

func (*DescribeBudgetPerformanceHistoryInput) SetNextToken added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryInput) SetNextToken(v string) *DescribeBudgetPerformanceHistoryInput

SetNextToken sets the NextToken field's value.

func (*DescribeBudgetPerformanceHistoryInput) SetTimePeriod added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryInput) SetTimePeriod(v *TimePeriod) *DescribeBudgetPerformanceHistoryInput

SetTimePeriod sets the TimePeriod field's value.

func (DescribeBudgetPerformanceHistoryInput) String added in v1.15.74 

func (s DescribeBudgetPerformanceHistoryInput) String() string

String returns the string representation

func (*DescribeBudgetPerformanceHistoryInput) Validate added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryInput) Validate() error

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

type DescribeBudgetPerformanceHistoryOutput added in v1.15.74 

type DescribeBudgetPerformanceHistoryOutput struct {

	// The history of how often the budget has gone into an ALARM state.
	//
	// For DAILY budgets, the history saves the state of the budget for the last
	// 60 days. For MONTHLY budgets, the history saves the state of the budget for
	// the current month plus the last 12 months. For QUARTERLY budgets, the history
	// saves the state of the budget for the last four quarters.
	BudgetPerformanceHistory *BudgetPerformanceHistory `type:"structure"`

	// A generic string.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeBudgetPerformanceHistoryOutput) GoString added in v1.15.74 

func (s DescribeBudgetPerformanceHistoryOutput) GoString() string

GoString returns the string representation

func (*DescribeBudgetPerformanceHistoryOutput) SetBudgetPerformanceHistory added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryOutput) SetBudgetPerformanceHistory(v *BudgetPerformanceHistory) *DescribeBudgetPerformanceHistoryOutput

SetBudgetPerformanceHistory sets the BudgetPerformanceHistory field's value.

func (*DescribeBudgetPerformanceHistoryOutput) SetNextToken added in v1.15.74 

func (s *DescribeBudgetPerformanceHistoryOutput) SetNextToken(v string) *DescribeBudgetPerformanceHistoryOutput

SetNextToken sets the NextToken field's value.

func (DescribeBudgetPerformanceHistoryOutput) String added in v1.15.74 

func (s DescribeBudgetPerformanceHistoryOutput) String() string

String returns the string representation

type DescribeBudgetsInput 

type DescribeBudgetsInput struct {

	// The accountId that is associated with the budgets that you want descriptions
	// of.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// An optional integer that represents how many entries a paginated response
	// contains. The maximum is 100.
	MaxResults *int64 `min:"1" type:"integer"`

	// The pagination token that you include in your request to indicate the next
	// set of results that you want to retrieve.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

Request of DescribeBudgets

func (DescribeBudgetsInput) GoString 

func (s DescribeBudgetsInput) GoString() string

GoString returns the string representation

func (*DescribeBudgetsInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DescribeBudgetsInput) SetMaxResults added in v1.5.0 

func (s *DescribeBudgetsInput) SetMaxResults(v int64) *DescribeBudgetsInput

SetMaxResults sets the MaxResults field's value.

func (*DescribeBudgetsInput) SetNextToken added in v1.5.0 

func (s *DescribeBudgetsInput) SetNextToken(v string) *DescribeBudgetsInput

SetNextToken sets the NextToken field's value.

func (DescribeBudgetsInput) String 

func (s DescribeBudgetsInput) String() string

String returns the string representation

func (*DescribeBudgetsInput) Validate 

func (s *DescribeBudgetsInput) Validate() error

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

type DescribeBudgetsOutput 

type DescribeBudgetsOutput struct {

	// A list of budgets.
	Budgets []*Budget `type:"list"`

	// The pagination token in the service response that indicates the next set
	// of results that you can retrieve.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

Response of DescribeBudgets

func (DescribeBudgetsOutput) GoString 

func (s DescribeBudgetsOutput) GoString() string

GoString returns the string representation

func (*DescribeBudgetsOutput) SetBudgets added in v1.5.0 

func (s *DescribeBudgetsOutput) SetBudgets(v []*Budget) *DescribeBudgetsOutput

SetBudgets sets the Budgets field's value.

func (*DescribeBudgetsOutput) SetNextToken added in v1.5.0 

func (s *DescribeBudgetsOutput) SetNextToken(v string) *DescribeBudgetsOutput

SetNextToken sets the NextToken field's value.

func (DescribeBudgetsOutput) String 

func (s DescribeBudgetsOutput) String() string

String returns the string representation

type DescribeNotificationsForBudgetInput 

type DescribeNotificationsForBudgetInput struct {

	// The accountId that is associated with the budget whose notifications you
	// want descriptions of.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget whose notifications you want descriptions of.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// An optional integer that represents how many entries a paginated response
	// contains. The maximum is 100.
	MaxResults *int64 `min:"1" type:"integer"`

	// The pagination token that you include in your request to indicate the next
	// set of results that you want to retrieve.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

Request of DescribeNotificationsForBudget

func (DescribeNotificationsForBudgetInput) GoString 

func (s DescribeNotificationsForBudgetInput) GoString() string

GoString returns the string representation

func (*DescribeNotificationsForBudgetInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DescribeNotificationsForBudgetInput) SetBudgetName added in v1.5.0 

func (s *DescribeNotificationsForBudgetInput) SetBudgetName(v string) *DescribeNotificationsForBudgetInput

SetBudgetName sets the BudgetName field's value.

func (*DescribeNotificationsForBudgetInput) SetMaxResults added in v1.5.0 

func (s *DescribeNotificationsForBudgetInput) SetMaxResults(v int64) *DescribeNotificationsForBudgetInput

SetMaxResults sets the MaxResults field's value.

func (*DescribeNotificationsForBudgetInput) SetNextToken added in v1.5.0 

func (s *DescribeNotificationsForBudgetInput) SetNextToken(v string) *DescribeNotificationsForBudgetInput

SetNextToken sets the NextToken field's value.

func (DescribeNotificationsForBudgetInput) String 

func (s DescribeNotificationsForBudgetInput) String() string

String returns the string representation

func (*DescribeNotificationsForBudgetInput) Validate 

func (s *DescribeNotificationsForBudgetInput) Validate() error

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

type DescribeNotificationsForBudgetOutput 

type DescribeNotificationsForBudgetOutput struct {

	// The pagination token in the service response that indicates the next set
	// of results that you can retrieve.
	NextToken *string `type:"string"`

	// A list of notifications that are associated with a budget.
	Notifications []*Notification `type:"list"`
	// contains filtered or unexported fields
}

Response of GetNotificationsForBudget

func (DescribeNotificationsForBudgetOutput) GoString 

func (s DescribeNotificationsForBudgetOutput) GoString() string

GoString returns the string representation

func (*DescribeNotificationsForBudgetOutput) SetNextToken added in v1.5.0 

func (s *DescribeNotificationsForBudgetOutput) SetNextToken(v string) *DescribeNotificationsForBudgetOutput

SetNextToken sets the NextToken field's value.

func (*DescribeNotificationsForBudgetOutput) SetNotifications added in v1.5.0 

func (s *DescribeNotificationsForBudgetOutput) SetNotifications(v []*Notification) *DescribeNotificationsForBudgetOutput

SetNotifications sets the Notifications field's value.

func (DescribeNotificationsForBudgetOutput) String 

func (s DescribeNotificationsForBudgetOutput) String() string

String returns the string representation

type DescribeSubscribersForNotificationInput 

type DescribeSubscribersForNotificationInput struct {

	// The accountId that is associated with the budget whose subscribers you want
	// descriptions of.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget whose subscribers you want descriptions of.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// An optional integer that represents how many entries a paginated response
	// contains. The maximum is 100.
	MaxResults *int64 `min:"1" type:"integer"`

	// The pagination token that you include in your request to indicate the next
	// set of results that you want to retrieve.
	NextToken *string `type:"string"`

	// The notification whose subscribers you want to list.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of DescribeSubscribersForNotification

func (DescribeSubscribersForNotificationInput) GoString 

func (s DescribeSubscribersForNotificationInput) GoString() string

GoString returns the string representation

func (*DescribeSubscribersForNotificationInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*DescribeSubscribersForNotificationInput) SetBudgetName added in v1.5.0 

func (s *DescribeSubscribersForNotificationInput) SetBudgetName(v string) *DescribeSubscribersForNotificationInput

SetBudgetName sets the BudgetName field's value.

func (*DescribeSubscribersForNotificationInput) SetMaxResults added in v1.5.0 

func (s *DescribeSubscribersForNotificationInput) SetMaxResults(v int64) *DescribeSubscribersForNotificationInput

SetMaxResults sets the MaxResults field's value.

func (*DescribeSubscribersForNotificationInput) SetNextToken added in v1.5.0 

func (s *DescribeSubscribersForNotificationInput) SetNextToken(v string) *DescribeSubscribersForNotificationInput

SetNextToken sets the NextToken field's value.

func (*DescribeSubscribersForNotificationInput) SetNotification added in v1.5.0 

func (s *DescribeSubscribersForNotificationInput) SetNotification(v *Notification) *DescribeSubscribersForNotificationInput

SetNotification sets the Notification field's value.

func (DescribeSubscribersForNotificationInput) String 

func (s DescribeSubscribersForNotificationInput) String() string

String returns the string representation

func (*DescribeSubscribersForNotificationInput) Validate 

func (s *DescribeSubscribersForNotificationInput) Validate() error

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

type DescribeSubscribersForNotificationOutput 

type DescribeSubscribersForNotificationOutput struct {

	// The pagination token in the service response that indicates the next set
	// of results that you can retrieve.
	NextToken *string `type:"string"`

	// A list of subscribers that are associated with a notification.
	Subscribers []*Subscriber `min:"1" type:"list"`
	// contains filtered or unexported fields
}

Response of DescribeSubscribersForNotification

func (DescribeSubscribersForNotificationOutput) GoString 

func (s DescribeSubscribersForNotificationOutput) GoString() string

GoString returns the string representation

func (*DescribeSubscribersForNotificationOutput) SetNextToken added in v1.5.0 

func (s *DescribeSubscribersForNotificationOutput) SetNextToken(v string) *DescribeSubscribersForNotificationOutput

SetNextToken sets the NextToken field's value.

func (*DescribeSubscribersForNotificationOutput) SetSubscribers added in v1.5.0 

func (s *DescribeSubscribersForNotificationOutput) SetSubscribers(v []*Subscriber) *DescribeSubscribersForNotificationOutput

SetSubscribers sets the Subscribers field's value.

func (DescribeSubscribersForNotificationOutput) String 

func (s DescribeSubscribersForNotificationOutput) String() string

String returns the string representation

type DuplicateRecordException added in v1.28.0 

type DuplicateRecordException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

The budget name already exists. Budget names must be unique within an account.

func (*DuplicateRecordException) Code added in v1.28.0 

func (s *DuplicateRecordException) Code() string

Code returns the exception type name.

func (*DuplicateRecordException) Error added in v1.28.0 

func (s *DuplicateRecordException) Error() string

func (DuplicateRecordException) GoString added in v1.28.0 

func (s DuplicateRecordException) GoString() string

GoString returns the string representation

func (*DuplicateRecordException) Message added in v1.28.0 

func (s *DuplicateRecordException) Message() string

Message returns the exception's message.

func (*DuplicateRecordException) OrigErr added in v1.28.0 

func (s *DuplicateRecordException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*DuplicateRecordException) RequestID added in v1.28.0 

func (s *DuplicateRecordException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*DuplicateRecordException) StatusCode added in v1.28.0 

func (s *DuplicateRecordException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (DuplicateRecordException) String added in v1.28.0 

func (s DuplicateRecordException) String() string

String returns the string representation

type ExpiredNextTokenException added in v1.28.0 

type ExpiredNextTokenException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

The pagination token expired.

func (*ExpiredNextTokenException) Code added in v1.28.0 

func (s *ExpiredNextTokenException) Code() string

Code returns the exception type name.

func (*ExpiredNextTokenException) Error added in v1.28.0 

func (s *ExpiredNextTokenException) Error() string

func (ExpiredNextTokenException) GoString added in v1.28.0 

func (s ExpiredNextTokenException) GoString() string

GoString returns the string representation

func (*ExpiredNextTokenException) Message added in v1.28.0 

func (s *ExpiredNextTokenException) Message() string

Message returns the exception's message.

func (*ExpiredNextTokenException) OrigErr added in v1.28.0 

func (s *ExpiredNextTokenException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*ExpiredNextTokenException) RequestID added in v1.28.0 

func (s *ExpiredNextTokenException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*ExpiredNextTokenException) StatusCode added in v1.28.0 

func (s *ExpiredNextTokenException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (ExpiredNextTokenException) String added in v1.28.0 

func (s ExpiredNextTokenException) String() string

String returns the string representation

type InternalErrorException added in v1.28.0 

type InternalErrorException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

An error on the server occurred during the processing of your request. Try again later.

func (*InternalErrorException) Code added in v1.28.0 

func (s *InternalErrorException) Code() string

Code returns the exception type name.

func (*InternalErrorException) Error added in v1.28.0 

func (s *InternalErrorException) Error() string

func (InternalErrorException) GoString added in v1.28.0 

func (s InternalErrorException) GoString() string

GoString returns the string representation

func (*InternalErrorException) Message added in v1.28.0 

func (s *InternalErrorException) Message() string

Message returns the exception's message.

func (*InternalErrorException) OrigErr added in v1.28.0 

func (s *InternalErrorException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*InternalErrorException) RequestID added in v1.28.0 

func (s *InternalErrorException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*InternalErrorException) StatusCode added in v1.28.0 

func (s *InternalErrorException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (InternalErrorException) String added in v1.28.0 

func (s InternalErrorException) String() string

String returns the string representation

type InvalidNextTokenException added in v1.28.0 

type InvalidNextTokenException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

The pagination token is invalid.

func (*InvalidNextTokenException) Code added in v1.28.0 

func (s *InvalidNextTokenException) Code() string

Code returns the exception type name.

func (*InvalidNextTokenException) Error added in v1.28.0 

func (s *InvalidNextTokenException) Error() string

func (InvalidNextTokenException) GoString added in v1.28.0 

func (s InvalidNextTokenException) GoString() string

GoString returns the string representation

func (*InvalidNextTokenException) Message added in v1.28.0 

func (s *InvalidNextTokenException) Message() string

Message returns the exception's message.

func (*InvalidNextTokenException) OrigErr added in v1.28.0 

func (s *InvalidNextTokenException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*InvalidNextTokenException) RequestID added in v1.28.0 

func (s *InvalidNextTokenException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*InvalidNextTokenException) StatusCode added in v1.28.0 

func (s *InvalidNextTokenException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (InvalidNextTokenException) String added in v1.28.0 

func (s InvalidNextTokenException) String() string

String returns the string representation

type InvalidParameterException added in v1.28.0 

type InvalidParameterException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

An error on the client occurred. Typically, the cause is an invalid input value.

func (*InvalidParameterException) Code added in v1.28.0 

func (s *InvalidParameterException) Code() string

Code returns the exception type name.

func (*InvalidParameterException) Error added in v1.28.0 

func (s *InvalidParameterException) Error() string

func (InvalidParameterException) GoString added in v1.28.0 

func (s InvalidParameterException) GoString() string

GoString returns the string representation

func (*InvalidParameterException) Message added in v1.28.0 

func (s *InvalidParameterException) Message() string

Message returns the exception's message.

func (*InvalidParameterException) OrigErr added in v1.28.0 

func (s *InvalidParameterException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*InvalidParameterException) RequestID added in v1.28.0 

func (s *InvalidParameterException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*InvalidParameterException) StatusCode added in v1.28.0 

func (s *InvalidParameterException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (InvalidParameterException) String added in v1.28.0 

func (s InvalidParameterException) String() string

String returns the string representation

type NotFoundException added in v1.28.0 

type NotFoundException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The error message the exception carries.
	Message_ *string `locationName:"Message" type:"string"`
	// contains filtered or unexported fields
}

We can’t locate the resource that you specified.

func (*NotFoundException) Code added in v1.28.0 

func (s *NotFoundException) Code() string

Code returns the exception type name.

func (*NotFoundException) Error added in v1.28.0 

func (s *NotFoundException) Error() string

func (NotFoundException) GoString added in v1.28.0 

func (s NotFoundException) GoString() string

GoString returns the string representation

func (*NotFoundException) Message added in v1.28.0 

func (s *NotFoundException) Message() string

Message returns the exception's message.

func (*NotFoundException) OrigErr added in v1.28.0 

func (s *NotFoundException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*NotFoundException) RequestID added in v1.28.0 

func (s *NotFoundException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*NotFoundException) StatusCode added in v1.28.0 

func (s *NotFoundException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (NotFoundException) String added in v1.28.0 

func (s NotFoundException) String() string

String returns the string representation

type Notification 

type Notification struct {

	// The comparison that is used for this notification.
	//
	// ComparisonOperator is a required field
	ComparisonOperator *string `type:"string" required:"true" enum:"ComparisonOperator"`

	// Whether this notification is in alarm. If a budget notification is in the
	// ALARM state, you have passed the set threshold for the budget.
	NotificationState *string `type:"string" enum:"NotificationState"`

	// Whether the notification is for how much you have spent (ACTUAL) or for how
	// much you're forecasted to spend (FORECASTED).
	//
	// NotificationType is a required field
	NotificationType *string `type:"string" required:"true" enum:"NotificationType"`

	// The threshold that is associated with a notification. Thresholds are always
	// a percentage.
	//
	// Threshold is a required field
	Threshold *float64 `type:"double" required:"true"`

	// The type of threshold for a notification. For ABSOLUTE_VALUE thresholds,
	// AWS notifies you when you go over or are forecasted to go over your total
	// cost threshold. For PERCENTAGE thresholds, AWS notifies you when you go over
	// or are forecasted to go over a certain percentage of your forecasted spend.
	// For example, if you have a budget for 200 dollars and you have a PERCENTAGE
	// threshold of 80%, AWS notifies you when you go over 160 dollars.
	ThresholdType *string `type:"string" enum:"ThresholdType"`
	// contains filtered or unexported fields
}

A notification that is associated with a budget. A budget can have up to five notifications.

Each notification must have at least one subscriber. A notification can have one SNS subscriber and up to 10 email subscribers, for a total of 11 subscribers.

For example, if you have a budget for 200 dollars and you want to be notified when you go over 160 dollars, create a notification with the following parameters:

  • A notificationType of ACTUAL

  • A thresholdType of PERCENTAGE

  • A comparisonOperator of GREATER_THAN

  • A notification threshold of 80

func (Notification) GoString 

func (s Notification) GoString() string

GoString returns the string representation

func (*Notification) SetComparisonOperator added in v1.5.0 

func (s *Notification) SetComparisonOperator(v string) *Notification

SetComparisonOperator sets the ComparisonOperator field's value.

func (*Notification) SetNotificationState added in v1.15.74 

func (s *Notification) SetNotificationState(v string) *Notification

SetNotificationState sets the NotificationState field's value.

func (*Notification) SetNotificationType added in v1.5.0 

func (s *Notification) SetNotificationType(v string) *Notification

SetNotificationType sets the NotificationType field's value.

func (*Notification) SetThreshold added in v1.5.0 

func (s *Notification) SetThreshold(v float64) *Notification

SetThreshold sets the Threshold field's value.

func (*Notification) SetThresholdType added in v1.10.39 

func (s *Notification) SetThresholdType(v string) *Notification

SetThresholdType sets the ThresholdType field's value.

func (Notification) String 

func (s Notification) String() string

String returns the string representation

func (*Notification) Validate 

func (s *Notification) Validate() error

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

type NotificationWithSubscribers 

type NotificationWithSubscribers struct {

	// The notification that is associated with a budget.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`

	// A list of subscribers who are subscribed to this notification.
	//
	// Subscribers is a required field
	Subscribers []*Subscriber `min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

A notification with subscribers. A notification can have one SNS subscriber and up to 10 email subscribers, for a total of 11 subscribers.

func (NotificationWithSubscribers) GoString 

func (s NotificationWithSubscribers) GoString() string

GoString returns the string representation

func (*NotificationWithSubscribers) SetNotification added in v1.5.0 

func (s *NotificationWithSubscribers) SetNotification(v *Notification) *NotificationWithSubscribers

SetNotification sets the Notification field's value.

func (*NotificationWithSubscribers) SetSubscribers added in v1.5.0 

func (s *NotificationWithSubscribers) SetSubscribers(v []*Subscriber) *NotificationWithSubscribers

SetSubscribers sets the Subscribers field's value.

func (NotificationWithSubscribers) String 

func (s NotificationWithSubscribers) String() string

String returns the string representation

func (*NotificationWithSubscribers) Validate 

func (s *NotificationWithSubscribers) Validate() error

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

type Spend 

type Spend struct {

	// The cost or usage amount that is associated with a budget forecast, actual
	// spend, or budget threshold.
	//
	// Amount is a required field
	Amount *string `min:"1" type:"string" required:"true"`

	// The unit of measurement that is used for the budget forecast, actual spend,
	// or budget threshold, such as dollars or GB.
	//
	// Unit is a required field
	Unit *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

The amount of cost or usage that is measured for a budget.

For example, a Spend for 3 GB of S3 usage would have the following parameters:

  • An Amount of 3

  • A unit of GB

func (Spend) GoString 

func (s Spend) GoString() string

GoString returns the string representation

func (*Spend) SetAmount added in v1.5.0 

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

SetAmount sets the Amount field's value.

func (*Spend) SetUnit added in v1.5.0 

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

SetUnit sets the Unit field's value.

func (Spend) String 

func (s Spend) String() string

String returns the string representation

func (*Spend) Validate 

func (s *Spend) Validate() error

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

type Subscriber 

type Subscriber struct {

	// The address that AWS sends budget notifications to, either an SNS topic or
	// an email.
	//
	// When you create a subscriber, the value of Address can't contain line breaks.
	//
	// Address is a required field
	Address *string `min:"1" type:"string" required:"true" sensitive:"true"`

	// The type of notification that AWS sends to a subscriber.
	//
	// SubscriptionType is a required field
	SubscriptionType *string `type:"string" required:"true" enum:"SubscriptionType"`
	// contains filtered or unexported fields
}

The subscriber to a budget notification. The subscriber consists of a subscription type and either an Amazon SNS topic or an email address.

For example, an email subscriber would have the following parameters:

  • A subscriptionType of EMAIL

  • An address of example@example.com

func (Subscriber) GoString 

func (s Subscriber) GoString() string

GoString returns the string representation

func (*Subscriber) SetAddress added in v1.5.0 

func (s *Subscriber) SetAddress(v string) *Subscriber

SetAddress sets the Address field's value.

func (*Subscriber) SetSubscriptionType added in v1.5.0 

func (s *Subscriber) SetSubscriptionType(v string) *Subscriber

SetSubscriptionType sets the SubscriptionType field's value.

func (Subscriber) String 

func (s Subscriber) String() string

String returns the string representation

func (*Subscriber) Validate 

func (s *Subscriber) Validate() error

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

type TimePeriod 

type TimePeriod struct {

	// The end date for a budget. If you didn't specify an end date, AWS set your
	// end date to 06/15/87 00:00 UTC. The defaults are the same for the AWS Billing
	// and Cost Management console and the API.
	//
	// After the end date, AWS deletes the budget and all associated notifications
	// and subscribers. You can change your end date with the UpdateBudget operation.
	End *time.Time `type:"timestamp"`

	// The start date for a budget. If you created your budget and didn't specify
	// a start date, AWS defaults to the start of your chosen time period (DAILY,
	// MONTHLY, QUARTERLY, or ANNUALLY). For example, if you created your budget
	// on January 24, 2018, chose DAILY, and didn't set a start date, AWS set your
	// start date to 01/24/18 00:00 UTC. If you chose MONTHLY, AWS set your start
	// date to 01/01/18 00:00 UTC. The defaults are the same for the AWS Billing
	// and Cost Management console and the API.
	//
	// You can change your start date with the UpdateBudget operation.
	Start *time.Time `type:"timestamp"`
	// contains filtered or unexported fields
}

The period of time that is covered by a budget. The period has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date.

func (TimePeriod) GoString 

func (s TimePeriod) GoString() string

GoString returns the string representation

func (*TimePeriod) SetEnd added in v1.5.0 

func (s *TimePeriod) SetEnd(v time.Time) *TimePeriod

SetEnd sets the End field's value.

func (*TimePeriod) SetStart added in v1.5.0 

func (s *TimePeriod) SetStart(v time.Time) *TimePeriod

SetStart sets the Start field's value.

func (TimePeriod) String 

func (s TimePeriod) String() string

String returns the string representation

type UpdateBudgetInput 

type UpdateBudgetInput struct {

	// The accountId that is associated with the budget that you want to update.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The budget that you want to update your budget to.
	//
	// NewBudget is a required field
	NewBudget *Budget `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of UpdateBudget

func (UpdateBudgetInput) GoString 

func (s UpdateBudgetInput) GoString() string

GoString returns the string representation

func (*UpdateBudgetInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*UpdateBudgetInput) SetNewBudget added in v1.5.0 

func (s *UpdateBudgetInput) SetNewBudget(v *Budget) *UpdateBudgetInput

SetNewBudget sets the NewBudget field's value.

func (UpdateBudgetInput) String 

func (s UpdateBudgetInput) String() string

String returns the string representation

func (*UpdateBudgetInput) Validate 

func (s *UpdateBudgetInput) Validate() error

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

type UpdateBudgetOutput 

type UpdateBudgetOutput struct {
	// contains filtered or unexported fields
}

Response of UpdateBudget

func (UpdateBudgetOutput) GoString 

func (s UpdateBudgetOutput) GoString() string

GoString returns the string representation

func (UpdateBudgetOutput) String 

func (s UpdateBudgetOutput) String() string

String returns the string representation

type UpdateNotificationInput 

type UpdateNotificationInput struct {

	// The accountId that is associated with the budget whose notification you want
	// to update.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget whose notification you want to update.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// The updated notification to be associated with a budget.
	//
	// NewNotification is a required field
	NewNotification *Notification `type:"structure" required:"true"`

	// The previous notification that is associated with a budget.
	//
	// OldNotification is a required field
	OldNotification *Notification `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of UpdateNotification

func (UpdateNotificationInput) GoString 

func (s UpdateNotificationInput) GoString() string

GoString returns the string representation

func (*UpdateNotificationInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*UpdateNotificationInput) SetBudgetName added in v1.5.0 

func (s *UpdateNotificationInput) SetBudgetName(v string) *UpdateNotificationInput

SetBudgetName sets the BudgetName field's value.

func (*UpdateNotificationInput) SetNewNotification added in v1.5.0 

func (s *UpdateNotificationInput) SetNewNotification(v *Notification) *UpdateNotificationInput

SetNewNotification sets the NewNotification field's value.

func (*UpdateNotificationInput) SetOldNotification added in v1.5.0 

func (s *UpdateNotificationInput) SetOldNotification(v *Notification) *UpdateNotificationInput

SetOldNotification sets the OldNotification field's value.

func (UpdateNotificationInput) String 

func (s UpdateNotificationInput) String() string

String returns the string representation

func (*UpdateNotificationInput) Validate 

func (s *UpdateNotificationInput) Validate() error

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

type UpdateNotificationOutput 

type UpdateNotificationOutput struct {
	// contains filtered or unexported fields
}

Response of UpdateNotification

func (UpdateNotificationOutput) GoString 

func (s UpdateNotificationOutput) GoString() string

GoString returns the string representation

func (UpdateNotificationOutput) String 

func (s UpdateNotificationOutput) String() string

String returns the string representation

type UpdateSubscriberInput 

type UpdateSubscriberInput struct {

	// The accountId that is associated with the budget whose subscriber you want
	// to update.
	//
	// AccountId is a required field
	AccountId *string `min:"12" type:"string" required:"true"`

	// The name of the budget whose subscriber you want to update.
	//
	// BudgetName is a required field
	BudgetName *string `min:"1" type:"string" required:"true"`

	// The updated subscriber that is associated with a budget notification.
	//
	// NewSubscriber is a required field
	NewSubscriber *Subscriber `type:"structure" required:"true"`

	// The notification whose subscriber you want to update.
	//
	// Notification is a required field
	Notification *Notification `type:"structure" required:"true"`

	// The previous subscriber that is associated with a budget notification.
	//
	// OldSubscriber is a required field
	OldSubscriber *Subscriber `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Request of UpdateSubscriber

func (UpdateSubscriberInput) GoString 

func (s UpdateSubscriberInput) GoString() string

GoString returns the string representation

func (*UpdateSubscriberInput) SetAccountId added in v1.5.0 

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

SetAccountId sets the AccountId field's value.

func (*UpdateSubscriberInput) SetBudgetName added in v1.5.0 

func (s *UpdateSubscriberInput) SetBudgetName(v string) *UpdateSubscriberInput

SetBudgetName sets the BudgetName field's value.

func (*UpdateSubscriberInput) SetNewSubscriber added in v1.5.0 

func (s *UpdateSubscriberInput) SetNewSubscriber(v *Subscriber) *UpdateSubscriberInput

SetNewSubscriber sets the NewSubscriber field's value.

func (*UpdateSubscriberInput) SetNotification added in v1.5.0 

func (s *UpdateSubscriberInput) SetNotification(v *Notification) *UpdateSubscriberInput

SetNotification sets the Notification field's value.

func (*UpdateSubscriberInput) SetOldSubscriber added in v1.5.0 

func (s *UpdateSubscriberInput) SetOldSubscriber(v *Subscriber) *UpdateSubscriberInput

SetOldSubscriber sets the OldSubscriber field's value.

func (UpdateSubscriberInput) String 

func (s UpdateSubscriberInput) String() string

String returns the string representation

func (*UpdateSubscriberInput) Validate 

func (s *UpdateSubscriberInput) Validate() error

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

type UpdateSubscriberOutput 

type UpdateSubscriberOutput struct {
	// contains filtered or unexported fields
}

Response of UpdateSubscriber

func (UpdateSubscriberOutput) GoString 

func (s UpdateSubscriberOutput) GoString() string

GoString returns the string representation

func (UpdateSubscriberOutput) String 

func (s UpdateSubscriberOutput) String() string

String returns the string representation

Source Files

View all Source files

Directories

Path Synopsis
Package budgetsiface provides an interface to enable mocking the AWS Budgets service client for testing your code.
 Package budgetsiface provides an interface to enable mocking the AWS Budgets service client for testing your code.

Jump to

Keyboard shortcuts

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