Amazon IoT FleetWise · JSON Structure

Iot Fleetwise S3 Config Structure

The Amazon S3 bucket where the Amazon Web Services IoT FleetWise campaign sends data. Amazon S3 is an object storage service that stores data as objects within buckets. For more information, see Creating, configuring, and working with Amazon S3 buckets in the Amazon Simple Storage Service User Guide.

Type: object Properties: 4 Required: 1
AutomotiveConnected VehiclesIoTTelematicsVehicle Data

S3Config is a JSON Structure definition published by Amazon IoT FleetWise, describing 4 properties, of which 1 is required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

bucketArn dataFormat storageCompressionFormat prefix

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-iot-fleetwise/refs/heads/main/json-structure/iot-fleetwise-s3-config-structure.json",
  "name": "S3Config",
  "description": "The Amazon S3 bucket where the Amazon Web Services IoT FleetWise campaign sends data. Amazon S3 is an object storage service that stores data as objects within buckets. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html\">Creating, configuring, and working with Amazon S3 buckets</a> in the <i>Amazon Simple Storage Service User Guide</i>.",
  "type": "object",
  "properties": {
    "bucketArn": {
      "allOf": [
        {
          "$ref": "#/components/schemas/S3BucketArn"
        },
        {
          "description": "The Amazon Resource Name (ARN) of the Amazon S3 bucket."
        }
      ]
    },
    "dataFormat": {
      "allOf": [
        {
          "$ref": "#/components/schemas/DataFormat"
        },
        {
          "description": "<p>Specify the format that files are saved in the Amazon S3 bucket. You can save files in an Apache Parquet or JSON format.</p> <ul> <li> <p>Parquet - Store data in a columnar storage file format. Parquet is optimal for fast data retrieval and can reduce costs. This option is selected by default.</p> </li> <li> <p>JSON - Store data in a standard text-based JSON file format.</p> </li> </ul>"
        }
      ]
    },
    "storageCompressionFormat": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StorageCompressionFormat"
        },
        {
          "description": "By default, stored data is compressed as a .gzip file. Compressed files have a reduced file size, which can optimize the cost of data storage."
        }
      ]
    },
    "prefix": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Prefix"
        },
        {
          "description": "<p>(Optional) Enter an S3 bucket prefix. The prefix is the string of characters after the bucket name and before the object name. You can use the prefix to organize data stored in Amazon S3 buckets. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html\">Organizing objects using prefixes</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <p>By default, Amazon Web Services IoT FleetWise sets the prefix <code>processed-data/year=YY/month=MM/date=DD/hour=HH/</code> (in UTC) to data it delivers to Amazon S3. You can enter a prefix to append it to this default prefix. For example, if you enter the prefix <code>vehicles</code>, the prefix will be <code>vehicles/processed-data/year=YY/month=MM/date=DD/hour=HH/</code>.</p>"
        }
      ]
    }
  },
  "required": [
    "bucketArn"
  ]
}