aws-sdk-states 1.24.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 46d7008b51a839196c60ec15f8d5cee92d73d522
-  data.tar.gz: 50d3aec12060bca51551bdc0fad91793402bb8fb
+  metadata.gz: 54826692697e74b50e190c0e99dd2a805d840f37
+  data.tar.gz: a0ec640131dcfda401c83058bd6d10e7896b5f39
 SHA512:
-  metadata.gz: 3054e9bc0314f5034f210e1864a88a30fefc5a567a6cce52c0d5bb7db95db49d86e96d228115a03f3e16bc56088920a3b78458ceba18f567e404790755b2fc43
-  data.tar.gz: 922990a459ae54371f39b39735397725076e3590ea699d5a92928496edb3fd732abfe1ce51cf5842f601f9b1a7e6ca3aa8be50f88c3c63c744b9f7ff9943be85
+  metadata.gz: 911fafc972a8b3a3e83ac3f513b22b8ebfe37de5ab43a25bdf2ee082f278d4b278dbba3185776b3eff62f6efee0bcccbfbb240d76d8fca5fc212760e8188fcca
+  data.tar.gz: 9d45d1e1d8d8f84e963a549e37513af85de01bee54bd13019957a3f176cc7bddfbc39140eae7d3d3e4a6f8e4af2a409fb6809ba4551106dbbb7a85d662ddb463

data/lib/aws-sdk-states.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-states/customizations'
 # @service
 module Aws::States
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.25.0'
 
 end

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

@@ -305,6 +305,9 @@ module Aws::States
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
     #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/limits.html#service-limits-state-machine-executions
@@ -359,7 +362,8 @@ module Aws::States
     # states that can do work (`Task` states), determine to which states to
     # transition next (`Choice` states), stop an execution with an error
     # (`Fail` states), and so on. State machines are specified using a
-    # JSON-based, structured language.
+    # JSON-based, structured language. For more information, see [Amazon
+    # States Language][1] in the AWS Step Functions User Guide.
     #
     # <note markdown="1"> This operation is eventually consistent. The results are best effort
     # and may not reflect very recent updates and changes.
@@ -369,14 +373,18 @@ module Aws::States
     # <note markdown="1"> `CreateStateMachine` is an idempotent API. Subsequent requests won’t
     # create a duplicate resource if it was already created.
     # `CreateStateMachine`'s idempotency check is based on the state
-    # machine `name` and `definition`. If a following request has a
-    # different `roleArn` or `tags`, Step Functions will ignore these
-    # differences and treat it as an idempotent request of the previous. In
-    # this case, `roleArn` and `tags` will not be updated, even if they are
-    # different.
+    # machine `name`, `definition`, `type`, and `LoggingConfiguration`. If a
+    # following request has a different `roleArn` or `tags`, Step Functions
+    # will ignore these differences and treat it as an idempotent request of
+    # the previous. In this case, `roleArn` and `tags` will not be updated,
+    # even if they are different.
     #
     #  </note>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html
+    #
     # @option params [required, String] :name
     #   The name of the state machine.
     #
@@ -392,6 +400,9 @@ module Aws::States
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
     #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
+    #
     # @option params [required, String] :definition
     #   The Amazon States Language definition of the state machine. See
     #   [Amazon States Language][1].
@@ -405,13 +416,23 @@ module Aws::States
     #   machine.
     #
     # @option params [String] :type
-    #   Determines whether a Standard or Express state machine is created. If
-    #   not set, Standard is created.
+    #   Determines whether a Standard or Express state machine is created. The
+    #   default is `STANDARD`. You cannot update the `type` of a state machine
+    #   once it has been created.
     #
     # @option params [Types::LoggingConfiguration] :logging_configuration
     #   Defines what execution history events are logged and where they are
     #   logged.
     #
+    #   <note markdown="1"> By default, the `level` is set to `OFF`. For more information see [Log
+    #   Levels][1] in the AWS Step Functions User Guide.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/cloudwatch-log-level.html
+    #
     # @option params [Array<Types::Tag>] :tags
     #   Tags to be added when creating a state machine.
     #
@@ -496,11 +517,11 @@ module Aws::States
 
     # Deletes a state machine. This is an asynchronous operation: It sets
     # the state machine's status to `DELETING` and begins the deletion
-    # process. Each state machine execution is deleted the next time it
-    # makes a state transition.
+    # process.
     #
-    # <note markdown="1"> The state machine itself is deleted after all executions are completed
-    # or deleted.
+    # <note markdown="1"> For `EXPRESS`state machines, the deletion will happen eventually
+    # (usually less than a minute). Running executions may emit logs after
+    # `DeleteStateMachine` API is called.
     #
     #  </note>
     #
@@ -568,6 +589,8 @@ module Aws::States
     #
     #  </note>
     #
+    # This API action is not supported by `EXPRESS` state machines.
+    #
     # @option params [required, String] :execution_arn
     #   The Amazon Resource Name (ARN) of the execution to describe.
     #
