How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amazon IoT SiteWise Properties API

The Properties API from Amazon IoT SiteWise — 8 operation(s) for properties.

Amazon IoT SiteWise Properties API is one of 16 APIs that Amazon IoT SiteWise publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Properties. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and pricing.

This API exposes 8 operations across 8 paths, and defines 79 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: http://iotsitewise.{region}.amazonaws.com, https://iotsitewise.{region}.amazonaws.com, http://iotsitewise.{region}.amazonaws.com.cn, https://iotsitewise.{region}.amazonaws.com.cn.

8 operations 8 paths 79 schemas 4 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://iotsitewise.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Amazon IoT SiteWise Properties API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 4 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Properties 8
POST
/properties/batch/aggregates
Amazon IoT SiteWise Batch Get Asset Property Aggregates
BatchGetAssetPropertyAggregates 9 params body → 200480481482483
POST
/properties/batch/latest
Amazon IoT SiteWise Batch Get Asset Property Value
BatchGetAssetPropertyValue 8 params body → 200480481482483
POST
/properties/batch/history
Amazon IoT SiteWise Batch Get Asset Property Value History
BatchGetAssetPropertyValueHistory 9 params body → 200480481482483
POST
/properties
Amazon IoT SiteWise Batch Put Asset Property Value
BatchPutAssetPropertyValue 7 params body → 200480481482483484485486
GET
/properties/aggregates#aggregateTypes&resolution&startDate&endDate
Amazon IoT SiteWise Get Asset Property Aggregates
GetAssetPropertyAggregates 18 params → 200480481482483484
GET
/properties/latest
Amazon IoT SiteWise Get Asset Property Value
GetAssetPropertyValue 10 params → 200480481482483484
GET
/properties/history
Amazon IoT SiteWise Get Asset Property Value History
GetAssetPropertyValueHistory 16 params → 200480481482483484
GET
/properties/interpolated#startTimeInSeconds&endTimeInSeconds&quality&intervalInSeconds&type
Amazon IoT SiteWise Get Interpolated Asset Property Values
GetInterpolatedAssetPropertyValues 20 params → 200480481482483484

Schemas 79

The contract defines 79 schemas that model the data the API accepts and returns. The most detailed are BatchGetAssetPropertyAggregatesEntry (10 properties), BatchGetAssetPropertyValueHistoryEntry (8 properties), Aggregates (6 properties), PutAssetPropertyValueEntry (5 properties). Each schema is shown below with its type and property counts.

