CreateStream - Amazon Kinesis Video Streams
Request SyntaxURI 요청 파라미터요청 본문응답 구문Response Elements오류참고

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

CreateStream

새 Kinesis 비디오 스트림을 생성합니다.

새 스트림을 생성하면 Kinesis Video Streams에서 스트림에 버전 번호를 할당합니다. 스트림의 메타데이터를 변경하면 Kinesis Video Streams가 버전을 업데이트합니다.

CreateStream은 비동기식 작업입니다.

서비스 작동 방식에 대한 자세한 내용을 알아보려면 작동 방식을 참조하세요.

KinesisVideo:CreateStream 작업에 대한 권한이 있어야 합니다.

Request Syntax

POST /createStream HTTP/1.1
Content-type: application/json

{
   "DataRetentionInHours": number,
   "DeviceName": "string",
   "KmsKeyId": "string",
   "MediaType": "string",
   "StreamName": "string",
   "Tags": { 
      "string" : "string" 
   }
}

URI 요청 파라미터

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

요청 본문

요청은 JSON 형식의 다음 데이터를 수락합니다.

DataRetentionInHours

스트림에 데이터를 보존하려는 시간입니다. Kinesis Video Streams는 스트림과 연결된 데이터 스토어에 데이터를 보관합니다.

기본값은 0이며, 스트림이 데이터를 유지하지 않음을 나타냅니다. 최소값은 1시간입니다.

DataRetentionInHours 값이 0인 경우에도 소비자는 서비스 호스트 버퍼에 남아 있는 조각을 사용할 수 있습니다. 이 조각의 보존 시간 제한은 5분이고 보존 메모리 제한은 200MB입니다. 두 제한 중 하나에 도달하면 조각이 버퍼에서 제거됩니다.

유형: 정수

유효 범위: 최소값 0.

필수 여부: 아니요

DeviceName

스트림에 쓰는 디바이스의 이름입니다.

참고

현재 구현에서는 Kinesis Video Streams가 이 이름을 사용하지 않습니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

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

Required: No

KmsKeyId

Kinesis Video Streams가 스트림 데이터를 암호화하는 데 사용할 AWS Key Management Service (AWS KMS) 키의 ID입니다.

키 ID를 지정하지 않으면 기본값인 Kinesis Video 관리형 키( AWS/kinesisvideo)가 사용됩니다.

자세한 내용은 DescribeKey를 참조하세요.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이는 2,048.

패턴: .+

Required: No

MediaType

스트림의 미디어 유형입니다. 스트림 소비자는 스트림을 처리할 때 이 정보를 사용할 수 있습니다. 미디어 유형에 대한 자세한 내용은 미디어 유형 섹션을 참조하세요. 를 지정하도록 선택한 경우 지침은 이름 지정 요구 사항을 MediaType참조하세요.

유효한 값의 예는 “video/h264" and "video/h264,audio/aac”입니다.

이 파라미터는 선택 사항이며 기본값은 null (또는 에서 비어 있음)입니다JSON.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

패턴: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

Required: No

StreamName

생성 중인 스트림의 이름입니다.

스트림 이름은 스트림의 식별자이며 각 계정 및 리전마다 고유해야 합니다.

유형: 문자열

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

Pattern: [a-zA-Z0-9_.-]+

필수 여부: 예

Tags

지정된 스트림과 연결할 태그 목록입니다. 각 태그는 키-값 페어입니다(값은 선택 사항임).

유형: 문자열 간 맵

맵 항목: 최대 항목 수는 50입니다.

키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.

키 패턴: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

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

값 패턴: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

필수 항목 여부: 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "StreamARN": "string"
}

Response Elements

작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.

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

StreamARN

스트림의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

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

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

오류

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.

AccountStreamLimitExceededException

계정에 대해 생성된 스트림 수가 너무 많습니다.

HTTP 상태 코드: 400

ClientLimitExceededException

Kinesis Video Streams는 허용된 클라이언트 호출 한도를 초과했기 때문에 요청을 제한했습니다. 나중에 직접 직접 호출해 보세요.

HTTP 상태 코드: 400

DeviceStreamLimitExceededException

구현되지 않음.

HTTP 상태 코드: 400

InvalidArgumentException

이 입력 파라미터의 값이 유효하지 않습니다.

HTTP 상태 코드: 400

InvalidDeviceException

구현되지 않음.

HTTP 상태 코드: 400

ResourceInUseException

입력 StreamARN 또는 ChannelARN의 CLOUD_STORAGE_MODE가 다른 Kinesis Video Stream 리소스에 이미 매핑되었거나 제공된 입력 StreamARN 또는 ChannelARN가 활성 상태가 아닌 경우 다음 중 하나를 시도합니다.

  1. 지정된 채널이 매핑되는 스트림을 결정하는 DescribeMediaStorageConfiguration API 입니다.

  2. 지정된 스트림이 매핑되는 채널을 결정하는 DescribeMappedResourceConfiguration API 입니다.

  3. DescribeStream 또는 를 DescribeSignalingChannel API 사용하여 리소스의 상태를 결정합니다.

HTTP 상태 코드: 400

TagsPerResourceExceededLimitException

리소스와 연결할 수 있는 태그 한도를 초과했습니다. Kinesis 비디오 스트림은 최대 50개의 태그를 지원할 수 있습니다.

HTTP 상태 코드: 400

참고

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