ivs

Описание

API Amazon Interactive Video Service (IVS) совместим с REST, используя стандартный HTTP API и потоки событий Amazon Web Services EventBridge для ответов. Для запросов и ответов, включая ошибки, используется JSON.

API является региональной службой Amazon Web Services. Список поддерживаемых регионов и HTTPS-служб Amazon IVS см. на странице Amazon IVS в Amazon Web Services General Reference.

Сводка изменений документации в каждом релизе приведена в разделе История документации.

• ``Accept: `` application/json
• ``Accept-Encoding: `` gzip, deflate
• ``Content-Type: `` application/json

• Канал — хранит данные конфигурации, связанные с вашим прямым потоком. Сначала вы создаёте канал, а затем используете ключ потока канала для начала прямого потока.
• Ключ потока — идентификатор, назначенный Amazon IVS при создании канала, который затем используется для авторизации потоковой передачи. * Обращайтесь с ключом потока как с секретом, так как он позволяет любому осуществлять потоковую передачу в канал. *
• Пара ключей для воспроизведения — воспроизведение видео может быть ограничено с помощью токенов авторизации воспроизведения, которые используют шифрование с открытым ключом. Пара ключей для воспроизведения — это пара открытого и закрытого ключей, используемых для подписи и проверки токена авторизации воспроизведения.
• Конфигурация записи — хранит конфигурацию, связанную с записью прямого потока и местом хранения записанного контента. Несколько каналов могут ссылаться на одну и ту же конфигурацию записи.
• Политика ограничения воспроизведения — ограничивает воспроизведение по странам и/или источникам.

Дополнительную информацию о вашем прямом потоке IVS см. также в разделе Начало работы с IVS низкой задержкой.

Тег — это метка метаданных, которую вы назначаете ресурсу Amazon Web Services. Тег состоит из ключа и значения, которые задаёте вы. Например, вы можете установить тег topic:nature для обозначения конкретной категории видео. Подробнее см. в Tagging Amazon Web Services Resources and Tag Editor, включая ограничения, применяемые к тегам и «Пределы и требования к именованию тегов»; Amazon IVS не имеет специфических ограничений помимо тех, которые там описаны.

Теги помогают вам идентифицировать и организовывать ваши ресурсы Amazon Web Services. Например, вы можете использовать один и тот же тег для разных ресурсов, чтобы указать, что они связаны. Вы также можете использовать теги для управления доступом (см. Теги доступа).

API Amazon IVS имеет такие операции, связанные с тегами: TagResource , UntagResource и ListTagsForResource . Следующие ресурсы поддерживают тегирование: каналы, ключи потоков, пары ключей для воспроизведения и конфигурации записи.

К ресурсу можно применить не более 50 тегов.

Обратите внимание на различия между этими понятиями:

• Аутентификация — это проверка подлинности. Вам необходимо пройти аутентификацию для подписания запросов API Amazon IVS.
• Авторизация — это предоставление разрешений. Ваши роли IAM должны иметь разрешения для запросов API Amazon IVS. Кроме того, авторизация требуется для просмотра частных каналов Amazon IVS. (Частные каналы — это каналы, включённые в "авторизацию воспроизведения").

Все запросы API Amazon IVS должны быть аутентифицированы с помощью подписи. Amazon Web Services Command-Line Interface (CLI) и Amazon IVS Player SDKs занимаются подписанием базовых API-вызовов за вас. Однако, если ваше приложение обращается к API Amazon IVS напрямую, вы сами отвечаете за подписание запросов.

Вы генерируете подпись, используя действительные учетные данные Amazon Web Services, имеющие разрешение на выполнение запрошенного действия. Например, вы должны подписать запросы PutMetadata с подписью, сгенерированной из учётной записи пользователя, имеющей разрешение ivs:PutMetadata.

Для получения дополнительной информации:

• Аутентификация и генерация подписей — см. Аутентификация запросов (Amazon Web Services Signature Version 4) в Amazon Web Services General Reference.
• Управление разрешениями Amazon IVS — см. Управление учетными данными и доступом на странице Безопасность руководства пользователя Amazon IVS.

ARN однозначно идентифицируют ресурсы AWS. ARN необходимы, когда вам нужно однозначно указать ресурс во всей AWS, например, в политиках IAM и вызовах API. Для получения дополнительной информации см. Имена ресурсов Amazon в AWS General Reference.

Доступные команды