AssetPropertyValueHistory
array
BatchGetAssetPropertyValueSkippedEntry
object
Contains information for an entry that has been processed by the previous BatchGetAssetPropertyValue request.
3 properties 2 required
BatchPutAssetPropertyErrors
array
BatchGetAssetPropertyAggregatesSkippedEntries
array
PropertyValueStringValue
string
InternalFailureException
AggregateType
string
BatchGetAssetPropertyValueHistoryEntry
object
Contains information for an asset property historical value entry that is associated with the BatchGetAssetPropertyValueHistory API. To identify an asset prope…
8 properties 1 required
AggregateTypes
array
BatchGetAssetPropertyAggregatesResponse
object
4 properties 3 required
ResourceNotFoundException
ID
string
ThrottlingException
Aggregates
object
Contains the (pre-calculated) aggregate values for an asset property.
6 properties
Variant
object
Contains an asset property value (of a single type only).
4 properties
BatchGetAssetPropertyAggregatesSkippedEntry
object
Contains information for an entry that has been processed by the previous BatchGetAssetPropertyAggregates request.
3 properties 2 required
BatchPutAssetPropertyError
object
Contains error information from updating a batch of asset property values.
3 properties 3 required
InterpolatedAssetPropertyValues
array
BatchGetAssetPropertyValueHistoryResponse
object
4 properties 3 required
BatchGetAssetPropertyValueErrorCode
string
InterpolatedAssetPropertyValue
object
Contains information about an interpolated asset property value.
2 properties 2 required
AggregatedValues
array
BatchGetAssetPropertyAggregatesErrorInfo
object
Contains the error code and the timestamp for an asset property aggregate entry that is associated with the BatchGetAssetPropertyAggregates API.
2 properties 2 required
AssetPropertyValue
object
Contains asset property value information.
3 properties 2 required
Timestamp
string
BatchGetAssetPropertyAggregatesEntry
object
Contains information for an asset property aggregate entry that is associated with the BatchGetAssetPropertyAggregates API. To identify an asset property, you…
10 properties 5 required
BatchGetAssetPropertyValueHistorySuccessEntry
object
Contains success information for an entry that is associated with the BatchGetAssetPropertyValueHistory API.
2 properties 2 required
GetInterpolatedAssetPropertyValuesResponse
object
2 properties 1 required
BatchGetAssetPropertyValueSuccessEntries
array
AssetPropertyAlias
string
Qualities
array
TimeOrdering
string
BatchGetAssetPropertyValueHistoryErrorCode
string
Resolution
string
BatchGetAssetPropertyAggregatesErrorEntries
array
PropertyValueIntegerValue
integer
InvalidRequestException
TimeInSeconds
integer
OffsetInNanos
integer
LimitExceededException
BatchGetAssetPropertyValueHistorySkippedEntries
array
GetAssetPropertyValueResponse
object
1 property
Timestamps
array
NextToken
string
GetAssetPropertyAggregatesResponse
object
2 properties 1 required
BatchGetAssetPropertyValueHistoryErrorInfo
object
The error information, such as the error code and the timestamp.
2 properties 2 required
EntryId
string
PropertyValueDoubleValue
number
BatchGetAssetPropertyValueEntry
object
Contains information for an asset property value entry that is associated with the BatchGetAssetPropertyValue API. To identify an asset property, you must spec…
4 properties 1 required
BatchEntryCompletionStatus
string
BatchPutAssetPropertyErrorEntry
object
Contains error information for asset property value entries that are associated with the BatchPutAssetPropertyValue API.
2 properties 2 required
AggregatedDoubleValue
number
AssetPropertyValues
array
Quality
string
PutAssetPropertyValueEntry
object
Contains a list of value updates for an asset property in the list of asset entries consumed by the BatchPutAssetPropertyValue API operation.
5 properties 2 required
BatchGetAssetPropertyValueErrorEntry
object
Contains error information for an asset property value entry that is associated with the BatchGetAssetPropertyValue API.
3 properties 3 required
BatchGetAssetPropertyAggregatesErrorEntry
object
Contains error information for an asset property aggregate entry that is associated with the BatchGetAssetPropertyAggregates API.
3 properties 3 required
BatchGetAssetPropertyAggregatesErrorCode
string
ErrorMessage
string
BatchGetAssetPropertyValueHistoryErrorEntry
object
A list of the errors (if any) associated with the batch request. Each error entry contains the entryId of the entry that failed.
3 properties 3 required
ServiceUnavailableException
BatchPutAssetPropertyValueResponse
object
1 property 1 required
BatchGetAssetPropertyValueResponse
object
4 properties 3 required
BatchPutAssetPropertyValueErrorCode
string
TimeInNanos
object
Contains a timestamp with optional nanosecond granularity.
2 properties 1 required
BatchPutAssetPropertyErrorEntries
array
BatchGetAssetPropertyValueErrorInfo
object
The error information, such as the error code and the timestamp.
2 properties 2 required
BatchGetAssetPropertyValueSkippedEntries
array
BatchGetAssetPropertyValueSuccessEntry
object
Contains success information for an entry that is associated with the BatchGetAssetPropertyValue API.
2 properties 1 required
PropertyValueBooleanValue
boolean
AggregatedValue
object
Contains aggregated asset property values (for example, average, minimum, and maximum).
3 properties 2 required
BatchGetAssetPropertyValueHistoryErrorEntries
array
ConflictingOperationException
BatchGetAssetPropertyAggregatesSuccessEntries
array
BatchGetAssetPropertyValueErrorEntries
array
BatchGetAssetPropertyAggregatesSuccessEntry
object
Contains success information for an entry that is associated with the BatchGetAssetPropertyAggregates API.
2 properties 2 required
GetAssetPropertyValueHistoryResponse
object
2 properties 1 required
BatchGetAssetPropertyValueHistorySkippedEntry
object
Contains information for an entry that has been processed by the previous BatchGetAssetPropertyValueHistory request.
3 properties 2 required
BatchGetAssetPropertyValueHistorySuccessEntries
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amazon-iot-sitewise-properties-api-openapi.yml Raw ↑

Other APIs Amazon IoT SiteWise publishes across the network.

Amazon IoT SiteWise Access Policies API
Amazon IoT SiteWise Asset Models API
Amazon IoT SiteWise Assets API
Amazon IoT SiteWise Configuration API
Amazon IoT SiteWise Dashboards API
Amazon IoT SiteWise Dashboards#projectId API
Amazon IoT SiteWise Gateways API
Amazon IoT SiteWise Jobs API
Amazon IoT SiteWise Logging API
Amazon IoT SiteWise Portals API
Amazon IoT SiteWise Projects API
Amazon IoT SiteWise Projects#portalId API
Where this information came from

This is an independent, third-party profile of Amazon IoT SiteWise Properties API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.