Create the Amazon resources - Amazon SDK for JavaScript
Create the Amazon resources using the Amazon CloudFormationCreate the Amazon resources using the Amazon Web Services Management Console;
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).

The Amazon SDK for JavaScript V3 API Reference Guide describes in detail all the API operations for the Amazon SDK for JavaScript version 3 (V3).

Create the Amazon resources

This topic is part of a example that demonstrates how to capture and process browser event data with Amazon Kinesis. To start at the beginning of the example, see Capturing Webpage Scroll Progress with Amazon Kinesis.

This example requires the following resources.

  • An Amazon Kinesis stream.

  • An Amazon Cognito identity pool with access enabled for unauthenticated identities.

  • An Amazon Identity and Access Management role whose policy grants permission to submit data to an Amazon Kinesis stream.

You can create these resources manually, but we recommend provisioning these resources using the Amazon CloudFormation as described in this topic.

Create the Amazon resources using the Amazon CloudFormation

To create the resources using the Amazon CloudFormation:

Amazon CloudFormation enables you to create and provision Amazon infrastructure deployments predictably and repeatedly. For more information about Amazon CloudFormation, see the Amazon CloudFormation User Guide.

  1. Install and configure the Amazon CloudFormation following the instructions in the Amazon CLI User Guide.

  2. Create a file named setup.yaml in the root directory of your project folder, and copy the content here on GitHub into it.

    Note

    The Amazon CloudFormation template was generated using the Amazon CDK available here on GitHub. For more information about the Amazon CDK, see the Amazon Cloud Development Kit (Amazon CDK) Developer Guide.

  3. Run the following command from the command line, replacing STACK_NAME with a unique name for the stack.

    Important

    The stack name must be unique within an Amazon Region and Amazon account. You can specify up to 128 characters, and numbers and hyphens are allowed.

    aws cloudformation create-stack --stack-name STACK_NAME --template-body file://setup.yaml --capabilities CAPABILITY_IAM

    For more information on the create-stack command parameters, see the Amazon CLI Command Reference guide, and the Amazon CloudFormation User Guide.

Note

If you create another stack using this template, you must change the stream name in setup.yaml, or you will encounter an error.

To view the resources when they are created, go to the Stacks page on the Amazon CloudFormation console, select the stack, and open the Resources tab.

The following items are required for this example:

  • An Amazon Kinesis stream. You need to include the name of the stream the browser script.

  • An Amazon Cognito identity pool with access enabled for unauthenticated identities. You need to include the identity pool ID in the code to obtain credentials for the browser script. For more information about Amazon Cognito identity pools, see Identity Pools in the Amazon Cognito Developer Guide.

  • An IAM role with an attached IAM policy that grants permission to submit data to an Amazon Kinesis stream. For more information about creating an IAM role, see Creating a Role to Delegate Permissions to an Amazon Service in the IAM User Guide.

    Note

    This is the role policy when is attached to the IAM role. The CDK automatically populates the STREAM_RESOURCE_ARN.

    {
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": [
            "mobileanalytics:PutEvents",
            "cognito-sync:*"
         ],
         "Resource": [
            "*"
         ]
      },
      {
         "Effect": "Allow",
         "Action": [
            "kinesis:Put*"
         ],
         "Resource": [
            "STREAM_RESOURCE_ARN"
         ]
      }
   ]
}
    Note

    The CDK automatically populates the STREAM_RESOURCE_ARN.

Create the Amazon resources using the Amazon Web Services Management Console;

To create resources for the app in the console, follow the instructions in the Amazon CloudFormation User Guide. Use the template provided create a file named setup.yaml, and copy the content here on GitHub.

Important

The stack name must be unique within an Amazon Region and Amazon account. You can specify up to 128 characters, and numbers and hyphens are allowed.

View a list of the resources in the console by opening the stack on the Amazon CloudFormation dashboard, and choosing the Resources tab. You require these for the example.