翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # UpdateMediaStorageConfiguration をストリーム`SignalingChannel`に関連付けて、メディアを保存します。を指定できるシグナリングモードは 2 つあります。 + `StorageStatus` が有効になっている場合、データは`StreamARN`提供された に保存されます。WebRTC Ingestion を機能させるには、ストリームでデータ保持が有効になっている必要があります。 + `StorageStatus` が無効になっている場合、データは保存されず、 `StreamARN`パラメータは必要ありません。 **重要** `StorageStatus` が有効になっている場合、peer-to-peer (マスタービューワー) 接続は行われなくなります。ピアはストレージセッションに直接接続します。`JoinStorageSession` API を呼び出して SDP オファーの送信をトリガーし、ピアとストレージセッション間の接続を確立する必要があります。 ## リクエストの構文 ``` 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 です。最大長は 1,024 です。 パターン: `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 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の 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 のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for .NET V4](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 SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for Java V2](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 SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS SDK for Python](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)