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.
Implementation for accessing MTurk
Amazon Mechanical Turk API ReferenceNamespace: Amazon.MTurk
Assembly: AWSSDK.MTurk.dll
Version: 3.x.y.z
public class AmazonMTurkClient : AmazonServiceClient IAmazonMTurk, IAmazonService, IDisposable
The AmazonMTurkClient type exposes the following members
Name | Description | |
---|---|---|
AmazonMTurkClient() |
Constructs AmazonMTurkClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration> |
|
AmazonMTurkClient(RegionEndpoint) |
Constructs AmazonMTurkClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration> |
|
AmazonMTurkClient(AmazonMTurkConfig) |
Constructs AmazonMTurkClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration> |
|
AmazonMTurkClient(AWSCredentials) |
Constructs AmazonMTurkClient with AWS Credentials |
|
AmazonMTurkClient(AWSCredentials, RegionEndpoint) |
Constructs AmazonMTurkClient with AWS Credentials |
|
AmazonMTurkClient(AWSCredentials, AmazonMTurkConfig) |
Constructs AmazonMTurkClient with AWS Credentials and an AmazonMTurkClient Configuration object. |
|
AmazonMTurkClient(string, string) |
Constructs AmazonMTurkClient with AWS Access Key ID and AWS Secret Key |
|
AmazonMTurkClient(string, string, RegionEndpoint) |
Constructs AmazonMTurkClient with AWS Access Key ID and AWS Secret Key |
|
AmazonMTurkClient(string, string, AmazonMTurkConfig) |
Constructs AmazonMTurkClient with AWS Access Key ID, AWS Secret Key and an AmazonMTurkClient Configuration object. |
|
AmazonMTurkClient(string, string, string) |
Constructs AmazonMTurkClient with AWS Access Key ID and AWS Secret Key |
|
AmazonMTurkClient(string, string, string, RegionEndpoint) |
Constructs AmazonMTurkClient with AWS Access Key ID and AWS Secret Key |
|
AmazonMTurkClient(string, string, string, AmazonMTurkConfig) |
Constructs AmazonMTurkClient with AWS Access Key ID, AWS Secret Key and an AmazonMTurkClient Configuration object. |
Name | Type | Description | |
---|---|---|---|
Config | Amazon.Runtime.IClientConfig | Inherited from Amazon.Runtime.AmazonServiceClient. | |
Paginators | Amazon.MTurk.Model.IMTurkPaginatorFactory |
Paginators for the service |
Name | Description | |
---|---|---|
AcceptQualificationRequest(AcceptQualificationRequestRequest) |
The Only the owner of the Qualification type can grant a Qualification request for that type.
A successful request for the |
|
AcceptQualificationRequestAsync(AcceptQualificationRequestRequest, CancellationToken) |
The Only the owner of the Qualification type can grant a Qualification request for that type.
A successful request for the |
|
ApproveAssignment(ApproveAssignmentRequest) |
The Approving an assignment initiates two payments from the Requester's Amazon.com account
If the Requester's account does not have adequate funds for these payments, the call to ApproveAssignment returns an exception, and the approval is not processed. You can include an optional feedback message with the approval, which the Worker can see in the Status section of the web site. You can also call this operation for assignments that were previous rejected and approve them by explicitly overriding the previous rejection. This only works on rejected assignments that were submitted within the previous 30 days and only if the assignment's related HIT has not been deleted. |
|
ApproveAssignmentAsync(ApproveAssignmentRequest, CancellationToken) |
The Approving an assignment initiates two payments from the Requester's Amazon.com account
If the Requester's account does not have adequate funds for these payments, the call to ApproveAssignment returns an exception, and the approval is not processed. You can include an optional feedback message with the approval, which the Worker can see in the Status section of the web site. You can also call this operation for assignments that were previous rejected and approve them by explicitly overriding the previous rejection. This only works on rejected assignments that were submitted within the previous 30 days and only if the assignment's related HIT has not been deleted. |
|
AssociateQualificationWithWorker(AssociateQualificationWithWorkerRequest) |
The
You can only assign a Qualification of a Qualification type that you created (using
the
Note: |
|
AssociateQualificationWithWorkerAsync(AssociateQualificationWithWorkerRequest, CancellationToken) |
The
You can only assign a Qualification of a Qualification type that you created (using
the
Note: |
|
CreateAdditionalAssignmentsForHIT(CreateAdditionalAssignmentsForHITRequest) |
The To extend the maximum number of assignments, specify the number of additional assignments.
|
|
CreateAdditionalAssignmentsForHITAsync(CreateAdditionalAssignmentsForHITRequest, CancellationToken) |
The To extend the maximum number of assignments, specify the number of additional assignments.
|
|
CreateHIT(CreateHITRequest) |
The
This operation allows you to specify a new HIT by passing in values for the properties
of the HIT, such as its title, reward amount and number of assignments. When you pass
these values to
An alternative way to create HITs is to first generate a HITTypeID using the
CreateHIT also supports several ways to provide question data: by providing a value
for the If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing. |
|
CreateHITAsync(CreateHITRequest, CancellationToken) |
The
This operation allows you to specify a new HIT by passing in values for the properties
of the HIT, such as its title, reward amount and number of assignments. When you pass
these values to
An alternative way to create HITs is to first generate a HITTypeID using the
CreateHIT also supports several ways to provide question data: by providing a value
for the If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing. |
|
CreateHITType(CreateHITTypeRequest) |
The |
|
CreateHITTypeAsync(CreateHITTypeRequest, CancellationToken) |
The |
|
CreateHITWithHITType(CreateHITWithHITTypeRequest) |
The
This is an alternative way to create HITs from the
CreateHITWithHITType also supports several ways to provide question data: by providing
a value for the If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing. |
|
CreateHITWithHITTypeAsync(CreateHITWithHITTypeRequest, CancellationToken) |
The
This is an alternative way to create HITs from the
CreateHITWithHITType also supports several ways to provide question data: by providing
a value for the If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing. |
|
CreateQualificationType(CreateQualificationTypeRequest) |
The |
|
CreateQualificationTypeAsync(CreateQualificationTypeRequest, CancellationToken) |
The |
|
CreateWorkerBlock(CreateWorkerBlockRequest) |
The |
|
CreateWorkerBlockAsync(CreateWorkerBlockRequest, CancellationToken) |
The |
|
DeleteHIT(DeleteHITRequest) |
The
You can only dispose of HITs that are in the
|
|
DeleteHITAsync(DeleteHITRequest, CancellationToken) |
The
You can only dispose of HITs that are in the
|
|
DeleteQualificationType(DeleteQualificationTypeRequest) |
The This operation does not revoke Qualifications already assigned to Workers because the Qualifications might be needed for active HITs. If there are any pending requests for the Qualification type, Amazon Mechanical Turk rejects those requests. After you delete a Qualification type, you can no longer use it to create HITs or HIT types. DeleteQualificationType must wait for all the HITs that use the deleted Qualification type to be deleted before completing. It may take up to 48 hours before DeleteQualificationType completes and the unique name of the Qualification type is available for reuse with CreateQualificationType. |
|
DeleteQualificationTypeAsync(DeleteQualificationTypeRequest, CancellationToken) |
The This operation does not revoke Qualifications already assigned to Workers because the Qualifications might be needed for active HITs. If there are any pending requests for the Qualification type, Amazon Mechanical Turk rejects those requests. After you delete a Qualification type, you can no longer use it to create HITs or HIT types. DeleteQualificationType must wait for all the HITs that use the deleted Qualification type to be deleted before completing. It may take up to 48 hours before DeleteQualificationType completes and the unique name of the Qualification type is available for reuse with CreateQualificationType. |
|
DeleteWorkerBlock(DeleteWorkerBlockRequest) |
The |
|
DeleteWorkerBlockAsync(DeleteWorkerBlockRequest, CancellationToken) |
The |
|
DetermineServiceOperationEndpoint(AmazonWebServiceRequest) |
Returns the endpoint that will be used for a particular request. |
|
DisassociateQualificationFromWorker(DisassociateQualificationFromWorkerRequest) |
The You can provide a text message explaining why the Qualification was revoked. The user who had the Qualification can see this message. |
|
DisassociateQualificationFromWorkerAsync(DisassociateQualificationFromWorkerRequest, CancellationToken) |
The You can provide a text message explaining why the Qualification was revoked. The user who had the Qualification can see this message. |
|
Dispose() | Inherited from Amazon.Runtime.AmazonServiceClient. | |
GetAccountBalance(GetAccountBalanceRequest) |
The |
|
GetAccountBalanceAsync(GetAccountBalanceRequest, CancellationToken) |
The |
|
GetAssignment(GetAssignmentRequest) |
The |
|
GetAssignmentAsync(GetAssignmentRequest, CancellationToken) |
The |
|
GetFileUploadURL(GetFileUploadURLRequest) |
The |
|
GetFileUploadURLAsync(GetFileUploadURLRequest, CancellationToken) |
The |
|
GetHIT(GetHITRequest) |
The |
|
GetHITAsync(GetHITRequest, CancellationToken) |
The |
|
GetQualificationScore(GetQualificationScoreRequest) |
The
To get a Worker's Qualification, you must know the Worker's ID. The Worker's ID is
included in the assignment data returned by the Only the owner of a Qualification type can query the value of a Worker's Qualification of that type. |
|
GetQualificationScoreAsync(GetQualificationScoreRequest, CancellationToken) |
The
To get a Worker's Qualification, you must know the Worker's ID. The Worker's ID is
included in the assignment data returned by the Only the owner of a Qualification type can query the value of a Worker's Qualification of that type. |
|
GetQualificationType(GetQualificationTypeRequest) |
The |
|
GetQualificationTypeAsync(GetQualificationTypeRequest, CancellationToken) |
The |
|
ListAssignmentsForHIT(ListAssignmentsForHITRequest) |
The You can get assignments for a HIT at any time, even if the HIT is not yet Reviewable. If a HIT requested multiple assignments, and has received some results but has not yet become Reviewable, you can still retrieve the partial results with this operation. Use the AssignmentStatus parameter to control which set of assignments for a HIT are returned. The ListAssignmentsForHIT operation can return submitted assignments awaiting approval, or it can return assignments that have already been approved or rejected. You can set AssignmentStatus=Approved,Rejected to get assignments that have already been approved and rejected together in one result set. Only the Requester who created the HIT can retrieve the assignments for that HIT. Results are sorted and divided into numbered pages and the operation returns a single page of results. You can use the parameters of the operation to control sorting and pagination. |
|
ListAssignmentsForHITAsync(ListAssignmentsForHITRequest, CancellationToken) |
The You can get assignments for a HIT at any time, even if the HIT is not yet Reviewable. If a HIT requested multiple assignments, and has received some results but has not yet become Reviewable, you can still retrieve the partial results with this operation. Use the AssignmentStatus parameter to control which set of assignments for a HIT are returned. The ListAssignmentsForHIT operation can return submitted assignments awaiting approval, or it can return assignments that have already been approved or rejected. You can set AssignmentStatus=Approved,Rejected to get assignments that have already been approved and rejected together in one result set. Only the Requester who created the HIT can retrieve the assignments for that HIT. Results are sorted and divided into numbered pages and the operation returns a single page of results. You can use the parameters of the operation to control sorting and pagination. |
|
ListBonusPayments(ListBonusPaymentsRequest) |
The |
|
ListBonusPaymentsAsync(ListBonusPaymentsRequest, CancellationToken) |
The |
|
ListHITs(ListHITsRequest) |
The |
|
ListHITsAsync(ListHITsRequest, CancellationToken) |
The |
|
ListHITsForQualificationType(ListHITsForQualificationTypeRequest) |
The |
|
ListHITsForQualificationTypeAsync(ListHITsForQualificationTypeRequest, CancellationToken) |
The |
|
ListQualificationRequests(ListQualificationRequestsRequest) |
The |
|
ListQualificationRequestsAsync(ListQualificationRequestsRequest, CancellationToken) |
The |
|
ListQualificationTypes(ListQualificationTypesRequest) |
The |
|
ListQualificationTypesAsync(ListQualificationTypesRequest, CancellationToken) |
The |
|
ListReviewableHITs(ListReviewableHITsRequest) |
The |
|
ListReviewableHITsAsync(ListReviewableHITsRequest, CancellationToken) |
The |
|
ListReviewPolicyResultsForHIT(ListReviewPolicyResultsForHITRequest) |
The |
|
ListReviewPolicyResultsForHITAsync(ListReviewPolicyResultsForHITRequest, CancellationToken) |
The |
|
ListWorkerBlocks(ListWorkerBlocksRequest) |
The |
|
ListWorkerBlocksAsync(ListWorkerBlocksRequest, CancellationToken) |
The |
|
ListWorkersWithQualificationType(ListWorkersWithQualificationTypeRequest) |
The |
|
ListWorkersWithQualificationTypeAsync(ListWorkersWithQualificationTypeRequest, CancellationToken) |
The |
|
NotifyWorkers(NotifyWorkersRequest) |
The |
|
NotifyWorkersAsync(NotifyWorkersRequest, CancellationToken) |
The |
|
RejectAssignment(RejectAssignmentRequest) |
The You can include an optional feedback message with the rejection, which the Worker can see in the Status section of the web site. When you include a feedback message with the rejection, it helps the Worker understand why the assignment was rejected, and can improve the quality of the results the Worker submits in the future. Only the Requester who created the HIT can reject an assignment for the HIT. |
|
RejectAssignmentAsync(RejectAssignmentRequest, CancellationToken) |
The You can include an optional feedback message with the rejection, which the Worker can see in the Status section of the web site. When you include a feedback message with the rejection, it helps the Worker understand why the assignment was rejected, and can improve the quality of the results the Worker submits in the future. Only the Requester who created the HIT can reject an assignment for the HIT. |
|
RejectQualificationRequest(RejectQualificationRequestRequest) |
The You can provide a text message explaining why the request was rejected. The Worker who made the request can see this message. |
|
RejectQualificationRequestAsync(RejectQualificationRequestRequest, CancellationToken) |
The You can provide a text message explaining why the request was rejected. The Worker who made the request can see this message. |
|
SendBonus(SendBonusRequest) |
The |
|
SendBonusAsync(SendBonusRequest, CancellationToken) |
The |
|
SendTestEventNotification(SendTestEventNotificationRequest) |
The |
|
SendTestEventNotificationAsync(SendTestEventNotificationRequest, CancellationToken) |
The |
|
UpdateExpirationForHIT(UpdateExpirationForHITRequest) |
The |
|
UpdateExpirationForHITAsync(UpdateExpirationForHITRequest, CancellationToken) |
The |
|
UpdateHITReviewStatus(UpdateHITReviewStatusRequest) |
The |
|
UpdateHITReviewStatusAsync(UpdateHITReviewStatusRequest, CancellationToken) |
The |
|
UpdateHITTypeOfHIT(UpdateHITTypeOfHITRequest) |
The |
|
UpdateHITTypeOfHITAsync(UpdateHITTypeOfHITRequest, CancellationToken) |
The |
|
UpdateNotificationSettings(UpdateNotificationSettingsRequest) |
The |
|
UpdateNotificationSettingsAsync(UpdateNotificationSettingsRequest, CancellationToken) |
The |
|
UpdateQualificationType(UpdateQualificationTypeRequest) |
The Most attributes of a Qualification type can be changed after the type has been created. However, the Name and Keywords fields cannot be modified. The RetryDelayInSeconds parameter can be modified or added to change the delay or to enable retries, but RetryDelayInSeconds cannot be used to disable retries. You can use this operation to update the test for a Qualification type. The test is updated based on the values specified for the Test, TestDurationInSeconds and AnswerKey parameters. All three parameters specify the updated test. If you are updating the test for a type, you must specify the Test and TestDurationInSeconds parameters. The AnswerKey parameter is optional; omitting it specifies that the updated test does not have an answer key. If you omit the Test parameter, the test for the Qualification type is unchanged. There is no way to remove a test from a Qualification type that has one. If the type already has a test, you cannot update it to be AutoGranted. If the Qualification type does not have a test and one is provided by an update, the type will henceforth have a test. If you want to update the test duration or answer key for an existing test without changing the questions, you must specify a Test parameter with the original questions, along with the updated values. If you provide an updated Test but no AnswerKey, the new test will not have an answer key. Requests for such Qualifications must be granted manually. You can also update the AutoGranted and AutoGrantedValue attributes of the Qualification type. |
|
UpdateQualificationTypeAsync(UpdateQualificationTypeRequest, CancellationToken) |
The Most attributes of a Qualification type can be changed after the type has been created. However, the Name and Keywords fields cannot be modified. The RetryDelayInSeconds parameter can be modified or added to change the delay or to enable retries, but RetryDelayInSeconds cannot be used to disable retries. You can use this operation to update the test for a Qualification type. The test is updated based on the values specified for the Test, TestDurationInSeconds and AnswerKey parameters. All three parameters specify the updated test. If you are updating the test for a type, you must specify the Test and TestDurationInSeconds parameters. The AnswerKey parameter is optional; omitting it specifies that the updated test does not have an answer key. If you omit the Test parameter, the test for the Qualification type is unchanged. There is no way to remove a test from a Qualification type that has one. If the type already has a test, you cannot update it to be AutoGranted. If the Qualification type does not have a test and one is provided by an update, the type will henceforth have a test. If you want to update the test duration or answer key for an existing test without changing the questions, you must specify a Test parameter with the original questions, along with the updated values. If you provide an updated Test but no AnswerKey, the new test will not have an answer key. Requests for such Qualifications must be granted manually. You can also update the AutoGranted and AutoGrantedValue attributes of the Qualification type. |
Name | Description | |
---|---|---|
AfterResponseEvent | Inherited from Amazon.Runtime.AmazonServiceClient. | |
BeforeRequestEvent | Inherited from Amazon.Runtime.AmazonServiceClient. | |
ExceptionEvent | Inherited from Amazon.Runtime.AmazonServiceClient. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5, 4.0, 3.5