libZSservicesZSamazonka-budgetsZSamazonka-budgets
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.Budgets.Lens

Description

 
Synopsis

Operations

CreateBudgetAction

createBudgetAction_actionType :: Lens' CreateBudgetAction ActionType Source #

The type of action. This defines the type of tasks that can be carried out by this action. This field also determines the format for definition.

createBudgetAction_executionRoleArn :: Lens' CreateBudgetAction Text Source #

The role passed for action execution and reversion. Roles and actions must be in the same account.

createBudgetAction_approvalModel :: Lens' CreateBudgetAction ApprovalModel Source #

This specifies if the action needs manual or automatic approval.

createBudgetActionResponse_actionId :: Lens' CreateBudgetActionResponse Text Source #

A system-generated universally unique identifier (UUID) for the action.

UpdateBudgetAction

updateBudgetAction_executionRoleArn :: Lens' UpdateBudgetAction (Maybe Text) Source #

The role passed for action execution and reversion. Roles and actions must be in the same account.

updateBudgetAction_approvalModel :: Lens' UpdateBudgetAction (Maybe ApprovalModel) Source #

This specifies if the action needs manual or automatic approval.

updateBudgetAction_actionId :: Lens' UpdateBudgetAction Text Source #

A system-generated universally unique identifier (UUID) for the action.

DeleteBudgetAction

deleteBudgetAction_actionId :: Lens' DeleteBudgetAction Text Source #

A system-generated universally unique identifier (UUID) for the action.

DescribeSubscribersForNotification

describeSubscribersForNotification_nextToken :: Lens' DescribeSubscribersForNotification (Maybe Text) Source #

The pagination token that you include in your request to indicate the next set of results that you want to retrieve.

describeSubscribersForNotification_maxResults :: Lens' DescribeSubscribersForNotification (Maybe Natural) Source #

An optional integer that represents how many entries a paginated response contains. The maximum is 100.

describeSubscribersForNotification_accountId :: Lens' DescribeSubscribersForNotification Text Source #

The accountId that is associated with the budget whose subscribers you want descriptions of.

describeSubscribersForNotification_budgetName :: Lens' DescribeSubscribersForNotification Text Source #

The name of the budget whose subscribers you want descriptions of.

describeSubscribersForNotificationResponse_nextToken :: Lens' DescribeSubscribersForNotificationResponse (Maybe Text) Source #

The pagination token in the service response that indicates the next set of results that you can retrieve.

DescribeNotificationsForBudget

describeNotificationsForBudget_nextToken :: Lens' DescribeNotificationsForBudget (Maybe Text) Source #

The pagination token that you include in your request to indicate the next set of results that you want to retrieve.

describeNotificationsForBudget_maxResults :: Lens' DescribeNotificationsForBudget (Maybe Natural) Source #

An optional integer that represents how many entries a paginated response contains. The maximum is 100.

describeNotificationsForBudget_accountId :: Lens' DescribeNotificationsForBudget Text Source #

The accountId that is associated with the budget whose notifications you want descriptions of.

describeNotificationsForBudget_budgetName :: Lens' DescribeNotificationsForBudget Text Source #

The name of the budget whose notifications you want descriptions of.

describeNotificationsForBudgetResponse_nextToken :: Lens' DescribeNotificationsForBudgetResponse (Maybe Text) Source #

The pagination token in the service response that indicates the next set of results that you can retrieve.

DescribeBudgets

describeBudgets_nextToken :: Lens' DescribeBudgets (Maybe Text) Source #

The pagination token that you include in your request to indicate the next set of results that you want to retrieve.

describeBudgets_maxResults :: Lens' DescribeBudgets (Maybe Natural) Source #

An optional integer that represents how many entries a paginated response contains. The maximum is 100.

describeBudgets_accountId :: Lens' DescribeBudgets Text Source #

The accountId that is associated with the budgets that you want descriptions of.

describeBudgetsResponse_nextToken :: Lens' DescribeBudgetsResponse (Maybe Text) Source #

The pagination token in the service response that indicates the next set of results that you can retrieve.

CreateSubscriber

createSubscriber_accountId :: Lens' CreateSubscriber Text Source #

The accountId that is associated with the budget that you want to create a subscriber for.

createSubscriber_budgetName :: Lens' CreateSubscriber Text Source #

