[ aws . sesv2 ]

list-contacts

Description

Lists the contacts present in a specific contact list.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  list-contacts
--contact-list-name <value>
[--filter <value>]
[--page-size <value>]
[--next-token <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--contact-list-name (string)

The name of the contact list.

--filter (structure)

A filter that can be applied to a list of contacts.

FilteredStatus -> (string)

The status by which you are filtering: OPT_IN or OPT_OUT .

TopicFilter -> (structure)

Used for filtering by a specific topic preference.

TopicName -> (string)

The name of a topic on which you wish to apply the filter.

UseDefaultIfPreferenceUnavailable -> (boolean)

Notes that the default subscription status should be applied to a contact because the contact has not noted their preference for subscribing to a topic.

Shorthand Syntax:

FilteredStatus=string,TopicFilter={TopicName=string,UseDefaultIfPreferenceUnavailable=boolean}

JSON Syntax:

{
  "FilteredStatus": "OPT_IN"|"OPT_OUT",
  "TopicFilter": {
    "TopicName": "string",
    "UseDefaultIfPreferenceUnavailable": true|false
  }
}

--page-size (integer)

The number of contacts that may be returned at once, which is dependent on if there are more or less contacts than the value of the PageSize. Use this parameter to paginate results. If additional contacts exist beyond the specified limit, the NextToken element is sent in the response. Use the NextToken value in subsequent requests to retrieve additional contacts.

--next-token (string)

A string token indicating that there might be additional contacts available to be listed. Use the token provided in the Response to use in the subsequent call to ListContacts with the same parameters to retrieve the next page of contacts.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.

See ‘aws help’ for descriptions of global parameters.

Output

Contacts -> (list)

The contacts present in a specific contact list.

(structure)

A contact is the end-user who is receiving the email.

EmailAddress -> (string)

The contact’s email address.

TopicPreferences -> (list)

The contact’s preference for being opted-in to or opted-out of a topic.

(structure)

The contact’s preference for being opted-in to or opted-out of a topic.

TopicName -> (string)

The name of the topic.

SubscriptionStatus -> (string)

The contact’s subscription status to a topic which is either OPT_IN or OPT_OUT .

TopicDefaultPreferences -> (list)

The default topic preferences applied to the contact.

(structure)

The contact’s preference for being opted-in to or opted-out of a topic.

TopicName -> (string)

The name of the topic.

SubscriptionStatus -> (string)

The contact’s subscription status to a topic which is either OPT_IN or OPT_OUT .

UnsubscribeAll -> (boolean)

A boolean value status noting if the contact is unsubscribed from all contact list topics.

LastUpdatedTimestamp -> (timestamp)

A timestamp noting the last time the contact’s information was updated.

NextToken -> (string)

A string token indicating that there might be additional contacts available to be listed. Copy this token to a subsequent call to ListContacts with the same parameters to retrieve the next page of contacts.