@aws-sdk/client-cost-explorer 3.223.0 → 3.226.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.
- package/README.md +4 -4
- package/dist-cjs/CostExplorer.js +30 -0
- package/dist-cjs/commands/ListSavingsPlansPurchaseRecommendationGenerationCommand.js +46 -0
- package/dist-cjs/commands/StartSavingsPlansPurchaseRecommendationGenerationCommand.js +46 -0
- package/dist-cjs/commands/index.js +2 -0
- package/dist-cjs/endpoint/ruleset.js +11 -20
- package/dist-cjs/models/models_0.js +45 -4
- package/dist-cjs/protocols/Aws_json1_1.js +169 -2
- package/dist-es/CostExplorer.js +30 -0
- package/dist-es/commands/ListSavingsPlansPurchaseRecommendationGenerationCommand.js +42 -0
- package/dist-es/commands/StartSavingsPlansPurchaseRecommendationGenerationCommand.js +42 -0
- package/dist-es/commands/index.js +2 -0
- package/dist-es/endpoint/ruleset.js +11 -20
- package/dist-es/models/models_0.js +34 -0
- package/dist-es/protocols/Aws_json1_1.js +164 -1
- package/dist-types/CostExplorer.d.ts +110 -53
- package/dist-types/CostExplorerClient.d.ts +14 -12
- package/dist-types/commands/DeleteCostCategoryDefinitionCommand.d.ts +2 -1
- package/dist-types/commands/GetCostAndUsageCommand.d.ts +2 -1
- package/dist-types/commands/GetCostAndUsageWithResourcesCommand.d.ts +11 -9
- package/dist-types/commands/GetCostCategoriesCommand.d.ts +2 -1
- package/dist-types/commands/GetCostForecastCommand.d.ts +2 -1
- package/dist-types/commands/GetDimensionValuesCommand.d.ts +2 -1
- package/dist-types/commands/GetReservationCoverageCommand.d.ts +6 -5
- package/dist-types/commands/GetReservationPurchaseRecommendationCommand.d.ts +2 -2
- package/dist-types/commands/GetReservationUtilizationCommand.d.ts +4 -3
- package/dist-types/commands/GetRightsizingRecommendationCommand.d.ts +2 -3
- package/dist-types/commands/GetSavingsPlansCoverageCommand.d.ts +8 -3
- package/dist-types/commands/GetSavingsPlansPurchaseRecommendationCommand.d.ts +4 -1
- package/dist-types/commands/GetSavingsPlansUtilizationCommand.d.ts +7 -3
- package/dist-types/commands/GetSavingsPlansUtilizationDetailsCommand.d.ts +10 -3
- package/dist-types/commands/GetTagsCommand.d.ts +2 -1
- package/dist-types/commands/GetUsageForecastCommand.d.ts +2 -1
- package/dist-types/commands/ListSavingsPlansPurchaseRecommendationGenerationCommand.d.ts +38 -0
- package/dist-types/commands/ListTagsForResourceCommand.d.ts +2 -2
- package/dist-types/commands/StartSavingsPlansPurchaseRecommendationGenerationCommand.d.ts +45 -0
- package/dist-types/commands/TagResourceCommand.d.ts +4 -1
- package/dist-types/commands/UpdateCostCategoryDefinitionCommand.d.ts +3 -1
- package/dist-types/commands/index.d.ts +2 -0
- package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +734 -459
- package/dist-types/protocols/Aws_json1_1.d.ts +6 -0
- package/dist-types/ts3.4/CostExplorer.d.ts +46 -0
- package/dist-types/ts3.4/CostExplorerClient.d.ts +12 -0
- package/dist-types/ts3.4/commands/ListSavingsPlansPurchaseRecommendationGenerationCommand.d.ts +43 -0
- package/dist-types/ts3.4/commands/StartSavingsPlansPurchaseRecommendationGenerationCommand.d.ts +43 -0
- package/dist-types/ts3.4/commands/index.d.ts +2 -0
- package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/ts3.4/models/models_0.d.ts +52 -0
- package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +24 -0
- package/package.json +28 -28
|
@@ -36,8 +36,9 @@ export interface Impact {
|
|
|
36
36
|
TotalImpact?: number;
|
|
37
37
|
}
|
|
38
38
|
/**
|
|
39
|
-
* <p>The combination of Amazon Web Service, linked account,
|
|
40
|
-
* where a cost anomaly is observed.
|
|
39
|
+
* <p>The combination of Amazon Web Service, linked account, linked account name,
|
|
40
|
+
* Region, and usage type where a cost anomaly is observed. The linked account name will
|
|
41
|
+
* only be available when the account name can be identified.</p>
|
|
41
42
|
*/
|
|
42
43
|
export interface RootCause {
|
|
43
44
|
/**
|
|
@@ -56,6 +57,10 @@ export interface RootCause {
|
|
|
56
57
|
* <p>The <code>UsageType</code> value that's associated with the cost anomaly. </p>
|
|
57
58
|
*/
|
|
58
59
|
UsageType?: string;
|
|
60
|
+
/**
|
|
61
|
+
* <p>The member account name value that's associated with the cost anomaly.</p>
|
|
62
|
+
*/
|
|
63
|
+
LinkedAccountName?: string;
|
|
59
64
|
}
|
|
60
65
|
/**
|
|
61
66
|
* <p>An unusual cost pattern. This consists of the detailed metadata and the current status
|
|
@@ -128,10 +133,10 @@ export declare enum MatchOption {
|
|
|
128
133
|
}
|
|
129
134
|
/**
|
|
130
135
|
* <p>The Cost Categories values used for filtering the costs.</p>
|
|
131
|
-
*
|
|
136
|
+
* <p>If <code>Values</code> and <code>Key</code> are not specified, the <code>ABSENT</code>
|
|
132
137
|
* <code>MatchOption</code> is applied to all Cost Categories. That is, it filters on
|
|
133
138
|
* resources that aren't mapped to any Cost Categories.</p>
|
|
134
|
-
*
|
|
139
|
+
* <p>If <code>Values</code> is provided and <code>Key</code> isn't specified, the
|
|
135
140
|
* <code>ABSENT</code>
|
|
136
141
|
* <code>MatchOption</code> is applied to the Cost Categories <code>Key</code> only. That
|
|
137
142
|
* is, it filters on resources without the given Cost Categories key.</p>
|
|
@@ -194,7 +199,9 @@ export declare enum Dimension {
|
|
|
194
199
|
export interface DimensionValues {
|
|
195
200
|
/**
|
|
196
201
|
* <p>The names of the metadata types that you can use to filter and group your results. For
|
|
197
|
-
* example, <code>AZ</code> returns a list of Availability Zones.
|
|
202
|
+
* example, <code>AZ</code> returns a list of Availability Zones.
|
|
203
|
+
* <code>LINK_ACCOUNT_NAME</code> and <code>SERVICE_CODE</code> can only be used in
|
|
204
|
+
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/AAPI_CostCategoryRule.html">CostCategoryRule</a>.</p>
|
|
198
205
|
*/
|
|
199
206
|
Key?: Dimension | string;
|
|
200
207
|
/**
|
|
@@ -212,10 +219,10 @@ export interface DimensionValues {
|
|
|
212
219
|
}
|
|
213
220
|
/**
|
|
214
221
|
* <p>The values that are available for a tag.</p>
|
|
215
|
-
*
|
|
222
|
+
* <p>If <code>Values</code> and <code>Key</code> aren't specified, the <code>ABSENT</code>
|
|
216
223
|
* <code>MatchOption</code> is applied to all tags. That is, it's filtered on resources
|
|
217
224
|
* with no tags.</p>
|
|
218
|
-
*
|
|
225
|
+
* <p>If <code>Key</code> is provided and <code>Values</code> isn't specified, the
|
|
219
226
|
* <code>ABSENT</code>
|
|
220
227
|
* <code>MatchOption</code> is applied to the tag <code>Key</code> only. That is, it's
|
|
221
228
|
* filtered on resources without the given tag key.</p>
|
|
@@ -310,8 +317,9 @@ export interface AnomalySubscription {
|
|
|
310
317
|
}
|
|
311
318
|
/**
|
|
312
319
|
* <p>The tag structure that contains a tag key and value. </p>
|
|
313
|
-
*
|
|
314
|
-
* <p>Tagging is supported only for the following Cost Explorer resource types:
|
|
320
|
+
* <note>
|
|
321
|
+
* <p>Tagging is supported only for the following Cost Explorer resource types:
|
|
322
|
+
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalyMonitor.html">
|
|
315
323
|
* <code>AnomalyMonitor</code>
|
|
316
324
|
* </a>, <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalySubscription.html">
|
|
317
325
|
* <code>AnomalySubscription</code>
|
|
@@ -358,10 +366,12 @@ export interface CreateAnomalySubscriptionRequest {
|
|
|
358
366
|
* <code>AnomalySubscription</code>
|
|
359
367
|
* </a>. You can use resource tags to control access to
|
|
360
368
|
* your <code>subscription</code> using IAM policies.</p>
|
|
361
|
-
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
369
|
+
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
370
|
+
* following restrictions apply to resource tags:</p>
|
|
362
371
|
* <ul>
|
|
363
372
|
* <li>
|
|
364
|
-
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
373
|
+
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
374
|
+
* user-tags to one resource. The remaining are reserved for Amazon Web Services use</p>
|
|
365
375
|
* </li>
|
|
366
376
|
* <li>
|
|
367
377
|
* <p>The maximum length of a key is 128 characters</p>
|
|
@@ -370,7 +380,8 @@ export interface CreateAnomalySubscriptionRequest {
|
|
|
370
380
|
* <p>The maximum length of a value is 256 characters</p>
|
|
371
381
|
* </li>
|
|
372
382
|
* <li>
|
|
373
|
-
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
383
|
+
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
384
|
+
* following: <code>_.:/=+@-</code>
|
|
374
385
|
* </p>
|
|
375
386
|
* </li>
|
|
376
387
|
* <li>
|
|
@@ -380,7 +391,8 @@ export interface CreateAnomalySubscriptionRequest {
|
|
|
380
391
|
* <p>Keys and values are trimmed for any leading or trailing whitespaces</p>
|
|
381
392
|
* </li>
|
|
382
393
|
* <li>
|
|
383
|
-
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
394
|
+
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
395
|
+
* Amazon Web Services use</p>
|
|
384
396
|
* </li>
|
|
385
397
|
* </ul>
|
|
386
398
|
*/
|
|
@@ -393,8 +405,7 @@ export interface CreateAnomalySubscriptionResponse {
|
|
|
393
405
|
SubscriptionArn: string | undefined;
|
|
394
406
|
}
|
|
395
407
|
/**
|
|
396
|
-
* <p>The cost anomaly monitor does not exist for the account.
|
|
397
|
-
* </p>
|
|
408
|
+
* <p>The cost anomaly monitor does not exist for the account. </p>
|
|
398
409
|
*/
|
|
399
410
|
export declare class UnknownMonitorException extends __BaseException {
|
|
400
411
|
readonly name: "UnknownMonitorException";
|
|
@@ -422,7 +433,7 @@ export declare enum CostCategoryInheritedValueDimensionName {
|
|
|
422
433
|
export interface CostCategoryInheritedValueDimension {
|
|
423
434
|
/**
|
|
424
435
|
* <p>The name of the dimension that's used to group costs.</p>
|
|
425
|
-
*
|
|
436
|
+
* <p>If you specify <code>LINKED_ACCOUNT_NAME</code>, the cost category value is based on
|
|
426
437
|
* account name. If you specify <code>TAG</code>, the cost category value is based on the
|
|
427
438
|
* value of the specified tag key.</p>
|
|
428
439
|
*/
|
|
@@ -467,7 +478,8 @@ export interface CostCategorySplitChargeRuleParameter {
|
|
|
467
478
|
export interface CostCategorySplitChargeRule {
|
|
468
479
|
/**
|
|
469
480
|
* <p>The Cost Category value that you want to split. That value can't be used as a source
|
|
470
|
-
* or a target in other split charge rules. To indicate uncategorized costs, you can use an
|
|
481
|
+
* or a target in other split charge rules. To indicate uncategorized costs, you can use an
|
|
482
|
+
* empty string as the source.</p>
|
|
471
483
|
*/
|
|
472
484
|
Source: string | undefined;
|
|
473
485
|
/**
|
|
@@ -477,13 +489,13 @@ export interface CostCategorySplitChargeRule {
|
|
|
477
489
|
Targets: string[] | undefined;
|
|
478
490
|
/**
|
|
479
491
|
* <p>The method that's used to define how to split your source costs across your targets. </p>
|
|
480
|
-
*
|
|
492
|
+
* <p>
|
|
481
493
|
* <code>Proportional</code> - Allocates charges across your targets based on the
|
|
482
494
|
* proportional weighted cost of each target.</p>
|
|
483
|
-
*
|
|
495
|
+
* <p>
|
|
484
496
|
* <code>Fixed</code> - Allocates charges across your targets based on your defined
|
|
485
497
|
* allocation percentage.</p>
|
|
486
|
-
*
|
|
498
|
+
* <p>><code>Even</code> - Allocates costs evenly across all targets.</p>
|
|
487
499
|
*/
|
|
488
500
|
Method: CostCategorySplitChargeMethod | string | undefined;
|
|
489
501
|
/**
|
|
@@ -532,8 +544,7 @@ export interface DeleteAnomalySubscriptionRequest {
|
|
|
532
544
|
export interface DeleteAnomalySubscriptionResponse {
|
|
533
545
|
}
|
|
534
546
|
/**
|
|
535
|
-
* <p>The cost anomaly subscription does not exist for the account.
|
|
536
|
-
* </p>
|
|
547
|
+
* <p>The cost anomaly subscription does not exist for the account. </p>
|
|
537
548
|
*/
|
|
538
549
|
export declare class UnknownSubscriptionException extends __BaseException {
|
|
539
550
|
readonly name: "UnknownSubscriptionException";
|
|
@@ -562,9 +573,7 @@ export interface DeleteCostCategoryDefinitionResponse {
|
|
|
562
573
|
EffectiveEnd?: string;
|
|
563
574
|
}
|
|
564
575
|
/**
|
|
565
|
-
* <p>
|
|
566
|
-
* The specified ARN in the request doesn't exist.
|
|
567
|
-
* </p>
|
|
576
|
+
* <p> The specified ARN in the request doesn't exist. </p>
|
|
568
577
|
*/
|
|
569
578
|
export declare class ResourceNotFoundException extends __BaseException {
|
|
570
579
|
readonly name: "ResourceNotFoundException";
|
|
@@ -722,7 +731,8 @@ export interface GetAnomalySubscriptionsRequest {
|
|
|
722
731
|
}
|
|
723
732
|
export interface GetAnomalySubscriptionsResponse {
|
|
724
733
|
/**
|
|
725
|
-
* <p>A list of cost anomaly subscriptions that includes the detailed metadata for each one.
|
|
734
|
+
* <p>A list of cost anomaly subscriptions that includes the detailed metadata for each one.
|
|
735
|
+
* </p>
|
|
726
736
|
*/
|
|
727
737
|
AnomalySubscriptions: AnomalySubscription[] | undefined;
|
|
728
738
|
/**
|
|
@@ -860,11 +870,13 @@ export interface ResultByTime {
|
|
|
860
870
|
}
|
|
861
871
|
export interface GetCostAndUsageResponse {
|
|
862
872
|
/**
|
|
863
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
873
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
874
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
864
875
|
*/
|
|
865
876
|
NextPageToken?: string;
|
|
866
877
|
/**
|
|
867
|
-
* <p>The groups that are specified by the <code>Filter</code> or <code>GroupBy</code>
|
|
878
|
+
* <p>The groups that are specified by the <code>Filter</code> or <code>GroupBy</code>
|
|
879
|
+
* parameters in the request.</p>
|
|
868
880
|
*/
|
|
869
881
|
GroupDefinitions?: GroupDefinition[];
|
|
870
882
|
/**
|
|
@@ -872,7 +884,8 @@ export interface GetCostAndUsageResponse {
|
|
|
872
884
|
*/
|
|
873
885
|
ResultsByTime?: ResultByTime[];
|
|
874
886
|
/**
|
|
875
|
-
* <p>The attributes that apply to a specific dimension value. For example, if the value is a
|
|
887
|
+
* <p>The attributes that apply to a specific dimension value. For example, if the value is a
|
|
888
|
+
* linked account, the attribute is that account name.</p>
|
|
876
889
|
*/
|
|
877
890
|
DimensionValueAttributes?: DimensionValuesWithAttributes[];
|
|
878
891
|
}
|
|
@@ -891,7 +904,8 @@ export declare class RequestChangedException extends __BaseException {
|
|
|
891
904
|
}
|
|
892
905
|
export interface GetCostAndUsageWithResourcesResponse {
|
|
893
906
|
/**
|
|
894
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
907
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
908
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
895
909
|
*/
|
|
896
910
|
NextPageToken?: string;
|
|
897
911
|
/**
|
|
@@ -904,7 +918,8 @@ export interface GetCostAndUsageWithResourcesResponse {
|
|
|
904
918
|
*/
|
|
905
919
|
ResultsByTime?: ResultByTime[];
|
|
906
920
|
/**
|
|
907
|
-
* <p>The attributes that apply to a specific dimension value. For example, if the value is a
|
|
921
|
+
* <p>The attributes that apply to a specific dimension value. For example, if the value is a
|
|
922
|
+
* linked account, the attribute is that account name.</p>
|
|
908
923
|
*/
|
|
909
924
|
DimensionValueAttributes?: DimensionValuesWithAttributes[];
|
|
910
925
|
}
|
|
@@ -986,8 +1001,8 @@ export interface GetCostForecastResponse {
|
|
|
986
1001
|
*/
|
|
987
1002
|
Total?: MetricValue;
|
|
988
1003
|
/**
|
|
989
|
-
* <p>The forecasts for your query, in order. For <code>DAILY</code> forecasts, this is a list
|
|
990
|
-
*
|
|
1004
|
+
* <p>The forecasts for your query, in order. For <code>DAILY</code> forecasts, this is a list
|
|
1005
|
+
* of days. For <code>MONTHLY</code> forecasts, this is a list of months.</p>
|
|
991
1006
|
*/
|
|
992
1007
|
ForecastResultsByTime?: ForecastResult[];
|
|
993
1008
|
}
|
|
@@ -998,110 +1013,131 @@ export declare enum Context {
|
|
|
998
1013
|
}
|
|
999
1014
|
export interface GetDimensionValuesResponse {
|
|
1000
1015
|
/**
|
|
1001
|
-
* <p>The filters that you used to filter your request. Some dimensions are available only
|
|
1002
|
-
*
|
|
1003
|
-
*
|
|
1004
|
-
*
|
|
1016
|
+
* <p>The filters that you used to filter your request. Some dimensions are available only
|
|
1017
|
+
* for a specific context.</p>
|
|
1018
|
+
* <p>If you set the context to <code>COST_AND_USAGE</code>, you can use the following
|
|
1019
|
+
* dimensions for searching:</p>
|
|
1020
|
+
* <ul>
|
|
1005
1021
|
* <li>
|
|
1006
1022
|
* <p>AZ - The Availability Zone. An example is <code>us-east-1a</code>.</p>
|
|
1007
1023
|
* </li>
|
|
1008
1024
|
* <li>
|
|
1009
|
-
* <p>DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are
|
|
1025
|
+
* <p>DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are
|
|
1026
|
+
* Aurora or MySQL.</p>
|
|
1010
1027
|
* </li>
|
|
1011
1028
|
* <li>
|
|
1012
|
-
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
1029
|
+
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
1030
|
+
* <code>m4.xlarge</code>.</p>
|
|
1013
1031
|
* </li>
|
|
1014
1032
|
* <li>
|
|
1015
|
-
* <p>LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon Web Services
|
|
1033
|
+
* <p>LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon Web Services
|
|
1034
|
+
* services, such as Amazon Web Services.</p>
|
|
1016
1035
|
* </li>
|
|
1017
1036
|
* <li>
|
|
1018
|
-
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
1019
|
-
*
|
|
1037
|
+
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
1038
|
+
* of the member account. The value field contains the Amazon Web Services ID of the member
|
|
1039
|
+
* account.</p>
|
|
1020
1040
|
* </li>
|
|
1021
1041
|
* <li>
|
|
1022
1042
|
* <p>OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.</p>
|
|
1023
1043
|
* </li>
|
|
1024
1044
|
* <li>
|
|
1025
|
-
* <p>OPERATION - The action performed. Examples include <code>RunInstance</code> and
|
|
1045
|
+
* <p>OPERATION - The action performed. Examples include <code>RunInstance</code> and
|
|
1046
|
+
* <code>CreateBucket</code>.</p>
|
|
1026
1047
|
* </li>
|
|
1027
1048
|
* <li>
|
|
1028
|
-
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
1049
|
+
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
1050
|
+
* Linux.</p>
|
|
1029
1051
|
* </li>
|
|
1030
1052
|
* <li>
|
|
1031
|
-
* <p>PURCHASE_TYPE - The reservation type of the purchase to which this usage is
|
|
1032
|
-
*
|
|
1053
|
+
* <p>PURCHASE_TYPE - The reservation type of the purchase to which this usage is
|
|
1054
|
+
* related. Examples include On-Demand Instances and Standard Reserved Instances.</p>
|
|
1033
1055
|
* </li>
|
|
1034
1056
|
* <li>
|
|
1035
1057
|
* <p>SERVICE - The Amazon Web Services service such as Amazon DynamoDB.</p>
|
|
1036
1058
|
* </li>
|
|
1037
1059
|
* <li>
|
|
1038
|
-
* <p>USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response
|
|
1039
|
-
*
|
|
1060
|
+
* <p>USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response
|
|
1061
|
+
* for the <code>GetDimensionValues</code> operation includes a unit attribute. Examples
|
|
1062
|
+
* include GB and Hrs.</p>
|
|
1040
1063
|
* </li>
|
|
1041
1064
|
* <li>
|
|
1042
|
-
* <p>USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2:
|
|
1043
|
-
*
|
|
1065
|
+
* <p>USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2:
|
|
1066
|
+
* CloudWatch – Alarms. The response for this operation includes a unit attribute.</p>
|
|
1044
1067
|
* </li>
|
|
1045
1068
|
* <li>
|
|
1046
|
-
* <p>RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax
|
|
1069
|
+
* <p>RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax
|
|
1070
|
+
* refunds, and credits.</p>
|
|
1047
1071
|
* </li>
|
|
1048
1072
|
* <li>
|
|
1049
|
-
* <p>RESOURCE_ID - The unique identifier of the resource. ResourceId is an opt-in
|
|
1073
|
+
* <p>RESOURCE_ID - The unique identifier of the resource. ResourceId is an opt-in
|
|
1074
|
+
* feature only available for last 14 days for EC2-Compute Service. You can opt-in by
|
|
1075
|
+
* enabling <code>Hourly</code> and <code>Resource Level Data</code> in Cost Management Console preferences.</p>
|
|
1050
1076
|
* </li>
|
|
1051
1077
|
* </ul>
|
|
1052
1078
|
* <p>If you set the context to <code>RESERVATIONS</code>, you can use the following
|
|
1053
|
-
*
|
|
1079
|
+
* dimensions for searching:</p>
|
|
1054
1080
|
* <ul>
|
|
1055
1081
|
* <li>
|
|
1056
1082
|
* <p>AZ - The Availability Zone. An example is <code>us-east-1a</code>.</p>
|
|
1057
1083
|
* </li>
|
|
1058
1084
|
* <li>
|
|
1059
|
-
* <p>CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or
|
|
1085
|
+
* <p>CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or
|
|
1086
|
+
* Linux.</p>
|
|
1060
1087
|
* </li>
|
|
1061
1088
|
* <li>
|
|
1062
|
-
* <p>DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments.
|
|
1063
|
-
* values are <code>SingleAZ</code> and <code>MultiAZ</code>.</p>
|
|
1089
|
+
* <p>DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments.
|
|
1090
|
+
* Valid values are <code>SingleAZ</code> and <code>MultiAZ</code>.</p>
|
|
1064
1091
|
* </li>
|
|
1065
1092
|
* <li>
|
|
1066
|
-
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
1093
|
+
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
1094
|
+
* <code>m4.xlarge</code>.</p>
|
|
1067
1095
|
* </li>
|
|
1068
1096
|
* <li>
|
|
1069
|
-
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
1070
|
-
*
|
|
1097
|
+
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
1098
|
+
* of the member account. The value field contains the Amazon Web Services ID of the member
|
|
1099
|
+
* account.</p>
|
|
1071
1100
|
* </li>
|
|
1072
1101
|
* <li>
|
|
1073
|
-
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
1102
|
+
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
1103
|
+
* Linux.</p>
|
|
1074
1104
|
* </li>
|
|
1075
1105
|
* <li>
|
|
1076
1106
|
* <p>REGION - The Amazon Web Services Region.</p>
|
|
1077
1107
|
* </li>
|
|
1078
1108
|
* <li>
|
|
1079
|
-
* <p>SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are
|
|
1109
|
+
* <p>SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are
|
|
1110
|
+
* regional or a single Availability Zone.</p>
|
|
1080
1111
|
* </li>
|
|
1081
1112
|
* <li>
|
|
1082
|
-
* <p>TAG (Coverage only) - The tags that are associated with a Reserved Instance
|
|
1113
|
+
* <p>TAG (Coverage only) - The tags that are associated with a Reserved Instance
|
|
1114
|
+
* (RI).</p>
|
|
1083
1115
|
* </li>
|
|
1084
1116
|
* <li>
|
|
1085
1117
|
* <p>TENANCY - The tenancy of a resource. Examples are shared or dedicated.</p>
|
|
1086
1118
|
* </li>
|
|
1087
1119
|
* </ul>
|
|
1088
|
-
* <p>If you set the context to <code>SAVINGS_PLANS</code>, you can use the following
|
|
1120
|
+
* <p>If you set the context to <code>SAVINGS_PLANS</code>, you can use the following
|
|
1121
|
+
* dimensions for searching:</p>
|
|
1089
1122
|
* <ul>
|
|
1090
1123
|
* <li>
|
|
1091
1124
|
* <p>SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute)</p>
|
|
1092
1125
|
* </li>
|
|
1093
1126
|
* <li>
|
|
1094
|
-
* <p>PAYMENT_OPTION - Payment option for the given Savings Plans (for example, All
|
|
1127
|
+
* <p>PAYMENT_OPTION - Payment option for the given Savings Plans (for example, All
|
|
1128
|
+
* Upfront)</p>
|
|
1095
1129
|
* </li>
|
|
1096
1130
|
* <li>
|
|
1097
1131
|
* <p>REGION - The Amazon Web Services Region.</p>
|
|
1098
1132
|
* </li>
|
|
1099
1133
|
* <li>
|
|
1100
|
-
* <p>INSTANCE_TYPE_FAMILY - The family of instances (For example,
|
|
1134
|
+
* <p>INSTANCE_TYPE_FAMILY - The family of instances (For example,
|
|
1135
|
+
* <code>m5</code>)</p>
|
|
1101
1136
|
* </li>
|
|
1102
1137
|
* <li>
|
|
1103
|
-
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
1104
|
-
*
|
|
1138
|
+
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
1139
|
+
* of the member account. The value field contains the Amazon Web Services ID of the member
|
|
1140
|
+
* account.</p>
|
|
1105
1141
|
* </li>
|
|
1106
1142
|
* <li>
|
|
1107
1143
|
* <p>SAVINGS_PLAN_ARN - The unique identifier for your Savings Plan</p>
|
|
@@ -1118,7 +1154,8 @@ export interface GetDimensionValuesResponse {
|
|
|
1118
1154
|
*/
|
|
1119
1155
|
TotalSize: number | undefined;
|
|
1120
1156
|
/**
|
|
1121
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
1157
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
1158
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
1122
1159
|
*/
|
|
1123
1160
|
NextPageToken?: string;
|
|
1124
1161
|
}
|
|
@@ -1160,7 +1197,7 @@ export interface CoverageHours {
|
|
|
1160
1197
|
* the xlarge instance, even though both instances show only one instance-hour. When you
|
|
1161
1198
|
* use normalized units instead of instance-hours, the xlarge instance used 8 normalized
|
|
1162
1199
|
* units, and the 2xlarge instance used 16 normalized units.</p>
|
|
1163
|
-
*
|
|
1200
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-modifying.html">Modifying Reserved Instances</a>
|
|
1164
1201
|
* in the <i>Amazon Elastic Compute Cloud User Guide for Linux
|
|
1165
1202
|
* Instances</i>.</p>
|
|
1166
1203
|
*/
|
|
@@ -1241,7 +1278,8 @@ export interface GetReservationCoverageResponse {
|
|
|
1241
1278
|
*/
|
|
1242
1279
|
Total?: Coverage;
|
|
1243
1280
|
/**
|
|
1244
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
1281
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
1282
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
1245
1283
|
*/
|
|
1246
1284
|
NextPageToken?: string;
|
|
1247
1285
|
}
|
|
@@ -1370,8 +1408,8 @@ export interface ElastiCacheInstanceDetails {
|
|
|
1370
1408
|
SizeFlexEligible?: boolean;
|
|
1371
1409
|
}
|
|
1372
1410
|
/**
|
|
1373
|
-
* <p>Details about the Amazon OpenSearch Service instances that Amazon Web Services recommends
|
|
1374
|
-
* purchase.</p>
|
|
1411
|
+
* <p>Details about the Amazon OpenSearch Service instances that Amazon Web Services recommends
|
|
1412
|
+
* that you purchase.</p>
|
|
1375
1413
|
*/
|
|
1376
1414
|
export interface ESInstanceDetails {
|
|
1377
1415
|
/**
|
|
@@ -1487,7 +1525,8 @@ export interface InstanceDetails {
|
|
|
1487
1525
|
*/
|
|
1488
1526
|
ElastiCacheInstanceDetails?: ElastiCacheInstanceDetails;
|
|
1489
1527
|
/**
|
|
1490
|
-
* <p>The Amazon OpenSearch Service instances that Amazon Web Services recommends that you
|
|
1528
|
+
* <p>The Amazon OpenSearch Service instances that Amazon Web Services recommends that you
|
|
1529
|
+
* purchase.</p>
|
|
1491
1530
|
*/
|
|
1492
1531
|
ESInstanceDetails?: ESInstanceDetails;
|
|
1493
1532
|
}
|
|
@@ -1653,7 +1692,8 @@ export interface ReservationPurchaseRecommendation {
|
|
|
1653
1692
|
}
|
|
1654
1693
|
export interface GetReservationPurchaseRecommendationResponse {
|
|
1655
1694
|
/**
|
|
1656
|
-
* <p>Information about this specific recommendation call, such as the time stamp for when
|
|
1695
|
+
* <p>Information about this specific recommendation call, such as the time stamp for when
|
|
1696
|
+
* Cost Explorer generated this recommendation.</p>
|
|
1657
1697
|
*/
|
|
1658
1698
|
Metadata?: ReservationPurchaseRecommendationMetadata;
|
|
1659
1699
|
/**
|
|
@@ -1798,7 +1838,8 @@ export interface GetReservationUtilizationResponse {
|
|
|
1798
1838
|
*/
|
|
1799
1839
|
Total?: ReservationAggregates;
|
|
1800
1840
|
/**
|
|
1801
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
1841
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
1842
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
1802
1843
|
*/
|
|
1803
1844
|
NextPageToken?: string;
|
|
1804
1845
|
}
|
|
@@ -1955,7 +1996,8 @@ export interface NetworkResourceUtilization {
|
|
|
1955
1996
|
*/
|
|
1956
1997
|
NetworkInBytesPerSecond?: string;
|
|
1957
1998
|
/**
|
|
1958
|
-
* <p>The network outbound throughput utilization measured in Bytes per second (Bps).
|
|
1999
|
+
* <p>The network outbound throughput utilization measured in Bytes per second (Bps).
|
|
2000
|
+
* </p>
|
|
1959
2001
|
*/
|
|
1960
2002
|
NetworkOutBytesPerSecond?: string;
|
|
1961
2003
|
/**
|
|
@@ -2277,7 +2319,8 @@ export interface GetSavingsPlansCoverageResponse {
|
|
|
2277
2319
|
*/
|
|
2278
2320
|
SavingsPlansCoverages: SavingsPlansCoverage[] | undefined;
|
|
2279
2321
|
/**
|
|
2280
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
2322
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
2323
|
+
* the response from a previous call has more results than the maximum page size.</p>
|
|
2281
2324
|
*/
|
|
2282
2325
|
NextToken?: string;
|
|
2283
2326
|
}
|
|
@@ -2508,11 +2551,13 @@ export interface GetSavingsPlansPurchaseRecommendationResponse {
|
|
|
2508
2551
|
*/
|
|
2509
2552
|
Metadata?: SavingsPlansPurchaseRecommendationMetadata;
|
|
2510
2553
|
/**
|
|
2511
|
-
* <p>Contains your request parameters, Savings Plan Recommendations Summary, and
|
|
2554
|
+
* <p>Contains your request parameters, Savings Plan Recommendations Summary, and
|
|
2555
|
+
* Details.</p>
|
|
2512
2556
|
*/
|
|
2513
2557
|
SavingsPlansPurchaseRecommendation?: SavingsPlansPurchaseRecommendation;
|
|
2514
2558
|
/**
|
|
2515
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
2559
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
2560
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
2516
2561
|
*/
|
|
2517
2562
|
NextPageToken?: string;
|
|
2518
2563
|
}
|
|
@@ -2675,7 +2720,8 @@ export interface SavingsPlansUtilizationDetail {
|
|
|
2675
2720
|
}
|
|
2676
2721
|
export interface GetSavingsPlansUtilizationDetailsResponse {
|
|
2677
2722
|
/**
|
|
2678
|
-
* <p>Retrieves a single daily or monthly Savings Plans utilization rate and details for your
|
|
2723
|
+
* <p>Retrieves a single daily or monthly Savings Plans utilization rate and details for your
|
|
2724
|
+
* account.</p>
|
|
2679
2725
|
*/
|
|
2680
2726
|
SavingsPlansUtilizationDetails: SavingsPlansUtilizationDetail[] | undefined;
|
|
2681
2727
|
/**
|
|
@@ -2687,13 +2733,15 @@ export interface GetSavingsPlansUtilizationDetailsResponse {
|
|
|
2687
2733
|
*/
|
|
2688
2734
|
TimePeriod: DateInterval | undefined;
|
|
2689
2735
|
/**
|
|
2690
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
2736
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
2737
|
+
* the response from a previous call has more results than the maximum page size.</p>
|
|
2691
2738
|
*/
|
|
2692
2739
|
NextToken?: string;
|
|
2693
2740
|
}
|
|
2694
2741
|
export interface GetTagsResponse {
|
|
2695
2742
|
/**
|
|
2696
|
-
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
2743
|
+
* <p>The token for the next set of retrievable results. Amazon Web Services provides the token
|
|
2744
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
2697
2745
|
*/
|
|
2698
2746
|
NextPageToken?: string;
|
|
2699
2747
|
/**
|
|
@@ -2715,13 +2763,15 @@ export interface GetUsageForecastResponse {
|
|
|
2715
2763
|
*/
|
|
2716
2764
|
Total?: MetricValue;
|
|
2717
2765
|
/**
|
|
2718
|
-
* <p>The forecasts for your query, in order. For <code>DAILY</code> forecasts, this is a
|
|
2719
|
-
*
|
|
2766
|
+
* <p>The forecasts for your query, in order. For <code>DAILY</code> forecasts, this is a
|
|
2767
|
+
* list of days. For <code>MONTHLY</code> forecasts, this is a list of months.</p>
|
|
2720
2768
|
*/
|
|
2721
2769
|
ForecastResultsByTime?: ForecastResult[];
|
|
2722
2770
|
}
|
|
2723
2771
|
/**
|
|
2724
|
-
* <p>Cost Explorer was unable to identify the usage unit. Provide
|
|
2772
|
+
* <p>Cost Explorer was unable to identify the usage unit. Provide
|
|
2773
|
+
* <code>UsageType/UsageTypeGroup</code> filter selections that contain matching units,
|
|
2774
|
+
* for example: <code>hours</code>.</p>
|
|
2725
2775
|
*/
|
|
2726
2776
|
export declare class UnresolvableUsageUnitException extends __BaseException {
|
|
2727
2777
|
readonly name: "UnresolvableUsageUnitException";
|
|
@@ -2753,7 +2803,8 @@ export interface ListCostAllocationTagsRequest {
|
|
|
2753
2803
|
* <p>The type of <code>CostAllocationTag</code> object that are returned for this request. The
|
|
2754
2804
|
* <code>AWSGenerated</code> type tags are tags that Amazon Web Services defines and applies to
|
|
2755
2805
|
* support Amazon Web Services resources for cost allocation purposes. The
|
|
2756
|
-
* <code>UserDefined</code> type tags are tags that you define, create, and apply to resources.
|
|
2806
|
+
* <code>UserDefined</code> type tags are tags that you define, create, and apply to resources.
|
|
2807
|
+
* </p>
|
|
2757
2808
|
*/
|
|
2758
2809
|
Type?: CostAllocationTagType | string;
|
|
2759
2810
|
/**
|
|
@@ -2818,7 +2869,7 @@ export interface ListCostCategoryDefinitionsRequest {
|
|
|
2818
2869
|
/**
|
|
2819
2870
|
* <p>A reference to a Cost Category containing only enough information to identify the Cost
|
|
2820
2871
|
* Category.</p>
|
|
2821
|
-
*
|
|
2872
|
+
* <p>You can use this information to retrieve the full Cost Category information using
|
|
2822
2873
|
* <code>DescribeCostCategory</code>.</p>
|
|
2823
2874
|
*/
|
|
2824
2875
|
export interface CostCategoryReference {
|
|
@@ -2869,16 +2920,76 @@ export interface ListCostCategoryDefinitionsResponse {
|
|
|
2869
2920
|
*/
|
|
2870
2921
|
NextToken?: string;
|
|
2871
2922
|
}
|
|
2923
|
+
export declare enum GenerationStatus {
|
|
2924
|
+
FAILED = "FAILED",
|
|
2925
|
+
PROCESSING = "PROCESSING",
|
|
2926
|
+
SUCCEEDED = "SUCCEEDED"
|
|
2927
|
+
}
|
|
2928
|
+
export interface ListSavingsPlansPurchaseRecommendationGenerationRequest {
|
|
2929
|
+
/**
|
|
2930
|
+
* <p>The status of the recommendation generation.</p>
|
|
2931
|
+
*/
|
|
2932
|
+
GenerationStatus?: GenerationStatus | string;
|
|
2933
|
+
/**
|
|
2934
|
+
* <p>The IDs for each specific recommendation.</p>
|
|
2935
|
+
*/
|
|
2936
|
+
RecommendationIds?: string[];
|
|
2937
|
+
/**
|
|
2938
|
+
* <p>The number of recommendations that you want returned in a single response object.</p>
|
|
2939
|
+
*/
|
|
2940
|
+
PageSize?: number;
|
|
2941
|
+
/**
|
|
2942
|
+
* <p>The token to retrieve the next set of results.</p>
|
|
2943
|
+
*/
|
|
2944
|
+
NextPageToken?: string;
|
|
2945
|
+
}
|
|
2946
|
+
/**
|
|
2947
|
+
* <p>The summary of the Savings Plans recommendation generation.</p>
|
|
2948
|
+
*/
|
|
2949
|
+
export interface GenerationSummary {
|
|
2950
|
+
/**
|
|
2951
|
+
* <p>Indicates the ID for this specific recommendation.</p>
|
|
2952
|
+
*/
|
|
2953
|
+
RecommendationId?: string;
|
|
2954
|
+
/**
|
|
2955
|
+
* <p>Indicates whether the recommendation generation succeeded, is processing, or
|
|
2956
|
+
* failed.</p>
|
|
2957
|
+
*/
|
|
2958
|
+
GenerationStatus?: GenerationStatus | string;
|
|
2959
|
+
/**
|
|
2960
|
+
* <p>Indicates the start time of the recommendation generation.</p>
|
|
2961
|
+
*/
|
|
2962
|
+
GenerationStartedTime?: string;
|
|
2963
|
+
/**
|
|
2964
|
+
* <p>Indicates the completion time of the recommendation generation.</p>
|
|
2965
|
+
*/
|
|
2966
|
+
GenerationCompletionTime?: string;
|
|
2967
|
+
/**
|
|
2968
|
+
* <p>Indicates the estimated time for when the recommendation generation will
|
|
2969
|
+
* complete.</p>
|
|
2970
|
+
*/
|
|
2971
|
+
EstimatedCompletionTime?: string;
|
|
2972
|
+
}
|
|
2973
|
+
export interface ListSavingsPlansPurchaseRecommendationGenerationResponse {
|
|
2974
|
+
/**
|
|
2975
|
+
* <p>The list of historical recommendation generations.</p>
|
|
2976
|
+
*/
|
|
2977
|
+
GenerationSummaryList?: GenerationSummary[];
|
|
2978
|
+
/**
|
|
2979
|
+
* <p>The token to retrieve the next set of results.</p>
|
|
2980
|
+
*/
|
|
2981
|
+
NextPageToken?: string;
|
|
2982
|
+
}
|
|
2872
2983
|
export interface ListTagsForResourceRequest {
|
|
2873
2984
|
/**
|
|
2874
|
-
* <p>The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see
|
|
2985
|
+
* <p>The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see
|
|
2986
|
+
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html">ResourceTag</a>.</p>
|
|
2875
2987
|
*/
|
|
2876
2988
|
ResourceArn: string | undefined;
|
|
2877
2989
|
}
|
|
2878
2990
|
export interface ListTagsForResourceResponse {
|
|
2879
2991
|
/**
|
|
2880
|
-
* <p>A list of tag key value pairs that are associated with the resource.
|
|
2881
|
-
* </p>
|
|
2992
|
+
* <p>A list of tag key value pairs that are associated with the resource. </p>
|
|
2882
2993
|
*/
|
|
2883
2994
|
ResourceTags?: ResourceTag[];
|
|
2884
2995
|
}
|
|
@@ -2888,7 +2999,8 @@ export interface ProvideAnomalyFeedbackRequest {
|
|
|
2888
2999
|
*/
|
|
2889
3000
|
AnomalyId: string | undefined;
|
|
2890
3001
|
/**
|
|
2891
|
-
* <p>Describes whether the cost anomaly was a planned activity or you considered it an anomaly.
|
|
3002
|
+
* <p>Describes whether the cost anomaly was a planned activity or you considered it an anomaly.
|
|
3003
|
+
* </p>
|
|
2892
3004
|
*/
|
|
2893
3005
|
Feedback: AnomalyFeedbackType | string | undefined;
|
|
2894
3006
|
}
|
|
@@ -2898,19 +3010,49 @@ export interface ProvideAnomalyFeedbackResponse {
|
|
|
2898
3010
|
*/
|
|
2899
3011
|
AnomalyId: string | undefined;
|
|
2900
3012
|
}
|
|
3013
|
+
/**
|
|
3014
|
+
* <p>A request to generate a recommendation is already in progress.</p>
|
|
3015
|
+
*/
|
|
3016
|
+
export declare class GenerationExistsException extends __BaseException {
|
|
3017
|
+
readonly name: "GenerationExistsException";
|
|
3018
|
+
readonly $fault: "client";
|
|
3019
|
+
Message?: string;
|
|
3020
|
+
/**
|
|
3021
|
+
* @internal
|
|
3022
|
+
*/
|
|
3023
|
+
constructor(opts: __ExceptionOptionType<GenerationExistsException, __BaseException>);
|
|
3024
|
+
}
|
|
3025
|
+
export interface StartSavingsPlansPurchaseRecommendationGenerationRequest {
|
|
3026
|
+
}
|
|
3027
|
+
export interface StartSavingsPlansPurchaseRecommendationGenerationResponse {
|
|
3028
|
+
/**
|
|
3029
|
+
* <p>The ID for this specific recommendation.</p>
|
|
3030
|
+
*/
|
|
3031
|
+
RecommendationId?: string;
|
|
3032
|
+
/**
|
|
3033
|
+
* <p>The start time of the recommendation generation.</p>
|
|
3034
|
+
*/
|
|
3035
|
+
GenerationStartedTime?: string;
|
|
3036
|
+
/**
|
|
3037
|
+
* <p>The estimated time for when the recommendation generation will complete.</p>
|
|
3038
|
+
*/
|
|
3039
|
+
EstimatedCompletionTime?: string;
|
|
3040
|
+
}
|
|
2901
3041
|
export interface TagResourceRequest {
|
|
2902
3042
|
/**
|
|
2903
|
-
* <p>The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see
|
|
3043
|
+
* <p>The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see
|
|
3044
|
+
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html">ResourceTag</a>.
|
|
2904
3045
|
* </p>
|
|
2905
3046
|
*/
|
|
2906
3047
|
ResourceArn: string | undefined;
|
|
2907
3048
|
/**
|
|
2908
|
-
* <p>
|
|
2909
|
-
*
|
|
2910
|
-
*
|
|
3049
|
+
* <p> A list of tag key-value pairs to be added to the resource.</p>
|
|
3050
|
+
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
3051
|
+
* following restrictions apply to resource tags:</p>
|
|
2911
3052
|
* <ul>
|
|
2912
3053
|
* <li>
|
|
2913
|
-
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
3054
|
+
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
3055
|
+
* user-tags to one resource. The remaining are reserved for Amazon Web Services use</p>
|
|
2914
3056
|
* </li>
|
|
2915
3057
|
* <li>
|
|
2916
3058
|
* <p>The maximum length of a key is 128 characters</p>
|
|
@@ -2919,7 +3061,8 @@ export interface TagResourceRequest {
|
|
|
2919
3061
|
* <p>The maximum length of a value is 256 characters</p>
|
|
2920
3062
|
* </li>
|
|
2921
3063
|
* <li>
|
|
2922
|
-
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
3064
|
+
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
3065
|
+
* following: <code>_.:/=+@-</code>
|
|
2923
3066
|
* </p>
|
|
2924
3067
|
* </li>
|
|
2925
3068
|
* <li>
|
|
@@ -2929,7 +3072,8 @@ export interface TagResourceRequest {
|
|
|
2929
3072
|
* <p>Keys and values are trimmed for any leading or trailing whitespaces</p>
|
|
2930
3073
|
* </li>
|
|
2931
3074
|
* <li>
|
|
2932
|
-
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
3075
|
+
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
3076
|
+
* Amazon Web Services use</p>
|
|
2933
3077
|
* </li>
|
|
2934
3078
|
* </ul>
|
|
2935
3079
|
*/
|
|
@@ -2938,7 +3082,8 @@ export interface TagResourceRequest {
|
|
|
2938
3082
|
export interface TagResourceResponse {
|
|
2939
3083
|
}
|
|
2940
3084
|
/**
|
|
2941
|
-
* <p>Can occur if you specify a number of tags for a resource greater than the maximum 50
|
|
3085
|
+
* <p>Can occur if you specify a number of tags for a resource greater than the maximum 50
|
|
3086
|
+
* user tags per resource.</p>
|
|
2942
3087
|
*/
|
|
2943
3088
|
export declare class TooManyTagsException extends __BaseException {
|
|
2944
3089
|
readonly name: "TooManyTagsException";
|
|
@@ -2953,13 +3098,15 @@ export declare class TooManyTagsException extends __BaseException {
|
|
|
2953
3098
|
export interface UntagResourceRequest {
|
|
2954
3099
|
/**
|
|
2955
3100
|
* <p>The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see
|
|
2956
|
-
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html">ResourceTag</a>.
|
|
3101
|
+
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html">ResourceTag</a>.
|
|
3102
|
+
* </p>
|
|
2957
3103
|
*/
|
|
2958
3104
|
ResourceArn: string | undefined;
|
|
2959
3105
|
/**
|
|
2960
3106
|
* <p>A list of tag keys associated with tags that need to be removed from the resource. If you
|
|
2961
3107
|
* specify a tag key that doesn't exist, it's ignored. Although the maximum number of array
|
|
2962
|
-
* members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.
|
|
3108
|
+
* members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.
|
|
3109
|
+
* </p>
|
|
2963
3110
|
*/
|
|
2964
3111
|
ResourceTagKeys: string[] | undefined;
|
|
2965
3112
|
}
|
|
@@ -3014,7 +3161,8 @@ export interface UpdateAnomalySubscriptionResponse {
|
|
|
3014
3161
|
SubscriptionArn: string | undefined;
|
|
3015
3162
|
}
|
|
3016
3163
|
/**
|
|
3017
|
-
* <p>The cost allocation tag status. The status of a key can either be active or inactive.
|
|
3164
|
+
* <p>The cost allocation tag status. The status of a key can either be active or inactive.
|
|
3165
|
+
* </p>
|
|
3018
3166
|
*/
|
|
3019
3167
|
export interface CostAllocationTagStatusEntry {
|
|
3020
3168
|
/**
|
|
@@ -3071,25 +3219,25 @@ export interface UpdateCostCategoryDefinitionResponse {
|
|
|
3071
3219
|
}
|
|
3072
3220
|
/**
|
|
3073
3221
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
3074
|
-
*
|
|
3222
|
+
* <ul>
|
|
3075
3223
|
* <li>
|
|
3076
|
-
*
|
|
3224
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
3077
3225
|
* filters that you plan to use. For example, you can filter for
|
|
3078
3226
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
3079
3227
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
3080
3228
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
3081
3229
|
* example is as follows:</p>
|
|
3082
|
-
*
|
|
3083
|
-
*
|
|
3230
|
+
* <p>
|
|
3231
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
3084
3232
|
* } }</code>
|
|
3085
|
-
*
|
|
3086
|
-
*
|
|
3233
|
+
* </p>
|
|
3234
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
3087
3235
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
3088
3236
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
3089
3237
|
* lines. </p>
|
|
3090
3238
|
* </li>
|
|
3091
3239
|
* <li>
|
|
3092
|
-
*
|
|
3240
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
3093
3241
|
* <code>Expression</code> types and the logical operators
|
|
3094
3242
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
3095
3243
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -3097,25 +3245,25 @@ export interface UpdateCostCategoryDefinitionResponse {
|
|
|
3097
3245
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
3098
3246
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
3099
3247
|
* follows:</p>
|
|
3100
|
-
*
|
|
3101
|
-
*
|
|
3248
|
+
* <p>
|
|
3249
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
3102
3250
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
3103
3251
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
3104
3252
|
* ["DataTransfer"] }}} ] } </code>
|
|
3105
|
-
*
|
|
3106
|
-
*
|
|
3107
|
-
*
|
|
3253
|
+
* </p>
|
|
3254
|
+
* <note>
|
|
3255
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
3108
3256
|
* service returns an error if more than one is specified. The following
|
|
3109
3257
|
* example shows an <code>Expression</code> object that creates an
|
|
3110
3258
|
* error.</p>
|
|
3111
|
-
*
|
|
3112
|
-
*
|
|
3113
|
-
*
|
|
3259
|
+
* </note>
|
|
3260
|
+
* <p>
|
|
3261
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
3114
3262
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
3115
|
-
*
|
|
3263
|
+
* </p>
|
|
3116
3264
|
* </li>
|
|
3117
3265
|
* </ul>
|
|
3118
|
-
*
|
|
3266
|
+
* <note>
|
|
3119
3267
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
3120
3268
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
3121
3269
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -3124,7 +3272,7 @@ export interface UpdateCostCategoryDefinitionResponse {
|
|
|
3124
3272
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
3125
3273
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
3126
3274
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
3127
|
-
*
|
|
3275
|
+
* </note>
|
|
3128
3276
|
*/
|
|
3129
3277
|
export interface Expression {
|
|
3130
3278
|
/**
|
|
@@ -3188,25 +3336,25 @@ export interface AnomalyMonitor {
|
|
|
3188
3336
|
MonitorDimension?: MonitorDimension | string;
|
|
3189
3337
|
/**
|
|
3190
3338
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
3191
|
-
*
|
|
3339
|
+
* <ul>
|
|
3192
3340
|
* <li>
|
|
3193
|
-
*
|
|
3341
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
3194
3342
|
* filters that you plan to use. For example, you can filter for
|
|
3195
3343
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
3196
3344
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
3197
3345
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
3198
3346
|
* example is as follows:</p>
|
|
3199
|
-
*
|
|
3200
|
-
*
|
|
3347
|
+
* <p>
|
|
3348
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
3201
3349
|
* } }</code>
|
|
3202
|
-
*
|
|
3203
|
-
*
|
|
3350
|
+
* </p>
|
|
3351
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
3204
3352
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
3205
3353
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
3206
3354
|
* lines. </p>
|
|
3207
3355
|
* </li>
|
|
3208
3356
|
* <li>
|
|
3209
|
-
*
|
|
3357
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
3210
3358
|
* <code>Expression</code> types and the logical operators
|
|
3211
3359
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
3212
3360
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -3214,25 +3362,25 @@ export interface AnomalyMonitor {
|
|
|
3214
3362
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
3215
3363
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
3216
3364
|
* follows:</p>
|
|
3217
|
-
*
|
|
3218
|
-
*
|
|
3365
|
+
* <p>
|
|
3366
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
3219
3367
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
3220
3368
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
3221
3369
|
* ["DataTransfer"] }}} ] } </code>
|
|
3222
|
-
*
|
|
3223
|
-
*
|
|
3224
|
-
*
|
|
3370
|
+
* </p>
|
|
3371
|
+
* <note>
|
|
3372
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
3225
3373
|
* service returns an error if more than one is specified. The following
|
|
3226
3374
|
* example shows an <code>Expression</code> object that creates an
|
|
3227
3375
|
* error.</p>
|
|
3228
|
-
*
|
|
3229
|
-
*
|
|
3230
|
-
*
|
|
3376
|
+
* </note>
|
|
3377
|
+
* <p>
|
|
3378
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
3231
3379
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
3232
|
-
*
|
|
3380
|
+
* </p>
|
|
3233
3381
|
* </li>
|
|
3234
3382
|
* </ul>
|
|
3235
|
-
*
|
|
3383
|
+
* <note>
|
|
3236
3384
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
3237
3385
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
3238
3386
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -3241,7 +3389,7 @@ export interface AnomalyMonitor {
|
|
|
3241
3389
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
3242
3390
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
3243
3391
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
3244
|
-
*
|
|
3392
|
+
* </note>
|
|
3245
3393
|
*/
|
|
3246
3394
|
MonitorSpecification?: Expression;
|
|
3247
3395
|
/**
|
|
@@ -3265,9 +3413,9 @@ export interface CostCategoryRule {
|
|
|
3265
3413
|
* Currently the only dimensions supported are <code>LINKED_ACCOUNT</code>,
|
|
3266
3414
|
* <code>SERVICE_CODE</code>, <code>RECORD_TYPE</code>, and
|
|
3267
3415
|
* <code>LINKED_ACCOUNT_NAME</code>.</p>
|
|
3268
|
-
*
|
|
3416
|
+
* <p>Root level <code>OR</code> isn't supported. We recommend that you create a separate
|
|
3269
3417
|
* rule instead.</p>
|
|
3270
|
-
*
|
|
3418
|
+
* <p>
|
|
3271
3419
|
* <code>RECORD_TYPE</code> is a dimension used for Cost Explorer APIs, and is also
|
|
3272
3420
|
* supported for Cost Category expressions. This dimension uses different terms, depending
|
|
3273
3421
|
* on whether you're using the console or API/JSON editor. For a detailed comparison, see
|
|
@@ -3294,91 +3442,112 @@ export interface CostCategoryRule {
|
|
|
3294
3442
|
}
|
|
3295
3443
|
export interface GetCostAndUsageRequest {
|
|
3296
3444
|
/**
|
|
3297
|
-
* <p>Sets the start date and end date for retrieving Amazon Web Services costs. The start
|
|
3298
|
-
* is inclusive, but the end date is exclusive. For example, if <code>start</code> is
|
|
3445
|
+
* <p>Sets the start date and end date for retrieving Amazon Web Services costs. The start
|
|
3446
|
+
* date is inclusive, but the end date is exclusive. For example, if <code>start</code> is
|
|
3299
3447
|
* <code>2017-01-01</code> and <code>end</code> is <code>2017-05-01</code>, then the cost and
|
|
3300
3448
|
* usage data is retrieved from <code>2017-01-01</code> up to and including
|
|
3301
3449
|
* <code>2017-04-30</code> but not including <code>2017-05-01</code>.</p>
|
|
3302
3450
|
*/
|
|
3303
3451
|
TimePeriod: DateInterval | undefined;
|
|
3304
3452
|
/**
|
|
3305
|
-
* <p>Sets the Amazon Web Services cost granularity to <code>MONTHLY</code> or
|
|
3306
|
-
*
|
|
3453
|
+
* <p>Sets the Amazon Web Services cost granularity to <code>MONTHLY</code> or
|
|
3454
|
+
* <code>DAILY</code>, or <code>HOURLY</code>. If <code>Granularity</code> isn't set, the
|
|
3455
|
+
* response object doesn't include the <code>Granularity</code>, either <code>MONTHLY</code> or
|
|
3456
|
+
* <code>DAILY</code>, or <code>HOURLY</code>. </p>
|
|
3307
3457
|
*/
|
|
3308
3458
|
Granularity: Granularity | string | undefined;
|
|
3309
3459
|
/**
|
|
3310
|
-
* <p>Filters Amazon Web Services costs by different dimensions. For example, you can specify
|
|
3311
|
-
*
|
|
3312
|
-
*
|
|
3313
|
-
*
|
|
3314
|
-
*
|
|
3315
|
-
*
|
|
3460
|
+
* <p>Filters Amazon Web Services costs by different dimensions. For example, you can specify
|
|
3461
|
+
* <code>SERVICE</code> and <code>LINKED_ACCOUNT</code> and get the costs that are associated
|
|
3462
|
+
* with that account's usage of that service. You can nest <code>Expression</code> objects to
|
|
3463
|
+
* define any combination of dimension filters. For more information, see <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a>. </p>
|
|
3464
|
+
* <p>Valid values for <code>MatchOptions</code> for <code>Dimensions</code> are
|
|
3465
|
+
* <code>EQUALS</code> and <code>CASE_SENSITIVE</code>.</p>
|
|
3466
|
+
* <p>Valid values for <code>MatchOptions</code> for <code>CostCategories</code> and
|
|
3467
|
+
* <code>Tags</code> are <code>EQUALS</code>, <code>ABSENT</code>, and
|
|
3468
|
+
* <code>CASE_SENSITIVE</code>. Default values are <code>EQUALS</code> and
|
|
3469
|
+
* <code>CASE_SENSITIVE</code>.</p>
|
|
3316
3470
|
*/
|
|
3317
3471
|
Filter?: Expression;
|
|
3318
3472
|
/**
|
|
3319
|
-
* <p>Which metrics are returned in the query. For more information about blended and
|
|
3320
|
-
*
|
|
3321
|
-
*
|
|
3322
|
-
*
|
|
3323
|
-
*
|
|
3324
|
-
*
|
|
3325
|
-
*
|
|
3473
|
+
* <p>Which metrics are returned in the query. For more information about blended and
|
|
3474
|
+
* unblended rates, see <a href="http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/">Why does the "blended" annotation
|
|
3475
|
+
* appear on some line items in my bill?</a>. </p>
|
|
3476
|
+
* <p>Valid values are <code>AmortizedCost</code>, <code>BlendedCost</code>,
|
|
3477
|
+
* <code>NetAmortizedCost</code>, <code>NetUnblendedCost</code>,
|
|
3478
|
+
* <code>NormalizedUsageAmount</code>, <code>UnblendedCost</code>, and
|
|
3479
|
+
* <code>UsageQuantity</code>. </p>
|
|
3480
|
+
* <note>
|
|
3481
|
+
* <p>If you return the <code>UsageQuantity</code> metric, the service aggregates all usage
|
|
3326
3482
|
* numbers without taking into account the units. For example, if you aggregate
|
|
3327
3483
|
* <code>usageQuantity</code> across all of Amazon EC2, the results aren't meaningful because
|
|
3328
3484
|
* Amazon EC2 compute hours and data transfer are measured in different units (for example,
|
|
3329
3485
|
* hours and GB). To get more meaningful <code>UsageQuantity</code> metrics, filter by
|
|
3330
3486
|
* <code>UsageType</code> or <code>UsageTypeGroups</code>. </p>
|
|
3331
|
-
*
|
|
3332
|
-
*
|
|
3487
|
+
* </note>
|
|
3488
|
+
* <p>
|
|
3333
3489
|
* <code>Metrics</code> is required for <code>GetCostAndUsage</code> requests.</p>
|
|
3334
3490
|
*/
|
|
3335
3491
|
Metrics: string[] | undefined;
|
|
3336
3492
|
/**
|
|
3337
|
-
* <p>You can group Amazon Web Services costs using up to two different groups, either
|
|
3338
|
-
* cost categories, or any two group by types.</p>
|
|
3339
|
-
*
|
|
3340
|
-
*
|
|
3341
|
-
*
|
|
3342
|
-
*
|
|
3493
|
+
* <p>You can group Amazon Web Services costs using up to two different groups, either
|
|
3494
|
+
* dimensions, tag keys, cost categories, or any two group by types.</p>
|
|
3495
|
+
* <p>Valid values for the <code>DIMENSION</code> type are <code>AZ</code>,
|
|
3496
|
+
* <code>INSTANCE_TYPE</code>, <code>LEGAL_ENTITY_NAME</code>, <code>INVOICING_ENTITY</code>,
|
|
3497
|
+
* <code>LINKED_ACCOUNT</code>, <code>OPERATION</code>, <code>PLATFORM</code>,
|
|
3498
|
+
* <code>PURCHASE_TYPE</code>, <code>SERVICE</code>, <code>TENANCY</code>,
|
|
3499
|
+
* <code>RECORD_TYPE</code>, and <code>USAGE_TYPE</code>.</p>
|
|
3500
|
+
* <p>When you group by the <code>TAG</code> type and include a valid tag key, you get all
|
|
3501
|
+
* tag values, including empty strings.</p>
|
|
3343
3502
|
*/
|
|
3344
3503
|
GroupBy?: GroupDefinition[];
|
|
3345
3504
|
/**
|
|
3346
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
3505
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
3506
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
3347
3507
|
*/
|
|
3348
3508
|
NextPageToken?: string;
|
|
3349
3509
|
}
|
|
3350
3510
|
export interface GetCostAndUsageWithResourcesRequest {
|
|
3351
3511
|
/**
|
|
3352
|
-
* <p>Sets the start and end dates for retrieving Amazon Web Services costs. The range must
|
|
3353
|
-
*
|
|
3512
|
+
* <p>Sets the start and end dates for retrieving Amazon Web Services costs. The range must
|
|
3513
|
+
* be within the last 14 days (the start date cannot be earlier than 14 days ago). The start date
|
|
3514
|
+
* is inclusive, but the end date is exclusive. For example, if <code>start</code> is
|
|
3515
|
+
* <code>2017-01-01</code> and <code>end</code> is <code>2017-05-01</code>, then the cost and
|
|
3516
|
+
* usage data is retrieved from <code>2017-01-01</code> up to and including
|
|
3517
|
+
* <code>2017-04-30</code> but not including <code>2017-05-01</code>.</p>
|
|
3354
3518
|
*/
|
|
3355
3519
|
TimePeriod: DateInterval | undefined;
|
|
3356
3520
|
/**
|
|
3357
|
-
* <p>Sets the Amazon Web Services cost granularity to <code>MONTHLY</code>,
|
|
3358
|
-
*
|
|
3359
|
-
*
|
|
3521
|
+
* <p>Sets the Amazon Web Services cost granularity to <code>MONTHLY</code>,
|
|
3522
|
+
* <code>DAILY</code>, or <code>HOURLY</code>. If <code>Granularity</code> isn't set, the
|
|
3523
|
+
* response object doesn't include the <code>Granularity</code>, <code>MONTHLY</code>,
|
|
3524
|
+
* <code>DAILY</code>, or <code>HOURLY</code>. </p>
|
|
3360
3525
|
*/
|
|
3361
3526
|
Granularity: Granularity | string | undefined;
|
|
3362
3527
|
/**
|
|
3363
3528
|
* <p>Filters Amazon Web Services costs by different dimensions. For example, you can specify
|
|
3364
|
-
*
|
|
3529
|
+
* <code>SERVICE</code> and <code>LINKED_ACCOUNT</code> and get the costs that are associated
|
|
3365
3530
|
* with that account's usage of that service. You can nest <code>Expression</code> objects to
|
|
3366
3531
|
* define any combination of dimension filters. For more information, see <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a>. </p>
|
|
3367
|
-
* <p>The <code>GetCostAndUsageWithResources</code> operation requires that you either group
|
|
3368
|
-
* <code>ResourceId</code>. It requires the <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a>
|
|
3532
|
+
* <p>The <code>GetCostAndUsageWithResources</code> operation requires that you either group
|
|
3533
|
+
* by or filter by a <code>ResourceId</code>. It requires the <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a>
|
|
3369
3534
|
* <code>"SERVICE = Amazon Elastic Compute Cloud - Compute"</code> in the filter.</p>
|
|
3370
|
-
* <p>Valid values for <code>MatchOptions</code> for <code>Dimensions</code> are
|
|
3371
|
-
*
|
|
3535
|
+
* <p>Valid values for <code>MatchOptions</code> for <code>Dimensions</code> are
|
|
3536
|
+
* <code>EQUALS</code> and <code>CASE_SENSITIVE</code>.</p>
|
|
3537
|
+
* <p>Valid values for <code>MatchOptions</code> for <code>CostCategories</code> and
|
|
3538
|
+
* <code>Tags</code> are <code>EQUALS</code>, <code>ABSENT</code>, and
|
|
3539
|
+
* <code>CASE_SENSITIVE</code>. Default values are <code>EQUALS</code> and
|
|
3540
|
+
* <code>CASE_SENSITIVE</code>.</p>
|
|
3372
3541
|
*/
|
|
3373
3542
|
Filter: Expression | undefined;
|
|
3374
3543
|
/**
|
|
3375
3544
|
* <p>Which metrics are returned in the query. For more information about blended and
|
|
3376
|
-
* unblended rates, see <a href="http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/">Why does
|
|
3377
|
-
*
|
|
3545
|
+
* unblended rates, see <a href="http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/">Why does the "blended" annotation
|
|
3546
|
+
* appear on some line items in my bill?</a>. </p>
|
|
3378
3547
|
* <p>Valid values are <code>AmortizedCost</code>, <code>BlendedCost</code>,
|
|
3379
|
-
*
|
|
3380
|
-
*
|
|
3381
|
-
*
|
|
3548
|
+
* <code>NetAmortizedCost</code>, <code>NetUnblendedCost</code>,
|
|
3549
|
+
* <code>NormalizedUsageAmount</code>, <code>UnblendedCost</code>, and
|
|
3550
|
+
* <code>UsageQuantity</code>. </p>
|
|
3382
3551
|
* <note>
|
|
3383
3552
|
* <p>If you return the <code>UsageQuantity</code> metric, the service aggregates all usage
|
|
3384
3553
|
* numbers without taking the units into account. For example, if you aggregate
|
|
@@ -3388,15 +3557,18 @@ export interface GetCostAndUsageWithResourcesRequest {
|
|
|
3388
3557
|
* <code>UsageType</code> or <code>UsageTypeGroups</code>. </p>
|
|
3389
3558
|
* </note>
|
|
3390
3559
|
* <p>
|
|
3391
|
-
* <code>Metrics</code> is required for <code>GetCostAndUsageWithResources</code>
|
|
3560
|
+
* <code>Metrics</code> is required for <code>GetCostAndUsageWithResources</code>
|
|
3561
|
+
* requests.</p>
|
|
3392
3562
|
*/
|
|
3393
3563
|
Metrics?: string[];
|
|
3394
3564
|
/**
|
|
3395
|
-
* <p>You can group Amazon Web Services costs using up to two different groups:
|
|
3565
|
+
* <p>You can group Amazon Web Services costs using up to two different groups:
|
|
3566
|
+
* <code>DIMENSION</code>, <code>TAG</code>, <code>COST_CATEGORY</code>.</p>
|
|
3396
3567
|
*/
|
|
3397
3568
|
GroupBy?: GroupDefinition[];
|
|
3398
3569
|
/**
|
|
3399
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
3570
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
3571
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
3400
3572
|
*/
|
|
3401
3573
|
NextPageToken?: string;
|
|
3402
3574
|
}
|
|
@@ -3419,25 +3591,25 @@ export interface GetCostCategoriesRequest {
|
|
|
3419
3591
|
CostCategoryName?: string;
|
|
3420
3592
|
/**
|
|
3421
3593
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
3422
|
-
*
|
|
3594
|
+
* <ul>
|
|
3423
3595
|
* <li>
|
|
3424
|
-
*
|
|
3596
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
3425
3597
|
* filters that you plan to use. For example, you can filter for
|
|
3426
3598
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
3427
3599
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
3428
3600
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
3429
3601
|
* example is as follows:</p>
|
|
3430
|
-
*
|
|
3431
|
-
*
|
|
3602
|
+
* <p>
|
|
3603
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
3432
3604
|
* } }</code>
|
|
3433
|
-
*
|
|
3434
|
-
*
|
|
3605
|
+
* </p>
|
|
3606
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
3435
3607
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
3436
3608
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
3437
3609
|
* lines. </p>
|
|
3438
3610
|
* </li>
|
|
3439
3611
|
* <li>
|
|
3440
|
-
*
|
|
3612
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
3441
3613
|
* <code>Expression</code> types and the logical operators
|
|
3442
3614
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
3443
3615
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -3445,25 +3617,25 @@ export interface GetCostCategoriesRequest {
|
|
|
3445
3617
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
3446
3618
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
3447
3619
|
* follows:</p>
|
|
3448
|
-
*
|
|
3449
|
-
*
|
|
3620
|
+
* <p>
|
|
3621
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
3450
3622
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
3451
3623
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
3452
3624
|
* ["DataTransfer"] }}} ] } </code>
|
|
3453
|
-
*
|
|
3454
|
-
*
|
|
3455
|
-
*
|
|
3625
|
+
* </p>
|
|
3626
|
+
* <note>
|
|
3627
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
3456
3628
|
* service returns an error if more than one is specified. The following
|
|
3457
3629
|
* example shows an <code>Expression</code> object that creates an
|
|
3458
3630
|
* error.</p>
|
|
3459
|
-
*
|
|
3460
|
-
*
|
|
3461
|
-
*
|
|
3631
|
+
* </note>
|
|
3632
|
+
* <p>
|
|
3633
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
3462
3634
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
3463
|
-
*
|
|
3635
|
+
* </p>
|
|
3464
3636
|
* </li>
|
|
3465
3637
|
* </ul>
|
|
3466
|
-
*
|
|
3638
|
+
* <note>
|
|
3467
3639
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
3468
3640
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
3469
3641
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -3472,7 +3644,7 @@ export interface GetCostCategoriesRequest {
|
|
|
3472
3644
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
3473
3645
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
3474
3646
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
3475
|
-
*
|
|
3647
|
+
* </note>
|
|
3476
3648
|
*/
|
|
3477
3649
|
Filter?: Expression;
|
|
3478
3650
|
/**
|
|
@@ -3538,42 +3710,45 @@ export interface GetCostCategoriesRequest {
|
|
|
3538
3710
|
}
|
|
3539
3711
|
export interface GetCostForecastRequest {
|
|
3540
3712
|
/**
|
|
3541
|
-
* <p>The period of time that you want the forecast to cover. The start date must be equal to or
|
|
3713
|
+
* <p>The period of time that you want the forecast to cover. The start date must be equal to or
|
|
3714
|
+
* no later than the current date to avoid a validation error.</p>
|
|
3542
3715
|
*/
|
|
3543
3716
|
TimePeriod: DateInterval | undefined;
|
|
3544
3717
|
/**
|
|
3545
|
-
* <p>Which metric Cost Explorer uses to create your forecast. For more information about
|
|
3546
|
-
*
|
|
3547
|
-
*
|
|
3548
|
-
*
|
|
3549
|
-
*
|
|
3718
|
+
* <p>Which metric Cost Explorer uses to create your forecast. For more information about
|
|
3719
|
+
* blended and unblended rates, see <a href="http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/">Why does the "blended" annotation
|
|
3720
|
+
* appear on some line items in my bill?</a>. </p>
|
|
3721
|
+
* <p>Valid values for a <code>GetCostForecast</code> call are the following:</p>
|
|
3722
|
+
* <ul>
|
|
3550
3723
|
* <li>
|
|
3551
|
-
*
|
|
3552
|
-
*
|
|
3724
|
+
* <p>AMORTIZED_COST</p>
|
|
3725
|
+
* </li>
|
|
3553
3726
|
* <li>
|
|
3554
|
-
*
|
|
3555
|
-
*
|
|
3727
|
+
* <p>BLENDED_COST</p>
|
|
3728
|
+
* </li>
|
|
3556
3729
|
* <li>
|
|
3557
|
-
*
|
|
3558
|
-
*
|
|
3730
|
+
* <p>NET_AMORTIZED_COST</p>
|
|
3731
|
+
* </li>
|
|
3559
3732
|
* <li>
|
|
3560
|
-
*
|
|
3561
|
-
*
|
|
3733
|
+
* <p>NET_UNBLENDED_COST</p>
|
|
3734
|
+
* </li>
|
|
3562
3735
|
* <li>
|
|
3563
|
-
*
|
|
3564
|
-
*
|
|
3736
|
+
* <p>UNBLENDED_COST</p>
|
|
3737
|
+
* </li>
|
|
3565
3738
|
* </ul>
|
|
3566
3739
|
*/
|
|
3567
3740
|
Metric: Metric | string | undefined;
|
|
3568
3741
|
/**
|
|
3569
|
-
* <p>How granular you want the forecast to be. You can get 3 months of <code>DAILY</code>
|
|
3570
|
-
*
|
|
3742
|
+
* <p>How granular you want the forecast to be. You can get 3 months of <code>DAILY</code>
|
|
3743
|
+
* forecasts or 12 months of <code>MONTHLY</code> forecasts.</p>
|
|
3744
|
+
* <p>The <code>GetCostForecast</code> operation supports only <code>DAILY</code> and
|
|
3745
|
+
* <code>MONTHLY</code> granularities.</p>
|
|
3571
3746
|
*/
|
|
3572
3747
|
Granularity: Granularity | string | undefined;
|
|
3573
3748
|
/**
|
|
3574
|
-
* <p>The filters that you want to use to filter your forecast. The
|
|
3575
|
-
*
|
|
3576
|
-
*
|
|
3749
|
+
* <p>The filters that you want to use to filter your forecast. The
|
|
3750
|
+
* <code>GetCostForecast</code> API supports filtering by the following dimensions:</p>
|
|
3751
|
+
* <ul>
|
|
3577
3752
|
* <li>
|
|
3578
3753
|
* <p>
|
|
3579
3754
|
* <code>AZ</code>
|
|
@@ -3693,9 +3868,10 @@ export interface GetCostForecastRequest {
|
|
|
3693
3868
|
*/
|
|
3694
3869
|
Filter?: Expression;
|
|
3695
3870
|
/**
|
|
3696
|
-
* <p>Cost Explorer always returns the mean forecast as a single point. You can request a
|
|
3697
|
-
*
|
|
3698
|
-
*
|
|
3871
|
+
* <p>Cost Explorer always returns the mean forecast as a single point. You can request a
|
|
3872
|
+
* prediction interval around the mean by specifying a confidence level. The higher the
|
|
3873
|
+
* confidence level, the more confident Cost Explorer is about the actual value falling in the
|
|
3874
|
+
* prediction interval. Higher confidence levels result in wider prediction intervals.</p>
|
|
3699
3875
|
*/
|
|
3700
3876
|
PredictionIntervalLevel?: number;
|
|
3701
3877
|
}
|
|
@@ -3713,75 +3889,87 @@ export interface GetDimensionValuesRequest {
|
|
|
3713
3889
|
*/
|
|
3714
3890
|
TimePeriod: DateInterval | undefined;
|
|
3715
3891
|
/**
|
|
3716
|
-
* <p>The name of the dimension. Each <code>Dimension</code> is available for a different
|
|
3717
|
-
*
|
|
3718
|
-
*
|
|
3892
|
+
* <p>The name of the dimension. Each <code>Dimension</code> is available for a different
|
|
3893
|
+
* <code>Context</code>. For more information, see <code>Context</code>.
|
|
3894
|
+
* <code>LINK_ACCOUNT_NAME</code> and <code>SERVICE_CODE</code> can only be used in <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/AAPI_CostCategoryRule.html">CostCategoryRule</a>. </p>
|
|
3719
3895
|
*/
|
|
3720
3896
|
Dimension: Dimension | string | undefined;
|
|
3721
3897
|
/**
|
|
3722
|
-
* <p>The context for the call to <code>GetDimensionValues</code>. This can be
|
|
3723
|
-
*
|
|
3724
|
-
*
|
|
3725
|
-
*
|
|
3726
|
-
*
|
|
3727
|
-
*
|
|
3728
|
-
*
|
|
3898
|
+
* <p>The context for the call to <code>GetDimensionValues</code>. This can be
|
|
3899
|
+
* <code>RESERVATIONS</code> or <code>COST_AND_USAGE</code>. The default value is
|
|
3900
|
+
* <code>COST_AND_USAGE</code>. If the context is set to <code>RESERVATIONS</code>, the
|
|
3901
|
+
* resulting dimension values can be used in the <code>GetReservationUtilization</code>
|
|
3902
|
+
* operation. If the context is set to <code>COST_AND_USAGE</code>, the resulting dimension
|
|
3903
|
+
* values can be used in the <code>GetCostAndUsage</code> operation.</p>
|
|
3904
|
+
* <p>If you set the context to <code>COST_AND_USAGE</code>, you can use the following
|
|
3905
|
+
* dimensions for searching:</p>
|
|
3906
|
+
* <ul>
|
|
3729
3907
|
* <li>
|
|
3730
3908
|
* <p>AZ - The Availability Zone. An example is <code>us-east-1a</code>.</p>
|
|
3731
3909
|
* </li>
|
|
3732
3910
|
* <li>
|
|
3733
|
-
* <p>BILLING_ENTITY - The Amazon Web Services seller that your account is with. Possible
|
|
3911
|
+
* <p>BILLING_ENTITY - The Amazon Web Services seller that your account is with. Possible
|
|
3912
|
+
* values are the following:</p>
|
|
3734
3913
|
* <p>- Amazon Web Services(Amazon Web Services): The entity that sells Amazon Web Services.</p>
|
|
3735
|
-
* <p>- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian entity that's an
|
|
3736
|
-
*
|
|
3737
|
-
* <p>- Amazon Web Services Marketplace: The entity that supports the sale of solutions that are
|
|
3738
|
-
*
|
|
3739
|
-
*
|
|
3914
|
+
* <p>- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian entity that's an acting
|
|
3915
|
+
* reseller for Amazon Web Services in India.</p>
|
|
3916
|
+
* <p>- Amazon Web Services Marketplace: The entity that supports the sale of solutions that are built on
|
|
3917
|
+
* Amazon Web Services by third-party software providers.</p>
|
|
3918
|
+
* </li>
|
|
3740
3919
|
* <li>
|
|
3741
|
-
* <p>CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or
|
|
3920
|
+
* <p>CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or
|
|
3921
|
+
* Linux.</p>
|
|
3742
3922
|
* </li>
|
|
3743
3923
|
* <li>
|
|
3744
|
-
* <p>DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments.
|
|
3924
|
+
* <p>DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments.
|
|
3925
|
+
* Valid values are <code>SingleAZ</code> and <code>MultiAZ</code>.</p>
|
|
3745
3926
|
* </li>
|
|
3746
3927
|
* <li>
|
|
3747
|
-
* <p>DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are
|
|
3928
|
+
* <p>DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are
|
|
3929
|
+
* Aurora or MySQL.</p>
|
|
3748
3930
|
* </li>
|
|
3749
3931
|
* <li>
|
|
3750
|
-
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
3932
|
+
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
3933
|
+
* <code>m4.xlarge</code>.</p>
|
|
3751
3934
|
* </li>
|
|
3752
3935
|
* <li>
|
|
3753
|
-
* <p>INSTANCE_TYPE_FAMILY - A family of instance types optimized to fit different use
|
|
3754
|
-
* Examples are <code>Compute Optimized</code> (for example, <code>C4</code>,
|
|
3755
|
-
*
|
|
3756
|
-
*
|
|
3757
|
-
* <code>R6g</code>).</p>
|
|
3936
|
+
* <p>INSTANCE_TYPE_FAMILY - A family of instance types optimized to fit different use
|
|
3937
|
+
* cases. Examples are <code>Compute Optimized</code> (for example, <code>C4</code>,
|
|
3938
|
+
* <code>C5</code>, <code>C6g</code>, and <code>C7g</code>), <code>Memory
|
|
3939
|
+
* Optimization</code> (for example, <code>R4</code>, <code>R5n</code>, <code>R5b</code>,
|
|
3940
|
+
* and <code>R6g</code>).</p>
|
|
3758
3941
|
* </li>
|
|
3759
3942
|
* <li>
|
|
3760
3943
|
* <p>INVOICING_ENTITY - The name of the entity that issues the Amazon Web Services
|
|
3761
3944
|
* invoice.</p>
|
|
3762
3945
|
* </li>
|
|
3763
3946
|
* <li>
|
|
3764
|
-
* <p>LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon Web Services
|
|
3947
|
+
* <p>LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon Web Services
|
|
3948
|
+
* services, such as Amazon Web Services.</p>
|
|
3765
3949
|
* </li>
|
|
3766
3950
|
* <li>
|
|
3767
|
-
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
3768
|
-
*
|
|
3951
|
+
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
3952
|
+
* of the member account. The value field contains the Amazon Web Services ID of the member
|
|
3953
|
+
* account.</p>
|
|
3769
3954
|
* </li>
|
|
3770
3955
|
* <li>
|
|
3771
3956
|
* <p>OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.</p>
|
|
3772
3957
|
* </li>
|
|
3773
3958
|
* <li>
|
|
3774
|
-
* <p>OPERATION - The action performed. Examples include <code>RunInstance</code> and
|
|
3959
|
+
* <p>OPERATION - The action performed. Examples include <code>RunInstance</code> and
|
|
3960
|
+
* <code>CreateBucket</code>.</p>
|
|
3775
3961
|
* </li>
|
|
3776
3962
|
* <li>
|
|
3777
|
-
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
3963
|
+
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
3964
|
+
* Linux.</p>
|
|
3778
3965
|
* </li>
|
|
3779
3966
|
* <li>
|
|
3780
3967
|
* <p>PURCHASE_TYPE - The reservation type of the purchase that this usage is related to.
|
|
3781
3968
|
* Examples include On-Demand Instances and Standard Reserved Instances.</p>
|
|
3782
3969
|
* </li>
|
|
3783
3970
|
* <li>
|
|
3784
|
-
* <p>RESERVATION_ID - The unique identifier for an Amazon Web Services Reservation
|
|
3971
|
+
* <p>RESERVATION_ID - The unique identifier for an Amazon Web Services Reservation
|
|
3972
|
+
* Instance.</p>
|
|
3785
3973
|
* </li>
|
|
3786
3974
|
* <li>
|
|
3787
3975
|
* <p>SAVINGS_PLAN_ARN - The unique identifier for your Savings Plans.</p>
|
|
@@ -3796,60 +3984,70 @@ export interface GetDimensionValuesRequest {
|
|
|
3796
3984
|
* <p>TENANCY - The tenancy of a resource. Examples are shared or dedicated.</p>
|
|
3797
3985
|
* </li>
|
|
3798
3986
|
* <li>
|
|
3799
|
-
* <p>USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response
|
|
3800
|
-
*
|
|
3987
|
+
* <p>USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response
|
|
3988
|
+
* for the <code>GetDimensionValues</code> operation includes a unit attribute. Examples
|
|
3989
|
+
* include GB and Hrs.</p>
|
|
3801
3990
|
* </li>
|
|
3802
3991
|
* <li>
|
|
3803
|
-
* <p>USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2:
|
|
3804
|
-
*
|
|
3992
|
+
* <p>USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2:
|
|
3993
|
+
* CloudWatch – Alarms. The response for this operation includes a unit attribute.</p>
|
|
3805
3994
|
* </li>
|
|
3806
3995
|
* <li>
|
|
3807
3996
|
* <p>REGION - The Amazon Web Services Region.</p>
|
|
3808
3997
|
* </li>
|
|
3809
3998
|
* <li>
|
|
3810
|
-
* <p>RECORD_TYPE - The different types of charges such as Reserved Instance (RI) fees,
|
|
3811
|
-
* costs, tax refunds, and credits.</p>
|
|
3999
|
+
* <p>RECORD_TYPE - The different types of charges such as Reserved Instance (RI) fees,
|
|
4000
|
+
* usage costs, tax refunds, and credits.</p>
|
|
3812
4001
|
* </li>
|
|
3813
4002
|
* <li>
|
|
3814
|
-
* <p>RESOURCE_ID - The unique identifier of the resource. ResourceId is an opt-in
|
|
4003
|
+
* <p>RESOURCE_ID - The unique identifier of the resource. ResourceId is an opt-in
|
|
4004
|
+
* feature only available for last 14 days for EC2-Compute Service.</p>
|
|
3815
4005
|
* </li>
|
|
3816
4006
|
* </ul>
|
|
3817
4007
|
* <p>If you set the context to <code>RESERVATIONS</code>, you can use the following
|
|
3818
|
-
*
|
|
4008
|
+
* dimensions for searching:</p>
|
|
3819
4009
|
* <ul>
|
|
3820
4010
|
* <li>
|
|
3821
4011
|
* <p>AZ - The Availability Zone. An example is <code>us-east-1a</code>.</p>
|
|
3822
4012
|
* </li>
|
|
3823
4013
|
* <li>
|
|
3824
|
-
* <p>CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or
|
|
4014
|
+
* <p>CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or
|
|
4015
|
+
* Linux.</p>
|
|
3825
4016
|
* </li>
|
|
3826
4017
|
* <li>
|
|
3827
|
-
* <p>DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments.
|
|
4018
|
+
* <p>DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments.
|
|
4019
|
+
* Valid values are <code>SingleAZ</code> and <code>MultiAZ</code>.</p>
|
|
3828
4020
|
* </li>
|
|
3829
4021
|
* <li>
|
|
3830
|
-
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
4022
|
+
* <p>INSTANCE_TYPE - The type of Amazon EC2 instance. An example is
|
|
4023
|
+
* <code>m4.xlarge</code>.</p>
|
|
3831
4024
|
* </li>
|
|
3832
4025
|
* <li>
|
|
3833
|
-
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
3834
|
-
*
|
|
4026
|
+
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
4027
|
+
* of the member account. The value field contains the Amazon Web Services ID of the member
|
|
4028
|
+
* account.</p>
|
|
3835
4029
|
* </li>
|
|
3836
4030
|
* <li>
|
|
3837
|
-
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
4031
|
+
* <p>PLATFORM - The Amazon EC2 operating system. Examples are Windows or
|
|
4032
|
+
* Linux.</p>
|
|
3838
4033
|
* </li>
|
|
3839
4034
|
* <li>
|
|
3840
4035
|
* <p>REGION - The Amazon Web Services Region.</p>
|
|
3841
4036
|
* </li>
|
|
3842
4037
|
* <li>
|
|
3843
|
-
* <p>SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are
|
|
4038
|
+
* <p>SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are
|
|
4039
|
+
* regional or a single Availability Zone.</p>
|
|
3844
4040
|
* </li>
|
|
3845
4041
|
* <li>
|
|
3846
|
-
* <p>TAG (Coverage only) - The tags that are associated with a Reserved Instance
|
|
4042
|
+
* <p>TAG (Coverage only) - The tags that are associated with a Reserved Instance
|
|
4043
|
+
* (RI).</p>
|
|
3847
4044
|
* </li>
|
|
3848
4045
|
* <li>
|
|
3849
4046
|
* <p>TENANCY - The tenancy of a resource. Examples are shared or dedicated.</p>
|
|
3850
4047
|
* </li>
|
|
3851
4048
|
* </ul>
|
|
3852
|
-
* <p>If you set the context to <code>SAVINGS_PLANS</code>, you can use the following
|
|
4049
|
+
* <p>If you set the context to <code>SAVINGS_PLANS</code>, you can use the following
|
|
4050
|
+
* dimensions for searching:</p>
|
|
3853
4051
|
* <ul>
|
|
3854
4052
|
* <li>
|
|
3855
4053
|
* <p>SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute)</p>
|
|
@@ -3862,11 +4060,13 @@ export interface GetDimensionValuesRequest {
|
|
|
3862
4060
|
* <p>REGION - The Amazon Web Services Region.</p>
|
|
3863
4061
|
* </li>
|
|
3864
4062
|
* <li>
|
|
3865
|
-
* <p>INSTANCE_TYPE_FAMILY - The family of instances (For example,
|
|
4063
|
+
* <p>INSTANCE_TYPE_FAMILY - The family of instances (For example,
|
|
4064
|
+
* <code>m5</code>)</p>
|
|
3866
4065
|
* </li>
|
|
3867
4066
|
* <li>
|
|
3868
|
-
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
3869
|
-
*
|
|
4067
|
+
* <p>LINKED_ACCOUNT - The description in the attribute map that includes the full name
|
|
4068
|
+
* of the member account. The value field contains the Amazon Web Services ID of the member
|
|
4069
|
+
* account.</p>
|
|
3870
4070
|
* </li>
|
|
3871
4071
|
* <li>
|
|
3872
4072
|
* <p>SAVINGS_PLAN_ARN - The unique identifier for your Savings Plans.</p>
|
|
@@ -3876,25 +4076,25 @@ export interface GetDimensionValuesRequest {
|
|
|
3876
4076
|
Context?: Context | string;
|
|
3877
4077
|
/**
|
|
3878
4078
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
3879
|
-
*
|
|
4079
|
+
* <ul>
|
|
3880
4080
|
* <li>
|
|
3881
|
-
*
|
|
4081
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
3882
4082
|
* filters that you plan to use. For example, you can filter for
|
|
3883
4083
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
3884
4084
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
3885
4085
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
3886
4086
|
* example is as follows:</p>
|
|
3887
|
-
*
|
|
3888
|
-
*
|
|
4087
|
+
* <p>
|
|
4088
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
3889
4089
|
* } }</code>
|
|
3890
|
-
*
|
|
3891
|
-
*
|
|
4090
|
+
* </p>
|
|
4091
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
3892
4092
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
3893
4093
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
3894
4094
|
* lines. </p>
|
|
3895
4095
|
* </li>
|
|
3896
4096
|
* <li>
|
|
3897
|
-
*
|
|
4097
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
3898
4098
|
* <code>Expression</code> types and the logical operators
|
|
3899
4099
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
3900
4100
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -3902,25 +4102,25 @@ export interface GetDimensionValuesRequest {
|
|
|
3902
4102
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
3903
4103
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
3904
4104
|
* follows:</p>
|
|
3905
|
-
*
|
|
3906
|
-
*
|
|
4105
|
+
* <p>
|
|
4106
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
3907
4107
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
3908
4108
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
3909
4109
|
* ["DataTransfer"] }}} ] } </code>
|
|
3910
|
-
*
|
|
3911
|
-
*
|
|
3912
|
-
*
|
|
4110
|
+
* </p>
|
|
4111
|
+
* <note>
|
|
4112
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
3913
4113
|
* service returns an error if more than one is specified. The following
|
|
3914
4114
|
* example shows an <code>Expression</code> object that creates an
|
|
3915
4115
|
* error.</p>
|
|
3916
|
-
*
|
|
3917
|
-
*
|
|
3918
|
-
*
|
|
4116
|
+
* </note>
|
|
4117
|
+
* <p>
|
|
4118
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
3919
4119
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
3920
|
-
*
|
|
4120
|
+
* </p>
|
|
3921
4121
|
* </li>
|
|
3922
4122
|
* </ul>
|
|
3923
|
-
*
|
|
4123
|
+
* <note>
|
|
3924
4124
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
3925
4125
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
3926
4126
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -3929,7 +4129,7 @@ export interface GetDimensionValuesRequest {
|
|
|
3929
4129
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
3930
4130
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
3931
4131
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
3932
|
-
*
|
|
4132
|
+
* </note>
|
|
3933
4133
|
*/
|
|
3934
4134
|
Filter?: Expression;
|
|
3935
4135
|
/**
|
|
@@ -3987,23 +4187,29 @@ export interface GetDimensionValuesRequest {
|
|
|
3987
4187
|
*/
|
|
3988
4188
|
MaxResults?: number;
|
|
3989
4189
|
/**
|
|
3990
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
4190
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
4191
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
3991
4192
|
*/
|
|
3992
4193
|
NextPageToken?: string;
|
|
3993
4194
|
}
|
|
3994
4195
|
/**
|
|
3995
|
-
* <p>You can use the following request parameters to query for how much of your instance
|
|
4196
|
+
* <p>You can use the following request parameters to query for how much of your instance
|
|
4197
|
+
* usage a reservation covered.</p>
|
|
3996
4198
|
*/
|
|
3997
4199
|
export interface GetReservationCoverageRequest {
|
|
3998
4200
|
/**
|
|
3999
|
-
* <p>The start and end dates of the period that you want to retrieve data about reservation
|
|
4000
|
-
*
|
|
4001
|
-
*
|
|
4201
|
+
* <p>The start and end dates of the period that you want to retrieve data about reservation
|
|
4202
|
+
* coverage for. You can retrieve data for a maximum of 13 months: the last 12 months and the
|
|
4203
|
+
* current month. The start date is inclusive, but the end date is exclusive. For example, if
|
|
4204
|
+
* <code>start</code> is <code>2017-01-01</code> and <code>end</code> is
|
|
4205
|
+
* <code>2017-05-01</code>, then the cost and usage data is retrieved from
|
|
4206
|
+
* <code>2017-01-01</code> up to and including <code>2017-04-30</code> but not including
|
|
4207
|
+
* <code>2017-05-01</code>. </p>
|
|
4002
4208
|
*/
|
|
4003
4209
|
TimePeriod: DateInterval | undefined;
|
|
4004
4210
|
/**
|
|
4005
4211
|
* <p>You can group the data by the following attributes:</p>
|
|
4006
|
-
*
|
|
4212
|
+
* <ul>
|
|
4007
4213
|
* <li>
|
|
4008
4214
|
* <p>AZ</p>
|
|
4009
4215
|
* </li>
|
|
@@ -4041,15 +4247,19 @@ export interface GetReservationCoverageRequest {
|
|
|
4041
4247
|
*/
|
|
4042
4248
|
GroupBy?: GroupDefinition[];
|
|
4043
4249
|
/**
|
|
4044
|
-
* <p>The granularity of the Amazon Web Services cost data for the reservation. Valid values
|
|
4045
|
-
*
|
|
4046
|
-
*
|
|
4047
|
-
*
|
|
4250
|
+
* <p>The granularity of the Amazon Web Services cost data for the reservation. Valid values
|
|
4251
|
+
* are <code>MONTHLY</code> and <code>DAILY</code>.</p>
|
|
4252
|
+
* <p>If <code>GroupBy</code> is set, <code>Granularity</code> can't be set. If
|
|
4253
|
+
* <code>Granularity</code> isn't set, the response object doesn't include
|
|
4254
|
+
* <code>Granularity</code>, either <code>MONTHLY</code> or <code>DAILY</code>.</p>
|
|
4255
|
+
* <p>The <code>GetReservationCoverage</code> operation supports only <code>DAILY</code> and
|
|
4256
|
+
* <code>MONTHLY</code> granularities.</p>
|
|
4048
4257
|
*/
|
|
4049
4258
|
Granularity?: Granularity | string;
|
|
4050
4259
|
/**
|
|
4051
|
-
* <p>Filters utilization data by dimensions. You can filter by the following
|
|
4052
|
-
*
|
|
4260
|
+
* <p>Filters utilization data by dimensions. You can filter by the following
|
|
4261
|
+
* dimensions:</p>
|
|
4262
|
+
* <ul>
|
|
4053
4263
|
* <li>
|
|
4054
4264
|
* <p>AZ</p>
|
|
4055
4265
|
* </li>
|
|
@@ -4087,22 +4297,25 @@ export interface GetReservationCoverageRequest {
|
|
|
4087
4297
|
* <p>TENANCY</p>
|
|
4088
4298
|
* </li>
|
|
4089
4299
|
* </ul>
|
|
4090
|
-
*
|
|
4091
|
-
* <code>GetReservationCoverage</code> uses the same
|
|
4092
|
-
*
|
|
4093
|
-
*
|
|
4094
|
-
*
|
|
4095
|
-
*
|
|
4096
|
-
*
|
|
4300
|
+
* <p>
|
|
4301
|
+
* <code>GetReservationCoverage</code> uses the same <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
4302
|
+
* as the other operations, but only <code>AND</code> is supported among each dimension. You can
|
|
4303
|
+
* nest only one level deep. If there are multiple values for a dimension, they are OR'd
|
|
4304
|
+
* together.</p>
|
|
4305
|
+
* <p>If you don't provide a <code>SERVICE</code> filter, Cost Explorer defaults to
|
|
4306
|
+
* EC2.</p>
|
|
4307
|
+
* <p>Cost category is also supported.</p>
|
|
4097
4308
|
*/
|
|
4098
4309
|
Filter?: Expression;
|
|
4099
4310
|
/**
|
|
4100
4311
|
* <p>The measurement that you want your reservation coverage reported in.</p>
|
|
4101
|
-
*
|
|
4312
|
+
* <p>Valid values are <code>Hour</code>, <code>Unit</code>, and <code>Cost</code>. You can use
|
|
4313
|
+
* multiple values in a request.</p>
|
|
4102
4314
|
*/
|
|
4103
4315
|
Metrics?: string[];
|
|
4104
4316
|
/**
|
|
4105
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
4317
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
4318
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
4106
4319
|
*/
|
|
4107
4320
|
NextPageToken?: string;
|
|
4108
4321
|
/**
|
|
@@ -4160,8 +4373,8 @@ export interface GetReservationCoverageRequest {
|
|
|
4160
4373
|
* </p>
|
|
4161
4374
|
* </li>
|
|
4162
4375
|
* </ul>
|
|
4163
|
-
*
|
|
4164
|
-
*
|
|
4376
|
+
* <p>Supported values for <code>SortOrder</code> are <code>ASCENDING</code> or
|
|
4377
|
+
* <code>DESCENDING</code>.</p>
|
|
4165
4378
|
*/
|
|
4166
4379
|
SortBy?: SortDefinition;
|
|
4167
4380
|
/**
|
|
@@ -4182,25 +4395,25 @@ export interface GetReservationPurchaseRecommendationRequest {
|
|
|
4182
4395
|
Service: string | undefined;
|
|
4183
4396
|
/**
|
|
4184
4397
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
4185
|
-
*
|
|
4398
|
+
* <ul>
|
|
4186
4399
|
* <li>
|
|
4187
|
-
*
|
|
4400
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
4188
4401
|
* filters that you plan to use. For example, you can filter for
|
|
4189
4402
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
4190
4403
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
4191
4404
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
4192
4405
|
* example is as follows:</p>
|
|
4193
|
-
*
|
|
4194
|
-
*
|
|
4406
|
+
* <p>
|
|
4407
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
4195
4408
|
* } }</code>
|
|
4196
|
-
*
|
|
4197
|
-
*
|
|
4409
|
+
* </p>
|
|
4410
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
4198
4411
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
4199
4412
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
4200
4413
|
* lines. </p>
|
|
4201
4414
|
* </li>
|
|
4202
4415
|
* <li>
|
|
4203
|
-
*
|
|
4416
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
4204
4417
|
* <code>Expression</code> types and the logical operators
|
|
4205
4418
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
4206
4419
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -4208,25 +4421,25 @@ export interface GetReservationPurchaseRecommendationRequest {
|
|
|
4208
4421
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
4209
4422
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
4210
4423
|
* follows:</p>
|
|
4211
|
-
*
|
|
4212
|
-
*
|
|
4424
|
+
* <p>
|
|
4425
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
4213
4426
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
4214
4427
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
4215
4428
|
* ["DataTransfer"] }}} ] } </code>
|
|
4216
|
-
*
|
|
4217
|
-
*
|
|
4218
|
-
*
|
|
4429
|
+
* </p>
|
|
4430
|
+
* <note>
|
|
4431
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
4219
4432
|
* service returns an error if more than one is specified. The following
|
|
4220
4433
|
* example shows an <code>Expression</code> object that creates an
|
|
4221
4434
|
* error.</p>
|
|
4222
|
-
*
|
|
4223
|
-
*
|
|
4224
|
-
*
|
|
4435
|
+
* </note>
|
|
4436
|
+
* <p>
|
|
4437
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
4225
4438
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
4226
|
-
*
|
|
4439
|
+
* </p>
|
|
4227
4440
|
* </li>
|
|
4228
4441
|
* </ul>
|
|
4229
|
-
*
|
|
4442
|
+
* <note>
|
|
4230
4443
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
4231
4444
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
4232
4445
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -4235,15 +4448,19 @@ export interface GetReservationPurchaseRecommendationRequest {
|
|
|
4235
4448
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
4236
4449
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
4237
4450
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
4238
|
-
*
|
|
4451
|
+
* </note>
|
|
4239
4452
|
*/
|
|
4240
4453
|
Filter?: Expression;
|
|
4241
4454
|
/**
|
|
4242
|
-
* <p>The account scope that you want your recommendations for. Amazon Web Services
|
|
4455
|
+
* <p>The account scope that you want your recommendations for. Amazon Web Services
|
|
4456
|
+
* calculates recommendations including the management account and member accounts if the value
|
|
4457
|
+
* is set to <code>PAYER</code>. If the value is <code>LINKED</code>, recommendations are
|
|
4458
|
+
* calculated for individual member accounts only.</p>
|
|
4243
4459
|
*/
|
|
4244
4460
|
AccountScope?: AccountScope | string;
|
|
4245
4461
|
/**
|
|
4246
|
-
* <p>The number of previous days that you want Amazon Web Services to consider when it
|
|
4462
|
+
* <p>The number of previous days that you want Amazon Web Services to consider when it
|
|
4463
|
+
* calculates your recommendations.</p>
|
|
4247
4464
|
*/
|
|
4248
4465
|
LookbackPeriodInDays?: LookbackPeriodInDays | string;
|
|
4249
4466
|
/**
|
|
@@ -4255,22 +4472,25 @@ export interface GetReservationPurchaseRecommendationRequest {
|
|
|
4255
4472
|
*/
|
|
4256
4473
|
PaymentOption?: PaymentOption | string;
|
|
4257
4474
|
/**
|
|
4258
|
-
* <p>The hardware specifications for the service instances that you want recommendations
|
|
4475
|
+
* <p>The hardware specifications for the service instances that you want recommendations
|
|
4476
|
+
* for, such as standard or convertible Amazon EC2 instances.</p>
|
|
4259
4477
|
*/
|
|
4260
4478
|
ServiceSpecification?: ServiceSpecification;
|
|
4261
4479
|
/**
|
|
4262
|
-
* <p>The number of recommendations that you want returned in a single response
|
|
4480
|
+
* <p>The number of recommendations that you want returned in a single response
|
|
4481
|
+
* object.</p>
|
|
4263
4482
|
*/
|
|
4264
4483
|
PageSize?: number;
|
|
4265
4484
|
/**
|
|
4266
|
-
* <p>The pagination token that indicates the next set of results that you want to
|
|
4485
|
+
* <p>The pagination token that indicates the next set of results that you want to
|
|
4486
|
+
* retrieve.</p>
|
|
4267
4487
|
*/
|
|
4268
4488
|
NextPageToken?: string;
|
|
4269
4489
|
}
|
|
4270
4490
|
export interface GetReservationUtilizationRequest {
|
|
4271
4491
|
/**
|
|
4272
|
-
* <p>Sets the start and end dates for retrieving Reserved Instance (RI) utilization. The
|
|
4273
|
-
* date is inclusive, but the end date is exclusive. For example, if <code>start</code> is
|
|
4492
|
+
* <p>Sets the start and end dates for retrieving Reserved Instance (RI) utilization. The
|
|
4493
|
+
* start date is inclusive, but the end date is exclusive. For example, if <code>start</code> is
|
|
4274
4494
|
* <code>2017-01-01</code> and <code>end</code> is <code>2017-05-01</code>, then the cost and
|
|
4275
4495
|
* usage data is retrieved from <code>2017-01-01</code> up to and including
|
|
4276
4496
|
* <code>2017-04-30</code> but not including <code>2017-05-01</code>. </p>
|
|
@@ -4281,15 +4501,19 @@ export interface GetReservationUtilizationRequest {
|
|
|
4281
4501
|
*/
|
|
4282
4502
|
GroupBy?: GroupDefinition[];
|
|
4283
4503
|
/**
|
|
4284
|
-
* <p>If <code>GroupBy</code> is set, <code>Granularity</code> can't be set. If
|
|
4285
|
-
*
|
|
4286
|
-
*
|
|
4287
|
-
*
|
|
4504
|
+
* <p>If <code>GroupBy</code> is set, <code>Granularity</code> can't be set. If
|
|
4505
|
+
* <code>Granularity</code> isn't set, the response object doesn't include
|
|
4506
|
+
* <code>Granularity</code>, either <code>MONTHLY</code> or <code>DAILY</code>. If both
|
|
4507
|
+
* <code>GroupBy</code> and <code>Granularity</code> aren't set,
|
|
4508
|
+
* <code>GetReservationUtilization</code> defaults to <code>DAILY</code>.</p>
|
|
4509
|
+
* <p>The <code>GetReservationUtilization</code> operation supports only <code>DAILY</code> and
|
|
4510
|
+
* <code>MONTHLY</code> granularities.</p>
|
|
4288
4511
|
*/
|
|
4289
4512
|
Granularity?: Granularity | string;
|
|
4290
4513
|
/**
|
|
4291
|
-
* <p>Filters utilization data by dimensions. You can filter by the following
|
|
4292
|
-
*
|
|
4514
|
+
* <p>Filters utilization data by dimensions. You can filter by the following
|
|
4515
|
+
* dimensions:</p>
|
|
4516
|
+
* <ul>
|
|
4293
4517
|
* <li>
|
|
4294
4518
|
* <p>AZ</p>
|
|
4295
4519
|
* </li>
|
|
@@ -4324,16 +4548,15 @@ export interface GetReservationUtilizationRequest {
|
|
|
4324
4548
|
* <p>TENANCY</p>
|
|
4325
4549
|
* </li>
|
|
4326
4550
|
* </ul>
|
|
4327
|
-
*
|
|
4328
|
-
* <code>GetReservationUtilization</code> uses the same
|
|
4329
|
-
*
|
|
4330
|
-
*
|
|
4331
|
-
*
|
|
4551
|
+
* <p>
|
|
4552
|
+
* <code>GetReservationUtilization</code> uses the same <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
4553
|
+
* as the other operations, but only <code>AND</code> is supported among each dimension, and
|
|
4554
|
+
* nesting is supported up to only one level deep. If there are multiple values for a dimension,
|
|
4555
|
+
* they are OR'd together.</p>
|
|
4332
4556
|
*/
|
|
4333
4557
|
Filter?: Expression;
|
|
4334
4558
|
/**
|
|
4335
4559
|
* <p>The value that you want to sort the data by.</p>
|
|
4336
|
-
*
|
|
4337
4560
|
* <p>The following values are supported for <code>Key</code>:</p>
|
|
4338
4561
|
* <ul>
|
|
4339
4562
|
* <li>
|
|
@@ -4422,13 +4645,13 @@ export interface GetReservationUtilizationRequest {
|
|
|
4422
4645
|
* </p>
|
|
4423
4646
|
* </li>
|
|
4424
4647
|
* </ul>
|
|
4425
|
-
*
|
|
4426
4648
|
* <p>The supported values for <code>SortOrder</code> are <code>ASCENDING</code> and
|
|
4427
4649
|
* <code>DESCENDING</code>.</p>
|
|
4428
4650
|
*/
|
|
4429
4651
|
SortBy?: SortDefinition;
|
|
4430
4652
|
/**
|
|
4431
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
4653
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
4654
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
4432
4655
|
*/
|
|
4433
4656
|
NextPageToken?: string;
|
|
4434
4657
|
/**
|
|
@@ -4441,25 +4664,25 @@ export interface GetReservationUtilizationRequest {
|
|
|
4441
4664
|
export interface GetRightsizingRecommendationRequest {
|
|
4442
4665
|
/**
|
|
4443
4666
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
4444
|
-
*
|
|
4667
|
+
* <ul>
|
|
4445
4668
|
* <li>
|
|
4446
|
-
*
|
|
4669
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
4447
4670
|
* filters that you plan to use. For example, you can filter for
|
|
4448
4671
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
4449
4672
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
4450
4673
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
4451
4674
|
* example is as follows:</p>
|
|
4452
|
-
*
|
|
4453
|
-
*
|
|
4675
|
+
* <p>
|
|
4676
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
4454
4677
|
* } }</code>
|
|
4455
|
-
*
|
|
4456
|
-
*
|
|
4678
|
+
* </p>
|
|
4679
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
4457
4680
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
4458
4681
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
4459
4682
|
* lines. </p>
|
|
4460
4683
|
* </li>
|
|
4461
4684
|
* <li>
|
|
4462
|
-
*
|
|
4685
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
4463
4686
|
* <code>Expression</code> types and the logical operators
|
|
4464
4687
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
4465
4688
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -4467,25 +4690,25 @@ export interface GetRightsizingRecommendationRequest {
|
|
|
4467
4690
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
4468
4691
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
4469
4692
|
* follows:</p>
|
|
4470
|
-
*
|
|
4471
|
-
*
|
|
4693
|
+
* <p>
|
|
4694
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
4472
4695
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
4473
4696
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
4474
4697
|
* ["DataTransfer"] }}} ] } </code>
|
|
4475
|
-
*
|
|
4476
|
-
*
|
|
4477
|
-
*
|
|
4698
|
+
* </p>
|
|
4699
|
+
* <note>
|
|
4700
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
4478
4701
|
* service returns an error if more than one is specified. The following
|
|
4479
4702
|
* example shows an <code>Expression</code> object that creates an
|
|
4480
4703
|
* error.</p>
|
|
4481
|
-
*
|
|
4482
|
-
*
|
|
4483
|
-
*
|
|
4704
|
+
* </note>
|
|
4705
|
+
* <p>
|
|
4706
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
4484
4707
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
4485
|
-
*
|
|
4708
|
+
* </p>
|
|
4486
4709
|
* </li>
|
|
4487
4710
|
* </ul>
|
|
4488
|
-
*
|
|
4711
|
+
* <note>
|
|
4489
4712
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
4490
4713
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
4491
4714
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -4494,7 +4717,7 @@ export interface GetRightsizingRecommendationRequest {
|
|
|
4494
4717
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
4495
4718
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
4496
4719
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
4497
|
-
*
|
|
4720
|
+
* </note>
|
|
4498
4721
|
*/
|
|
4499
4722
|
Filter?: Expression;
|
|
4500
4723
|
/**
|
|
@@ -4506,8 +4729,8 @@ export interface GetRightsizingRecommendationRequest {
|
|
|
4506
4729
|
*/
|
|
4507
4730
|
Configuration?: RightsizingRecommendationConfiguration;
|
|
4508
4731
|
/**
|
|
4509
|
-
* <p>The specific service that you want recommendations for. The only valid value for
|
|
4510
|
-
*
|
|
4732
|
+
* <p>The specific service that you want recommendations for. The only valid value for
|
|
4733
|
+
* <code>GetRightsizingRecommendation</code> is "<code>AmazonEC2</code>".</p>
|
|
4511
4734
|
*/
|
|
4512
4735
|
Service: string | undefined;
|
|
4513
4736
|
/**
|
|
@@ -4515,26 +4738,33 @@ export interface GetRightsizingRecommendationRequest {
|
|
|
4515
4738
|
*/
|
|
4516
4739
|
PageSize?: number;
|
|
4517
4740
|
/**
|
|
4518
|
-
* <p>The pagination token that indicates the next set of results that you want to
|
|
4741
|
+
* <p>The pagination token that indicates the next set of results that you want to
|
|
4742
|
+
* retrieve.</p>
|
|
4519
4743
|
*/
|
|
4520
4744
|
NextPageToken?: string;
|
|
4521
4745
|
}
|
|
4522
4746
|
export interface GetSavingsPlansCoverageRequest {
|
|
4523
4747
|
/**
|
|
4524
|
-
* <p>The time period that you want the usage and costs for. The <code>Start</code> date must be
|
|
4748
|
+
* <p>The time period that you want the usage and costs for. The <code>Start</code> date must be
|
|
4749
|
+
* within 13 months. The <code>End</code> date must be after the <code>Start</code> date, and
|
|
4750
|
+
* before the current date. Future dates can't be used as an <code>End</code> date.</p>
|
|
4525
4751
|
*/
|
|
4526
4752
|
TimePeriod: DateInterval | undefined;
|
|
4527
4753
|
/**
|
|
4528
|
-
* <p>You can group the data using the attributes <code>INSTANCE_FAMILY</code>,
|
|
4754
|
+
* <p>You can group the data using the attributes <code>INSTANCE_FAMILY</code>,
|
|
4755
|
+
* <code>REGION</code>, or <code>SERVICE</code>.</p>
|
|
4529
4756
|
*/
|
|
4530
4757
|
GroupBy?: GroupDefinition[];
|
|
4531
4758
|
/**
|
|
4532
|
-
* <p>The granularity of the Amazon Web Services cost data for your Savings Plans.
|
|
4533
|
-
*
|
|
4759
|
+
* <p>The granularity of the Amazon Web Services cost data for your Savings Plans.
|
|
4760
|
+
* <code>Granularity</code> can't be set if <code>GroupBy</code> is set.</p>
|
|
4761
|
+
* <p>The <code>GetSavingsPlansCoverage</code> operation supports only <code>DAILY</code> and
|
|
4762
|
+
* <code>MONTHLY</code> granularities.</p>
|
|
4534
4763
|
*/
|
|
4535
4764
|
Granularity?: Granularity | string;
|
|
4536
4765
|
/**
|
|
4537
|
-
* <p>Filters Savings Plans coverage data by dimensions. You can filter data for Savings Plans
|
|
4766
|
+
* <p>Filters Savings Plans coverage data by dimensions. You can filter data for Savings Plans
|
|
4767
|
+
* usage with the following dimensions:</p>
|
|
4538
4768
|
* <ul>
|
|
4539
4769
|
* <li>
|
|
4540
4770
|
* <p>
|
|
@@ -4558,23 +4788,25 @@ export interface GetSavingsPlansCoverageRequest {
|
|
|
4558
4788
|
* </li>
|
|
4559
4789
|
* </ul>
|
|
4560
4790
|
* <p>
|
|
4561
|
-
* <code>GetSavingsPlansCoverage</code> uses the same
|
|
4562
|
-
* <
|
|
4563
|
-
*
|
|
4791
|
+
* <code>GetSavingsPlansCoverage</code> uses the same <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
4792
|
+
* as the other operations, but only <code>AND</code> is supported among each dimension. If there
|
|
4793
|
+
* are multiple values for a dimension, they are OR'd together.</p>
|
|
4564
4794
|
* <p>Cost category is also supported.</p>
|
|
4565
4795
|
*/
|
|
4566
4796
|
Filter?: Expression;
|
|
4567
4797
|
/**
|
|
4568
|
-
* <p>The measurement that you want your Savings Plans coverage reported in. The only valid
|
|
4798
|
+
* <p>The measurement that you want your Savings Plans coverage reported in. The only valid
|
|
4799
|
+
* value is <code>SpendCoveredBySavingsPlans</code>.</p>
|
|
4569
4800
|
*/
|
|
4570
4801
|
Metrics?: string[];
|
|
4571
4802
|
/**
|
|
4572
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
4573
|
-
* more results than the maximum page size.</p>
|
|
4803
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
4804
|
+
* the response from a previous call has more results than the maximum page size.</p>
|
|
4574
4805
|
*/
|
|
4575
4806
|
NextToken?: string;
|
|
4576
4807
|
/**
|
|
4577
|
-
* <p>The number of items to be returned in a response. The default is <code>20</code>, with a
|
|
4808
|
+
* <p>The number of items to be returned in a response. The default is <code>20</code>, with a
|
|
4809
|
+
* minimum value of <code>1</code>.</p>
|
|
4578
4810
|
*/
|
|
4579
4811
|
MaxResults?: number;
|
|
4580
4812
|
/**
|
|
@@ -4617,7 +4849,6 @@ export interface GetSavingsPlansCoverageRequest {
|
|
|
4617
4849
|
* </p>
|
|
4618
4850
|
* </li>
|
|
4619
4851
|
* </ul>
|
|
4620
|
-
*
|
|
4621
4852
|
* <p>The supported values for <code>SortOrder</code> are <code>ASCENDING</code> and
|
|
4622
4853
|
* <code>DESCENDING</code>.</p>
|
|
4623
4854
|
*/
|
|
@@ -4637,11 +4868,15 @@ export interface GetSavingsPlansPurchaseRecommendationRequest {
|
|
|
4637
4868
|
*/
|
|
4638
4869
|
PaymentOption: PaymentOption | string | undefined;
|
|
4639
4870
|
/**
|
|
4640
|
-
* <p>The account scope that you want your recommendations for. Amazon Web Services calculates
|
|
4871
|
+
* <p>The account scope that you want your recommendations for. Amazon Web Services calculates
|
|
4872
|
+
* recommendations including the management account and member accounts if the value is set to
|
|
4873
|
+
* <code>PAYER</code>. If the value is <code>LINKED</code>, recommendations are calculated for
|
|
4874
|
+
* individual member accounts only.</p>
|
|
4641
4875
|
*/
|
|
4642
4876
|
AccountScope?: AccountScope | string;
|
|
4643
4877
|
/**
|
|
4644
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
4878
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
4879
|
+
* the response from a previous call has more results than the maximum page size.</p>
|
|
4645
4880
|
*/
|
|
4646
4881
|
NextPageToken?: string;
|
|
4647
4882
|
/**
|
|
@@ -4668,11 +4903,14 @@ export interface GetSavingsPlansPurchaseRecommendationRequest {
|
|
|
4668
4903
|
}
|
|
4669
4904
|
export interface GetSavingsPlansUtilizationDetailsRequest {
|
|
4670
4905
|
/**
|
|
4671
|
-
* <p>The time period that you want the usage and costs for. The <code>Start</code> date must be
|
|
4906
|
+
* <p>The time period that you want the usage and costs for. The <code>Start</code> date must be
|
|
4907
|
+
* within 13 months. The <code>End</code> date must be after the <code>Start</code> date, and
|
|
4908
|
+
* before the current date. Future dates can't be used as an <code>End</code> date.</p>
|
|
4672
4909
|
*/
|
|
4673
4910
|
TimePeriod: DateInterval | undefined;
|
|
4674
4911
|
/**
|
|
4675
|
-
* <p>Filters Savings Plans utilization coverage data for active Savings Plans dimensions.
|
|
4912
|
+
* <p>Filters Savings Plans utilization coverage data for active Savings Plans dimensions. You
|
|
4913
|
+
* can filter data with the following dimensions:</p>
|
|
4676
4914
|
* <ul>
|
|
4677
4915
|
* <li>
|
|
4678
4916
|
* <p>
|
|
@@ -4701,8 +4939,7 @@ export interface GetSavingsPlansUtilizationDetailsRequest {
|
|
|
4701
4939
|
* </li>
|
|
4702
4940
|
* </ul>
|
|
4703
4941
|
* <p>
|
|
4704
|
-
* <code>GetSavingsPlansUtilizationDetails</code> uses the same
|
|
4705
|
-
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
4942
|
+
* <code>GetSavingsPlansUtilizationDetails</code> uses the same <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
4706
4943
|
* as the other operations, but only <code>AND</code> is supported among each dimension.</p>
|
|
4707
4944
|
*/
|
|
4708
4945
|
Filter?: Expression;
|
|
@@ -4711,16 +4948,17 @@ export interface GetSavingsPlansUtilizationDetailsRequest {
|
|
|
4711
4948
|
*/
|
|
4712
4949
|
DataType?: (SavingsPlansDataType | string)[];
|
|
4713
4950
|
/**
|
|
4714
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
4951
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token when
|
|
4952
|
+
* the response from a previous call has more results than the maximum page size.</p>
|
|
4715
4953
|
*/
|
|
4716
4954
|
NextToken?: string;
|
|
4717
4955
|
/**
|
|
4718
|
-
* <p>The number of items to be returned in a response. The default is <code>20</code>, with a
|
|
4956
|
+
* <p>The number of items to be returned in a response. The default is <code>20</code>, with a
|
|
4957
|
+
* minimum value of <code>1</code>.</p>
|
|
4719
4958
|
*/
|
|
4720
4959
|
MaxResults?: number;
|
|
4721
4960
|
/**
|
|
4722
4961
|
* <p>The value that you want to sort the data by.</p>
|
|
4723
|
-
*
|
|
4724
4962
|
* <p>The following values are supported for <code>Key</code>:</p>
|
|
4725
4963
|
* <ul>
|
|
4726
4964
|
* <li>
|
|
@@ -4759,7 +4997,6 @@ export interface GetSavingsPlansUtilizationDetailsRequest {
|
|
|
4759
4997
|
* </p>
|
|
4760
4998
|
* </li>
|
|
4761
4999
|
* </ul>
|
|
4762
|
-
*
|
|
4763
5000
|
* <p>The supported values for <code>SortOrder</code> are <code>ASCENDING</code> and
|
|
4764
5001
|
* <code>DESCENDING</code>.</p>
|
|
4765
5002
|
*/
|
|
@@ -4767,16 +5004,21 @@ export interface GetSavingsPlansUtilizationDetailsRequest {
|
|
|
4767
5004
|
}
|
|
4768
5005
|
export interface GetSavingsPlansUtilizationRequest {
|
|
4769
5006
|
/**
|
|
4770
|
-
* <p>The time period that you want the usage and costs for. The <code>Start</code> date must be
|
|
5007
|
+
* <p>The time period that you want the usage and costs for. The <code>Start</code> date must be
|
|
5008
|
+
* within 13 months. The <code>End</code> date must be after the <code>Start</code> date, and
|
|
5009
|
+
* before the current date. Future dates can't be used as an <code>End</code> date.</p>
|
|
4771
5010
|
*/
|
|
4772
5011
|
TimePeriod: DateInterval | undefined;
|
|
4773
5012
|
/**
|
|
4774
|
-
* <p>The granularity of the Amazon Web Services utillization data for your Savings
|
|
4775
|
-
*
|
|
5013
|
+
* <p>The granularity of the Amazon Web Services utillization data for your Savings
|
|
5014
|
+
* Plans.</p>
|
|
5015
|
+
* <p>The <code>GetSavingsPlansUtilization</code> operation supports only <code>DAILY</code> and
|
|
5016
|
+
* <code>MONTHLY</code> granularities.</p>
|
|
4776
5017
|
*/
|
|
4777
5018
|
Granularity?: Granularity | string;
|
|
4778
5019
|
/**
|
|
4779
|
-
* <p>Filters Savings Plans utilization coverage data for active Savings Plans dimensions.
|
|
5020
|
+
* <p>Filters Savings Plans utilization coverage data for active Savings Plans dimensions. You
|
|
5021
|
+
* can filter data with the following dimensions:</p>
|
|
4780
5022
|
* <ul>
|
|
4781
5023
|
* <li>
|
|
4782
5024
|
* <p>
|
|
@@ -4810,8 +5052,7 @@ export interface GetSavingsPlansUtilizationRequest {
|
|
|
4810
5052
|
* </li>
|
|
4811
5053
|
* </ul>
|
|
4812
5054
|
* <p>
|
|
4813
|
-
* <code>GetSavingsPlansUtilization</code> uses the same
|
|
4814
|
-
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
5055
|
+
* <code>GetSavingsPlansUtilization</code> uses the same <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html">Expression</a> object
|
|
4815
5056
|
* as the other operations, but only <code>AND</code> is supported among each dimension.</p>
|
|
4816
5057
|
*/
|
|
4817
5058
|
Filter?: Expression;
|
|
@@ -4845,7 +5086,6 @@ export interface GetSavingsPlansUtilizationRequest {
|
|
|
4845
5086
|
* </p>
|
|
4846
5087
|
* </li>
|
|
4847
5088
|
* </ul>
|
|
4848
|
-
*
|
|
4849
5089
|
* <p>The supported values for <code>SortOrder</code> are <code>ASCENDING</code> and
|
|
4850
5090
|
* <code>DESCENDING</code>.</p>
|
|
4851
5091
|
*/
|
|
@@ -4857,8 +5097,11 @@ export interface GetTagsRequest {
|
|
|
4857
5097
|
*/
|
|
4858
5098
|
SearchString?: string;
|
|
4859
5099
|
/**
|
|
4860
|
-
* <p>The start and end dates for retrieving the dimension values. The start date is
|
|
4861
|
-
*
|
|
5100
|
+
* <p>The start and end dates for retrieving the dimension values. The start date is
|
|
5101
|
+
* inclusive, but the end date is exclusive. For example, if <code>start</code> is
|
|
5102
|
+
* <code>2017-01-01</code> and <code>end</code> is <code>2017-05-01</code>, then the cost and
|
|
5103
|
+
* usage data is retrieved from <code>2017-01-01</code> up to and including
|
|
5104
|
+
* <code>2017-04-30</code> but not including <code>2017-05-01</code>.</p>
|
|
4862
5105
|
*/
|
|
4863
5106
|
TimePeriod: DateInterval | undefined;
|
|
4864
5107
|
/**
|
|
@@ -4867,25 +5110,25 @@ export interface GetTagsRequest {
|
|
|
4867
5110
|
TagKey?: string;
|
|
4868
5111
|
/**
|
|
4869
5112
|
* <p>Use <code>Expression</code> to filter by cost or by usage. There are two patterns: </p>
|
|
4870
|
-
*
|
|
5113
|
+
* <ul>
|
|
4871
5114
|
* <li>
|
|
4872
|
-
*
|
|
5115
|
+
* <p>Simple dimension values - You can set the dimension name and values for the
|
|
4873
5116
|
* filters that you plan to use. For example, you can filter for
|
|
4874
5117
|
* <code>REGION==us-east-1 OR REGION==us-west-1</code>. For
|
|
4875
5118
|
* <code>GetRightsizingRecommendation</code>, the Region is a full name (for
|
|
4876
5119
|
* example, <code>REGION==US East (N. Virginia)</code>. The <code>Expression</code>
|
|
4877
5120
|
* example is as follows:</p>
|
|
4878
|
-
*
|
|
4879
|
-
*
|
|
5121
|
+
* <p>
|
|
5122
|
+
* <code>{ "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ]
|
|
4880
5123
|
* } }</code>
|
|
4881
|
-
*
|
|
4882
|
-
*
|
|
5124
|
+
* </p>
|
|
5125
|
+
* <p>The list of dimension values are OR'd together to retrieve cost or usage data.
|
|
4883
5126
|
* You can create <code>Expression</code> and <code>DimensionValues</code> objects
|
|
4884
5127
|
* using either <code>with*</code> methods or <code>set*</code> methods in multiple
|
|
4885
5128
|
* lines. </p>
|
|
4886
5129
|
* </li>
|
|
4887
5130
|
* <li>
|
|
4888
|
-
*
|
|
5131
|
+
* <p>Compound dimension values with logical operations - You can use multiple
|
|
4889
5132
|
* <code>Expression</code> types and the logical operators
|
|
4890
5133
|
* <code>AND/OR/NOT</code> to create a list of one or more
|
|
4891
5134
|
* <code>Expression</code> objects. By doing this, you can filter on more
|
|
@@ -4893,25 +5136,25 @@ export interface GetTagsRequest {
|
|
|
4893
5136
|
* REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
|
|
4894
5137
|
* DataTransfer)</code>. The <code>Expression</code> for that is as
|
|
4895
5138
|
* follows:</p>
|
|
4896
|
-
*
|
|
4897
|
-
*
|
|
5139
|
+
* <p>
|
|
5140
|
+
* <code>{ "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [
|
|
4898
5141
|
* "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values":
|
|
4899
5142
|
* ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values":
|
|
4900
5143
|
* ["DataTransfer"] }}} ] } </code>
|
|
4901
|
-
*
|
|
4902
|
-
*
|
|
4903
|
-
*
|
|
5144
|
+
* </p>
|
|
5145
|
+
* <note>
|
|
5146
|
+
* <p>Because each <code>Expression</code> can have only one operator, the
|
|
4904
5147
|
* service returns an error if more than one is specified. The following
|
|
4905
5148
|
* example shows an <code>Expression</code> object that creates an
|
|
4906
5149
|
* error.</p>
|
|
4907
|
-
*
|
|
4908
|
-
*
|
|
4909
|
-
*
|
|
5150
|
+
* </note>
|
|
5151
|
+
* <p>
|
|
5152
|
+
* <code> { "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE",
|
|
4910
5153
|
* "Values": [ "DataTransfer" ] } } </code>
|
|
4911
|
-
*
|
|
5154
|
+
* </p>
|
|
4912
5155
|
* </li>
|
|
4913
5156
|
* </ul>
|
|
4914
|
-
*
|
|
5157
|
+
* <note>
|
|
4915
5158
|
* <p>For the <code>GetRightsizingRecommendation</code> action, a combination of OR and
|
|
4916
5159
|
* NOT isn't supported. OR isn't supported between different dimensions, or dimensions
|
|
4917
5160
|
* and tags. NOT operators aren't supported. Dimensions are also limited to
|
|
@@ -4920,7 +5163,7 @@ export interface GetTagsRequest {
|
|
|
4920
5163
|
* <p>For the <code>GetReservationPurchaseRecommendation</code> action, only NOT is
|
|
4921
5164
|
* supported. AND and OR aren't supported. Dimensions are limited to
|
|
4922
5165
|
* <code>LINKED_ACCOUNT</code>.</p>
|
|
4923
|
-
*
|
|
5166
|
+
* </note>
|
|
4924
5167
|
*/
|
|
4925
5168
|
Filter?: Expression;
|
|
4926
5169
|
/**
|
|
@@ -4977,7 +5220,8 @@ export interface GetTagsRequest {
|
|
|
4977
5220
|
*/
|
|
4978
5221
|
MaxResults?: number;
|
|
4979
5222
|
/**
|
|
4980
|
-
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
5223
|
+
* <p>The token to retrieve the next set of results. Amazon Web Services provides the token
|
|
5224
|
+
* when the response from a previous call has more results than the maximum page size.</p>
|
|
4981
5225
|
*/
|
|
4982
5226
|
NextPageToken?: string;
|
|
4983
5227
|
}
|
|
@@ -4994,26 +5238,28 @@ export interface GetUsageForecastRequest {
|
|
|
4994
5238
|
TimePeriod: DateInterval | undefined;
|
|
4995
5239
|
/**
|
|
4996
5240
|
* <p>Which metric Cost Explorer uses to create your forecast.</p>
|
|
4997
|
-
*
|
|
4998
|
-
*
|
|
5241
|
+
* <p>Valid values for a <code>GetUsageForecast</code> call are the following:</p>
|
|
5242
|
+
* <ul>
|
|
4999
5243
|
* <li>
|
|
5000
|
-
*
|
|
5001
|
-
*
|
|
5244
|
+
* <p>USAGE_QUANTITY</p>
|
|
5245
|
+
* </li>
|
|
5002
5246
|
* <li>
|
|
5003
|
-
*
|
|
5004
|
-
*
|
|
5247
|
+
* <p>NORMALIZED_USAGE_AMOUNT</p>
|
|
5248
|
+
* </li>
|
|
5005
5249
|
* </ul>
|
|
5006
5250
|
*/
|
|
5007
5251
|
Metric: Metric | string | undefined;
|
|
5008
5252
|
/**
|
|
5009
|
-
* <p>How granular you want the forecast to be. You can get 3 months of <code>DAILY</code>
|
|
5010
|
-
*
|
|
5253
|
+
* <p>How granular you want the forecast to be. You can get 3 months of <code>DAILY</code>
|
|
5254
|
+
* forecasts or 12 months of <code>MONTHLY</code> forecasts.</p>
|
|
5255
|
+
* <p>The <code>GetUsageForecast</code> operation supports only <code>DAILY</code> and
|
|
5256
|
+
* <code>MONTHLY</code> granularities.</p>
|
|
5011
5257
|
*/
|
|
5012
5258
|
Granularity: Granularity | string | undefined;
|
|
5013
5259
|
/**
|
|
5014
|
-
* <p>The filters that you want to use to filter your forecast. The
|
|
5015
|
-
*
|
|
5016
|
-
*
|
|
5260
|
+
* <p>The filters that you want to use to filter your forecast. The
|
|
5261
|
+
* <code>GetUsageForecast</code> API supports filtering by the following dimensions:</p>
|
|
5262
|
+
* <ul>
|
|
5017
5263
|
* <li>
|
|
5018
5264
|
* <p>
|
|
5019
5265
|
* <code>AZ</code>
|
|
@@ -5133,9 +5379,11 @@ export interface GetUsageForecastRequest {
|
|
|
5133
5379
|
*/
|
|
5134
5380
|
Filter?: Expression;
|
|
5135
5381
|
/**
|
|
5136
|
-
* <p>Amazon Web Services Cost Explorer always returns the mean forecast as a single point.
|
|
5137
|
-
*
|
|
5138
|
-
*
|
|
5382
|
+
* <p>Amazon Web Services Cost Explorer always returns the mean forecast as a single point.
|
|
5383
|
+
* You can request a prediction interval around the mean by specifying a confidence level. The
|
|
5384
|
+
* higher the confidence level, the more confident Cost Explorer is about the actual value
|
|
5385
|
+
* falling in the prediction interval. Higher confidence levels result in wider prediction
|
|
5386
|
+
* intervals.</p>
|
|
5139
5387
|
*/
|
|
5140
5388
|
PredictionIntervalLevel?: number;
|
|
5141
5389
|
}
|
|
@@ -5149,10 +5397,12 @@ export interface CreateAnomalyMonitorRequest {
|
|
|
5149
5397
|
* <code>AnomalyMonitor</code>
|
|
5150
5398
|
* </a>. You can use resource tags to control access to your
|
|
5151
5399
|
* <code>monitor</code> using IAM policies.</p>
|
|
5152
|
-
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
5400
|
+
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
5401
|
+
* following restrictions apply to resource tags:</p>
|
|
5153
5402
|
* <ul>
|
|
5154
5403
|
* <li>
|
|
5155
|
-
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
5404
|
+
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
5405
|
+
* user-tags to one resource. The remaining are reserved for Amazon Web Services use</p>
|
|
5156
5406
|
* </li>
|
|
5157
5407
|
* <li>
|
|
5158
5408
|
* <p>The maximum length of a key is 128 characters</p>
|
|
@@ -5161,7 +5411,8 @@ export interface CreateAnomalyMonitorRequest {
|
|
|
5161
5411
|
* <p>The maximum length of a value is 256 characters</p>
|
|
5162
5412
|
* </li>
|
|
5163
5413
|
* <li>
|
|
5164
|
-
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
5414
|
+
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
5415
|
+
* following: <code>_.:/=+@-</code>
|
|
5165
5416
|
* </p>
|
|
5166
5417
|
* </li>
|
|
5167
5418
|
* <li>
|
|
@@ -5171,7 +5422,8 @@ export interface CreateAnomalyMonitorRequest {
|
|
|
5171
5422
|
* <p>Keys and values are trimmed for any leading or trailing whitespaces</p>
|
|
5172
5423
|
* </li>
|
|
5173
5424
|
* <li>
|
|
5174
|
-
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
5425
|
+
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
5426
|
+
* Amazon Web Services use</p>
|
|
5175
5427
|
* </li>
|
|
5176
5428
|
* </ul>
|
|
5177
5429
|
*/
|
|
@@ -5238,8 +5490,7 @@ export interface CreateCostCategoryDefinitionRequest {
|
|
|
5238
5490
|
*/
|
|
5239
5491
|
RuleVersion: CostCategoryRuleVersion | string | undefined;
|
|
5240
5492
|
/**
|
|
5241
|
-
* <p>The Cost Category rules used to categorize costs. For more information, see
|
|
5242
|
-
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html">CostCategoryRule</a>.</p>
|
|
5493
|
+
* <p>The Cost Category rules used to categorize costs. For more information, see <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html">CostCategoryRule</a>.</p>
|
|
5243
5494
|
*/
|
|
5244
5495
|
Rules: CostCategoryRule[] | undefined;
|
|
5245
5496
|
/**
|
|
@@ -5248,8 +5499,7 @@ export interface CreateCostCategoryDefinitionRequest {
|
|
|
5248
5499
|
*/
|
|
5249
5500
|
DefaultValue?: string;
|
|
5250
5501
|
/**
|
|
5251
|
-
* <p>
|
|
5252
|
-
* The split charge rules used to allocate your charges between your Cost Category values.
|
|
5502
|
+
* <p> The split charge rules used to allocate your charges between your Cost Category values.
|
|
5253
5503
|
* </p>
|
|
5254
5504
|
*/
|
|
5255
5505
|
SplitChargeRules?: CostCategorySplitChargeRule[];
|
|
@@ -5258,10 +5508,12 @@ export interface CreateCostCategoryDefinitionRequest {
|
|
|
5258
5508
|
* <code>CostCategory</code>
|
|
5259
5509
|
* </a>. You can use resource tags to control access to your
|
|
5260
5510
|
* <code>cost category</code> using IAM policies.</p>
|
|
5261
|
-
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
5511
|
+
* <p>Each tag consists of a key and a value, and each key must be unique for the resource. The
|
|
5512
|
+
* following restrictions apply to resource tags:</p>
|
|
5262
5513
|
* <ul>
|
|
5263
5514
|
* <li>
|
|
5264
|
-
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
5515
|
+
* <p>Although the maximum number of array members is 200, you can assign a maximum of 50
|
|
5516
|
+
* user-tags to one resource. The remaining are reserved for Amazon Web Services use</p>
|
|
5265
5517
|
* </li>
|
|
5266
5518
|
* <li>
|
|
5267
5519
|
* <p>The maximum length of a key is 128 characters</p>
|
|
@@ -5270,7 +5522,8 @@ export interface CreateCostCategoryDefinitionRequest {
|
|
|
5270
5522
|
* <p>The maximum length of a value is 256 characters</p>
|
|
5271
5523
|
* </li>
|
|
5272
5524
|
* <li>
|
|
5273
|
-
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
5525
|
+
* <p>Keys and values can only contain alphanumeric characters, spaces, and any of the
|
|
5526
|
+
* following: <code>_.:/=+@-</code>
|
|
5274
5527
|
* </p>
|
|
5275
5528
|
* </li>
|
|
5276
5529
|
* <li>
|
|
@@ -5280,7 +5533,8 @@ export interface CreateCostCategoryDefinitionRequest {
|
|
|
5280
5533
|
* <p>Keys and values are trimmed for any leading or trailing whitespaces</p>
|
|
5281
5534
|
* </li>
|
|
5282
5535
|
* <li>
|
|
5283
|
-
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
5536
|
+
* <p>Don’t use <code>aws:</code> as a prefix for your keys. This prefix is reserved for
|
|
5537
|
+
* Amazon Web Services use</p>
|
|
5284
5538
|
* </li>
|
|
5285
5539
|
* </ul>
|
|
5286
5540
|
*/
|
|
@@ -5288,7 +5542,8 @@ export interface CreateCostCategoryDefinitionRequest {
|
|
|
5288
5542
|
}
|
|
5289
5543
|
export interface GetAnomalyMonitorsResponse {
|
|
5290
5544
|
/**
|
|
5291
|
-
* <p>A list of cost anomaly monitors that includes the detailed metadata for each monitor.
|
|
5545
|
+
* <p>A list of cost anomaly monitors that includes the detailed metadata for each monitor.
|
|
5546
|
+
* </p>
|
|
5292
5547
|
*/
|
|
5293
5548
|
AnomalyMonitors: AnomalyMonitor[] | undefined;
|
|
5294
5549
|
/**
|
|
@@ -5312,7 +5567,8 @@ export interface UpdateCostCategoryDefinitionRequest {
|
|
|
5312
5567
|
RuleVersion: CostCategoryRuleVersion | string | undefined;
|
|
5313
5568
|
/**
|
|
5314
5569
|
* <p>The <code>Expression</code> object used to categorize costs. For more information, see
|
|
5315
|
-
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html">CostCategoryRule
|
|
5570
|
+
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html">CostCategoryRule
|
|
5571
|
+
* </a>. </p>
|
|
5316
5572
|
*/
|
|
5317
5573
|
Rules: CostCategoryRule[] | undefined;
|
|
5318
5574
|
/**
|
|
@@ -5321,8 +5577,7 @@ export interface UpdateCostCategoryDefinitionRequest {
|
|
|
5321
5577
|
*/
|
|
5322
5578
|
DefaultValue?: string;
|
|
5323
5579
|
/**
|
|
5324
|
-
* <p>
|
|
5325
|
-
* The split charge rules used to allocate your charges between your Cost Category values.
|
|
5580
|
+
* <p> The split charge rules used to allocate your charges between your Cost Category values.
|
|
5326
5581
|
* </p>
|
|
5327
5582
|
*/
|
|
5328
5583
|
SplitChargeRules?: CostCategorySplitChargeRule[];
|
|
@@ -5774,6 +6029,18 @@ export declare const CostCategoryReferenceFilterSensitiveLog: (obj: CostCategory
|
|
|
5774
6029
|
* @internal
|
|
5775
6030
|
*/
|
|
5776
6031
|
export declare const ListCostCategoryDefinitionsResponseFilterSensitiveLog: (obj: ListCostCategoryDefinitionsResponse) => any;
|
|
6032
|
+
/**
|
|
6033
|
+
* @internal
|
|
6034
|
+
*/
|
|
6035
|
+
export declare const ListSavingsPlansPurchaseRecommendationGenerationRequestFilterSensitiveLog: (obj: ListSavingsPlansPurchaseRecommendationGenerationRequest) => any;
|
|
6036
|
+
/**
|
|
6037
|
+
* @internal
|
|
6038
|
+
*/
|
|
6039
|
+
export declare const GenerationSummaryFilterSensitiveLog: (obj: GenerationSummary) => any;
|
|
6040
|
+
/**
|
|
6041
|
+
* @internal
|
|
6042
|
+
*/
|
|
6043
|
+
export declare const ListSavingsPlansPurchaseRecommendationGenerationResponseFilterSensitiveLog: (obj: ListSavingsPlansPurchaseRecommendationGenerationResponse) => any;
|
|
5777
6044
|
/**
|
|
5778
6045
|
* @internal
|
|
5779
6046
|
*/
|
|
@@ -5790,6 +6057,14 @@ export declare const ProvideAnomalyFeedbackRequestFilterSensitiveLog: (obj: Prov
|
|
|
5790
6057
|
* @internal
|
|
5791
6058
|
*/
|
|
5792
6059
|
export declare const ProvideAnomalyFeedbackResponseFilterSensitiveLog: (obj: ProvideAnomalyFeedbackResponse) => any;
|
|
6060
|
+
/**
|
|
6061
|
+
* @internal
|
|
6062
|
+
*/
|
|
6063
|
+
export declare const StartSavingsPlansPurchaseRecommendationGenerationRequestFilterSensitiveLog: (obj: StartSavingsPlansPurchaseRecommendationGenerationRequest) => any;
|
|
6064
|
+
/**
|
|
6065
|
+
* @internal
|
|
6066
|
+
*/
|
|
6067
|
+
export declare const StartSavingsPlansPurchaseRecommendationGenerationResponseFilterSensitiveLog: (obj: StartSavingsPlansPurchaseRecommendationGenerationResponse) => any;
|
|
5793
6068
|
/**
|
|
5794
6069
|
* @internal
|
|
5795
6070
|
*/
|