Connect / Client / list_contact_references
list_contact_references#
- Connect.Client.list_contact_references(**kwargs)#
This API is in preview release for Amazon Connect and is subject to change.
For the specified
referenceTypes
, returns a list of references associated with the contact.See also: AWS API Documentation
Request Syntax
response = client.list_contact_references( InstanceId='string', ContactId='string', ReferenceTypes=[ 'URL'|'ATTACHMENT'|'NUMBER'|'STRING'|'DATE'|'EMAIL', ], NextToken='string' )
- Parameters:
InstanceId (string) –
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
ContactId (string) –
[REQUIRED]
The identifier of the initial contact.
ReferenceTypes (list) –
[REQUIRED]
The type of reference.
(string) –
NextToken (string) –
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
Warning
This is not expected to be set, because the value returned in the previous response is always null.
- Return type:
dict
- Returns:
Response Syntax
{ 'ReferenceSummaryList': [ { 'Url': { 'Name': 'string', 'Value': 'string' }, 'Attachment': { 'Name': 'string', 'Value': 'string', 'Status': 'APPROVED'|'REJECTED' }, 'String': { 'Name': 'string', 'Value': 'string' }, 'Number': { 'Name': 'string', 'Value': 'string' }, 'Date': { 'Name': 'string', 'Value': 'string' }, 'Email': { 'Name': 'string', 'Value': 'string' } }, ], 'NextToken': 'string' }
Response Structure
(dict) –
ReferenceSummaryList (list) –
Information about the flows.
(dict) –
Contains summary information about a reference.
ReferenceSummary
contains only one non null field between the URL and attachment based on the reference type.Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
Url
,Attachment
,String
,Number
,Date
,Email
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
Url (dict) –
Information about the reference when the
referenceType
isURL
. Otherwise, null.Name (string) –
Identifier of the URL reference.
Value (string) –
A valid URL.
Attachment (dict) –
Information about the reference when the
referenceType
isATTACHMENT
. Otherwise, null.Name (string) –
Identifier of the attachment reference.
Value (string) –
The location path of the attachment reference.
Status (string) –
Status of the attachment reference type.
String (dict) –
Information about a reference when the
referenceType
isSTRING
. Otherwise, null.Name (string) –
Identifier of the string reference.
Value (string) –
A valid string.
Number (dict) –
Information about a reference when the
referenceType
isNUMBER
. Otherwise, null.Name (string) –
Identifier of the number reference.
Value (string) –
A valid number.
Date (dict) –
Information about a reference when the
referenceType
isDATE
. Otherwise, null.Name (string) –
Identifier of the date reference.
Value (string) –
A valid date.
Email (dict) –
Information about a reference when the
referenceType
isEMAIL
. Otherwise, null.Name (string) –
Identifier of the email reference.
Value (string) –
A valid email address.
NextToken (string) –
If there are additional results, this is the token for the next set of results.
Warning
This is always returned as null in the response.
Exceptions
Connect.Client.exceptions.InvalidRequestException
Connect.Client.exceptions.InvalidParameterException
Connect.Client.exceptions.ResourceNotFoundException
Connect.Client.exceptions.InternalServiceException
Connect.Client.exceptions.ThrottlingException