기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateStream 새 Kinesis 비디오 스트림을 생성합니다. 새 스트림을 생성하면 Kinesis Video Streams에서 스트림에 버전 번호를 할당합니다. 스트림의 메타데이터를 변경하면 Kinesis Video Streams가 버전을 업데이트합니다. `CreateStream`은 비동기식 작업입니다. 서비스 작동 방식에 대한 자세한 내용을 알아보려면 [작동 방식](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html)을 참조하세요. `KinesisVideo:CreateStream` 작업에 대한 권한이 있어야 합니다. ## Request Syntax ``` POST /createStream HTTP/1.1 Content-type: application/json { "DataRetentionInHours": number, "DeviceName": "string", "KmsKeyId": "string", "MediaType": "string", "StreamName": "string", "StreamStorageConfiguration": { "DefaultStorageTier": "string" }, "Tags": { "string" : "string" } } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DataRetentionInHours](#API_CreateStream_RequestSyntax) ** 스트림에 데이터를 보존하려는 시간입니다. Kinesis Video Streams는 스트림과 연결된 데이터 스토어에 데이터를 보관합니다. 기본값은 0이며, 스트림이 데이터를 유지하지 않음을 나타냅니다. 최소값은 1시간입니다. `DataRetentionInHours` 값이 0인 경우에도 소비자는 보존 시간 제한이 5분이고 보존 메모리 제한이 200MB인 서비스 호스트 버퍼에 남아 있는 조각을 계속 사용할 수 있습니다. 두 제한 중 하나에 도달하면 조각이 버퍼에서 제거됩니다. 유형: 정수 유효 범위: 최소값 0. 필수 여부: 아니요 ** [DeviceName](#API_CreateStream_RequestSyntax) ** 스트림에 쓰는 디바이스의 이름입니다. 현재 구현에서 Kinesis Video Streams는이 이름을 사용하지 않습니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이 128. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [KmsKeyId](#API_CreateStream_RequestSyntax) ** Kinesis Video Streams가 스트림 데이터를 암호화하는 데 사용할 AWS Key Management Service (AWS KMS) 키의 ID입니다. 키 ID를 지정하지 않으면 기본값인 Kinesis Video 관리형 키(`aws/kinesisvideo`)가 사용됩니다. 자세한 내용은 [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters)를 참조하세요. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 패턴: `.+` 필수 여부: 아니요 ** [MediaType](#API_CreateStream_RequestSyntax) ** 스트림의 미디어 유형입니다. 스트림 소비자는 스트림을 처리할 때이 정보를 사용할 수 있습니다. 미디어 유형에 대한 자세한 내용은 [미디어 유형을 참조하세요](http://www.iana.org/assignments/media-types/media-types.xhtml). 를 지정하도록 선택한 경우 지침은 [이름 지정 요구 사항을](https://tools.ietf.org/html/rfc6838#section-4.2) `MediaType`참조하세요. 유효한 값의 예로는 "video/h264" 및 "video/h264,audio/aac"가 있습니다. 이 파라미터는 선택 사항이며 기본값은 입니다`null`(또는 JSON에서는 비어 있음). 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이 128. 패턴: `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` 필수 여부: 아니요 ** [StreamName](#API_CreateStream_RequestSyntax) ** 생성 중인 스트림의 이름입니다. 스트림 이름은 스트림의 식별자이며 각 계정 및 리전에 대해 고유해야 합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [StreamStorageConfiguration](#API_CreateStream_RequestSyntax) ** 스트림 데이터의 기본 스토리지 계층을 포함하여 스트림의 스토리지에 대한 구성입니다. 이 구성은 다양한 수준의 성능과 비용 최적화를 제공하는 다양한 계층을 통해 스트림 데이터를 저장하고 액세스하는 방법을 결정합니다. 지정하지 않으면 스트림은 최적의 성능을 위해 HOT 계층과 함께 기본 스토리지 구성을 사용합니다. 유형: [StreamStorageConfiguration](API_StreamStorageConfiguration.md)객체 필수 여부: 아니요 ** [Tags](#API_CreateStream_RequestSyntax) ** 지정된 스트림과 연결할 태그 목록입니다. 각 태그는 키-값 페어입니다(값은 선택 사항). 유형: 문자열 간 맵 맵 항목: 최대 항목 수는 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" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [StreamARN](#API_CreateStream_ResponseSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** 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입니다. 1. 지정된 스트림이 매핑되는 채널을 결정하는 `DescribeMappedResourceConfiguration` API입니다. 1. 리소스의 상태를 결정하는 `DescribeStream` 또는 `DescribeSignalingChannel` API입니다. HTTP 상태 코드: 400 ** TagsPerResourceExceededLimitException ** 리소스와 연결할 수 있는 태그 제한을 초과했습니다. Kinesis 비디오 스트림은 최대 50개의 태그를 지원할 수 있습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateStream) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateStream)