CleanRoomsService / Client / get_collaboration_privacy_budget_template

get_collaboration_privacy_budget_template#

CleanRoomsService.Client.get_collaboration_privacy_budget_template(**kwargs)#

Returns details about a specified privacy budget template.

See also: AWS API Documentation

Request Syntax

response = client.get_collaboration_privacy_budget_template(
    collaborationIdentifier='string',
    privacyBudgetTemplateIdentifier='string'
)
Parameters:

  • collaborationIdentifier (string) –

    [REQUIRED]

    A unique identifier for one of your collaborations.

  • privacyBudgetTemplateIdentifier (string) –

    [REQUIRED]

    A unique identifier for one of your privacy budget templates.

Return type:

dict

Returns:

Response Syntax

{
    'collaborationPrivacyBudgetTemplate': {
        'id': 'string',
        'arn': 'string',
        'collaborationId': 'string',
        'collaborationArn': 'string',
        'creatorAccountId': 'string',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'privacyBudgetType': 'DIFFERENTIAL_PRIVACY',
        'autoRefresh': 'CALENDAR_MONTH'|'NONE',
        'parameters': {
            'differentialPrivacy': {
                'epsilon': 123,
                'usersNoisePerQuery': 123
            }
        }
    }
}

Response Structure

  • (dict) –

    • collaborationPrivacyBudgetTemplate (dict) –

      Returns the details of the privacy budget template that you requested.

      • id (string) –

        The unique identifier of the collaboration privacy budget template.

      • arn (string) –

        The ARN of the collaboration privacy budget template.

      • collaborationId (string) –

        The unique identifier of the collaboration that includes this collaboration privacy budget template.

      • collaborationArn (string) –

        The ARN of the collaboration that includes this collaboration privacy budget template.

      • creatorAccountId (string) –

        The unique identifier of the account that created this collaboration privacy budget template.

      • createTime (datetime) –

        The time at which the collaboration privacy budget template was created.

      • updateTime (datetime) –

        The most recent time at which the collaboration privacy budget template was updated.

      • privacyBudgetType (string) –

        The type of privacy budget template.

      • autoRefresh (string) –

        How often the privacy budget refreshes.

        Warning

        If you plan to regularly bring new data into the collaboration, use CALENDAR_MONTH to automatically get a new privacy budget for the collaboration every calendar month. Choosing this option allows arbitrary amounts of information to be revealed about rows of the data when repeatedly queried across refreshes. Avoid choosing this if the same rows will be repeatedly queried between privacy budget refreshes.

      • parameters (dict) –

        Specifies the epsilon and noise parameters for the privacy budget template.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: differentialPrivacy. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}

        • differentialPrivacy (dict) –

          The epsilon and noise parameters.

          • epsilon (integer) –

            The epsilon value that you specified.

          • usersNoisePerQuery (integer) –

            Noise added per query is measured in terms of the number of users whose contributions you want to obscure. This value governs the rate at which the privacy budget is depleted.

Exceptions