翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# でストレージ設定を構成する AWS IoT SiteWise
サービスマネージドウォーム階層ストレージにオプトインするように、またコールド階層にデータをレプリケートするように、ストレージ設定を構成できます。ウォーム階層とホット階層の保持期間の詳細については、「[データ保持の影響](#retention-period)」を参照してください。ストレージ設定を構成するときは、次の操作を行います。
+ **ホット階層の保持** — データが削除される前にホット階層に保存され、ストレージ設定に基づいてサービスマネージドウォーム階層ストレージまたはコールド階層ストレージに移動される期間、保持期間を設定します。 AWS IoT SiteWise は、保持期間が終了する前に存在していたホット階層内のデータをすべて削除します。保持期間を設定しなかった場合、データはホット階層に無期限に保存されます。
+ **ウォーム階層の保持** — AWS IoT SiteWise ストレージから削除されてカスタマー管理のコールド階層ストレージに移動する前に、ウォーム階層にデータを保存する期間を設定します。 は、保持期間が終了する前に存在していたウォーム階層からすべてのデータ AWS IoT SiteWise を削除します。保持期間が設定されていない場合、データはウォーム階層に無期限に保存されます。
**注記**
クエリのパフォーマンスを向上させるには、ウォーム階層ストレージとともにホット階層の保持期間を設定します。
## ホットおよびウォーム階層ストレージにおけるデータ保持の影響
+ ホット階層ストレージの保持期間を短縮すると、データはホット階層からウォーム階層またはコールド階層に完全に移動されます。ウォーム階層の保持期間を短くすると、データはコールド階層に移動され、ウォーム階層から完全に削除されます。
+ ホット階層またはウォーム階層ストレージの保持期間を長くすると、その変更によって AWS IoT SiteWise から に送信されるデータに影響します。 AWS IoT SiteWise は、ホット階層に入力するためにウォームストレージまたはコールドストレージからデータを取得しません。例えば、ホット階層ストレージの保持期間が最初に 30 日間に設定され、その後 60 日間に延長された場合、ホット階層ストレージに 60 日分のデータが含まれるまでに 30 日かかります。
**Topics**
+ [ホットおよびウォーム階層ストレージにおけるデータ保持の影響](#retention-period)
+ [ウォーム階層のストレージ設定を構成する (コンソール)](#configure-storage-console-warm)
+ [ウォーム階層のストレージ設定を構成する (AWS CLI)](#configure-storage-cli-warm)
+ [コールド階層のストレージ設定を構成する (コンソール)](#configure-storage-console)
+ [コールド階層のストレージ設定を構成する (AWS CLI)](#configure-storage-cli)
## ウォーム階層のストレージ設定を構成する (コンソール)
次の手順では、 AWS IoT SiteWise コンソールのウォーム階層にデータをレプリケートするようにストレージ設定を構成する方法を示します。
**コンソールでストレージの設定を設定するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで **[設定]** の **[ストレージ]** を選択します。
1. 右上隅の**[編集]** を選択します。
1. **[ストレージを編集]** ページで、次の作業を行います:
1. **[ホット階層設定]** では、以下を行います。
+ ホット階層のデータの保持期間 (この期間に達するとデータは削除される) を設定する場合は、**[保持期間を有効化]** を選択します。
+ 保持期間を設定するには、整数を入力して単位を選択します。保持期間は、30 日以上にする必要があります。
AWS IoT SiteWise は、保持期間より古いホット階層内のデータをすべて削除します。保持期間を設定しなかった場合、データは無期限に保存されます。
1. (推奨) **[ウォーム階層設定]** では、以下を実行します。
+ ウォーム階層ストレージにオプトインするには、**[ウォーム階層ストレージのオプトインを確認します]** を選択して、ウォーム階層ストレージにオプトインします。
+ (オプション) 保持期間を設定するには、整数を入力し、単位を選択します。保持期間は、365 日以上にする必要があります。
AWS IoT SiteWise は、保持期間より前に存在していたウォーム階層内のデータを削除します。保持期間を設定しなかった場合、データは無期限に保存されます。
**注記**
ウォーム階層にオプトインすると、設定は 1 回のみ表示されます。
ホット階層の保持を設定するには、ウォーム階層ストレージまたはコールド階層ストレージが必要です。コスト効率と履歴データの取得のために、 AWS IoT SiteWise では、長期データをウォーム階層に保存することをお勧めします。
ウォーム階層の保持を設定するには、コールド階層ストレージが必要です。
1. 設定を保存するには、**[保存]** を選択します。
**[AWS IoT SiteWise ストレージ]** セクションでは、**[ウォーム階層ストレージ]** は次のいずれかの状態です。
+ **[有効]** – ホット階層の保持期間より前にデータが存在している場合、 AWS IoT SiteWise はデータをウォーム階層に移動します。
+ **[無効]** – ウォーム階層ストレージは無効です。
## ウォーム階層のストレージ設定を構成する (AWS CLI)
AWS CLI および次のコマンドを使用して、ウォーム階層にデータを移動するようにストレージ設定を設定できます。
既存の設定が上書きされないように、次のコマンドを実行して、現在のストレージ設定情報を取得します。
```
aws iotsitewise describe-storage-configuration
```
**Example 既存のコールド階層設定のないレスポンス**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-10-14T15:53:35-07:00",
"warmTier": "DISABLED"
}
```
**Example 既存のコールド階層設定のあるレスポンス**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": retention-in-days
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2023-10-25T15:59:46-07:00",
"warmTier": "DISABLED"
}
```
### でウォーム階層のストレージ設定を構成する AWS CLI
ストレージ設定を構成するには、次のコマンドを実行します。を、 AWS IoT SiteWise ストレージ設定を含むファイルの名前`file-name`に置き換えます。
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise ホット階層とウォーム階層を使用した設定**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"warmTier": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
}
}
```
`hot-tier-retention-in-days` は 30 日以上の整数である必要があります。
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
コールド階層ストレージが有効になっている場合は、「[AWS CLI および既存のコールド階層を使用してストレージ設定を構成する](#configure-storage-cli-existing-cold)」を参照してください。
### AWS CLI および既存のコールド階層を使用してストレージ設定を構成する
**既存のコールド階層ストレージ AWS CLI で を使用してストレージ設定を構成する**
+ ストレージ設定を構成するには、次のコマンドを実行します。*file-name* を、 AWS IoT SiteWise ストレージの設定を含むファイルの名前に置き換えます。
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise ストレージ設定**
+ *amzn-s3-demo-bucket* をユーザーの Amazon S3 バケット名に置き換えます。
+ *[prefix]* (プレフィックス) は Amazon S3 のプレフィックスに置き換えてください。
+ *aws-account-id* を AWS アカウント ID に置き換えます。
+ *role-name* を、 が Amazon S3 にデータを送信 AWS IoT SiteWise することを許可する Amazon S3 アクセスロールの名前に置き換えます。
+ *hot-tier-retention-in-days* を、30 日以上の整数に置き換えます。
+ *warm-tier-retention-in-days* を、365 日以上の整数に置き換えます。
**注記**
AWS IoT SiteWise は、コールド階層の保持期間より古いウォーム階層のデータをすべて削除します。保持期間を設定しなかった場合、データは無期限に保存されます。
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
},
"warmTier": "ENABLED",
"warmTierRetentionPeriod": {
"numberOfDays": warm-tier-retention-in-days
}
}
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
## コールド階層のストレージ設定を構成する (コンソール)
次の手順では、 AWS IoT SiteWise コンソールでコールド階層にデータをレプリケートするようにストレージ設定を構成する方法を示します。
**コンソールでストレージの設定を設定するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで **[設定]** の **[ストレージ]** を選択します。
1. 右上隅の**[編集]** を選択します。
1. **[ストレージを編集]** ページで、次の作業を行います:
1. **[ストレージ設定]** で **[コールド階層ストレージを有効にする]** を選択します。デフォルトでは、コールド階層ストレージは無効です。
1. **S3 バケットの場所**には、既存の Amazon S3 バケット名とプレフィックスを入力します。
**注記**
Amazon S3 では、プレフィックスを Amazon S3 バケット内のフォルダ名として使用します。プレフィックスは1～255文字で、末尾はスラッシュ (/) とする。お客様の AWS IoT SiteWise データはこのフォルダーに保存されます。
Amazon S3 バケットがない場合は、**[表示]** () を選択し、Amazon S3 コンソールでバケットを作成します。詳細については、*Amazon S3 ユーザーガイド* の [最初の S3 バケットを作成する](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) を参照してください。
1. **S3 アクセスロール**の場合、次のいずれかを実行します。
+ ** AWS マネージドテンプレートからロールを作成する** を選択すると、 が Amazon S3 AWS IoT SiteWise にデータを送信できるようにする IAM ロール AWS が自動的に作成されます。 Amazon S3
+ **[既存のロールの使用]** を選択し、リストから作成したロールを選択します。
**注記**
**[S3 バケットの場所]** には、前のステップで使用したのと同じ Amazon S3 バケット名をIAM ポリシーで使用する必要があります。
次の例に示すようなアクセス許可をロールが持っていることを確認してください。
**Example アクセス許可ポリシー:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
amzn-s3-demo-bucket を、ユーザーの Amazon S3 バケットの名前に置き換えます。
Amazon S3 バケットがカスタマーマネージド KMS キーを使用して暗号化されている場合、KMS キーには `kms:Decrypt`および `kms:GenerateDataKey`オペレーションの IAM ロールを持つアクセスポリシーが必要です。
1. ホット階層を設定するには、「[ウォーム階層のストレージ設定を構成する (コンソール)](#configure-storage-console-warm)」の「ステップ 5」を参照してください。
1. (オプション) **[AWS IoT Analytics 統合]** では、以下を行います。
**注記**
サポート終了通知: 2025 年 12 月 15 日に、 AWS は のサポートを終了します AWS IoT Analytics。2025 年 12 月 15 日以降、 AWS IoT Analytics コンソールまたは AWS IoT Analytics リソースにアクセスできなくなります。詳細については、[AWS IoT Analytics 「サポート終了](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html)」を参照してください。
1. AWS IoT Analytics を使用してデータをクエリする場合は、**Enabled AWS IoT Analytics data store** を選択します。
1. AWS IoT SiteWise はデータストアの名前を生成するか、別の名前を入力できます。
AWS IoT SiteWise は、データを保存 AWS IoT Analytics するために にデータストアを自動的に作成します。データをクエリするには、 AWS IoT Analytics を使用してデータセットを作成できます。詳細については、[「 ユーザーガイド」の AWS IoT SiteWise 「データの使用](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html)」を参照してください。 *AWS IoT Analytics *
1. **[保存]** を選択します。
**[AWS IoT SiteWise ストレージ]** セクションの**[コールド階層ストレージ]**は、次のいずれかの値に設定できます。
+ **有効** – 指定した Amazon S3 バケットにデータを AWS IoT SiteWise レプリケートします。
+ **Enable** – AWS IoT SiteWise コールド階層ストレージを有効にするリクエストを処理しています。このプロセスは完了までに数分かかることがあります。
+ **Enable\$1Failed** – コールド階層ストレージを有効にするリクエストを処理 AWS IoT SiteWise できませんでした。 AWS IoT SiteWise が Amazon CloudWatch Logs にログを送信できるようにした場合、これらのログを使用して問題のトラブルシューティングを行うことができます。詳細については、「[Amazon CloudWatch Logs によるモニタリング](monitor-cloudwatch-logs.md)」を参照してください。
+ **[無効]** – コールド階層ストレージは無効です。
## コールド階層のストレージ設定を構成する (AWS CLI)
以下では、 AWS CLIを使用して、ストレージの設定でコールド階層にデータが複製されるようにする手順を示します。
**を使用してストレージ設定を構成するには AWS CLI**
1. アカウント内の Amazon S3 バケットにデータを書き出すには、次のコマンドを実行し、ストレージの設定を行ってください。*file-name* を、 AWS IoT SiteWise ストレージ設定を含むファイルの名前に置き換えます。
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise ストレージ設定**
+ *amzn-s3-demo-bucket* をユーザーの Amazon S3 バケット名に置き換えます。
+ *[prefix]* (プレフィックス) は Amazon S3 のプレフィックスに置き換えてください。
+ *aws-account-id* を AWS アカウント ID に置き換えます。
+ *role-name* を、 が Amazon S3 にデータを送信 AWS IoT SiteWise することを許可する Amazon S3 アクセスロールの名前に置き換えます。
+ *retention-in-days* は、30 日以上の整数に置き換えます。
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"retentionPeriod": {
"numberOfDays": retention-in-days,
"unlimited": false
}
}
```
**注記**
AWS IoT SiteWise ストレージ設定と IAM ポリシーでは、同じ Amazon S3 バケット名を使用する必要があります。
次の例に示すようなアクセス許可をロールが持っていることを確認してください。
**Example アクセス許可ポリシー:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
amzn-s3-demo-bucket を、ユーザーの Amazon S3 バケットの名前に置き換えます。
Amazon S3 バケットがカスタマーマネージド KMS キーを使用して暗号化されている場合、KMS キーには `kms:Decrypt`および `kms:GenerateDataKey`オペレーションの IAM ロールを持つアクセスポリシーが必要です。
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
**注記**
がストレージ設定を更新する AWS IoT SiteWise までに数分かかる場合があります。
1. ストレージの設定情報を取得するには、次のコマンドを実行します。
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/torque/",
"roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
}
},
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:54:14-07:00"
}
```
1. Amazon S3 バケットへのデータ書き出しを停止するには、次のコマンドを実行してストレージの設定を行ってください。
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
**注記**
デフォルトでは、データは のホット階層にのみ保存されます AWS IoT SiteWise。
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
1. ストレージの設定情報を取得するには、次のコマンドを実行します。
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:57:14-07:00"
}
```
### (オプション) AWS IoT Analytics データストアを作成する (AWS CLI)
**注記**
サポート終了通知: 2025 年 12 月 15 日に、 AWS は のサポートを終了します AWS IoT Analytics。2025 年 12 月 15 日以降、 AWS IoT Analytics コンソールまたは AWS IoT Analytics リソースにアクセスできなくなります。詳細については、[AWS IoT Analytics 「サポート終了](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html)」を参照してください。
AWS IoT Analytics データストアは、データを受信して保存するスケーラブルでクエリ可能なリポジトリです。 AWS IoT SiteWise コンソールまたは AWS IoT Analytics APIs を使用して、 AWS IoT Analytics データを保存するための AWS IoT SiteWise データストアを作成できます。データをクエリするには、 を使用してデータセットを作成します AWS IoT Analytics。詳細については、 *AWS IoT Analytics ユーザーガイド*の「[AWS IoT SiteWise データの使用](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html)」を参照してください。
次の手順では AWS CLI 、 を使用して にデータストアを作成します AWS IoT Analytics。
データストアを作成するには、次のコマンドを実行します。*file-name* は、データストアの設定を含むファイルの名前に置き換えてください。
```
aws iotanalytics create-datastore --cli-input-json file://file-name.json
```
**注記**
既存の Amazon S3 バケット名を指定する必要があります。 Amazon S3 バケットを持っていない場合は、まずバケットを作成します。詳細については、*Amazon S3 ユーザーガイド* の [最初の S3 バケットを作成する](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) を参照してください。
AWS IoT SiteWise ストレージ設定、IAM ポリシー、 AWS IoT Analytics データストア設定では、同じ Amazon S3 バケット名を使用する必要があります。
**Example AWS IoT Analytics データストアの設定**
*data-store-name* と *amzn-s3-demo-bucket* を AWS IoT Analytics データストア名と Amazon S3 バケット名に置き換えます。
```
{
"datastoreName": "data-store-name",
"datastoreStorage": {
"iotSiteWiseMultiLayerStorage": {
"customerManagedS3Storage": {
"bucket": "amzn-s3-demo-bucket"
}
}
},
"retentionPeriod": {
"numberOfDays": 90
}
}
```
**Example response**
```
{
"datastoreName": "datastore_IoTSiteWise_demo",
"datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
"retentionPeriod": {
"numberOfDays": 90,
"unlimited": false
}
}
```