翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateStream 新しい Kinesis ビデオストリームを作成します。 新しいストリームを作成すると、Kinesis Video Streams によってバージョン番号が割り当てられます。ストリームのメタデータを変更すると、Kinesis Video Streams によってバージョンが更新されます。 `CreateStream` は非同期の操作です。 サービスの仕組みについては、「[仕組み](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html)」を参照してください。 `KinesisVideo:CreateStream` アクションのアクセス許可が必要です。 ## リクエストの構文 ``` 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 分の保持時間と200 MB の容量の制限があります。いずれかの制限に達すると、フラグメントはバッファから削除されます。 型: 整数 値の範囲: 最小値 は 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)」を参照してください。`MediaType` を指定する場合は、ガイドラインの「[命名要件](https://tools.ietf.org/html/rfc6838#section-4.2)」を参照してください。 有効な値の例として、 "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 です。最大長は 1,024 です。 パターン: `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 のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for .NET V4](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 SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Java V2](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 SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Python](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)