

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Esporta esempi di metadati
<a name="bulk-operations-export-filter-examples"></a>

Quando esegui un'esportazione in blocco dei tuoi AWS IoT SiteWise contenuti su Amazon S3, puoi *specificare* filtri per limitare i modelli e gli asset specifici che desideri esportare. 

Specificate i filtri in una `iotSiteWiseConfiguration` sezione all'interno della `sources` sezione del corpo della richiesta.

**Nota**  
Puoi includere più filtri. L'operazione in blocco esporterà qualsiasi modello di asset o risorsa che corrisponde a uno qualsiasi dei filtri.  
Se non fornite alcun filtro, l'operazione esporterà tutti i modelli e gli asset degli asset.

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



## Filtra per modello di asset
<a name="bulk-export-filter-asset-model"></a>

Puoi filtrare un modello di asset specifico. Puoi anche includere tutti gli asset che utilizzano quel modello o tutti i modelli di asset all'interno della sua gerarchia. Non puoi includere sia gli asset che la gerarchia.

Per ulteriori informazioni sulle gerarchie, consultare [Definite le gerarchie dei modelli di asset](define-asset-hierarchies.md).

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

Questo filtro include il modello di asset specificato:

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

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

Questo filtro include il modello di asset specificato, insieme a tutti gli asset che utilizzano quel modello di asset:

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

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

Questo filtro include il modello di asset specificato, insieme a tutti i modelli di asset associati nella sua gerarchia:

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

------

## Filtra per risorsa
<a name="bulk-export-filter-asset"></a>

Puoi filtrare una risorsa specifica. Puoi anche includere il suo modello di asset o tutte le risorse associate all'interno della sua gerarchia. Non è possibile includere sia il modello di asset che la gerarchia.

Per ulteriori informazioni sulle gerarchie, consultare [Definite le gerarchie dei modelli di asset](define-asset-hierarchies.md).

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

Questo filtro include la risorsa specificata:

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

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

Questo filtro include l'asset specificato, insieme al modello di asset che utilizza:

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

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

Questo filtro include la risorsa specificata, insieme a tutte le risorse associate nella sua gerarchia:

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

------