How to create my workspace in AWS IoT TwinMaker? - johnnyw-aws/aws-iot-twinmaker-samples GitHub Wiki

This article will serve as your starting point to effectively utilize AWS IoT TwinMaker's capabilities from creating AWS IoT TwinMaker workspace.

Prerequisites

To work with AWS IoT TwinMaker in this tutorial, you will need the following prerequisite:

  1. An AWS Account and the necessary permissions to use AWS IoT TwinMaker. If you already have an AWS IoT TwinMaker set up, you can proceed to the next section. Otherwise, follow the instructions to set up an account and configure authentication. The instructions will guide you through the necessary steps to ensure successful completion.

Goals

"We want to start using TwinMaker."

Your AWS Iot TwinMaker journey will start from creating a workspace. A workspace is a top-level container for your digital twin application. You create a logical set of entities, components, scene assets, and other resources for your digital twin inside this workspace. It also serves as a security boundary to manage access to the digital twin application and the resources it contains. Each workspace is linked to the Amazon S3 bucket where your workspace data is stored. You use IAM roles to restrict access to your workspace.

A workspace can contain multiple components, entities, scenes and resources. A component type, entity, scene or resource exists only within one workspace.

For more information about AWS IoT TwinMaker and the workspace concept, see TwinMaker instruction.

How to create workspace

Option 1: If you have not done so already, you can choose to follow the instructions provided in CookieFactoryV2. Once you have completed the instructions, a AWS IoT TwinMaker workspace will be created during the process.

Option 2: Alternatively, you have the option to follow the AWS User Guide titled "Create a workspace" to create your AWS IoT TwinMaker workspace.

Clean up

CookieFactory V2 clean up instructions

You can clean up CookieFactoryV2 resources by following the clean up instructions provided in CookieFactoryV2.

AWS Console

  1. Log into AWS IoT TwinMaker Console, with your AWS account.
  2. On left side panel, select Workspaces.
  3. Select the workspace you created.
  4. Ensure all the resources inside of the workspace removed.
  5. Press the Delete button.
  6. In pop-up field, confirm deletion by typing in Delete.

AWS CLI

You can run the delete-workspace CLI command to remove a workspace. In your terminal run the following command:

delete-workspace --workspace-id <YourWorkspaceId>

Replace <YourWorkspaceId> with your workspace Id.