ucloud-sdk-python3 0.11.136__py3-none-any.whl → 0.11.138__py3-none-any.whl

ucloud/client.py

@@ -82,6 +82,16 @@ class Client(client.Client):
             self.logger,
         )
 
+    def ses(self):
+        from ucloud.services.ses.client import SESClient
+
+        return SESClient(
+            self._auto_config("ses"),
+            self.transport,
+            self.middleware,
+            self.logger,
+        )
+
     def sts(self):
         from ucloud.services.sts.client import STSClient
 

ucloud/services/ses/client.py

@@ -0,0 +1,152 @@
+""" Code is generated by ucloud-model, DO NOT EDIT IT. """
+
+import typing
+
+
+from ucloud.core.client import Client
+from ucloud.services.ses.schemas import apis
+
+
+class SESClient(Client):
+    def __init__(
+        self, config: dict, transport=None, middleware=None, logger=None
+    ):
+        super(SESClient, self).__init__(config, transport, middleware, logger)
+
+    def send_ses_email(
+        self, req: typing.Optional[dict] = None, **kwargs
+    ) -> dict:
+        """SendSESEmail - 直接发送邮件，无需创建发送任务和模版，支持 HTML/纯文本内容、主题、抄送/密送、附件和邮件头，单次最多 100 个收件人。
+
+        **Request**
+
+        - **ProjectId** (str) - (Config) 项目ID。不填写为默认项目，子帐号必须填写。 请参考 `GetProjectList接口 <https://docs.ucloud.cn/api/summary/get_project_list>`_
+        - **Region** (str) - (Config) 地域。 参见  `地域和可用区列表 <https://docs.ucloud.cn/api/summary/regionlist>`_
+        - **From** (str) - (Required) 发件人邮箱，配置地址：https://console.ucloud.cn/ses/email-config?tab=sender-list
+        - **Subject** (str) - (Required) 邮件主题（长度 1~200 字符）
+        - **To** (list) - (Required) 收件人
+        - **Attachments** (list) - 见 **SendSESEmailParamAttachments** 模型定义
+        - **Bcc** (list) - 密送（抄送+密送总数量不能超过100）
+        - **Cc** (list) - 抄送（抄送+密送总数量不能超过100）
+        - **FromName** (str) - 发件人名称，不传或为空时，自动回落到该发件人在控制台配置的别名（Alias）
+        - **Headers** (list) - 见 **SendSESEmailParamHeaders** 模型定义
+        - **Html** (str) - HTML 内容 （与Text二选一，长度上限 10,485,760个字符）
+        - **PreHeader** (str) - 邮件预览文本
+        - **Text** (str) - 纯文本内容 （与Html二选一，长度上限 10,485,760个字符）
+        - **Zone** (str) - 可用区。参见  `可用区列表 <https://docs.ucloud.cn/api/summary/regionlist>`_
+
+        **Response**
+
+        - **FailContent** (list) - 见 **FailedTargetEmail** 模型定义
+        - **SessionNo** (str) - 本次发送任务的唯一标识
+        - **SuccessCount** (int) - 发送成功数
+
+        **Request Model**
+
+        **SendSESEmailParamAttachments**
+        - **ContentType** (str) - MIME 类型，如： application/pdf
+        - **Data** (str) - 附件内容（Base64 编码），单次请求最多 10 个附件；总大小不超过 10MB
+        - **Filename** (str) - 附件文件名
+
+
+        **SendSESEmailParamHeaders**
+        - **Name** (str) - 邮件头名称，最多 20 个且仅允许字母、数字和 -（正则 ^[A-Za-z0-9-]+$）。禁止使用保留名称：From/To/Cc/Bcc/Subject/Reply-To/Content-Type/Mime-Version，以及 X-SES- 前缀（均不区分大小写）。
+        - **Value** (str) - 邮件头值
+
+
+        **Response Model**
+
+        **FailedTargetEmail**
+        - **Bcc** (list) - 密送
+        - **Cc** (list) - 抄送
+        - **EmailAddress** (str) - 收件邮箱
+        - **FailureReason** (str) - 失败原因
+        - **TemplateVariableParams** (list) - 模版变量
+        - **To** (str) - 收件人
+
+
+        """
+        # build request
+        d = {
+            "ProjectId": self.config.project_id,
+            "Region": self.config.region,
+        }
+        req and d.update(req)
+        d = apis.SendSESEmailRequestSchema().dumps(d)
+
+        # build options
+        kwargs["max_retries"] = 0  # ignore retry when api is not idempotent
+
+        resp = self.invoke("SendSESEmail", d, **kwargs)
+        return apis.SendSESEmailResponseSchema().loads(resp)
+
+    def send_ses_email_template(
+        self, req: typing.Optional[dict] = None, **kwargs
+    ) -> dict:
+        """SendSESEmailTemplate - 通过模版发送邮件，无需创建发送任务。支持自定义主题、摘要、预览文本、抄送/密送、附件和邮件头，单次最多 100 个收件人。
+
+        **Request**
+
+        - **ProjectId** (str) - (Config) 项目ID。不填写为默认项目，子帐号必须填写。 请参考 `GetProjectList接口 <https://docs.ucloud.cn/api/summary/get_project_list>`_
+        - **Region** (str) - (Config) 地域。 参见  `地域和可用区列表 <https://docs.ucloud.cn/api/summary/regionlist>`_
+        - **From** (str) - (Required) 发件人邮箱
+        - **Subject** (str) - (Required) 邮件主题
+        - **TemplateId** (str) - (Required) 模版 ID，获取：https://console.ucloud.cn/ses/email-config?tab=template
+        - **Attachments** (list) - 见 **SendSESEmailTemplateParamAttachments** 模型定义
+        - **EmailContent** (list) - 见 **SendSESEmailTemplateParamEmailContent** 模型定义
+        - **FromName** (str) - 发件人名称，不传或为空时，自动回落到该发件人在控制台配置的别名（Alias）
+        - **Headers** (list) - 见 **SendSESEmailTemplateParamHeaders** 模型定义
+        - **PreHeader** (str) - 邮件预览文本
+        - **Zone** (str) - 可用区。参见  `可用区列表 <https://docs.ucloud.cn/api/summary/regionlist>`_
+
+        **Response**
+
+        - **FailContent** (list) - 见 **FailedTargetEmail** 模型定义
+        - **SessionNo** (str) - 本次发送任务的唯一标识
+        - **SuccessCount** (int) - 发送成功数
+
+        **Request Model**
+
+        **SendSESEmailTemplateParamAttachments**
+        - **ContentType** (str) - MIME 类型，如： application/pdf
+        - **Data** (str) - 附件内容（Base64 编码），单次请求最多 10 个附件；总大小不超过 10MB
+        - **Filename** (str) - 附件文件名
+
+
+        **SendSESEmailTemplateParamEmailContent**
+        - **Bcc** (list) - 密送（抄送+密送总数量不能超过100）
+        - **Cc** (list) - 抄送（抄送+密送总数量不能超过100）
+        - **TemplateVariableParams** (list) - 模版变量，格式 variableName{##}variableValue （例：{"name{##}Tom", "code{##}1234"}）
+        - **To** (str) - 收件人，最多100条
+
+
+        **SendSESEmailTemplateParamHeaders**
+        - **Name** (str) - 邮件头名称，最多 20 个且仅允许字母、数字和 -（正则 ^[A-Za-z0-9-]+$）。禁止使用保留名称：From/To/Cc/Bcc/Subject/Reply-To/Content-Type/Mime-Version，以及 X-SES- 前缀（均不区分大小写）。
+        - **Value** (str) - 邮件头值
+
+
+        **Response Model**
+
+        **FailedTargetEmail**
+        - **Bcc** (list) - 密送
+        - **Cc** (list) - 抄送
+        - **EmailAddress** (str) - 收件邮箱
+        - **FailureReason** (str) - 失败原因
+        - **TemplateVariableParams** (list) - 模版变量
+        - **To** (str) - 收件人
+
+
+        """
+        # build request
+        d = {
+            "ProjectId": self.config.project_id,
+            "Region": self.config.region,
+        }
+        req and d.update(req)
+        d = apis.SendSESEmailTemplateRequestSchema().dumps(d)
+
+        # build options
+        kwargs["max_retries"] = 0  # ignore retry when api is not idempotent
+
+        resp = self.invoke("SendSESEmailTemplate", d, **kwargs)
+        return apis.SendSESEmailTemplateResponseSchema().loads(resp)

