Class: AWS::SimpleEmailService::Identity

Inherits:
Core::Resource
  • Object
show all
Defined in:
lib/aws/simple_email_service/identity.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#bounce_topic_arn ⇒ String

Returns the current value of bounce_topic_arn.

Returns:

  • (String) —

    the current value of bounce_topic_arn



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def bounce_topic_arn
  @bounce_topic_arn
end

#complaint_topic_arn ⇒ String

Returns the current value of complaint_topic_arn.

Returns:

  • (String) —

    the current value of complaint_topic_arn



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def complaint_topic_arn
  @complaint_topic_arn
end

#dkim_enabled ⇒ Boolean

When set to true, Easy DKIM signing will be enabled for email sent from this identity.

Returns:

  • (Boolean) —

    the current value of dkim_enabled



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def dkim_enabled
  @dkim_enabled
end

#dkim_tokens ⇒ Array<String> (readonly)

Returns a set of DNS records, or tokens, that must be published in the domain name’s DNS to complete the DKIM verification process. Call #verify_dkim if this returns an empty list.

Returns:

  • (Array<String>) —

    the current value of dkim_tokens



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def dkim_tokens
  @dkim_tokens
end

#dkim_verification_status ⇒ String (readonly)

Returns the current value of dkim_verification_status.

Returns:

  • (String) —

    the current value of dkim_verification_status



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def dkim_verification_status
  @dkim_verification_status
end

#forwarding_enabled ⇒ Boolean Also known as: forwarding_enabled?

When false, complaint and bounce notifications will not be forwarded via email. Can only be set to false when there is both a bounce_topic and complaint_topic.

Returns:

  • (Boolean) —

    the current value of forwarding_enabled



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def forwarding_enabled
  @forwarding_enabled
end

#identity ⇒ String (readonly)

Returns the email address or domain name for this identity.

Returns:

  • (String) —

    Returns the email address or domain name for this identity.



49
50
51
 
# File 'lib/aws/simple_email_service/identity.rb', line 49

def identity
  @identity
end

#verification_status ⇒ String (readonly)

Returns the current value of verification_status.

Returns:

  • (String) —

    the current value of verification_status



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def verification_status
  @verification_status
end

#verification_token ⇒ String? (readonly)

Returns the current value of verification_token.

Returns:

  • (String, nil) —

    the current value of verification_token



39
40
41
 
# File 'lib/aws/simple_email_service/identity.rb', line 39

def verification_token
  @verification_token
end

Instance Method Details

#bounce_topic ⇒ SNS::Topic?

Returns:



107
108
109
110
111
 
# File 'lib/aws/simple_email_service/identity.rb', line 107

def bounce_topic
  if arn = bounce_topic_arn
    SNS::Topic.new(arn, :config => config)
  end
end

#bounce_topic=(topic) ⇒ Object

Parameters:

  • topic (String, SNS::Topic) —

    The topic (ARN string or topic object) that bounce notifications should be published to.



101
102
103
104
 
# File 'lib/aws/simple_email_service/identity.rb', line 101

def bounce_topic= topic
  arn = topic.respond_to?(:arn) ? topic.arn : topic
  self.bounce_topic_arn = arn
end

#complaint_topic ⇒ SNS::Topic?

Returns:



121
122
123
124
125
 
# File 'lib/aws/simple_email_service/identity.rb', line 121

def complaint_topic
  if arn = complaint_topic_arn
    SNS::Topic.new(arn, :config => config)
  end
end

#complaint_topic=(topic) ⇒ Object

Parameters:

  • topic (String, SNS::Topic) —

    The topic (ARN string or topic object) that complaint notifications should be published to.



115
116
117
118
 
# File 'lib/aws/simple_email_service/identity.rb', line 115

def complaint_topic= topic
  arn = topic.respond_to?(:arn) ? topic.arn : topic
  self.complaint_topic_arn = arn
end

#delete ⇒ nil

Deletes the current identity.

Returns:

  • (nil) 


153
154
155
156
 
# File 'lib/aws/simple_email_service/identity.rb', line 153

def delete
  client.delete_identity(:identity => identity)
  nil
end

#domain? ⇒ Boolean

Returns true if this AWS::SimpleEmailService::Identity represents a domain.

Returns:



135
136
137
 
# File 'lib/aws/simple_email_service/identity.rb', line 135

def domain?
  !email_address?
end

#email_address? ⇒ Boolean

Returns true if this AWS::SimpleEmailService::Identity represents an email address.

Returns:



129
130
131
 
# File 'lib/aws/simple_email_service/identity.rb', line 129

def email_address?
  identity.match(/@/) ? true : false
end

#exists? ⇒ Boolean

Returns true if the identity exists.

Returns:

  • (Boolean) —

    Returns true if the identity exists.



159
160
161
162
163
 
# File 'lib/aws/simple_email_service/identity.rb', line 159

def exists?
  options = { :identities => [identity] }
  resp = client.get_identity_verification_attributes(options)
  !!resp[:verification_attributes][identity]
end

#pending? ⇒ Boolean

Returns true if verification for this email address/domain is still pending.

Returns:

  • (Boolean) —

    Returns true if verification for this email address/domain is still pending.



147
148
149
 
# File 'lib/aws/simple_email_service/identity.rb', line 147

def pending?
  verification_status == 'Pending'
end

#verified? ⇒ Boolean

Returns true if this email address/domain has been verified.

Returns:

  • (Boolean) —

    Returns true if this email address/domain has been verified.



141
142
143
 
# File 'lib/aws/simple_email_service/identity.rb', line 141

def verified?
  verification_status == 'Success'
end

#verify_dkim ⇒ Array<String>

Returns an array of DKIM tokens.

Returns:

  • (Array<String>) —

    Returns an array of DKIM tokens.



90
91
92
93
94
95
96
97
 
# File 'lib/aws/simple_email_service/identity.rb', line 90

def verify_dkim
  if domain?
    resp = client.verify_domain_dkim(:domain => identity)
    reps[:dkim_tokens]
  else
    raise "unable to verify dkim for an email address"
  end
end