AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Used by workers to retrieve a task (with the specified activity ARN) which has been
scheduled for execution by a running state machine. This initiates a long poll, where
the service holds the HTTP connection open and responds as soon as a task becomes
available (i.e. an execution of a task of this type is needed.) The maximum time the
service holds on to the request before responding is 60 seconds. If no task is available
within 60 seconds, the poll returns a
This API action isn't logged in CloudTrail.
Workers should set their client side socket timeout to at least 65 seconds (5 seconds
higher than the maximum time the service may hold the poll request).
Polling with taskToken with a null string.
GetActivityTask can cause latency in some implementations. See
Avoid
Latency When Polling for Activity Tasks in the Step Functions Developer Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to GetActivityTaskAsync.
Namespace: Amazon.StepFunctions
Assembly: AWSSDK.StepFunctions.dll
Version: 3.x.y.z
public abstract GetActivityTaskResponse GetActivityTask( GetActivityTaskRequest request )
Container for the necessary parameters to execute the GetActivityTask service method.
| Exception | Condition |
|---|---|
| ActivityDoesNotExistException | The specified activity does not exist. |
| ActivityWorkerLimitExceededException | The maximum number of workers concurrently polling for activity tasks has been reached. |
| InvalidArnException | The provided Amazon Resource Name (ARN) is not valid. |
| KmsAccessDeniedException | Either your KMS key policy or API caller does not have the required permissions. |
| KmsInvalidStateException | The KMS key is not in valid state, for example: Disabled or Deleted. |
| KmsThrottlingException | Received when KMS returns ThrottlingException for a KMS call that Step Functions makes on behalf of the caller. |
.NET Framework:
Supported in: 4.5 and newer, 3.5