oci 2.125.0__py3-none-any.whl → 2.125.1__py3-none-any.whl

oci/email/email_client.py

@@ -22,12 +22,11 @@ missing = Sentinel("Missing")
 
 class EmailClient(object):
     """
-    API for the Email Delivery service. Use this API to send high-volume, application-generated
-    emails. For more information, see [Overview of the Email Delivery Service](/iaas/Content/Email/Concepts/overview.htm).
+    Use the Email Delivery API to do the necessary set up to send high-volume and application-generated emails through the OCI Email Delivery service.
+    For more information, see [Overview of the Email Delivery Service](/iaas/Content/Email/Concepts/overview.htm).
 
-
-    **Note:** Write actions (POST, UPDATE, DELETE) may take several minutes to propagate and be reflected by the API.
-    If a subsequent read request fails to reflect your changes, wait a few minutes and try again.
+     **Note:** Write actions (POST, UPDATE, DELETE) may take several minutes to propagate and be reflected by the API.
+     If a subsequent read request fails to reflect your changes, wait a few minutes and try again.
     """
 
     def __init__(self, config, **kwargs):
@@ -123,12 +122,12 @@ class EmailClient(object):
 
     def change_email_domain_compartment(self, email_domain_id, change_email_domain_compartment_details, **kwargs):
         """
-        Moves a email domain into a different compartment.
+        Moves an email domain into a different compartment.
         When provided, If-Match is checked against ETag value of the resource.
         For information about moving resources between compartments, see
         `Moving Resources to a Different Compartment`__.
 
-        **Note:** All Dkim objects associated with this email domain will also be moved into the provided compartment.
+        **Note:** All DKIM objects associated with this email domain will also be moved into the provided compartment.
 
         __ https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes
 
@@ -172,7 +171,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/change_email_domain_compartment.py.html>`__ to see an example of how to use change_email_domain_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/change_email_domain_compartment.py.html>`__ to see an example of how to use change_email_domain_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['emailDomainId']
@@ -281,7 +280,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/change_sender_compartment.py.html>`__ to see an example of how to use change_sender_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/change_sender_compartment.py.html>`__ to see an example of how to use change_sender_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['senderId']
@@ -354,10 +353,10 @@ class EmailClient(object):
 
     def create_dkim(self, create_dkim_details, **kwargs):
         """
-        Creates a new DKIM for a email domain.
-        This DKIM will sign all approved senders in the tenancy that are in this email domain.
+        Creates a new DKIM for an email domain.
+        This DKIM signs all approved senders in the tenancy that are in this email domain.
         Best security practices indicate to periodically rotate the DKIM that is doing the signing.
-        When a second DKIM is applied, all senders will seamlessly pick up the new key
+        When a second DKIM is applied, all senders seamlessly pick up the new key
         without interruption in signing.
 
 
@@ -390,7 +389,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/create_dkim.py.html>`__ to see an example of how to use create_dkim API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/create_dkim.py.html>`__ to see an example of how to use create_dkim API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -486,7 +485,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/create_email_domain.py.html>`__ to see an example of how to use create_email_domain API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/create_email_domain.py.html>`__ to see an example of how to use create_email_domain API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -575,7 +574,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/create_sender.py.html>`__ to see an example of how to use create_sender API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/create_sender.py.html>`__ to see an example of how to use create_sender API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -664,7 +663,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/create_suppression.py.html>`__ to see an example of how to use create_suppression API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/create_suppression.py.html>`__ to see an example of how to use create_suppression API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -730,7 +729,7 @@ class EmailClient(object):
         will stop signing the domain's outgoing mail.
         DKIM keys are left in DELETING state for about a day to allow DKIM signatures on
         in-transit mail to be validated.
-        Consider instead of deletion creating a new DKIM for this domain so the signing can be rotated to it.
+        Consider creating a new DKIM for this domain so the signing can be rotated to it instead of deletion.
 
 
         :param str dkim_id: (required)
