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.

# Exemples de métadonnées d'exportation
<a name="bulk-operations-export-filter-examples"></a>

Lorsque vous exportez votre AWS IoT SiteWise contenu en masse vers Amazon S3, vous pouvez définir des *filtres* pour limiter les modèles d'actifs et les actifs spécifiques que vous souhaitez exporter. 

Vous spécifiez les filtres dans une `iotSiteWiseConfiguration` section de la `sources` section du corps de votre demande.

**Note**  
Vous pouvez inclure plusieurs filtres. L'opération groupée exportera tout modèle de ressource ou ressource correspondant à l'un des filtres.  
Si vous ne fournissez aucun filtre, l'opération exportera tous vos modèles et actifs d'actifs.

```
{
    "metadataTransferJobId": "your-transfer-job-id",
    "sources": [{
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
            "filters": [{
                list of filters
            }]
        }
    }],
    "destination": {
        "type": "s3",
        "s3Configuration": {
            "location": "arn:aws:s3:::amzn-s3-demo-bucket"
        }
    }
}
```



## Filtrer par modèle d'actif
<a name="bulk-export-filter-asset-model"></a>

Vous pouvez filtrer un modèle d'actif spécifique. Vous pouvez également inclure tous les actifs utilisant ce modèle, ou tous les modèles d'actifs au sein de sa hiérarchie. Vous ne pouvez pas inclure à la fois les actifs et la hiérarchie.

Pour plus d'informations sur les hiérarchies, consultez [Définir les hiérarchies des modèles d'actifs](define-asset-hierarchies.md).

------
#### [ Asset model ]

Ce filtre inclut le modèle d'actif spécifié :

```
"filterByAssetModel": {
    "assetModelId": "asset model ID"
}
```

------
#### [ Asset model and its assets ]

Ce filtre inclut le modèle d'actif spécifié, ainsi que tous les actifs utilisant ce modèle d'actif :

```
"filterByAssetModel": {
    "assetModelId": "asset model ID",
    "includeAssets": true
}
```

------
#### [ Asset model and its hierarchy ]

Ce filtre inclut le modèle d'actif spécifié, ainsi que tous les modèles d'actifs associés dans sa hiérarchie :

```
"filterByAssetModel": {
    "assetModelId": "asset model ID",
    "includeOffspring": true
}
```

------

## Filtrer par actif
<a name="bulk-export-filter-asset"></a>

Vous pouvez filtrer un actif spécifique. Vous pouvez également inclure son modèle d'actif ou tous les actifs associés dans sa hiérarchie. Vous ne pouvez pas inclure à la fois le modèle et la hiérarchie des actifs.

Pour plus d'informations sur les hiérarchies, consultez [Définir les hiérarchies des modèles d'actifs](define-asset-hierarchies.md).

------
#### [ Asset ]

Ce filtre inclut l'actif spécifié :

```
"filterByAsset": {
    "assetId": "asset ID"
}
```

------
#### [ Asset and its asset model ]

Ce filtre inclut l'actif spécifié, ainsi que le modèle d'actif qu'il utilise :

```
"filterByAsset": {
    "assetId": "asset ID",
    "includeAssetModel": true
}
```

------
#### [ Asset and its hierarchy ]

Ce filtre inclut l'actif spécifié, ainsi que tous les actifs associés dans sa hiérarchie :

```
"filterByAsset": {
    "assetId": "asset ID",
    "includeOffspring": true
}
```

------