Creating a membership and joining a collaboration in AWS Clean Rooms - AWS Clean Rooms

Creating a membership and joining a collaboration in AWS Clean Rooms

A membership is a resource that is created when a member joins a collaboration in AWS Clean Rooms.

You can join a collaboration as a member who can query data, member who can receive results of a query, or both. You can also join a collaboration as a member paying for query compute costs. All members can contribute data.

For information about how to create a membership and join a collaboration using the AWS SDKs, see the AWS Clean Rooms API Reference.

Create a membership and join a collaboration

To create a membership and join a collaboration
  1. Sign in to the AWS Management Console and open the AWS Clean Rooms console with your member AWS account.

  2. In the left navigation pane, choose Collaborations.

  3. On the Available to join tab, for Collaborations available to join, choose the Name of the collaboration.

  4. On the collaboration details page, view the collaboration details, including your member details and a list of the other members.

    Verify that the AWS account IDs for each member of the collaboration are the ones with whom you intend to enter in to the collaboration.

  5. Choose Create membership.

  6. On the Create membership page, in the Overview, view the Collaboration name, Collaboration description, AWS account ID of the Collaboration creator, Your member abilities, and the AWS account ID of the member who will Pay for queries.

  7. If the collaboration creator has chosen to enable Query logging, choose one of the following options for Log storage in Amazon CloudWatch Logs:

    If you choose... Then ...
    Turn on The query logs relevant to you are stored in Amazon CloudWatch Logs.

    Each member can receive only logs for queries that they initiated or that contain their data.

    The member who can receive results also receives logs for all queries run in a collaboration, even if their data is not accessed in a query.

    Turn off The query logs relevant to you aren't stored in your Amazon CloudWatch Logs account.
    Note

    After you turn on Query logging, it can take a few minutes for log storage to be set up and start receiving logs in Amazon CloudWatch Logs. During this brief period, the member who can query might run queries that don’t actually send logs.

  8. If Your member abilities includes Receive results:

    1. For Query results settings,

      1. Specify the Results destination in Amazon S3 by entering the S3 destination or choose Browse S3 to select from a list of available S3 buckets.

        For example: s3://bucket/prefix

      2. Choose the Result format (either CSV or PARQUET).

    2. For Service access, choose to either Create and use a new service role or Use an existing service role.

      For more information, see Create a service role to write results.

  9. If you want to enable Tags for the membership resource, choose Add new tag and then enter the Key and Value pair.

  10. If the collaboration creator has designated you as the member who will Pay for queries, indicate your acceptance by selecting the I agree to pay for the query compute costs in this collaboration check box.

    Note

    You must select this check box to proceed.

    For more information about how pricing is calculated, see Pricing for AWS Clean Rooms.

    If you are the member paying for query compute costs but not the member who can query, it is recommended that you use AWS Budgets to configure a budget for AWS Clean Rooms and receive notifications once the maximum budget has been reached. For more information about setting up a budget, see Managing your costs with AWS Budgets in the AWS Cost Management User Guide. For more information about setting up notifications, see Creating an Amazon SNS topic for budget notifications in the AWS Cost Management User Guide. If the maximum budget has been reached, you can contact the member who can run queries or leave the collaboration. If you leave the collaboration, no more queries will be allowed to run, and therefore you will no longer be billed for query compute costs.

  11. If you are sure that you want to create a membership and join the collaboration, choose Create membership.

You are given read access to the collaboration metadata. This includes information such as the display name and description of the collaboration, in addition to all the names and AWS account IDs of other members.

For information about how to leave a collaboration, see Leaving a collaboration.

Next steps

You are now ready to: