Amazon IoT TwinMaker · JSON Structure

Iot Twinmaker Get Property Value History Request Structure

GetPropertyValueHistoryRequest schema

Type: object Properties: 13 Required: 1
3D VisualizationDigital TwinIndustrial IoTIoT

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

Properties

entityId componentName componentTypeId selectedProperties propertyFilters startDateTime endDateTime interpolation nextToken maxResults orderByTime startTime endTime

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-twinmaker/refs/heads/main/json-structure/iot-twinmaker-get-property-value-history-request-structure.json",
  "name": "GetPropertyValueHistoryRequest",
  "description": "GetPropertyValueHistoryRequest schema",
  "type": "object",
  "properties": {
    "entityId": {
      "allOf": [
        {
          "$ref": "#/components/schemas/EntityId"
        },
        {
          "description": "The ID of the entity."
        }
      ]
    },
    "componentName": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Name"
        },
        {
          "description": "The name of the component."
        }
      ]
    },
    "componentTypeId": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ComponentTypeId"
        },
        {
          "description": "The ID of the component type."
        }
      ]
    },
    "selectedProperties": {
      "allOf": [
        {
          "$ref": "#/components/schemas/SelectedPropertyList"
        },
        {
          "description": "A list of properties whose value histories the request retrieves."
        }
      ]
    },
    "propertyFilters": {
      "allOf": [
        {
          "$ref": "#/components/schemas/PropertyFilters"
        },
        {
          "description": "A list of objects that filter the property value history request."
        }
      ]
    },
    "startDateTime": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Timestamp"
        },
        {
          "deprecated": true,
          "description": "The date and time of the earliest property value to return.This field is deprecated and will throw an error in the future. Use startTime instead."
        }
      ]
    },
    "endDateTime": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Timestamp"
        },
        {
          "deprecated": true,
          "description": "The date and time of the latest property value to return.This field is deprecated and will throw an error in the future. Use endTime instead."
        }
      ]
    },
    "interpolation": {
      "allOf": [
        {
          "$ref": "#/components/schemas/InterpolationParameters"
        },
        {
          "description": "An object that specifies the interpolation type and the interval over which to interpolate data."
        }
      ]
    },
    "nextToken": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NextToken"
        },
        {
          "description": "The string that specifies the next page of results."
        }
      ]
    },
    "maxResults": {
      "allOf": [
        {
          "$ref": "#/components/schemas/MaxResults"
        },
        {
          "description": "<p>The maximum number of results to return at one time. The default is 25.</p> <p>Valid Range: Minimum value of 1. Maximum value of 250.</p>"
        }
      ]
    },
    "orderByTime": {
      "allOf": [
        {
          "$ref": "#/components/schemas/OrderByTime"
        },
        {
          "description": "The time direction to use in the result order."
        }
      ]
    },
    "startTime": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Time"
        },
        {
          "description": "<p>The ISO8601 DateTime of the earliest property value to return.</p> <p>For more information about the ISO8601 DateTime format, see the data type <a href=\"https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_PropertyValue.html\">PropertyValue</a>.</p>"
        }
      ]
    },
    "endTime": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Time"
        },
        {
          "description": "<p>The ISO8601 DateTime of the latest property value to return.</p> <p>For more information about the ISO8601 DateTime format, see the data type <a href=\"https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_PropertyValue.html\">PropertyValue</a>.</p>"
        }
      ]
    }
  },
  "required": [
    "selectedProperties"
  ]
}