Getting Started

Exercise 1 - Get familiar with QuickSight CLI

  1. In Cloud9 terminal, type/copy in following command. Hit enter/return key to submit.
aws quicksight help
  1. Use space key / up down arrow keys / mouse to scroll the list of available commands.
  2. Press q to exit back to terminal prompt.
  3. Now, lets see how to get help on a specific command. Let’s try this with describe-user command.
aws quicksight describe-user help
  1. As before, use space key / up down arrow keys / mouse to scroll and q to exit back to prompt.
AdminWorkshop-GettingStarted-Exercise

Exercise 2 - Run describe-user

When you ran the RunMeFirst.sh script in Cloud9 during initial setup, the output told you which Identity region is being used by your QuickSight account. Identity region is where QuickSight manages users and groups. It needn’t be same as the region you select during QuickSight setup. QuickSight picks the most well connected region, that is closest to the region you selected during setup, to manage users and groups. We surfaced that info by running a describe-user command and parsing out the region from the user’s arn or error message if it was run in a different region. Let’s run this by hand to get familiar with QuickSight commands.

  1. Execute the following command from terminal.
aws quicksight describe-user --aws-account-id $AAI --namespace default --user-name $UN --region $IR

Note - We had set the value for variables AAI, UN, EML and IR from the RunMeFirst.sh script. Namespaces are containers that hold users and groups. It is used to implement multi tenancy. Initially, QuickSight is setup with a default namespace and that is where the admin user got created when we setup QuickSight. We will explore namespaces further in later section.

  1. Optional step - Run following command and cross check the value of variable IR against the region in user arn (they should match as we extracted it from this arn earlier)
echo $IR
AdminWorkshop-GettingStarted-Exercise