aws-sdk-costandusagereportservice 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cc8a1462383c61981f7d8f2b167fe28716f913a7
-  data.tar.gz: 9a6f709588d066d3b4044e1a9eeb5b0b8b35ae3c
+  metadata.gz: 3daaf964f175d7a50b3d5d8364e8197f72c44b63
+  data.tar.gz: 8fe3e8fae66d108dfe4d6d770896944faa80e6d1
 SHA512:
-  metadata.gz: 757e59f747b272b29dd017259adfa489222828259bc5c1449a40bd66227b5a9cb10d17817b13006051932b07347c3bf61213152bcd523d194618bd2c7988cb3b
-  data.tar.gz: b2820980e0e210eda27bdc416f97dd9bab2fa7a1276ea7caa47422f715d1af2d7beac3ac7aa595ce4979b1decac2a4953236c023929c2bec407c94a17dca9f9f
+  metadata.gz: 77a425de926b538896788798ed7b418c8fad613b069f99781f034acc174166d4a0b8c3af70d947f03cd5d0ff44990423bb568c21e355a9770e4448b2a3914cd6
+  data.tar.gz: 84a2e769535241cd1ed5ed680209d077b3e205c1260193afcd3f246419f6e86bb27c5f4bf6bc93dbe2f25da9b2adc68d4652b2f0aab6e35e35686ae4baa4dd68

data/lib/aws-sdk-costandusagereportservice.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-costandusagereportservice/customizations'
 # @service
 module Aws::CostandUsageReportService
 
-  GEM_VERSION = '1.6.0'
+  GEM_VERSION = '1.7.0'
 
 end

data/lib/aws-sdk-costandusagereportservice/client.rb

@@ -215,16 +215,25 @@ module Aws::CostandUsageReportService
 
     # @!group API Operations
 
-    # Delete a specified report definition
+    # Deletes the specified report.
     #
     # @option params [String] :report_name
-    #   Preferred name for a report, it has to be unique. Must starts with a
-    #   number/letter, case sensitive. Limited to 256 characters.
+    #   The name of the report that you want to create. The name must be
+    #   unique, is case sensitive, and can't include spaces.
     #
     # @return [Types::DeleteReportDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteReportDefinitionResponse#response_message #response_message} => String
     #
+    #
+    # @example Example: To delete the AWS Cost and Usage report named ExampleReport.
+    #
+    #   # The following example deletes the AWS Cost and Usage report named ExampleReport.
+    #
+    #   resp = client.delete_report_definition({
+    #     report_name: "ExampleReport", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_report_definition({
@@ -244,10 +253,10 @@ module Aws::CostandUsageReportService
       req.send_request(options)
     end
 
-    # Describe a list of report definitions owned by the account
+    # Lists the AWS Cost and Usage reports available to this account.
     #
     # @option params [Integer] :max_results
-    #   The max number of results returned by the operation.
+    #   The maximum number of results that AWS returns for the operation.
     #
     # @option params [String] :next_token
     #   A generic string.
@@ -257,6 +266,51 @@ module Aws::CostandUsageReportService
     #   * {Types::DescribeReportDefinitionsResponse#report_definitions #report_definitions} => Array<Types::ReportDefinition>
     #   * {Types::DescribeReportDefinitionsResponse#next_token #next_token} => String
     #
+    #
+    # @example Example: To list the AWS Cost and Usage reports for the account.
+    #
+    #   # The following example lists the AWS Cost and Usage reports for the account.
+    #
+    #   resp = client.describe_report_definitions({
+    #     max_results: 5, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     report_definitions: [
+    #       {
+    #         additional_artifacts: [
+    #           "QUICKSIGHT", 
+    #         ], 
+    #         additional_schema_elements: [
+    #           "RESOURCES", 
+    #         ], 
+    #         compression: "GZIP", 
+    #         format: "textORcsv", 
+    #         report_name: "ExampleReport", 
+    #         s3_bucket: "example-s3-bucket", 
+    #         s3_prefix: "exampleprefix", 
+    #         s3_region: "us-east-1", 
+    #         time_unit: "HOURLY", 
+    #       }, 
+    #       {
+    #         additional_artifacts: [
+    #           "QUICKSIGHT", 
+    #         ], 
+    #         additional_schema_elements: [
+    #           "RESOURCES", 
+    #         ], 
+    #         compression: "GZIP", 
+    #         format: "textORcsv", 
+    #         report_name: "ExampleReport2", 
+    #         s3_bucket: "example-s3-bucket", 
+    #         s3_prefix: "exampleprefix", 
+    #         s3_region: "us-east-1", 
+    #         time_unit: "HOURLY", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_report_definitions({
@@ -269,15 +323,17 @@ module Aws::CostandUsageReportService
     #   resp.report_definitions #=> Array
     #   resp.report_definitions[0].report_name #=> String
     #   resp.report_definitions[0].time_unit #=> String, one of "HOURLY", "DAILY"
