list-hits-for-qualification-type

Описание

Операция ListHITsForQualificationType возвращает HITы, использующие указанный тип квалификации для требования квалификации. Операция возвращает HITы любого статуса, кроме HITов, которые были удалены с помощью операции DeleteHIT или которые были автоматически удалены.

См. также: Документация API AWS

list-hits-for-qualification-type является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько API-запросов. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответном пакете для постраничной операции, аргумент --query должен извлечь данные из результатов следующих выражений запроса: HITs

Синтаксис

  list-hits-for-qualification-type
--qualification-type-id <value>
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--qualification-type-id (строка)

Идентификатор типа квалификации, используемый при запросе HITов.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные JSON. Передача произвольных двоичных данных с использованием JSON-значения в качестве строки невозможна, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен для указания точки начала постраничной выборки. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы при вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить таймауты вызовов AWS-службы.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.

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

Общее количество элементов, возвращаемых в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничную выборку, укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.

--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-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматический запрос параметров ввода CLI.

Вывод

NextToken -> (строка)

Если предыдущий ответ был неполным (потому что для получения требуется больше данных), Amazon Mechanical Turk возвращает маркер постраничной навигации в ответе. Вы можете использовать этот маркер, чтобы получить следующий набор результатов.

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

Количество HIT на этой странице в отфильтрованном списке результатов, эквивалентное количеству HIT, возвращаемых этим вызовом.

HITs -> (список)

Список элементов HIT, возвращаемых запросом.

(структура)

Структура данных HIT представляет собой отдельный HIT, включая всю необходимую информацию для Работника, чтобы принять и выполнить HIT.

HITId -> (строка)

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

HITTypeId -> (строка)

Идентификатор типа HIT для этого HIT.

HITGroupId -> (строка)

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

HITLayoutId -> (строка)

Идентификатор макета HIT для этого 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 или увидеть HIT в результатах поиска.

QualificationTypeId -> (строка)

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

Comparator -> (строка)

Тип сравнения с значением квалификации. Вы можете сравнить значение квалификации с IntegerValue, чтобы определить, меньше ли оно, меньше или равно, больше, больше или равно, равно или не равно IntegerValue. Вы можете сравнить его со значением LocaleValue, чтобы определить, равно ли оно или не равно значение 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, которые были одобрены или отклонены.

END_OF_DOCUMENT_MARKER