The GetWorkerAcceptLimit operation retrieves the value of MaxWorkerAcceptLimit for the group you specify. For example, you can retrieve the limit for HITs of a specific HIT type, or you can retrieve the limit for HITs that don't otherwise have a HIT-type-specific limit set. See
SetWorkerAcceptLimit
for more information about these limits.
If you request the MaxWorkerAcceptLimit for a HIT of a certain type, but you haven't previously set that limit, the operation returns an error indicating that the limit is undefined. If you request the limit for the overall group of remaining HITs, but you haven't previously set that limit, the operation returns the default value of 10.
If you request the limit for a HIT type you did not create, the operation returns an error.
The following example of a call to the GetWorkerAcceptLimit operation retrieves the limit for HITs of type T100CN9P324W00EXAMPLE.
http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]&Version=2007-03-12 &Operation=GetWorkerAcceptLimit &Signature=[signature for this request]&Timestamp=[your system's local time]&LimitGroupType=HIT Type &LimitGroupID=T100CN9P324W00EXAMPLE
A request to the Amazon Mechanical Turk service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.
GetWorkerAcceptLimit accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the GetWorkerAcceptLimit operation:
| Name | Description | Type | Value |
|---|---|---|---|
Operation
|
The operation you want to call. To access the
| Required |
|
LimitGroupType
|
The type of group you want to retrieve the limit for; either | Required |
|
LimitGroupID
|
The ID of the HIT type you want to retrieve the limit for. For the request to succeed, you must be the creator of this HIT type. | Required when LimitGroupType = HIT Type |
A valid HIT type you created |
A successful request for the
GetWorkerAcceptLimit operation will have a
GetWorkerAcceptLimitResult element in the response.
The GetWorkerAcceptLimitResult
element contains the following element:
| Name | Description | Value |
|---|---|---|
MaxWorkerAcceptLimit
|
The maximum number of assignments any Worker can accept for the group of HITs you specified. |
A positive integer |