

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

# メタデータのエクスポート例
<a name="bulk-operations-export-filter-examples"></a>

Amazon S3 への AWS IoT SiteWise コンテンツの一括エクスポートを実行するときに、エクスポートする特定のアセットモデルとアセットを制限する*フィルター*を指定できます。

フィルターは、リクエスト本文の `sources` セクション内の `iotSiteWiseConfiguration` セクションで指定します。

**注記**  
複数のフィルターを含めることができます。一括オペレーションは、いずれかのフィルターに一致するアセットモデルまたはアセットをエクスポートします。  
フィルターを指定しなかった場合、オペレーションはすべてのアセットモデルとアセットをエクスポートします。

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



## アセットモデルでフィルタリングする
<a name="bulk-export-filter-asset-model"></a>

特定のアセットモデルをフィルタリングできます。そのモデルを使用するすべてのアセット、または階層内のすべてのアセットモデルを含めることもできます。アセットと階層の両方を含めることはできません。

階層の詳細については、「[アセットモデルの階層を定義する](define-asset-hierarchies.md)」を参照してください。

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

このフィルターには、指定されたアセットモデルが含まれます。

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

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

このフィルターには、指定されたアセットモデルとそのアセットモデルを使用するすべてのアセットが含まれます。

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

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

このフィルターには、指定されたアセットモデルと、階層内の関連するすべてのアセットモデルが含まれます。

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

------

## アセットでフィルタリングする
<a name="bulk-export-filter-asset"></a>

特定のアセットをフィルタリングできます。そのアセットモデル、または関連するすべてのアセットを階層に含めることもできます。アセットモデルと階層の両方を含めることはできません。

階層の詳細については、「[アセットモデルの階層を定義する](define-asset-hierarchies.md)」を参照してください。

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

このフィルターには、指定されたアセットが含まれます。

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

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

このフィルターには、指定したアセットと、それが使用するアセットモデルが含まれます。

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

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

このフィルターには、指定されたアセットと、階層内の関連するすべてのアセットが含まれます。

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

------