翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateSignalingChannel シグナリングチャネルを作成します。 `CreateSignalingChannel` は非同期の操作です。 ## リクエストの構文 ``` 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 です。最大長は 1,024 です。パターン: `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 のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for .NET V4](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 SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for Java V2](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 SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateSignalingChannel) + [AWS SDK for Python](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)