budgets

package
v0.8.0 Latest Latest
Warning

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

 Go to latest Published: Apr 25, 2019 License: Apache-2.0 Imports: 7 Imported by: 27

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

	// 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"   // Service endpoint prefix API calls made to.
	EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata.
)

Service information constants

Variables

This section is empty.

Functions

This section is empty.

Types

type Budget 

type Budget struct {

	// The total amount of cost, usage, RI utilization, or RI coverage that you
	// want to track with your budget.
	//
	// BudgetLimit is required for cost or usage budgets, but optional for RI utilization
	// or coverage budgets. RI utilization or coverage budgets default to 100, which
	// is the only valid value for RI utilization or coverage budgets.
	BudgetLimit *Spend `type:"structure"`

	// The name of a budget. The name must be unique within accounts. 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 monetary costs, usage, RI utilization, or RI coverage.
	//
	// BudgetType is a required field
	BudgetType BudgetType `type:"string" required:"true" enum:"true"`

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

	// The cost filters, such as service or region, 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, and RI_COVERAGE budgets do not have CostTypes.
	CostTypes *CostTypes `type:"structure"`

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

	// 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 and RI_COVERAGE budgets.
	//
	// TimeUnit is a required field
	TimeUnit TimeUnit `type:"string" required:"true" enum:"true"`
	// 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) 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 v0.6.0 

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 BudgetType `type:"string" enum:"true"`

	// 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 TimeUnit `type:"string" enum:"true"`
	// 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 v0.6.0 

func (s BudgetPerformanceHistory) GoString() string

GoString returns the string representation

func (BudgetPerformanceHistory) String added in v0.6.0 

func (s BudgetPerformanceHistory) String() string

String returns the string representation

type BudgetType 

type BudgetType string

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

COST, USAGE, RI_UTILIZATION, or RI_COVERAGE. 

const (
	BudgetTypeUsage         BudgetType = "USAGE"
	BudgetTypeCost          BudgetType = "COST"
	BudgetTypeRiUtilization BudgetType = "RI_UTILIZATION"
	BudgetTypeRiCoverage    BudgetType = "RI_COVERAGE"
)

Enum values for BudgetType

func (BudgetType) MarshalValue added in v0.3.0 

func (enum BudgetType) MarshalValue() (string, error)

func (BudgetType) MarshalValueBuf added in v0.3.0 

func (enum BudgetType) MarshalValueBuf(b []byte) ([]byte, error)

type BudgetedAndActualAmounts added in v0.6.0 

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 v0.6.0 

func (s BudgetedAndActualAmounts) GoString() string

GoString returns the string representation

func (BudgetedAndActualAmounts) String added in v0.6.0 

func (s BudgetedAndActualAmounts) String() string

String returns the string representation

type Budgets 

type Budgets struct {
	*aws.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(config aws.Config) *Budgets

New creates a new instance of the Budgets client with a config.

Example: 

// Create a Budgets client from just a config.
svc := budgets.New(myConfig)

func (*Budgets) CreateBudgetRequest 

func (c *Budgets) CreateBudgetRequest(input *CreateBudgetInput) CreateBudgetRequest

CreateBudgetRequest returns a request value for making API operation for AWS Budgets.

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

// Example sending a request using the CreateBudgetRequest method.
req := client.CreateBudgetRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) CreateNotificationRequest 

func (c *Budgets) CreateNotificationRequest(input *CreateNotificationInput) CreateNotificationRequest

CreateNotificationRequest returns a request value for making API operation for AWS Budgets.

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

// Example sending a request using the CreateNotificationRequest method.
req := client.CreateNotificationRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) CreateSubscriberRequest 

func (c *Budgets) CreateSubscriberRequest(input *CreateSubscriberInput) CreateSubscriberRequest

CreateSubscriberRequest returns a request value for making API operation for AWS Budgets.

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

// Example sending a request using the CreateSubscriberRequest method.
req := client.CreateSubscriberRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DeleteBudgetRequest 

func (c *Budgets) DeleteBudgetRequest(input *DeleteBudgetInput) DeleteBudgetRequest

DeleteBudgetRequest returns a request value for making 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. 

// Example sending a request using the DeleteBudgetRequest method.
req := client.DeleteBudgetRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DeleteNotificationRequest 

func (c *Budgets) DeleteNotificationRequest(input *DeleteNotificationInput) DeleteNotificationRequest

DeleteNotificationRequest returns a request value for making API operation for AWS Budgets.

Deletes a notification.

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

// Example sending a request using the DeleteNotificationRequest method.
req := client.DeleteNotificationRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DeleteSubscriberRequest 

