create-hit-with-hit-type
Описание
Операция CreateHITWithHITType создает новую задачу интеллектуального труда (HIT) с использованием существующего идентификатора типа HIT (HITTypeID), сгенерированного операцией CreateHITType.
Это альтернативный способ создания HIT из операции CreateHIT. Это рекомендуемая лучшая практика для Заказчиков, которые создают большое количество HIT.
CreateHITWithHITType также поддерживает несколько способов предоставления данных вопросов: путем указания значения параметра Question, который полностью определяет содержимое HIT, или путем предоставления параметра HitLayoutId и соответствующего параметра HitLayoutParameters.
Примечание
Если HIT создается с 10 или более максимальными назначениями, взимается дополнительная плата. Более подробную информацию см. в Amazon Mechanical Turk Цены .См. также: AWS Документация API
Синтаксис
create-hit-with-hit-type
--hit-type-id <value>
[--max-assignments <value>]
--lifetime-in-seconds <value>
[--question <value>]
[--requester-annotation <value>]
[--unique-request-token <value>]
[--assignment-review-policy <value>]
[--hit-review-policy <value>]
[--hit-layout-id <value>]
[--hit-layout-parameters <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--hit-type-id (строка)
--max-assignments (целое число)
--lifetime-in-seconds (длинное целое число)
--question (строка)
Данные, которые использует человек, выполняющий HIT, для получения результатов.
Ограничения: Должен быть структурой данных QuestionForm, структурой данных ExternalQuestion или структурой данных HTMLQuestion. Данные вопроса в формате XML не должны превышать 64 килобайта (65 535 байтов) в размере, включая пробелы.
Должен быть указан либо параметр Question, либо параметр HITLayoutId.
--requester-annotation (строка)
Произвольное поле данных. Параметр RequesterAnnotation позволяет вашему приложению прикрепить произвольные данные к HIT для отслеживания. Например, этот параметр может быть идентификатором, внутренним для приложения Заказчика, который соответствует HIT.
Параметр RequesterAnnotation для HIT виден только Заказчику, который создал HIT. Он не отображается Работнику или любому другому Заказчику.
Параметр RequesterAnnotation может быть разным для каждой отправляемой вами HIT. Он не влияет на то, как ваши HIT сгруппированы.
--unique-request-token (строка)
Уникальный идентификатор для этого запроса, который позволяет вам повторить вызов при ошибке, не создавая дубликатов HIT. Это полезно в таких случаях, как таймауты сети, когда неясно, произошел ли вызов успешно на сервере. Если HIT уже существует в системе из предыдущего вызова с использованием того же UniqueRequestToken, последующие вызовы вернут ошибку AWS.MechanicalTurk.HitAlreadyExists с сообщением, содержащим HITId.
Примечание
Обратите внимание: вы несете ответственность за обеспечение уникальности токена. Уникальный токен истекает через 24 часа. Последующие вызовы с использованием того же UniqueRequestToken, сделанные после 24-часового лимита, могут создать дубликаты HIT.--assignment-review-policy (структура)
Политика обзора на уровне назначения применяется к назначениям в рамках HIT. Вы можете указать механизму Turk выполнять различные действия на основе политики.
PolicyName -> (строка)
Parameters -> (список)
Имя параметра из политики обзора.
(структура)
Имя параметра из политики обзора.
Key -> (строка)
Values -> (список)
Список значений параметра
(строка)
MapEntries -> (список)
Список объектов ParameterMapEntry.
(структура)
Эта структура данных — тип данных для параметра AnswerKey политики обзора ScoreMyKnownAnswers/2011-09-01.
Key -> (строка)
Values -> (список)
Список ответов на вопрос, указанный в элементе MapEntry Key. Работник должен соответствовать всем значениям, чтобы ответ был оценен правильно.
(строка)
Синтаксис JSON:
{
"PolicyName": "string",
"Parameters": [
{
"Key": "string",
"Values": ["string", ...],
"MapEntries": [
{
"Key": "string",
"Values": ["string", ...]
}
...
]
}
...
]
}
--hit-review-policy (структура)
Политика обзора на уровне HIT применяется к HIT. Вы можете указать механизму Turk выполнять различные действия на основе политики.
PolicyName -> (строка)
Parameters -> (список)
Имя параметра из политики обзора.
(структура)
Имя параметра из политики обзора.
Key -> (строка)
Values -> (список)
Список значений параметра
(строка)
MapEntries -> (список)
Список объектов ParameterMapEntry.
(структура)
Эта структура данных — тип данных для параметра AnswerKey политики обзора ScoreMyKnownAnswers/2011-09-01.
Key -> (строка)
Values -> (список)
Список ответов на вопрос, указанный в элементе MapEntry Key. Работник должен соответствовать всем значениям, чтобы ответ был оценен правильно.
(строка)
Синтаксис JSON:
{
"PolicyName": "string",
"Parameters": [
{
"Key": "string",
"Values": ["string", ...],
"MapEntries": [
{
"Key": "string",
"Values": ["string", ...]
}
...
]
}
...
]
}
--hit-layout-id (строка)
HITLayoutId позволяет использовать предварительно созданный дизайн HIT с подстановочными значениями и создавать дополнительную HIT, предоставляя эти значения как параметры HITLayoutParameters.
Ограничения: Должен быть указан либо параметр Question, либо параметр HITLayoutId.
--hit-layout-parameters (список)
Если указан HITLayoutId, все подстановочные значения должны быть заполнены значениями с помощью структуры HITLayoutParameter. Дополнительную информацию см. в HITLayout.
(структура)
Структура данных HITLayoutParameter определяет значения параметров, используемые с HITLayout. HITLayout — это повторно используемая шаблон проекта Amazon Mechanical Turk, используемый для предоставления данных вопроса задачи интеллектуального труда (HIT) для CreateHIT.
Name -> (строка)
Value -> (строка)
Сокращенный синтаксис:
Name=string,Value=string ...
Синтаксис JSON:
[
{
"Name": "string",
"Value": "string"
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет воспринята буквально. Это может быть не указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит скелет JSON в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, выполняется проверка входных данных команды и возвращается пример выходного JSON для этой команды. Сгенерированный скелет JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном скелете JSON.
Глобальные параметры
--debug (логическое значение)
Включение отладки регистрации.
--endpoint-url (строка)
Переопределение URL по умолчанию команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию по проверке сертификатов SSL.
--no-paginate (логическое значение)
Отключение автоматической постраничной навигации. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/отключение цветного вывода.
- on
- off
- auto
--no-sign-request (логическое значение)
Отключение подписи запросов. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается как двоичный блок fileb://, всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключение постраничной навигации cli для вывода.
--cli-auto-prompt (логическое значение)
Автоматический запрос параметров CLI.
--no-cli-auto-prompt (логическое значение)
Отключение автоматического запроса параметров CLI.
Вывод
HIT -> (структура)
Содержит данные только что созданного HIT. Для описания структуры данных HIT в ответах см. документацию по структуре данных HIT.
HITId -> (строка)
HITTypeId -> (строка)
HITGroupId -> (строка)
HITLayoutId -> (строка)
CreationTime -> (временная метка)
Title -> (строка)
Description -> (строка)
Question -> (строка)
Keywords -> (строка)
HITStatus -> (строка)
MaxAssignments -> (целое число)
Reward -> (строка)
AutoApprovalDelayInSeconds -> (целое число с большой точностью)
Expiration -> (временная метка)
AssignmentDurationInSeconds -> (целое число с большой точностью)
RequesterAnnotation -> (строка)
QualificationRequirements -> (список)
Условия, которым должны соответствовать квалификации Работника, чтобы принять HIT. HIT может иметь от нуля до десяти требований к квалификации. Все требования должны быть выполнены для того, чтобы Работник мог принять HIT. Кроме того, другие действия могут быть ограничены с помощью поля ActionsGuarded в каждой структуре QualificationRequirement.
(структура)
Структура данных QualificationRequirement описывает квалификацию, которой должен обладать Работник, прежде чем ему будет разрешено принять HIT. Требование может (по желанию) указывать, что Работник должен обладать этой квалификацией для предварительного просмотра HIT или его просмотра в результатах поиска.
QualificationTypeId -> (строка)
Comparator -> (строка)
IntegerValues -> (список)
Целое значение для сравнения со значением квалификации. IntegerValue не должно присутствовать, если Comparator равен Exists или DoesNotExist. IntegerValue может быть использовано только в том случае, если тип квалификации имеет целочисленное значение; его нельзя использовать с идентификатором типа квалификации Worker_Locale. При выполнении сравнения множества с использованием компаратора In или NotIn вы можете использовать до 15 элементов IntegerValue в структуре данных QualificationRequirement.
(целое число)
LocaleValues -> (список)
Значение локали для сравнения со значением квалификации. Значение локали должно быть допустимым кодом страны ISO 3166 или поддерживать подрайоны ISO 3166-2. LocaleValue может быть использовано только с идентификатором типа квалификации Worker_Locale. LocaleValue может использоваться только с компараторами EqualTo, NotEqualTo, In и NotIn. При использовании компараторов EqualTo или NotEqualTo необходимо использовать только один элемент LocaleValue. При выполнении сравнения множества с использованием компараторов In или NotIn вы можете использовать до 30 элементов LocaleValue в структуре данных QualificationRequirement.
(структура)
Структура данных Locale представляет географический регион или местоположение.
Country -> (строка)
Subdivision -> (строка)
RequiredToPreview -> (булево значение)
ActionsGuarded вместо этого. Если RequiredToPreview равно true, данные вопроса для HIT не будут отображаться, когда Работник, чьи квалификации не соответствуют этому требованию, пытается предварительно просмотреть HIT. То есть квалификации Работника должны удовлетворять всем требованиям, для которых RequiredToPreview равно true, чтобы предварительно просмотреть HIT. Если Работник удовлетворяет всем требованиям, где RequiredToPreview равно true (или если таких требований нет), но не удовлетворяет всем требованиям для HIT, Работнику будет разрешено просмотреть данные вопроса HIT, но не будет разрешено принять и выполнить HIT. По умолчанию false. Это не должно использоваться в сочетании с полем ActionsGuarded.ActionsGuarded -> (строка)
RequiredToPreview.HITReviewStatus -> (строка)
NumberOfAssignmentsPending -> (целое число)
NumberOfAssignmentsAvailable -> (целое число)
NumberOfAssignmentsCompleted -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.