AWS SDK Version 3 for .NET
API Reference

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.

The DeleteHIT operation is used to delete HIT that is no longer needed. Only the Requester who created the HIT can delete it.

You can only dispose of HITs that are in the Reviewable state, with all of their submitted assignments already either approved or rejected. If you call the DeleteHIT operation on a HIT that is not in the Reviewable state (for example, that has not expired, or still has active assignments), or on a HIT that is Reviewable but without all of its submitted assignments already approved or rejected, the service will return an error.

  • HITs are automatically disposed of after 120 days.

  • After you dispose of a HIT, you can no longer approve the HIT's rejected assignments.

  • Disposed HITs are not returned in results for the ListHITs operation.

  • Disposing HITs can improve the performance of operations such as ListReviewableHITs and ListHITs.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginDeleteHIT and EndDeleteHIT.

Namespace: Amazon.MTurk
Assembly: AWSSDK.MTurk.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<DeleteHITResponse> DeleteHITAsync(
         DeleteHITRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.MTurk.Model.DeleteHITRequest

Container for the necessary parameters to execute the DeleteHIT service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the DeleteHIT service method, as returned by MTurk.

Exceptions

ExceptionCondition
RequestErrorException Your request is invalid.
ServiceException Amazon Mechanical Turk is temporarily unable to process your request. Try your call again.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also