@@ -665,6 +688,8 @@ module Aws::States
     #
     #  </note>
     #
+    # This API action is not supported by `EXPRESS` state machines.
+    #
     # @option params [required, String] :execution_arn
     #   The Amazon Resource Name (ARN) of the execution you want state machine
     #   information for.
@@ -676,6 +701,7 @@ module Aws::States
     #   * {Types::DescribeStateMachineForExecutionOutput#definition #definition} => String
     #   * {Types::DescribeStateMachineForExecutionOutput#role_arn #role_arn} => String
     #   * {Types::DescribeStateMachineForExecutionOutput#update_date #update_date} => Time
+    #   * {Types::DescribeStateMachineForExecutionOutput#logging_configuration #logging_configuration} => Types::LoggingConfiguration
     #
     # @example Request syntax with placeholder values
     #
@@ -690,6 +716,10 @@ module Aws::States
     #   resp.definition #=> String
     #   resp.role_arn #=> String
     #   resp.update_date #=> Time
+    #   resp.logging_configuration.level #=> String, one of "ALL", "ERROR", "FATAL", "OFF"
+    #   resp.logging_configuration.include_execution_data #=> Boolean
+    #   resp.logging_configuration.destinations #=> Array
+    #   resp.logging_configuration.destinations[0].cloud_watch_logs_log_group.log_group_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecution AWS API Documentation
     #
@@ -768,6 +798,8 @@ module Aws::States
     # after 24 hours. Using an expired pagination token will return an *HTTP
     # 400 InvalidToken* error.
     #
+    # This API action is not supported by `EXPRESS` state machines.
+    #
     # @option params [required, String] :execution_arn
     #   The Amazon Resource Name (ARN) of the execution.
     #
@@ -972,6 +1004,8 @@ module Aws::States
     #
     #  </note>
     #
+    # This API action is not supported by `EXPRESS` state machines.
+    #
     # @option params [required, String] :state_machine_arn
     #   The Amazon Resource Name (ARN) of the state machine whose executions
     #   is listed.
@@ -1286,6 +1320,9 @@ module Aws::States
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
     #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/limits.html#service-limits-state-machine-executions
@@ -1330,6 +1367,8 @@ module Aws::States
 
     # Stops an execution.
     #
+    # This API action is not supported by `EXPRESS` state machines.
+    #
     # @option params [required, String] :execution_arn
     #   The Amazon Resource Name (ARN) of the execution to stop.
     #
@@ -1438,10 +1477,10 @@ module Aws::States
       req.send_request(options)
     end
 
-    # Updates an existing state machine by modifying its `definition` and/or
-    # `roleArn`. Running executions will continue to use the previous
-    # `definition` and `roleArn`. You must include at least one of
-    # `definition` or `roleArn` or you will receive a
+    # Updates an existing state machine by modifying its `definition`,
+    # `roleArn`, or `loggingConfiguration`. Running executions will continue
+    # to use the previous `definition` and `roleArn`. You must include at
+    # least one of `definition` or `roleArn` or you will receive a
     # `MissingRequiredParameter` error.
     #
     # <note markdown="1"> All `StartExecution` calls within a few seconds will use the updated
@@ -1466,6 +1505,8 @@ module Aws::States
     #   The Amazon Resource Name (ARN) of the IAM role of the state machine.
     #
     # @option params [Types::LoggingConfiguration] :logging_configuration
+    #   The `LoggingConfiguration` data type is used to set CloudWatch Logs
+    #   options.
     #
     # @return [Types::UpdateStateMachineOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1516,7 +1557,7 @@ module Aws::States
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-states'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -252,6 +252,7 @@ module Aws::States
     DescribeStateMachineForExecutionOutput.add_member(:definition, Shapes::ShapeRef.new(shape: Definition, required: true, location_name: "definition"))
     DescribeStateMachineForExecutionOutput.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "roleArn"))
     DescribeStateMachineForExecutionOutput.add_member(:update_date, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "updateDate"))
+    DescribeStateMachineForExecutionOutput.add_member(:logging_configuration, Shapes::ShapeRef.new(shape: LoggingConfiguration, location_name: "loggingConfiguration"))
     DescribeStateMachineForExecutionOutput.struct_class = Types::DescribeStateMachineForExecutionOutput
 
     DescribeStateMachineInput.add_member(:state_machine_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "stateMachineArn"))

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

@@ -71,6 +71,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] creation_date
@@ -244,6 +247,9 @@ module Aws::States
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
     #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/limits.html#service-limits-state-machine-executions
@@ -330,6 +336,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] definition
@@ -348,12 +357,22 @@ module Aws::States
     #
     # @!attribute [rw] type
     #   Determines whether a Standard or Express state machine is created.
