Spec-Zone.ru › AWS CLI v2

[ aws . mturk ]

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 (строка)

Идентификатор типа HIT, который вы хотите использовать для создания этой HIT.

--max-assignments (целое число)

Количество раз, когда HIT может быть принят и завершен, прежде чем HIT станет недоступным.

--lifetime-in-seconds (длинное целое число)

Промежуток времени в секундах, после которого HIT больше не доступен для пользователей для принятия. После истечения срока действия HIT HIT больше не отображается в поисках HIT, даже если не все назначения для HIT были приняты.

--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 -> (строка)

Имя политики обзора: SimplePlurality/2011-09-01 или ScoreMyKnownAnswers/2011-09-01

Parameters -> (список)

Имя параметра из политики обзора.

(структура)

Имя параметра из политики обзора.

Key -> (строка)

Имя параметра из списка политик обзора.

Values -> (список)

Список значений параметра

(строка)

MapEntries -> (список)

Список объектов ParameterMapEntry.

(структура)

Эта структура данных — тип данных для параметра AnswerKey политики обзора ScoreMyKnownAnswers/2011-09-01.

Key -> (строка)

QuestionID из HIT, используемый для идентификации вопроса, который требует от механизма Turk выполнить оценку в рамках политики обзора ScoreMyKnownAnswers/2011-09-01.

Values -> (список)

Список ответов на вопрос, указанный в элементе MapEntry Key. Работник должен соответствовать всем значениям, чтобы ответ был оценен правильно.

(строка)

Синтаксис JSON:

{
  "PolicyName": "string",
  "Parameters": [
    {
      "Key": "string",
      "Values": ["string", ...],
      "MapEntries": [
        {
          "Key": "string",
          "Values": ["string", ...]
        }
        ...
      ]
    }
    ...
  ]
}

--hit-review-policy (структура)

Политика обзора на уровне HIT применяется к HIT. Вы можете указать механизму Turk выполнять различные действия на основе политики.

PolicyName -> (строка)

Имя политики обзора: SimplePlurality/2011-09-01 или ScoreMyKnownAnswers/2011-09-01

Parameters -> (список)

Имя параметра из политики обзора.

(структура)

Имя параметра из политики обзора.

Key -> (строка)

Имя параметра из списка политик обзора.

Values -> (список)

Список значений параметра

(строка)

MapEntries -> (список)

Список объектов ParameterMapEntry.

(структура)

Эта структура данных — тип данных для параметра AnswerKey политики обзора ScoreMyKnownAnswers/2011-09-01.

Key -> (строка)

QuestionID из HIT, используемый для идентификации вопроса, который требует от механизма Turk выполнить оценку в рамках политики обзора ScoreMyKnownAnswers/2011-09-01.

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 -> (строка)

Имя параметра в HITLayout.

Value -> (строка)

Значение, подставляемое для параметра, на который ссылается HITLayout.

Сокращенный синтаксис:

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 -> (строка)

Уникальный идентификатор HIT.

HITTypeId -> (строка)

Идентификатор типа HIT.

HITGroupId -> (строка)

Идентификатор группы HIT.

HITLayoutId -> (строка)

Идентификатор макета HIT.

CreationTime -> (временная метка)

Дата и время создания HIT.

Title -> (строка)

Заголовок HIT.

Description -> (строка)

Общее описание HIT.

Question -> (строка)

Данные, используемые Работником для выполнения HIT и получения результатов. Это структура QuestionForm, HTMLQuestion или ExternalQuestion.

Keywords -> (строка)

Одно или несколько слов или фраз, описывающих HIT, разделенных запятыми. Поисковые запросы, похожие на ключевые слова HIT, с большей вероятностью будут включать HIT в результаты поиска.

HITStatus -> (строка)

Статус HIT и его заданий. Допустимые значения: Assignable | Unassignable | Reviewable | Reviewing | Disposed.

MaxAssignments -> (целое число)

Количество раз, когда HIT можно принять и выполнить, прежде чем HIT станет недоступным.

Reward -> (строка)

Строка, представляющая денежную сумму.

AutoApprovalDelayInSeconds -> (целое число с большой точностью)

Время в секундах после того, как Работник отправит задание для HIT, по истечении которого результаты автоматически одобряются Amazon Mechanical Turk. Это время, в течение которого Заказчик может отклонить задание, отправленное Работником, прежде чем задание будет автоматически одобрено, и Работник получит оплату.

Expiration -> (временная метка)

Дата и время истечения срока действия HIT.

AssignmentDurationInSeconds -> (целое число с большой точностью)

