@aws-sdk/client-budgets 3.569.0 → 3.572.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +31 -7
  2. package/dist-cjs/index.js +152 -1
  3. package/dist-es/Budgets.js +6 -0
  4. package/dist-es/commands/ListTagsForResourceCommand.js +24 -0
  5. package/dist-es/commands/TagResourceCommand.js +24 -0
  6. package/dist-es/commands/UntagResourceCommand.js +24 -0
  7. package/dist-es/commands/index.js +3 -0
  8. package/dist-es/models/models_0.js +13 -0
  9. package/dist-es/protocols/Aws_json1_1.js +72 -1
  10. package/dist-types/Budgets.d.ts +21 -0
  11. package/dist-types/BudgetsClient.d.ts +5 -2
  12. package/dist-types/commands/CreateBudgetActionCommand.d.ts +9 -0
  13. package/dist-types/commands/CreateBudgetCommand.d.ts +9 -0
  14. package/dist-types/commands/DeleteBudgetActionCommand.d.ts +2 -2
  15. package/dist-types/commands/DescribeBudgetNotificationsForAccountCommand.d.ts +1 -3
  16. package/dist-types/commands/ExecuteBudgetActionCommand.d.ts +2 -2
  17. package/dist-types/commands/ListTagsForResourceCommand.d.ts +80 -0
  18. package/dist-types/commands/TagResourceCommand.d.ts +82 -0
  19. package/dist-types/commands/UntagResourceCommand.d.ts +76 -0
  20. package/dist-types/commands/UpdateBudgetActionCommand.d.ts +2 -2
  21. package/dist-types/commands/index.d.ts +3 -0
  22. package/dist-types/models/models_0.d.ts +285 -118
  23. package/dist-types/protocols/Aws_json1_1.d.ts +27 -0
  24. package/dist-types/ts3.4/Budgets.d.ts +51 -0
  25. package/dist-types/ts3.4/BudgetsClient.d.ts +18 -0
  26. package/dist-types/ts3.4/commands/ListTagsForResourceCommand.d.ts +39 -0
  27. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +35 -0
  28. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +38 -0
  29. package/dist-types/ts3.4/commands/index.d.ts +3 -0
  30. package/dist-types/ts3.4/models/models_0.d.ts +30 -0
  31. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +36 -0
  32. package/package.json +8 -8