-    #   If not set, Standard is created.
+    #   The default is `STANDARD`. You cannot update the `type` of a state
+    #   machine once it has been created.
     #   @return [String]
     #
     # @!attribute [rw] logging_configuration
     #   Defines what execution history events are logged and where they are
     #   logged.
+    #
+    #   <note markdown="1"> By default, the `level` is set to `OFF`. For more information see
+    #   [Log Levels][1] in the AWS Step Functions User Guide.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/cloudwatch-log-level.html
     #   @return [Types::LoggingConfiguration]
     #
     # @!attribute [rw] tags
@@ -481,6 +500,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] creation_date
@@ -515,7 +537,7 @@ module Aws::States
     end
 
     # @!attribute [rw] execution_arn
-    #   The Amazon Resource Name (ARN) that identifies the execution.
+    #   The Amazon Resource Name (ARN) that id entifies the execution.
     #   @return [String]
     #
     # @!attribute [rw] state_machine_arn
@@ -536,6 +558,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -625,6 +650,11 @@ module Aws::States
     #   date.
     #   @return [Time]
     #
+    # @!attribute [rw] logging_configuration
+    #   The `LoggingConfiguration` data type is used to set CloudWatch Logs
+    #   options.
+    #   @return [Types::LoggingConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecutionOutput AWS API Documentation
     #
     class DescribeStateMachineForExecutionOutput < Struct.new(
@@ -632,7 +662,8 @@ module Aws::States
       :name,
       :definition,
       :role_arn,
-      :update_date)
+      :update_date,
+      :logging_configuration)
       include Aws::Structure
     end
 
@@ -672,6 +703,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -694,6 +728,7 @@ module Aws::States
     #   @return [String]
     #
     # @!attribute [rw] type
+    #   The `type` of the state machine (`STANDARD` or `EXPRESS`).
     #   @return [String]
     #
     # @!attribute [rw] creation_date
@@ -701,6 +736,8 @@ module Aws::States
     #   @return [Time]
     #
     # @!attribute [rw] logging_configuration
+    #   The `LoggingConfiguration` data type is used to set CloudWatch Logs
+    #   options.
     #   @return [Types::LoggingConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineOutput AWS API Documentation
@@ -799,7 +836,7 @@ module Aws::States
     # Contains details about an execution.
     #
     # @!attribute [rw] execution_arn
-    #   The Amazon Resource Name (ARN) that identifies the execution.
+    #   The Amazon Resource Name (ARN) that id entifies the execution.
     #   @return [String]
     #
     # @!attribute [rw] state_machine_arn
@@ -820,6 +857,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -1642,6 +1682,9 @@ module Aws::States
       include Aws::Structure
     end
 
+    # The `LoggingConfiguration` data type is used to set CloudWatch Logs
+    # options.
+    #
     # @note When making an API call, you may pass LoggingConfiguration
     #   data as a hash:
     #
@@ -1662,14 +1705,14 @@ module Aws::States
     #   @return [String]
     #
     # @!attribute [rw] include_execution_data
-    #   Determines whether execution history data is included in your log.
-    #   When set to `FALSE`, data is excluded.
+    #   Determines whether execution data is included in your log. When set
+    #   to `FALSE`, data is excluded.
     #   @return [Boolean]
     #
     # @!attribute [rw] destinations
-    #   An object that describes where your execution history events will be
-    #   logged. Limited to size 1. Required, if your log level is not set to
-    #   `OFF`.
+    #   An array of objects that describes where your execution history
+    #   events will be logged. Limited to size 1. Required, if your log
+    #   level is not set to `OFF`.
     #   @return [Array<Types::LogDestination>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/LoggingConfiguration AWS API Documentation
@@ -1878,6 +1921,9 @@ module Aws::States
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
     #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/limits.html#service-limits-state-machine-executions
@@ -1905,7 +1951,7 @@ module Aws::States
     end
 
     # @!attribute [rw] execution_arn
-    #   The Amazon Resource Name (ARN) that identifies the execution.
+    #   The Amazon Resource Name (ARN) that id entifies the execution.
     #   @return [String]
     #
     # @!attribute [rw] start_date
@@ -1954,6 +2000,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] output
@@ -2038,6 +2087,9 @@ module Aws::States
     #   * special characters `` " # % \ ^ | ~ ` $ & , ; : / ``
     #
     #   * control characters (`U+0000-001F`, `U+007F-009F`)
+    #
+    #   To enable logging with CloudWatch Logs, the name should only contain
+    #   0-9, A-Z, a-z, - and \_.
     #   @return [String]
     #
     # @!attribute [rw] type
@@ -2505,6 +2557,8 @@ module Aws::States
     #   @return [String]
     #
     # @!attribute [rw] logging_configuration
+    #   The `LoggingConfiguration` data type is used to set CloudWatch Logs
+    #   options.
     #   @return [Types::LoggingConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineInput AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-states
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-04 00:00:00.000000000 Z
+date: 2020-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core