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.
# Gérez les flux de données pour AWS IoT SiteWise
Un flux de données est la ressource qui contient des séries chronologiques historiques. Chaque flux de données est identifié par un alias unique, ce qui permet de suivre plus facilement l'origine de chaque donnée. Les flux de données sont automatiquement créés AWS IoT SiteWise lorsque les premières données de séries chronologiques sont reçues. Si les premières données de série chronologique sont identifiées par un alias, AWS IoT SiteWise crée un nouveau flux de données avec cet alias, à condition qu'aucune propriété d'actif ne soit déjà attribuée à cet alias. Sinon, si les premières données de série chronologique sont identifiées par un ID d'actif et un ID de propriété, un nouveau flux de données est AWS IoT SiteWise créé et associe ce flux de données à la propriété de l'actif.
Il existe deux manières d'attribuer un alias à une propriété d'actif. La méthode utilisée dépend du fait que les données sont envoyées au AWS IoT SiteWise premier ou qu'un actif est créé en premier.
+ Si les données sont envoyées au AWS IoT SiteWise premier, cela crée automatiquement un flux de données avec l'alias attribué. Lorsque la ressource est créée ultérieurement, utilisez l'[ AssociateTimeSeriesToAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateTimeSeriesToAssetProperty.html)API pour associer le flux de données et son alias à la propriété de la ressource.
+ Si un actif est créé en premier, utilisez l'[ UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html)API pour attribuer un alias à une propriété d'actif. Lorsque les données sont ensuite envoyées à AWS IoT SiteWise, le flux de données est automatiquement créé et associé à la propriété de l'actif.
Actuellement, vous pouvez uniquement associer des flux de données à des mesures. Les *mesures* sont un type de propriété d'actif qui représente les flux de données brutes des capteurs des appareils, tels que les valeurs de température horodatées ou les valeurs de rotations par minute (RPM) horodatées.
Lorsque ces mesures définissent des métriques ou des transformations, les données entrantes déclenchent des calculs spécifiques. Il est important de noter qu'une propriété d'actif ne peut être liée qu'à un seul flux de données à la fois.
AWS IoT SiteWise utilise `TimeSeries` la ressource Amazon Resource Name (ARN) pour déterminer vos frais de stockage. Pour plus d’informations, consultez [Tarification d’AWS IoT SiteWise](https://aws.amazon.com/iot-sitewise/pricing/).
Les sections suivantes expliquent comment utiliser la AWS IoT SiteWise console ou l'API pour gérer les flux de données.
**Topics**
+ [Configuration des autorisations et des paramètres](manage-data-streams-configuration.md)
+ [Associer un flux de données à une propriété d'actif](manage-data-streams-method.md)
+ [Dissocier un flux de données d'une propriété d'actif](disassociate-data-streams-method.md)
+ [Supprimer un flux de données](delete-data-streams-method.md)
+ [Mettre à jour un alias de propriété d'actif](update-data-streams-method.md)
+ [Scénarios courants](data-ingestion-scenarios.md)
# Configuration des autorisations et des paramètres
Les flux de données sont automatiquement créés AWS IoT SiteWise lorsque les premières données de séries chronologiques sont reçues. Si les données ingérées ne sont pas associées à une propriété d'actif, AWS IoT SiteWise crée un nouveau flux de données dissocié qui est configurable pour être associé à une propriété d'actif. Configurez le contrôle d'accès de la passerelle à laquelle les données sont envoyées AWS IoT SiteWise, en utilisant les politiques IAM pour spécifier le type de données à ingérer.
La politique IAM suivante désactive l'ingestion de données dissociée depuis la passerelle, tout en autorisant l'ingestion de données vers les flux de données associés à une propriété d'actif :
**Example Politique utilisateur IAM qui désactive l'ingestion de données dissociées depuis la passerelle**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowPutAssetPropertyValuesUsingAssetIdAndPropertyId",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:asset/*"
},
{
"Sid": "AllowPutAssetPropertyValuesUsingAliasWithAssociatedAssetProperty",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:time-series/*",
"Condition": {
"StringLikeIfExists": {
"iotsitewise:isAssociatedWithAssetProperty": "true"
}
}
},
{
"Sid": "DenyPutAssetPropertyValuesUsingAliasWithNoAssociatedAssetProperty",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:time-series/*",
"Condition": {
"StringLikeIfExists": {
"iotsitewise:isAssociatedWithAssetProperty": "false"
}
}
}
]
}
```
**Example Politique utilisateur IAM qui désactive toute ingestion de données depuis la passerelle**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DenyPutAssetPropertyValues",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": [
"arn:aws:iotsitewise:*:*:asset/*",
"arn:aws:iotsitewise:*:*:time-series/*"
]
}
]
}
```
# Associer un flux de données à une propriété d'actif
Gérez vos flux de données à l'aide du Console AWS IoT SiteWise ou AWS CLI.
------
#### [ Console ]
Utilisez la AWS IoT SiteWise console pour gérer vos flux de données.
**Pour gérer les flux de données (console)**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation, sélectionnez **Data streams**.
1. Choisissez un flux de données en filtrant sur l'alias du flux de données ou en sélectionnant **Flux de données dissociés** dans le menu déroulant du filtre.
1. Sélectionnez le flux de données à mettre à jour. Vous pouvez sélectionner plusieurs flux de données. Cliquez sur **Gérer les flux de données** en haut à droite.
1. Sélectionnez le flux de données à associer dans **Mettre à jour les associations de flux de données**, puis cliquez sur le bouton **Choisir une mesure**.
1. Dans la section **Choisir une mesure**, recherchez la propriété de mesure de l'actif correspondante. Sélectionnez la mesure, puis cliquez sur **Choisir**.
1. Effectuez les étapes 4 et 5 pour les autres flux de données sélectionnés à l'étape 3. Attribuez des propriétés d'actifs à tous les flux de données.
1. Choisissez **Mettre à jour** pour valider les modifications. Une bannière de confirmation de réussite s'affiche pour confirmer la mise à jour.
------
#### [ AWS CLI ]
Pour associer un flux de données (identifié par son alias) à une propriété d'actif (identifiée par son IDs), exécutez la commande suivante :
```
aws iotsitewise associate-time-series-to-asset-property \
--alias \
--assetId \
--propertyId
```
------
# Dissocier un flux de données d'une propriété d'actif
------
#### [ Console ]
Utilisez la AWS IoT SiteWise console pour dissocier votre flux de données d'une propriété d'actif.
**Pour dissocier les flux de données d'une propriété d'actif (console)**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation, sélectionnez **Data streams**.
1. Choisissez un flux de données en filtrant sur l'alias du flux de données ou en sélectionnant **Flux de données associés** dans le menu déroulant du filtre.
1. Sélectionnez le flux de données à dissocier. La colonne **Alias du flux de données** doit contenir un alias. Les colonnes **Nom** de la **ressource et Nom de la propriété** de la ressource doivent contenir les valeurs de la propriété de la ressource à laquelle le flux de données est associé. Vous pouvez sélectionner plusieurs flux de données.
1. Cliquez sur **Gérer les flux de données** en haut à droite.
1. Dans la section **Mettre à jour les associations de flux de données**, cliquez sur **X** dans la colonne **Nom de la mesure**. Un `submitted` statut doit apparaître dans la colonne **État**.
1. Choisissez **Mettre à jour** pour valider les modifications. Le flux de données est désormais dissocié de la propriété de l'actif, et l'alias est désormais utilisé pour identifier le flux de données.
------
#### [ AWS CLI ]
Pour dissocier un flux de données d'une propriété d'actif (identifiée par son `ID` s et son alias), exécutez la commande suivante :
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
Le flux de données est désormais dissocié de la propriété de l'actif, et l'alias est utilisé pour identifier le flux de données. L'alias n'est plus associé à la propriété de l'actif, car il est désormais associé au flux de données.
------
# Supprimer un flux de données
Lorsqu'une propriété est supprimée d'un modèle d'actifs, les AWS IoT SiteWise propriétés et leurs flux de données sont supprimés de tous les actifs gérés par le modèle d'actifs. Il supprime également toutes les propriétés et leurs flux de données d'un actif lorsque celui-ci est supprimé. Si les données d'un flux de données doivent être préservées, elles doivent être dissociées de la propriété de l'actif avant d'être supprimées.
**Avertissement**
Lorsqu'une propriété est supprimée d'un actif, le flux de données associé est également supprimé. Pour préserver le flux de données, dissociez-le d'abord de la propriété de l'actif, avant de supprimer la propriété du modèle d'actif ou de supprimer l'actif.
------
#### [ Console ]
Utilisez la AWS IoT SiteWise console pour dissocier votre flux de données d'une propriété d'actif.
**Pour supprimer un flux de données (console)**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation, sélectionnez **Data streams**.
1. Choisissez un flux de données en filtrant sur l'alias du flux de données.
1. Sélectionnez le flux de données à supprimer. Vous pouvez sélectionner plusieurs flux de données.
1. Cliquez sur le bouton **Supprimer** pour supprimer le flux de données.
------
#### [ AWS CLI ]
Utilisez l'[ DeleteTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteTimeSeries.html)API pour supprimer un flux de données spécifique, par son alias.
```
aws iotsitewise delete-time-series \
--alias
```
------
# Mettre à jour un alias de propriété d'actif
Les alias doivent être uniques au sein d'une AWS région. Cela inclut les alias des propriétés des actifs et des flux de données. N'attribuez pas d'alias à une propriété d'actif si une autre propriété ou un autre flux de données utilise cet alias.
------
#### [ Console ]
Utilisez la AWS IoT SiteWise console pour mettre à jour un alias de propriété d'actif.
**Pour mettre à jour un alias de propriété d'actif (console)**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le panneau de navigation, choisissez **Ressources**.
1. Sélectionnez l'actif dans le tableau.
1. Cliquez sur le bouton **Edit (Modifier)**.
1. Sélectionnez le **type de propriété** dans le tableau **Propriétés**.
1. Recherchez la propriété et saisissez le nouvel alias dans le champ de texte de l'alias de propriété.
1. Cliquez sur le bouton **Enregistrer** pour enregistrer les modifications.
------
#### [ AWS CLI ]
Pour mettre à jour un alias sur une propriété d'actif, exécutez la commande suivante :
```
aws iotsitewise update-asset-property \
--asset-id \
--property-id \
--property-alias \
--property-notification-state
```
**Note**
Si les notifications de propriétés sont actuellement activées, elles doivent être fournies à nouveau pour garantir qu'elles continuent de l'être.
------
# Scénarios courants
## Déplacer un flux de données
Pour modifier l'association d'un flux de données à une autre propriété d'actif, dissociez d'abord le flux de données de la propriété d'actif actuelle. Lorsque vous dissociez un flux de données d'une propriété d'actif, un alias doit être attribué à cette propriété d'actif.
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
Réattribuez maintenant le flux de données à la nouvelle propriété de l'actif.
```
aws iotsitewise associate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
## Erreur lors de l'attribution d'un alias à une propriété d'actif
Lorsque vous utilisez l'`UpdateAssetProperty`API pour attribuer un alias à une propriété, le message d'erreur suivant peut s'afficher :
```
Given alias for property with ID already in use by another property or data stream
```
Ce message d'erreur indique que l'alias n'est pas attribué à la propriété, car il est actuellement utilisé par une autre propriété ou un flux de données.
Cela se produit si les données sont ingérées AWS IoT SiteWise avec un alias. Lorsque des données sont envoyées avec un alias qui n'est pas utilisé par un autre flux de données ou une autre propriété d'actif, un nouveau flux de données est créé avec cet alias. Les deux options ci-dessous permettent de résoudre le problème.
+ Utilisez `AssociateTimeSeriesToAssetProperty` l'API pour associer le flux de données à son alias à la propriété de l'actif.
+ Arrêtez temporairement l'ingestion de données et supprimez le flux de données. Utilisez `UpdateAssetProperty` l'API pour attribuer l'alias à la propriété de l'actif, puis réactivez l'ingestion de données.
## Erreur lors de l'association d'un flux de données à une propriété d'actif
Lorsque vous associez un flux de données à une propriété d'actif, le message d'erreur suivant s'affiche.
```
assetProperty with assetId propertyId contains data
```
Ce message d'erreur indique que la propriété de l'actif est déjà associée à un flux de données contenant des données. Ce flux de données doit être dissocié ou supprimé avant d'associer un autre flux de données à cette propriété d'actif.
**Note**
Lors de la dissociation d'un flux de données d'une propriété d'actif, l'alias attribué à la propriété est attribué au flux de données. Pour que cet alias reste attribué à la propriété, attribuez-lui un nouvel alias avant de dissocier le flux de données.
Pour conserver les données stockées dans la propriété de l'actif, procédez comme suit :
+ Assurez-vous qu'aucune donnée n'est ingérée dans la propriété de l'actif, afin d'éviter la création d'un nouveau flux de données.
+ Utilisez `UpdateAssetProperty` l'API pour définir un nouvel alias attribué au flux de données actuellement attribué.
+ Utilisez `DisassociateTimeSeriesFromAssetProperty` l'API pour dissocier le flux de données actuel de la propriété de l'actif.
+ Utilisez `AssociateTimeSeriesToAssetProperty` l'API pour associer le flux de données souhaité à la propriété de l'actif.
Si les données stockées dans la propriété de l'actif doivent être supprimées, procédez comme suit :
+ Assurez-vous qu'aucune donnée n'est ingérée dans la propriété de l'actif, afin d'éviter la création d'un nouveau flux de données.
+ Utilisez `DeleteTimeSeries` l'API pour supprimer le flux de données actuellement attribué.
+ Utilisez `AssociateTimeSeriesToAssetProperty` l'API pour associer le flux de données souhaité à la propriété de l'actif.