diff --git a/.changes/next-release/feature-AWSIoTSiteWise-d79b215.json b/.changes/next-release/feature-AWSIoTSiteWise-d79b215.json new file mode 100644 index 000000000000..9ddd6436e5ac --- /dev/null +++ b/.changes/next-release/feature-AWSIoTSiteWise-d79b215.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "AWS IoT SiteWise", + "contributor": "", + "description": "My AWS Service (placeholder) - This release introduces custom Intervals and offset for tumbling window in metric for AWS IoT SiteWise." +} diff --git a/services/iotsitewise/src/main/resources/codegen-resources/service-2.json b/services/iotsitewise/src/main/resources/codegen-resources/service-2.json index 45bfb8436eb9..0076ba1d64bf 100644 --- a/services/iotsitewise/src/main/resources/codegen-resources/service-2.json +++ b/services/iotsitewise/src/main/resources/codegen-resources/service-2.json @@ -557,7 +557,7 @@ {"shape":"LimitExceededException"}, {"shape":"ConflictingOperationException"} ], - "documentation":"
Retrieves information about the storage configuration for IoT SiteWise.
Exporting data to Amazon S3 is currently in preview release and is subject to change. We recommend that you use this feature only with test data, and not in production environments.
Retrieves information about the storage configuration for IoT SiteWise.
", "endpoint":{"hostPrefix":"api."} }, "DisassociateAssets":{ @@ -890,7 +890,7 @@ {"shape":"LimitExceededException"}, {"shape":"ConflictingOperationException"} ], - "documentation":"Configures storage settings for IoT SiteWise.
Exporting data to Amazon S3 is currently in preview release and is subject to change. We recommend that you use this feature only with test data, and not in production environments.
Configures storage settings for IoT SiteWise.
", "endpoint":{"hostPrefix":"api."} }, "TagResource":{ @@ -4086,9 +4086,8 @@ }, "Interval":{ "type":"string", - "max":3, - "min":2, - "pattern":"1w|1d|1h|15m|5m|1m" + "max":23, + "min":2 }, "IntervalInSeconds":{ "type":"long", @@ -4704,6 +4703,11 @@ "min":1, "pattern":"[A-Za-z0-9+/=]+" }, + "Offset":{ + "type":"string", + "max":25, + "min":2 + }, "OffsetInNanos":{ "type":"integer", "max":999999999, @@ -5331,10 +5335,14 @@ "members":{ "interval":{ "shape":"Interval", - "documentation":"The time interval for the tumbling window. Note that w
represents weeks, d
represents days, h
represents hours, and m
represents minutes. IoT SiteWise computes the 1w
interval the end of Sunday at midnight each week (UTC), the 1d
interval at the end of each day at midnight (UTC), the 1h
interval at the end of each hour, and so on.
When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.
" + "documentation":"The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.
IoT SiteWise computes the 1w
interval the end of Sunday at midnight each week (UTC), the 1d
interval at the end of each day at midnight (UTC), the 1h
interval at the end of each hour, and so on.
When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.
" + }, + "offset":{ + "shape":"Offset", + "documentation":"The offset for the tumbling window. The offset
parameter accepts the following:
The offset time.
For example, if you specify 18h
for offset
and 1d
for interval
, IoT SiteWise aggregates data in one of the following ways:
If you create the metric before or at 6:00 p.m. (UTC), you get the first aggregation result at 6 p.m. (UTC) on the day when you create the metric.
If you create the metric after 6:00 p.m. (UTC), you get the first aggregation result at 6 p.m. (UTC) the next day.
The ISO 8601 format.
For example, if you specify PT18H
for offset
and 1d
for interval
, IoT SiteWise aggregates data in one of the following ways:
If you create the metric before or at 6:00 p.m. (UTC), you get the first aggregation result at 6 p.m. (UTC) on the day when you create the metric.
If you create the metric after 6:00 p.m. (UTC), you get the first aggregation result at 6 p.m. (UTC) the next day.
The 24-hour clock.
For example, if you specify 00:03:00
for offset
and 5m
for interval
, and you create the metric at 2 p.m. (UTC), you get the first aggregation result at 2:03 p.m. (UTC). You get the second aggregation result at 2:08 p.m. (UTC).
The offset time zone.
For example, if you specify 2021-07-23T18:00-08
for offset
and 1d
for interval
, IoT SiteWise aggregates data in one of the following ways:
If you create the metric before or at 6:00 p.m. (PST), you get the first aggregation result at 6 p.m. (PST) on the day when you create the metric.
If you create the metric after 6:00 p.m. (PST), you get the first aggregation result at 6 p.m. (PST) the next day.
Contains a tumbling window, which is a repeating fixed-sized, non-overlapping, and contiguous time interval. This window is used in metric and aggregation computations.
" + "documentation":"Contains a tumbling window, which is a repeating fixed-sized, non-overlapping, and contiguous time window. You use this window in metrics to aggregate data from properties and other assets.
You can use m
, h
, d
, and w
when you specify an interval or offset. Note that m
represents minutes, and w
represents weeks. You can also use s
to represent seconds in offset
.
The interval
and offset
parameters support the ISO 8601 format. For example, PT5S
represents five seconds, PT5M
represents five minutes, and PT5H
represents five hours.