-    #   resp.report_definitions[0].format #=> String, one of "textORcsv"
-    #   resp.report_definitions[0].compression #=> String, one of "ZIP", "GZIP"
+    #   resp.report_definitions[0].format #=> String, one of "textORcsv", "Parquet"
+    #   resp.report_definitions[0].compression #=> String, one of "ZIP", "GZIP", "Parquet"
     #   resp.report_definitions[0].additional_schema_elements #=> Array
     #   resp.report_definitions[0].additional_schema_elements[0] #=> String, one of "RESOURCES"
     #   resp.report_definitions[0].s3_bucket #=> String
     #   resp.report_definitions[0].s3_prefix #=> String
-    #   resp.report_definitions[0].s3_region #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-central-1", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1"
+    #   resp.report_definitions[0].s3_region #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-central-1", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "eu-north-1", "ap-northeast-3"
     #   resp.report_definitions[0].additional_artifacts #=> Array
-    #   resp.report_definitions[0].additional_artifacts[0] #=> String, one of "REDSHIFT", "QUICKSIGHT"
+    #   resp.report_definitions[0].additional_artifacts[0] #=> String, one of "REDSHIFT", "QUICKSIGHT", "ATHENA"
+    #   resp.report_definitions[0].refresh_closed_reports #=> Boolean
+    #   resp.report_definitions[0].report_versioning #=> String, one of "CREATE_NEW_REPORT", "OVERWRITE_REPORT"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DescribeReportDefinitions AWS API Documentation
@@ -289,28 +345,53 @@ module Aws::CostandUsageReportService
       req.send_request(options)
     end
 
-    # Create a new report definition
+    # Creates a new report using the description that you provide.
     #
     # @option params [required, Types::ReportDefinition] :report_definition
-    #   The definition of AWS Cost and Usage Report. Customer can specify the
-    #   report name, time unit, report format, compression format, S3 bucket
-    #   and additional artifacts and schema elements in the definition.
+    #   Represents the output of the PutReportDefinition operation. The
+    #   content consists of the detailed metadata and data file information.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To create a report named ExampleReport.
+    #
+    #   # The following example creates a AWS Cost and Usage report named ExampleReport.
+    #
+    #   resp = client.put_report_definition({
+    #     report_definition: {
+    #       additional_artifacts: [
+    #         "REDSHIFT", 
+    #         "QUICKSIGHT", 
+    #       ], 
+    #       additional_schema_elements: [
+    #         "RESOURCES", 
+    #       ], 
+    #       compression: "ZIP", 
+    #       format: "textORcsv", 
+    #       report_name: "ExampleReport", 
+    #       s3_bucket: "example-s3-bucket", 
+    #       s3_prefix: "exampleprefix", 
+    #       s3_region: "us-east-1", 
+    #       time_unit: "DAILY", 
+    #     }, 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_report_definition({
     #     report_definition: { # required
     #       report_name: "ReportName", # required
     #       time_unit: "HOURLY", # required, accepts HOURLY, DAILY
-    #       format: "textORcsv", # required, accepts textORcsv
-    #       compression: "ZIP", # required, accepts ZIP, GZIP
+    #       format: "textORcsv", # required, accepts textORcsv, Parquet
+    #       compression: "ZIP", # required, accepts ZIP, GZIP, Parquet
     #       additional_schema_elements: ["RESOURCES"], # required, accepts RESOURCES
     #       s3_bucket: "S3Bucket", # required
     #       s3_prefix: "S3Prefix", # required
