aws-sdk-costexplorer 1.2.0 → 1.3.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.
- checksums.yaml +4 -4
- data/lib/aws-sdk-costexplorer.rb +1 -1
- data/lib/aws-sdk-costexplorer/client.rb +117 -33
- data/lib/aws-sdk-costexplorer/client_api.rb +18 -0
- data/lib/aws-sdk-costexplorer/types.rb +178 -39
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 47c8a1aee41cfbbeac27c6dcfebb7bdce048744c
|
4
|
+
data.tar.gz: 23eda2491bcade6dd9b524fa0f7f19549e5daffe
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9df66e5162344323b0dffa6cec5dc9403021b9903136f462bf43cd85cedcd6e0e09795db956ce73fd8d71d5b770055085e08671312e59c4a5ac38b6828e8803b
|
7
|
+
data.tar.gz: c540020a0e135a4b95dd474a1c3b36decf8c4bb998b41d631e4b7fbb64e06520f7c12a64c4c6264a26e2e7ef981493f529423581c3980852252047ab97b0e065
|
data/lib/aws-sdk-costexplorer.rb
CHANGED
@@ -301,7 +301,7 @@ module Aws::CostExplorer
|
|
301
301
|
req.send_request(options)
|
302
302
|
end
|
303
303
|
|
304
|
-
# Retrieves all available filter values for a
|
304
|
+
# Retrieves all available filter values for a specified filter over a
|
305
305
|
# period of time. You can search the dimension values for an arbitrary
|
306
306
|
# string.
|
307
307
|
#
|
@@ -328,31 +328,41 @@ module Aws::CostExplorer
|
|
328
328
|
# `COST_AND_USAGE` the resulting dimension values can be used in the
|
329
329
|
# `GetCostAndUsage` operation.
|
330
330
|
#
|
331
|
-
# If you set the context to `
|
331
|
+
# If you set the context to `COST_AND_USAGE`, you can use the following
|
332
332
|
# dimensions for searching:
|
333
333
|
#
|
334
334
|
# * AZ - The Availability Zone. An example is `us-east-1a`.
|
335
335
|
#
|
336
|
-
# *
|
336
|
+
# * DATABASE\_ENGINE - The Amazon Relational Database Service database.
|
337
|
+
# Examples are Aurora or MySQL.
|
338
|
+
#
|
339
|
+
# * INSTANCE\_TYPE - The type of EC2 instance. An example is
|
337
340
|
# `m4.xlarge`.
|
338
341
|
#
|
342
|
+
# * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
|
343
|
+
# AWS services, such as Amazon Web Services.
|
344
|
+
#
|
339
345
|
# * LINKED\_ACCOUNT - The description in the attribute map that includes
|
340
346
|
# the full name of the member account. The value field contains the
|
341
347
|
# AWS ID of the member account.
|
342
348
|
#
|
349
|
+
# * OPERATING\_SYSTEM - The operating system. Examples are Windows or
|
350
|
+
# Linux.
|
351
|
+
#
|
343
352
|
# * OPERATION - The action performed. Examples include `RunInstance` and
|
344
353
|
# `CreateBucket`.
|
345
354
|
#
|
355
|
+
# * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
|
356
|
+
#
|
346
357
|
# * PURCHASE\_TYPE - The reservation type of the purchase to which this
|
347
358
|
# usage is related. Examples include On-Demand Instances and Standard
|
348
359
|
# Reserved Instances.
|
349
360
|
#
|
350
|
-
# * SERVICE - The AWS service such as DynamoDB.
|
361
|
+
# * SERVICE - The AWS service such as Amazon DynamoDB.
|
351
362
|
#
|
352
363
|
# * USAGE\_TYPE - The type of usage. An example is
|
353
|
-
#
|
354
|
-
# operation includes a unit attribute
|
355
|
-
# and Hrs.
|
364
|
+
# DataTransfer-In-Bytes. The response for the `GetDimensionValues`
|
365
|
+
# operation includes a unit attribute. Examples include GB and Hrs.
|
356
366
|
#
|
357
367
|
# * USAGE\_TYPE\_GROUP - The grouping of common usage types. An example
|
358
368
|
# is EC2: CloudWatch – Alarms. The response for this operation
|
@@ -366,22 +376,28 @@ module Aws::CostExplorer
|
|
366
376
|
#
|
367
377
|
# * AZ - The Availability Zone. An example is `us-east-1a`.
|
368
378
|
#
|
369
|
-
# *
|
379
|
+
# * CACHE\_ENGINE - The Amazon ElastiCache operating system. Examples
|
380
|
+
# are Windows or Linux.
|
381
|
+
#
|
382
|
+
# * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database Service
|
383
|
+
# deployments. Valid values are `SingleAZ` and `MultiAZ`.
|
384
|
+
#
|
385
|
+
# * INSTANCE\_TYPE - The type of EC2 instance. An example is
|
370
386
|
# `m4.xlarge`.
|
371
387
|
#
|
372
388
|
# * LINKED\_ACCOUNT - The description in the attribute map that includes
|
373
389
|
# the full name of the member account. The value field contains the
|
374
390
|
# AWS ID of the member account.
|
375
391
|
#
|
376
|
-
# * PLATFORM - The
|
377
|
-
# model, and software on an instance. For example, a Windows instance
|
378
|
-
# with SQL Server Web and no license, or a Red Hat Enterprise Linux
|
379
|
-
# instance.
|
392
|
+
# * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
|
380
393
|
#
|
381
394
|
# * REGION - The AWS Region.
|
382
395
|
#
|
383
|
-
# * SCOPE - The scope of a Reserved Instance (RI).
|
384
|
-
# or a single Availability Zone.
|
396
|
+
# * SCOPE (Utilization only) - The scope of a Reserved Instance (RI).
|
397
|
+
# Values are regional or a single Availability Zone.
|
398
|
+
#
|
399
|
+
# * TAG (Coverage only) - The tags that are associated with a Reserved
|
400
|
+
# Instance (RI).
|
385
401
|
#
|
386
402
|
# * TENANCY - The tenancy of a resource. Examples are shared or
|
387
403
|
# dedicated.
|
@@ -440,14 +456,26 @@ module Aws::CostExplorer
|
|
440
456
|
#
|
441
457
|
# * AZ
|
442
458
|
#
|
459
|
+
# * CACHE\_ENGINE
|
460
|
+
#
|
461
|
+
# * DATABASE\_ENGINE
|
462
|
+
#
|
463
|
+
# * DEPLOYMENT\_OPTION
|
464
|
+
#
|
443
465
|
# * INSTANCE\_TYPE
|
444
466
|
#
|
445
467
|
# * LINKED\_ACCOUNT
|
446
468
|
#
|
469
|
+
# * OPERATING\_SYSTEM
|
470
|
+
#
|
447
471
|
# * PLATFORM
|
448
472
|
#
|
449
473
|
# * REGION
|
450
474
|
#
|
475
|
+
# * SERVICE
|
476
|
+
#
|
477
|
+
# * TAG
|
478
|
+
#
|
451
479
|
# * TENANCY
|
452
480
|
#
|
453
481
|
# To determine valid values for a dimension, use the
|
@@ -467,14 +495,24 @@ module Aws::CostExplorer
|
|
467
495
|
#
|
468
496
|
# * AZ
|
469
497
|
#
|
498
|
+
# * CACHE\_ENGINE
|
499
|
+
#
|
500
|
+
# * DATABASE\_ENGINE
|
501
|
+
#
|
502
|
+
# * DEPLOYMENT\_OPTION
|
503
|
+
#
|
470
504
|
# * INSTANCE\_TYPE
|
471
505
|
#
|
472
506
|
# * LINKED\_ACCOUNT
|
473
507
|
#
|
508
|
+
# * OPERATING\_SYSTEM
|
509
|
+
#
|
474
510
|
# * PLATFORM
|
475
511
|
#
|
476
512
|
# * REGION
|
477
513
|
#
|
514
|
+
# * TAG
|
515
|
+
#
|
478
516
|
# * TENANCY
|
479
517
|
#
|
480
518
|
# @option params [String] :granularity
|
@@ -482,8 +520,8 @@ module Aws::CostExplorer
|
|
482
520
|
# are `MONTHLY` and `DAILY`.
|
483
521
|
#
|
484
522
|
# If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
|
485
|
-
# isn't set, the response object doesn't include
|
486
|
-
#
|
523
|
+
# isn't set, the response object doesn't include `Granularity`, either
|
524
|
+
# `MONTHLY` or `DAILY`.
|
487
525
|
#
|
488
526
|
# @option params [Types::Expression] :filter
|
489
527
|
# Filters utilization data by dimensions. You can filter by the
|
@@ -491,14 +529,26 @@ module Aws::CostExplorer
|
|
491
529
|
#
|
492
530
|
# * AZ
|
493
531
|
#
|
532
|
+
# * CACHE\_ENGINE
|
533
|
+
#
|
534
|
+
# * DATABASE\_ENGINE
|
535
|
+
#
|
536
|
+
# * DEPLOYMENT\_OPTION
|
537
|
+
#
|
494
538
|
# * INSTANCE\_TYPE
|
495
539
|
#
|
496
540
|
# * LINKED\_ACCOUNT
|
497
541
|
#
|
542
|
+
# * OPERATING\_SYSTEM
|
543
|
+
#
|
498
544
|
# * PLATFORM
|
499
545
|
#
|
500
546
|
# * REGION
|
501
547
|
#
|
548
|
+
# * SERVICE
|
549
|
+
#
|
550
|
+
# * TAG
|
551
|
+
#
|
502
552
|
# * TENANCY
|
503
553
|
#
|
504
554
|
# `GetReservationCoverage` uses the same ` Expression ` object as the
|
@@ -631,7 +681,8 @@ module Aws::CostExplorer
|
|
631
681
|
# The reservation purchase option that you want recommendations for.
|
632
682
|
#
|
633
683
|
# @option params [Types::ServiceSpecification] :service_specification
|
634
|
-
# The
|
684
|
+
# The hardware specifications for the service instances that you want
|
685
|
+
# recommendations for, such as standard or convertible EC2 instances.
|
635
686
|
#
|
636
687
|
# @option params [Integer] :page_size
|
637
688
|
# The number of recommendations that you want returned in a single
|
@@ -684,6 +735,14 @@ module Aws::CostExplorer
|
|
684
735
|
# resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.tenancy #=> String
|
685
736
|
# resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.current_generation #=> Boolean
|
686
737
|
# resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.size_flex_eligible #=> Boolean
|
738
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.family #=> String
|
739
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.instance_type #=> String
|
740
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.region #=> String
|
741
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.database_engine #=> String
|
742
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.deployment_option #=> String
|
743
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.license_model #=> String
|
744
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.current_generation #=> Boolean
|
745
|
+
# resp.recommendations[0].recommendation_details[0].instance_details.rds_instance_details.size_flex_eligible #=> Boolean
|
687
746
|
# resp.recommendations[0].recommendation_details[0].recommended_number_of_instances_to_purchase #=> String
|
688
747
|
# resp.recommendations[0].recommendation_details[0].recommended_normalized_units_to_purchase #=> String
|
689
748
|
# resp.recommendations[0].recommendation_details[0].minimum_number_of_instances_used_per_hour #=> String
|
@@ -715,15 +774,14 @@ module Aws::CostExplorer
|
|
715
774
|
req.send_request(options)
|
716
775
|
end
|
717
776
|
|
718
|
-
#
|
719
|
-
# accounts in an organization
|
720
|
-
#
|
721
|
-
#
|
722
|
-
#
|
723
|
-
# `SUBSCRIPTION_ID`.
|
777
|
+
# Retrieves the reservation utilization for your account. Master
|
778
|
+
# accounts in an organization have access to member accounts. You can
|
779
|
+
# filter data by dimensions in a time period. You can use
|
780
|
+
# `GetDimensionValues` to determine the possible dimension values.
|
781
|
+
# Currently, you can group only by `SUBSCRIPTION_ID`.
|
724
782
|
#
|
725
783
|
# @option params [required, Types::DateInterval] :time_period
|
726
|
-
# Sets the start and end dates for retrieving
|
784
|
+
# Sets the start and end dates for retrieving Reserved Instance (RI)
|
727
785
|
# utilization. The start date is inclusive, but the end date is
|
728
786
|
# exclusive. For example, if `start` is `2017-01-01` and `end` is
|
729
787
|
# `2017-05-01`, then the cost and usage data is retrieved from
|
@@ -735,16 +793,42 @@ module Aws::CostExplorer
|
|
735
793
|
#
|
736
794
|
# @option params [String] :granularity
|
737
795
|
# If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
|
738
|
-
# isn't set, the response object doesn't include
|
739
|
-
#
|
740
|
-
#
|
796
|
+
# isn't set, the response object doesn't include `Granularity`, either
|
797
|
+
# `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity` aren't set,
|
798
|
+
# `GetReservationUtilization` defaults to `DAILY`.
|
741
799
|
#
|
742
800
|
# @option params [Types::Expression] :filter
|
743
|
-
# Filters utilization data by
|
801
|
+
# Filters utilization data by dimensions. You can filter by the
|
802
|
+
# following dimensions:
|
803
|
+
#
|
804
|
+
# * AZ
|
805
|
+
#
|
806
|
+
# * CACHE\_ENGINE
|
807
|
+
#
|
808
|
+
# * DATABASE\_ENGINE
|
809
|
+
#
|
810
|
+
# * DEPLOYMENT\_OPTION
|
811
|
+
#
|
812
|
+
# * INSTANCE\_TYPE
|
813
|
+
#
|
814
|
+
# * LINKED\_ACCOUNT
|
815
|
+
#
|
816
|
+
# * OPERATING\_SYSTEM
|
817
|
+
#
|
818
|
+
# * PLATFORM
|
819
|
+
#
|
820
|
+
# * REGION
|
821
|
+
#
|
822
|
+
# * SERVICE
|
823
|
+
#
|
824
|
+
# * SCOPE
|
825
|
+
#
|
826
|
+
# * TENANCY
|
827
|
+
#
|
744
828
|
# `GetReservationUtilization` uses the same ` Expression ` object as the
|
745
829
|
# other operations, but only `AND` is supported among each dimension,
|
746
|
-
# and nesting is supported to only one level deep. If there are
|
747
|
-
# values for a dimension, they are OR'd together.
|
830
|
+
# and nesting is supported up to only one level deep. If there are
|
831
|
+
# multiple values for a dimension, they are OR'd together.
|
748
832
|
#
|
749
833
|
# @option params [String] :next_page_token
|
750
834
|
# The token to retrieve the next set of results. AWS provides the token
|
@@ -830,8 +914,8 @@ module Aws::CostExplorer
|
|
830
914
|
req.send_request(options)
|
831
915
|
end
|
832
916
|
|
833
|
-
#
|
834
|
-
#
|
917
|
+
# Queries for available tag keys and tag values for a specified period.
|
918
|
+
# You can search the tag values for an arbitrary string.
|
835
919
|
#
|
836
920
|
# @option params [String] :search_string
|
837
921
|
# The value that you want to search for.
|
@@ -900,7 +984,7 @@ module Aws::CostExplorer
|
|
900
984
|
params: params,
|
901
985
|
config: config)
|
902
986
|
context[:gem_name] = 'aws-sdk-costexplorer'
|
903
|
-
context[:gem_version] = '1.
|
987
|
+
context[:gem_version] = '1.3.0'
|
904
988
|
Seahorse::Client::Request.new(handlers, context)
|
905
989
|
end
|
906
990
|
|
@@ -75,6 +75,8 @@ module Aws::CostExplorer
|
|
75
75
|
PageSize = Shapes::IntegerShape.new(name: 'PageSize')
|
76
76
|
PaymentOption = Shapes::StringShape.new(name: 'PaymentOption')
|
77
77
|
PurchasedHours = Shapes::StringShape.new(name: 'PurchasedHours')
|
78
|
+
RDSInstanceDetails = Shapes::StructureShape.new(name: 'RDSInstanceDetails')
|
79
|
+
RequestChangedException = Shapes::StructureShape.new(name: 'RequestChangedException')
|
78
80
|
ReservationAggregates = Shapes::StructureShape.new(name: 'ReservationAggregates')
|
79
81
|
ReservationCoverageGroup = Shapes::StructureShape.new(name: 'ReservationCoverageGroup')
|
80
82
|
ReservationCoverageGroups = Shapes::ListShape.new(name: 'ReservationCoverageGroups')
|
@@ -253,6 +255,7 @@ module Aws::CostExplorer
|
|
253
255
|
Groups.member = Shapes::ShapeRef.new(shape: Group)
|
254
256
|
|
255
257
|
InstanceDetails.add_member(:ec2_instance_details, Shapes::ShapeRef.new(shape: EC2InstanceDetails, location_name: "EC2InstanceDetails"))
|
258
|
+
InstanceDetails.add_member(:rds_instance_details, Shapes::ShapeRef.new(shape: RDSInstanceDetails, location_name: "RDSInstanceDetails"))
|
256
259
|
InstanceDetails.struct_class = Types::InstanceDetails
|
257
260
|
|
258
261
|
Keys.member = Shapes::ShapeRef.new(shape: Key)
|
@@ -266,6 +269,16 @@ module Aws::CostExplorer
|
|
266
269
|
Metrics.key = Shapes::ShapeRef.new(shape: MetricName)
|
267
270
|
Metrics.value = Shapes::ShapeRef.new(shape: MetricValue)
|
268
271
|
|
272
|
+
RDSInstanceDetails.add_member(:family, Shapes::ShapeRef.new(shape: GenericString, location_name: "Family"))
|
273
|
+
RDSInstanceDetails.add_member(:instance_type, Shapes::ShapeRef.new(shape: GenericString, location_name: "InstanceType"))
|
274
|
+
RDSInstanceDetails.add_member(:region, Shapes::ShapeRef.new(shape: GenericString, location_name: "Region"))
|
275
|
+
RDSInstanceDetails.add_member(:database_engine, Shapes::ShapeRef.new(shape: GenericString, location_name: "DatabaseEngine"))
|
276
|
+
RDSInstanceDetails.add_member(:deployment_option, Shapes::ShapeRef.new(shape: GenericString, location_name: "DeploymentOption"))
|
277
|
+
RDSInstanceDetails.add_member(:license_model, Shapes::ShapeRef.new(shape: GenericString, location_name: "LicenseModel"))
|
278
|
+
RDSInstanceDetails.add_member(:current_generation, Shapes::ShapeRef.new(shape: GenericBoolean, location_name: "CurrentGeneration"))
|
279
|
+
RDSInstanceDetails.add_member(:size_flex_eligible, Shapes::ShapeRef.new(shape: GenericBoolean, location_name: "SizeFlexEligible"))
|
280
|
+
RDSInstanceDetails.struct_class = Types::RDSInstanceDetails
|
281
|
+
|
269
282
|
ReservationAggregates.add_member(:utilization_percentage, Shapes::ShapeRef.new(shape: UtilizationPercentage, location_name: "UtilizationPercentage"))
|
270
283
|
ReservationAggregates.add_member(:purchased_hours, Shapes::ShapeRef.new(shape: PurchasedHours, location_name: "PurchasedHours"))
|
271
284
|
ReservationAggregates.add_member(:total_actual_hours, Shapes::ShapeRef.new(shape: TotalActualHours, location_name: "TotalActualHours"))
|
@@ -380,6 +393,7 @@ module Aws::CostExplorer
|
|
380
393
|
o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
|
381
394
|
o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
|
382
395
|
o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
|
396
|
+
o.errors << Shapes::ShapeRef.new(shape: RequestChangedException)
|
383
397
|
end)
|
384
398
|
|
385
399
|
api.add_operation(:get_dimension_values, Seahorse::Model::Operation.new.tap do |o|
|
@@ -390,7 +404,9 @@ module Aws::CostExplorer
|
|
390
404
|
o.output = Shapes::ShapeRef.new(shape: GetDimensionValuesResponse)
|
391
405
|
o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
|
392
406
|
o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
|
407
|
+
o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
|
393
408
|
o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
|
409
|
+
o.errors << Shapes::ShapeRef.new(shape: RequestChangedException)
|
394
410
|
end)
|
395
411
|
|
396
412
|
api.add_operation(:get_reservation_coverage, Seahorse::Model::Operation.new.tap do |o|
|
@@ -434,7 +450,9 @@ module Aws::CostExplorer
|
|
434
450
|
o.output = Shapes::ShapeRef.new(shape: GetTagsResponse)
|
435
451
|
o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
|
436
452
|
o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
|
453
|
+
o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
|
437
454
|
o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
|
455
|
+
o.errors << Shapes::ShapeRef.new(shape: RequestChangedException)
|
438
456
|
end)
|
439
457
|
end
|
440
458
|
|
@@ -564,31 +564,42 @@ module Aws::CostExplorer
|
|
564
564
|
# `COST_AND_USAGE` the resulting dimension values can be used in the
|
565
565
|
# `GetCostAndUsage` operation.
|
566
566
|
#
|
567
|
-
# If you set the context to `
|
568
|
-
# dimensions for searching:
|
567
|
+
# If you set the context to `COST_AND_USAGE`, you can use the
|
568
|
+
# following dimensions for searching:
|
569
569
|
#
|
570
570
|
# * AZ - The Availability Zone. An example is `us-east-1a`.
|
571
571
|
#
|
572
|
-
# *
|
572
|
+
# * DATABASE\_ENGINE - The Amazon Relational Database Service
|
573
|
+
# database. Examples are Aurora or MySQL.
|
574
|
+
#
|
575
|
+
# * INSTANCE\_TYPE - The type of EC2 instance. An example is
|
573
576
|
# `m4.xlarge`.
|
574
577
|
#
|
578
|
+
# * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
|
579
|
+
# AWS services, such as Amazon Web Services.
|
580
|
+
#
|
575
581
|
# * LINKED\_ACCOUNT - The description in the attribute map that
|
576
582
|
# includes the full name of the member account. The value field
|
577
583
|
# contains the AWS ID of the member account.
|
578
584
|
#
|
585
|
+
# * OPERATING\_SYSTEM - The operating system. Examples are Windows or
|
586
|
+
# Linux.
|
587
|
+
#
|
579
588
|
# * OPERATION - The action performed. Examples include `RunInstance`
|
580
589
|
# and `CreateBucket`.
|
581
590
|
#
|
591
|
+
# * PLATFORM - The EC2 operating system. Examples are Windows or
|
592
|
+
# Linux.
|
593
|
+
#
|
582
594
|
# * PURCHASE\_TYPE - The reservation type of the purchase to which
|
583
595
|
# this usage is related. Examples include On-Demand Instances and
|
584
596
|
# Standard Reserved Instances.
|
585
597
|
#
|
586
|
-
# * SERVICE - The AWS service such as DynamoDB.
|
598
|
+
# * SERVICE - The AWS service such as Amazon DynamoDB.
|
587
599
|
#
|
588
600
|
# * USAGE\_TYPE - The type of usage. An example is
|
589
|
-
#
|
590
|
-
# operation includes a unit attribute
|
591
|
-
# and Hrs.
|
601
|
+
# DataTransfer-In-Bytes. The response for the `GetDimensionValues`
|
602
|
+
# operation includes a unit attribute. Examples include GB and Hrs.
|
592
603
|
#
|
593
604
|
# * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
|
594
605
|
# example is EC2: CloudWatch – Alarms. The response for this
|
@@ -602,22 +613,29 @@ module Aws::CostExplorer
|
|
602
613
|
#
|
603
614
|
# * AZ - The Availability Zone. An example is `us-east-1a`.
|
604
615
|
#
|
605
|
-
# *
|
616
|
+
# * CACHE\_ENGINE - The Amazon ElastiCache operating system. Examples
|
617
|
+
# are Windows or Linux.
|
618
|
+
#
|
619
|
+
# * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
|
620
|
+
# Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
|
621
|
+
#
|
622
|
+
# * INSTANCE\_TYPE - The type of EC2 instance. An example is
|
606
623
|
# `m4.xlarge`.
|
607
624
|
#
|
608
625
|
# * LINKED\_ACCOUNT - The description in the attribute map that
|
609
626
|
# includes the full name of the member account. The value field
|
610
627
|
# contains the AWS ID of the member account.
|
611
628
|
#
|
612
|
-
# * PLATFORM - The
|
613
|
-
#
|
614
|
-
# instance with SQL Server Web and no license, or a Red Hat
|
615
|
-
# Enterprise Linux instance.
|
629
|
+
# * PLATFORM - The EC2 operating system. Examples are Windows or
|
630
|
+
# Linux.
|
616
631
|
#
|
617
632
|
# * REGION - The AWS Region.
|
618
633
|
#
|
619
|
-
# * SCOPE - The scope of a Reserved Instance (RI).
|
620
|
-
# or a single Availability Zone.
|
634
|
+
# * SCOPE (Utilization only) - The scope of a Reserved Instance (RI).
|
635
|
+
# Values are regional or a single Availability Zone.
|
636
|
+
#
|
637
|
+
# * TAG (Coverage only) - The tags that are associated with a Reserved
|
638
|
+
# Instance (RI).
|
621
639
|
#
|
622
640
|
# * TENANCY - The tenancy of a resource. Examples are shared or
|
623
641
|
# dedicated.
|
@@ -644,31 +662,42 @@ module Aws::CostExplorer
|
|
644
662
|
# The filters that you used to filter your request. Some dimensions
|
645
663
|
# are available only for a specific context:
|
646
664
|
#
|
647
|
-
# If you set the context to `
|
648
|
-
# dimensions for searching:
|
665
|
+
# If you set the context to `COST_AND_USAGE`, you can use the
|
666
|
+
# following dimensions for searching:
|
649
667
|
#
|
650
668
|
# * AZ - The Availability Zone. An example is `us-east-1a`.
|
651
669
|
#
|
652
|
-
# *
|
670
|
+
# * DATABASE\_ENGINE - The Amazon Relational Database Service
|
671
|
+
# database. Examples are Aurora or MySQL.
|
672
|
+
#
|
673
|
+
# * INSTANCE\_TYPE - The type of EC2 instance. An example is
|
653
674
|
# `m4.xlarge`.
|
654
675
|
#
|
676
|
+
# * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
|
677
|
+
# AWS services, such as Amazon Web Services.
|
678
|
+
#
|
655
679
|
# * LINKED\_ACCOUNT - The description in the attribute map that
|
656
680
|
# includes the full name of the member account. The value field
|
657
681
|
# contains the AWS ID of the member account.
|
658
682
|
#
|
683
|
+
# * OPERATING\_SYSTEM - The operating system. Examples are Windows or
|
684
|
+
# Linux.
|
685
|
+
#
|
659
686
|
# * OPERATION - The action performed. Examples include `RunInstance`
|
660
687
|
# and `CreateBucket`.
|
661
688
|
#
|
689
|
+
# * PLATFORM - The EC2 operating system. Examples are Windows or
|
690
|
+
# Linux.
|
691
|
+
#
|
662
692
|
# * PURCHASE\_TYPE - The reservation type of the purchase to which
|
663
693
|
# this usage is related. Examples include On-Demand Instances and
|
664
694
|
# Standard Reserved Instances.
|
665
695
|
#
|
666
|
-
# * SERVICE - The AWS service such as DynamoDB.
|
696
|
+
# * SERVICE - The AWS service such as Amazon DynamoDB.
|
667
697
|
#
|
668
698
|
# * USAGE\_TYPE - The type of usage. An example is
|
669
|
-
#
|
670
|
-
# operation includes a unit attribute
|
671
|
-
# and Hrs.
|
699
|
+
# DataTransfer-In-Bytes. The response for the `GetDimensionValues`
|
700
|
+
# operation includes a unit attribute. Examples include GB and Hrs.
|
672
701
|
#
|
673
702
|
# * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
|
674
703
|
# example is EC2: CloudWatch – Alarms. The response for this
|
@@ -682,22 +711,29 @@ module Aws::CostExplorer
|
|
682
711
|
#
|
683
712
|
# * AZ - The Availability Zone. An example is `us-east-1a`.
|
684
713
|
#
|
685
|
-
# *
|
714
|
+
# * CACHE\_ENGINE - The Amazon ElastiCache operating system. Examples
|
715
|
+
# are Windows or Linux.
|
716
|
+
#
|
717
|
+
# * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
|
718
|
+
# Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
|
719
|
+
#
|
720
|
+
# * INSTANCE\_TYPE - The type of EC2 instance. An example is
|
686
721
|
# `m4.xlarge`.
|
687
722
|
#
|
688
723
|
# * LINKED\_ACCOUNT - The description in the attribute map that
|
689
724
|
# includes the full name of the member account. The value field
|
690
725
|
# contains the AWS ID of the member account.
|
691
726
|
#
|
692
|
-
# * PLATFORM - The
|
693
|
-
#
|
694
|
-
# instance with SQL Server Web and no license, or a Red Hat
|
695
|
-
# Enterprise Linux instance.
|
727
|
+
# * PLATFORM - The EC2 operating system. Examples are Windows or
|
728
|
+
# Linux.
|
696
729
|
#
|
697
730
|
# * REGION - The AWS Region.
|
698
731
|
#
|
699
|
-
# * SCOPE - The scope of a Reserved Instance (RI).
|
700
|
-
# or a single Availability Zone.
|
732
|
+
# * SCOPE (Utilization only) - The scope of a Reserved Instance (RI).
|
733
|
+
# Values are regional or a single Availability Zone.
|
734
|
+
#
|
735
|
+
# * TAG (Coverage only) - The tags that are associated with a Reserved
|
736
|
+
# Instance (RI).
|
701
737
|
#
|
702
738
|
# * TENANCY - The tenancy of a resource. Examples are shared or
|
703
739
|
# dedicated.
|
@@ -786,14 +822,24 @@ module Aws::CostExplorer
|
|
786
822
|
#
|
787
823
|
# * AZ
|
788
824
|
#
|
825
|
+
# * CACHE\_ENGINE
|
826
|
+
#
|
827
|
+
# * DATABASE\_ENGINE
|
828
|
+
#
|
829
|
+
# * DEPLOYMENT\_OPTION
|
830
|
+
#
|
789
831
|
# * INSTANCE\_TYPE
|
790
832
|
#
|
791
833
|
# * LINKED\_ACCOUNT
|
792
834
|
#
|
835
|
+
# * OPERATING\_SYSTEM
|
836
|
+
#
|
793
837
|
# * PLATFORM
|
794
838
|
#
|
795
839
|
# * REGION
|
796
840
|
#
|
841
|
+
# * TAG
|
842
|
+
#
|
797
843
|
# * TENANCY
|
798
844
|
# @return [Array<Types::GroupDefinition>]
|
799
845
|
#
|
@@ -802,7 +848,7 @@ module Aws::CostExplorer
|
|
802
848
|
# values are `MONTHLY` and `DAILY`.
|
803
849
|
#
|
804
850
|
# If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
|
805
|
-
# isn't set, the response object doesn't include
|
851
|
+
# isn't set, the response object doesn't include `Granularity`,
|
806
852
|
# either `MONTHLY` or `DAILY`.
|
807
853
|
# @return [String]
|
808
854
|
#
|
@@ -812,14 +858,26 @@ module Aws::CostExplorer
|
|
812
858
|
#
|
813
859
|
# * AZ
|
814
860
|
#
|
861
|
+
# * CACHE\_ENGINE
|
862
|
+
#
|
863
|
+
# * DATABASE\_ENGINE
|
864
|
+
#
|
865
|
+
# * DEPLOYMENT\_OPTION
|
866
|
+
#
|
815
867
|
# * INSTANCE\_TYPE
|
816
868
|
#
|
817
869
|
# * LINKED\_ACCOUNT
|
818
870
|
#
|
871
|
+
# * OPERATING\_SYSTEM
|
872
|
+
#
|
819
873
|
# * PLATFORM
|
820
874
|
#
|
821
875
|
# * REGION
|
822
876
|
#
|
877
|
+
# * SERVICE
|
878
|
+
#
|
879
|
+
# * TAG
|
880
|
+
#
|
823
881
|
# * TENANCY
|
824
882
|
#
|
825
883
|
# `GetReservationCoverage` uses the same ` Expression ` object as the
|
@@ -915,8 +973,8 @@ module Aws::CostExplorer
|
|
915
973
|
# @return [String]
|
916
974
|
#
|
917
975
|
# @!attribute [rw] service_specification
|
918
|
-
# The
|
919
|
-
# for.
|
976
|
+
# The hardware specifications for the service instances that you want
|
977
|
+
# recommendations for, such as standard or convertible EC2 instances.
|
920
978
|
# @return [Types::ServiceSpecification]
|
921
979
|
#
|
922
980
|
# @!attribute [rw] page_size
|
@@ -1008,7 +1066,7 @@ module Aws::CostExplorer
|
|
1008
1066
|
# }
|
1009
1067
|
#
|
1010
1068
|
# @!attribute [rw] time_period
|
1011
|
-
# Sets the start and end dates for retrieving
|
1069
|
+
# Sets the start and end dates for retrieving Reserved Instance (RI)
|
1012
1070
|
# utilization. The start date is inclusive, but the end date is
|
1013
1071
|
# exclusive. For example, if `start` is `2017-01-01` and `end` is
|
1014
1072
|
# `2017-05-01`, then the cost and usage data is retrieved from
|
@@ -1022,17 +1080,43 @@ module Aws::CostExplorer
|
|
1022
1080
|
#
|
1023
1081
|
# @!attribute [rw] granularity
|
1024
1082
|
# If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
|
1025
|
-
# isn't set, the response object doesn't include
|
1083
|
+
# isn't set, the response object doesn't include `Granularity`,
|
1026
1084
|
# either `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity`
|
1027
1085
|
# aren't set, `GetReservationUtilization` defaults to `DAILY`.
|
1028
1086
|
# @return [String]
|
1029
1087
|
#
|
1030
1088
|
# @!attribute [rw] filter
|
1031
|
-
# Filters utilization data by
|
1089
|
+
# Filters utilization data by dimensions. You can filter by the
|
1090
|
+
# following dimensions:
|
1091
|
+
#
|
1092
|
+
# * AZ
|
1093
|
+
#
|
1094
|
+
# * CACHE\_ENGINE
|
1095
|
+
#
|
1096
|
+
# * DATABASE\_ENGINE
|
1097
|
+
#
|
1098
|
+
# * DEPLOYMENT\_OPTION
|
1099
|
+
#
|
1100
|
+
# * INSTANCE\_TYPE
|
1101
|
+
#
|
1102
|
+
# * LINKED\_ACCOUNT
|
1103
|
+
#
|
1104
|
+
# * OPERATING\_SYSTEM
|
1105
|
+
#
|
1106
|
+
# * PLATFORM
|
1107
|
+
#
|
1108
|
+
# * REGION
|
1109
|
+
#
|
1110
|
+
# * SERVICE
|
1111
|
+
#
|
1112
|
+
# * SCOPE
|
1113
|
+
#
|
1114
|
+
# * TENANCY
|
1115
|
+
#
|
1032
1116
|
# `GetReservationUtilization` uses the same ` Expression ` object as
|
1033
1117
|
# the other operations, but only `AND` is supported among each
|
1034
|
-
# dimension, and nesting is supported to only one level deep. If
|
1035
|
-
# are multiple values for a dimension, they are OR'd together.
|
1118
|
+
# dimension, and nesting is supported up to only one level deep. If
|
1119
|
+
# there are multiple values for a dimension, they are OR'd together.
|
1036
1120
|
# @return [Types::Expression]
|
1037
1121
|
#
|
1038
1122
|
# @!attribute [rw] next_page_token
|
@@ -1199,10 +1283,15 @@ module Aws::CostExplorer
|
|
1199
1283
|
# The EC2 instances that AWS recommends that you purchase.
|
1200
1284
|
# @return [Types::EC2InstanceDetails]
|
1201
1285
|
#
|
1286
|
+
# @!attribute [rw] rds_instance_details
|
1287
|
+
# The RDS instances that AWS recommends that you purchase.
|
1288
|
+
# @return [Types::RDSInstanceDetails]
|
1289
|
+
#
|
1202
1290
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/InstanceDetails AWS API Documentation
|
1203
1291
|
#
|
1204
1292
|
class InstanceDetails < Struct.new(
|
1205
|
-
:ec2_instance_details
|
1293
|
+
:ec2_instance_details,
|
1294
|
+
:rds_instance_details)
|
1206
1295
|
include Aws::Structure
|
1207
1296
|
end
|
1208
1297
|
|
@@ -1224,6 +1313,56 @@ module Aws::CostExplorer
|
|
1224
1313
|
include Aws::Structure
|
1225
1314
|
end
|
1226
1315
|
|
1316
|
+
# Details about the RDS instances that AWS recommends that you purchase.
|
1317
|
+
#
|
1318
|
+
# @!attribute [rw] family
|
1319
|
+
# The instance family of the recommended reservation.
|
1320
|
+
# @return [String]
|
1321
|
+
#
|
1322
|
+
# @!attribute [rw] instance_type
|
1323
|
+
# The type of instance that AWS recommends.
|
1324
|
+
# @return [String]
|
1325
|
+
#
|
1326
|
+
# @!attribute [rw] region
|
1327
|
+
# The AWS Region of the recommended reservation.
|
1328
|
+
# @return [String]
|
1329
|
+
#
|
1330
|
+
# @!attribute [rw] database_engine
|
1331
|
+
# The database engine that the recommended reservation supports.
|
1332
|
+
# @return [String]
|
1333
|
+
#
|
1334
|
+
# @!attribute [rw] deployment_option
|
1335
|
+
# Whether the recommendation is for a reservation in a single
|
1336
|
+
# availability zone or a reservation with a backup in a second
|
1337
|
+
# availability zone.
|
1338
|
+
# @return [String]
|
1339
|
+
#
|
1340
|
+
# @!attribute [rw] license_model
|
1341
|
+
# The license model that the recommended reservation supports.
|
1342
|
+
# @return [String]
|
1343
|
+
#
|
1344
|
+
# @!attribute [rw] current_generation
|
1345
|
+
# Whether the recommendation is for a current generation instance.
|
1346
|
+
# @return [Boolean]
|
1347
|
+
#
|
1348
|
+
# @!attribute [rw] size_flex_eligible
|
1349
|
+
# Whether the recommended reservation is size flexible.
|
1350
|
+
# @return [Boolean]
|
1351
|
+
#
|
1352
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/RDSInstanceDetails AWS API Documentation
|
1353
|
+
#
|
1354
|
+
class RDSInstanceDetails < Struct.new(
|
1355
|
+
:family,
|
1356
|
+
:instance_type,
|
1357
|
+
:region,
|
1358
|
+
:database_engine,
|
1359
|
+
:deployment_option,
|
1360
|
+
:license_model,
|
1361
|
+
:current_generation,
|
1362
|
+
:size_flex_eligible)
|
1363
|
+
include Aws::Structure
|
1364
|
+
end
|
1365
|
+
|
1227
1366
|
# The aggregated numbers for your RI usage.
|
1228
1367
|
#
|
1229
1368
|
# @!attribute [rw] utilization_percentage
|
@@ -1401,8 +1540,8 @@ module Aws::CostExplorer
|
|
1401
1540
|
# @return [String]
|
1402
1541
|
#
|
1403
1542
|
# @!attribute [rw] estimated_reservation_cost_for_lookback_period
|
1404
|
-
# How much AWS estimates that you spent
|
1405
|
-
# the specified historical period.
|
1543
|
+
# How much AWS estimates that you would have spent for all usage
|
1544
|
+
# during the specified historical period if you had had a reservation.
|
1406
1545
|
# @return [String]
|
1407
1546
|
#
|
1408
1547
|
# @!attribute [rw] upfront_cost
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: aws-sdk-costexplorer
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.3.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2018-
|
11
|
+
date: 2018-04-19 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: aws-sdk-core
|