Время в секундах, отведенное Работнику для выполнения HIT после его принятия.

RequesterAnnotation -> (строка)

Произвольное поле данных, которое может использовать Заказчик, создавший HIT. Это поле видно только создателю HIT.

QualificationRequirements -> (список)

Условия, которым должны соответствовать квалификации Работника, чтобы принять HIT. HIT может иметь от нуля до десяти требований к квалификации. Все требования должны быть выполнены для того, чтобы Работник мог принять HIT. Кроме того, другие действия могут быть ограничены с помощью поля ActionsGuarded в каждой структуре QualificationRequirement.

(структура)

Структура данных QualificationRequirement описывает квалификацию, которой должен обладать Работник, прежде чем ему будет разрешено принять HIT. Требование может (по желанию) указывать, что Работник должен обладать этой квалификацией для предварительного просмотра HIT или его просмотра в результатах поиска.

QualificationTypeId -> (строка)

Идентификатор типа квалификации для требования.

Comparator -> (строка)

Тип сравнения с значением квалификации. Можно сравнить значение квалификации с IntegerValue, чтобы определить, является ли оно LessThan, LessThanOrEqualTo, GreaterThan, GreaterThanOrEqualTo, EqualTo или NotEqualTo IntegerValue. Можно сравнить его с LocaleValue, чтобы определить, равно ли оно EqualTo или NotEqualTo LocaleValue. Можно проверить, входит ли значение в множество IntegerValue или LocaleValue. Кроме того, требование квалификации может проверить, существует ли квалификация или отсутствует в профиле пользователя, независимо от её значения.

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 -> (строка)

Страна локали. Должен быть допустимым кодом страны ISO 3166. Например, код US относится к Соединенным Штатам Америки.

Subdivision -> (строка)

Штат или подразделение локали. Допустимый код подразделения ISO 3166-2. Например, код WA относится к штату Вашингтон.

RequiredToPreview -> (булево значение)

УСТАНОВЛЕНО: Используйте поле ActionsGuarded вместо этого. Если RequiredToPreview равно true, данные вопроса для HIT не будут отображаться, когда Работник, чьи квалификации не соответствуют этому требованию, пытается предварительно просмотреть HIT. То есть квалификации Работника должны удовлетворять всем требованиям, для которых RequiredToPreview равно true, чтобы предварительно просмотреть HIT. Если Работник удовлетворяет всем требованиям, где RequiredToPreview равно true (или если таких требований нет), но не удовлетворяет всем требованиям для HIT, Работнику будет разрешено просмотреть данные вопроса HIT, но не будет разрешено принять и выполнить HIT. По умолчанию false. Это не должно использоваться в сочетании с полем ActionsGuarded.

ActionsGuarded -> (строка)

Установление этого атрибута предотвращает Работникам, чьи квалификации не соответствуют этому QualificationRequirement, выполнение указанного действия. Допустимые аргументы включают «Accept» (Работник не может принять HIT, но может предварительно просмотреть HIT и увидеть его в результатах поиска), «PreviewAndAccept» (Работник не может принять или предварительно просмотреть HIT, но может увидеть HIT в своих результатах поиска) и «DiscoverPreviewAndAccept» (Работник не может принять, предварительно просмотреть или увидеть HIT в своих результатах поиска). Возможно создание HIT с несколькими QualificationRequirements (с различными значениями атрибута ActionGuarded). В этом случае Работник может выполнить действие только при выполнении всех QualificationRequirements, защищающих действие. Действия в порядке от наименее ограниченного к наиболее ограниченному — Discover, Preview и Accept. Например, если Работник выполняет все QualificationRequirements, установленные как DiscoverPreviewAndAccept, но не выполняет все требования, установленные как PreviewAndAccept, то Работник сможет Discover, т. е. увидеть HIT в своих результатах поиска, но не сможет предварительно просмотреть или принять HIT. ActionsGuarded не следует использовать в сочетании с полем RequiredToPreview.

HITReviewStatus -> (строка)

Указывает статус проверки HIT. Допустимые значения: NotReviewed | MarkedForReview | ReviewedAppropriate | ReviewedInappropriate.

NumberOfAssignmentsPending -> (целое число)

Количество заданий для этого HIT, которые просматриваются или были приняты Работниками, но еще не были отправлены, возвращены или оставлены.

NumberOfAssignmentsAvailable -> (целое число)

Количество заданий для этого HIT, доступных для принятия Работниками.

NumberOfAssignmentsCompleted -> (целое число)

Количество заданий для этого HIT, которые были одобрены или отклонены.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API