CleanRoomsML / Client / list_audience_generation_jobs

list_audience_generation_jobs#

CleanRoomsML.Client.list_audience_generation_jobs(**kwargs)#

Returns a list of audience generation jobs.

See also: AWS API Documentation

Request Syntax

response = client.list_audience_generation_jobs(
    collaborationId='string',
    configuredAudienceModelArn='string',
    maxResults=123,
    nextToken='string'
)
Parameters:

  • collaborationId (string) – The identifier of the collaboration that contains the audience generation jobs that you are interested in.

  • configuredAudienceModelArn (string) – The Amazon Resource Name (ARN) of the configured audience model that was used for the audience generation jobs that you are interested in.

  • maxResults (integer) – The maximum size of the results that is returned per call.

  • nextToken (string) – The token value retrieved from a previous call to access the next page of results.

Return type:

dict

Returns:

Response Syntax

{
    'audienceGenerationJobs': [
        {
            'audienceGenerationJobArn': 'string',
            'collaborationId': 'string',
            'configuredAudienceModelArn': 'string',
            'createTime': datetime(2015, 1, 1),
            'description': 'string',
            'name': 'string',
            'startedBy': 'string',
            'status': 'CREATE_PENDING'|'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'ACTIVE'|'DELETE_PENDING'|'DELETE_IN_PROGRESS'|'DELETE_FAILED',
            'updateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • audienceGenerationJobs (list) –

      The audience generation jobs that match the request.

      • (dict) –

        Provides information about the configured audience generation job.

        • audienceGenerationJobArn (string) –

          The Amazon Resource Name (ARN) of the audience generation job.

        • collaborationId (string) –

          The identifier of the collaboration that contains this audience generation job.

        • configuredAudienceModelArn (string) –

          The Amazon Resource Name (ARN) of the configured audience model that was used for this audience generation job.

        • createTime (datetime) –

          The time at which the audience generation job was created.

        • description (string) –

          The description of the audience generation job.

        • name (string) –

          The name of the audience generation job.

        • startedBy (string) –

          The AWS Account that submitted the job.

        • status (string) –

          The status of the audience generation job.

        • updateTime (datetime) –

          The most recent time at which the audience generation job was updated.

    • nextToken (string) –

      The token value retrieved from a previous call to access the next page of results.

Exceptions

  • CleanRoomsML.Client.exceptions.ValidationException

  • CleanRoomsML.Client.exceptions.AccessDeniedException