func (c *Budgets) DeleteSubscriberRequest(input *DeleteSubscriberInput) DeleteSubscriberRequest

DeleteSubscriberRequest returns a request value for making API operation for AWS Budgets.

Deletes a subscriber.

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

// Example sending a request using the DeleteSubscriberRequest method.
req := client.DeleteSubscriberRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DescribeBudgetPerformanceHistoryRequest added in v0.6.0 

func (c *Budgets) DescribeBudgetPerformanceHistoryRequest(input *DescribeBudgetPerformanceHistoryInput) DescribeBudgetPerformanceHistoryRequest

DescribeBudgetPerformanceHistoryRequest returns a request value for making API operation for AWS Budgets.

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

// Example sending a request using the DescribeBudgetPerformanceHistoryRequest method.
req := client.DescribeBudgetPerformanceHistoryRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DescribeBudgetRequest 

func (c *Budgets) DescribeBudgetRequest(input *DescribeBudgetInput) DescribeBudgetRequest

DescribeBudgetRequest returns a request value for making API operation for AWS Budgets.

Describes a budget. 

// Example sending a request using the DescribeBudgetRequest method.
req := client.DescribeBudgetRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DescribeBudgetsRequest 

func (c *Budgets) DescribeBudgetsRequest(input *DescribeBudgetsInput) DescribeBudgetsRequest

DescribeBudgetsRequest returns a request value for making API operation for AWS Budgets.

Lists the budgets that are associated with an account. 

// Example sending a request using the DescribeBudgetsRequest method.
req := client.DescribeBudgetsRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DescribeNotificationsForBudgetRequest 

func (c *Budgets) DescribeNotificationsForBudgetRequest(input *DescribeNotificationsForBudgetInput) DescribeNotificationsForBudgetRequest

DescribeNotificationsForBudgetRequest returns a request value for making API operation for AWS Budgets.

Lists the notifications that are associated with a budget. 

// Example sending a request using the DescribeNotificationsForBudgetRequest method.
req := client.DescribeNotificationsForBudgetRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) DescribeSubscribersForNotificationRequest 

func (c *Budgets) DescribeSubscribersForNotificationRequest(input *DescribeSubscribersForNotificationInput) DescribeSubscribersForNotificationRequest

DescribeSubscribersForNotificationRequest returns a request value for making API operation for AWS Budgets.

Lists the subscribers that are associated with a notification. 

// Example sending a request using the DescribeSubscribersForNotificationRequest method.
req := client.DescribeSubscribersForNotificationRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) UpdateBudgetRequest 

func (c *Budgets) UpdateBudgetRequest(input *UpdateBudgetInput) UpdateBudgetRequest

UpdateBudgetRequest returns a request value for making 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. 

// Example sending a request using the UpdateBudgetRequest method.
req := client.UpdateBudgetRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) UpdateNotificationRequest 

func (c *Budgets) UpdateNotificationRequest(input *UpdateNotificationInput) UpdateNotificationRequest

UpdateNotificationRequest returns a request value for making API operation for AWS Budgets.

Updates a notification. 

// Example sending a request using the UpdateNotificationRequest method.
req := client.UpdateNotificationRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

func (*Budgets) UpdateSubscriberRequest 

func (c *Budgets) UpdateSubscriberRequest(input *UpdateSubscriberInput) UpdateSubscriberRequest

UpdateSubscriberRequest returns a request value for making API operation for AWS Budgets.

Updates a subscriber. 

// Example sending a request using the UpdateSubscriberRequest method.
req := client.UpdateSubscriberRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

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

type ComparisonOperator string

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

GREATER_THAN, LESS_THAN, EQUAL_TO 

const (
	ComparisonOperatorGreaterThan ComparisonOperator = "GREATER_THAN"
	ComparisonOperatorLessThan    ComparisonOperator = "LESS_THAN"
	ComparisonOperatorEqualTo     ComparisonOperator = "EQUAL_TO"
)

Enum values for ComparisonOperator

func (ComparisonOperator) MarshalValue added in v0.3.0 

func (enum ComparisonOperator) MarshalValue() (string, error)

func (ComparisonOperator) MarshalValueBuf added in v0.3.0 

func (enum ComparisonOperator) MarshalValueBuf(b []byte) ([]byte, error)

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

