Skip to main content

profile_object_types

Creates, updates, deletes, gets or lists a profile_object_types resource.

Overview

Nameprofile_object_types
TypeResource
Idaws.customer_profiles.profile_object_types

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
allow_profile_creationbooleanIndicates whether a profile should be created when data is received if one doesn’t exist for an object of this type. The default is FALSE. If the AllowProfileCreation flag is set to FALSE, then the service tries to fetch a standard profile and associate this object with the profile. If it is set to TRUE, and if no match is found, then the service creates a new standard profile.
created_atstring (date-time)The timestamp of when the domain was created.
descriptionstringThe description of the profile object type.
encryption_keystringThe customer-provided key to encrypt the profile object that will be created in this profile object type.
expiration_daysintegerThe number of days until the data in the object expires.
fieldsobjectA map of the name and ObjectType field.
keysobjectA list of unique keys that can be used to map data to the profile.
last_updated_atstring (date-time)The timestamp of when the domain was most recently edited.
max_available_profile_object_countintegerThe amount of provisioned profile object max count available.
max_profile_object_countintegerThe amount of profile object max count assigned to the object type.
object_type_namestringThe name of the profile object type. (pattern: <code>^[a-zA-Z_][a-zA-Z_0-9-]*$</code>)
source_last_updated_timestamp_formatstringThe format of your sourceLastUpdatedTimestamp that was previously set up.
source_priorityintegerAn integer that determines the priority of this object type when data from multiple sources is ingested. Lower values take priority. Object types without a specified source priority default to the lowest priority.
tagsobjectThe tags used to organize, track, or control access for this resource.
template_idstringA unique identifier for the object template. (pattern: <code>^[a-zA-Z0-9_-]+$</code>)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_profile_object_typeselectdomain_name, object_type_name, regionReturns the object types for a specific domain.
list_profile_object_typesselectdomain_name, regionnext-token, max-resultsLists all of the templates available within the service.
put_profile_object_typereplacedomain_name, object_type_name, regionDefines a ProfileObjectType. To add or remove tags on an existing ObjectType, see TagResource/UntagResource.
delete_profile_object_typedeletedomain_name, object_type_name, regionRemoves a ProfileObjectType from a specific domain as well as removes all the ProfileObjects of that type. It also disables integrations from this specific ProfileObjectType. In addition, it scrubs all of the fields of the standard profile that were populated from this ProfileObjectType.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
domain_namestringThe unique name of the domain.
object_type_namestringThe name of the profile object type.
regionstringAWS region (default: us-east-1)
max-resultsintegerThe maximum number of objects returned per page.
next-tokenstringIdentifies the next page of results to return.

SELECT examples

Returns the object types for a specific domain.

SELECT
allow_profile_creation,
created_at,
description,
encryption_key,
expiration_days,
fields,
keys,
last_updated_at,
max_available_profile_object_count,
max_profile_object_count,
object_type_name,
source_last_updated_timestamp_format,
source_priority,
tags,
template_id
FROM aws.customer_profiles.profile_object_types
WHERE domain_name = '{{ domain_name }}' -- required
AND object_type_name = '{{ object_type_name }}' -- required
AND region = '{{ region }}' -- required
;

REPLACE examples

Defines a ProfileObjectType. To add or remove tags on an existing ObjectType, see TagResource/UntagResource.

REPLACE aws.customer_profiles.profile_object_types
SET
Description = '{{ Description }}',
TemplateId = '{{ TemplateId }}',
ExpirationDays = {{ ExpirationDays }},
EncryptionKey = '{{ EncryptionKey }}',
AllowProfileCreation = {{ AllowProfileCreation }},
SourceLastUpdatedTimestampFormat = '{{ SourceLastUpdatedTimestampFormat }}',
MaxProfileObjectCount = {{ MaxProfileObjectCount }},
SourcePriority = {{ SourcePriority }},
Fields = '{{ Fields }}',
Keys = '{{ Keys }}',
Tags = '{{ Tags }}'
WHERE
domain_name = '{{ domain_name }}' --required
AND object_type_name = '{{ object_type_name }}' --required
AND region = '{{ region }}' --required
RETURNING
allow_profile_creation,
created_at,
description,
encryption_key,
expiration_days,
fields,
keys,
last_updated_at,
max_available_profile_object_count,
max_profile_object_count,
object_type_name,
source_last_updated_timestamp_format,
source_priority,
tags,
template_id;

DELETE examples

Removes a ProfileObjectType from a specific domain as well as removes all the ProfileObjects of that type. It also disables integrations from this specific ProfileObjectType. In addition, it scrubs all of the fields of the standard profile that were populated from this ProfileObjectType.

DELETE FROM aws.customer_profiles.profile_object_types
WHERE domain_name = '{{ domain_name }}' --required
AND object_type_name = '{{ object_type_name }}' --required
AND region = '{{ region }}' --required
;