-    #       s3_region: "us-east-1", # required, accepts us-east-1, us-west-1, us-west-2, eu-central-1, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1
-    #       additional_artifacts: ["REDSHIFT"], # accepts REDSHIFT, QUICKSIGHT
+    #       s3_region: "us-east-1", # required, accepts us-east-1, us-west-1, us-west-2, eu-central-1, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, eu-north-1, ap-northeast-3
+    #       additional_artifacts: ["REDSHIFT"], # accepts REDSHIFT, QUICKSIGHT, ATHENA
+    #       refresh_closed_reports: false,
+    #       report_versioning: "CREATE_NEW_REPORT", # accepts CREATE_NEW_REPORT, OVERWRITE_REPORT
     #     },
     #   })
     #
@@ -336,7 +417,7 @@ module Aws::CostandUsageReportService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costandusagereportservice'
-      context[:gem_version] = '1.6.0'
+      context[:gem_version] = '1.7.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-costandusagereportservice/client_api.rb

@@ -27,11 +27,13 @@ module Aws::CostandUsageReportService
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
     PutReportDefinitionRequest = Shapes::StructureShape.new(name: 'PutReportDefinitionRequest')
     PutReportDefinitionResponse = Shapes::StructureShape.new(name: 'PutReportDefinitionResponse')
+    RefreshClosedReports = Shapes::BooleanShape.new(name: 'RefreshClosedReports')
     ReportDefinition = Shapes::StructureShape.new(name: 'ReportDefinition')
     ReportDefinitionList = Shapes::ListShape.new(name: 'ReportDefinitionList')
     ReportFormat = Shapes::StringShape.new(name: 'ReportFormat')
     ReportLimitReachedException = Shapes::StructureShape.new(name: 'ReportLimitReachedException')
     ReportName = Shapes::StringShape.new(name: 'ReportName')
+    ReportVersioning = Shapes::StringShape.new(name: 'ReportVersioning')
     S3Bucket = Shapes::StringShape.new(name: 'S3Bucket')
     S3Prefix = Shapes::StringShape.new(name: 'S3Prefix')
     SchemaElement = Shapes::StringShape.new(name: 'SchemaElement')
@@ -69,6 +71,8 @@ module Aws::CostandUsageReportService
     ReportDefinition.add_member(:s3_prefix, Shapes::ShapeRef.new(shape: S3Prefix, required: true, location_name: "S3Prefix"))
     ReportDefinition.add_member(:s3_region, Shapes::ShapeRef.new(shape: AWSRegion, required: true, location_name: "S3Region"))
     ReportDefinition.add_member(:additional_artifacts, Shapes::ShapeRef.new(shape: AdditionalArtifactList, location_name: "AdditionalArtifacts"))
+    ReportDefinition.add_member(:refresh_closed_reports, Shapes::ShapeRef.new(shape: RefreshClosedReports, location_name: "RefreshClosedReports"))
+    ReportDefinition.add_member(:report_versioning, Shapes::ShapeRef.new(shape: ReportVersioning, location_name: "ReportVersioning"))
     ReportDefinition.struct_class = Types::ReportDefinition
 
     ReportDefinitionList.member = Shapes::ShapeRef.new(shape: ReportDefinition)
@@ -87,6 +91,7 @@ module Aws::CostandUsageReportService
         "jsonVersion" => "1.1",
         "protocol" => "json",
         "serviceFullName" => "AWS Cost and Usage Report Service",
+        "serviceId" => "Cost and Usage Report Service",
         "signatureVersion" => "v4",
         "signingName" => "cur",
         "targetPrefix" => "AWSOrigamiServiceGatewayService",

data/lib/aws-sdk-costandusagereportservice/types.rb

@@ -8,7 +8,7 @@
 module Aws::CostandUsageReportService
   module Types
 
-    # Request of DeleteReportDefinition
+    # Deletes the specified report.
     #
     # @note When making an API call, you may pass DeleteReportDefinitionRequest
     #   data as a hash:
@@ -18,8 +18,8 @@ module Aws::CostandUsageReportService
     #       }
     #
     # @!attribute [rw] report_name
-    #   Preferred name for a report, it has to be unique. Must starts with a
-    #   number/letter, case sensitive. Limited to 256 characters.
+    #   The name of the report that you want to create. The name must be
+    #   unique, is case sensitive, and can't include spaces.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DeleteReportDefinitionRequest AWS API Documentation
@@ -29,10 +29,11 @@ module Aws::CostandUsageReportService
       include Aws::Structure
     end
 
