AWS iot-sitewise documentation change
Summary
Updated documentation structure, clarified prerequisites, added resource cleanup guidance, and included additional resource links
Security assessment
Changes focus on documentation organization, demo resource management, and supplementary material links. No evidence of addressing vulnerabilities or security weaknesses. IAM references remain unchanged except for acronym expansion.
Diff
diff --git a/iot-sitewise/latest/userguide/publish-to-amazon-dynamodb.md b/iot-sitewise/latest/userguide/publish-to-amazon-dynamodb.md index 8e3bc7543..0c3124864 100644 --- a//iot-sitewise/latest/userguide/publish-to-amazon-dynamodb.md +++ b//iot-sitewise/latest/userguide/publish-to-amazon-dynamodb.md @@ -5 +5 @@ -PrerequisitesStep 1: Configure AWS IoT SiteWise to publish property value updatesStep 2: Create a rule in AWS IoT CoreStep 3: Configure the DynamoDB rule actionStep 4: Explore data in DynamoDBStep 5: Clean up resources after the tutorial +PrerequisitesStep 1: Configure AWS IoT SiteWise to publish property value updatesStep 2: Create a rule in AWS IoT CoreStep 3: Configure the DynamoDB rule actionStep 4: Explore data in DynamoDBClean up resourcesAdditional resources @@ -25 +25,3 @@ In this tutorial, you build on the AWS IoT SiteWise demo that provides a sample - * Step 5: Clean up resources after the tutorial + * Clean up resources + + * Additional resources @@ -38 +40,6 @@ To complete this tutorial, you need the following: - * An IAM user with administrator permissions. For detailed instructions, see [How AWS IoT SiteWise works with IAM](./security_iam_service-with-iam.html). + * An AWS Identity and Access Management (IAM) user with administrator permissions. For detailed instructions, see [How AWS IoT SiteWise works with IAM](./security_iam_service-with-iam.html). + + * A running AWS IoT SiteWise demo. For more information, see [Use the AWS IoT SiteWise demo](./getting-started-demo.html). + + + @@ -40 +47 @@ To complete this tutorial, you need the following: - * A running AWS IoT SiteWise wind farm demo. When you set up the demo, it defines models and assets in AWS IoT SiteWise and streams data to them to represent a wind farm. For more information, see [Use the AWS IoT SiteWise demo](./getting-started-demo.html). +###### Note @@ -41,0 +49 @@ To complete this tutorial, you need the following: +This tutorial requires the use of resources created in the [Use the AWS IoT SiteWise demo](./getting-started-demo.html). You must complete it before proceeding with this tutorial. @@ -42,0 +51 @@ To complete this tutorial, you need the following: +###### Important @@ -43,0 +53 @@ To complete this tutorial, you need the following: +Keep all demo resources until you complete this tutorial. Deleting any components might disrupt the demo's functionality and affect your ability to complete the tutorial. @@ -178 +188 @@ In this step, explore the demo assets' wind speed data in your new Amazon Dynamo -Now that you have completed the tutorial, disable or delete the rule and delete your DynamoDB table to avoid incurring additional charges. To clean up your resources, see Step 5: Clean up resources after the tutorial. +Now that you have completed the tutorial, you can disable or delete the rule and delete your DynamoDB table to avoid incurring additional charges. To clean up your resources, see Clean up resources. @@ -180 +190 @@ Now that you have completed the tutorial, disable or delete the rule and delete -## Step 5: Clean up resources after the tutorial +You can also learn how to create custom applications to consume and visualize this data. For a guided tutorial on visualizing AWS IoT SiteWise data, see [Visualize and share data in Grafana](./visualize-with-grafana.html). @@ -182 +192 @@ Now that you have completed the tutorial, disable or delete the rule and delete -After you complete the tutorial, clean up your resources to avoid incurring additional charges. Your demo wind farm assets are deleted at the end of the duration that you chose when you created the demo. You can also delete the demo manually. +## Clean up resources @@ -184 +194 @@ After you complete the tutorial, clean up your resources to avoid incurring addi -The AWS IoT SiteWise demo deletes itself after a week, or the number of days you chose if you created the demo stack from the AWS CloudFormation console. You can delete the demo before if you are done using the demo resources. You can also delete the demo if the demo fails to create. Use the following steps to delete the demo manually. +After you complete the tutorial, clean up your resources to avoid incurring additional charges. @@ -186 +196 @@ The AWS IoT SiteWise demo deletes itself after a week, or the number of days you -**(optional) To delete the AWS IoT SiteWise demo** +**To delete the AWS IoT SiteWise demo** @@ -188,7 +198 @@ The AWS IoT SiteWise demo deletes itself after a week, or the number of days you - 1. Navigate to the [AWS CloudFormation console](https://console.aws.amazon.com/cloudformation). - - 2. Choose **IoTSiteWiseDemoAssets** from the list of Stacks. - - 3. Choose **Delete**. - -When you delete the stack, all of the resources created for the demo are deleted. + 1. Navigate to the [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/). @@ -196 +200 @@ When you delete the stack, all of the resources created for the demo are deleted - 4. In the confirmation dialog, choose **Delete stack**. + 2. In the upper-right corner of the page, choose **Delete demo**. @@ -198 +202 @@ When you delete the stack, all of the resources created for the demo are deleted -The stack takes around 15 minutes to delete. If the demo fails to delete, choose Delete in the upper-right corner again. If the demo fails to delete again, follow the steps in the AWS CloudFormation console to skip the resources that failed to delete, and try again. + 3. In the confirmation dialog, enter `DELETE` and then choose **Delete**. @@ -253,0 +258,15 @@ Use the following procedures to disable property value update notifications (if +## Additional resources + +For more information about working with DynamoDB and monitoring your data, see the following resources: + + * [Monitoring metrics in with CloudWatch ](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) in the _DynamoDB Developer Guide_ + + * [Best practices for designing and using partition keys effectively in ](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) in the _DynamoDB Developer Guide_ + + * [Rules for AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) in the _AWS IoT Developer Guide_ + + * [Visualize and share data in Grafana](./visualize-with-grafana.html) + + + +