@@ -211,7 +211,8 @@ export declare const SubscriptionType: {
211
211
  */
212
212
  export type SubscriptionType = (typeof SubscriptionType)[keyof typeof SubscriptionType];
213
213
  /**
214
- * <p>The subscriber to a budget notification. The subscriber consists of a subscription type and either an Amazon SNS topic or an email address.</p>
214
+ * <p>The subscriber to a budget notification. The subscriber consists of a subscription
215
+ * type and either an Amazon SNS topic or an email address.</p>
215
216
  * <p>For example, an email subscriber has the following parameters:</p>
216
217
  * <ul>
217
218
  * <li>
@@ -232,8 +233,10 @@ export interface Subscriber {
232
233
  */
233
234
  SubscriptionType: SubscriptionType | undefined;
234
235
  /**
235
- * <p>The address that Amazon Web Services sends budget notifications to, either an SNS topic or an email.</p>
236
- * <p>When you create a subscriber, the value of <code>Address</code> can't contain line breaks.</p>
236
+ * <p>The address that Amazon Web Services sends budget notifications to, either an SNS topic
237
+ * or an email.</p>
238
+ * <p>When you create a subscriber, the value of <code>Address</code> can't contain line
239
+ * breaks.</p>
237
240
  * @public
238
241
  */
239
242
  Address: string | undefined;
@@ -249,8 +252,8 @@ export interface Action {
249
252
  */
250
253
  ActionId: string | undefined;
251
254
  /**
252
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
253
- * substring, aren't allowed.</p>
255
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
256
+ * "/action/" substring, aren't allowed.</p>
254
257
  * @public
255
258
  */
256
259
  BudgetName: string | undefined;
@@ -260,8 +263,8 @@ export interface Action {
260
263
  */
261
264
  NotificationType: NotificationType | undefined;
262
265
  /**
263
- * <p>The type of action. This defines the type of tasks that can be carried out by this action.
264
- * This field also determines the format for definition. </p>
266
+ * <p>The type of action. This defines the type of tasks that can be carried out by this
267
+ * action. This field also determines the format for definition. </p>
265
268
  * @public
266
269
  */
267
270
  ActionType: ActionType | undefined;
@@ -276,8 +279,8 @@ export interface Action {
276
279
  */
277
280
  Definition: Definition | undefined;
278
281
  /**
279
- * <p>The role passed for action execution and reversion. Roles and actions must be in the same
280
- * account. </p>
282
+ * <p>The role passed for action execution and reversion. Roles and actions must be in the
283
+ * same account. </p>
281
284
  * @public
282
285
  */
283
286
  ExecutionRoleArn: string | undefined;
@@ -344,8 +347,8 @@ export interface ActionHistory {
344
347
  */
345
348
  Status: ActionStatus | undefined;
346
349
  /**
347
- * <p>This distinguishes between whether the events are triggered by the user or are generated by
348
- * the system. </p>
350
+ * <p>This distinguishes between whether the events are triggered by the user or are
351
+ * generated by the system. </p>
349
352
  * @public
350
353
  */
351
354
  EventType: EventType | undefined;
@@ -368,33 +371,49 @@ export declare const AutoAdjustType: {
368
371
  */
369
372
  export type AutoAdjustType = (typeof AutoAdjustType)[keyof typeof AutoAdjustType];
370
373
  /**
371
- * <p>The parameters that define or describe the historical data that your auto-adjusting budget is based on.</p>
374
+ * <p>The parameters that define or describe the historical data that your auto-adjusting
375
+ * budget is based on.</p>
372
376
  * @public
373
377
  */
374
378
  export interface HistoricalOptions {
375
379
  /**
376
- * <p>The number of budget periods included in the moving-average calculation that determines your auto-adjusted budget amount. The maximum value depends on the <code>TimeUnit</code> granularity of the budget:</p>
380
+ * <p>The number of budget periods included in the moving-average calculation that
381
+ * determines your auto-adjusted budget amount. The maximum value depends on the
382
+ * <code>TimeUnit</code> granularity of the budget:</p>
377
383
  * <ul>
378
384
  * <li>
379
- * <p>For the <code>DAILY</code> granularity, the maximum value is <code>60</code>.</p>
385
+ * <p>For the <code>DAILY</code> granularity, the maximum value is
386
+ * <code>60</code>.</p>
380
387
  * </li>
381
388
  * <li>
382
- * <p>For the <code>MONTHLY</code> granularity, the maximum value is <code>12</code>.</p>
389
+ * <p>For the <code>MONTHLY</code> granularity, the maximum value is
390
+ * <code>12</code>.</p>
383
391
  * </li>
384
392
  * <li>
385
- * <p>For the <code>QUARTERLY</code> granularity, the maximum value is <code>4</code>.</p>
393
+ * <p>For the <code>QUARTERLY</code> granularity, the maximum value is
394
+ * <code>4</code>.</p>
386
395
  * </li>
387
396
  * <li>
388
- * <p>For the <code>ANNUALLY</code> granularity, the maximum value is <code>1</code>.</p>
397
+ * <p>For the <code>ANNUALLY</code> granularity, the maximum value is
398
+ * <code>1</code>.</p>
389
399
  * </li>
390
400
  * </ul>
391
401
  * @public
392
402
  */
393
403
  BudgetAdjustmentPeriod: number | undefined;
394
404
  /**
395
- * <p>The integer that describes how many budget periods in your <code>BudgetAdjustmentPeriod</code> are included in the calculation of your current <code>BudgetLimit</code>. If the first budget period in your <code>BudgetAdjustmentPeriod</code> has no cost data, then that budget period isn’t included in the average that determines your budget limit. </p>
396
- * <p>For example, if you set <code>BudgetAdjustmentPeriod</code> as <code>4</code> quarters, but your account had no cost data in the first quarter, then only the last three quarters are included in the calculation. In this scenario, <code>LookBackAvailablePeriods</code> returns <code>3</code>. </p>
397
- * <p>You can’t set your own <code>LookBackAvailablePeriods</code>. The value is automatically calculated from the <code>BudgetAdjustmentPeriod</code> and your historical cost data.</p>
405
+ * <p>The integer that describes how many budget periods in your
406
+ * <code>BudgetAdjustmentPeriod</code> are included in the calculation of your current
407
+ * <code>BudgetLimit</code>. If the first budget period in your
408
+ * <code>BudgetAdjustmentPeriod</code> has no cost data, then that budget period isn’t
409
+ * included in the average that determines your budget limit. </p>
410
+ * <p>For example, if you set <code>BudgetAdjustmentPeriod</code> as <code>4</code>
411
+ * quarters, but your account had no cost data in the first quarter, then only the last
412
+ * three quarters are included in the calculation. In this scenario,
413
+ * <code>LookBackAvailablePeriods</code> returns <code>3</code>. </p>
414
+ * <p>You can’t set your own <code>LookBackAvailablePeriods</code>. The value is
415
+ * automatically calculated from the <code>BudgetAdjustmentPeriod</code> and your
416
+ * historical cost data.</p>
398
417
  * @public
399
418
  */
400
419
  LookBackAvailablePeriods?: number;
@@ -405,12 +424,14 @@ export interface HistoricalOptions {
405
424
  */
406
425
  export interface AutoAdjustData {
407
426
  /**
408
- * <p>The string that defines whether your budget auto-adjusts based on historical or forecasted data.</p>
427
+ * <p>The string that defines whether your budget auto-adjusts based on historical or
428
+ * forecasted data.</p>
409
429
  * @public
410
430
  */
411
431
  AutoAdjustType: AutoAdjustType | undefined;
412
432
  /**
413
- * <p>The parameters that define or describe the historical data that your auto-adjusting budget is based on.</p>
433
+ * <p>The parameters that define or describe the historical data that your auto-adjusting
434
+ * budget is based on.</p>
414
435
  * @public
415
436
  */
416
437
  HistoricalOptions?: HistoricalOptions;
@@ -452,8 +473,8 @@ export interface AutoAdjustData {
452
473
  */
453
474
  export interface Spend {
454
475
  /**
455
- * <p>The cost or usage amount that's associated with a budget forecast, actual spend, or budget
456
- * threshold.</p>
476
+ * <p>The cost or usage amount that's associated with a budget forecast, actual spend, or
477
+ * budget threshold.</p>
457
478
  * @public
458
479
  */
459
480
  Amount: string | undefined;
@@ -481,12 +502,12 @@ export declare const BudgetType: {
481
502
  */
482
503
  export type BudgetType = (typeof BudgetType)[keyof typeof BudgetType];
483
504
  /**
484
- * <p>The spend objects that are associated with this budget. The <code>actualSpend</code> tracks
485
- * how much you've used, cost, usage, RI units, or Savings Plans units and the
505
+ * <p>The spend objects that are associated with this budget. The <code>actualSpend</code>
506
+ * tracks how much you've used, cost, usage, RI units, or Savings Plans units and the
486
507
  * <code>forecastedSpend</code> tracks how much that you're predicted to spend based on
487
508
  * your historical usage profile.</p>
488
- * <p>For example, if it's the 20th of the month and you have spent <code>50</code> dollars on
489
- * Amazon EC2, your <code>actualSpend</code> is <code>50 USD</code>, and your
509
+ * <p>For example, if it's the 20th of the month and you have spent <code>50</code> dollars
510
+ * on Amazon EC2, your <code>actualSpend</code> is <code>50 USD</code>, and your
490
511
  * <code>forecastedSpend</code> is <code>75 USD</code>.</p>
491
512
  * @public
492
513
  */
@@ -504,7 +525,8 @@ export interface CalculatedSpend {
504
525
  ForecastedSpend?: Spend;
505
526
  }
506
527
  /**
507
- * <p>The types of cost that are included in a <code>COST</code> budget, such as tax and subscriptions.</p>
528
+ * <p>The types of cost that are included in a <code>COST</code> budget, such as tax and
529
+ * subscriptions.</p>
508
530
  * <p>
509
531
  * <code>USAGE</code>, <code>RI_UTILIZATION</code>, <code>RI_COVERAGE</code>,
510
532
  * <code>SAVINGS_PLANS_UTILIZATION</code>, and <code>SAVINGS_PLANS_COVERAGE</code>
@@ -580,19 +602,28 @@ export interface CostTypes {
580
602
  UseAmortized?: boolean;
581
603
  }
582
604
  /**
583
- * <p>The period of time that's covered by a budget. The period has a start date and an end date.
584
- * The start date must come before the end date. There are no restrictions on the end date. </p>
605
+ * <p>The period of time that's covered by a budget. The period has a start date and an end
606
+ * date. The start date must come before the end date. There are no restrictions on the end
607
+ * date. </p>
585
608
  * @public
586
609
  */
587
610
  export interface TimePeriod {
588
611
  /**
589
- * <p>The start date for a budget. If you created your budget and didn't specify a start date, Amazon Web Services 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 <code>DAILY</code>, and didn't set a start date, Amazon Web Services set your start date to <code>01/24/18 00:00 UTC</code>. If you chose <code>MONTHLY</code>, Amazon Web Services set your start date to <code>01/01/18 00:00 UTC</code>. The defaults are the same for the Billing and Cost Management console and the API.</p>
612
+ * <p>The start date for a budget. If you created your budget and didn't specify a start
613
+ * date, Amazon Web Services defaults to the start of your chosen time period (DAILY,
614
+ * MONTHLY, QUARTERLY, or ANNUALLY). For example, if you created your budget on January 24,
615
+ * 2018, chose <code>DAILY</code>, and didn't set a start date, Amazon Web Services set your
616
+ * start date to <code>01/24/18 00:00 UTC</code>. If you chose <code>MONTHLY</code>,
617
+ * Amazon Web Services set your start date to <code>01/01/18 00:00 UTC</code>. The
618
+ * defaults are the same for the Billing and Cost Management console and the API.</p>
590
619
  * <p>You can change your start date with the <code>UpdateBudget</code> operation.</p>
591
620
  * @public
592
621
  */
593
622
  Start?: Date;
594
623
  /**
595
- * <p>The end date for a budget. If you didn't specify an end date, Amazon Web Services set your end date to <code>06/15/87 00:00 UTC</code>. The defaults are the same for the Billing and Cost Management console and the API.</p>
624
+ * <p>The end date for a budget. If you didn't specify an end date, Amazon Web Services set
625
+ * your end date to <code>06/15/87 00:00 UTC</code>. The defaults are the same for the
626
+ * Billing and Cost Management console and the API.</p>
596
627
  * <p>After the end date, Amazon Web Services deletes the budget and all the associated
597
628
  * notifications and subscribers. You can change your end date with the
598
629
  * <code>UpdateBudget</code> operation.</p>
@@ -615,7 +646,9 @@ export declare const TimeUnit: {
615
646
  */
616
647
  export type TimeUnit = (typeof TimeUnit)[keyof typeof TimeUnit];
617
648
  /**
618
- * <p>Represents the output of the <code>CreateBudget</code> operation. The content consists of the detailed metadata and data file information, and the current status of the <code>budget</code> object.</p>
649
+ * <p>Represents the output of the <code>CreateBudget</code> operation. The content consists
650
+ * of the detailed metadata and data file information, and the current status of the
651
+ * <code>budget</code> object.</p>
619
652
  * <p>This is the Amazon Resource Name (ARN) pattern for a budget: </p>
620
653
  * <p>
621
654
  * <code>arn:aws:budgets::AccountId:budget/budgetName</code>
@@ -624,15 +657,15 @@ export type TimeUnit = (typeof TimeUnit)[keyof typeof TimeUnit];
624
657
  */
625
658
  export interface Budget {
626
659
  /**
627
- * <p>The name of a budget. The name must be unique within an account. The <code>:</code> and
628
- * <code>\</code> characters, and the "/action/" substring, aren't allowed in
660
+ * <p>The name of a budget. The name must be unique within an account. The <code>:</code>
661
+ * and <code>\</code> characters, and the "/action/" substring, aren't allowed in
629
662
  * <code>BudgetName</code>.</p>
630
663
  * @public
631
664
  */
632
665
  BudgetName: string | undefined;
633
666
  /**
634
- * <p>The total amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or
635
- * Savings Plans coverage that you want to track with your budget.</p>
667
+ * <p>The total amount of cost, usage, RI utilization, RI coverage, Savings Plans
668
+ * utilization, or Savings Plans coverage that you want to track with your budget.</p>
636
669
  * <p>
637
670
  * <code>BudgetLimit</code> is required for cost or usage budgets, but optional for RI or
638
671
  * Savings Plans utilization or coverage budgets. RI and Savings Plans utilization or
@@ -644,20 +677,26 @@ export interface Budget {
644
677
  */
645
678
  BudgetLimit?: Spend;
646
679
  /**
647
- * <p>A map containing multiple <code>BudgetLimit</code>, including current or future limits.</p>
680
+ * <p>A map containing multiple <code>BudgetLimit</code>, including current or future
681
+ * limits.</p>
648
682
  * <p>
649
- * <code>PlannedBudgetLimits</code> is available for cost or usage budget and supports both
650
- * monthly and quarterly <code>TimeUnit</code>. </p>
651
- * <p>For monthly budgets, provide 12 months of <code>PlannedBudgetLimits</code> values. This must start from the current month and include the next 11 months. The <code>key</code> is the start of the month, <code>UTC</code> in epoch seconds. </p>
683
+ * <code>PlannedBudgetLimits</code> is available for cost or usage budget and supports
684
+ * both monthly and quarterly <code>TimeUnit</code>. </p>
685
+ * <p>For monthly budgets, provide 12 months of <code>PlannedBudgetLimits</code> values.
686
+ * This must start from the current month and include the next 11 months. The
687
+ * <code>key</code> is the start of the month, <code>UTC</code> in epoch seconds. </p>
652
688
  * <p>For quarterly budgets, provide four quarters of <code>PlannedBudgetLimits</code> value
653
689
  * entries in standard calendar quarter increments. This must start from the current
654
690
  * quarter and include the next three quarters. The <code>key</code> is the start of the
655
691
  * quarter, <code>UTC</code> in epoch seconds. </p>
656
- * <p>If the planned budget expires before 12 months for monthly or four quarters for quarterly,
657
- * provide the <code>PlannedBudgetLimits</code> values only for the remaining
692
+ * <p>If the planned budget expires before 12 months for monthly or four quarters for
693
+ * quarterly, provide the <code>PlannedBudgetLimits</code> values only for the remaining
658
694
  * periods.</p>
659
- * <p>If the budget begins at a date in the future, provide <code>PlannedBudgetLimits</code> values from the start date of the budget. </p>
660
- * <p>After all of the <code>BudgetLimit</code> values in <code>PlannedBudgetLimits</code> are used, the budget continues to use the last limit as the <code>BudgetLimit</code>. At that point, the planned budget provides the same experience as a fixed budget. </p>
695
+ * <p>If the budget begins at a date in the future, provide <code>PlannedBudgetLimits</code>
696
+ * values from the start date of the budget. </p>
697
+ * <p>After all of the <code>BudgetLimit</code> values in <code>PlannedBudgetLimits</code>
698
+ * are used, the budget continues to use the last limit as the <code>BudgetLimit</code>. At
699
+ * that point, the planned budget provides the same experience as a fixed budget. </p>
661
700
  * <p>
662
701
  * <code>DescribeBudget</code> and <code>DescribeBudgets</code> response along with
663
702
  * <code>PlannedBudgetLimits</code> also contain <code>BudgetLimit</code> representing
@@ -670,7 +709,9 @@ export interface Budget {
670
709
  */
671
710
  PlannedBudgetLimits?: Record<string, Spend>;
672
711
  /**
673
- * <p>The cost filters, such as <code>Region</code>, <code>Service</code>, <code>member account</code>, <code>Tag</code>, or <code>Cost Category</code>, that are applied to a budget.</p>
712
+ * <p>The cost filters, such as <code>Region</code>, <code>Service</code>,
713
+ * <code>LinkedAccount</code>, <code>Tag</code>, or <code>CostCategory</code>, that are
714
+ * applied to a budget.</p>
674
715
  * <p>Amazon Web Services Budgets supports the following services as a <code>Service</code> filter for RI budgets:</p>
675
716
  * <ul>
676
717
  * <li>
@@ -695,7 +736,9 @@ export interface Budget {
695
736
  /**
696
737
  * <p>The types of costs that are included in this <code>COST</code> budget.</p>
697
738
  * <p>
698
- * <code>USAGE</code>, <code>RI_UTILIZATION</code>, <code>RI_COVERAGE</code>, <code>SAVINGS_PLANS_UTILIZATION</code>, and <code>SAVINGS_PLANS_COVERAGE</code> budgets do not have <code>CostTypes</code>.</p>
739
+ * <code>USAGE</code>, <code>RI_UTILIZATION</code>, <code>RI_COVERAGE</code>,
740
+ * <code>SAVINGS_PLANS_UTILIZATION</code>, and <code>SAVINGS_PLANS_COVERAGE</code>
741
+ * budgets do not have <code>CostTypes</code>.</p>
699
742
  * @public
700
743
  */
701
744
  CostTypes?: CostTypes;
@@ -705,16 +748,16 @@ export interface Budget {
705
748
  */
706
749
  TimeUnit: TimeUnit | undefined;
707
750
  /**
708
- * <p>The period of time that's covered by a budget. You setthe start date and end date. The start
709
- * date must come before the end date. The end date must come before <code>06/15/87 00:00
710
- * UTC</code>. </p>
711
- * <p>If you create your budget and don't specify a start date, Amazon Web Services defaults to the
712
- * start of your chosen time period (DAILY, MONTHLY, QUARTERLY, or ANNUALLY). For example,
713
- * if you created your budget on January 24, 2018, chose <code>DAILY</code>, and didn't set
714
- * a start date, Amazon Web Services set your start date to <code>01/24/18 00:00 UTC</code>.
715
- * If you chose <code>MONTHLY</code>, Amazon Web Services set your start date to
716
- * <code>01/01/18 00:00 UTC</code>. If you didn't specify an end date, Amazon Web Services set your end date to <code>06/15/87 00:00 UTC</code>. The defaults are the same for
717
- * the Billing and Cost Management console and the API. </p>
751
+ * <p>The period of time that's covered by a budget. You setthe start date and end date. The
752
+ * start date must come before the end date. The end date must come before <code>06/15/87
753
+ * 00:00 UTC</code>. </p>
754
+ * <p>If you create your budget and don't specify a start date, Amazon Web Services defaults
755
+ * to the start of your chosen time period (DAILY, MONTHLY, QUARTERLY, or ANNUALLY). For
756
+ * example, if you created your budget on January 24, 2018, chose <code>DAILY</code>, and
757
+ * didn't set a start date, Amazon Web Services set your start date to <code>01/24/18 00:00
758
+ * UTC</code>. If you chose <code>MONTHLY</code>, Amazon Web Services set your start
759
+ * date to <code>01/01/18 00:00 UTC</code>. If you didn't specify an end date, Amazon Web Services set your end date to <code>06/15/87 00:00 UTC</code>. The defaults are
760
+ * the same for the Billing and Cost Management console and the API. </p>
718
761
  * <p>You can change either date with the <code>UpdateBudget</code> operation.</p>
719
762
  * <p>After the end date, Amazon Web Services deletes the budget and all the associated
720
763
  * notifications and subscribers.</p>
@@ -727,8 +770,8 @@ export interface Budget {
727
770
  */
728
771
  CalculatedSpend?: CalculatedSpend;
729
772
  /**
730
- * <p>Specifies whether this budget tracks costs, usage, RI utilization, RI coverage, Savings
731
- * Plans utilization, or Savings Plans coverage.</p>
773
+ * <p>Specifies whether this budget tracks costs, usage, RI utilization, RI coverage,
774
+ * Savings Plans utilization, or Savings Plans coverage.</p>
732
775
  * @public
733
776
  */
734
777
  BudgetType: BudgetType | undefined;
@@ -769,9 +812,12 @@ export declare const NotificationState: {
769
812
  */
770
813
  export type NotificationState = (typeof NotificationState)[keyof typeof NotificationState];
771
814
  /**
772
- * <p>A notification that's associated with a budget. A budget can have up to ten notifications. </p>
773
- * <p>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.</p>
774
- * <p>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:</p>
815
+ * <p>A notification that's associated with a budget. A budget can have up to ten
816
+ * notifications. </p>
817
+ * <p>Each notification must have at least one subscriber. A notification can have one SNS
818
+ * subscriber and up to 10 email subscribers, for a total of 11 subscribers.</p>
819
+ * <p>For example, if you have a budget for 200 dollars and you want to be notified when you
820
+ * go over 160 dollars, create a notification with the following parameters:</p>
775
821
  * <ul>
776
822
  * <li>
777
823
  * <p>A notificationType of <code>ACTUAL</code>
@@ -794,8 +840,9 @@ export type NotificationState = (typeof NotificationState)[keyof typeof Notifica
794
840
  */
795
841
  export interface Notification {
796
842
  /**
797
- * <p>Specifies whether the notification is for how much you have spent (<code>ACTUAL</code>) or
798
- * for how much that you're forecasted to spend (<code>FORECASTED</code>).</p>
843
+ * <p>Specifies whether the notification is for how much you have spent
844
+ * (<code>ACTUAL</code>) or for how much that you're forecasted to spend
845
+ * (<code>FORECASTED</code>).</p>
799
846
  * @public
800
847
  */
801
848
  NotificationType: NotificationType | undefined;
@@ -805,14 +852,21 @@ export interface Notification {
805
852
  */
806
853
  ComparisonOperator: ComparisonOperator | undefined;
807
854
  /**
808
- * <p>The threshold that's associated with a notification. Thresholds are always a percentage, and
809
- * many customers find value being alerted between 50% - 200% of the budgeted amount. The
810
- * maximum limit for your threshold is 1,000,000% above the budgeted amount.</p>
855
+ * <p>The threshold that's associated with a notification. Thresholds are always a
856
+ * percentage, and many customers find value being alerted between 50% - 200% of the
857
+ * budgeted amount. The maximum limit for your threshold is 1,000,000% above the budgeted
858
+ * amount.</p>
811
859
  * @public
812
860
  */
813
861
  Threshold: number | undefined;
814
862
  /**
815
- * <p>The type of threshold for a notification. For <code>ABSOLUTE_VALUE</code> thresholds, Amazon Web Services notifies you when you go over or are forecasted to go over your total cost threshold. For <code>PERCENTAGE</code> thresholds, Amazon Web Services 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 <code>PERCENTAGE</code> threshold of 80%, Amazon Web Services notifies you when you go over 160 dollars.</p>
863
+ * <p>The type of threshold for a notification. For <code>ABSOLUTE_VALUE</code> thresholds,
864
+ * Amazon Web Services notifies you when you go over or are forecasted to go over your
865
+ * total cost threshold. For
866
+ * <code>PERCENTAGE</code> thresholds, Amazon Web Services notifies you when you go over
867
+ * or are forecasted to go over a certain percentage of your forecasted spend. For example,
868
+ * if you have a budget for 200 dollars and you have a <code>PERCENTAGE</code> threshold of
869
+ * 80%, Amazon Web Services notifies you when you go over 160 dollars.</p>
816
870
  * @public
817
871
  */
818
872
  ThresholdType?: ThresholdType;
@@ -824,7 +878,8 @@ export interface Notification {
824
878
  NotificationState?: NotificationState;
825
879
  }
826
880
  /**
827
- * <p>A notification with subscribers. A notification can have one SNS subscriber and up to 10 email subscribers, for a total of 11 subscribers.</p>
881
+ * <p>A notification with subscribers. A notification can have one SNS subscriber and up to
882
+ * 10 email subscribers, for a total of 11 subscribers.</p>
828
883
  * @public
829
884
  */
830
885
  export interface NotificationWithSubscribers {
@@ -839,6 +894,22 @@ export interface NotificationWithSubscribers {
839
894
  */
840
895
  Subscribers: Subscriber[] | undefined;
841
896
  }
897
+ /**
898
+ * <p>The tag structure that contains a tag key and value.</p>
899
+ * @public
900
+ */
901
+ export interface ResourceTag {
902
+ /**
903
+ * <p>The key that's associated with the tag.</p>
904
+ * @public
905
+ */
906
+ Key: string | undefined;
907
+ /**
908
+ * <p>The value that's associated with the tag.</p>
909
+ * @public
910
+ */
911
+ Value: string | undefined;
912
+ }
842
913
  /**
843
914
  * <p> Request of CreateBudget </p>
844
915
  * @public
@@ -859,6 +930,12 @@ export interface CreateBudgetRequest {
859
930
  * @public
860
931
  */
861
932
  NotificationsWithSubscribers?: NotificationWithSubscribers[];
933
+ /**
934
+ * <p>An optional list of tags to associate with the specified budget. Each tag consists of a
935
+ * key and a value, and each key must be unique for the resource.</p>
936
+ * @public
937
+ */
938
+ ResourceTags?: ResourceTag[];
862
939
  }
863
940
  /**
864
941
  * <p> Response of CreateBudget </p>
@@ -934,6 +1011,23 @@ export declare class InvalidParameterException extends __BaseException {
934
1011
  */
935
1012
  constructor(opts: __ExceptionOptionType<InvalidParameterException, __BaseException>);
936
1013
  }
1014
+ /**
1015
+ * <p>You've reached the limit on the number of tags you can associate with a resource.</p>
1016
+ * @public
1017
+ */
1018
+ export declare class ServiceQuotaExceededException extends __BaseException {
1019
+ readonly name: "ServiceQuotaExceededException";
1020
+ readonly $fault: "client";
1021
+ /**
1022
+ * <p>The error message the exception carries.</p>
1023
+ * @public
1024
+ */
1025
+ Message?: string;
1026
+ /**
1027
+ * @internal
1028
+ */
1029
+ constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
1030
+ }
937
1031
  /**
938
1032
  * <p>The number of API requests has exceeded the maximum allowed API request throttling limit
939
1033
  * for the account.</p>
@@ -962,8 +1056,8 @@ export interface CreateBudgetActionRequest {
962
1056
  */
963
1057
  AccountId: string | undefined;
964
1058
  /**
965
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
966
- * substring, aren't allowed.</p>
1059
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1060
+ * "/action/" substring, aren't allowed.</p>
967
1061
  * @public
968
1062
  */
969
1063
  BudgetName: string | undefined;
@@ -1008,6 +1102,12 @@ export interface CreateBudgetActionRequest {
1008
1102
  * @public
1009
1103
  */
1010
1104
  Subscribers: Subscriber[] | undefined;
1105
+ /**
1106
+ * <p>An optional list of tags to associate with the specified budget action. Each tag consists of a
1107
+ * key and a value, and each key must be unique for the resource.</p>
1108
+ * @public
1109
+ */
1110
+ ResourceTags?: ResourceTag[];
1011
1111
  }
1012
1112
  /**
1013
1113
  * @public
@@ -1019,8 +1119,8 @@ export interface CreateBudgetActionResponse {
1019
1119
  */
1020
1120
  AccountId: string | undefined;
1021
1121
  /**
1022
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1023
- * substring, aren't allowed.</p>
1122
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1123
+ * "/action/" substring, aren't allowed.</p>
1024
1124
  * @public
1025
1125
  */
1026
1126
  BudgetName: string | undefined;
@@ -1145,8 +1245,8 @@ export interface DeleteBudgetActionRequest {
1145
1245
  */
1146
1246
  AccountId: string | undefined;
1147
1247
  /**
1148
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1149
- * substring, aren't allowed.</p>
1248
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1249
+ * "/action/" substring, aren't allowed.</p>
1150
1250
  * @public
1151
1251
  */
1152
1252
  BudgetName: string | undefined;
@@ -1168,8 +1268,8 @@ export interface DeleteBudgetActionResponse {
1168
1268
  */
1169
1269
  AccountId: string | undefined;
1170
1270
  /**
1171
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1172
- * substring, aren't allowed.</p>
1271
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1272
+ * "/action/" substring, aren't allowed.</p>
1173
1273
  * @public
1174
1274
  */
1175
1275
  BudgetName: string | undefined;
@@ -1180,8 +1280,8 @@ export interface DeleteBudgetActionResponse {
1180
1280
  Action: Action | undefined;
1181
1281
  }
1182
1282
  /**
1183
- * <p> The request was received and recognized by the server, but the server rejected that
1184
- * particular method for the requested resource. </p>
1283
+ * <p>The request was received and recognized by the server, but the server rejected that
1284
+ * particular method for the requested resource.</p>
1185
1285
  * @public
1186
1286
  */
1187
1287
  export declare class ResourceLockedException extends __BaseException {
@@ -1293,8 +1393,8 @@ export interface DescribeBudgetActionRequest {
1293
1393
  */
1294
1394
  AccountId: string | undefined;
1295
1395
  /**
1296
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1297
- * substring, aren't allowed.</p>
1396
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1397
+ * "/action/" substring, aren't allowed.</p>
1298
1398
  * @public
1299
1399
  */
1300
1400
  BudgetName: string | undefined;
@@ -1316,8 +1416,8 @@ export interface DescribeBudgetActionResponse {
1316
1416
  */
1317
1417
  AccountId: string | undefined;
1318
1418
  /**
1319
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1320
- * substring, aren't allowed.</p>
1419
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1420
+ * "/action/" substring, aren't allowed.</p>
1321
1421
  * @public
1322
1422
  */
1323
1423
  BudgetName: string | undefined;
@@ -1339,8 +1439,8 @@ export interface DescribeBudgetActionHistoriesRequest {
1339
1439
  */
1340
1440
  AccountId: string | undefined;
1341
1441
  /**
1342
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1343
- * substring, aren't allowed.</p>
1442
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1443
+ * "/action/" substring, aren't allowed.</p>
1344
1444
  * @public
1345
1445
  */
1346
1446
  BudgetName: string | undefined;
@@ -1352,13 +1452,15 @@ export interface DescribeBudgetActionHistoriesRequest {
1352
1452
  */
1353
1453
  ActionId: string | undefined;
1354
1454
  /**
1355
- * <p>The period of time that's covered by a budget. The period has a start date and an end date.
1356
- * The start date must come before the end date. There are no restrictions on the end date. </p>
1455
+ * <p>The period of time that's covered by a budget. The period has a start date and an end
1456
+ * date. The start date must come before the end date. There are no restrictions on the end
1457
+ * date. </p>
1357
1458
  * @public
1358
1459
  */
1359
1460
  TimePeriod?: TimePeriod;
1360
1461
  /**
1361
- * <p> An integer that represents how many entries a paginated response contains. The maximum is 100.</p>
1462
+ * <p> An integer that represents how many entries a paginated response contains. The
1463
+ * maximum is 100.</p>
1362
1464
  * @public
1363
1465
  */
1364
1466
  MaxResults?: number;
@@ -1412,7 +1514,8 @@ export interface DescribeBudgetActionsForAccountRequest {
1412
1514
  */
1413
1515
  AccountId: string | undefined;
1414
1516
  /**
1415
- * <p> An integer that represents how many entries a paginated response contains. The maximum is 100.</p>
1517
+ * <p> An integer that represents how many entries a paginated response contains. The
1518
+ * maximum is 100.</p>
1416
1519
  * @public
1417
1520
  */
1418
1521
  MaxResults?: number;
@@ -1449,13 +1552,14 @@ export interface DescribeBudgetActionsForBudgetRequest {
1449
1552
  */
1450
1553
  AccountId: string | undefined;
1451
1554
  /**
1452
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1453
- * substring, aren't allowed.</p>
1555
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1556
+ * "/action/" substring, aren't allowed.</p>
1454
1557
  * @public
1455
1558
  */
1456
1559
  BudgetName: string | undefined;
1457
1560
  /**
1458
- * <p> An integer that represents how many entries a paginated response contains. The maximum is 100.</p>
1561
+ * <p> An integer that represents how many entries a paginated response contains. The
1562
+ * maximum is 100.</p>
1459
1563
  * @public
1460
1564
  */
1461
1565
  MaxResults?: number;
@@ -1492,8 +1596,8 @@ export interface DescribeBudgetNotificationsForAccountRequest {
1492
1596
  */
1493
1597
  AccountId: string | undefined;
1494
1598
  /**
1495
- * <p> An integer that represents how many budgets a paginated response contains. The default is
1496
- * 50. </p>
1599
+ * <p> An integer that represents how many budgets a paginated response contains. The
1600
+ * default is 50. </p>
1497
1601
  * @public
1498
1602
  */
1499
1603
  MaxResults?: number;
@@ -1516,8 +1620,8 @@ export interface BudgetNotificationsForAccount {
1516
1620
  */
1517
1621
  Notifications?: Notification[];
1518
1622
  /**
1519
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1520
- * substring, aren't allowed.</p>
1623
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1624
+ * "/action/" substring, aren't allowed.</p>
1521
1625
  * @public
1522
1626
  */
1523
1627
  BudgetName?: string;
@@ -1527,9 +1631,7 @@ export interface BudgetNotificationsForAccount {
1527
1631
  */
1528
1632
  export interface DescribeBudgetNotificationsForAccountResponse {
1529
1633
  /**
1530
- * <p>
1531
- * A list of budget names and associated notifications for an account.
1532
- * </p>
1634
+ * <p> A list of budget names and associated notifications for an account. </p>
1533
1635
  * @public
1534
1636
  */
1535
1637
  BudgetNotificationsForAccount?: BudgetNotificationsForAccount[];
@@ -1566,8 +1668,8 @@ export interface DescribeBudgetPerformanceHistoryRequest {
1566
1668
  */
1567
1669
  AccountId: string | undefined;
1568
1670
  /**
1569
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1570
- * substring, aren't allowed.</p>
1671
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1672
+ * "/action/" substring, aren't allowed.</p>
1571
1673
  * @public
1572
1674
  */
1573
1675
  BudgetName: string | undefined;
@@ -1577,7 +1679,8 @@ export interface DescribeBudgetPerformanceHistoryRequest {
1577
1679
  */
1578
1680
  TimePeriod?: TimePeriod;
1579
1681
  /**
1580
- * <p> An integer that represents how many entries a paginated response contains. The maximum is 100.</p>
1682
+ * <p> An integer that represents how many entries a paginated response contains. The
1683
+ * maximum is 100.</p>
1581
1684
  * @public
1582
1685
  */
1583
1686
  MaxResults?: number;
@@ -1588,7 +1691,8 @@ export interface DescribeBudgetPerformanceHistoryRequest {
1588
1691
  NextToken?: string;
1589
1692
  }
1590
1693
  /**
1591
- * <p>The amount of cost or usage that you created the budget for, compared to your actual costs or usage.</p>
1694
+ * <p>The amount of cost or usage that you created the budget for, compared to your actual
1695
+ * costs or usage.</p>
1592
1696
  * @public
1593
1697
  */
1594
1698
  export interface BudgetedAndActualAmounts {
@@ -1609,20 +1713,23 @@ export interface BudgetedAndActualAmounts {
1609
1713
  TimePeriod?: TimePeriod;
1610
1714
  }
1611
1715
  /**
1612
- * <p>A history of the state of a budget at the end of the budget's specified time period.</p>
1716
+ * <p>A history of the state of a budget at the end of the budget's specified time
1717
+ * period.</p>
1613
1718
  * @public
1614
1719
  */
1615
1720
  export interface BudgetPerformanceHistory {
1616
1721
  /**
1617
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1618
- * substring, aren't allowed.</p>
1722
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1723
+ * "/action/" substring, aren't allowed.</p>
1619
1724
  * @public
1620
1725
  */
1621
1726
  BudgetName?: string;
1622
1727
  /**
1623
1728
  * <p> The type of a budget. It must be one of the following types: </p>
1624
1729
  * <p>
1625
- * <code>COST</code>, <code>USAGE</code>, <code>RI_UTILIZATION</code>, <code>RI_COVERAGE</code>, <code>SAVINGS_PLANS_UTILIZATION</code>, or <code>SAVINGS_PLANS_COVERAGE</code>.</p>
1730
+ * <code>COST</code>, <code>USAGE</code>, <code>RI_UTILIZATION</code>,
1731
+ * <code>RI_COVERAGE</code>, <code>SAVINGS_PLANS_UTILIZATION</code>, or
1732
+ * <code>SAVINGS_PLANS_COVERAGE</code>.</p>
1626
1733
  * @public
1627
1734
  */
1628
1735
  BudgetType?: BudgetType;
@@ -1642,8 +1749,8 @@ export interface BudgetPerformanceHistory {
1642
1749
  */
1643
1750
  TimeUnit?: TimeUnit;
1644
1751
  /**
1645
- * <p>A list of amounts of cost or usage that you created budgets for, which are compared to your
1646
- * actual costs or usage.</p>
1752
+ * <p>A list of amounts of cost or usage that you created budgets for, which are compared to
1753
+ * your actual costs or usage.</p>
1647
1754
  * @public
1648
1755
  */
1649
1756
  BudgetedAndActualAmountsList?: BudgetedAndActualAmounts[];
@@ -1817,8 +1924,8 @@ export interface ExecuteBudgetActionRequest {
1817
1924
  */
1818
1925
  AccountId: string | undefined;
1819
1926
  /**
1820
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1821
- * substring, aren't allowed.</p>
1927
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1928
+ * "/action/" substring, aren't allowed.</p>
1822
1929
  * @public
1823
1930
  */
1824
1931
  BudgetName: string | undefined;
@@ -1847,8 +1954,8 @@ export interface ExecuteBudgetActionResponse {
1847
1954
  */
1848
1955
  AccountId: string | undefined;
1849
1956
  /**
1850
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1851
- * substring, aren't allowed.</p>
1957
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
1958
+ * "/action/" substring, aren't allowed.</p>
1852
1959
  * @public
1853
1960
  */
1854
1961
  BudgetName: string | undefined;
@@ -1867,6 +1974,66 @@ export interface ExecuteBudgetActionResponse {
1867
1974
  */
1868
1975
  ExecutionType: ExecutionType | undefined;
1869
1976
  }
1977
+ /**
1978
+ * @public
1979
+ */
1980
+ export interface ListTagsForResourceRequest {
1981
+ /**
1982
+ * <p>The unique identifier for the resource.</p>
1983
+ * @public
1984
+ */
1985
+ ResourceARN: string | undefined;
1986
+ }
1987
+ /**
1988
+ * @public
1989
+ */
1990
+ export interface ListTagsForResourceResponse {
1991
+ /**
1992
+ * <p>The tags associated with the resource.</p>
1993
+ * @public
1994
+ */
1995
+ ResourceTags?: ResourceTag[];
1996
+ }
1997
+ /**
1998
+ * @public
1999
+ */
2000
+ export interface TagResourceRequest {
2001
+ /**
2002
+ * <p>The unique identifier for the resource.</p>
2003
+ * @public
2004
+ */
2005
+ ResourceARN: string | undefined;
2006
+ /**
2007
+ * <p>The tags associated with the resource.</p>
2008
+ * @public
2009
+ */
2010
+ ResourceTags: ResourceTag[] | undefined;
2011
+ }
2012
+ /**
2013
+ * @public
2014
+ */
2015
+ export interface TagResourceResponse {
2016
+ }
2017
+ /**
2018
+ * @public
2019
+ */
2020
+ export interface UntagResourceRequest {
2021
+ /**
2022
+ * <p>The unique identifier for the resource.</p>
2023
+ * @public
2024
+ */
2025
+ ResourceARN: string | undefined;
2026
+ /**
2027
+ * <p>The key that's associated with the tag.</p>
2028
+ * @public
2029
+ */
2030
+ ResourceTagKeys: string[] | undefined;
2031
+ }
2032
+ /**
2033
+ * @public
2034
+ */
2035
+ export interface UntagResourceResponse {
2036
+ }
1870
2037
  /**
1871
2038
  * <p> Request of UpdateBudget </p>
1872
2039
  * @public
@@ -1899,8 +2066,8 @@ export interface UpdateBudgetActionRequest {
1899
2066
  */
1900
2067
  AccountId: string | undefined;
1901
2068
  /**
1902
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1903
- * substring, aren't allowed.</p>
2069
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
2070
+ * "/action/" substring, aren't allowed.</p>
1904
2071
  * @public
1905
2072
  */
1906
2073
  BudgetName: string | undefined;
@@ -1956,8 +2123,8 @@ export interface UpdateBudgetActionResponse {
1956
2123
  */
1957
2124
  AccountId: string | undefined;
1958
2125
  /**
1959
- * <p> A string that represents the budget name. The ":" and "\" characters, and the "/action/"
1960
- * substring, aren't allowed.</p>
2126
+ * <p> A string that represents the budget name. The ":" and "\" characters, and the
2127
+ * "/action/" substring, aren't allowed.</p>
1961
2128
  * @public
1962
2129
  */
1963
2130
  BudgetName: string | undefined;