-    # Response of DeleteReportDefinition
+    # If the action is successful, the service sends back an HTTP 200
+    # response.
     #
     # @!attribute [rw] response_message
-    #   A message indicates if the deletion is successful.
+    #   Whether the deletion was successful or not.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DeleteReportDefinitionResponse AWS API Documentation
@@ -42,7 +43,7 @@ module Aws::CostandUsageReportService
       include Aws::Structure
     end
 
-    # Request of DescribeReportDefinitions
+    # Requests a list of AWS Cost and Usage reports owned by the account.
     #
     # @note When making an API call, you may pass DescribeReportDefinitionsRequest
     #   data as a hash:
@@ -53,7 +54,7 @@ module Aws::CostandUsageReportService
     #       }
     #
     # @!attribute [rw] max_results
-    #   The max number of results returned by the operation.
+    #   The maximum number of results that AWS returns for the operation.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -68,10 +69,11 @@ module Aws::CostandUsageReportService
       include Aws::Structure
     end
 
-    # Response of DescribeReportDefinitions
+    # If the action is successful, the service sends back an HTTP 200
+    # response.
     #
     # @!attribute [rw] report_definitions
-    #   A list of report definitions.
+    #   A list of AWS Cost and Usage reports owned by the account.
     #   @return [Array<Types::ReportDefinition>]
     #
     # @!attribute [rw] next_token
@@ -86,7 +88,7 @@ module Aws::CostandUsageReportService
       include Aws::Structure
     end
 
-    # Request of PutReportDefinition
+    # Creates a Cost and Usage Report.
     #
     # @note When making an API call, you may pass PutReportDefinitionRequest
     #   data as a hash:
@@ -95,21 +97,21 @@ module Aws::CostandUsageReportService
     #         report_definition: { # required
     #           report_name: "ReportName", # required
     #           time_unit: "HOURLY", # required, accepts HOURLY, DAILY
-    #           format: "textORcsv", # required, accepts textORcsv
-    #           compression: "ZIP", # required, accepts ZIP, GZIP
+    #           format: "textORcsv", # required, accepts textORcsv, Parquet
+    #           compression: "ZIP", # required, accepts ZIP, GZIP, Parquet
     #           additional_schema_elements: ["RESOURCES"], # required, accepts RESOURCES
     #           s3_bucket: "S3Bucket", # required
     #           s3_prefix: "S3Prefix", # required
-    #           s3_region: "us-east-1", # required, accepts us-east-1, us-west-1, us-west-2, eu-central-1, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1
-    #           additional_artifacts: ["REDSHIFT"], # accepts REDSHIFT, QUICKSIGHT
+    #           s3_region: "us-east-1", # required, accepts us-east-1, us-west-1, us-west-2, eu-central-1, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, eu-north-1, ap-northeast-3
+    #           additional_artifacts: ["REDSHIFT"], # accepts REDSHIFT, QUICKSIGHT, ATHENA
+    #           refresh_closed_reports: false,
+    #           report_versioning: "CREATE_NEW_REPORT", # accepts CREATE_NEW_REPORT, OVERWRITE_REPORT
     #         },
     #       }
     #
     # @!attribute [rw] report_definition
-    #   The definition of AWS Cost and Usage Report. Customer can specify
-    #   the report name, time unit, report format, compression format, S3
-    #   bucket and additional artifacts and schema elements in the
-    #   definition.
+    #   Represents the output of the PutReportDefinition operation. The
+    #   content consists of the detailed metadata and data file information.
     #   @return [Types::ReportDefinition]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/PutReportDefinitionRequest AWS API Documentation
@@ -119,15 +121,16 @@ module Aws::CostandUsageReportService
       include Aws::Structure
     end
 
-    # Response of PutReportDefinition
+    # If the action is successful, the service sends back an HTTP 200
+    # response with an empty HTTP body.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/PutReportDefinitionResponse AWS API Documentation
     #
     class PutReportDefinitionResponse < Aws::EmptyStructure; end
 
-    # The definition of AWS Cost and Usage Report. Customer can specify the
-    # report name, time unit, report format, compression format, S3 bucket
-    # and additional artifacts and schema elements in the definition.
+    # The definition of AWS Cost and Usage Report. You can specify the
+    # report name, time unit, report format, compression format, S3 bucket,
+    # additional artifacts, and schema elements in the definition.
     #
     # @note When making an API call, you may pass ReportDefinition
     #   data as a hash:
@@ -135,52 +138,70 @@ module Aws::CostandUsageReportService
     #       {
     #         report_name: "ReportName", # required
     #         time_unit: "HOURLY", # required, accepts HOURLY, DAILY
-    #         format: "textORcsv", # required, accepts textORcsv
-    #         compression: "ZIP", # required, accepts ZIP, GZIP
+    #         format: "textORcsv", # required, accepts textORcsv, Parquet
+    #         compression: "ZIP", # required, accepts ZIP, GZIP, Parquet
     #         additional_schema_elements: ["RESOURCES"], # required, accepts RESOURCES
     #         s3_bucket: "S3Bucket", # required
     #         s3_prefix: "S3Prefix", # required
-    #         s3_region: "us-east-1", # required, accepts us-east-1, us-west-1, us-west-2, eu-central-1, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1
-    #         additional_artifacts: ["REDSHIFT"], # accepts REDSHIFT, QUICKSIGHT
+    #         s3_region: "us-east-1", # required, accepts us-east-1, us-west-1, us-west-2, eu-central-1, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, eu-north-1, ap-northeast-3
+    #         additional_artifacts: ["REDSHIFT"], # accepts REDSHIFT, QUICKSIGHT, ATHENA
+    #         refresh_closed_reports: false,
+    #         report_versioning: "CREATE_NEW_REPORT", # accepts CREATE_NEW_REPORT, OVERWRITE_REPORT
     #       }
     #
     # @!attribute [rw] report_name
-    #   Preferred name for a report, it has to be unique. Must starts with a
-    #   number/letter, case sensitive. Limited to 256 characters.
+    #   The name of the report that you want to create. The name must be
+    #   unique, is case sensitive, and can't include spaces.
     #   @return [String]
     #
     # @!attribute [rw] time_unit
-    #   The frequency on which report data are measured and displayed.
+    #   The length of time covered by the report.
     #   @return [String]
     #
     # @!attribute [rw] format
-    #   Preferred format for report.
+    #   The format that AWS saves the report in.
     #   @return [String]
     #
     # @!attribute [rw] compression
-    #   Preferred compression format for report.
+    #   The compression format that AWS uses for the report.
     #   @return [String]
     #
     # @!attribute [rw] additional_schema_elements
-    #   A list of schema elements.
+    #   A list of strings that indicate additional content that Amazon Web
+    #   Services includes in the report, such as individual resource IDs.
     #   @return [Array<String>]
     #
     # @!attribute [rw] s3_bucket
-    #   Name of customer S3 bucket.
+    #   The S3 bucket where AWS delivers the report.
     #   @return [String]
     #
     # @!attribute [rw] s3_prefix
-    #   Preferred report path prefix. Limited to 256 characters.
+    #   The prefix that AWS adds to the report name when AWS delivers the
+    #   report. Your prefix can't include spaces.
     #   @return [String]
     #
     # @!attribute [rw] s3_region
-    #   Region of customer S3 bucket.
+    #   The region of the S3 bucket that AWS delivers the report into.
     #   @return [String]
     #
     # @!attribute [rw] additional_artifacts
-    #   A list of additional artifacts.
+    #   A list of manifests that you want Amazon Web Services to create for
+    #   this report.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] refresh_closed_reports
+    #   Whether you want Amazon Web Services to update your reports after
+    #   they have been finalized if Amazon Web Services detects charges
+    #   related to previous months. These charges can include refunds,
+    #   credits, or support fees.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] report_versioning
+    #   Whether you want Amazon Web Services to overwrite the previous
+    #   version of each report or to deliver the report in addition to the
+    #   previous versions.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/ReportDefinition AWS API Documentation
     #
     class ReportDefinition < Struct.new(
@@ -192,7 +213,9 @@ module Aws::CostandUsageReportService
       :s3_bucket,
       :s3_prefix,
       :s3_region,
-      :additional_artifacts)
+      :additional_artifacts,
+      :refresh_closed_reports,
+      :report_versioning)
       include Aws::Structure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costandusagereportservice
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-20 00:00:00.000000000 Z
+date: 2019-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core