func (s CreateBudgetOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (CreateBudgetOutput) String 

func (s CreateBudgetOutput) String() string

String returns the string representation

type CreateBudgetRequest 

type CreateBudgetRequest struct {
	*aws.Request
	Input *CreateBudgetInput
	Copy  func(*CreateBudgetInput) CreateBudgetRequest
}

CreateBudgetRequest is a API request type for the CreateBudget API operation.

func (CreateBudgetRequest) Send 

func (r CreateBudgetRequest) Send(ctx context.Context) (*CreateBudgetOutput, error)

Send marshals and sends the CreateBudget API request.

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

func (s CreateNotificationOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (CreateNotificationOutput) String 

func (s CreateNotificationOutput) String() string

String returns the string representation

type CreateNotificationRequest 

type CreateNotificationRequest struct {
	*aws.Request
	Input *CreateNotificationInput
	Copy  func(*CreateNotificationInput) CreateNotificationRequest
}

CreateNotificationRequest is a API request type for the CreateNotification API operation.

func (CreateNotificationRequest) Send 

func (r CreateNotificationRequest) Send(ctx context.Context) (*CreateNotificationOutput, error)

Send marshals and sends the CreateNotification API request.

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

func (s CreateSubscriberOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (CreateSubscriberOutput) String 

func (s CreateSubscriberOutput) String() string

String returns the string representation

type CreateSubscriberRequest 

type CreateSubscriberRequest struct {
	*aws.Request
	Input *CreateSubscriberInput
	Copy  func(*CreateSubscriberInput) CreateSubscriberRequest
}

CreateSubscriberRequest is a API request type for the CreateSubscriber API operation.

func (CreateSubscriberRequest) Send 

func (r CreateSubscriberRequest) Send(ctx context.Context) (*CreateSubscriberOutput, error)

Send marshals and sends the CreateSubscriber API request.

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

func (s DeleteBudgetOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DeleteBudgetOutput) String 

func (s DeleteBudgetOutput) String() string

String returns the string representation

type DeleteBudgetRequest 

type DeleteBudgetRequest struct {
	*aws.Request
	Input *DeleteBudgetInput
	Copy  func(*DeleteBudgetInput) DeleteBudgetRequest
}

DeleteBudgetRequest is a API request type for the DeleteBudget API operation.

func (DeleteBudgetRequest) Send 

func (r DeleteBudgetRequest) Send(ctx context.Context) (*DeleteBudgetOutput, error)

Send marshals and sends the DeleteBudget API request.

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

func (s DeleteNotificationOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DeleteNotificationOutput) String 

func (s DeleteNotificationOutput) String() string

String returns the string representation

type DeleteNotificationRequest 

type DeleteNotificationRequest struct {
	*aws.Request
	Input *DeleteNotificationInput
	Copy  func(*DeleteNotificationInput) DeleteNotificationRequest
}

DeleteNotificationRequest is a API request type for the DeleteNotification API operation.

func (DeleteNotificationRequest) Send 

func (r DeleteNotificationRequest) Send(ctx context.Context) (*DeleteNotificationOutput, error)

Send marshals and sends the DeleteNotification API request.

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

func (s DeleteSubscriberOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DeleteSubscriberOutput) String 

func (s DeleteSubscriberOutput) String() string

String returns the string representation

type DeleteSubscriberRequest 

type DeleteSubscriberRequest struct {
	*aws.Request
	Input *DeleteSubscriberInput
	Copy  func(*DeleteSubscriberInput) DeleteSubscriberRequest
}

DeleteSubscriberRequest is a API request type for the DeleteSubscriber API operation.

func (DeleteSubscriberRequest) Send 

func (r DeleteSubscriberRequest) Send(ctx context.Context) (*DeleteSubscriberOutput, error)

Send marshals and sends the DeleteSubscriber API request.

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

func (s DescribeBudgetOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DescribeBudgetOutput) String 

func (s DescribeBudgetOutput) String() string

String returns the string representation

type DescribeBudgetPerformanceHistoryInput added in v0.6.0 

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 v0.6.0 

func (s DescribeBudgetPerformanceHistoryInput) GoString() string

GoString returns the string representation

func (DescribeBudgetPerformanceHistoryInput) String added in v0.6.0 

func (s DescribeBudgetPerformanceHistoryInput) String() string

String returns the string representation

func (*DescribeBudgetPerformanceHistoryInput) Validate added in v0.6.0 

func (s *DescribeBudgetPerformanceHistoryInput) Validate() error

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

type DescribeBudgetPerformanceHistoryOutput added in v0.6.0 

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 v0.6.0 

func (s DescribeBudgetPerformanceHistoryOutput) GoString() string

GoString returns the string representation

func (DescribeBudgetPerformanceHistoryOutput) SDKResponseMetadata added in v0.6.0 

func (s DescribeBudgetPerformanceHistoryOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DescribeBudgetPerformanceHistoryOutput) String added in v0.6.0 

func (s DescribeBudgetPerformanceHistoryOutput) String() string

String returns the string representation

type DescribeBudgetPerformanceHistoryRequest added in v0.6.0 

type DescribeBudgetPerformanceHistoryRequest struct {
	*aws.Request
	Input *DescribeBudgetPerformanceHistoryInput
	Copy  func(*DescribeBudgetPerformanceHistoryInput) DescribeBudgetPerformanceHistoryRequest
}

DescribeBudgetPerformanceHistoryRequest is a API request type for the DescribeBudgetPerformanceHistory API operation.

func (DescribeBudgetPerformanceHistoryRequest) Send added in v0.6.0 

func (r DescribeBudgetPerformanceHistoryRequest) Send(ctx context.Context) (*DescribeBudgetPerformanceHistoryOutput, error)

Send marshals and sends the DescribeBudgetPerformanceHistory API request.

type DescribeBudgetRequest 

type DescribeBudgetRequest struct {
	*aws.Request
	Input *DescribeBudgetInput
	Copy  func(*DescribeBudgetInput) DescribeBudgetRequest
}

DescribeBudgetRequest is a API request type for the DescribeBudget API operation.

func (DescribeBudgetRequest) Send 

func (r DescribeBudgetRequest) Send(ctx context.Context) (*DescribeBudgetOutput, error)

Send marshals and sends the DescribeBudget API request.

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

func (s DescribeBudgetsOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DescribeBudgetsOutput) String 

func (s DescribeBudgetsOutput) String() string

String returns the string representation

type DescribeBudgetsRequest 

type DescribeBudgetsRequest struct {
	*aws.Request
	Input *DescribeBudgetsInput
	Copy  func(*DescribeBudgetsInput) DescribeBudgetsRequest
}

DescribeBudgetsRequest is a API request type for the DescribeBudgets API operation.

func (DescribeBudgetsRequest) Send 

func (r DescribeBudgetsRequest) Send(ctx context.Context) (*DescribeBudgetsOutput, error)

Send marshals and sends the DescribeBudgets API request.

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

func (s DescribeNotificationsForBudgetOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DescribeNotificationsForBudgetOutput) String 

func (s DescribeNotificationsForBudgetOutput) String() string

String returns the string representation

type DescribeNotificationsForBudgetRequest 

type DescribeNotificationsForBudgetRequest struct {
	*aws.Request
	Input *DescribeNotificationsForBudgetInput
	Copy  func(*DescribeNotificationsForBudgetInput) DescribeNotificationsForBudgetRequest
}

DescribeNotificationsForBudgetRequest is a API request type for the DescribeNotificationsForBudget API operation.

func (DescribeNotificationsForBudgetRequest) Send 

func (r DescribeNotificationsForBudgetRequest) Send(ctx context.Context) (*DescribeNotificationsForBudgetOutput, error)

Send marshals and sends the DescribeNotificationsForBudget API request.

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

func (s DescribeSubscribersForNotificationOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (DescribeSubscribersForNotificationOutput) String 

func (s DescribeSubscribersForNotificationOutput) String() string

String returns the string representation

type DescribeSubscribersForNotificationRequest 

type DescribeSubscribersForNotificationRequest struct {
	*aws.Request
	Input *DescribeSubscribersForNotificationInput
	Copy  func(*DescribeSubscribersForNotificationInput) DescribeSubscribersForNotificationRequest
}

DescribeSubscribersForNotificationRequest is a API request type for the DescribeSubscribersForNotification API operation.

func (DescribeSubscribersForNotificationRequest) Send 

func (r DescribeSubscribersForNotificationRequest) Send(ctx context.Context) (*DescribeSubscribersForNotificationOutput, error)

Send marshals and sends the DescribeSubscribersForNotification API request.

type Notification 

type Notification struct {

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

	// 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 NotificationState `type:"string" enum:"true"`

	// 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 NotificationType `type:"string" required:"true" enum:"true"`

	// 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 ThresholdType `type:"string" enum:"true"`
	// 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) 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 NotificationState added in v0.6.0 

type NotificationState string
const (
	NotificationStateOk    NotificationState = "OK"
	NotificationStateAlarm NotificationState = "ALARM"
)

Enum values for NotificationState

func (NotificationState) MarshalValue added in v0.6.0 

func (enum NotificationState) MarshalValue() (string, error)

func (NotificationState) MarshalValueBuf added in v0.6.0 

func (enum NotificationState) MarshalValueBuf(b []byte) ([]byte, error)

type NotificationType 

type NotificationType string

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

const (
	NotificationTypeActual     NotificationType = "ACTUAL"
	NotificationTypeForecasted NotificationType = "FORECASTED"
)

Enum values for NotificationType

func (NotificationType) MarshalValue added in v0.3.0 

func (enum NotificationType) MarshalValue() (string, error)

func (NotificationType) MarshalValueBuf added in v0.3.0 

func (enum NotificationType) MarshalValueBuf(b []byte) ([]byte, error)

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) 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) 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.
	//
	// Address is a required field
	Address *string `min:"1" type:"string" required:"true"`

	// The type of notification that AWS sends to a subscriber.
	//
	// SubscriptionType is a required field
	SubscriptionType SubscriptionType `type:"string" required:"true" enum:"true"`
	// 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) 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 SubscriptionType 

type SubscriptionType string

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

const (
	SubscriptionTypeSns   SubscriptionType = "SNS"
	SubscriptionTypeEmail SubscriptionType = "EMAIL"
)

Enum values for SubscriptionType

func (SubscriptionType) MarshalValue added in v0.3.0 

func (enum SubscriptionType) MarshalValue() (string, error)

func (SubscriptionType) MarshalValueBuf added in v0.3.0 

func (enum SubscriptionType) MarshalValueBuf(b []byte) ([]byte, error)

type ThresholdType 

type ThresholdType string

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

const (
	ThresholdTypePercentage    ThresholdType = "PERCENTAGE"
	ThresholdTypeAbsoluteValue ThresholdType = "ABSOLUTE_VALUE"
)

Enum values for ThresholdType

func (ThresholdType) MarshalValue added in v0.3.0 

func (enum ThresholdType) MarshalValue() (string, error)

func (ThresholdType) MarshalValueBuf added in v0.3.0 

func (enum ThresholdType) MarshalValueBuf(b []byte) ([]byte, error)

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" timestampFormat:"unix"`

	// 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" timestampFormat:"unix"`
	// 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) String 

func (s TimePeriod) String() string

String returns the string representation

type TimeUnit 

type TimeUnit string

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

const (
	TimeUnitDaily     TimeUnit = "DAILY"
	TimeUnitMonthly   TimeUnit = "MONTHLY"
	TimeUnitQuarterly TimeUnit = "QUARTERLY"
	TimeUnitAnnually  TimeUnit = "ANNUALLY"
)

Enum values for TimeUnit

func (TimeUnit) MarshalValue added in v0.3.0 

func (enum TimeUnit) MarshalValue() (string, error)

func (TimeUnit) MarshalValueBuf added in v0.3.0 

func (enum TimeUnit) MarshalValueBuf(b []byte) ([]byte, error)

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

func (s UpdateBudgetOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (UpdateBudgetOutput) String 

func (s UpdateBudgetOutput) String() string

String returns the string representation

type UpdateBudgetRequest 

type UpdateBudgetRequest struct {
	*aws.Request
	Input *UpdateBudgetInput
	Copy  func(*UpdateBudgetInput) UpdateBudgetRequest
}

UpdateBudgetRequest is a API request type for the UpdateBudget API operation.

func (UpdateBudgetRequest) Send 

func (r UpdateBudgetRequest) Send(ctx context.Context) (*UpdateBudgetOutput, error)

Send marshals and sends the UpdateBudget API request.

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

func (s UpdateNotificationOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (UpdateNotificationOutput) String 

func (s UpdateNotificationOutput) String() string

String returns the string representation

type UpdateNotificationRequest 

type UpdateNotificationRequest struct {
	*aws.Request
	Input *UpdateNotificationInput
	Copy  func(*UpdateNotificationInput) UpdateNotificationRequest
}

UpdateNotificationRequest is a API request type for the UpdateNotification API operation.

func (UpdateNotificationRequest) Send 

func (r UpdateNotificationRequest) Send(ctx context.Context) (*UpdateNotificationOutput, error)

Send marshals and sends the UpdateNotification API request.

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

func (s UpdateSubscriberOutput) SDKResponseMetadata() aws.Response

SDKResponseMetdata return sthe response metadata for the API.

func (UpdateSubscriberOutput) String 

func (s UpdateSubscriberOutput) String() string

String returns the string representation

type UpdateSubscriberRequest 

type UpdateSubscriberRequest struct {
	*aws.Request
	Input *UpdateSubscriberInput
	Copy  func(*UpdateSubscriberInput) UpdateSubscriberRequest
}

UpdateSubscriberRequest is a API request type for the UpdateSubscriber API operation.

func (UpdateSubscriberRequest) Send 

func (r UpdateSubscriberRequest) Send(ctx context.Context) (*UpdateSubscriberOutput, error)

Send marshals and sends the UpdateSubscriber API request.

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.