@@ -762,7 +761,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/delete_dkim.py.html>`__ to see an example of how to use delete_dkim API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/delete_dkim.py.html>`__ to see an example of how to use delete_dkim API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dkimId']
@@ -833,7 +832,7 @@ class EmailClient(object):
 
     def delete_email_domain(self, email_domain_id, **kwargs):
         """
-        Deletes a email domain.
+        Deletes an email domain.
 
 
         :param str email_domain_id: (required)
@@ -865,7 +864,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/delete_email_domain.py.html>`__ to see an example of how to use delete_email_domain API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/delete_email_domain.py.html>`__ to see an example of how to use delete_email_domain API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['emailDomainId']
@@ -967,7 +966,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/delete_sender.py.html>`__ to see an example of how to use delete_sender API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/delete_sender.py.html>`__ to see an example of how to use delete_sender API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['senderId']
@@ -1064,7 +1063,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/delete_suppression.py.html>`__ to see an example of how to use delete_suppression API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/delete_suppression.py.html>`__ to see an example of how to use delete_suppression API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['suppressionId']
@@ -1160,7 +1159,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/get_dkim.py.html>`__ to see an example of how to use get_dkim API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/get_dkim.py.html>`__ to see an example of how to use get_dkim API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dkimId']
@@ -1229,6 +1228,97 @@ class EmailClient(object):
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
+    def get_email_configuration(self, compartment_id, **kwargs):
+        """
+        Returns  email configuration associated with the specified compartment.
+
+
+        :param str compartment_id: (required)
+            The OCID for the compartment.
+
+        :param str opc_request_id: (optional)
+            The request ID for tracing from the system
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.email.models.Configuration`
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/get_email_configuration.py.html>`__ to see an example of how to use get_email_configuration API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['compartmentId']
+        resource_path = "/configuration"
+        method = "GET"
+        operation_name = "get_email_configuration"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/emaildelivery/20170907/Configuration/GetEmailConfiguration"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"get_email_configuration got unknown kwargs: {extra_kwargs!r}")
+
+        query_params = {
+            "compartmentId": compartment_id
+        }
+        query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                query_params=query_params,
+                header_params=header_params,
+                response_type="Configuration",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                query_params=query_params,
+                header_params=header_params,
+                response_type="Configuration",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
     def get_email_domain(self, email_domain_id, **kwargs):
         """
         Retrieves the specified email domain.
@@ -1258,7 +1348,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/get_email_domain.py.html>`__ to see an example of how to use get_email_domain API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/get_email_domain.py.html>`__ to see an example of how to use get_email_domain API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['emailDomainId']
@@ -1354,7 +1444,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/get_sender.py.html>`__ to see an example of how to use get_sender API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/get_sender.py.html>`__ to see an example of how to use get_sender API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['senderId']
@@ -1451,7 +1541,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/get_suppression.py.html>`__ to see an example of how to use get_suppression API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/get_suppression.py.html>`__ to see an example of how to use get_suppression API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['suppressionId']
@@ -1547,7 +1637,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['workRequestId']
@@ -1618,7 +1708,7 @@ class EmailClient(object):
 
     def list_dkims(self, email_domain_id, **kwargs):
         """
-        Lists DKIMs for a email domain.
+        Lists DKIMs for an email domain.
 
 
         :param str email_domain_id: (required)
@@ -1686,7 +1776,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_dkims.py.html>`__ to see an example of how to use list_dkims API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_dkims.py.html>`__ to see an example of how to use list_dkims API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['emailDomainId']
@@ -1853,7 +1943,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_email_domains.py.html>`__ to see an example of how to use list_email_domains API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_email_domains.py.html>`__ to see an example of how to use list_email_domains API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2017,7 +2107,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_senders.py.html>`__ to see an example of how to use list_senders API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_senders.py.html>`__ to see an example of how to use list_senders API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2138,20 +2228,24 @@ class EmailClient(object):
             returned list (inclusive). Specifying this parameter without the
             corresponding `timeCreatedLessThan` parameter will retrieve suppressions created from the
             given `timeCreatedGreaterThanOrEqualTo` to the current time, in \"YYYY-MM-ddThh:mmZ\" format with a
-            Z offset, as defined by RFC 3339.
+            Z offset, as defined by `RFC 3339`__.
 
             **Example:** 2016-12-19T16:39:57.600Z
 
+            __ https://tools.ietf.org/html/rfc3339
+
         :param datetime time_created_less_than: (optional)
             Search for suppressions that were created within a specific date range,
             using this parameter to specify the latest creation date for the returned
             list (exclusive). Specifying this parameter without the corresponding
             `timeCreatedGreaterThanOrEqualTo` parameter will retrieve all suppressions created before the
             specified end date, in \"YYYY-MM-ddThh:mmZ\" format with a Z offset, as
-            defined by RFC 3339.
+            defined by `RFC 3339`__.
 
             **Example:** 2016-12-19T16:39:57.600Z
 
+            __ https://tools.ietf.org/html/rfc3339
+
         :param str page: (optional)
             For list pagination. The value of the opc-next-page response header from the previous \"List\" call.
             For important details about how pagination works,
