기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateSignalingChannel
기존 신호 채널을 업데이트합니다. 이는 비동기 작업이며 완료하는 데 시간이 걸립니다.
MessageTtlSeconds값이 업데이트 (증가 또는 감소) 되면 업데이트 후 이 채널을 통해 전송되는 새 메시지에만 적용됩니다. 기존 메시지는 여전히 이전 MessageTtlSeconds 값에 따라 만료됩니다.
Request Syntax
POST /updateSignalingChannel HTTP/1.1
Content-type: application/json
{
"ChannelARN": "string",
"CurrentVersion": "string",
"SingleMasterConfiguration": {
"MessageTtlSeconds": number
}
}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
- CurrentVersion
-
업데이트하려는 신호 채널의 현재 버전.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
[a-zA-Z0-9]+필수 사항 여부: Yes
- SingleMasterConfiguration
-
업데이트하려는 신호 채널
SINGLE_MASTER유형에 대한 구성이 포함된 구조입니다.유형: SingleMasterConfiguration객체
필수 항목 여부: 아니요
응답 구문
HTTP/1.1 200
Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 반송합니다.
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- AccessDeniedException
-
이 작업을 수행하는 데 필요한 권한은 없습니다.
HTTP 상태 코드: 401
- ClientLimitExceededException
-
허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.
HTTP 상태 코드: 400
- InvalidArgumentException
-
이 입력 매개변수의 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
입력
StreamARN또는ChannelARNCLOUD_STORAGE_MODE입력이 이미 다른 Kinesis Video Stream 리소스에 매핑되어 있거나 제공된StreamARN입력ChannelARN또는 입력이 활성 상태가 아닌 경우 다음 중 하나를 시도해 보십시오.-
해당 스트림의 채널이 매핑되는 대상을 결정하는
DescribeMediaStorageConfigurationAPI입니다. -
지정된 스트림이 매핑되는 채널을 결정하는
DescribeMappedResourceConfigurationAPI입니다. -
리소스 상태를 확인하기 위한
DescribeStream또는DescribeSignalingChannelAPI입니다.
HTTP 상태 코드: 400
-
- ResourceNotFoundException
-
Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다.
HTTP 상태 코드: 404
- VersionMismatchException
-
지정한 스트림 버전은 최신 버전이 아닙니다. 최신 버전을 가져오려면 DescribeStreamAPI를 사용하세요.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