The name of the budget that you want to subscribe to. Budget names must be unique within an account.

createSubscriber_notification :: Lens' CreateSubscriber Notification Source #

The notification that you want to create a subscriber for.

createSubscriber_subscriber :: Lens' CreateSubscriber Subscriber Source #

The subscriber that you want to associate with a budget notification.

ExecuteBudgetAction

executeBudgetAction_actionId :: Lens' ExecuteBudgetAction Text Source #

A system-generated universally unique identifier (UUID) for the action.

executeBudgetActionResponse_actionId :: Lens' ExecuteBudgetActionResponse Text Source #

A system-generated universally unique identifier (UUID) for the action.

UpdateBudget

updateBudget_accountId :: Lens' UpdateBudget Text Source #

The accountId that is associated with the budget that you want to update.

updateBudget_newBudget :: Lens' UpdateBudget Budget Source #

The budget that you want to update your budget to.

DeleteBudget

deleteBudget_accountId :: Lens' DeleteBudget Text Source #

The accountId that is associated with the budget that you want to delete.

deleteBudget_budgetName :: Lens' DeleteBudget Text Source #

The name of the budget that you want to delete.

DeleteNotification

deleteNotification_accountId :: Lens' DeleteNotification Text Source #

The accountId that is associated with the budget whose notification you want to delete.

deleteNotification_budgetName :: Lens' DeleteNotification Text Source #

The name of the budget whose notification you want to delete.

deleteNotification_notification :: Lens' DeleteNotification Notification Source #

The notification that you want to delete.

UpdateNotification

updateNotification_accountId :: Lens' UpdateNotification Text Source #

The accountId that is associated with the budget whose notification you want to update.

updateNotification_budgetName :: Lens' UpdateNotification Text Source #

The name of the budget whose notification you want to update.

updateNotification_oldNotification :: Lens' UpdateNotification Notification Source #

The previous notification that is associated with a budget.

updateNotification_newNotification :: Lens' UpdateNotification Notification Source #

The updated notification to be associated with a budget.

DescribeBudgetActionsForAccount

DescribeBudgetPerformanceHistory

describeBudgetPerformanceHistory_timePeriod :: Lens' DescribeBudgetPerformanceHistory (Maybe TimePeriod) Source #

Retrieves how often the budget went into an ALARM state for the specified time period.

describeBudgetPerformanceHistoryResponse_budgetPerformanceHistory :: Lens' DescribeBudgetPerformanceHistoryResponse (Maybe BudgetPerformanceHistory) Source #

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.

DescribeBudgetActionHistories

describeBudgetActionHistories_actionId :: Lens' DescribeBudgetActionHistories Text Source #

A system-generated universally unique identifier (UUID) for the action.

DescribeBudget

describeBudget_accountId :: Lens' DescribeBudget Text Source #

The accountId that is associated with the budget that you want a description of.

describeBudget_budgetName :: Lens' DescribeBudget Text Source #

The name of the budget that you want a description of.

UpdateSubscriber

updateSubscriber_accountId :: Lens' UpdateSubscriber Text Source #

The accountId that is associated with the budget whose subscriber you want to update.

updateSubscriber_budgetName :: Lens' UpdateSubscriber Text Source #

The name of the budget whose subscriber you want to update.

updateSubscriber_notification :: Lens' UpdateSubscriber Notification Source #

The notification whose subscriber you want to update.

updateSubscriber_oldSubscriber :: Lens' UpdateSubscriber Subscriber Source #

The previous subscriber that is associated with a budget notification.

updateSubscriber_newSubscriber :: Lens' UpdateSubscriber Subscriber Source #

The updated subscriber that is associated with a budget notification.

DeleteSubscriber

deleteSubscriber_accountId :: Lens' DeleteSubscriber Text Source #

The accountId that is associated with the budget whose subscriber you want to delete.

deleteSubscriber_budgetName :: Lens' DeleteSubscriber Text Source #

The name of the budget whose subscriber you want to delete.

deleteSubscriber_notification :: Lens' DeleteSubscriber Notification Source #

The notification whose subscriber you want to delete.

deleteSubscriber_subscriber :: Lens' DeleteSubscriber Subscriber Source #

The subscriber that you want to delete.

DescribeBudgetActionsForBudget

DescribeBudgetAction

describeBudgetAction_actionId :: Lens' DescribeBudgetAction Text Source #

