Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

StartEdgeConfigurationUpdate

API asynchrone qui met à jour la configuration périphérique existante d'un flux. Le Kinesis Video Stream synchronisera la configuration périphérique du flux avec le composant Edge Agent IoT Greengrass qui s'exécute sur un appareil IoT Hub, configuré dans vos locaux. Le temps de synchronisation peut varier et dépend de la connectivité du périphérique Hub. Il SyncStatus sera mis à jour au fur et à mesure que la configuration Edge sera reconnue et synchronisée avec l'agent Edge.

Si cette API est invoquée pour la première fois, une nouvelle configuration périphérique sera créée pour le flux et le statut de synchronisation sera défini surSYNCING. Vous devrez attendre que l'état de synchronisation atteigne un état de terminal tel que :IN_SYNC, ouSYNC_FAILED, avant de réutiliser cette API. Si vous invoquez cette API pendant le processus de synchronisation, une ResourceInUseException sera émise. La connectivité de la configuration périphérique du flux et de l'agent Edge sera réessayée pendant 15 minutes. Après 15 minutes, le statut passera à l'SYNC_FAILEDétat actuel.

Pour déplacer une configuration Edge d'un appareil à un autre, utilisez cette DeleteEdgeConfiguration option pour supprimer la configuration Edge actuelle. Vous pouvez ensuite appeler StartEdgeConfigurationUpdate avec un ARN du périphérique Hub mis à jour.

Syntaxe de la demande

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"
}

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

Syntaxe de la réponse

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"
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :