翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # StartEdgeConfigurationUpdate ストリームの既存のエッジ設定を更新する非同期 API。Kinesis Video Stream は、ストリームのエッジ設定を、オンプレミスでセットアップされた IoT Hub Device で実行される Edge Agent IoT Greengrass コンポーネントと同期します。同期時間は、Hub デバイスの接続によって異なります。`SyncStatus` エッジ設定が確認され、エッジエージェントと同期されると、が更新されます。この API が初めて呼び出されると、ストリームの新しいエッジ設定が作成され、同期ステータスがに設定されます`SYNCING`。同期ステータスが `IN_SYNC`、、などの終了状態になるまで待ってから`SYNC_FAILED`、この API を再度使用する必要があります。同期プロセス中にこの API を呼び出すと、 `ResourceInUseException` がスローされます。ストリームのエッジ設定とエッジエージェントの接続は 15 分間再試行されます。15 分後、ステータスは `SYNC_FAILED`状態に移行します。エッジ設定をあるデバイスから別のデバイスに移動するには、 [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) を使用して現在のエッジ設定を削除します。その後、更新された Hub Device ARN を使用して StartEdgeConfigurationUpdate を呼び出すことができます。 **注記** この API は、 AWS アフリカ (ケープタウン) リージョン af-south-1 では利用できません。 ## リクエストの構文 ``` 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 です。最大長は 1,024 です。パターン: `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 です。最大長は 1,024 です。パターン: `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 のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for .NET V4](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 SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for Java V2](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 SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate) + [AWS SDK for Python](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)