AWS::CleanRooms::Collaboration - Amazon CloudFormation
SyntaxPropertiesReturn valuesExamples
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).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

AWS::CleanRooms::Collaboration

Creates a new collaboration.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::CleanRooms::Collaboration",
  "Properties" : {
      "AnalyticsEngine" : String,
      "AutoApprovedChangeTypes" : [ String, ... ],
      "CreatorDisplayName" : String,
      "CreatorMemberAbilities" : [ String, ... ],
      "CreatorMLMemberAbilities" : MLMemberAbilities,
      "CreatorPaymentConfiguration" : PaymentConfiguration,
      "DataEncryptionMetadata" : DataEncryptionMetadata,
      "Description" : String,
      "JobLogStatus" : String,
      "Members" : [ MemberSpecification, ... ],
      "Name" : String,
      "QueryLogStatus" : String,
      "Tags" : [ Tag, ... ]
    }
}

Properties

AnalyticsEngine

The analytics engine for the collaboration.

Note

After July 16, 2025, the CLEAN_ROOMS_SQL parameter will no longer be available.

Required: No

Type: String

Allowed values: CLEAN_ROOMS_SQL | SPARK

Update requires: No interruption

AutoApprovedChangeTypes

The types of change requests that are automatically approved for this collaboration.

Required: No

Type: Array of String

Update requires: Replacement

CreatorDisplayName

A display name of the collaboration creator.

Required: Yes

Type: String

Pattern: ^(?!\s*$)[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDBFF-\uDC00\uDFFF\t]*$

Minimum: 1

Maximum: 100

Update requires: Replacement

CreatorMemberAbilities

The abilities granted to the collaboration creator.

Allowed valuesCAN_QUERY | CAN_RECEIVE_RESULTS | CAN_RUN_JOB

Required: No

Type: Array of String

Update requires: Replacement

CreatorMLMemberAbilities

The ML member abilities for a collaboration member.

Required: No

Type: MLMemberAbilities

Update requires: Replacement

CreatorPaymentConfiguration

An object representing the collaboration member's payment responsibilities set by the collaboration creator.

Required: No

Type: PaymentConfiguration

Update requires: Replacement

DataEncryptionMetadata

The settings for client-side encryption for cryptographic computing.

Required: No

Type: DataEncryptionMetadata

Update requires: Replacement

Description

A description of the collaboration provided by the collaboration owner.

Required: Yes

Type: String

Pattern: ^(?!\s*$)[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDBFF-\uDC00\uDFFF\t\r\n]*$

Minimum: 1

Maximum: 255

Update requires: No interruption

JobLogStatus

An indicator as to whether job logging has been enabled or disabled for the collaboration.

When ENABLED, Amazon Clean Rooms logs details about jobs run within this collaboration and those logs can be viewed in Amazon CloudWatch Logs. The default value is DISABLED.

Required: No

Type: String

Allowed values: ENABLED | DISABLED

Update requires: Replacement

Members

A list of initial members, not including the creator. This list is immutable.

Required: No

Type: Array of MemberSpecification

Minimum: 0

Maximum: 9

Update requires: Replacement

Name

A human-readable identifier provided by the collaboration owner. Display names are not unique.

Required: Yes

Type: String

Pattern: ^(?!\s*$)[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDBFF-\uDC00\uDFFF\t]*$

Minimum: 1

Maximum: 100

Update requires: No interruption

QueryLogStatus

An indicator as to whether query logging has been enabled or disabled for the collaboration.

When ENABLED, Amazon Clean Rooms logs details about queries run within this collaboration and those logs can be viewed in Amazon CloudWatch Logs. The default value is DISABLED.

Required: Yes

Type: String

Allowed values: ENABLED | DISABLED

Update requires: Replacement

Tags

An optional label that you can assign to a resource when you create it. Each tag consists of a key and an optional value, both of which you define. When you use tagging, you can also use tag-based access control in IAM policies to control access to this resource.

Required: No

Type: Array of Tag

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the CollaborationIdentifier, such as a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. For example:

{ "Ref": "MyCollaboration" }

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Arn

Returns the Amazon Resource Name (ARN) of the specified collaboration.

Example: arn:aws:cleanrooms:us-east-1:111122223333:collaboration/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

CollaborationIdentifier

Returns the unique identifier of the specified collaboration.

Example: a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Examples

Create a collaboration

The following example creates a collaboration with the collaboration creator.

JSON

"ExampleCollaboration": {
  {
    "Type": "AWS::CleanRooms::Collaboration",
    "Properties": {
      "Name": "Example Collaboration",
      "Description": "Example AWS Clean Rooms collaboration",
      "CreatorDisplayName": "Member 1",
      "CreatorMemberAbilities": ["CAN_QUERY", "CAN_RECEIVE_RESULTS"],
      "Members": [
        {
          "AccountId": "111122223333",
          "DisplayName": "Member 2",
          "MemberAbilities": []
        },
        {
          "AccountId": "444455556666",
          "DisplayName": "Member 3",
          "MemberAbilities": []
        }
      ],
      "QueryLogStatus": "ENABLED"
    }
  }
}

YAML

ExampleCollaboration:
  Type: AWS::CleanRooms::Collaboration
  Properties:
    Name: Example Collaboration
    Description: Example AWS Clean Rooms collaboration
    CreatorDisplayName: Member 1
    CreatorMemberAbilities:
      - CAN_QUERY
      - CAN_RECEIVE_RESULTS
    Members:
      - AccountId: 111122223333
        DisplayName: Member 2
        MemberAbilities: []
      - AccountId: 444455556666
        DisplayName: Member 3
        MemberAbilities: []
    QueryLogStatus: ENABLED