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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 87fd4ca3923fa05af050f055cd46350ecaee4e56
4
- data.tar.gz: 922c2e493f0550c59285e6f6a19317bcc1d36942
3
+ metadata.gz: 47c8a1aee41cfbbeac27c6dcfebb7bdce048744c
4
+ data.tar.gz: 23eda2491bcade6dd9b524fa0f7f19549e5daffe
5
5
  SHA512:
6
- metadata.gz: 9488f467344b8eb01fb3ce1bae4b8324ee6725313b0e7a14dfdad98e6a7df633908b131a95f4f31d0491b0b7a311a1b74144ed304ef3d9794bac5d8851412255
7
- data.tar.gz: 2d9b78663c7e2b68eea6c2ce794662ce3bc51b5438f35c9fc4c85d61f92072192a421ae05d51a6848ae51d2c1fa9c69e9c1016a7251588404113b57986c6d3c3
6
+ metadata.gz: 9df66e5162344323b0dffa6cec5dc9403021b9903136f462bf43cd85cedcd6e0e09795db956ce73fd8d71d5b770055085e08671312e59c4a5ac38b6828e8803b
7
+ data.tar.gz: c540020a0e135a4b95dd474a1c3b36decf8c4bb998b41d631e4b7fbb64e06520f7c12a64c4c6264a26e2e7ef981493f529423581c3980852252047ab97b0e065
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
42
42
  # @service
43
43
  module Aws::CostExplorer
44
44
 
45
- GEM_VERSION = '1.2.0'
45
+ GEM_VERSION = '1.3.0'
46
46
 
47
47
  end
@@ -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 specific filter over 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 `CostAndUsage`, you can use the following
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
- # * INSTANCE\_TYPE - The type of instance. An example is an EC2
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
- # `DataTransfer-In-Bytes`. The response for the `GetDimensionValues`
354
- # operation includes a unit attribute, examples of which include GB
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
- # * INSTANCE\_TYPE - The type of instance. An example is an EC2
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 specific combination of operating system, license
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). Values are regional
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 the `Granularity`,
486
- # either `MONTHLY` or `DAILY`.
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 specific service, such as EC2, that you want recommendations for.
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
- # You can retrieve the reservation utilization for your account. Master
719
- # accounts in an organization in AWS Organizations have access to their
720
- # associated member accounts. You can filter data by dimensions in a
721
- # time period. You can use `GetDimensionValues` to determine the
722
- # possible dimension values. Currently, you can group only by
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 reserve instance (RI)
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 the `Granularity`,
739
- # either `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity`
740
- # aren't set, `GetReservationUtilization` defaults to `DAILY`.
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 using different dimensions.
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 multiple
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
- # You can query for available tag keys and tag values for a specified
834
- # period. You can search the tag values for an arbitrary string.
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.2.0'
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 `CostAndUsage`, you can use the following
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
- # * INSTANCE\_TYPE - The type of instance. An example is an EC2
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
- # `DataTransfer-In-Bytes`. The response for the `GetDimensionValues`
590
- # operation includes a unit attribute, examples of which include GB
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
- # * INSTANCE\_TYPE - The type of instance. An example is an EC2
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 specific combination of operating system, license
613
- # model, and software on an instance. For example, a Windows
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). Values are regional
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 `CostAndUsage`, you can use the following
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
- # * INSTANCE\_TYPE - The type of instance. An example is an EC2
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
- # `DataTransfer-In-Bytes`. The response for the `GetDimensionValues`
670
- # operation includes a unit attribute, examples of which include GB
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
- # * INSTANCE\_TYPE - The type of instance. An example is an EC2
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 specific combination of operating system, license
693
- # model, and software on an instance. For example, a Windows
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). Values are regional
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 the `Granularity`,
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 specific service, such as EC2, that you want recommendations
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 reserve instance (RI)
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 the `Granularity`,
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 using different dimensions.
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 there
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 on Reserved Instances during
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.2.0
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-03-20 00:00:00.000000000 Z
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