기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetSignalingChannelEndpoint
지정된 신호 채널이 메시지를 보내고 받을 수 있는 엔드포인트를 제공합니다. 이 API는 Protocols
및 Role
속성으로 구성된 SingleMasterChannelEndpointConfiguration
입력 매개변수를 사용합니다.
Protocols
통신 메커니즘을 결정하는 데 사용됩니다. 예를 들어 WSS
프로토콜로 지정하는 경우 이 API는 보안 웹소켓 엔드포인트를 생성합니다. HTTPS
프로토콜로 지정하는 경우 이 API는 HTTPS 엔드포인트를 생성합니다. WEBRTC
프로토콜로 지정했지만 신호 채널이 인제스트를 위해 구성되지 않은 경우 오류가 발생합니다. InvalidArgumentException
Role
메시징 권한을 결정합니다. MASTER
역할을 통해 이 API는 클라이언트가 채널의 모든 시청자와 통신하는 데 사용할 수 있는 엔드포인트를 생성합니다. VIEWER
역할을 수행하면 이 API는 클라이언트가 통신에만 사용할 수 있는 엔드포인트를 생성합니다MASTER
.
Request Syntax
POST /getSignalingChannelEndpoint HTTP/1.1
Content-type: application/json
{
"ChannelARN": "string
",
"SingleMasterChannelEndpointConfiguration": {
"Protocols": [ "string
" ],
"Role": "string
"
}
}
URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ChannelARN
-
엔드포인트를 얻으려는 신호 채널의 Amazon 리소스 이름 (ARN).
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
필수 사항 여부: Yes
- SingleMasterChannelEndpointConfiguration
-
SINGLE_MASTER
채널 유형에 대한 엔드포인트 구성을 포함하는 구조입니다.유형: SingleMasterChannelEndpointConfiguration객체
필수 항목 여부: 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"ResourceEndpointList": [
{
"Protocol": "string",
"ResourceEndpoint": "string"
}
]
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- ResourceEndpointList
-
지정된 신호 채널의 엔드포인트 목록.
타입: ResourceEndpointListItem 객체 배열
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- AccessDeniedException
-
이 작업을 수행하는 데 필요한 권한이 없습니다.
HTTP 상태 코드: 401
- ClientLimitExceededException
-
허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.
HTTP 상태 코드: 400
- InvalidArgumentException
-
이 입력 매개변수의 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
입력
StreamARN
또는ChannelARN
CLOUD_STORAGE_MODE
입력이 이미 다른 Kinesis Video Stream 리소스에 매핑되어 있거나 제공된StreamARN
입력ChannelARN
또는 입력이 활성 상태가 아닌 경우 다음 중 하나를 시도해 보십시오.-
해당 스트림의 채널이 매핑되는 대상을 결정하는
DescribeMediaStorageConfiguration
API입니다. -
지정된 스트림이 매핑되는 채널을 결정하는
DescribeMappedResourceConfiguration
API입니다. -
리소스의 상태를 확인하기 위한
DescribeStream
또는DescribeSignalingChannel
API입니다.
HTTP 상태 코드: 400
-
- ResourceNotFoundException
-
Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다.
HTTP 상태 코드: 404
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.