CreateStream - Amazon Kinesis Video Streams
リクエストの構文URI リクエストパラメータリクエスト本文レスポンスの構文レスポンス要素エラー以下の資料も参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateStream

新しい Kinesis ビデオストリームを作成します。

新しいストリームを作成すると、Kinesis Video Streams によってバージョン番号が割り当てられます。ストリームのメタデータを変更すると、Kinesis Video Streams によってバージョンが更新されます。

CreateStream は非同期の操作です。

サービスの仕組みについては、「仕組み」を参照してください。

KinesisVideo:CreateStream アクションのアクセス許可が必要です。

リクエストの構文

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

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

URI リクエストパラメータ

リクエストではURIパラメータを使用しません。

リクエスト本文

リクエストは、 JSON形式の次のデータを受け入れます。

DataRetentionInHours

ストリームにデータを保持する時間数。Kinesis Video Streams は、ストリームに関連付けられているデータストアにデータを保持します。

デフォルト値は 0 で、ストリームがデータを維持しないことを示します。最小値は 1 時間です。

DataRetentionInHours の値が 0 の場合でも、コンシューマーはサービスホストバッファーに残っているフラグメントを消費できます。このバッファーには、5 分の保持時間と200 MB の容量の制限があります。いずれかの制限に達すると、フラグメントはバッファから削除されます。

型: 整数

値の範囲: 最小値 は 0 です。

必須: いいえ

DeviceName

ストリームに書き込んでいるデバイスの名前。

注記

現在の実装では、Kinesis Video Streams はこの名前を使用しません。

タイプ: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

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

必須: いいえ

KmsKeyId

Kinesis Video Streams がストリームデータの暗号化に使用する AWS Key Management Service （AWS KMS) キーの ID。

キー ID が指定されていない場合、デフォルトの Kinesis Video 管理キー (aws/kinesisvideo) が使われます。

詳細については、「DescribeKey」を参照してください。

タイプ: 文字列

長さの制約: 最小長は 1 です。最大長は 2,048 です。

パターン: .+

必須: いいえ

MediaType

ストリームのメディアタイプ。ストリームのコンシューマーは、ストリームの処理時にこの情報を使用できます。メディアタイプの詳細については、「メディアタイプ」を参照してください。MediaType を指定する場合は、ガイドラインの「命名要件」を参照してください。

有効な値の例にはvideo/h264" and "video/h264,audio/aac「」が含まれます。

このパラメータはオプションです。デフォルト値は null (または では空) ですJSON。

タイプ: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

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

必須: いいえ

StreamName

作成しているストリームの名前。

ストリーム名はストリームの識別子であり、アカウントやリージョンごとに一意である必要があります。

タイプ: 文字列

長さの制約: 最小長は 1 です。最大長は 256 です。

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

必須: はい

Tags

指定されたストリームに関連付けるタグのリスト。各タグはキーと値のペアです (値はオプションです)。

型: 文字列から文字列へのマップ

マップエントリ: 項目の最大数は 50 です。

キーの長さ制限: 最小長さは 1 です。最大長は 128 です。

キーパターン: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

値の長さの制限: 最小長は 0 です。最大長は 256 です。

値のパターン: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

必須: いいえ

レスポンスの構文

HTTP/1.1 200
Content-type: application/json

{
   "StreamARN": "string"
}

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを返します。

次のデータは、 サービスによって JSON 形式で返されます。

StreamARN

ストリームの Amazon リソースネーム (ARN）。

タイプ: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

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

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AccountStreamLimitExceededException

アカウント用に作成されたストリームの数が多すぎます。

HTTP ステータスコード: 400

ClientLimitExceededException

Kinesis Video Streams は、許可されたクライアントコールの制限を超えているため、リクエストをスロットリングしました。後で呼び出しを試みてください。

HTTP ステータスコード: 400

DeviceStreamLimitExceededException

実装されていません。

HTTP ステータスコード: 400

InvalidArgumentException

この入力パラメータの値は無効です。

HTTP ステータスコード: 400

InvalidDeviceException

実装されていません。

HTTP ステータスコード: 400

ResourceInUseException

入力 StreamARNまたは ChannelARNCLOUD_STORAGE_MODEが別の Kinesis Video Stream リソースに既にマッピングされている場合、または指定された入力 StreamARNまたは ChannelARNがアクティブステータスでない場合は、次のいずれかの を試してください。

  1. 特定のチャネルがマッピングされるストリームDescribeMediaStorageConfigurationAPIを決定する 。

  2. 特定のストリームがマッピングされるチャネルDescribeMappedResourceConfigurationAPIを決定する 。

  3. リソースのステータスを決定する DescribeSignalingChannel API DescribeStreamまたは 。

HTTP ステータスコード: 400

TagsPerResourceExceededLimitException

リソースに関連付けることができるタグの上限を超えています。Kinesis ビデオストリームは、最大 50 個のタグをサポートできます。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の 1 つAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。