Using the Amazon IoT SiteWise demo - Amazon IoT SiteWise
Creating the Amazon IoT SiteWise demoDeleting the Amazon IoT SiteWise demo
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Using the Amazon IoT SiteWise demo

You can easily explore Amazon IoT SiteWise by using the Amazon IoT SiteWise demo. Amazon IoT SiteWise provides the demo as an Amazon CloudFormation template that you can deploy to create asset models, assets, and a SiteWise Monitor portal, and generate sample data for up to a week.

Important

Once you create the demo, you will start being charged for the resources that this demo creates and consumes.

Creating the Amazon IoT SiteWise demo

You can create the Amazon IoT SiteWise demo from the Amazon IoT SiteWise console.

Note

The demo creates Lambda functions, one CloudWatch Events rule, and the Amazon Identity and Access Management (IAM) roles required for the demo. You might see these resources in your Amazon Web Services account. We recommend that you keep these resources until you're done with the demo. If you delete the resources, the demo might stop working correctly.

To create the demo in the Amazon IoT SiteWise console

  1. Navigate to the Amazon IoT SiteWise console and find the SiteWise demo in the upper-right corner of the page.

  2. (Optional) Under SiteWise demo, change the Days to keep demo assets field to specify how many days to keep the demo before deleting it.

  3. (Optional) To create a SiteWise Monitor portal to monitor sample data, do the following.

    Note

    You will be charged for the SiteWise Monitor resources that this demo creates and consumes. For more information, see SiteWise Monitor in the Amazon IoT SiteWise Pricing.

    1. Choose Monitor Resources.

    2. Choose Permission.

    3. Choose an existing IAM role that grants your federated IAM users access to the portal.

      Important

      Your IAM role must have the following permissions.

      {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iotsitewise:Describe*",
                "iotsitewise:List*",
                "iotsitewise:Get*",
                "cloudformation:DescribeStacks",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedRolePolicies",
                "sso:DescribeRegisteredRegions",
                "organizations:DescribeOrganization"
            ],
            "Resource": "*"
        }
    ]
}

    For more information about how to work with SiteWise Monitor, see What is Amazon IoT SiteWise Monitor? in the Amazon IoT SiteWise Monitor Application Guide.

  4. Choose Create demo.

    The demo takes around 3 minutes to create. If the demo fails to create, your account might have insufficient permissions. Switch to an account that has administrative permissions, or use the following steps to delete the demo and try again:

    1. Choose Delete demo.

      The demo takes around 15 minutes to delete.

    2. If the demo doesn't delete, open the Amazon CloudFormation console, choose the stack named IoTSiteWiseDemoAssets, and choose Delete in the upper-right corner.

    3. If the demo fails to delete again, follow the steps in the Amazon CloudFormation console to skip the resources that failed to delete, and try again.

  5. After the demo creates successfully, you can explore the demo assets and data in the Amazon IoT SiteWise console.

Deleting the Amazon IoT SiteWise demo

The Amazon IoT SiteWise demo deletes itself after a week, or the number of days you chose if you created the demo stack from the Amazon CloudFormation console. You can delete the demo before if you're 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.

To delete the Amazon IoT SiteWise demo

  1. Navigate to the Amazon CloudFormation console.

  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.

  4. In the confirmation dialog, choose Delete stack.

    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 Amazon CloudFormation console to skip the resources that failed to delete, and try again.