기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 작업 Amazon Kinesis Video Streams에서 지원하는 작업은 다음과 같습니다. + [CreateSignalingChannel](API_CreateSignalingChannel.md) + [CreateStream](API_CreateStream.md) + [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) + [DeleteSignalingChannel](API_DeleteSignalingChannel.md) + [DeleteStream](API_DeleteStream.md) + [DescribeEdgeConfiguration](API_DescribeEdgeConfiguration.md) + [DescribeImageGenerationConfiguration](API_DescribeImageGenerationConfiguration.md) + [DescribeMappedResourceConfiguration](API_DescribeMappedResourceConfiguration.md) + [DescribeMediaStorageConfiguration](API_DescribeMediaStorageConfiguration.md) + [DescribeNotificationConfiguration](API_DescribeNotificationConfiguration.md) + [DescribeSignalingChannel](API_DescribeSignalingChannel.md) + [DescribeStream](API_DescribeStream.md) + [DescribeStreamStorageConfiguration](API_DescribeStreamStorageConfiguration.md) + [GetDataEndpoint](API_GetDataEndpoint.md) + [GetSignalingChannelEndpoint](API_GetSignalingChannelEndpoint.md) + [ListEdgeAgentConfigurations](API_ListEdgeAgentConfigurations.md) + [ListSignalingChannels](API_ListSignalingChannels.md) + [ListStreams](API_ListStreams.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ListTagsForStream](API_ListTagsForStream.md) + [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) + [TagResource](API_TagResource.md) + [TagStream](API_TagStream.md) + [UntagResource](API_UntagResource.md) + [UntagStream](API_UntagStream.md) + [UpdateDataRetention](API_UpdateDataRetention.md) + [UpdateImageGenerationConfiguration](API_UpdateImageGenerationConfiguration.md) + [UpdateMediaStorageConfiguration](API_UpdateMediaStorageConfiguration.md) + [UpdateNotificationConfiguration](API_UpdateNotificationConfiguration.md) + [UpdateSignalingChannel](API_UpdateSignalingChannel.md) + [UpdateStream](API_UpdateStream.md) + [UpdateStreamStorageConfiguration](API_UpdateStreamStorageConfiguration.md) Amazon Kinesis Video Streams Media에서 지원하는 작업은 다음과 같습니다. + [GetMedia](API_dataplane_GetMedia.md) + [PutMedia](API_dataplane_PutMedia.md) Amazon Kinesis Video Streams Archived Media에서 지원하는 작업은 다음과 같습니다. + [GetClip](API_reader_GetClip.md) + [GetDASHStreamingSessionURL](API_reader_GetDASHStreamingSessionURL.md) + [GetHLSStreamingSessionURL](API_reader_GetHLSStreamingSessionURL.md) + [GetImages](API_reader_GetImages.md) + [GetMediaForFragmentList](API_reader_GetMediaForFragmentList.md) + [ListFragments](API_reader_ListFragments.md) Amazon Kinesis Video Signaling 채널에서 지원하는 작업은 다음과 같습니다. + [GetIceServerConfig](API_signaling_GetIceServerConfig.md) + [SendAlexaOfferToMaster](API_signaling_SendAlexaOfferToMaster.md) Amazon Kinesis Video WebRTC Storage에서 지원하는 작업은 다음과 같습니다. + [JoinStorageSession](API_webrtc_JoinStorageSession.md) + [JoinStorageSessionAsViewer](API_webrtc_JoinStorageSessionAsViewer.md) # Amazon Kinesis Video Streams Amazon Kinesis Video Streams에서 지원하는 작업은 다음과 같습니다. + [CreateSignalingChannel](API_CreateSignalingChannel.md) + [CreateStream](API_CreateStream.md) + [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) + [DeleteSignalingChannel](API_DeleteSignalingChannel.md) + [DeleteStream](API_DeleteStream.md) + [DescribeEdgeConfiguration](API_DescribeEdgeConfiguration.md) + [DescribeImageGenerationConfiguration](API_DescribeImageGenerationConfiguration.md) + [DescribeMappedResourceConfiguration](API_DescribeMappedResourceConfiguration.md) + [DescribeMediaStorageConfiguration](API_DescribeMediaStorageConfiguration.md) + [DescribeNotificationConfiguration](API_DescribeNotificationConfiguration.md) + [DescribeSignalingChannel](API_DescribeSignalingChannel.md) + [DescribeStream](API_DescribeStream.md) + [DescribeStreamStorageConfiguration](API_DescribeStreamStorageConfiguration.md) + [GetDataEndpoint](API_GetDataEndpoint.md) + [GetSignalingChannelEndpoint](API_GetSignalingChannelEndpoint.md) + [ListEdgeAgentConfigurations](API_ListEdgeAgentConfigurations.md) + [ListSignalingChannels](API_ListSignalingChannels.md) + [ListStreams](API_ListStreams.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ListTagsForStream](API_ListTagsForStream.md) + [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) + [TagResource](API_TagResource.md) + [TagStream](API_TagStream.md) + [UntagResource](API_UntagResource.md) + [UntagStream](API_UntagStream.md) + [UpdateDataRetention](API_UpdateDataRetention.md) + [UpdateImageGenerationConfiguration](API_UpdateImageGenerationConfiguration.md) + [UpdateMediaStorageConfiguration](API_UpdateMediaStorageConfiguration.md) + [UpdateNotificationConfiguration](API_UpdateNotificationConfiguration.md) + [UpdateSignalingChannel](API_UpdateSignalingChannel.md) + [UpdateStream](API_UpdateStream.md) + [UpdateStreamStorageConfiguration](API_UpdateStreamStorageConfiguration.md) # CreateSignalingChannel 신호 채널을 생성합니다. `CreateSignalingChannel`은 비동기식 작업입니다. ## Request Syntax ``` POST /createSignalingChannel HTTP/1.1 Content-type: application/json { "ChannelName": "string", "ChannelType": "string", "SingleMasterConfiguration": { "MessageTtlSeconds": number }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelName](#API_CreateSignalingChannel_RequestSyntax) ** 생성하고 있는 신호 채널의 이름입니다. 각 AWS 계정 및에 대해 고유해야 합니다 AWS 리전. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [ChannelType](#API_CreateSignalingChannel_RequestSyntax) ** 생성하고 있는 신호 채널의 유형입니다. 현재는 `SINGLE_MASTER` 채널 유형만 지원됩니다. 타입: 문자열 유효 값: `SINGLE_MASTER | FULL_MESH` 필수 여부: 아니요 ** [SingleMasterConfiguration](#API_CreateSignalingChannel_RequestSyntax) ** `SINGLE_MASTER` 채널 유형에 대한 구성을 포함하는 구조입니다. 채널 메시지의 라이브 시간에 대한 기본 구성은 60초(1분)입니다. 유형: [SingleMasterConfiguration](API_SingleMasterConfiguration.md)객체 필수 여부: 아니요 ** [Tags](#API_CreateSignalingChannel_RequestSyntax) ** 이 채널과 연결할 태그 세트(키-값 페어)입니다. 타입: [Tag](API_Tag.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "ChannelARN": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ChannelARN](#API_CreateSignalingChannel_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) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** AccountChannelLimitExceededException ** 이 리전에서이 AWS 계정 에 대한 활성 신호 채널의 최대 한도에 도달했습니다. HTTP 상태 코드: 400 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. 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/CreateSignalingChannel) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateSignalingChannel) # 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) # DeleteEdgeConfiguration 스트림의 기존 엣지 구성과 Edge Agent에서 해당 미디어를 삭제하는 비동기 API입니다. 이 API를 호출하면 동기화 상태가 로 설정됩니다`DELETING`. 활성 엣지 작업이 중지되고 모든 미디어가 엣지 디바이스에서 삭제되는 삭제 프로세스가 시작됩니다. 삭제 시간은 저장된 미디어의 총량에 따라 달라집니다. 삭제 프로세스가 실패하면 동기화 상태가 로 변경됩니다`DELETE_FAILED`. 삭제를 다시 시도해야 합니다. 삭제 프로세스가 성공적으로 완료되면 엣지 구성에 더 이상 액세스할 수 없습니다. **참고** AWS 아프리카(케이프타운) 리전인 af-south-1에서는이 API를 사용할 수 없습니다. ## Request Syntax ``` POST /deleteEdgeConfiguration HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_DeleteEdgeConfiguration_RequestSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DeleteEdgeConfiguration_RequestSyntax) ** 엣지 구성을 삭제할 스트림의 이름입니다. `StreamName` 또는를 지정합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** StreamEdgeConfigurationNotFoundException ** Amazon Kinesis Video Stream이 지정한 스트림의 엣지 구성을 찾을 수 없을 때 렌더링되는 예외입니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DeleteEdgeConfiguration) # DeleteSignalingChannel 지정된 신호 채널을 삭제합니다. `DeleteSignalingChannel`는 비동기 작업입니다. 채널의 현재 버전을 지정하지 않으면 최신 버전이 삭제됩니다. ## Request Syntax ``` POST /deleteSignalingChannel HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "CurrentVersion": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelARN](#API_DeleteSignalingChannel_RequestSyntax) ** 삭제하려는 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [CurrentVersion](#API_DeleteSignalingChannel_RequestSyntax) ** 삭제하려는 신호 채널의 현재 버전입니다. `DescribeSignalingChannel` 또는 `ListSignalingChannels` API 작업을 호출하여 현재 버전을 가져올 수 있습니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** VersionMismatchException ** 지정한 스트림 버전이 최신 버전이 아닙니다. 최신 버전을 가져오려면 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API를 사용합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DeleteSignalingChannel) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DeleteSignalingChannel) # DeleteStream Kinesis 비디오 스트림과 스트림에 포함된 데이터를 삭제합니다. 이 메서드는 스트림을 삭제 대상으로 표시하고 스트림의 데이터에 즉시 액세스할 수 없게 만듭니다. 스트림을 삭제하기 전에 최신 버전의 스트림이 있는지 확인하려면 스트림 버전을 지정할 수 있습니다. Kinesis Video Streams는 각 스트림에 버전을 할당합니다. 스트림을 업데이트하면 Kinesis Video Streams가 새 버전 번호를 할당합니다. 최신 스트림 버전을 가져오려면 `DescribeStream` API를 사용합니다. 이 작업에는 `KinesisVideo:DeleteStream` 작업에 대한 권한이 필요합니다. ## Request Syntax ``` POST /deleteStream HTTP/1.1 Content-type: application/json { "CurrentVersion": "string", "StreamARN": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CurrentVersion](#API_DeleteStream_RequestSyntax) ** 선택 사항: 삭제하려는 스트림의 버전입니다. 가 올바른 스트림을 삭제하고 있는지 확인하기 위한 보호 수단으로 버전을 지정합니다. 스트림 버전을 가져오려면 `DescribeStream` API를 사용합니다. 지정하지 않으면 스트림을 삭제하기 전에 만 확인`CreationTime`됩니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 아니요 ** [StreamARN](#API_DeleteStream_RequestSyntax) ** 삭제하려는 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceInUseException ** 의 입력 `StreamARN` 또는 `ChannelARN``CLOUD_STORAGE_MODE`가 다른 Kinesis Video Stream 리소스에 이미 매핑되어 있거나 제공된 입력 `StreamARN` 또는 `ChannelARN`가 활성 상태가 아닌 경우 다음 중 하나를 시도합니다. 1. 지정된 채널이 매핑되는 스트림을 결정하는 `DescribeMediaStorageConfiguration` API입니다. 1. 지정된 스트림이 매핑되는 채널을 결정하는 `DescribeMappedResourceConfiguration` API입니다. 1. 리소스의 상태를 결정하는 `DescribeStream` 또는 `DescribeSignalingChannel` API입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** VersionMismatchException ** 지정한 스트림 버전이 최신 버전이 아닙니다. 최신 버전을 가져오려면 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API를 사용합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DeleteStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DeleteStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DeleteStream) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DeleteStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DeleteStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DeleteStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DeleteStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DeleteStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DeleteStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DeleteStream) # DescribeEdgeConfiguration `StartEdgeConfigurationUpdate` API를 사용하여 설정된 스트림의 엣지 구성과 엣지 에이전트의 레코더 및 업로더 작업의 최신 상태를 설명합니다. 이 API를 사용하여 구성의 상태를 가져와 구성이 Edge 에이전트와 동기화되어 있는지 확인합니다. 이 API를 사용하여 Edge 에이전트의 상태를 평가합니다. **참고** AWS 아프리카(케이프타운) 리전인 af-south-1에서는이 API를 사용할 수 없습니다. ## Request Syntax ``` POST /describeEdgeConfiguration HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_DescribeEdgeConfiguration_RequestSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName`또는를 지정합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DescribeEdgeConfiguration_RequestSyntax) ** 엣지 구성을 업데이트하려는 스트림의 이름입니다. `StreamName` 또는를 지정합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "EdgeAgentStatus": { "LastRecorderStatus": { "JobStatusDetails": "string", "LastCollectedTime": number, "LastUpdatedTime": number, "RecorderStatus": "string" }, "LastUploaderStatus": { "JobStatusDetails": "string", "LastCollectedTime": number, "LastUpdatedTime": number, "UploaderStatus": "string" } }, "EdgeConfig": { "DeletionConfig": { "DeleteAfterUpload": boolean, "EdgeRetentionInHours": number, "LocalSizeConfig": { "MaxLocalMediaSizeInMB": number, "StrategyOnFullSize": "string" } }, "HubDeviceArn": "string", "RecorderConfig": { "MediaSourceConfig": { "MediaUriSecretArn": "string", "MediaUriType": "string" }, "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } }, "UploaderConfig": { "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } } }, "FailedStatusDetails": "string", "LastUpdatedTime": number, "StreamARN": "string", "StreamName": "string", "SyncStatus": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CreationTime](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 스트림의 엣지 구성이 처음 생성된 타임스탬프입니다. 유형: 타임스탬프 ** [EdgeAgentStatus](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 엣지 에이전트의 레코더 및 업로더 작업에 대한 최신 상태 세부 정보가 포함된 객체입니다. 이 정보를 사용하여 엣지 에이전트의 현재 상태를 확인합니다. 유형: [EdgeAgentStatus](API_EdgeAgentStatus.md)객체 ** [EdgeConfig](#API_DescribeEdgeConfiguration_ResponseSyntax) ** Edge Agent IoT Greengrass 구성 요소와 동기화하는 데 사용할 스트림의 엣지 구성에 대한 설명입니다. Edge Agent 구성 요소는 온프레미스의 IoT Hub 디바이스 설정에서 실행됩니다. 유형: [EdgeConfig](API_EdgeConfig.md)객체 ** [FailedStatusDetails](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 생성된 실패 상태에 대한 설명입니다. 유형: 문자열 ** [LastUpdatedTime](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 스트림의 엣지 구성이 마지막으로 업데이트된 타임스탬프입니다. 유형: 타임스탬프 ** [StreamARN](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ** [StreamName](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 엣지 구성이 업데이트된 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` ** [SyncStatus](#API_DescribeEdgeConfiguration_ResponseSyntax) ** 엣지 구성 업데이트의 최신 상태입니다. 타입: 문자열 유효 값: `SYNCING | ACKNOWLEDGED | IN_SYNC | SYNC_FAILED | DELETING | DELETE_FAILED | DELETING_ACKNOWLEDGED` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** StreamEdgeConfigurationNotFoundException ** Amazon Kinesis Video Stream이 지정한 스트림의 엣지 구성을 찾을 수 없을 때 렌더링되는 예외입니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeEdgeConfiguration) # DescribeImageGenerationConfiguration 지정된 Kinesis 비디오 스트림에 `ImageGenerationConfiguration` 대한를 가져옵니다. ## Request Syntax ``` POST /describeImageGenerationConfiguration HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_DescribeImageGenerationConfiguration_RequestSyntax) ** 이미지 생성 구성을 검색할 Kinesis 비디오 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DescribeImageGenerationConfiguration_RequestSyntax) ** 이미지 생성 구성을 검색할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "ImageGenerationConfiguration": { "DestinationConfig": { "DestinationRegion": "string", "Uri": "string" }, "Format": "string", "FormatConfig": { "string" : "string" }, "HeightPixels": number, "ImageSelectorType": "string", "SamplingInterval": number, "Status": "string", "WidthPixels": number } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ImageGenerationConfiguration](#API_DescribeImageGenerationConfiguration_ResponseSyntax) ** Kinesis 비디오 스트림(KVS) 이미지 전송에 필요한 정보가 포함된 구조입니다. 이 구조가 null이면 구성이 스트림에서 삭제됩니다. 타입: [ImageGenerationConfiguration](API_ImageGenerationConfiguration.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeImageGenerationConfiguration) # DescribeMappedResourceConfiguration 스트림에 대한 최신 정보를 반환합니다. 입력에 `streamName` 또는를 제공해야 `streamARN` 합니다. ## Request Syntax ``` POST /describeMappedResourceConfiguration HTTP/1.1 Content-type: application/json { "MaxResults": number, "NextToken": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_DescribeMappedResourceConfiguration_RequestSyntax) ** 응답에 반환할 최대 결과 수입니다. 유형: 정수 유효한 범위: 고정 값 1. 필수 여부: 아니요 ** [NextToken](#API_DescribeMappedResourceConfiguration_RequestSyntax) ** 다른 결과 배치를 가져오기 위해 다음 요청에서 제공할 토큰입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` 필수 여부: 아니요 ** [StreamARN](#API_DescribeMappedResourceConfiguration_RequestSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DescribeMappedResourceConfiguration_RequestSyntax) ** 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "MappedResourceConfigurationList": [ { "ARN": "string", "Type": "string" } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [MappedResourceConfigurationList](#API_DescribeMappedResourceConfiguration_ResponseSyntax) ** 미디어 스토리지 구성 속성을 캡슐화하거나 포함하는 구조입니다. 타입: [MappedResourceConfigurationListItem](API_MappedResourceConfigurationListItem.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [NextToken](#API_DescribeMappedResourceConfiguration_ResponseSyntax) ** `NextToken`요청에 사용된 토큰을 사용하여 다음 결과 세트를 가져옵니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration) # DescribeMediaStorageConfiguration 채널에 대한 최신 정보를 반환합니다. 입력에서 `ChannelName` 또는 `ChannelARN`를 지정합니다. ## Request Syntax ``` POST /describeMediaStorageConfiguration HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "ChannelName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelARN](#API_DescribeMediaStorageConfiguration_RequestSyntax) ** 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [ChannelName](#API_DescribeMediaStorageConfiguration_RequestSyntax) ** 채널의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "MediaStorageConfiguration": { "Status": "string", "StreamARN": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [MediaStorageConfiguration](#API_DescribeMediaStorageConfiguration_ResponseSyntax) ** 미디어 스토리지 구성 속성을 캡슐화하거나 포함하는 구조입니다. 타입: [MediaStorageConfiguration](API_MediaStorageConfiguration.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration) # DescribeNotificationConfiguration 지정된 Kinesis 비디오 스트림에 `NotificationConfiguration` 대한를 가져옵니다. ## Request Syntax ``` POST /describeNotificationConfiguration HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_DescribeNotificationConfiguration_RequestSyntax) ** 알림 구성을 검색할 Kinesis 비디오 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는 StreamARN을 지정해야 합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DescribeNotificationConfiguration_RequestSyntax) ** 알림 구성을 검색할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "NotificationConfiguration": { "DestinationConfig": { "Uri": "string" }, "Status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NotificationConfiguration](#API_DescribeNotificationConfiguration_ResponseSyntax) ** 알림에 필요한 정보가 포함된 구조입니다. 구조가 null이면 구성이 스트림에서 삭제됩니다. 타입: [NotificationConfiguration](API_NotificationConfiguration.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeNotificationConfiguration) # DescribeSignalingChannel 신호 채널에 대한 최신 정보를 반환합니다. 설명하려는 채널의 이름 또는 Amazon 리소스 이름(ARN)을 지정해야 합니다. ## Request Syntax ``` POST /describeSignalingChannel HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "ChannelName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelARN](#API_DescribeSignalingChannel_RequestSyntax) ** 설명할 신호 채널의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [ChannelName](#API_DescribeSignalingChannel_RequestSyntax) ** 설명할 신호 채널의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "ChannelInfo": { "ChannelARN": "string", "ChannelName": "string", "ChannelStatus": "string", "ChannelType": "string", "CreationTime": number, "SingleMasterConfiguration": { "MessageTtlSeconds": number }, "Version": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ChannelInfo](#API_DescribeSignalingChannel_ResponseSyntax) ** 지정된 신호 채널의 메타데이터 및 속성을 캡슐화하는 구조입니다. 타입: [ChannelInfo](API_ChannelInfo.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeSignalingChannel) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeSignalingChannel) # DescribeStream 지정된 스트림에 대한 최신 정보를 반환합니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. ## Request Syntax ``` POST /describeStream HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_DescribeStream_RequestSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DescribeStream_RequestSyntax) ** 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "StreamInfo": { "CreationTime": number, "DataRetentionInHours": number, "DeviceName": "string", "KmsKeyId": "string", "MediaType": "string", "Status": "string", "StreamARN": "string", "StreamName": "string", "Version": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [StreamInfo](#API_DescribeStream_ResponseSyntax) ** 스트림을 설명하는 객체입니다. 타입: [StreamInfo](API_StreamInfo.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeStream) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeStream) # DescribeStreamStorageConfiguration 지정된 Kinesis 비디오 스트림에 대한 현재 스토리지 구성을 검색합니다. 요청에서 `StreamName` 또는를 지정해야 합니다`StreamARN`. `KinesisVideo:DescribeStreamStorageConfiguration` 작업에 대한 권한이 있어야 합니다. ## Request Syntax ``` POST /describeStreamStorageConfiguration HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_DescribeStreamStorageConfiguration_RequestSyntax) ** 스토리지 구성을 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_DescribeStreamStorageConfiguration_RequestSyntax) ** 스토리지 구성을 검색할 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "StreamARN": "string", "StreamName": "string", "StreamStorageConfiguration": { "DefaultStorageTier": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [StreamARN](#API_DescribeStreamStorageConfiguration_ResponseSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ** [StreamName](#API_DescribeStreamStorageConfiguration_ResponseSyntax) ** 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` ** [StreamStorageConfiguration](#API_DescribeStreamStorageConfiguration_ResponseSyntax) ** 기본 스토리지 계층 및 기타 스토리지 관련 설정을 포함하여 스트림의 현재 스토리지 구성입니다. 타입: [StreamStorageConfiguration](API_StreamStorageConfiguration.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration) # 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_GetDataEndpoint_RequestSyntax) ** 엔드포인트를 가져올 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](#API_GetDataEndpoint_RequestSyntax) ** 엔드포인트를 가져오려는 스트림의 Amazon 리소스 이름(ARN)입니다. 요청`StreamName`에서이 파라미터 또는를 지정해야 합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_GetDataEndpoint_RequestSyntax) ** 엔드포인트를 가져오려는 스트림의 이름입니다. 요청`StreamARN`에서이 파라미터 또는를 지정해야 합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "DataEndpoint": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [DataEndpoint](#API_GetDataEndpoint_ResponseSyntax) ** 엔드포인트 값입니다. 스트림에서 데이터를 읽거나 스트림에 데이터를 쓰려면 애플리케이션에서이 엔드포인트를 지정합니다. 유형: 문자열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/GetDataEndpoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/GetDataEndpoint) # 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](#API_GetSignalingChannelEndpoint_RequestSyntax) ** 엔드포인트를 가져오려는 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [SingleMasterChannelEndpointConfiguration](#API_GetSignalingChannelEndpoint_RequestSyntax) ** `SINGLE_MASTER` 채널 유형에 대한 엔드포인트 구성을 포함하는 구조입니다. 유형: [SingleMasterChannelEndpointConfiguration](API_SingleMasterChannelEndpointConfiguration.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "ResourceEndpointList": [ { "Protocol": "string", "ResourceEndpoint": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ResourceEndpointList](#API_GetSignalingChannelEndpoint_ResponseSyntax) ** 지정된 신호 채널의 엔드포인트 목록입니다. 타입: [ResourceEndpointListItem](API_ResourceEndpointListItem.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) # ListEdgeAgentConfigurations 지정된 Edge Agent와 연결된 엣지 구성의 배열을 반환합니다. 요청에서 Edge 에이전트를 지정해야 합니다`HubDeviceArn`. **참고** AWS 아프리카(케이프타운) 리전인 af-south-1에서는이 API를 사용할 수 없습니다. ## Request Syntax ``` POST /listEdgeAgentConfigurations HTTP/1.1 Content-type: application/json { "HubDeviceArn": "string", "MaxResults": number, "NextToken": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [HubDeviceArn](#API_ListEdgeAgentConfigurations_RequestSyntax) ** 엣지 에이전트의 "사물 인터넷(IoT) 사물" Arn입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:iot:[a-z0-9-]+:[0-9]+:thing/[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [MaxResults](#API_ListEdgeAgentConfigurations_RequestSyntax) ** 응답에 반환할 최대 엣지 구성 수입니다. 기본값은 5입니다. 타입: 정수 유효한 범위: 최소값 1. 최대값은 10입니다. 필수 여부: 아니요 ** [NextToken](#API_ListEdgeAgentConfigurations_RequestSyntax) ** 이 파라미터를 지정하면 `ListEdgeAgentConfigurations` 작업 결과가 잘리면 호출이 응답`NextToken`에를 반환합니다. 또 다른 엣지 구성 배치를 가져오려면 다음 요청에서이 토큰을 제공합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "EdgeConfigs": [ { "CreationTime": number, "EdgeConfig": { "DeletionConfig": { "DeleteAfterUpload": boolean, "EdgeRetentionInHours": number, "LocalSizeConfig": { "MaxLocalMediaSizeInMB": number, "StrategyOnFullSize": "string" } }, "HubDeviceArn": "string", "RecorderConfig": { "MediaSourceConfig": { "MediaUriSecretArn": "string", "MediaUriType": "string" }, "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } }, "UploaderConfig": { "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } } }, "FailedStatusDetails": "string", "LastUpdatedTime": number, "StreamARN": "string", "StreamName": "string", "SyncStatus": "string" } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [EdgeConfigs](#API_ListEdgeAgentConfigurations_ResponseSyntax) ** 단일 스트림의 엣지 구성에 대한 설명입니다. 타입: [ListEdgeAgentConfigurationsEdgeConfig](API_ListEdgeAgentConfigurationsEdgeConfig.md)객체 배열 ** [NextToken](#API_ListEdgeAgentConfigurations_ResponseSyntax) ** 응답이 잘린 경우 호출은 지정된 토큰과 함께이 요소를 반환합니다. 다음 엣지 구성 배치를 가져오려면 다음 요청에서이 토큰을 사용합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/ListEdgeAgentConfigurations) # ListSignalingChannels `ChannelInfo` 객체의 배열을 반환합니다. 각 객체는 신호 채널을 설명합니다. 특정 조건을 충족하는 채널만 검색하려면를 지정할 수 있습니다`ChannelNameCondition`. ## Request Syntax ``` POST /listSignalingChannels HTTP/1.1 Content-type: application/json { "ChannelNameCondition": { "ComparisonOperator": "string", "ComparisonValue": "string" }, "MaxResults": number, "NextToken": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelNameCondition](#API_ListSignalingChannels_RequestSyntax) ** 선택 사항: 특정 조건을 충족하는 채널만 반환합니다. 유형: [ChannelNameCondition](API_ChannelNameCondition.md)객체 필수 여부: 아니요 ** [MaxResults](#API_ListSignalingChannels_RequestSyntax) ** 응답에서 반환할 최대 채널 수입니다. 기본값은 500입니다. 타입: 정수 유효한 범위: 최소값 1. 최대값은 10,000입니다. 필수 여부: 아니요 ** [NextToken](#API_ListSignalingChannels_RequestSyntax) ** 이 파라미터를 지정하면 `ListSignalingChannels` 작업 결과가 잘리면 호출이 응답`NextToken`에를 반환합니다. 다른 채널 배치를 가져오려면 다음 요청에서이 토큰을 제공합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "ChannelInfoList": [ { "ChannelARN": "string", "ChannelName": "string", "ChannelStatus": "string", "ChannelType": "string", "CreationTime": number, "SingleMasterConfiguration": { "MessageTtlSeconds": number }, "Version": "string" } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ChannelInfoList](#API_ListSignalingChannels_ResponseSyntax) ** `ChannelInfo` 객체 어레이. 타입: [ChannelInfo](API_ChannelInfo.md)객체 배열 ** [NextToken](#API_ListSignalingChannels_ResponseSyntax) ** 응답이 잘린 경우 호출은 토큰과 함께이 요소를 반환합니다. 다음 스트림 배치를 가져오려면 다음 요청에서이 토큰을 사용합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/ListSignalingChannels) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/ListSignalingChannels) # ListStreams `StreamInfo` 객체의 배열을 반환합니다. 각 객체는 스트림을 설명합니다. 특정 조건을 충족하는 스트림만 검색하려면를 지정할 수 있습니다`StreamNameCondition`. ## Request Syntax ``` POST /listStreams HTTP/1.1 Content-type: application/json { "MaxResults": number, "NextToken": "string", "StreamNameCondition": { "ComparisonOperator": "string", "ComparisonValue": "string" } } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_ListStreams_RequestSyntax) ** 응답에서 반환할 최대 스트림 수입니다. 기본값은 10,000입니다. 타입: 정수 유효한 범위: 최소값 1. 최대값은 10,000입니다. 필수 여부: 아니요 ** [NextToken](#API_ListStreams_RequestSyntax) ** 이 파라미터를 지정하면 `ListStreams` 작업 결과가 잘리면 호출이 응답`NextToken`에를 반환합니다. 다른 스트림 배치를 가져오려면 다음 요청에서이 토큰을 제공합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` 필수 여부: 아니요 ** [StreamNameCondition](#API_ListStreams_RequestSyntax) ** 선택 사항: 특정 조건을 충족하는 스트림만 반환합니다. 현재 스트림 이름의 접두사만 조건으로 지정할 수 있습니다. 유형: [StreamNameCondition](API_StreamNameCondition.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "StreamInfoList": [ { "CreationTime": number, "DataRetentionInHours": number, "DeviceName": "string", "KmsKeyId": "string", "MediaType": "string", "Status": "string", "StreamARN": "string", "StreamName": "string", "Version": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListStreams_ResponseSyntax) ** 응답이 잘린 경우 호출은 토큰과 함께이 요소를 반환합니다. 다음 스트림 배치를 가져오려면 다음 요청에서이 토큰을 사용합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` ** [StreamInfoList](#API_ListStreams_ResponseSyntax) ** `StreamInfo` 객체 어레이. 타입: [StreamInfo](API_StreamInfo.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/ListStreams) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/ListStreams) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ListStreams) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/ListStreams) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/ListStreams) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/ListStreams) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/ListStreams) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/ListStreams) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/ListStreams) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/ListStreams) # ListTagsForResource 지정된 신호 채널과 연결된 태그 목록을 반환합니다. ## Request Syntax ``` POST /ListTagsForResource HTTP/1.1 Content-type: application/json { "NextToken": "string", "ResourceARN": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [NextToken](#API_ListTagsForResource_RequestSyntax) ** 이 파라미터를 지정하고 `ListTagsForResource` 호출 결과가 잘린 경우 응답에는 다음 요청에서 다음 태그 배치를 가져오는 데 사용할 수 있는 토큰이 포함됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` 필수 여부: 아니요 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 태그를 나열하려는 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Tags": { "string" : "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListTagsForResource_ResponseSyntax) ** 이 파라미터를 지정하고 `ListTagsForResource` 호출 결과가 잘린 경우 응답에는 다음 요청에서 다음 태그 세트를 가져오는 데 사용할 수 있는 토큰이 포함됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 지정된 신호 채널과 연결된 태그 키 및 값의 맵입니다. 유형: 문자열 간 맵 맵 항목: 최대 항목 수는 50입니다. 키 길이 제약 조건: 최소 길이는 1. 최대 길이 128. 키 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256. 가치 패턴: `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/ListTagsForResource) # ListTagsForStream 지정된 스트림과 연결된 태그 목록을 반환합니다. 요청에서 `StreamName` 또는를 지정해야 합니다`StreamARN`. ## Request Syntax ``` POST /listTagsForStream HTTP/1.1 Content-type: application/json { "NextToken": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [NextToken](#API_ListTagsForStream_RequestSyntax) ** 이 파라미터를 지정하고 `ListTagsForStream` 호출 결과가 잘린 경우 응답에는 다음 요청에서 다음 태그 배치를 가져오는 데 사용할 수 있는 토큰이 포함됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` 필수 여부: 아니요 ** [StreamARN](#API_ListTagsForStream_RequestSyntax) ** 태그를 나열하려는 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_ListTagsForStream_RequestSyntax) ** 태그를 나열하려는 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Tags": { "string" : "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListTagsForStream_ResponseSyntax) ** 이 파라미터를 지정하고 `ListTags` 호출 결과가 잘린 경우 응답에는 다음 요청에서 다음 태그 세트를 가져오는 데 사용할 수 있는 토큰이 포함됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9+/=]*` ** [Tags](#API_ListTagsForStream_ResponseSyntax) ** 지정된 스트림과 연결된 태그 키 및 값의 맵입니다. 유형: 문자열 간 맵 맵 항목: 최대 항목 수는 50입니다. 키 길이 제약 조건: 최소 길이는 1. 최대 길이 128. 키 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256. 가치 패턴: `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** InvalidResourceFormatException ** 의 형식`StreamARN`이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/ListTagsForStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/ListTagsForStream) # StartEdgeConfigurationUpdate 스트림의 기존 엣지 구성을 업데이트하는 비동기 API입니다. Kinesis Video Stream은 스트림의 엣지 구성을 IoT Hub 디바이스에서 실행되는 Edge Agent IoT Greengrass 구성 요소와 동기화하고 온프레미스에서 설정합니다. 동기화 시간은 허브 디바이스의 연결에 따라 달라질 수 있습니다. 엣지 구성이 승인되고 엣지 에이전트와 동기화`SyncStatus`되면가 업데이트됩니다. 이 API를 처음 호출하면 스트림에 대한 새 엣지 구성이 생성되고 동기화 상태가 로 설정됩니다`SYNCING`. 이 API를 다시 `SYNC_FAILED`사용하려면 동기화 상태가 `IN_SYNC`또는와 같은 터미널 상태에 도달할 때까지 기다려야 합니다. 동기화 프로세스 중에이 API를 호출하면 `ResourceInUseException`이 발생합니다. 스트림의 엣지 구성과 엣지 에이전트의 연결은 15분 동안 재시도됩니다. 15분이 지나면 상태가 `SYNC_FAILED` 상태로 전환됩니다. 엣지 구성을 한 디바이스에서 다른 디바이스로 이동하려면 [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md)를 사용하여 현재 엣지 구성을 삭제합니다. 그런 다음 업데이트된 허브 디바이스 ARN을 사용하여 StartEdgeConfigurationUpdate를 호출할 수 있습니다. **참고** AWS 아프리카(케이프타운) 리전인 af-south-1에서는이 API를 사용할 수 없습니다. ## Request Syntax ``` POST /startEdgeConfigurationUpdate HTTP/1.1 Content-type: application/json { "EdgeConfig": { "DeletionConfig": { "DeleteAfterUpload": boolean, "EdgeRetentionInHours": number, "LocalSizeConfig": { "MaxLocalMediaSizeInMB": number, "StrategyOnFullSize": "string" } }, "HubDeviceArn": "string", "RecorderConfig": { "MediaSourceConfig": { "MediaUriSecretArn": "string", "MediaUriType": "string" }, "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } }, "UploaderConfig": { "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } } }, "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [EdgeConfig](#API_StartEdgeConfigurationUpdate_RequestSyntax) ** 업데이트 프로세스를 호출하는 데 필요한 엣지 구성 세부 정보입니다. 타입: [EdgeConfig](API_EdgeConfig.md)객체 필수 항목 여부: 예 ** [StreamARN](#API_StartEdgeConfigurationUpdate_RequestSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_StartEdgeConfigurationUpdate_RequestSyntax) ** 엣지 구성을 업데이트하려는 스트림의 이름입니다. `StreamName` 또는를 지정합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "EdgeConfig": { "DeletionConfig": { "DeleteAfterUpload": boolean, "EdgeRetentionInHours": number, "LocalSizeConfig": { "MaxLocalMediaSizeInMB": number, "StrategyOnFullSize": "string" } }, "HubDeviceArn": "string", "RecorderConfig": { "MediaSourceConfig": { "MediaUriSecretArn": "string", "MediaUriType": "string" }, "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } }, "UploaderConfig": { "ScheduleConfig": { "DurationInSeconds": number, "ScheduleExpression": "string" } } }, "FailedStatusDetails": "string", "LastUpdatedTime": number, "StreamARN": "string", "StreamName": "string", "SyncStatus": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CreationTime](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** 스트림의 엣지 구성이 처음 생성된 타임스탬프입니다. 유형: 타임스탬프 ** [EdgeConfig](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** Edge Agent IoT Greengrass 구성 요소와 동기화하는 데 사용할 스트림의 엣지 구성에 대한 설명입니다. Edge Agent 구성 요소는 온프레미스의 IoT Hub 디바이스 설정에서 실행됩니다. 유형: [EdgeConfig](API_EdgeConfig.md)객체 ** [FailedStatusDetails](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** 생성된 실패 상태에 대한 설명입니다. 유형: 문자열 ** [LastUpdatedTime](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** 스트림의 엣지 구성이 마지막으로 업데이트된 타임스탬프입니다. 유형: 타임스탬프 ** [StreamARN](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ** [StreamName](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** 엣지 구성이 업데이트된 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` ** [SyncStatus](#API_StartEdgeConfigurationUpdate_ResponseSyntax) ** 스트림 엣지 구성의 현재 동기화 상태입니다. 이 API를 호출하면 동기화 상태가 `SYNCING` 상태로 설정됩니다. `DescribeEdgeConfiguration` API를 사용하여 엣지 구성의 최신 상태를 가져옵니다. 타입: 문자열 유효 값: `SYNCING | ACKNOWLEDGED | IN_SYNC | SYNC_FAILED | DELETING | DELETE_FAILED | DELETING_ACKNOWLEDGED` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** 시간 단위의 스트림 데이터 보존은 0과 같습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) # TagResource 신호 채널**에만** 하나 이상의 태그를 추가합니다. **참고:** 스트림에 태그를 지정하려면 대신 TagStream API를 사용합니다. *태그*는 정의하여 AWS 리소스에 할당할 수 있는 키-값 페어(값은 선택 사항)입니다. 이미 있는 태그를 지정하는 경우, 태그 값은 요청에서 지정한 값으로 대체됩니다. 자세한 내용은 * AWS 결제 및 비용 관리 및* [비용 관리 사용 설명서의 비용 할당 태그 사용을 참조하세요](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html). ## Request Syntax ``` POST /TagResource HTTP/1.1 Content-type: application/json { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_TagResource_RequestSyntax) ** 태그를 추가할 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [Tags](#API_TagResource_RequestSyntax) ** 지정된 신호 채널과 연결할 태그 목록입니다. 각 태그는 키-값 페어입니다. 타입: [Tag](API_Tag.md)객체 배열 배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 50개입니다. 필수 항목 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** TagsPerResourceExceededLimitException ** 리소스와 연결할 수 있는 태그 제한을 초과했습니다. Kinesis 비디오 스트림은 최대 50개의 태그를 지원할 수 있습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/TagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/TagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/TagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/TagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/TagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/TagResource) # TagStream 스트림에 하나 이상의 태그를 추가합니다. *태그*는 정의하여 AWS 리소스에 할당할 수 있는 키-값 페어(값은 선택 사항)입니다. 이미 있는 태그를 지정하는 경우, 태그 값은 요청에서 지정한 값으로 대체됩니다. 자세한 내용은 * AWS 결제 및 비용 관리 및* [비용 관리 사용 설명서의 비용 할당 태그 사용을 참조하세요](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html). `StreamName` 또는를 제공해야 합니다`StreamARN`. 이 작업에는 `KinesisVideo:TagStream` 작업에 대한 권한이 필요합니다. Kinesis 비디오 스트림은 최대 50개의 태그를 지원할 수 있습니다. ## Request Syntax ``` POST /tagStream HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string", "Tags": { "string" : "string" } } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_TagStream_RequestSyntax) ** 태그 또는 태그를 추가할 리소스의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_TagStream_RequestSyntax) ** 태그를 추가할 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [Tags](#API_TagStream_RequestSyntax) ** 지정된 스트림과 연결할 태그 목록입니다. 각 태그는 키-값 페어입니다(값은 선택 사항). 유형: 문자열 간 맵 맵 항목: 최대 항목 수는 50입니다. 키 길이 제약 조건: 최소 길이는 1. 최대 길이 128. 키 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256. 가치 패턴: `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` 필수 항목 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** InvalidResourceFormatException ** 의 형식`StreamARN`이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** TagsPerResourceExceededLimitException ** 리소스와 연결할 수 있는 태그 제한을 초과했습니다. Kinesis 비디오 스트림은 최대 50개의 태그를 지원할 수 있습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/TagStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/TagStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/TagStream) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/TagStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/TagStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/TagStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/TagStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/TagStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/TagStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/TagStream) # UntagResource 신호 채널에서만 하나 이상의 태그를 제거합니다****. **참고:** 스트림에서 태그를 제거하려면 대신 UntagStream API를 사용합니다. 요청에서 태그 키만 지정하고 값을 지정하지 마십시오. 존재하지 않는 태그 키를 지정하면 무시됩니다. ## Request Syntax ``` POST /UntagResource HTTP/1.1 Content-type: application/json { "ResourceARN": "string", "TagKeyList": [ "string" ] } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_UntagResource_RequestSyntax) ** 태그를 제거할 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [TagKeyList](#API_UntagResource_RequestSyntax) ** 제거할 태그의 키 목록입니다. 타입: 문자열 배열 배열 멤버: 최소수는 1개입니다. 최대수 50개. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UntagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UntagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UntagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UntagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UntagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UntagResource) # UntagStream 스트림에서 하나 이상의 태그를 제거합니다. 요청에서 태그 키만 지정하고 값을 지정하지 마십시오. 존재하지 않는 태그 키를 지정하면 무시됩니다. 요청에서 `StreamName` 또는를 제공해야 합니다`StreamARN`. ## Request Syntax ``` POST /untagStream HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string", "TagKeyList": [ "string" ] } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StreamARN](#API_UntagStream_RequestSyntax) ** 태그를 제거할 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_UntagStream_RequestSyntax) ** 태그를 제거할 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [TagKeyList](#API_UntagStream_RequestSyntax) ** 제거할 태그의 키 목록입니다. 타입: 문자열 배열 배열 멤버: 최소수는 1개입니다. 최대수 50개. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** InvalidResourceFormatException ** 의 형식`StreamARN`이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** Amazon Kinesis Video Streams가 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UntagStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UntagStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UntagStream) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UntagStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UntagStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UntagStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UntagStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UntagStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UntagStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UntagStream) # UpdateDataRetention 스트림의 데이터 보존 기간을 지정한 값만큼 늘리거나 줄입니다. 데이터 보존 기간을 늘리거나 줄일지 여부를 표시하려면 요청 본문에 `Operation` 파라미터를 지정합니다. 요청에서 `StreamName` 또는를 지정해야 합니다`StreamARN`. 이 작업에는 `KinesisVideo:UpdateDataRetention` 작업에 대한 권한이 필요합니다. 데이터 보존 기간을 변경하면 다음과 같이 스트림의 데이터에 영향을 줍니다. + 데이터 보존 기간이 증가하면 기존 데이터가 새 보존 기간 동안 보존됩니다. 예를 들어 데이터 보존 기간이 1시간에서 7시간으로 늘어날 경우 기존 데이터는 모두 7시간 동안 보존됩니다. + 데이터 보존 기간이 줄어들면 기존 데이터는 새 보존 기간 동안 보존됩니다. 예를 들어 데이터 보존 기간이 7시간에서 1시간으로 줄어들면 기존 데이터는 모두 1시간 동안 보존되고 1시간이 지난 데이터는 즉시 삭제됩니다. ## Request Syntax ``` POST /updateDataRetention HTTP/1.1 Content-type: application/json { "CurrentVersion": "string", "DataRetentionChangeInHours": number, "Operation": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CurrentVersion](#API_UpdateDataRetention_RequestSyntax) ** 보존 기간을 변경하려는 스트림의 버전입니다. 버전을 가져오려면 `DescribeStream` 또는 `ListStreams` API를 호출합니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 예 ** [DataRetentionChangeInHours](#API_UpdateDataRetention_RequestSyntax) ** 현재 보존을 조정할 시간입니다. 지정하는 값은에 따라 현재 값에 추가되거나 차감됩니다`operation`. 데이터 보존의 최소값은 0이고 최대값은 87600(10년)입니다. 타입: 정수 유효한 범위: 최소값 1. 필수 항목 여부: 예 ** [Operation](#API_UpdateDataRetention_RequestSyntax) ** 보존 기간을 늘리거나 줄일지 여부를 나타냅니다. 타입: 문자열 유효 값: `INCREASE_DATA_RETENTION | DECREASE_DATA_RETENTION` 필수 사항 여부: 예 ** [StreamARN](#API_UpdateDataRetention_RequestSyntax) ** 보존 기간을 변경하려는 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_UpdateDataRetention_RequestSyntax) ** 보존 기간을 변경하려는 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceInUseException ** 의 입력 `StreamARN` 또는 `ChannelARN``CLOUD_STORAGE_MODE`가 다른 Kinesis Video Stream 리소스에 이미 매핑되어 있거나 제공된 입력 `StreamARN` 또는 `ChannelARN`가 활성 상태가 아닌 경우 다음 중 하나를 시도합니다. 1. 지정된 채널이 매핑되는 스트림을 결정하는 `DescribeMediaStorageConfiguration` API입니다. 1. 지정된 스트림이 매핑되는 채널을 결정하는 `DescribeMappedResourceConfiguration` API입니다. 1. 리소스의 상태를 결정하는 `DescribeStream` 또는 `DescribeSignalingChannel` API입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** VersionMismatchException ** 지정한 스트림 버전이 최신 버전이 아닙니다. 최신 버전을 가져오려면 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API를 사용합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateDataRetention) # UpdateImageGenerationConfiguration `StreamInfo` 및 `ImageProcessingConfiguration` 필드를 업데이트합니다. ## Request Syntax ``` POST /updateImageGenerationConfiguration HTTP/1.1 Content-type: application/json { "ImageGenerationConfiguration": { "DestinationConfig": { "DestinationRegion": "string", "Uri": "string" }, "Format": "string", "FormatConfig": { "string" : "string" }, "HeightPixels": number, "ImageSelectorType": "string", "SamplingInterval": number, "Status": "string", "WidthPixels": number }, "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ImageGenerationConfiguration](#API_UpdateImageGenerationConfiguration_RequestSyntax) ** KVS 이미지 전송에 필요한 정보가 포함된 구조입니다. 구조가 null이면 구성이 스트림에서 삭제됩니다. 유형: [ImageGenerationConfiguration](API_ImageGenerationConfiguration.md)객체 필수 여부: 아니요 ** [StreamARN](#API_UpdateImageGenerationConfiguration_RequestSyntax) ** 이미지 생성 구성을 업데이트하려는 Kinesis 비디오 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_UpdateImageGenerationConfiguration_RequestSyntax) ** 이미지 생성 구성을 업데이트할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** 시간 단위의 스트림 데이터 보존은 0과 같습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateImageGenerationConfiguration) # UpdateMediaStorageConfiguration `SignalingChannel`를 스트림에 연결하여 미디어를 저장합니다. 를 지정할 수 있는 두 가지 신호 모드가 있습니다. + `StorageStatus`이 활성화된 경우 데이터는 `StreamARN` 제공된에 저장됩니다. WebRTC Ingestion이 작동하려면 스트림에 데이터 보존이 활성화되어 있어야 합니다. + `StorageStatus`가 비활성화되면 데이터가 저장되지 않으며 `StreamARN` 파라미터가 필요하지 않습니다. **중요** `StorageStatus`이 활성화된 경우 직접 peer-to-peer(마스터 뷰어) 연결이 더 이상 발생하지 않습니다. 피어는 스토리지 세션에 직접 연결됩니다. SDP 제안 전송을 트리거하고 피어와 스토리지 세션 간에 연결을 설정하려면 `JoinStorageSession` API를 호출해야 합니다. ## Request Syntax ``` POST /updateMediaStorageConfiguration HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "MediaStorageConfiguration": { "Status": "string", "StreamARN": "string" } } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelARN](#API_UpdateMediaStorageConfiguration_RequestSyntax) ** 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [MediaStorageConfiguration](#API_UpdateMediaStorageConfiguration_RequestSyntax) ** 미디어 스토리지 구성 속성을 캡슐화하거나 포함하는 구조입니다. 타입: [MediaStorageConfiguration](API_MediaStorageConfiguration.md)객체 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** 시간 단위의 스트림 데이터 보존은 0과 같습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) # UpdateNotificationConfiguration 스트림에 대한 알림 정보를 업데이트합니다. ## Request Syntax ``` POST /updateNotificationConfiguration HTTP/1.1 Content-type: application/json { "NotificationConfiguration": { "DestinationConfig": { "Uri": "string" }, "Status": "string" }, "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [NotificationConfiguration](#API_UpdateNotificationConfiguration_RequestSyntax) ** 알림에 필요한 정보를 포함하는 구조입니다. 구조가 null이면 구성이 스트림에서 삭제됩니다. 유형: [NotificationConfiguration](API_NotificationConfiguration.md)객체 필수 여부: 아니요 ** [StreamARN](#API_UpdateNotificationConfiguration_RequestSyntax) ** 알림 구성을 업데이트하려는 Kinesis 비디오 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_UpdateNotificationConfiguration_RequestSyntax) ** 알림 구성을 업데이트할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** 시간 단위의 스트림 데이터 보존은 0과 같습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateNotificationConfiguration) # 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](#API_UpdateSignalingChannel_RequestSyntax) ** 업데이트하려는 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [CurrentVersion](#API_UpdateSignalingChannel_RequestSyntax) ** 업데이트하려는 신호 채널의 현재 버전입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 예 ** [SingleMasterConfiguration](#API_UpdateSignalingChannel_RequestSyntax) ** 업데이트하려는 신호 채널 `SINGLE_MASTER` 유형에 대한 구성을 포함하는 구조입니다. 채널 유형이 인 채널에는이 파라미터와 `SINGLE_MASTER` 채널 메시지의 Timetime-to-live가 필요합니다. 유형: [SingleMasterConfiguration](API_SingleMasterConfiguration.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** VersionMismatchException ** 지정한 스트림 버전이 최신 버전이 아닙니다. 최신 버전을 가져오려면 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API를 사용합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) # UpdateStream 디바이스 이름 및 미디어 유형과 같은 스트림 메타데이터를 업데이트합니다. 스트림 이름 또는 스트림의 Amazon 리소스 이름(ARN)을 제공해야 합니다. 스트림을 업데이트하기 전에 최신 버전의 스트림이 있는지 확인하려면 스트림 버전을 지정할 수 있습니다. Kinesis Video Streams는 각 스트림에 버전을 할당합니다. 스트림을 업데이트하면 Kinesis Video Streams가 새 버전 번호를 할당합니다. 최신 스트림 버전을 가져오려면 `DescribeStream` API를 사용합니다. `UpdateStream`는 비동기 작업이며 완료하는 데 시간이 걸립니다. ## Request Syntax ``` POST /updateStream HTTP/1.1 Content-type: application/json { "CurrentVersion": "string", "DeviceName": "string", "MediaType": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CurrentVersion](#API_UpdateStream_RequestSyntax) ** 메타데이터를 업데이트하려는 스트림의 버전입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 예 ** [DeviceName](#API_UpdateStream_RequestSyntax) ** 스트림에 쓰는 디바이스의 이름입니다. 현재 구현에서 Kinesis Video Streams는이 이름을 사용하지 않습니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이 128. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [MediaType](#API_UpdateStream_RequestSyntax) ** 스트림의 미디어 유형입니다. 스트림의 소비자에게 스트림에 포함된 콘텐츠 유형을 지정하는 `MediaType` 데 사용합니다. 미디어 유형에 대한 자세한 내용은 [미디어 유형을 참조하세요](http://www.iana.org/assignments/media-types/media-types.xhtml). 를 지정하도록 선택한 경우 [이름 지정 요구 사항을](https://tools.ietf.org/html/rfc6838#section-4.2) `MediaType`참조하세요. 콘솔에서 비디오를 재생하려면 올바른 비디오 유형을 지정해야 합니다. 예를 들어 스트림의 비디오가 H.264인 경우를 `video/h264`로 지정합니다`MediaType`. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이 128. 패턴: `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` 필수 여부: 아니요 ** [StreamARN](#API_UpdateStream_RequestSyntax) ** 메타데이터를 업데이트하려는 스트림의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_UpdateStream_RequestSyntax) ** 메타데이터를 업데이트하려는 스트림의 이름입니다. 스트림 이름은 스트림의 식별자이며 각 계정 및 리전에 대해 고유해야 합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceInUseException ** 의 입력 `StreamARN` 또는 `ChannelARN``CLOUD_STORAGE_MODE`가 다른 Kinesis Video Stream 리소스에 이미 매핑되어 있거나 제공된 입력 `StreamARN` 또는 `ChannelARN`가 활성 상태가 아닌 경우 다음 중 하나를 시도합니다. 1. 지정된 채널이 매핑되는 스트림을 결정하는 `DescribeMediaStorageConfiguration` API입니다. 1. 지정된 스트림이 매핑되는 채널을 결정하는 `DescribeMappedResourceConfiguration` API입니다. 1. 리소스의 상태를 결정하는 `DescribeStream` 또는 `DescribeSignalingChannel` API입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** VersionMismatchException ** 지정한 스트림 버전이 최신 버전이 아닙니다. 최신 버전을 가져오려면 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API를 사용합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateStream) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateStream) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateStream) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateStream) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateStream) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateStream) # UpdateStreamStorageConfiguration 기존 Kinesis 비디오 스트림의 스토리지 구성을 업데이트합니다. 이 작업을 통해 스트림의 스토리지 계층 설정을 수정하여 액세스 패턴에 따라 스토리지 비용과 성능을 최적화할 수 있습니다. `UpdateStreamStorageConfiguration`은 비동기식 작업입니다. `KinesisVideo:UpdateStreamStorageConfiguration` 작업에 대한 권한이 있어야 합니다. ## Request Syntax ``` POST /updateStreamStorageConfiguration HTTP/1.1 Content-type: application/json { "CurrentVersion": "string", "StreamARN": "string", "StreamName": "string", "StreamStorageConfiguration": { "DefaultStorageTier": "string" } } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CurrentVersion](#API_UpdateStreamStorageConfiguration_RequestSyntax) ** 스토리지 구성을 변경하려는 스트림의 버전입니다. 버전을 가져오려면 `DescribeStream` 또는 `ListStreams` API를 호출합니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 예 ** [StreamARN](#API_UpdateStreamStorageConfiguration_RequestSyntax) ** 스토리지 구성을 업데이트하려는 스트림의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_UpdateStreamStorageConfiguration_RequestSyntax) ** 스토리지 구성을 업데이트하려는 스트림의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [StreamStorageConfiguration](#API_UpdateStreamStorageConfiguration_RequestSyntax) ** 스트림에 대한 새 스토리지 구성입니다. 여기에는 스트림 데이터를 저장하고 액세스하는 방법을 결정하는 기본 스토리지 계층이 포함됩니다. 스토리지 계층마다 특정 사용 사례 요구 사항에 맞게 다양한 수준의 성능과 비용 최적화를 제공합니다. 타입: [StreamStorageConfiguration](API_StreamStorageConfiguration.md)객체 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 401 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. 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 ** ResourceNotFoundException ** Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다. HTTP 상태 코드: 404 ** VersionMismatchException ** 지정한 스트림 버전이 최신 버전이 아닙니다. 최신 버전을 가져오려면 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API를 사용합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration) # Amazon Kinesis Video Streams 미디어 Amazon Kinesis Video Streams Media에서 지원하는 작업은 다음과 같습니다. + [GetMedia](API_dataplane_GetMedia.md) + [PutMedia](API_dataplane_PutMedia.md) # GetMedia 이 API를 사용하여 Kinesis 비디오 스트림에서 미디어 콘텐츠를 검색합니다. 요청에서 스트림 이름 또는 스트림 Amazon 리소스 이름(ARN)과 시작 청크를 식별합니다. 그런 다음 Kinesis Video Streams는 조각 번호별로 청크 스트림을 순서대로 반환합니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `GetMedia` 요청을 보냅니다. 스트림에 미디어 데이터(분할)를 배치하면 Kinesis Video Streams는 수신되는 각 조각과 관련 메타데이터를 "청크"라고 하는에 저장합니다. 자세한 내용은 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) 단원을 참조하십시오. `GetMedia` API는 요청에 지정한 청크부터 시작하여 이러한 청크의 스트림을 반환합니다. `GetMedia` API는 장기 실행 연결을 통해 스트리밍 API로 작동하도록 설계되었습니다. 각 조각에 대해 새 HTTP 연결이 설정되고 닫히는 기존 RESTful 방식으로는 사용하기 위한 것이 아닙니다. `GetMedia` API를 호출하면 Kinesis Video Streams는 HTTP 청크 전송 인코딩을 사용하여 지속적으로 장기 실행 연결을 통해 조각을 지속적으로 전송합니다. `GetMedia` API를 사용할 때는 다음 제한이 적용됩니다. + 클라이언트는 스트림당 초당 `GetMedia` 최대 5회를 호출할 수 있습니다. + Kinesis Video Streams는 `GetMedia` 세션 중에 초당 최대 25메가바이트(또는 초당 200메가비트)의 속도로 미디어 데이터를 전송합니다. **참고** 를 스트리밍 장기 실행 연결`GetMedia`로 사용하여 단일 영구 연결에서 여러 조각을 검색합니다. 각 조각에 대해 새 HTTP 연결을 설정하고 닫는 기존 RESTful 방식으로 `GetMedia` API를 사용하지 마십시오. 동시 `GetMedia` 연결을 3개 이상 시도하면 Kinesis Video Streams는 `ConnectionLimitExceededException` 오류와 함께 최신 연결을 제한합니다. **참고** `GetMedia` HTTP 응답 상태 코드는 즉시 반환되지만 재생에 사용할 수 있는 수집된 조각이 없는 경우 HTTP 응답 페이로드의 읽기는 3초 후에 시간 초과됩니다. **참고** Kinesis Video Streams 미디어 API를 호출한 후 오류가 발생하면 HTTP 상태 코드 및 응답 본문 외에도 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 - 문제를 보고하려는 경우 요청 ID가 주어지면 AWS지원 팀이 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류를 재시도할 수 있는지 여부와 조건에 대해 프로그래밍 방식으로 결정할 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 수행해야 할 작업에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /getMedia HTTP/1.1 Content-type: application/json { "StartSelector": { "AfterFragmentNumber": "string", "ContinuationToken": "string", "StartSelectorType": "string", "StartTimestamp": number }, "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [StartSelector](#API_dataplane_GetMedia_RequestSyntax) ** 지정된 스트림에서 가져올 시작 청크를 식별합니다. 타입: [StartSelector](API_dataplane_StartSelector.md)객체 필수 항목 여부: 예 ** [StreamARN](#API_dataplane_GetMedia_RequestSyntax) ** 미디어 콘텐츠를 가져오려는 스트림의 ARN입니다. 를 지정하지 않으면를 지정`streamARN`해야 합니다`streamName`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_dataplane_GetMedia_RequestSyntax) ** 미디어 콘텐츠를 가져오려는 Kinesis 비디오 스트림 이름입니다. 를 지정하지 않으면를 지정`streamName`해야 합니다`streamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-Type: ContentType Payload ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답에 다음 HTTP 헤더가 반환됩니다. ** [ContentType](#API_dataplane_GetMedia_ResponseSyntax) ** 요청된 미디어의 콘텐츠 유형입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[a-zA-Z0-9_\.\-]+$` 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [Payload](#API_dataplane_GetMedia_ResponseSyntax) ** Kinesis Video Streams가 반환하는 페이로드는 지정된 스트림의 청크 시퀀스입니다. 청크에 대한 자세한 내용은 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)를 참조하세요. Kinesis Video Streams가 `GetMedia` 호출에서 반환하는 청크에는 다음과 같은 추가 Matroska(MKV) 태그도 포함됩니다. + AWS\$1KINESISVIDEO\$1CONTINUATION\$1TOKEN(UTF-8 문자열) - `GetMedia` 통화가 종료되는 경우 다음 요청에서이 연속 토큰을 사용하여 마지막 요청이 종료된 다음 청크를 가져올 수 있습니다. + AWS\$1KINESISVIDEO\$1MILLIS\$1BEHIND\$1NOW(UTF-8 문자열) - 클라이언트 애플리케이션은이 태그 값을 사용하여 응답에서 반환된 청크가 스트림의 최신 청크에서 얼마나 뒤에 있는지 확인할 수 있습니다. + AWS\$1KINESISVIDEO\$1FRAGMENT\$1NUMBER - 청크에 반환된 조각 번호입니다. + AWS\$1KINESISVIDEO\$1SERVER\$1TIMESTAMP - 조각의 서버 타임스탬프입니다. + AWS\$1KINESISVIDEO\$1PRODUCER\$1TIMESTAMP - 조각의 생산자 타임스탬프입니다. 오류가 발생하면 다음 태그가 표시됩니다. + AWS\$1KINESISVIDEO\$1ERROR\$1CODE - GetMedia를 중지한 오류에 대한 문자열 설명입니다. + AWS\$1KINESISVIDEO\$1ERROR\$1ID: 오류의 정수 코드입니다. 오류 코드는 다음과 같습니다. + 3002 - 스트림에 쓰는 중 오류 발생 + 4000 - 요청된 조각을 찾을 수 없음 + 4500 - 스트림의 KMS 키에 대한 액세스 거부됨 + 4501 - 스트림의 KMS 키가 비활성화됨 + 4502 - 스트림의 KMS 키에 대한 검증 오류 + 4503 - 스트림에 지정된 KMS 키를 사용할 수 없음 + 4504 - 스트림에 지정된 KMS 키의 잘못된 사용 + 4505 - 스트림에 지정된 KMS 키의 상태가 잘못되었습니다. + 4506 - 스트림에 지정된 KMS 키를 찾을 수 없음 + 5000 - 내부 오류 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** ConnectionLimitExceededException ** 허용된 클라이언트 연결 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 발신자가 잘못된 엔드포인트를 사용하여 스트림에 데이터를 씁니다. 이러한 예외가 수신되면 사용자는가 `GetDataEndpoint` 로 `APIName` 설정된를 호출`PUT_MEDIA`하고 응답의 엔드포인트를 사용하여 다음 `PutMedia` 호출을 호출해야 합니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** 상태 코드: 404, 지정된 이름의 스트림이 존재하지 않습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-data-2017-09-30/GetMedia) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-data-2017-09-30/GetMedia) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-data-2017-09-30/GetMedia) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-data-2017-09-30/GetMedia) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-data-2017-09-30/GetMedia) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-data-2017-09-30/GetMedia) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-data-2017-09-30/GetMedia) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-data-2017-09-30/GetMedia) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-data-2017-09-30/GetMedia) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-data-2017-09-30/GetMedia) # PutMedia 이 API를 사용하여 미디어 데이터를 Kinesis 비디오 스트림으로 전송합니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `PutMedia` 요청을 보냅니다. 요청에서 HTTP 헤더를 사용하여 스트림 이름, 타임스탬프, 타임스탬프 값이 절대인지 아니면 생산자가 기록을 시작한 시점을 기준으로 하는지와 같은 파라미터 정보를 제공합니다. 요청 본문을 사용하여 미디어 데이터를 전송합니다. Kinesis Video Streams는이 API를 사용하여 미디어 데이터를 전송하기 위한 Matroska(MKV) 컨테이너 형식만 지원합니다. 이 API를 사용하여 데이터를 전송하는 옵션은 다음과 같습니다. + 미디어 데이터를 실시간으로 전송: 예를 들어 보안 카메라는 프레임을 생성할 때 실시간으로 프레임을 전송할 수 있습니다. 이 접근 방식은 비디오 레코딩과 유선으로 전송된 데이터 간의 지연 시간을 최소화합니다. 이를 연속 생산자라고 합니다. 이 경우 소비자 애플리케이션은 실시간으로 또는 필요할 때 스트림을 읽을 수 있습니다. + 미디어 데이터를 오프라인으로 전송(배치로): 예를 들어, 바디 카메라가 몇 시간 동안 비디오를 녹화하여 디바이스에 저장할 수 있습니다. 나중에 카메라를 도킹 포트에 연결하면 카메라가 `PutMedia` 세션을 시작하여 Kinesis 비디오 스트림으로 데이터를 전송할 수 있습니다. 이 시나리오에서는 지연 시간이 문제가 되지 않습니다. 이 API를 사용할 때는 다음 고려 사항에 유의하세요. + `streamName` 또는 `streamARN` 중 하나만 지정해야 하지만 두 가지 모두 지정해서는 안 됩니다. + 콘솔에서 또는 HLS를 통해 미디어를 재생하려면 각 조각의 트랙 1에 h.264 인코딩 비디오가 포함되어야 하고, 조각 메타데이터의 CodecID는 "V\$1MPEG/ISO/AVC"여야 하며, 조각 메타데이터에는 AVCC 형식의 h.264 코덱 프라이빗 데이터가 포함되어야 합니다. 선택적으로 각 조각의 트랙 2에는 AAC 인코딩 오디오가 포함되어야 하고, 조각 메타데이터의 CodecID는 "A\$1AAC"여야 하며, 조각 메타데이터에는 AAC 코덱 프라이빗 데이터가 포함되어야 합니다. + `PutMedia` API는 장기 실행 연결을 통해 스트리밍 API로 작동하도록 설계되었습니다. 각 조각에 대해 새 HTTP 연결이 설정되고 닫히는 기존 RESTful 방식으로 사용하기 위한 것이 아닙니다. `PutMedia` API를 사용하는 경우 HTTP 청크 전송 인코딩을 사용하여 영구 연결을 통해 조각을 지속적으로 전송합니다. + `PutMedia` 세션에서 수신된 각 조각에 대해 Kinesis Video Streams는 하나 이상의 승인을 보냅니다. 클라이언트 측 네트워크 고려 사항으로 인해 이러한 승인이 생성될 때 이러한 승인을 모두 받지 못할 수 있습니다. **참고** 를 스트리밍 장기 실행 연결`PutMedia`로 사용하여 단일 영구 연결로 여러 조각을 전송합니다. 동시 `PutMedia` 연결을 두 개 이상 시도하면 Kinesis Video Streams는 `ConnectionLimitExceededException` 오류와 함께 최신 연결을 제한합니다. `PutMedia` API를 사용할 때는 다음 제한이 적용됩니다. + 클라이언트는 스트림당 초당 `PutMedia` 최대 5회를 호출할 수 있습니다. + 클라이언트는 스트림당 초당 최대 5개의 조각을 전송할 수 있습니다. + Kinesis Video Streams는 `PutMedia` 세션 중에 최대 12.5MB/초 또는 100Mbps의 속도로 미디어 데이터를 읽습니다. 다음 제약 조건에 유의하세요. 이러한 경우 Kinesis Video Streams는 응답에서 오류 확인을 전송합니다. + 시간 코드가 최대 허용 한도보다 길고 데이터가 50MB를 초과하는 조각은 허용되지 않습니다. + 트랙이 3개 이상인 조각은 허용되지 않습니다. 모든 조각의 각 프레임은 조각 헤더에 정의된 트랙 중 하나와 동일한 트랙 번호를 가져야 합니다. 또한 모든 조각에는 조각 헤더에 정의된 각 트랙에 대해 하나 이상의 프레임이 포함되어야 합니다. + 각 조각에는 조각 메타데이터에 정의된 각 트랙에 대해 하나 이상의 프레임이 포함되어야 합니다. + 조각의 가장 빠른 프레임 타임스탬프는 이전 조각의 최신 프레임 타임스탬프 이후여야 합니다. + 둘 이상의 MKV 세그먼트를 포함하거나 허용되지 않는 MKV 요소(예: `track*`)를 포함하는 MKV 스트림도 오류 승인을 초래합니다. Kinesis Video Streams는 수신되는 각 조각과 관련 메타데이터를 "청크"라고 하는에 저장합니다. 조각 메타데이터에는 다음이 포함됩니다. + `PutMedia` 요청 시작 시 제공된 MKV 헤더 + 조각에 대한 다음 Kinesis Video Streams 관련 메타데이터: + `server_timestamp` - Kinesis Video Streams가 조각 수신을 시작한 시점의 타임스탬프입니다. + `producer_timestamp` - 생산자가 조각 기록을 시작한 타임스탬프입니다. Kinesis Video Streams는 요청에서 수신된 세 가지 정보를 사용하여이 값을 계산합니다. + 조각과 함께 요청 본문에 수신된 조각 타임코드 값입니다. + 요청 헤더 2개: `producerStartTimestamp` (생산자가 기록을 시작한 시점) 및 `fragmentTimeCodeType` (페이로드의 조각 타임코드가 절대인지 상대인지 여부). 그런 다음 Kinesis Video Streams는 다음과 같이 조각에 `producer_timestamp` 대한를 계산합니다. `fragmentTimeCodeType`가 상대인 경우 `producer_timestamp` = `producerStartTimeStamp` \$1 조각 타임코드 `fragmentTimeCodeType`가 절대인 경우 `producer_timestamp` = 조각 타임코드(밀리초로 변환됨) + Kinesis Video Streams에서 할당한 고유 조각 번호입니다. **참고** `GetMedia` 요청을 하면 Kinesis Video Streams는 이러한 청크의 스트림을 반환합니다. 클라이언트는 필요에 따라 메타데이터를 처리할 수 있습니다. **참고** 이 작업은 AWS SDK for Java에서만 사용할 수 있습니다. 다른 언어에서는 AWS SDKs 지원되지 않습니다. **참고** Kinesis Video Streams는 PutMedia API를 통해 수집 및 보관하는 동안 코덱 프라이빗 데이터를 구문 분석하고 검증하지 않습니다. KVS는 HLS API를 통해 스트림을 사용할 때 MPEG-TS 및 MP4 조각 패키징을 위한 코덱 프라이빗 데이터에서 필요한 정보를 추출하고 검증합니다. APIs **참고** Kinesis Video Streams 미디어 API를 호출한 후 오류가 발생하면 HTTP 상태 코드 및 응답 본문 외에도 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 - 문제를 보고하려는 경우 요청 ID가 주어지면 AWS지원 팀이 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류가 재시도 가능한지 여부와 조건에 대해 프로그래밍 방식으로 결정할 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 수행해야 할 작업에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /putMedia HTTP/1.1 x-amzn-stream-name: StreamName x-amzn-stream-arn: StreamARN x-amzn-fragment-timecode-type: FragmentTimecodeType x-amzn-producer-start-timestamp: ProducerStartTimestamp Payload ``` ## URI 요청 파라미터 요청은 다음 URI 파라미터를 사용합니다. ** [FragmentTimecodeType](#API_dataplane_PutMedia_RequestSyntax) ** 이것은 `x-amzn-fragment-timecode-type` HTTP 헤더의 값으로 전달됩니다. 조각(페이로드, HTTP 요청 본문)의 타임코드가 절대인지 아니면 상대적인지 나타냅니다`producerStartTimestamp`. Kinesis Video Streams는 API 개요에 설명된 대로이 정보를 사용하여 요청에서 수신된 조각에 `producer_timestamp` 대한를 계산합니다. 유효한 값: `ABSOLUTE | RELATIVE` 필수 사항 여부: 예 ** [ProducerStartTimestamp](#API_dataplane_PutMedia_RequestSyntax) ** 이것은 `x-amzn-producer-start-timestamp` HTTP 헤더의 값으로 전달됩니다. 이는 생산자가 미디어 기록을 시작한 생산자 타임스탬프입니다(요청에 있는 특정 조각의 타임스탬프가 아님). ** [StreamARN](#API_dataplane_PutMedia_RequestSyntax) ** 이것은 `x-amzn-stream-arn` HTTP 헤더의 값으로 전달됩니다. 미디어 콘텐츠를 쓰려는 Kinesis 비디오 스트림의 Amazon 리소스 이름(ARN)입니다. 를 지정하지 않으면를 지정`streamARN`해야 합니다`streamName`. 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ** [StreamName](#API_dataplane_PutMedia_RequestSyntax) ** 이것은 `x-amzn-stream-name` HTTP 헤더의 값으로 전달됩니다. 미디어 콘텐츠를 작성할 Kinesis 비디오 스트림의 이름입니다. 를 지정하지 않으면를 지정`streamName`해야 합니다`streamARN`. 길이 제약: 최소 길이 1. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` ## 요청 본문 요청은 다음의 이진 데이터를 허용합니다. ** [Payload](#API_dataplane_PutMedia_RequestSyntax) ** Kinesis 비디오 스트림에 쓸 미디어 콘텐츠입니다. 현재 구현에서 Kinesis Video Streams는 단일 MKV 세그먼트가 있는 Matroska(MKV) 컨테이너 형식만 지원합니다. 세그먼트에는 하나 이상의 클러스터가 포함될 수 있습니다. 각 MKV 클러스터는 Kinesis 비디오 스트림 조각에 매핑됩니다. 선택한 클러스터 지속 시간이 조각 지속 시간이 됩니다. ## Response Syntax ``` HTTP/1.1 200 Payload ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [Payload](#API_dataplane_PutMedia_ResponseSyntax) ** Kinesis Video Streams가 `PutMedia` 요청을 성공적으로 수신하면 서비스는 요청 헤더를 검증합니다. 그런 다음 서비스는 페이로드를 읽기 시작하고 먼저 HTTP 200 응답을 전송합니다. 그런 다음 서비스는 줄 바꿈으로 구분된 일련의 JSON 객체(`Acknowledgement` 객체)가 포함된 스트림을 반환합니다. 승인은 미디어 데이터가 전송되는 것과 동일한 연결에서 수신됩니다. `PutMedia` 요청에 대한 승인은 여러 개 있을 수 있습니다. 각 `Acknowledgement`는 다음과 같은 키-값 페어로 구성됩니다. + `AckEventType` - 확인이 나타내는 이벤트 유형입니다. + **버퍼링:** Kinesis Video Streams가 조각 수신을 시작했습니다. Kinesis Video Streams는 조각 데이터의 첫 번째 바이트가 수신될 때 첫 번째 버퍼링 승인을 보냅니다. + **수신됨:** Kinesis Video Streams가 전체 조각을 수신했습니다. 데이터를 유지하도록 스트림을 구성하지 않은 경우 생산자는이 승인을 받으면 조각 버퍼링을 중지할 수 있습니다. + **영구:** Kinesis Video Streams가 조각을 유지했습니다(예: Amazon S3). 데이터를 유지하도록 스트림을 구성한 경우이 승인을 받게 됩니다. 이 승인을 받은 후 생산자는 조각 버퍼링을 중지할 수 있습니다. + **오류:** 조각을 처리하는 동안 Kinesis Video Streams에서 오류가 발생했습니다. 오류 코드를 검토하고 다음 조치를 결정할 수 있습니다. + **유휴:** `PutMedia` 세션이 진행 중입니다. 그러나 Kinesis Video Streams는 현재 데이터를 수신하지 않습니다. Kinesis Video Streams는 마지막으로 데이터를 수신한 후 최대 30초 동안이 승인을 주기적으로 전송합니다. 30초 이내에 데이터가 수신되지 않으면 Kinesis Video Streams가 요청을 닫습니다. **참고** 이 승인은 생산자가 데이터를 전송하지 않더라도 `PutMedia` 연결이 활성 상태인지 확인하는 데 도움이 될 수 있습니다. + `FragmentTimecode` - 승인이 전송되는 조각 타임코드입니다. 가 **유휴** 상태`AckEventType`인 경우 요소가 누락될 수 있습니다. + `FragmentNumber` - 확인이 전송되는 Kinesis Video Streams 생성 조각 번호입니다. + `ErrorId` 및 `ErrorCode` - `AckEventType`가 인 경우 `Error`이 필드는 해당 오류 코드를 제공합니다. 다음은 오류 IDs 목록과 해당 오류 코드 및 오류 메시지입니다. + 4000 - STREAM\$1READ\$1ERROR - 데이터 스트림을 읽는 동안 오류가 발생했습니다. + 4001 - MAX\$1FRAGMENT\$1SIZE\$1REACHED - 조각 크기가 최대 제한인 50MB보다 큽니다. + 4002 - MAX\$1FRAGMENT\$1DURATION\$1REACHED - 조각 지속 시간이 최대 허용 한도보다 큽니다. + 4003 - MAX\$1CONNECTION\$1DURATION\$1REACHED - 연결 기간이 허용되는 최대 임계값보다 깁니다. + 4004 - FRAGMENT\$1TIMECODE\$1LESSER\$1THAN\$1PREVIOUS - 조각 타임코드가 이전 타임코드의 타임코드보다 작습니다(`PutMedia`호출 내에서 조각을 순서대로 전송할 수 없음). + 4005 - MORE\$1THAN\$1ALLOWED\$1TRACKS\$1FOUND - MKV에서 둘 이상의 트랙이 발견되었습니다(사용되지 않음). + 4006 - INVALID\$1MKV\$1DATA - 입력 스트림을 유효한 MKV 형식으로 구문 분석하지 못했습니다. + 4007 - INVALID\$1PRODUCER\$1TIMESTAMP - 잘못된 생산자 타임스탬프입니다. + 4008 - STREAM\$1NOT\$1ACTIVE - 스트림이 더 이상 존재하지 않습니다(삭제됨). + 4009 - FRAGMENT\$1METADATA\$1LIMIT\$1REACHED - 조각 메타데이터 제한에 도달했습니다. 개발자 안내서의 [제한](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) 섹션을 참조하세요. + 4010 - TRACK\$1NUMBER\$1MISMATCH - MKV 프레임의 트랙 번호가 MKV 헤더의 트랙과 일치하지 않았습니다. + 4011 - FRAMES\$1MISSING\$1FOR\$1TRACK - 조각에 MKV 헤더의 트랙 중 하나 이상에 대한 프레임이 포함되어 있지 않습니다. + 4012 - INVALID\$1FRAGMENT\$1METADATA - 조각 메타데이터 이름은 문자열 로 시작할 수 없습니다` AWS_`. + 4500 - KMS\$1KEY\$1ACCESS\$1DENIED - 스트림의 지정된 KMS 키에 대한 액세스가 거부됩니다. + 4501 - KMS\$1KEY\$1DISABLED - 스트림의 지정된 KMS 키가 비활성화되었습니다. + 4502 - KMS\$1KEY\$1VALIDATION\$1ERROR - 스트림의 지정된 KMS 키가 검증에 실패했습니다. + 4503 - KMS\$1KEY\$1UNAVAILABLE - 스트림의 지정된 KMS 키를 사용할 수 없습니다. + 4504 - KMS\$1KEY\$1INVALID\$1USAGE - 스트림의 지정된 KMS 키의 잘못된 사용입니다. + 4505 - KMS\$1KEY\$1INVALID\$1STATE - 스트림의 지정된 KMS 키가 잘못된 상태입니다. + 4506 - KMS\$1KEY\$1NOT\$1FOUND - 스트림의 지정된 KMS 키를 찾을 수 없습니다. + 5000 - INTERNAL\$1ERROR - 내부 서비스 오류입니다. + 5001 - ARCHIVAL\$1ERROR - Kinesis Video Streams가 조각을 데이터 스토어에 유지하지 못했습니다. 생산자는 장기 실행 `PutMedia` 요청에 대한 페이로드를 보내는 동안 승인에 대한 응답을 읽어야 합니다. 생산자는 중간 프록시 서버의 버퍼링으로 인해 동시에 확인 청크를 수신할 수 있습니다. 적시에 승인을 받으려는 생산자는 각 `PutMedia` 요청에서 더 적은 조각을 보낼 수 있습니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** ConnectionLimitExceededException ** 허용된 클라이언트 연결 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 발신자가 잘못된 엔드포인트를 사용하여 스트림에 데이터를 씁니다. 이러한 예외가 수신되면 사용자는가 `GetDataEndpoint` 로 `APIName` 설정된를 호출`PUT_MEDIA`하고 응답의 엔드포인트를 사용하여 다음 `PutMedia` 호출을 호출해야 합니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** 상태 코드: 404, 지정된 이름의 스트림이 존재하지 않습니다. HTTP 상태 코드: 404 ## 예제 ### 승인 형식 승인 형식은 다음과 같습니다. ``` { Acknowledgement : { "EventType": enum "FragmentTimecode": Long, "FragmentNumber": Long, "ErrorId" : String } } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-data-2017-09-30/PutMedia) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-data-2017-09-30/PutMedia) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-data-2017-09-30/PutMedia) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-data-2017-09-30/PutMedia) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-data-2017-09-30/PutMedia) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-data-2017-09-30/PutMedia) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-data-2017-09-30/PutMedia) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-data-2017-09-30/PutMedia) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-data-2017-09-30/PutMedia) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-data-2017-09-30/PutMedia) # Amazon Kinesis Video Streams 아카이브된 미디어 Amazon Kinesis Video Streams Archived Media에서 지원하는 작업은 다음과 같습니다. + [GetClip](API_reader_GetClip.md) + [GetDASHStreamingSessionURL](API_reader_GetDASHStreamingSessionURL.md) + [GetHLSStreamingSessionURL](API_reader_GetHLSStreamingSessionURL.md) + [GetImages](API_reader_GetImages.md) + [GetMediaForFragmentList](API_reader_GetMediaForFragmentList.md) + [ListFragments](API_reader_ListFragments.md) # GetClip 지정된 시간 범위 동안 지정된 비디오 스트림에서 아카이브된 온디맨드 미디어가 포함된 MP4 파일(클립)을 다운로드합니다. StreamName 및 StreamARN 파라미터는 모두 선택 사항이지만이 API 작업을 호출할 때 StreamName 또는 StreamARN을 지정해야 합니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `GetClip` 요청을 보냅니다. Amazon Kinesis 비디오 스트림에는 MP4를 통해 데이터를 제공하기 위한 다음과 같은 요구 사항이 있습니다. + [비디오 재생 트랙 요구 사항](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + 데이터 보존이 0보다 커야 합니다. + 각 조각의 비디오 추적에는 H.264용 AVC(Advanced Video Coding) 형식 및 H.265용 HEVC 형식의 코덱 프라이빗 데이터가 포함되어야 합니다. 자세한 내용은 [MPEG-4 사양 ISO/IEC 14496-15](https://www.iso.org/standard/55980.html)를 참조하십시오. 스트림 데이터를 지정된 형식에 맞게 조정하는 방법에 대한 자세한 내용은 [NAL 적응 플래그](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html)를 참조하십시오. + 각 조각의 오디오 조각에는 AAC 형식([AAC 사양 ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) 또는 [MS Wave 형식](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html)의 코덱 프라이빗 데이터가 포함되어야 합니다. `GetClip.OutgoingBytes` Amazon CloudWatch 지표를 모니터링하여 발신 데이터의 양을 모니터링할 수 있습니다. CloudWatch를 사용하여 Kinesis Video Streams를 모니터링하는 방법에 대한 자세한 내용은 [Kinesis Video Streams 모니터링을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html). 요금 정보는 [Amazon Kinesis Video Streams 요금](https://aws.amazon.com/kinesis/video-streams/pricing/) 및 [AWS 요금을](https://aws.amazon.com/pricing/) 참조하세요. 발신 AWS 데이터에 대한 요금이 적용됩니다. **중요** 각 조각에 포함된 코덱 프라이빗 데이터(CPD)에는 조각을 올바르게 디코딩하는 데 필요한 프레임 속도, 해상도 및 인코딩 프로파일과 같은 코덱별 초기화 정보가 포함되어 있습니다. 결과 클립의 대상 조각 간에는 CPD 변경이 지원되지 않습니다. CPD는 쿼리된 미디어를 통해 일관성을 유지해야 합니다. 그렇지 않으면 오류가 반환됩니다. **중요** 변경 사항 추적은 지원되지 않습니다. 트랙은 쿼리된 미디어 전체에서 일관성을 유지해야 합니다. 스트림의 조각이 비디오만 있음에서 오디오와 비디오를 모두 있음으로 변경되거나 AAC 오디오 트랙이 A-Law 오디오 트랙으로 변경되면 오류가 반환됩니다. ## Request Syntax ``` POST /getClip HTTP/1.1 Content-type: application/json { "ClipFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) ** 요청된 클립의 시간 범위와 타임스탬프의 소스입니다. 타입: [ClipFragmentSelector](API_reader_ClipFragmentSelector.md)객체 필수 항목 여부: 예 ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** 미디어 클립을 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. StreamName 또는 StreamARN을 지정해야 합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetClip_RequestSyntax) ** 미디어 클립을 검색할 스트림의 이름입니다. StreamName 또는 StreamARN을 지정해야 합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-Type: ContentType Payload ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답에 다음 HTTP 헤더가 반환됩니다. ** [ContentType](#API_reader_GetClip_ResponseSyntax) ** 요청된 클립에 있는 미디어의 콘텐츠 유형입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[a-zA-Z0-9_\.\-]+$` 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [Payload](#API_reader_GetClip_ResponseSyntax) ** 지정된 비디오 스트림의 미디어 클립이 포함된 기존 MP4 파일입니다. 출력에는 지정된 시작 타임스탬프의 처음 100MB 또는 처음 200개의 조각이 포함됩니다. 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** InvalidCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에 있는 코덱 프라이빗 데이터는이 작업에 유효하지 않습니다. HTTP 상태 코드: 400 ** InvalidMediaFrameException ** 요청된 클립의 하나 이상의 프레임을 지정된 코덱을 기반으로 구문 분석할 수 없습니다. HTTP 상태 코드: 400 ** MissingCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에서 코덱 프라이빗 데이터를 찾을 수 없습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** `GetImages` 데이터를 보존하지 않는 스트림에 대해가 요청되었습니다(즉, `DataRetentionInHours`의가 0임). HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ** UnsupportedStreamMediaTypeException ** 재생 세션의 첫 번째 조각에 있는 트랙의 코덱 IDs에서 미디어 유형(예: h.264 또는 h.265 비디오, AAC 또는 G.711 오디오)을 확인할 수 없습니다. 트랙 1의 코덱 ID는 여야 하며`V_MPEG/ISO/AVC`, 선택적으로 트랙 2의 코덱 ID는 여야 합니다`A_AAC`. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip) # GetDASHStreamingSessionURL 스트림에 대한 MPEG Dynamic Adaptive Streaming over HTTP(DASH) URL을 검색합니다. 그런 다음 미디어 플레이어에서 URL을 열어 스트림 콘텐츠를 볼 수 있습니다. `StreamName` 및 `StreamARN` 파라미터는 모두 선택 사항이지만이 API 작업을 호출할 `StreamARN` 때 `StreamName` 또는를 지정해야 합니다. Amazon Kinesis 비디오 스트림에는 MPEG-DASH를 통해 데이터를 제공하기 위한 다음과 같은 요구 사항이 있습니다. + [비디오 재생 트랙 요구 사항](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + 데이터 보존이 0보다 커야 합니다. + 각 조각의 비디오 추적에는 H.264용 AVC(Advanced Video Coding) 형식 및 H.265용 HEVC 형식의 코덱 프라이빗 데이터가 포함되어야 합니다. 자세한 내용은 [MPEG-4 사양 ISO/IEC 14496-15](https://www.iso.org/standard/55980.html)를 참조하십시오. 스트림 데이터를 지정된 형식에 맞게 조정하는 방법에 대한 자세한 내용은 [NAL 적응 플래그](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html)를 참조하십시오. + 각 조각의 오디오 조각에는 AAC 형식([AAC 사양 ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) 또는 [MS Wave 형식](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html)의 코덱 프라이빗 데이터가 포함되어야 합니다. 다음 절차에서는 Kinesis Video Streams에서 MPEG-DASH를 사용하는 방법을 보여줍니다. 1. `GetDataEndpoint` API를 호출하여 엔드포인트를 가져옵니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트에 `GetDASHStreamingSessionURL` 요청을 보냅니다. 1. 를 사용하여 MPEG-DASH URL을 검색합니다`GetDASHStreamingSessionURL`. Kinesis Video Streams는 MPEG-DASH 프로토콜을 사용하여 스트림의 콘텐츠에 액세스하는 데 사용할 MPEG-DASH 스트리밍 세션을 생성합니다.는 세션의 MPEG-DASH *매니페스트*(MPEG-DASH로 스트리밍하는 데 필요한 루트 리소스)에 대해 인증된 URL(암호화된 세션 토큰 포함)을 `GetDASHStreamingSessionURL` 반환합니다. **참고** 권한이 없는 엔터티가이 토큰에 액세스할 수 있는 위치에이 토큰을 공유하거나 저장하지 마세요. 토큰은 스트림의 콘텐츠에 대한 액세스를 제공합니다. 자격 AWS 증명에 사용하는 것과 동일한 방법으로 토큰을 보호합니다. 매니페스트를 통해 사용할 수 있는 미디어는 요청된 스트림, 시간 범위 및 형식으로만 구성됩니다. 다른 미디어 데이터(예: 요청된 기간 이외의 프레임 또는 대체 비트레이트)는 사용할 수 없습니다. 1. MPEG-DASH 프로토콜을 지원하는 미디어 플레이어에 MPEG-DASH 매니페스트의 URL(암호화된 세션 토큰 포함)을 제공합니다. Kinesis Video Streams를 사용하면 매니페스트 URL을 통해 초기화 조각과 미디어 조각을 사용할 수 있습니다. 초기화 조각에는 스트림의 코덱 프라이빗 데이터와 비디오 또는 오디오 디코더 및 렌더러를 설정하는 데 필요한 기타 데이터가 포함되어 있습니다. 미디어 조각에는 인코딩된 비디오 프레임 또는 인코딩된 오디오 샘플이 포함되어 있습니다. 1. 미디어 플레이어는 인증된 URL을 수신하고 스트림 메타데이터와 미디어 데이터를 정상적으로 요청합니다. 미디어 플레이어가 데이터를 요청하면 다음 작업을 호출합니다. + **GetDASHManifest:** 재생하려는 미디어의 메타데이터가 포함된 MPEG DASH 매니페스트를 검색합니다. + **GetMP4InitFragment:** MP4 초기화 조각을 검색합니다. 미디어 플레이어는 일반적으로 미디어 조각을 로드하기 전에 초기화 조각을 로드합니다. 이 조각에는 "`fytp`" 및 "`moov`" MP4 원자와 미디어 플레이어 디코더를 초기화하는 데 필요한 하위 원자가 포함되어 있습니다. 초기화 조각은 Kinesis 비디오 스트림의 조각과 일치하지 않습니다. 여기에는 미디어 플레이어가 미디어 프레임을 디코딩하는 데 필요한 스트림 및 해당 트랙에 대한 코덱 프라이빗 데이터만 포함됩니다. + **GetMP4MediaFragment:** MP4 미디어 조각을 검색합니다. 이러한 조각에는 인코딩된 조각의 미디어 프레임과 타임스탬프를 포함하는 "`moof`" 및 "`mdat`" MP4 원자와 하위 원자가 포함됩니다. **중요** 각 조각에 포함된 코덱 프라이빗 데이터(CPD)에는 조각을 올바르게 디코딩하는 데 필요한 프레임 속도, 해상도 및 인코딩 프로파일과 같은 코덱별 초기화 정보가 포함되어 있습니다. 스트리밍 세션 중에는 CPD 변경 사항이 지원되지 않습니다. CPD는 쿼리된 미디어를 통해 일관성을 유지해야 합니다. **중요** 변경 사항 추적은 지원되지 않습니다. 트랙은 쿼리된 미디어 전체에서 일관성을 유지해야 합니다. 스트림의 조각이 비디오만 갖는 것에서 오디오와 비디오를 모두 갖는 것으로 변경되거나 AAC 오디오 트랙이 A-Law 오디오 트랙으로 변경되면 스트리밍이 실패합니다. 이 작업으로 검색된 데이터는 요금이 청구됩니다. 자세한 내용은 [ 요금](https://aws.amazon.com/kinesis/video-streams/pricing/)을 참조하세요. **참고** MPEG-DASH 세션에 적용되는 제한 사항은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). `GetMP4MediaFragment.OutgoingBytes` Amazon CloudWatch 지표를 모니터링하여 미디어 플레이어가 사용하는 데이터의 양을 모니터링할 수 있습니다. CloudWatch를 사용하여 Kinesis Video Streams를 모니터링하는 방법에 대한 자세한 내용은 [Kinesis Video Streams 모니터링을](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) 참조하세요. 요금 정보는 [Amazon Kinesis Video Streams 요금](https://aws.amazon.com/kinesis/video-streams/pricing/) 및 [AWS 요금을](https://aws.amazon.com/pricing/) 참조하세요. HLS 세션과 발신 AWS 데이터 모두에 요금이 적용됩니다. HLS에 대한 자세한 내용은 [Apple 개발자 사이트의](https://developer.apple.com) [HTTP 라이브 스트리밍](https://developer.apple.com/streaming/)을 참조하세요. **중요** Kinesis Video Streams 아카이브 미디어 API를 호출한 후 HTTP 상태 코드 및 응답 본문 외에도 오류가 발생하는 경우 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 - AWS 지원 팀에 문제를 보고하려는 경우 요청 ID가 지정된 경우 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류의 재시도 가능 여부와 조건에 대한 프로그래밍 방식 결정을 내릴 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 취해야 할 조치에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /getDASHStreamingSessionURL HTTP/1.1 Content-type: application/json { "DASHFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "DisplayFragmentNumber": "string", "DisplayFragmentTimestamp": "string", "Expires": number, "MaxManifestFragmentResults": number, "PlaybackMode": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DASHFragmentSelector](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** 요청된 조각의 시간 범위와 타임스탬프의 소스입니다. 이 파라미터는이 `ON_DEMAND` 또는 `PlaybackMode`인 경우에 필요합니다`LIVE_REPLAY`. PlaybackMode가 인 경우이 파라미터는 선택 사항입니다```LIVE`. 이 `PlaybackMode`인 경우 `LIVE`를 설정할 `FragmentSelectorType` 수 있지만를 설정해서는 `TimestampRange` 안 됩니다. `PlaybackMode`가 `ON_DEMAND` 또는 `LIVE_REPLAY`인 경우 `FragmentSelectorType` 및를 모두 설정해야 `TimestampRange` 합니다. 유형: [DASHFragmentSelector](API_reader_DASHFragmentSelector.md)객체 필수 여부: 아니요 ** [DisplayFragmentNumber](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** 조각은 세션의 시퀀스 번호를 기반으로 매니페스트 파일에서 식별됩니다. DisplayFragmentNumber가 로 설정된 경우 속성 이름이 “kvs:fn”인 매니페스트 파일의 각 S 요소에 `ALWAYS`Kinesis Video Streams 조각 번호가 추가됩니다. 이러한 조각 번호는 로깅에 사용하거나 다른 APIs(예: `GetMedia` 및 `GetMediaForFragmentList`)와 함께 사용할 수 있습니다. 이러한 사용자 지정 속성을 활용하려면 사용자 지정 MPEG-DASH 미디어 플레이어가 필요합니다. 기본 값은 `NEVER`입니다. 타입: 문자열 유효 값: `ALWAYS | NEVER` 필수 여부: 아니요 ** [DisplayFragmentTimestamp](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** MPEG-DASH 사양에 따라 매니페스트 파일에 있는 조각의 벽시계 시간은 매니페스트 자체의 속성을 사용하여 파생할 수 있습니다. 그러나 일반적으로 MPEG-DASH 호환 미디어 플레이어는 미디어 타임라인의 격차를 제대로 처리하지 못합니다. Kinesis Video Streams는 매니페스트 파일의 미디어 타임라인을 조정하여 불연속 미디어를 재생할 수 있도록 합니다. 따라서 매니페스트 파일에서 파생된 벽시계 시간이 정확하지 않을 수 있습니다. DisplayFragmentTimestamp가 로 설정된 경우 속성 이름이 “kvs:ts”인 매니페스트 파일의 각 S 요소에 `ALWAYS`정확한 조각 타임스탬프가 추가됩니다. 이 사용자 지정 속성을 활용하려면 사용자 지정 MPEG-DASH 미디어 플레이어가 필요합니다. 기본값은 `NEVER`입니다. [DASHFragmentSelector](API_reader_DASHFragmentSelector.md)가 이면 `SERVER_TIMESTAMP`타임스탬프는 서버 시작 타임스탬프가 됩니다. 마찬가지로 [DASHFragmentSelector](API_reader_DASHFragmentSelector.md)가 인 경우 `PRODUCER_TIMESTAMP`타임스탬프는 생산자 시작 타임스탬프가 됩니다. 타입: 문자열 유효 값: `ALWAYS | NEVER` 필수 여부: 아니요 ** [Expires](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** 요청된 세션이 만료될 때까지의 초 단위 시간입니다. 이 값은 300(5분)\$143200(12시간) 사이일 수 있습니다. 세션이 만료되면 해당 세션에 대해 `GetDashManifest`, `GetMP4InitFragment`또는를 새로 호출`GetMP4MediaFragment`할 수 없습니다. 기본값은 300(5분)입니다. 유형: 정수 유효한 범위: 최소값은 300입니다. 최대 값은 43200입니다. 필수 여부: 아니요 ** [MaxManifestFragmentResults](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** MPEG-DASH 매니페스트에 반환되는 최대 조각 수입니다. `PlaybackMode`가 이면 `LIVE`가장 최근의 조각이이 값까지 반환됩니다. `PlaybackMode`가 이면이 최대 수까지 가장 `ON_DEMAND`오래된 조각이 반환됩니다. 라이브 MPEG-DASH 매니페스트에서 사용할 수 있는 조각 수가 많으면 비디오 플레이어는 재생을 시작하기 전에 콘텐츠를 버퍼링하는 경우가 많습니다. 버퍼 크기를 늘리면 재생 지연 시간이 증가하지만 재생 중에 재버퍼링이 발생할 가능성은 줄어듭니다. 라이브 MPEG-DASH 매니페스트에는 최소 3개의 조각과 최대 10개의 조각이 있는 것이 좋습니다. 기본값은가 `LIVE` 또는 `PlaybackMode`인 경우 조각 5개`LIVE_REPLAY`,가 인 경우 조각 1,000`PlaybackMode`개입니다`ON_DEMAND`. 조각 1,000개의 최대값은 조각 1초가 포함된 스트림에서 16분 이상의 비디오와 조각 10초가 포함된 스트림에서 2 1/2시간 이상의 비디오에 해당합니다. 타입: Long 유효 범위: 최소값 1. 최대값은 5000입니다. 필수 여부: 아니요 ** [PlaybackMode](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** 라이브, 라이브 재생 또는 아카이브된 온디맨드 데이터를 검색할지 여부입니다. 세 가지 유형의 세션의 기능은 다음과 같습니다. + ** `LIVE` **:이 유형의 세션의 경우 MPEG-DASH 매니페스트는 사용 가능한 최신 조각으로 계속 업데이트됩니다. 미디어 플레이어는 1초 간격으로 새 매니페스트를 검색하는 것이 좋습니다. 미디어 플레이어에서 이러한 유형의 세션이 재생되면 사용자 인터페이스는 일반적으로 재생 창에서 표시할 위치를 선택할 수 있는 스크러버 제어 없이 "실시간" 알림을 표시합니다. **참고** `LIVE` 모드에서는 조각 간에 간격이 있더라도(즉, 조각이 누락된 경우) 사용 가능한 최신 조각이 MPEG-DASH 매니페스트에 포함됩니다. 이와 같은 격차로 인해 미디어 플레이어가 중지되거나 재생이 점프될 수 있습니다. 이 모드에서는 조각이 재생 목록의 최신 조각보다 오래된 경우 MPEG-DASH 매니페스트에 추가되지 않습니다. 매니페스트에 후속 조각을 추가한 후 누락된 조각을 사용할 수 있게 되면 이전 조각이 추가되지 않고 갭이 채워지지 않습니다. + ** `LIVE_REPLAY` **:이 유형의 세션의 경우 MPEG-DASH 매니페스트는 지정된 시작 시간의 조각을 포함하여 시작한다는 점을 제외하면 `LIVE` 모드에 대해 업데이트되는 방식과 유사하게 업데이트됩니다. 수집될 때 조각을 추가하는 대신 다음 조각의 기간이 경과하면 조각이 추가됩니다. 예를 들어 세션의 조각 길이가 2초인 경우 2초마다 매니페스트에 새 조각이 추가됩니다. 이 모드는 이벤트가 감지될 때부터 재생을 시작하고 세션 생성 시점을 기준으로 아직 수집되지 않은 라이브 스트리밍 미디어를 계속할 수 있는 데 유용합니다. 이 모드는 `ON_DEMAND` 모드에서 1,000개의 조각 제한으로 제한되지 않고 이전에 아카이브된 미디어를 스트리밍하는 데에도 유용합니다. + ** `ON_DEMAND` **:이 유형의 세션의 경우 MPEG-DASH 매니페스트에는에 지정된 수까지 세션의 모든 조각이 포함됩니다`MaxManifestFragmentResults`. 매니페스트는 각 세션에 대해 한 번만 검색해야 합니다. 미디어 플레이어에서 이러한 유형의 세션이 재생되면 일반적으로 사용자 인터페이스에 재생 창에서 표시할 위치를 선택할 수 있는 스크러버 제어가 표시됩니다. 모든 재생 모드에서 `FragmentSelectorType`가 `PRODUCER_TIMESTAMP`이고 시작 타임스탬프가 동일한 여러 조각이 있는 경우 조각 번호가 더 큰 조각(즉, 최신 조각)이 MPEG-DASH 매니페스트에 포함됩니다. 다른 조각은 포함되지 않습니다. 타임스탬프는 다르지만 지속 시간이 겹치는 조각은 MPEG-DASH 매니페스트에 계속 포함됩니다. 이로 인해 미디어 플레이어에서 예기치 않은 동작이 발생할 수 있습니다. 기본값은 `LIVE`입니다. 타입: 문자열 유효 값: `LIVE | LIVE_REPLAY | ON_DEMAND` 필수 여부: 아니요 ** [StreamARN](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** MPEG-DASH 매니페스트 URL을 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetDASHStreamingSessionURL_RequestSyntax) ** MPEG-DASH 매니페스트 URL을 검색할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "DASHStreamingSessionURL": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [DASHStreamingSessionURL](#API_reader_GetDASHStreamingSessionURL_ResponseSyntax) ** 미디어 플레이어가 MPEG-DASH 매니페스트를 검색하는 데 사용할 수 있는 URL(세션 토큰 포함)입니다. 유형: 문자열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** InvalidCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에 있는 코덱 프라이빗 데이터는이 작업에 유효하지 않습니다. HTTP 상태 코드: 400 ** MissingCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에서 코덱 프라이빗 데이터를 찾을 수 없습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** `GetImages`가 데이터를 보존하지 않는 스트림에 대해 요청되었습니다(즉, `DataRetentionInHours`의가 0임). HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ** UnsupportedStreamMediaTypeException ** 재생 세션의 첫 번째 조각에 있는 트랙의 코덱 IDs에서 미디어 유형(예: h.264 또는 h.265 비디오, AAC 또는 G.711 오디오)을 확인할 수 없습니다. 트랙 1의 코덱 ID는 이어야 하며`V_MPEG/ISO/AVC`, 선택적으로 트랙 2의 코덱 ID는 여야 합니다`A_AAC`. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetDASHStreamingSessionURL) # GetHLSStreamingSessionURL 스트림에 대한 HTTP 라이브 스트리밍(HLS) URL을 검색합니다. 그런 다음 브라우저 또는 미디어 플레이어에서 URL을 열어 스트림 콘텐츠를 볼 수 있습니다. `StreamName` 및 `StreamARN` 파라미터는 모두 선택 사항이지만이 API 작업을 호출할 `StreamARN` 때 `StreamName` 또는를 지정해야 합니다. Amazon Kinesis 비디오 스트림에는 HLS를 통해 데이터를 제공하기 위한 다음과 같은 요구 사항이 있습니다. + [비디오 재생 트랙 요구 사항](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + 데이터 보존이 0보다 커야 합니다. + 각 조각의 비디오 트랙에는 H.264 형식의 경우 고급 비디오 코딩(AVC) 또는 H.265 형식의 경우 HEVC([MPEG-4 사양 ISO/IEC 14496-15](https://www.iso.org/standard/55980.html))의 코덱 프라이빗 데이터가 포함되어야 합니다. 스트림 데이터를 지정된 형식에 맞게 조정하는 방법에 대한 자세한 내용은 [NAL 적응 플래그](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html)를 참조하십시오. + 각 조각의 오디오 트랙(있는 경우)에는 AAC 형식의 코덱 프라이빗 데이터가 포함되어야 합니다([AAC 사양 ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)). Kinesis Video Streams HLS 세션에는 조각화된 MPEG-4 형식(fMP4 또는 CMAF라고도 함) 또는 MPEG-2 형식(HSL 사양이 지원하는 TS 청크라고도 함)의 조각이 포함되어 있습니다. HLS 조각 유형에 대한 자세한 내용은 [HLS 사양을](https://tools.ietf.org/html/draft-pantos-http-live-streaming-23) 참조하세요. 다음 절차에서는 Kinesis Video Streams에서 HLS를 사용하는 방법을 보여줍니다. 1. `GetDataEndpoint` API를 호출하여 엔드포인트를 가져옵니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `GetHLSStreamingSessionURL` 요청을 보냅니다. 1. 를 사용하여 HLS URL을 검색합니다`GetHLSStreamingSessionURL`. Kinesis Video Streams는 HLS 프로토콜을 사용하여 스트림의 콘텐츠에 액세스하는 데 사용할 HLS 스트리밍 세션을 생성합니다.는 세션의 HLS *마스터 재생 목록*(HLS로 스트리밍하는 데 필요한 루트 리소스)에 대해 인증된 URL(암호화된 세션 토큰 포함)을 `GetHLSStreamingSessionURL` 반환합니다. **참고** 권한이 없는 엔터티가이 토큰에 액세스할 수 있는 위치에이 토큰을 공유하거나 저장하지 마십시오. 토큰은 스트림의 콘텐츠에 대한 액세스를 제공합니다. 자격 증명에 사용하는 것과 동일한 방법으로 토큰을 AWS 보호합니다. 재생 목록을 통해 사용할 수 있는 미디어는 요청된 스트림, 시간 범위 및 형식으로만 구성됩니다. 다른 미디어 데이터(예: 요청된 기간 이외의 프레임 또는 대체 비트 전송률)는 사용할 수 없습니다. 1. HLS 프로토콜을 지원하는 미디어 플레이어에 HLS 마스터 재생 목록의 URL(암호화된 세션 토큰 포함)을 제공합니다. Kinesis Video Streams를 사용하면 마스터 재생 목록 URL을 통해 HLS 미디어 재생 목록, 초기화 조각 및 미디어 조각을 사용할 수 있습니다. 초기화 조각에는 스트림의 코덱 프라이빗 데이터와 비디오 또는 오디오 디코더 및 렌더러를 설정하는 데 필요한 기타 데이터가 포함되어 있습니다. 미디어 조각에는 H.264 인코딩 비디오 프레임 또는 AAC 인코딩 오디오 샘플이 포함되어 있습니다. 1. 미디어 플레이어는 인증된 URL을 수신하고 스트림 메타데이터 및 미디어 데이터를 정상적으로 요청합니다. 미디어 플레이어가 데이터를 요청하면 다음 작업을 호출합니다. + **GetHLSMasterPlaylist:** 각 트랙의 `GetHLSMediaPlaylist` 작업에 대한 URL과 예상 비트레이트 및 해상도를 포함한 미디어 플레이어에 대한 추가 메타데이터가 포함된 HLS 마스터 재생 목록을 검색합니다. + **GetHLSMediaPlaylist:** 작업을 사용하여 MP4 초기화 조각에 액세스하는 URL과 `GetMP4InitFragment` 작업을 사용하여 MP4 미디어 조각에 액세스하는 URLs이 포함된 HLS 미디어 재생 목록을 검색합니다`GetMP4MediaFragment`. HLS 미디어 재생 목록에는가 인지 또는 `LIVE` 인지와 같이 플레이어가 재생하는 데 필요한 스트림에 대한 메타데이터도 포함되어 `PlaybackMode` 있습니다`ON_DEMAND`. HLS 미디어 재생 목록은 일반적으로 `PlaybackType`가 인 세션에 대해 정적입니다`ON_DEMAND`. HLS 미디어 재생 목록은가 인 세션`PlaybackType`의 새 조각으로 지속적으로 업데이트됩니다`LIVE`. 비디오 트랙과 오디오 트랙(해당하는 경우)에는 특정 트랙에 대한 MP4 미디어 URLs이 포함된 고유한 HLS 미디어 재생 목록이 있습니다. + **GetMP4InitFragment:** MP4 초기화 조각을 검색합니다. 미디어 플레이어는 일반적으로 미디어 조각을 로드하기 전에 초기화 조각을 로드합니다. 이 조각에는 "`fytp`" 및 "`moov`" MP4 원자와 미디어 플레이어 디코더를 초기화하는 데 필요한 하위 원자가 포함되어 있습니다. 초기화 조각은 Kinesis 비디오 스트림의 조각과 일치하지 않습니다. 여기에는 미디어 플레이어가 미디어 프레임을 디코딩하는 데 필요한 스트림 및 해당 트랙에 대한 코덱 프라이빗 데이터만 포함됩니다. + **GetMP4MediaFragment:** MP4 미디어 조각을 검색합니다. 이러한 조각에는 인코딩된 조각의 미디어 프레임과 타임스탬프를 포함하는 "`moof`" 및 "`mdat`" MP4 원자와 하위 원자가 포함됩니다. **참고** 각 조각에 포함된 코덱 프라이빗 데이터(CPD)에는 조각을 올바르게 디코딩하는 데 필요한 프레임 속도, 해상도 및 인코딩 프로파일과 같은 코덱별 초기화 정보가 포함되어 있습니다. TS와 MP4 모두 스트리밍 세션 중에 CPD 변경이 지원됩니다. 따라서 세션의 조각은 재생을 중단하지 않고 CPD에서 다른 정보를 가질 수 있습니다. 각 스트리밍 세션에 대해 500개의 CPD 변경만 허용됩니다. **중요** 변경 사항 추적은 지원되지 않습니다. 트랙은 쿼리된 미디어 전체에서 일관성을 유지해야 합니다. 스트림의 조각이 비디오만 갖는 것에서 오디오와 비디오를 모두 갖는 것으로 변경되거나 AAC 오디오 트랙이 A-Law 오디오 트랙으로 변경되면 스트리밍이 실패합니다. 이 작업으로 검색된 데이터는 요금이 청구됩니다. 자세한 내용은 [ 요금](https://aws.amazon.com/kinesis/video-streams/pricing/)을 참조하십시오. + **GetTSFragment:** 스트림의 모든 트랙에 대한 초기화 및 미디어 데이터를 모두 포함하는 MPEG TS 조각을 검색합니다. **참고** `ContainerFormat`가 인 경우 `MPEG_TS`이 API는 `GetMP4InitFragment` 및 대신 스트림 미디어를 검색`GetMP4MediaFragment`하는 데 사용됩니다. 이 작업으로 검색된 데이터는 요금이 청구됩니다. 자세한 내용은 [Kinesis Video Streams 요금을](https://aws.amazon.com/kinesis/video-streams/pricing/) 참조하세요. 스트리밍 세션 URL은 플레이어 간에 공유해서는 안 됩니다. 여러 미디어 플레이어가 세션을 공유하는 경우 서비스가 세션을 제한할 수 있습니다. 연결 제한은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). `GetMP4MediaFragment.OutgoingBytes` Amazon CloudWatch 지표를 모니터링하여 미디어 플레이어가 사용하는 데이터의 양을 모니터링할 수 있습니다. CloudWatch를 사용하여 Kinesis Video Streams를 모니터링하는 방법에 대한 자세한 내용은 [Kinesis Video Streams 모니터링을](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) 참조하세요. 요금 정보는 [Amazon Kinesis Video Streams 요금](https://aws.amazon.com/kinesis/video-streams/pricing/) 및 [AWS 요금을](https://aws.amazon.com/pricing/) 참조하세요. HLS 세션과 발신 AWS 데이터에 대한 요금이 모두 적용됩니다. 설명서 가이드: [AWS CLI 를 사용하여 HLS 스트리밍 세션 URL 검색](hls-playback.md#retrieve-hls-url) 및에서 비디오 재생 예제를 참조하세요[예: HTML 및 JavaScript에서 HLS 사용](hls-playback.md#how-hls-ex1). HLS에 대한 자세한 내용은 [Apple 개발자 사이트의](https://developer.apple.com) [HTTP 라이브 스트리밍](https://developer.apple.com/streaming/)을 참조하세요. **중요** Kinesis Video Streams 아카이브 미디어 API를 호출한 후 HTTP 상태 코드 및 응답 본문 외에도 오류가 발생하면 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 - 문제를에 보고하려는 경우 요청 ID가 주어지면 AWS지원 팀이 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류가 재시도 가능한지 여부와 조건에 대해 프로그래밍 방식으로 결정할 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 수행해야 할 작업에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /getHLSStreamingSessionURL HTTP/1.1 Content-type: application/json { "ContainerFormat": "string", "DiscontinuityMode": "string", "DisplayFragmentTimestamp": "string", "Expires": number, "HLSFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "MaxMediaPlaylistFragmentResults": number, "PlaybackMode": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ContainerFormat](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** 미디어 패키징에 사용할 형식을 지정합니다. `FRAGMENTED_MP4` 컨테이너 형식을 지정하면 미디어가 MP4 조각(fMP4 또는 CMAF)으로 패키징됩니다. 이는 패키징 오버헤드가 최소화되므로 권장되는 패키징입니다. 다른 컨테이너 형식 옵션은 입니다`MPEG_TS`. HLS는 릴리스된 이후 MPEG TS 청크를 지원했으며 때로는 이전 HLS 플레이어에서 유일하게 지원되는 패키징입니다. MPEG TS는 일반적으로 패키징 오버헤드가 5\$125%입니다. 즉, MPEG TS는 일반적으로 fMP4보다 5\$125% 더 많은 대역폭과 비용이 필요합니다. 기본값은 `FRAGMENTED_MP4`입니다. 타입: 문자열 유효 값: `FRAGMENTED_MP4 | MPEG_TS` 필수 여부: 아니요 ** [DiscontinuityMode](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** 조각 간의 불연속성을 표시하는 플래그가 미디어 재생 목록에 추가되는 시기를 지정합니다. 미디어 플레이어는 일반적으로 각 조각의 타임스탬프를 기반으로 재생할 미디어 콘텐츠 타임라인을 작성합니다. 즉, 조각 간에 겹치거나 갭이 있는 경우(이 로 [HLSFragmentSelector](API_reader_HLSFragmentSelector.md) 설정된 경우와 같음`SERVER_TIMESTAMP`) 미디어 플레이어 타임라인은 일부 위치의 조각 간에 작은 갭도 발생하고 다른 위치의 프레임을 덮어씁니다. 미디어 플레이어 타임라인의 갭으로 인해 재생이 중지되고 겹침으로 인해 재생이 지터리해질 수 있습니다. 조각 사이에 불연속성 플래그가 있는 경우 미디어 플레이어는 타임라인을 재설정하여 다음 조각이 이전 조각 바로 뒤에 재생되도록 해야 합니다. 지원되는 모드는 다음과 같습니다. + `ALWAYS`: HLS 미디어 재생 목록의 모든 조각 사이에 불연속성 마커가 배치됩니다. 조각 타임스탬프가 정확하지 않은 `ALWAYS` 경우 값을 사용하는 것이 좋습니다. + `NEVER`: 불연속성 마커는 어디에도 배치되지 않습니다. 미디어 플레이어 타임라인이 생산자 타임스탬프에 가장 정확하게 매핑되도록 `NEVER`하려면 값을 사용하는 것이 좋습니다. + `ON_DISCONTINUITY`: 갭이 있거나 50밀리초 이상 겹치는 조각 사이에 불연속성 마커가 배치됩니다. 대부분의 재생 시나리오에서는 미디어 타임라인에 심각한 문제(예: 누락된 조각)가 있을 때만 미디어 플레이어 타임라인이 재설정`ON_DISCONTINUITY`되도록 값을 사용하는 것이 좋습니다. 기본값은가 로 [HLSFragmentSelector](API_reader_HLSFragmentSelector.md) 설정된 `ALWAYS` 경우 `SERVER_TIMESTAMP`이고가 로 설정된 `NEVER` 경우 입니다`PRODUCER_TIMESTAMP`. 타입: 문자열 유효 값: `ALWAYS | NEVER | ON_DISCONTINUITY` 필수 여부: 아니요 ** [DisplayFragmentTimestamp](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** 조각 시작 타임스탬프가 HLS 미디어 재생 목록에 포함되어야 하는 시기를 지정합니다. 일반적으로 미디어 플레이어는 재생 세션에서 첫 번째 조각의 시작을 기준으로 재생헤드 위치를 시간으로 보고합니다. 그러나 시작 타임스탬프가 HLS 미디어 재생 목록에 포함된 경우 일부 미디어 플레이어는 조각 타임스탬프를 기반으로 현재 재생헤드를 절대 시간으로 보고할 수 있습니다. 이는 최종 사용자에게 미디어의 벽시계 시간을 표시하는 재생 환경을 생성하는 데 유용할 수 있습니다. 기본값은 `NEVER`입니다. [HLSFragmentSelector](API_reader_HLSFragmentSelector.md)가 이면 `SERVER_TIMESTAMP`타임스탬프는 서버 시작 타임스탬프가 됩니다. 마찬가지로 [HLSFragmentSelector](API_reader_HLSFragmentSelector.md)가 `PRODUCER_TIMESTAMP`인 경우 타임스탬프는 생산자 시작 타임스탬프가 됩니다. 타입: 문자열 유효 값: `ALWAYS | NEVER` 필수 여부: 아니요 ** [Expires](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** 요청된 세션이 만료될 때까지의 초 단위 시간입니다. 이 값은 300(5분)\$143200(12시간) 사이일 수 있습니다. 세션이 만료되면 해당 세션에 대해 , `GetHLSMasterPlaylist`, `GetHLSMediaPlaylist``GetMP4MediaFragment`, 또는 `GetMP4InitFragment`를 새로 호출`GetTSFragment`할 수 없습니다. 기본값은 300(5분)입니다. 유형: 정수 유효한 범위: 최소값은 300입니다. 최대 값은 43200입니다. 필수 여부: 아니요 ** [HLSFragmentSelector](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** 요청된 조각의 시간 범위와 타임스탬프의 소스입니다. 이 파라미터는이 `ON_DEMAND` 또는 `PlaybackMode`인 경우 필요합니다`LIVE_REPLAY`. PlaybackMode가 인 경우이 파라미터는 선택 사항입니다```LIVE`. 이 `PlaybackMode`인 경우 `LIVE`를 설정할 `FragmentSelectorType` 수 있지만를 설정해서는 `TimestampRange` 안 됩니다. `PlaybackMode`가 `ON_DEMAND` 또는 `LIVE_REPLAY`인 경우 `FragmentSelectorType` 및를 모두 설정해야 `TimestampRange` 합니다. 유형: [HLSFragmentSelector](API_reader_HLSFragmentSelector.md)객체 필수 여부: 아니요 ** [MaxMediaPlaylistFragmentResults](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** HLS 미디어 재생 목록에 반환되는 최대 조각 수입니다. `PlaybackMode`가 이면 `LIVE`가장 최근의 조각이이 값까지 반환됩니다. `PlaybackMode`가 이면이 최대 수까지 가장 `ON_DEMAND`오래된 조각이 반환됩니다. 라이브 HLS 미디어 재생 목록에서 사용할 수 있는 조각 수가 많을 경우 비디오 플레이어는 재생을 시작하기 전에 콘텐츠를 버퍼링하는 경우가 많습니다. 버퍼 크기를 늘리면 재생 지연 시간이 증가하지만 재생 중에 재버퍼링이 발생할 가능성은 줄어듭니다. 라이브 HLS 미디어 재생 목록에는 최소 3개의 조각과 최대 10개의 조각이 있는 것이 좋습니다. 기본값은가 `LIVE` 또는 `PlaybackMode`인 경우 조각 5개`LIVE_REPLAY`,가 인 경우 조각 1,000`PlaybackMode`개입니다`ON_DEMAND`. 조각 5,000개의 최대값은 조각 1초가 포함된 스트림의 비디오 80분 이상과 조각 10초가 포함된 스트림의 비디오 13시간 이상에 해당합니다. 타입: Long 유효 범위: 최소값 1. 최대값은 5000입니다. 필수 여부: 아니요 ** [PlaybackMode](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** 라이브, 라이브 재생 또는 아카이브된 온디맨드 데이터를 검색할지 여부입니다. 세 가지 유형의 세션의 기능은 다음과 같습니다. + ** `LIVE` **:이 유형의 세션의 경우 HLS 미디어 재생 목록은 사용 가능한 최신 조각으로 계속 업데이트됩니다. 미디어 플레이어는 1초 간격으로 새 재생 목록을 검색하는 것이 좋습니다. 미디어 플레이어에서 이러한 유형의 세션이 재생되면 사용자 인터페이스는 일반적으로 재생 창에서 표시할 위치를 선택할 수 있는 스크러버 제어 없이 "실시간" 알림을 표시합니다. **참고** `LIVE` 모드에서는 조각 간에 간격이 있더라도(즉, 조각이 누락된 경우) 사용 가능한 최신 조각이 HLS 미디어 재생 목록에 포함됩니다. 이와 같은 격차로 인해 미디어 플레이어가 중지되거나 재생이 점프될 수 있습니다. 이 모드에서는 조각이 재생 목록의 최신 조각보다 오래된 경우 HLS 미디어 재생 목록에 추가되지 않습니다. 후속 조각이 재생 목록에 추가된 후 누락된 조각을 사용할 수 있게 되면 이전 조각이 추가되지 않고 갭이 채워지지 않습니다. + ** `LIVE_REPLAY` **:이 유형의 세션의 경우 HLS 미디어 재생 목록은 지정된 시작 시간의 조각을 포함하는 것으로 시작한다는 점을 제외하면 `LIVE` 모드에 대해 업데이트되는 방식과 유사하게 업데이트됩니다. 조각이 수집될 때 조각을 추가하는 대신 다음 조각의 기간이 경과하면 조각이 추가됩니다. 예를 들어 세션의 조각 길이가 2초인 경우 2초마다 미디어 재생 목록에 새 조각이 추가됩니다. 이 모드는 이벤트가 감지될 때부터 재생을 시작하고 세션 생성 시점을 기준으로 아직 수집되지 않은 라이브 스트리밍 미디어를 계속할 수 있는 데 유용합니다. 이 모드는 `ON_DEMAND` 모드에서 1,000개의 조각 제한으로 제한되지 않고 이전에 아카이브된 미디어를 스트리밍하는 데에도 유용합니다. + ** `ON_DEMAND` **:이 유형의 세션의 경우 HLS 미디어 재생 목록에는에 지정된 수까지 세션의 모든 조각이 포함됩니다`MaxMediaPlaylistFragmentResults`. 재생 목록은 각 세션에 대해 한 번만 검색해야 합니다. 미디어 플레이어에서 이러한 유형의 세션이 재생되면 사용자 인터페이스는 일반적으로 재생 창에서 표시할 위치를 선택하기 위한 스크러버 제어를 표시합니다. 모든 재생 모드에서 `FragmentSelectorType`가 `PRODUCER_TIMESTAMP`이고 시작 타임스탬프가 동일한 조각이 여러 개 있는 경우 조각 번호가 가장 큰 조각(즉, 최신 조각)이 HLS 미디어 재생 목록에 포함됩니다. 다른 조각은 포함되지 않습니다. 타임스탬프는 다르지만 지속 시간이 겹치는 조각은 HLS 미디어 재생 목록에 계속 포함됩니다. 이로 인해 미디어 플레이어에서 예기치 않은 동작이 발생할 수 있습니다. 기본값은 `LIVE`입니다. 타입: 문자열 유효 값: `LIVE | LIVE_REPLAY | ON_DEMAND` 필수 여부: 아니요 ** [StreamARN](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** HLS 마스터 재생 목록 URL을 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) ** HLS 마스터 재생 목록 URL을 검색할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "HLSStreamingSessionURL": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [HLSStreamingSessionURL](#API_reader_GetHLSStreamingSessionURL_ResponseSyntax) ** 미디어 플레이어가 HLS 마스터 재생 목록을 검색하는 데 사용할 수 있는 URL(세션 토큰 포함)입니다. 유형: 문자열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** InvalidCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에 있는 코덱 프라이빗 데이터는이 작업에 유효하지 않습니다. HTTP 상태 코드: 400 ** MissingCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에서 코덱 프라이빗 데이터를 찾을 수 없습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** `GetImages`가 데이터를 보존하지 않는 스트림에 대해 요청되었습니다(즉, `DataRetentionInHours`의가 0임). HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ** UnsupportedStreamMediaTypeException ** 재생 세션의 첫 번째 조각에 있는 트랙의 코덱 IDs에서 미디어 유형(예: h.264 또는 h.265 비디오, AAC 또는 G.711 오디오)을 확인할 수 없습니다. 트랙 1의 코덱 ID는 이어야 하며`V_MPEG/ISO/AVC`, 선택적으로 트랙 2의 코덱 ID는 여야 합니다`A_AAC`. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) # GetImages 이미지에 대한 관리형 지원은 Kinesis Video Streams에서 스트리밍되고 저장된 비디오 데이터에서 이미지를 가져올 수 있는 완전 관리형 방법을 제공합니다. 이미지를 사용하여 사람, 반려동물 또는 차량 감지와 같은 기계 학습(ML) 워크로드를 실행할 수 있습니다. 또한 이미지를 사용하여 모션 이벤트에 대한 이미지 미리 보기 및 비디오 클립에 대한 스크러빙과 같은 대화형 요소를 재생에 추가할 수 있습니다. 또한 GetImages는 지정된 시간 범위, 샘플링 간격 및 이미지 형식 구성의 각 타임스탬프에 해당하는 이미지 목록을 검색합니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트에 `GetImages` 요청을 보냅니다. [비디오 재생 트랙 요구 사항](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). ## Request Syntax ``` POST /getImages HTTP/1.1 Content-type: application/json { "EndTimestamp": number, "Format": "string", "FormatConfig": { "string" : "string" }, "HeightPixels": number, "ImageSelectorType": "string", "MaxResults": number, "NextToken": "string", "SamplingInterval": number, "StartTimestamp": number, "StreamARN": "string", "StreamName": "string", "WidthPixels": number } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [EndTimestamp](#API_reader_GetImages_RequestSyntax) ** 생성할 이미지 범위의 종료 타임스탬프입니다. `StartTimestamp` \$1 사이의 시간 범위가 300초를 `EndTimestamp` 초과하는 경우를 받게 `StartTimestamp`됩니다`IllegalArgumentException`. 유형: 타임스탬프 필수 항목 여부: 예 ** [Format](#API_reader_GetImages_RequestSyntax) ** 이미지를 인코딩하는 데 사용할 형식입니다. 타입: 문자열 유효 값: `JPEG | PNG` 필수 사항 여부: 예 ** [FormatConfig](#API_reader_GetImages_RequestSyntax) ** 이미지가 생성될 때 적용할 수 있는 추가 파라미터가 포함된 키-값 페어 구조의 목록입니다. `FormatConfig` 키는 이미지를 생성하는 데 사용할 JPEG 품질 키를 `JPEGQuality`나타내는 입니다. `FormatConfig` 값은 1\$1100의 인트를 허용합니다. 값이 1이면 이미지가 더 낮은 품질과 최상의 압축으로 생성됩니다. 값이 100인 경우 최상의 품질과 적은 압축으로 이미지가 생성됩니다. 값이 제공되지 않으면 `JPEGQuality` 키의 기본값이 80으로 설정됩니다. 유형: 문자열 간 맵 맵 항목: 최대 항목 수 1개입니다. 유효한 키: `JPEGQuality` 값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256. 값 패턴: `^[a-zA-Z_0-9]+` 필수 여부: 아니요 ** [HeightPixels](#API_reader_GetImages_RequestSyntax) ** `WidthPixels` 파라미터와 함께 사용되는 출력 이미지의 높이입니다. `HeightPixels` 및 `WidthPixels` 파라미터가 모두 제공되면 이미지가 지정된 종횡비에 맞게 늘어납니다. `HeightPixels` 파라미터만 제공된 경우 원래 종횡비를 사용하여 `WidthPixels` 비율을 계산합니다. 파라미터가 제공되지 않으면 원래 이미지 크기가 반환됩니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 2160입니다. 필수 여부: 아니요 ** [ImageSelectorType](#API_reader_GetImages_RequestSyntax) ** 이미지를 생성하는 데 사용할 서버 또는 생산자 타임스탬프의 오리진입니다. 타입: 문자열 유효 값: `PRODUCER_TIMESTAMP | SERVER_TIMESTAMP` 필수 사항 여부: 예 ** [MaxResults](#API_reader_GetImages_RequestSyntax) ** API에서 반환할 최대 이미지 수입니다. 기본 제한은 API 응답당 이미지 25개입니다. 이 값보다 `MaxResults` 큰 값을 제공하면 페이지 크기가 25가 됩니다. 추가 결과는 페이지 매김됩니다. 타입: Long 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_reader_GetImages_RequestSyntax) ** 다음 이미지 세트의 페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답에서 도출된 `GetImages:NextToken`입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 4096자입니다. 패턴: `[a-zA-Z0-9+/]+={0,2}` 필수 여부: 아니요 ** [SamplingInterval](#API_reader_GetImages_RequestSyntax) ** 스트림에서 이미지를 생성해야 하는 밀리초(ms) 단위의 시간 간격입니다. 제공할 수 있는 최소값은 200ms(초당 이미지 5개)입니다. 타임스탬프 범위가 샘플링 간격보다 작으면 사용 가능한 경우의 이미지가 반환`startTimestamp`됩니다. 유형: 정수 필수 항목 여부: 아니요 ** [StartTimestamp](#API_reader_GetImages_RequestSyntax) ** 이미지를 생성해야 하는 시작점입니다. 이미지를 반환하려면 타임스탬프의 포함 범위 `StartTimestamp` 내에 있어야 합니다. 유형: 타임스탬프 필수 항목 여부: 예 ** [StreamARN](#API_reader_GetImages_RequestSyntax) ** 이미지를 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetImages_RequestSyntax) ** 이미지를 검색할 스트림의 이름입니다. `StreamName` 또는를 지정해야 합니다`StreamARN`. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [WidthPixels](#API_reader_GetImages_RequestSyntax) ** `HeightPixels` 파라미터와 함께 사용되는 출력 이미지의 너비입니다. `WidthPixels` 및 `HeightPixels` 파라미터가 모두 제공되면 이미지가 지정된 종횡비에 맞게 늘어납니다. `WidthPixels` 파라미터만 제공되거나 만 `HeightPixels` 제공되면 `ValidationException`가 발생합니다. 파라미터가 제공되지 않으면 스트림의 원래 이미지 크기가 반환됩니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 3840입니다. 필수 항목 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "Images": [ { "Error": "string", "ImageContent": "string", "TimeStamp": number } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Images](#API_reader_GetImages_ResponseSyntax) ** 비디오 스트림에서 생성된 이미지 목록입니다. 지정된 타임스탬프에 사용할 수 있는 미디어가 없는 경우 `NO_MEDIA` 오류가 출력에 나열됩니다. 이미지가 생성되는 동안 오류가 발생하면 `MEDIA_ERROR`가 출력에 누락된 이미지의 원인으로 나열됩니다. 타입: [Image](API_reader_Image.md)객체 배열 ** [NextToken](#API_reader_GetImages_ResponseSyntax) ** 더 많은 이미지를 가져오기 위해 요청에 사용된 암호화된 토큰입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 4096자입니다. 패턴: `[a-zA-Z0-9+/]+={0,2}` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** `GetImages` 데이터를 보존하지 않는 스트림에 대해가 요청되었습니다(즉, `DataRetentionInHours`의가 0임). HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되는 경우이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetImages) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetImages) # GetMediaForFragmentList Amazon Kinesis 비디오 스트림의 아카이브된 데이터에서 조각 목록(조각 번호로 지정됨)에 대한 미디어를 가져옵니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `GetMediaForFragmentList` 요청을 보냅니다. 제한은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). **중요** Kinesis Video Streams 아카이브 미디어 API를 호출한 후 HTTP 상태 코드 및 응답 본문 외에도 오류가 발생하면 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 -에 문제를 보고하려는 경우 요청 ID가 주어지면 AWS지원 팀이 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류를 재시도할 수 있는지 여부와 조건에 대해 프로그래밍 방식으로 결정할 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 수행해야 할 작업에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /getMediaForFragmentList HTTP/1.1 Content-type: application/json { "Fragments": [ "string" ], "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 미디어를 검색할 조각 수의 목록입니다. 를 사용하여 이러한 값을 검색합니다[ListFragments](API_reader_ListFragments.md). 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 1000입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[0-9]+$` 필수 여부: 예 ** [StreamARN](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 조각 미디어를 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. 이 파라미터 또는 `StreamName` 파라미터를 지정합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 조각 미디어를 검색할 스트림의 이름입니다. 이 파라미터 또는 `StreamARN` 파라미터를 지정합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-Type: ContentType Payload ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답에 다음 HTTP 헤더가 반환됩니다. ** [ContentType](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** 요청된 미디어의 콘텐츠 유형입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[a-zA-Z0-9_\.\-]+$` 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [Payload](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** Kinesis Video Streams가 반환하는 페이로드는 지정된 스트림의 청크 시퀀스입니다. 청크에 대한 자세한 내용은 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)를 참조하세요. Kinesis Video Streams가 `GetMediaForFragmentList` 호출에서 반환하는 청크에는 다음과 같은 추가 Matroska(MKV) 태그도 포함됩니다. + AWS\$1KINESISVIDEO\$1FRAGMENT\$1NUMBER - 청크에 반환된 조각 번호입니다. + AWS\$1KINESISVIDEO\$1SERVER\$1SIDE\$1TIMESTAMP - 조각의 서버 측 타임스탬프입니다. + AWS\$1KINESISVIDEO\$1PRODUCER\$1SIDE\$1TIMESTAMP - 조각의 생산자 측 타임스탬프입니다. 예외가 발생하면 다음 태그가 포함됩니다. + AWS\$1KINESISVIDEO\$1FRAGMENT\$1NUMBER - 예외를 발생시킨 조각의 수입니다. + AWS\$1KINESISVIDEO\$1EXCEPTION\$1ERROR\$1CODE - 오류의 정수 코드입니다. + AWS\$1KINESISVIDEO\$1EXCEPTION\$1MESSAGE - 예외에 대한 텍스트 설명입니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) # ListFragments 아카이브된 데이터 내에서 지정된 스트림 및 타임스탬프 범위의 [Fragment](API_reader_Fragment.md) 객체 목록을 반환합니다. 조각 나열은 최종적으로 일관됩니다. 즉, 생산자가 조각이 지속되었다는 확인을 수신하더라도에 대한 요청에서 결과가 즉시 반환되지 않을 수 있습니다`ListFragments`. 그러나 결과는 일반적으로 1초 이내에 사용할 수 있습니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트에 `ListFragments` 요청을 보냅니다. **중요** Kinesis Video Streams 아카이브 미디어 API를 호출한 후 HTTP 상태 코드 및 응답 본문 외에도 오류가 발생하는 경우 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 -에 문제를 보고하려는 경우 요청 ID가 주어지면 AWS지원 팀이 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류의 재시도 가능 여부와 조건에 대한 프로그래밍 방식 결정을 내릴 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 취해야 할 조치에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /listFragments HTTP/1.1 Content-type: application/json { "FragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "MaxResults": number, "NextToken": "string", "StreamARN": "string", "StreamName": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [FragmentSelector](#API_reader_ListFragments_RequestSyntax) ** 반환할 조각 범위의 타임스탬프 범위와 타임스탬프 오리진을 설명합니다. 이는가 API에 전달되지 `NextToken` 않은 경우에만 필요합니다. 유형: [FragmentSelector](API_reader_FragmentSelector.md)객체 필수 여부: 아니요 ** [MaxResults](#API_reader_ListFragments_RequestSyntax) ** 반환할 총 조각 수입니다. 사용 가능한 총 조각 수가에 지정된 값보다 많으면 페이지 매김`max-results`을 재개하는 데 사용할 수 있는 출력에 [ListFragments:NextToken](#KinesisVideo-reader_ListFragments-response-NextToken)이 제공됩니다. 기본값은 100입니다. 타입: Long 유효한 범위: 최소값은 1입니다. 최대값은 1000입니다. 필수 여부: 아니요 ** [NextToken](#API_reader_ListFragments_RequestSyntax) ** 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답의 [ListFragments:NextToken](#KinesisVideo-reader_ListFragments-response-NextToken)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 4096자입니다. 패턴: `[a-zA-Z0-9+/]+={0,2}` 필수 여부: 아니요 ** [StreamARN](#API_reader_ListFragments_RequestSyntax) ** 조각 목록을 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. 이 파라미터 또는 `StreamName` 파라미터를 지정합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_ListFragments_RequestSyntax) ** 조각 목록을 검색할 스트림의 이름입니다. 이 파라미터 또는 `StreamARN` 파라미터를 지정합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "Fragments": [ { "FragmentLengthInMilliseconds": number, "FragmentNumber": "string", "FragmentSizeInBytes": number, "ProducerTimestamp": number, "ServerTimestamp": number } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Fragments](#API_reader_ListFragments_ResponseSyntax) ** 선택기 기준을 충족하는 스트림의 아카이브된 [Fragment](API_reader_Fragment.md) 객체 목록입니다. 페이지 간에도 결과는 특정 순서가 아닙니다. 스트림에 선택기 기준을 충족하는 조각이 없는 경우 빈 목록이 반환됩니다. 타입: [Fragment](API_reader_Fragment.md)객체 배열 ** [NextToken](#API_reader_ListFragments_ResponseSyntax) ** 반환된 목록이 잘린 경우 작업은 결과의 다음 페이지를 검색하는 데 사용할이 토큰을 반환합니다. 이 값은 반환할 결과가 더 이상 없는 `null` 경우입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 4096자입니다. 패턴: `[a-zA-Z0-9+/]+={0,2}` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/ListFragments) # Amazon Kinesis Video Signaling 채널 Amazon Kinesis Video Signaling 채널에서 지원하는 작업은 다음과 같습니다. + [GetIceServerConfig](API_signaling_GetIceServerConfig.md) + [SendAlexaOfferToMaster](API_signaling_SendAlexaOfferToMaster.md) # GetIceServerConfig **참고:**이 API를 사용하기 전에 `GetSignalingChannelEndpoint` API를 호출하여 HTTPS 엔드포인트를 요청해야 합니다. 그런 다음 `GetIceServerConfig` API 요청에서 엔드포인트와 리전을 지정합니다. WebRTC 연결을 구성하는 데 사용할 수 있는 URIs, 사용자 이름 및 암호를 포함한 대화형 연결 설정(ICE) 서버 구성 정보를 가져옵니다. ICE 구성 요소는이 구성 정보를 사용하여 NAT(TURN) 릴레이 서버를 중심으로 릴레이를 사용한 순회 인증을 포함하여 WebRTC 연결을 설정합니다. TURN은 peer-to-peer 애플리케이션의 연결을 개선하는 데 사용되는 프로토콜입니다. TURN은 클라우드 기반 릴레이 서비스를 제공하여 하나 이상의 피어가 직접 peer-to-peer 연결을 사용할 수 없는 경우에도 연결을 설정할 수 있도록 합니다. 자세한 내용은 [TURN 서비스에 대한 액세스를 위한 REST API를](https://tools.ietf.org/html/draft-uberti-rtcweb-turn-rest-00) 참조하세요. 피어 중 하나가 신호 채널을 통해 직접 peer-to-peer 연결을 설정할 수 없는 경우이 API를 호출하여 폴백 메커니즘을 설정할 수 있습니다. 이 API를 호출하려면 신호 채널의 Amazon 리소스 이름(ARN)을 지정해야 합니다. ## Request Syntax ``` POST /v1/get-ice-server-config HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "ClientId": "string", "Service": "string", "Username": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelARN](#API_signaling_GetIceServerConfig_RequestSyntax) ** 구성된 피어 간의 peer-to-peer 연결에 사용할 신호 채널의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [ClientId](#API_signaling_GetIceServerConfig_RequestSyntax) ** 뷰어의 고유 식별자입니다. 신호 채널 내에서 고유해야 합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ** [Service](#API_signaling_GetIceServerConfig_RequestSyntax) ** 원하는 서비스를 지정합니다. 현재는 유일하게 유효한 값`TURN`입니다. 타입: 문자열 유효 값: `TURN` 필수 여부: 아니요 ** [Username](#API_signaling_GetIceServerConfig_RequestSyntax) ** 자격 증명과 연결할 선택적 사용자 ID입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "IceServerList": [ { "Password": "string", "Ttl": number, "Uris": [ "string" ], "Username": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [IceServerList](#API_signaling_GetIceServerConfig_ResponseSyntax) ** ICE 서버 정보 객체의 목록입니다. 타입: [IceServer](API_signaling_IceServer.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과하여 요청이 제한되었습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** InvalidClientException ** 지정된 클라이언트가 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ** SessionExpiredException ** 클라이언트 세션이 만료된 경우. 클라이언트가 연결되면 세션은 45분 동안 유효합니다. 클라이언트는 메시지 전송/수신을 계속하려면 채널에 다시 연결해야 합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-signaling-2019-12-04/GetIceServerConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-signaling-2019-12-04/GetIceServerConfig) # SendAlexaOfferToMaster **참고** 이 API를 사용하기 전에 `GetSignalingChannelEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 `SendAlexaOfferToMaster` API 요청에서 엔드포인트와 리전을 지정합니다. 이 API를 사용하면 WebRTC 지원 디바이스를 Alexa 디스플레이 디바이스와 연결할 수 있습니다. 호출되면 마스터 피어에 Alexa 세션 설명 프로토콜(SDP) 제안을 보냅니다. 제안은 마스터가 지정된 신호 채널에 연결되는 즉시 전달됩니다. 이 API는 연결된 마스터의 SDP 응답을 반환합니다. 마스터가 신호 채널에 연결되지 않은 경우 메시지가 만료될 때까지 재전송 요청이 이루어집니다. ## Request Syntax ``` POST /v1/send-alexa-offer-to-master HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "MessagePayload": "string", "SenderClientId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ChannelARN](#API_signaling_SendAlexaOfferToMaster_RequestSyntax) ** Alexa와 마스터 피어가 통신하는 신호 채널의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [MessagePayload](#API_signaling_SendAlexaOfferToMaster_RequestSyntax) ** base64로 인코딩된 SDP는 콘텐츠를 제공합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 10000입니다. 패턴: `[a-zA-Z0-9+/=]+` 필수 여부: 예 ** [SenderClientId](#API_signaling_SendAlexaOfferToMaster_RequestSyntax) ** 발신자 클라이언트의 고유 식별자입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "Answer": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Answer](#API_signaling_SendAlexaOfferToMaster_ResponseSyntax) ** base64로 인코딩된 SDP 응답 콘텐츠입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 10000입니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과하여 요청이 제한되었습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 호출자는이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-signaling-2019-12-04/SendAlexaOfferToMaster) # Amazon Kinesis Video WebRTC 스토리지 Amazon Kinesis Video WebRTC Storage에서 지원하는 작업은 다음과 같습니다. + [JoinStorageSession](API_webrtc_JoinStorageSession.md) + [JoinStorageSessionAsViewer](API_webrtc_JoinStorageSessionAsViewer.md) # JoinStorageSession **참고** 이 API를 사용하기 전에 `GetSignalingChannelEndpoint` API를 호출하여 WEBRTC 엔드포인트를 요청해야 합니다. 그런 다음 `JoinStorageSession` API 요청에서 엔드포인트와 리전을 지정합니다. 진행 중인 단방향 비디오 및/또는 다방향 오디오 WebRTC 세션에 입력 채널의 비디오 생성 디바이스로 참여합니다. 채널에 대한 기존 세션이 없는 경우 새 스트리밍 세션을 생성하고 신호 채널의 Amazon 리소스 이름(ARN)을 제공합니다. 현재 `SINGLE_MASTER` 유형의 경우 비디오 생성 디바이스는 오디오 및 비디오 미디어를 모두 스트림으로 수집할 수 있습니다. 비디오 생성 디바이스만 세션에 참여하고 미디어를 레코딩할 수 있습니다. **중요** 현재 WebRTC 수집에는 오디오 트랙과 비디오 트랙이 모두 필요합니다. 현재 요구 사항: 비디오 트랙: H.264 오디오 트랙: Opus 비디오: 최대 해상도는 SQFHD(1920x1920)입니다. KVS WebRTC 수집은 현재 특정 H264 프로파일 세트를 지원합니다. 제약 기준 기준 기본 높음 제한-높음 프로그레시브-높음 Kinesis 비디오 스트림의 결과 수집 비디오에는 H.264 비디오 및 AAC 오디오 파라미터가 있습니다. 마스터 참가자가 WebRTC를 통해 연결을 협상하면 수집된 미디어 세션이 Kinesis 비디오 스트림에 저장됩니다. 그러면 여러 뷰어가 재생 APIs. 수집된 WebRTC 미디어에서 `HLS` 또는 `DASH` 재생, [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)를 통한 이미지 생성 등과 같은 기존 Kinesis Video Streams 기능을 사용할 수도 있습니다. **참고** S3 이미지 전송 및 알림은 현재 지원되지 않습니다. **참고** 하나의 비디오 생성 디바이스 클라이언트만 채널의 세션과 연결할 수 있다고 가정합니다. 둘 이상의 클라이언트가 특정 채널의 세션에 비디오 생성 디바이스로 조인하는 경우 가장 최근의 클라이언트 요청이 우선합니다. **추가 정보** + **Idempotent** -이 API는 멱등성이 없습니다. + **재시도 동작** - 새 API 호출로 계산됩니다. + **동시 호출** - 동시 호출이 허용됩니다. 제안은 각 호출당 한 번씩 전송됩니다. ## Request Syntax ``` POST /joinStorageSession HTTP/1.1 Content-type: application/json { "channelArn": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) ** 신호 채널의 Amazon 리소스 이름(ARN)입니다. 이 입력 파라미터의 대소문자를 기록해 둡니다. 유형: String 패턴: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 403 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession) # JoinStorageSessionAsViewer **참고** 이 API를 사용하기 전에 `GetSignalingChannelEndpoint` API를 호출하여 WEBRTC 엔드포인트를 요청해야 합니다. 그런 다음 `JoinStorageSessionAsViewer` API 요청에서 엔드포인트와 리전을 지정합니다. `JoinStorageSessionAsViewer`를 사용하면 최종 사용자가 진행 중인 클라우드 레코딩 WebRTC 스트리밍 세션에 참여할 수 있습니다. 이 API는 최종 사용자와 레코딩 에이전트 간에 SDP 제안 및 ICE 후보를 전송하여 WebRTC 연결을 시작하여 최종 사용자가 레코딩 에이전트를 통해 마스터로부터 실시간 비디오를 수신하고 레코딩 에이전트를 통해 양방향 오디오 통신에 참여할 수 있도록 합니다. 연결되면 최종 사용자의 오디오가 제공된 경우 마스터 참가자를 포함하여 연결된 다른 모든 피어에 전달되고 Kinesis Video 스트림에 저장되는 WebRTC 스트림에 통합됩니다. **중요** 현재 최종 사용자는 비디오 트랙을 전송할 수 없습니다. 최종 사용자는 선택적 오디오 트랙을 보내거나 트랙을 전혀 보내지 않을 수 있습니다. 현재 최종 사용자 참가자 전송 요구 사항: 비디오 트랙: 지원되지 않음 오디오 트랙(선택 사항): Opus 마스터 참가자가 현재 비디오 생성 디바이스에 연결되어 있는 경우 Kinesis 비디오 스트림의 결과 수집 비디오에는 H.264 비디오 및 AAC 오디오 파라미터가 있습니다. **참고** 최종 참가자는 마스터 참가자가 아닌 스토리지 세션에 직접 연결합니다. 스토리지 세션은 미디어를 혼합, 복제 및 적절한 대상으로 라우팅하는 작업을 담당합니다. **참고** 마스터 참가자가 없는 경우 최종 사용자는 서로 들을 수 없습니다. 최종 사용자가 WebRTC를 통해 연결을 협상하면 마스터 참가자가 스토리지 세션에 연결되어 있는 한 수집된 오디오 세션이 Kinesis 비디오 스트림에 저장됩니다. 수집된 WebRTC 미디어에서 `HLS` 또는 `DASH` 재생, [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)를 통한 이미지 생성 등과 같은 기존 Kinesis Video Streams 기능을 사용할 수도 있습니다. **참고** S3 이미지 전송 및 알림은 현재 지원되지 않습니다. **참고** 하나의 비디오 생성 디바이스 클라이언트만 채널의 세션과 연결할 수 있다고 가정합니다. 둘 이상의 클라이언트가 특정 채널의 세션에 비디오 생성 디바이스로 조인하는 경우 가장 최근의 클라이언트 요청이 우선합니다. **Limits** 현재 제한이 적용됩니다. + **최대 뷰어 수:** 3 + **최종 사용자 참가자가 마스터 참가자 없이 스토리지 세션에 연결된 상태로 유지되는 최대 시간:** 3분 **중요** 최종 사용자가 스토리지 세션에서 연결을 끊는 경우(피어 연결을 끊는 경우) 할당량(최종 사용자 제한)은 1분 동안 소비된 상태로 유지됩니다. 이 1분 동안 최종 사용자는 동일한 클라이언트 ID로이 API를 호출하여 추가 최종 사용자 할당량을 소비하지 않고 세션에 다시 참여할 수 있습니다. 1분 후 최종 사용자 할당량이 릴리스되고 다른 최종 사용자가 참여할 수 있습니다. **추가 정보** + **Idempotent** -이 API는 멱등성이 없습니다. + **재시도 동작** - 새 API 호출로 계산됩니다. + **동시 호출** - 동시 호출이 허용됩니다. 제안은 각 호출당 한 번씩 전송됩니다. ## Request Syntax ``` POST /joinStorageSessionAsViewer HTTP/1.1 Content-type: application/json { "channelArn": "string", "clientId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [channelArn](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) ** 신호 채널의 Amazon 리소스 이름(ARN)입니다. 이 입력 파라미터의 대소문자를 기록해 둡니다. 유형: String 패턴: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 예 ** [clientId](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) ** 발신자 클라이언트의 고유 식별자입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 403 ** ClientLimitExceededException ** 허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. HTTP 상태 코드: 400 ** InvalidArgumentException ** 이 입력 파라미터의 값이 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)