---
title: "POST /memberships/{membershipIdentifier}/configuredTableAssociations/{configuredTableAssociationIdentifier}/analysisRule"
method: POST
path: "/memberships/{membershipIdentifier}/configuredTableAssociations/{configuredTableAssociationIdentifier}/analysisRule"
---

# POST /memberships/{membershipIdentifier}/configuredTableAssociations/{configuredTableAssociationIdentifier}/analysisRule

`POST /memberships/{membershipIdentifier}/configuredTableAssociations/{configuredTableAssociationIdentifier}/analysisRule`

Creates a new analysis rule for an associated configured table.

## Path parameters

- `membershipIdentifier` string, required
- `configuredTableAssociationIdentifier` string, required

## Request body

- object
  - `analysisRuleType` 'AGGREGATION' | 'LIST' | 'CUSTOM', required — The type of analysis rule.
  - `analysisRulePolicy` object, required — Controls on the query specifications that can be run on an associated configured table.
    - `v1` object — The policy for the configured table association analysis rule.
      - `list` object — Analysis rule type that enables only list queries on a configured table.
        - `allowedResultReceivers` AccountId[] — The list of collaboration members who are allowed to receive results of queries run with this configured table.
        - `allowedAdditionalAnalyses` AdditionalAnalysesResourceArn[] — The list of resources or wildcards (ARNs) that are allowed to perform additional analysis on query output.
      - `aggregation` object — Analysis rule type that enables only aggregation queries on a configured table.
        - `allowedResultReceivers` AccountId[] — The list of collaboration members who are allowed to receive results of queries run with this configured table.
        - `allowedAdditionalAnalyses` AdditionalAnalysesResourceArn[] — <p> The list of resources or wildcards (ARNs) that are allowed to perform additional analysis on query output.</p> <p>The <code>allowedAdditionalAnalyses</code> parameter is currently supported for the list analysis rule (<code>AnalysisRuleList</code>) and the custom analysis rule (<code>AnalysisRuleCustom</code>).</p>
      - `custom` object — Analysis rule type that enables the table owner to approve custom SQL queries on their configured tables. It supports differential privacy.
        - `allowedResultReceivers` AccountId[] — The list of collaboration members who are allowed to receive results of queries run with this configured table.
        - `allowedAdditionalAnalyses` AdditionalAnalysesResourceArn[] — The list of resources or wildcards (ARNs) that are allowed to perform additional analysis on query output.

## Response `200`

Success

- CreateConfiguredTableAssociationAnalysisRuleOutput
  - `analysisRule` object, required — The analysis rule for the configured table association. In the console, the <code>ConfiguredTableAssociationAnalysisRule</code> is referred to as the <i>collaboration analysis rule</i>.
    - `membershipIdentifier` string, required — The membership identifier for the configured table association analysis rule.
    - `configuredTableAssociationId` string, required — The unique identifier for the configured table association.
    - `configuredTableAssociationArn` string, required — The Amazon Resource Name (ARN) of the configured table association.
    - `policy` object, required — The policy of the configured table association analysis rule.
      - `v1` object — The policy for the configured table association analysis rule.
        - `list` object — Analysis rule type that enables only list queries on a configured table.
          - `allowedResultReceivers` AccountId[] — The list of collaboration members who are allowed to receive results of queries run with this configured table.
          - `allowedAdditionalAnalyses` AdditionalAnalysesResourceArn[] — The list of resources or wildcards (ARNs) that are allowed to perform additional analysis on query output.
        - `aggregation` object — Analysis rule type that enables only aggregation queries on a configured table.
          - `allowedResultReceivers` AccountId[] — The list of collaboration members who are allowed to receive results of queries run with this configured table.
          - `allowedAdditionalAnalyses` AdditionalAnalysesResourceArn[] — <p> The list of resources or wildcards (ARNs) that are allowed to perform additional analysis on query output.</p> <p>The <code>allowedAdditionalAnalyses</code> parameter is currently supported for the list analysis rule (<code>AnalysisRuleList</code>) and the custom analysis rule (<code>AnalysisRuleCustom</code>).</p>
        - `custom` object — Analysis rule type that enables the table owner to approve custom SQL queries on their configured tables. It supports differential privacy.
          - `allowedResultReceivers` AccountId[] — The list of collaboration members who are allowed to receive results of queries run with this configured table.
          - `allowedAdditionalAnalyses` AdditionalAnalysesResourceArn[] — The list of resources or wildcards (ARNs) that are allowed to perform additional analysis on query output.
    - `type` 'AGGREGATION' | 'LIST' | 'CUSTOM', required — The type of the configured table association analysis rule.
    - `createTime` string, date-time, required — The creation time of the configured table association analysis rule.
    - `updateTime` string, date-time, required — The update time of the configured table association analysis rule.

## Other responses

- `480` — ConflictException
- `481` — ResourceNotFoundException
- `482` — InternalServerException
- `483` — ValidationException
- `484` — ThrottlingException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/cleanrooms.md) · [All operations](https://skmtc.net/aws/apis/cleanrooms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cleanrooms/revisions/17ce59ba806e/schema)