GetDataEndpoint - Amazon Kinesis Video Streams

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GetDataEndpoint

읽기 또는 쓰기를 위해 지정된 스트림의 끝점을 가져옵니다. 애플리케이션에서 이 엔드포인트를 사용하여 지정된 스트림에서 읽기 (GetMedia또는 GetMediaForFragmentList 작업 사용) 하거나 쓰기 (PutMedia작업 사용) 할 수 있습니다.

참고

반환된 엔드포인트에는 API 이름이 추가되지 않습니다. 클라이언트는 반환된 엔드포인트에 API 이름을 추가해야 합니다.

요청에서 StreamName 또는 로 스트림을 지정합니다StreamARN.

Request Syntax

POST /getDataEndpoint HTTP/1.1 Content-type: application/json { "APIName": "string", "StreamARN": "string", "StreamName": "string" }

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

APIName

엔드포인트를 가져올 API 작업의 이름.

타입: 문자열

유효 값: PUT_MEDIA | GET_MEDIA | LIST_FRAGMENTS | GET_MEDIA_FOR_FRAGMENT_LIST | GET_HLS_STREAMING_SESSION_URL | GET_DASH_STREAMING_SESSION_URL | GET_CLIP | GET_IMAGES

필수 사항 여부: 예

StreamARN

엔드포인트를 가져오려는 스트림의 Amazon 리소스 이름 (ARN) StreamName요청에서 이 파라미터 또는 a를 지정해야 합니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1024입니다.

패턴: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Required: No

StreamName

엔드포인트를 가져오려는 스트림의 이름. StreamARN요청에서 이 파라미터 또는 a를 지정해야 합니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.

패턴: [a-zA-Z0-9_.-]+

필수 여부: 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "DataEndpoint": "string" }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

DataEndpoint

엔드포인트 값. 스트림에서 데이터를 읽거나 스트림에 데이터를 쓰려면 애플리케이션에서 이 엔드포인트를 지정하십시오.

타입: 문자열

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

ClientLimitExceededException

허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.

HTTP 상태 코드: 400

InvalidArgumentException

이 입력 매개변수의 값이 유효하지 않습니다.

HTTP 상태 코드: 400

NotAuthorizedException

호출자는 이 작업을 수행할 권한이 없습니다.

HTTP 상태 코드: 401

ResourceNotFoundException

Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다.

HTTP 상태 코드: 404

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.