ucloud/services/ses/schemas/apis.py

@@ -0,0 +1,141 @@
+""" Code is generated by ucloud-model, DO NOT EDIT IT. """
+
+from ucloud.core.typesystem import schema, fields
+from ucloud.services.ses.schemas import models
+
+""" SES API Schema
+"""
+
+
+"""
+API: SendSESEmail
+
+直接发送邮件，无需创建发送任务和模版，支持 HTML/纯文本内容、主题、抄送/密送、附件和邮件头，单次最多 100 个收件人。
+"""
+
+
+class SendSESEmailParamAttachmentsSchema(schema.RequestSchema):
+    """SendSESEmailParamAttachments -"""
+
+    fields = {
+        "ContentType": fields.Str(required=False, dump_to="ContentType"),
+        "Data": fields.Str(required=False, dump_to="Data"),
+        "Filename": fields.Str(required=False, dump_to="Filename"),
+    }
+
+
+class SendSESEmailParamHeadersSchema(schema.RequestSchema):
+    """SendSESEmailParamHeaders -"""
+
+    fields = {
+        "Name": fields.Str(required=False, dump_to="Name"),
+        "Value": fields.Str(required=False, dump_to="Value"),
+    }
+
+
+class SendSESEmailRequestSchema(schema.RequestSchema):
+    """SendSESEmail - 直接发送邮件，无需创建发送任务和模版，支持 HTML/纯文本内容、主题、抄送/密送、附件和邮件头，单次最多 100 个收件人。"""
+
+    fields = {
+        "Attachments": fields.List(SendSESEmailParamAttachmentsSchema()),
+        "Bcc": fields.List(fields.Str()),
+        "Cc": fields.List(fields.Str()),
+        "From": fields.Str(required=True, dump_to="From"),
+        "FromName": fields.Str(required=False, dump_to="FromName"),
+        "Headers": fields.List(SendSESEmailParamHeadersSchema()),
+        "Html": fields.Str(required=False, dump_to="Html"),
+        "PreHeader": fields.Str(required=False, dump_to="PreHeader"),
+        "ProjectId": fields.Str(required=False, dump_to="ProjectId"),
+        "Region": fields.Str(required=False, dump_to="Region"),
+        "Subject": fields.Str(required=True, dump_to="Subject"),
+        "Text": fields.Str(required=False, dump_to="Text"),
+        "To": fields.List(fields.Str()),
+        "Zone": fields.Str(required=False, dump_to="Zone"),
+    }
+
+
+class SendSESEmailResponseSchema(schema.ResponseSchema):
+    """SendSESEmail - 直接发送邮件，无需创建发送任务和模版，支持 HTML/纯文本内容、主题、抄送/密送、附件和邮件头，单次最多 100 个收件人。"""
+
+    fields = {
+        "FailContent": fields.List(
+            models.FailedTargetEmailSchema(),
+            required=True,
+            load_from="FailContent",
+        ),
+        "SessionNo": fields.Str(required=True, load_from="SessionNo"),
+        "SuccessCount": fields.Int(required=True, load_from="SuccessCount"),
+    }
+
+
+"""
+API: SendSESEmailTemplate
+
+通过模版发送邮件，无需创建发送任务。支持自定义主题、摘要、预览文本、抄送/密送、附件和邮件头，单次最多 100 个收件人。
+"""
+
+
+class SendSESEmailTemplateParamAttachmentsSchema(schema.RequestSchema):
+    """SendSESEmailTemplateParamAttachments -"""
+
+    fields = {
+        "ContentType": fields.Str(required=False, dump_to="ContentType"),
+        "Data": fields.Str(required=False, dump_to="Data"),
+        "Filename": fields.Str(required=False, dump_to="Filename"),
+    }
+
+
+class SendSESEmailTemplateParamEmailContentSchema(schema.RequestSchema):
+    """SendSESEmailTemplateParamEmailContent -"""
+
+    fields = {
+        "Bcc": fields.List(fields.Str()),
+        "Cc": fields.List(fields.Str()),
+        "TemplateVariableParams": fields.List(fields.Str()),
+        "To": fields.Str(required=False, dump_to="To"),
+    }
+
+
+class SendSESEmailTemplateParamHeadersSchema(schema.RequestSchema):
+    """SendSESEmailTemplateParamHeaders -"""
+
+    fields = {
+        "Name": fields.Str(required=False, dump_to="Name"),
+        "Value": fields.Str(required=False, dump_to="Value"),
+    }
+
+
+class SendSESEmailTemplateRequestSchema(schema.RequestSchema):
+    """SendSESEmailTemplate - 通过模版发送邮件，无需创建发送任务。支持自定义主题、摘要、预览文本、抄送/密送、附件和邮件头，单次最多 100 个收件人。"""
+
+    fields = {
+        "Attachments": fields.List(
+            SendSESEmailTemplateParamAttachmentsSchema()
+        ),
+        "EmailContent": fields.List(
+            SendSESEmailTemplateParamEmailContentSchema()
+        ),
+        "From": fields.Str(required=True, dump_to="From"),
+        "FromName": fields.Str(required=False, dump_to="FromName"),
+        "Headers": fields.List(SendSESEmailTemplateParamHeadersSchema()),
+        "PreHeader": fields.Str(required=False, dump_to="PreHeader"),
+        "ProjectId": fields.Str(required=False, dump_to="ProjectId"),
+        "Region": fields.Str(required=False, dump_to="Region"),
+        "Subject": fields.Str(required=True, dump_to="Subject"),
+        "TemplateId": fields.Str(required=True, dump_to="TemplateId"),
+        "Zone": fields.Str(required=False, dump_to="Zone"),
+    }
+
+
+class SendSESEmailTemplateResponseSchema(schema.ResponseSchema):
+    """SendSESEmailTemplate - 通过模版发送邮件，无需创建发送任务。支持自定义主题、摘要、预览文本、抄送/密送、附件和邮件头，单次最多 100 个收件人。"""
+
+    fields = {
+        "FailContent": fields.List(
+            models.FailedTargetEmailSchema(),
+            required=True,
+            load_from="FailContent",
+        ),
+        "SessionNo": fields.Str(required=True, load_from="SessionNo"),
+        "SuccessCount": fields.Int(required=True, load_from="SuccessCount"),
+    }

