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

StartEdgeConfigurationUpdate

ストリームの既存のエッジ設定を更新する非同期 API。Kinesis ビデオストリームは、ストリームのエッジ構成を、オンプレミスで設定された IoT Hub デバイス上で動作する Edge Agent IoT Greengrass コンポーネントと同期します。同期にかかる時間は、ハブデバイスの接続状況によって異なる場合があります。SyncStatusエッジ構成が確認され、Edge Agent と同期されると更新されます。

この API を初めて呼び出すと、ストリーム用に新しいエッジ設定が作成され、同期ステータスはに設定されます。SYNCINGこの API を再度使用する前に、同期ステータスが:IN_SYNCSYNC_FAILED、またはなどの端末状態になるまで待つ必要があります。同期処理中にこの API を呼び出すと、ResourceInUseExceptionがスローされます。ストリームのエッジ設定と Edge Agent の接続は 15 分間再試行されます。15 分後、SYNC_FAILEDステータスはその状態に移行します。

エッジ構成をあるデバイスから別のデバイスに移動するには、DeleteEdgeConfigurationを使用して現在のエッジ構成を削除します。その後、更新されたハブデバイス ARN StartEdgeConfigurationUpdate で呼び出すことができます。

リクエストの構文

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 形式のデータを受け入れます。

レスポンスの構文

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 形式で返されます。

エラー

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

その他の参照資料

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