기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.