Removes the association between an S/MIME certificate and an email identity. After the association is removed, Amazon SES API v2 stops adding an S/MIME signature to messages sent from that address.
If the email identity is a domain, specify the FromAddress whose certificate association you want to remove.
This operation is idempotent. If the specified email identity exists but there's no matching certificate association, the operation succeeds without making any changes. Amazon SES API v2 returns a NotFoundException only when the specified email identity doesn't exist.
Parameters:
-
email_identity
(Identity)
–
The email identity whose certificate association you want to remove.
-
from_address
(Optional[EmailAddress], default:
None
)
–
The email address whose certificate association you want to remove. This value is required when the email identity is a domain. When the email identity is an email address, this value is optional.
Raises:
Source code in docs_src/capo_sesv2/_services/se_sv2.py
| def disassociate_email_identity_certificate(
self,
email_identity: "capo_sesv2.types.identity.Identity",
*,
config_overrides: Optional[SESv2ClientConfig] = None,
from_address: Optional["capo_sesv2.types.email_address.EmailAddress"] = None,
) -> "capo_sesv2.types.disassociate_email_identity_certificate_response.DisassociateEmailIdentityCertificateResponse":
"""<p>Removes the association between an S/MIME certificate and an email identity. After the association is removed, Amazon SES API v2 stops adding an S/MIME signature to messages sent from that address.</p> <p>If the email identity is a domain, specify the <code>FromAddress</code> whose certificate association you want to remove.</p> <p>This operation is idempotent. If the specified email identity exists but there's no matching certificate association, the operation succeeds without making any changes. Amazon SES API v2 returns a <code>NotFoundException</code> only when the specified email identity doesn't exist.</p>
Args:
email_identity: <p>The email identity whose certificate association you want to remove.</p>
from_address: <p>The email address whose certificate association you want to remove. This value is required when the email identity is a domain. When the email identity is an email address, this value is optional.</p>
Raises:
capo_sesv2.errors.bad_request_exception.BadRequestException: <p>The input you provided is invalid.</p>
capo_sesv2.errors.not_found_exception.NotFoundException: <p>The resource you attempted to access doesn't exist.</p>
capo_sesv2.errors.too_many_requests_exception.TooManyRequestsException: <p>Too many requests have been made to the operation.</p>
capo_sesv2.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
def _handler(
req: "OperationRequest[capo_sesv2.types.disassociate_email_identity_certificate_request.DisassociateEmailIdentityCertificateRequest]",
) -> OperationResponse[
"capo_sesv2.types.disassociate_email_identity_certificate_response.DisassociateEmailIdentityCertificateResponse"
]:
import capo_sesv2._operations.simple_email_service_v2.disassociate_email_identity_certificate
output, http_response = (
capo_sesv2._operations.simple_email_service_v2.disassociate_email_identity_certificate.disassociate_email_identity_certificate(
req.options, req.input
)
)
return OperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("DisassociateEmailIdentityCertificate")
)
input_: capo_sesv2.types.disassociate_email_identity_certificate_request.DisassociateEmailIdentityCertificateRequest = {
"email_identity": email_identity
}
if from_address is not None:
input_["from_address"] = from_address
response = execute_pipeline(
OperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
response.response.close()
return response.output
|