CleanRoomsML / Client / update_configured_audience_model

update_configured_audience_model#

CleanRoomsML.Client.update_configured_audience_model(**kwargs)#

Provides the information necessary to update a configured audience model. Updates that impact audience generation jobs take effect when a new job starts, but do not impact currently running jobs.

See also: AWS API Documentation

Request Syntax

response = client.update_configured_audience_model(
    audienceModelArn='string',
    audienceSizeConfig={
        'audienceSizeBins': [
            123,
        ],
        'audienceSizeType': 'ABSOLUTE'|'PERCENTAGE'
    },
    configuredAudienceModelArn='string',
    description='string',
    minMatchingSeedSize=123,
    outputConfig={
        'destination': {
            's3Destination': {
                's3Uri': 'string'
            }
        },
        'roleArn': 'string'
    },
    sharedAudienceMetrics=[
        'ALL'|'NONE',
    ]
)
Parameters:
  • audienceModelArn (string) – The Amazon Resource Name (ARN) of the new audience model that you want to use.

  • audienceSizeConfig (dict) –

    The new audience size configuration.

    • audienceSizeBins (list) – [REQUIRED]

      An array of the different audience output sizes.

      • (integer) –

    • audienceSizeType (string) – [REQUIRED]

      Whether the audience output sizes are defined as an absolute number or a percentage.

  • configuredAudienceModelArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the configured audience model that you want to update.

  • description (string) – The new description of the configured audience model.

  • minMatchingSeedSize (integer) – The minimum number of users from the seed audience that must match with users in the training data of the audience model.

  • outputConfig (dict) –

    The new output configuration.

    • destination (dict) – [REQUIRED]

      Defines the Amazon S3 bucket where the configured audience is stored.

      • s3Destination (dict) – [REQUIRED]

        The Amazon S3 bucket and path for the configured audience.

        • s3Uri (string) – [REQUIRED]

          The Amazon S3 location URI.

    • roleArn (string) – [REQUIRED]

      The ARN of the IAM role that can write the Amazon S3 bucket.

  • sharedAudienceMetrics (list) –

    The new value for whether to share audience metrics.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'configuredAudienceModelArn': 'string'
}

Response Structure

  • (dict) –

    • configuredAudienceModelArn (string) –

      The Amazon Resource Name (ARN) of the configured audience model that was updated.

Exceptions

  • CleanRoomsML.Client.exceptions.ConflictException

  • CleanRoomsML.Client.exceptions.ValidationException

  • CleanRoomsML.Client.exceptions.AccessDeniedException

  • CleanRoomsML.Client.exceptions.ResourceNotFoundException