aws-sdk-costexplorer 1.2.0 → 1.3.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|