ウォームティア (AWS CLI) のストレージ設定を行います。

AWS CLI および次のコマンドを使用して、データをウォームティアに移動するようにストレージ設定を構成できます。

既存の構成が上書きされないようにするには、以下のコマンドを実行して現在のストレージ構成情報を取得します。

aws iotsitewise describe-storage-configuration

例 コールドティア構成が存在しない場合の応答

{
          "storageType": "SITEWISE_DEFAULT_STORAGE",
          "disassociatedDataStorage": "ENABLED",
          "configurationStatus": {
              "state": "ACTIVE"
          },
          "lastUpdateDate": "2021-10-14T15:53:35-07:00",
          "warmTier": "DISABLED"
}

例 既存のコールドティア構成での応答

{             
      "storageType": "MULTI_LAYER_STORAGE",
          "multiLayerStorage": {
            "customerManagedS3Storage": {
            "s3ResourceArn": "arn:aws:s3:::bucket-name/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

例 AWS IoT SiteWise ホットティアとウォームティアによる設定

{
             "storageType": "SITEWISE_DEFAULT_STORAGE",
             "disassociatedDataStorage": "ENABLED",
             "warmTier": "ENABLED",
             "retentionPeriod": {
                "numberOfDays": hot-tier-retention-in-days
              } 
              
}

hot-tier-retention-in-days30 日以上の整数でなければなりません。

例 レスポンス

{
             "storageType": "SITEWISE_DEFAULT_STORAGE",
             "configurationStatus": {
             "state": "UPDATE_IN_PROGRESS"
             }
}

コールド階層ストレージを有効にしている場合は、を参照してくださいAWS CLI 既存のコールドティアを使用してストレージ設定を行います。。

AWS CLI 既存のコールドティアを使用してストレージ設定を行います。

AWS CLI 既存のコールドティアストレージを使用してストレージ設定を行います。

• 以下のコマンドを実行してストレージ設定を構成します。file-name は、 AWS IoT SiteWise ストレージの設定を含むファイルの名前に置き換えてください。

  aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json

  例 AWS IoT SiteWise ストレージ設定

  • bucket-name は Amazon S3 バケット名に置き換えます。

  • [prefix] (プレフィックス) は Amazon S3 のプレフィックスに置き換えてください。

  • AWS アカウント ID aws-account-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:::bucket-name/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
      }
  }

  例 レスポンス

  {
        "storageType": "MULTI_LAYER_STORAGE",
        "configurationStatus": {
          "state": "UPDATE_IN_PROGRESS"
         }
  }