[ aws . rekognition ]
describe-stream-processor
Описание
Предоставляет информацию о потоковом процессоре, созданном с помощью CreateStreamProcessor. Вы можете получить информацию о входных и выходных потоках, параметрах входных данных для распознавания лиц и текущем статусе потокового процессора.
См. также: Документация API AWS
Синтаксис
describe-stream-processor
--name <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]
Параметры
--name (строка)
--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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
За исключением случаев, когда это специально оговаривается, во всех примерах используются правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Получение информации о потоковом процессоре
Следующая команда describe-stream-processor отображает подробности о указанном потоковом процессоре.
aws rekognition describe-stream-processor \
--name my-stream-processor
Вывод:
{
"Status": "STOPPED",
"Name": "my-stream-processor",
"LastUpdateTimestamp": 1532449292.712,
"Settings": {
"FaceSearch": {
"FaceMatchThreshold": 80.0,
"CollectionId": "my-collection"
}
},
"RoleArn": "arn:aws:iam::123456789012:role/AmazonRekognitionDetectStream",
"StreamProcessorArn": "arn:aws:rekognition:us-west-2:123456789012:streamprocessor/my-stream-processpr",
"Output": {
"KinesisDataStream": {
"Arn": "arn:aws:kinesis:us-west-2:123456789012:stream/AmazonRekognitionRekStream"
}
},
"Input": {
"KinesisVideoStream": {
"Arn": "arn:aws:kinesisvideo:us-west-2:123456789012:stream/macwebcam/123456789012"
}
},
"CreationTimestamp": 1532449292.712
}
Для получения дополнительной информации см. Разработку с потоковым видео в Руководстве разработчика Amazon Rekognition.
Вывод
Имя -> (строка)
StreamProcessorArn -> (строка)
Статус -> (строка)
StatusMessage -> (строка)
CreationTimestamp -> (метка времени)
LastUpdateTimestamp -> (метка времени)
Ввод -> (структура)
Поток видео Kinesis, предоставляющий исходное видеопоток.
KinesisVideoStream -> (структура)
Поток ввода видео Kinesis для исходного видеопотока.
Arn -> (строка)
Вывод -> (структура)
Поток данных Kinesis, в который Amazon Rekognition Video помещает результаты анализа.
KinesisDataStream -> (структура)
Поток Amazon Kinesis Data Streams, в который обработчик потоков Amazon Rekognition передает результаты анализа.
Arn -> (строка)
S3Destination -> (структура)
Расположение ведра Amazon S3, в которое Amazon Rekognition публикует подробные результаты вывода видеоаналитики.
Bucket -> (строка)
KeyPrefix -> (строка)
RoleArn -> (строка)
Настройки -> (структура)
Параметры ввода, используемые в анализируемом потоке видео обработчиком потока. Вы можете использовать FaceSearch для распознавания лиц на потоке видео, или вы можете использовать ConnectedHome для обнаружения меток.
FaceSearch -> (структура)
Настройки поиска лиц для использования на потоке видео.
CollectionId -> (строка)
FaceMatchThreshold -> (число с плавающей точкой)
ConnectedHome -> (структура)
Настройки обнаружения меток для использования на потоке видео. Определение настроек требуется в параметре запроса CreateStreamProcessor. Включение этой настройки в запросе CreateStreamProcessor позволяет использовать обработчик потоков для обнаружения меток. Вы затем можете выбрать, что вы хотите, чтобы обработчик потоков обнаруживал, например, людей или животных. Когда обработчик потоков запущен, отправляется одно уведомление для каждого класса объектов, указанного. Например, если выбраны посылки и домашние животные, одно уведомление SNS публикуется в первый раз, когда обнаружена посылка, и одно уведомление SNS публикуется в первый раз, когда обнаружено домашнее животное, а также сводка в конце сеанса.
Labels -> (список)
Указывает, что вы хотите обнаружить на видео, например, людей, посылки или домашних животных. В настоящее время допустимые метки, которые вы можете включить в этот список: «ЧЕЛОВЕК», «ЖИВОТНОЕ», «ПОСЫЛКА» и «ВСЕ».
(строка)
MinConfidence -> (число с плавающей точкой)
NotificationChannel -> (структура)
Тема Amazon Simple Notification Service, в которую Amazon Rekognition публикует результаты обнаружения объектов и состояние завершения операции анализа видео.
Amazon Rekognition публикует уведомление в первый раз, когда обнаруживается объект интереса или человек в потоке видео. Например, если Amazon Rekognition обнаружит человека на второй секунде, животное на четвертой секунде и снова человека на пятой секунде, Amazon Rekognition отправит 2 уведомления об обнаружении класса объектов, одно для человека на второй секунде и одно для животного на четвертой секунде.
Amazon Rekognition также публикует уведомление о завершении сеанса со сводкой по завершении сеанса обработки потока.
SNSTopicArn -> (строка)
KmsKeyId -> (строка)
RegionsOfInterest -> (список)
Указывает расположения в кадрах, где Amazon Rekognition проверяет наличие объектов или людей. Этот параметр является необязательным для обработчиков потоков обнаружения меток.
(структура)
Указывает местоположение в кадре, где Rekognition проверяет наличие объектов интереса, таких как текст, метки или лица. Он использует BoundingBox или Polygon для определения области экрана.
Слово, лицо или метка включаются в область, если они находятся более чем наполовину в этой области. Если есть более одной области, слово, лицо или метка сравниваются со всеми областями экрана. Любой объект интереса, который находится более чем наполовину в области, сохраняется в результатах.
BoundingBox -> (структура)
Прямоугольник, представляющий область интереса на экране.
Ширина -> (число с плавающей точкой)
Высота -> (число с плавающей точкой)
Левый -> (число с плавающей точкой)
Верхний -> (число с плавающей точкой)
Polygon -> (список)
Указывает фигуру, состоящую из до 10 Point объектов, чтобы определить область интереса.
(структура)
Координаты X и Y точки на изображении или кадре видео. Значения X и Y являются отношениями к общему размеру изображения или разрешению видео. Например, если входное изображение имеет размер 700x200, а значения равны X=0,5 и Y=0,25, то точка находится в координате (350,50) пикселей на изображении.
Массив Point объектов образует Polygon. Polygon возвращается DetectText и DetectCustomLabels Polygon представляет собой детальный многоугольник вокруг обнаруженного элемента. Для получения дополнительной информации см. раздел Геометрия в руководстве разработчика Amazon Rekognition.
X -> (число с плавающей точкой)
Polygon.Y -> (число с плавающей точкой)
Polygon.DataSharingPreference -> (структура)
Показывает, делитесь ли вы данными с Rekognition для улучшения производительности модели. Вы можете выбрать этот параметр на уровне учетной записи или на основе каждого потока. Обратите внимание, что если вы откажетесь от участия на уровне учетной записи, этот параметр игнорируется для отдельных потоков.
OptIn -> (булево)
© Copyright 2025, Amazon Web Services. Created using Sphinx.