PinpointEmail / Client / get_dedicated_ips

get_dedicated_ips#

PinpointEmail.Client.get_dedicated_ips(**kwargs)#

List the dedicated IP addresses that are associated with your Amazon Pinpoint account.

See also: AWS API Documentation

Request Syntax

response = client.get_dedicated_ips(
    PoolName='string',
    NextToken='string',
    PageSize=123
)
Parameters:
  • PoolName (string) – The name of the IP pool that the dedicated IP address is associated with.

  • NextToken (string) – A token returned from a previous call to GetDedicatedIps to indicate the position of the dedicated IP pool in the list of IP pools.

  • PageSize (integer) – The number of results to show in a single call to GetDedicatedIpsRequest. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

Return type:

dict

Returns:

Response Syntax

{
    'DedicatedIps': [
        {
            'Ip': 'string',
            'WarmupStatus': 'IN_PROGRESS'|'DONE',
            'WarmupPercentage': 123,
            'PoolName': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    Information about the dedicated IP addresses that are associated with your Amazon Pinpoint account.

    • DedicatedIps (list) –

      A list of dedicated IP addresses that are reserved for use by your Amazon Pinpoint account.

      • (dict) –

        Contains information about a dedicated IP address that is associated with your Amazon Pinpoint account.

        • Ip (string) –

          An IP address that is reserved for use by your Amazon Pinpoint account.

        • WarmupStatus (string) –

          The warm-up status of a dedicated IP address. The status can have one of the following values:

          • IN_PROGRESS – The IP address isn’t ready to use because the dedicated IP warm-up process is ongoing.

          • DONE – The dedicated IP warm-up process is complete, and the IP address is ready to use.

        • WarmupPercentage (integer) –

          Indicates how complete the dedicated IP warm-up process is. When this value equals 1, the address has completed the warm-up process and is ready for use.

        • PoolName (string) –

          The name of the dedicated IP pool that the IP address is associated with.

    • NextToken (string) –

      A token that indicates that there are additional dedicated IP addresses to list. To view additional addresses, issue another request to GetDedicatedIps, passing this token in the NextToken parameter.

Exceptions

  • PinpointEmail.Client.exceptions.TooManyRequestsException

  • PinpointEmail.Client.exceptions.NotFoundException

  • PinpointEmail.Client.exceptions.BadRequestException