@@ -2195,7 +2289,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_suppressions.py.html>`__ to see an example of how to use list_suppressions API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_suppressions.py.html>`__ to see an example of how to use list_suppressions API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2328,7 +2422,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['workRequestId']
@@ -2448,7 +2542,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['workRequestId']
@@ -2571,7 +2665,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2678,7 +2772,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/update_dkim.py.html>`__ to see an example of how to use update_dkim API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/update_dkim.py.html>`__ to see an example of how to use update_dkim API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dkimId']
@@ -2751,7 +2845,7 @@ class EmailClient(object):
 
     def update_email_domain(self, email_domain_id, update_email_domain_details, **kwargs):
         """
-        Modifies a email domain.
+        Modifies an email domain.
 
 
         :param str email_domain_id: (required)
@@ -2786,7 +2880,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/update_email_domain.py.html>`__ to see an example of how to use update_email_domain API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/update_email_domain.py.html>`__ to see an example of how to use update_email_domain API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['emailDomainId']
@@ -2897,7 +2991,7 @@ class EmailClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.0/email/update_sender.py.html>`__ to see an example of how to use update_sender API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.1/email/update_sender.py.html>`__ to see an example of how to use update_sender API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['senderId']

oci/email/models/__init__.py

@@ -8,6 +8,7 @@ from __future__ import absolute_import
 
 from .change_email_domain_compartment_details import ChangeEmailDomainCompartmentDetails
 from .change_sender_compartment_details import ChangeSenderCompartmentDetails
+from .configuration import Configuration
 from .create_dkim_details import CreateDkimDetails
 from .create_email_domain_details import CreateEmailDomainDetails
 from .create_sender_details import CreateSenderDetails
@@ -38,6 +39,7 @@ from .work_request_summary_collection import WorkRequestSummaryCollection
 email_type_mapping = {
     "ChangeEmailDomainCompartmentDetails": ChangeEmailDomainCompartmentDetails,
     "ChangeSenderCompartmentDetails": ChangeSenderCompartmentDetails,
+    "Configuration": Configuration,
     "CreateDkimDetails": CreateDkimDetails,
     "CreateEmailDomainDetails": CreateEmailDomainDetails,
     "CreateSenderDetails": CreateSenderDetails,

oci/email/models/configuration.py

@@ -0,0 +1,138 @@
+# coding: utf-8
+# Copyright (c) 2016, 2024, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20170907
+
+
+from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel  # noqa: F401
+from oci.decorators import init_model_state_from_kwargs
+
+
+@init_model_state_from_kwargs
+class Configuration(object):
+    """
+    Tenancy level customer email configuration details.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new Configuration object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param compartment_id:
+            The value to assign to the compartment_id property of this Configuration.
+        :type compartment_id: str
+
+        :param http_submit_endpoint:
+            The value to assign to the http_submit_endpoint property of this Configuration.
+        :type http_submit_endpoint: str
+
+        :param smtp_submit_endpoint:
+            The value to assign to the smtp_submit_endpoint property of this Configuration.
+        :type smtp_submit_endpoint: str
+
+        """
+        self.swagger_types = {
+            'compartment_id': 'str',
+            'http_submit_endpoint': 'str',
+            'smtp_submit_endpoint': 'str'
+        }
+
+        self.attribute_map = {
+            'compartment_id': 'compartmentId',
+            'http_submit_endpoint': 'httpSubmitEndpoint',
+            'smtp_submit_endpoint': 'smtpSubmitEndpoint'
+        }
+
+        self._compartment_id = None
+        self._http_submit_endpoint = None
+        self._smtp_submit_endpoint = None
+
+    @property
+    def compartment_id(self):
+        """
+        **[Required]** Gets the compartment_id of this Configuration.
+        The root compartment `OCID`__ (same as the tenancy OCID)
+
+        __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+
+        :return: The compartment_id of this Configuration.
+        :rtype: str
+        """
+        return self._compartment_id
+
+    @compartment_id.setter
+    def compartment_id(self, compartment_id):
+        """
+        Sets the compartment_id of this Configuration.
+        The root compartment `OCID`__ (same as the tenancy OCID)
+
+        __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+
+        :param compartment_id: The compartment_id of this Configuration.
+        :type: str
+        """
+        self._compartment_id = compartment_id
+
+    @property
+    def http_submit_endpoint(self):
+        """
+        **[Required]** Gets the http_submit_endpoint of this Configuration.
+        Endpoint used to submit emails via the HTTP email submission API
+
+
+        :return: The http_submit_endpoint of this Configuration.
+        :rtype: str
+        """
+        return self._http_submit_endpoint
+
+    @http_submit_endpoint.setter
+    def http_submit_endpoint(self, http_submit_endpoint):
+        """
+        Sets the http_submit_endpoint of this Configuration.
+        Endpoint used to submit emails via the HTTP email submission API
+
+
+        :param http_submit_endpoint: The http_submit_endpoint of this Configuration.
+        :type: str
+        """
+        self._http_submit_endpoint = http_submit_endpoint
+
+    @property
+    def smtp_submit_endpoint(self):
+        """
+        **[Required]** Gets the smtp_submit_endpoint of this Configuration.
+        Endpoint used to submit emails via the standard SMTP submission protocol. Note that TLS 1.2 and standard SMTP authentication is required for submission.
+
+
+        :return: The smtp_submit_endpoint of this Configuration.
+        :rtype: str
+        """
+        return self._smtp_submit_endpoint
+
+    @smtp_submit_endpoint.setter
+    def smtp_submit_endpoint(self, smtp_submit_endpoint):
+        """
+        Sets the smtp_submit_endpoint of this Configuration.
+        Endpoint used to submit emails via the standard SMTP submission protocol. Note that TLS 1.2 and standard SMTP authentication is required for submission.
+
+
+        :param smtp_submit_endpoint: The smtp_submit_endpoint of this Configuration.
+        :type: str
+        """
+        self._smtp_submit_endpoint = smtp_submit_endpoint
+
+    def __repr__(self):
+        return formatted_flat_dict(self)
+
+    def __eq__(self, other):
+        if other is None:
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        return not self == other

oci/email/models/create_dkim_details.py

@@ -71,8 +71,8 @@ class CreateDkimDetails(object):
         The DKIM selector. This selector is required to be globally unique for this email domain.
         If you do not provide the selector, we will generate one for you.
         If you do provide the selector, we suggest adding a short region indicator
-        to differentiate from your signing of emails in other regions you may be subscribed to.
-        Selectors limited to ASCII characters may use alphanumeric, dash (\"-\"), and dot (\".\") characters.
+        to differentiate from your signing of emails in other regions you might be subscribed to.
+        Selectors limited to ASCII characters can use alphanumeric, dash (\"-\"), and dot (\".\") characters.
         Non-ASCII selector names should adopt IDNA2008 normalization (RFC 5891-5892).
 
         Avoid entering confidential information.
@@ -92,8 +92,8 @@ class CreateDkimDetails(object):
         The DKIM selector. This selector is required to be globally unique for this email domain.
         If you do not provide the selector, we will generate one for you.
         If you do provide the selector, we suggest adding a short region indicator
-        to differentiate from your signing of emails in other regions you may be subscribed to.
-        Selectors limited to ASCII characters may use alphanumeric, dash (\"-\"), and dot (\".\") characters.
+        to differentiate from your signing of emails in other regions you might be subscribed to.
+        Selectors limited to ASCII characters can use alphanumeric, dash (\"-\"), and dot (\".\") characters.
         Non-ASCII selector names should adopt IDNA2008 normalization (RFC 5891-5892).
 
         Avoid entering confidential information.

oci/email/models/create_email_domain_details.py

@@ -71,9 +71,11 @@ class CreateEmailDomainDetails(object):
         The email domain name must be unique in the region for this tenancy.
         Domain names limited to ASCII characters use alphanumeric, dash (\"-\"), and dot (\".\") characters.
         The dash and dot are only allowed between alphanumeric characters.
-        For details, please see: https://tools.ietf.org/html/rfc5321#section-4.1.2
+        For details, see `RFC 5321, section 4.1.2`__
         Non-ASCII domain names should adopt IDNA2008 normalization (RFC 5891-5892).
 
+        __ https://tools.ietf.org/html/rfc5321#section-4.1.2
+
 
         :return: The name of this CreateEmailDomainDetails.
         :rtype: str
@@ -88,9 +90,11 @@ class CreateEmailDomainDetails(object):
         The email domain name must be unique in the region for this tenancy.
         Domain names limited to ASCII characters use alphanumeric, dash (\"-\"), and dot (\".\") characters.
         The dash and dot are only allowed between alphanumeric characters.
-        For details, please see: https://tools.ietf.org/html/rfc5321#section-4.1.2
+        For details, see `RFC 5321, section 4.1.2`__
         Non-ASCII domain names should adopt IDNA2008 normalization (RFC 5891-5892).
 
+        __ https://tools.ietf.org/html/rfc5321#section-4.1.2
+
 
         :param name: The name of this CreateEmailDomainDetails.
         :type: str