A system-generated universally unique identifier (UUID) for the action.

CreateBudget

createBudget_notificationsWithSubscribers :: Lens' CreateBudget (Maybe [NotificationWithSubscribers]) Source #

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.

createBudget_accountId :: Lens' CreateBudget Text Source #

The accountId that is associated with the budget.

createBudget_budget :: Lens' CreateBudget Budget Source #

The budget object that you want to create.

CreateNotification

createNotification_accountId :: Lens' CreateNotification Text Source #

The accountId that is associated with the budget that you want to create a notification for.

createNotification_budgetName :: Lens' CreateNotification Text Source #

The name of the budget that you want AWS to notify you about. Budget names must be unique within an account.

createNotification_notification :: Lens' CreateNotification Notification Source #

The notification that you want to create.

createNotification_subscribers :: Lens' CreateNotification (NonEmpty Subscriber) Source #

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.

Types

Action

action_actionId :: Lens' Action Text Source #

A system-generated universally unique identifier (UUID) for the action.

action_budgetName :: Lens' Action Text Source #

Undocumented member.

action_actionType :: Lens' Action ActionType Source #

The type of action. This defines the type of tasks that can be carried out by this action. This field also determines the format for definition.

action_actionThreshold :: Lens' Action ActionThreshold Source #

The trigger threshold of the action.

action_definition :: Lens' Action Definition Source #

Where you specify all of the type-specific parameters.

action_executionRoleArn :: Lens' Action Text Source #

The role passed for action execution and reversion. Roles and actions must be in the same account.

action_approvalModel :: Lens' Action ApprovalModel Source #

This specifies if the action needs manual or automatic approval.

action_status :: Lens' Action ActionStatus Source #

The status of action.

ActionHistory

actionHistory_status :: Lens' ActionHistory ActionStatus Source #

The status of action at the time of the event.

actionHistory_eventType :: Lens' ActionHistory EventType Source #

This distinguishes between whether the events are triggered by the user or generated by the system.

ActionHistoryDetails

ActionThreshold

Budget

budget_calculatedSpend :: Lens' Budget (Maybe CalculatedSpend) Source #

The actual and forecasted cost or usage that the budget tracks.

budget_plannedBudgetLimits :: Lens' Budget (Maybe (HashMap Text Spend)) Source #

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.

budget_lastUpdatedTime :: Lens' Budget (Maybe UTCTime) Source #

The last time that you updated this budget.

budget_budgetLimit :: Lens' Budget (Maybe Spend) Source #

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.

budget_timePeriod :: Lens' Budget (Maybe TimePeriod) Source #

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.

budget_costTypes :: Lens' Budget (Maybe CostTypes) Source #

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.

budget_costFilters :: Lens' Budget (Maybe (HashMap Text [Text])) Source #

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

budget_budgetName :: Lens' Budget Text Source #

The name of a budget. The name must be unique within an account. The : and \ characters aren't allowed in BudgetName.

budget_timeUnit :: Lens' Budget TimeUnit Source #

The length of time until a budget resets the actual and forecasted spend.

budget_budgetType :: Lens' Budget BudgetType Source #

Whether this budget tracks costs, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage.

BudgetPerformanceHistory

budgetPerformanceHistory_budgetedAndActualAmountsList :: Lens' BudgetPerformanceHistory (Maybe [BudgetedAndActualAmounts]) Source #

A list of amounts of cost or usage that you created budgets for, compared to your actual costs or usage.

budgetPerformanceHistory_costTypes :: Lens' BudgetPerformanceHistory (Maybe CostTypes) Source #

The history of the cost types for a budget during the specified time period.

budgetPerformanceHistory_costFilters :: Lens' BudgetPerformanceHistory (Maybe (HashMap Text [Text])) Source #

The history of the cost filters for a budget during the specified time period.

BudgetedAndActualAmounts

budgetedAndActualAmounts_timePeriod :: Lens' BudgetedAndActualAmounts (Maybe TimePeriod) Source #

The time period covered by this budget comparison.

budgetedAndActualAmounts_actualAmount :: Lens' BudgetedAndActualAmounts (Maybe Spend) Source #

Your actual costs or usage for a budget period.

budgetedAndActualAmounts_budgetedAmount :: Lens' BudgetedAndActualAmounts (Maybe Spend) Source #