ucloud/services/ses/schemas/models.py

@@ -0,0 +1,16 @@
+""" Code is generated by ucloud-model, DO NOT EDIT IT. """
+
+from ucloud.core.typesystem import schema, fields
+
+
+class FailedTargetEmailSchema(schema.ResponseSchema):
+    """FailedTargetEmail - 发送失败收件人"""
+
+    fields = {
+        "Bcc": fields.List(fields.Str()),
+        "Cc": fields.List(fields.Str()),
+        "EmailAddress": fields.Str(required=False, load_from="EmailAddress"),
+        "FailureReason": fields.Str(required=False, load_from="FailureReason"),
+        "TemplateVariableParams": fields.List(fields.Str()),
+        "To": fields.Str(required=False, load_from="To"),
+    }

ucloud/version.py

@@ -1 +1 @@
-version = "0.11.136"
+version = "0.11.138"

{ucloud_sdk_python3-0.11.136.dist-info → ucloud_sdk_python3-0.11.138.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ucloud-sdk-python3
-Version: 0.11.136
+Version: 0.11.138
 Summary: UCloud Service Development Kit - Python
 Home-page: https://github.com/ucloud/ucloud-sdk-python3
 Author: ucloud
@@ -23,19 +23,19 @@ License-File: LICENSE
 Requires-Dist: requests
 Provides-Extra: ci
 Requires-Dist: sphinx; extra == "ci"
-Requires-Dist: requests; extra == "ci"
-Requires-Dist: pytest-cov; extra == "ci"
-Requires-Dist: flake8>=3.6.0; extra == "ci"
 Requires-Dist: requests-mock; extra == "ci"
+Requires-Dist: pytest-cov; extra == "ci"
 Requires-Dist: pytest>=4.6; extra == "ci"
+Requires-Dist: requests; extra == "ci"
+Requires-Dist: flake8>=3.6.0; extra == "ci"
 Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
 Requires-Dist: sphinx; extra == "dev"
-Requires-Dist: requests; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: flake8>=3.6.0; extra == "dev"
 Requires-Dist: requests-mock; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: pytest>=4.6; extra == "dev"
-Requires-Dist: black; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+Requires-Dist: flake8>=3.6.0; extra == "dev"
 Provides-Extra: doc
 Requires-Dist: requests; extra == "doc"
 Requires-Dist: sphinx; extra == "doc"

{ucloud_sdk_python3-0.11.136.dist-info → ucloud_sdk_python3-0.11.138.dist-info}/RECORD

@@ -1,6 +1,6 @@
 ucloud/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ucloud/client.py,sha256=WR6atshXR_DWeVaRJIEFuzHKiumdgW-qFQRFxsyC6N0,14548
-ucloud/version.py,sha256=msw5IoyRi_u9BMxGxRDmvt--TK2cMcy4gL9QK3_i-YA,21
+ucloud/client.py,sha256=-BJGM-ulXMVFaj_-fHQkZlB5tu7f3bpZPxpUqFDuii8,14782
+ucloud/version.py,sha256=-WSjt_Jo4twVZEPGpszk8WOkQ-fG4J24aj0pZItq93I,21
 ucloud/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ucloud/core/auth/__init__.py,sha256=yO69G6m3hTfWQZzqFmZJEe0-JXw6JKTHTDJu7goX_QU,71
 ucloud/core/auth/_cfg.py,sha256=7Zsv7bKxJ6NtxeR_VE9jldLh-iIy0ERvkr2AuvLESZY,2115
@@ -72,6 +72,11 @@ ucloud/services/sandbox/client.py,sha256=ghnxf1t3YYAYNalgOnfUf1vkVXbB8k7mWHygE-a
 ucloud/services/sandbox/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ucloud/services/sandbox/schemas/apis.py,sha256=cBKsHFFgS_mwQzNBlEFfAkONu3q2-Xu3Veo0osZk3dM,5850
 ucloud/services/sandbox/schemas/models.py,sha256=n9CW8Tirs7aHrn6bNb2ETRU6aOYscaQ4RZUeEDIhL8U,1665
+ucloud/services/ses/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ucloud/services/ses/client.py,sha256=VsGOOkOeVEavNW3X9ltnuSnMmXl8z1_8pj_mnbqZaUM,7236
+ucloud/services/ses/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ucloud/services/ses/schemas/apis.py,sha256=6557ym9iAA4BIGnnOv9xZR1y4wlufV9MOy-VrURf7Us,5501
+ucloud/services/ses/schemas/models.py,sha256=0jRyQxTUQjcp_K9oPzAOueNrm_sdsQRmoylqZBtZNXE,600
 ucloud/services/stepflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ucloud/services/stepflow/client.py,sha256=Gh_GwF9v7OOGZo8q7kG7aHyV4e4k7f1A-LGYjIGV4HY,4012
 ucloud/services/stepflow/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -338,8 +343,8 @@ ucloud/testing/driver/__init__.py,sha256=54MLBVRxmiRLl0NLnP5dBi7abADTzWT3hJTgWxD
 ucloud/testing/driver/_scenario.py,sha256=9L8TTuPRTRIAowNT9fe8lX-dx3QHPxVuVXlBRkKJs-Y,2585
 ucloud/testing/driver/_specification.py,sha256=FaKgkqsZJej7cTPp6-YjbNotR13mUZvRJlsnxxhUCMs,1726
 ucloud/testing/driver/_step.py,sha256=rK9PN4Hu20eD4ol7jV8KAIqfdwTXKEj9nJoXd_tzHpE,5443
-ucloud_sdk_python3-0.11.136.dist-info/LICENSE,sha256=Pd-b5cKP4n2tFDpdx27qJSIq0d1ok0oEcGTlbtL6QMU,11560
-ucloud_sdk_python3-0.11.136.dist-info/METADATA,sha256=0-en84SsXdMlVRB8iUC-cybJZyXCjSY-JZSISftWQw8,2876
-ucloud_sdk_python3-0.11.136.dist-info/WHEEL,sha256=BNRMDyzLkkcmlv0J8ppDQkk2VED33SesJDynr9ED1gc,91
-ucloud_sdk_python3-0.11.136.dist-info/top_level.txt,sha256=zDw9C3GldC2mbAz2YzUcVbMsPS4MYmWmXnGeYcoIeJI,7
-ucloud_sdk_python3-0.11.136.dist-info/RECORD,,
+ucloud_sdk_python3-0.11.138.dist-info/LICENSE,sha256=Pd-b5cKP4n2tFDpdx27qJSIq0d1ok0oEcGTlbtL6QMU,11560
+ucloud_sdk_python3-0.11.138.dist-info/METADATA,sha256=6LCTT39G45IsRIgjyHxZPHbc7WWQ0GDrGV9CKxaf_a4,2876
+ucloud_sdk_python3-0.11.138.dist-info/WHEEL,sha256=BNRMDyzLkkcmlv0J8ppDQkk2VED33SesJDynr9ED1gc,91
+ucloud_sdk_python3-0.11.138.dist-info/top_level.txt,sha256=zDw9C3GldC2mbAz2YzUcVbMsPS4MYmWmXnGeYcoIeJI,7
+ucloud_sdk_python3-0.11.138.dist-info/RECORD,,