Create the Amazon resources - Amazon SDK for JavaScript
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.

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).

Starting October 1, 2022, Amazon SDK for JavaScript (v3) will end support for Internet Explorer 11 (IE 11). For details, see Announcing the end of support for Internet Explorer 11 in the Amazon SDK for JavaScript (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 developer 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 anoher stack using this template, you must change the stream name in the setup.yaml or you encounter an error.

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

You require the following 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 poplulates 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 poplulates 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.