The amount of cost or usage that you created the budget for.

CalculatedSpend

calculatedSpend_forecastedSpend :: Lens' CalculatedSpend (Maybe Spend) Source #

The amount of cost, usage, RI units, or Savings Plans units that you are forecasted to use.

calculatedSpend_actualSpend :: Lens' CalculatedSpend Spend Source #

The amount of cost, usage, RI units, or Savings Plans units that you have used.

CostTypes

costTypes_useAmortized :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget uses the amortized rate.

The default value is false.

costTypes_includeRecurring :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes recurring fees such as monthly RI fees.

The default value is true.

costTypes_useBlended :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget uses a blended rate.

The default value is false.

costTypes_includeSupport :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes support subscription fees.

The default value is true.

costTypes_includeDiscount :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes discounts.

The default value is true.

costTypes_includeSubscription :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes subscriptions.

The default value is true.

costTypes_includeRefund :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes refunds.

The default value is true.

costTypes_includeUpfront :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes upfront RI costs.

The default value is true.

costTypes_includeOtherSubscription :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes non-RI subscription costs.

The default value is true.

costTypes_includeTax :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes taxes.

The default value is true.

costTypes_includeCredit :: Lens' CostTypes (Maybe Bool) Source #

Specifies whether a budget includes credits.

The default value is true.

Definition

definition_scpActionDefinition :: Lens' Definition (Maybe ScpActionDefinition) Source #

The service control policies (SCPs) action definition details.

definition_iamActionDefinition :: Lens' Definition (Maybe IamActionDefinition) Source #

The AWS Identity and Access Management (IAM) action definition details.

definition_ssmActionDefinition :: Lens' Definition (Maybe SsmActionDefinition) Source #

The AWS Systems Manager (SSM) action definition details.

IamActionDefinition

iamActionDefinition_groups :: Lens' IamActionDefinition (Maybe (NonEmpty Text)) Source #

A list of groups to be attached. There must be at least one group.

iamActionDefinition_roles :: Lens' IamActionDefinition (Maybe (NonEmpty Text)) Source #

A list of roles to be attached. There must be at least one role.

iamActionDefinition_users :: Lens' IamActionDefinition (Maybe (NonEmpty Text)) Source #

A list of users to be attached. There must be at least one user.

iamActionDefinition_policyArn :: Lens' IamActionDefinition Text Source #

The Amazon Resource Name (ARN) of the policy to be attached.

Notification

notification_thresholdType :: Lens' Notification (Maybe ThresholdType) Source #

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.

notification_notificationState :: Lens' Notification (Maybe NotificationState) Source #

Whether this notification is in alarm. If a budget notification is in the ALARM state, you have passed the set threshold for the budget.

notification_notificationType :: Lens' Notification NotificationType Source #

Whether the notification is for how much you have spent (ACTUAL) or for how much you're forecasted to spend (FORECASTED).

notification_comparisonOperator :: Lens' Notification ComparisonOperator Source #

The comparison that is used for this notification.

notification_threshold :: Lens' Notification Double Source #

The threshold that is associated with a notification. Thresholds are always a percentage, and many customers find value being alerted between 50% - 200% of the budgeted amount. The maximum limit for your threshold is 1,000,000% above the budgeted amount.

NotificationWithSubscribers

notificationWithSubscribers_subscribers :: Lens' NotificationWithSubscribers (NonEmpty Subscriber) Source #

A list of subscribers who are subscribed to this notification.

ScpActionDefinition

Spend

spend_amount :: Lens' Spend Text Source #

The cost or usage amount that is associated with a budget forecast, actual spend, or budget threshold.

spend_unit :: Lens' Spend Text Source #

The unit of measurement that is used for the budget forecast, actual spend, or budget threshold, such as dollars or GB.

SsmActionDefinition

ssmActionDefinition_region :: Lens' SsmActionDefinition Text Source #

The Region to run the SSM document.

Subscriber

subscriber_subscriptionType :: Lens' Subscriber SubscriptionType Source #

The type of notification that AWS sends to a subscriber.

subscriber_address :: Lens' Subscriber Text Source #

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.

TimePeriod

timePeriod_start :: Lens' TimePeriod (Maybe UTCTime) Source #

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.

timePeriod_end :: Lens' TimePeriod (Maybe UTCTime) Source #

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.