ucloud-sdk-python3 0.11.136__tar.gz → 0.11.137__tar.gz

{ucloud_sdk_python3-0.11.136 → ucloud_sdk_python3-0.11.137}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ucloud-sdk-python3
-Version: 0.11.136
+Version: 0.11.137
 Summary: UCloud Service Development Kit - Python
 Home-page: https://github.com/ucloud/ucloud-sdk-python3
 Author: ucloud
@@ -31,20 +31,20 @@ Provides-Extra: doc
 Requires-Dist: requests; extra == "doc"
 Requires-Dist: sphinx; extra == "doc"
 Provides-Extra: dev
-Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: pytest>=4.6; 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>=4.6; extra == "dev"
 Requires-Dist: black; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: requests_mock; extra == "dev"
 Provides-Extra: ci
-Requires-Dist: sphinx; extra == "ci"
+Requires-Dist: pytest>=4.6; extra == "ci"
 Requires-Dist: requests; extra == "ci"
-Requires-Dist: pytest-cov; extra == "ci"
 Requires-Dist: flake8>=3.6.0; extra == "ci"
+Requires-Dist: pytest-cov; extra == "ci"
+Requires-Dist: sphinx; extra == "ci"
 Requires-Dist: requests_mock; extra == "ci"
-Requires-Dist: pytest>=4.6; extra == "ci"
 
 <p align="center">
     <img src="https://ucloud-sdk.dl.ufileos.com/logos%2Flogo-mini.png" />

{ucloud_sdk_python3-0.11.136 → ucloud_sdk_python3-0.11.137}/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_sdk_python3-0.11.137/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_sdk_python3-0.11.137/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_sdk_python3-0.11.137/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_sdk_python3-0.11.137/ucloud/version.py

@@ -0,0 +1 @@
+version = "0.11.137"

{ucloud_sdk_python3-0.11.136 → ucloud_sdk_python3-0.11.137}/ucloud_sdk_python3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ucloud-sdk-python3
-Version: 0.11.136
+Version: 0.11.137
 Summary: UCloud Service Development Kit - Python
 Home-page: https://github.com/ucloud/ucloud-sdk-python3
 Author: ucloud
@@ -31,20 +31,20 @@ Provides-Extra: doc
 Requires-Dist: requests; extra == "doc"
 Requires-Dist: sphinx; extra == "doc"
 Provides-Extra: dev
-Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: pytest>=4.6; 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>=4.6; extra == "dev"
 Requires-Dist: black; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: requests_mock; extra == "dev"
 Provides-Extra: ci
-Requires-Dist: sphinx; extra == "ci"
+Requires-Dist: pytest>=4.6; extra == "ci"
 Requires-Dist: requests; extra == "ci"
-Requires-Dist: pytest-cov; extra == "ci"
 Requires-Dist: flake8>=3.6.0; extra == "ci"
+Requires-Dist: pytest-cov; extra == "ci"
+Requires-Dist: sphinx; extra == "ci"
 Requires-Dist: requests_mock; extra == "ci"
-Requires-Dist: pytest>=4.6; extra == "ci"
 
 <p align="center">
     <img src="https://ucloud-sdk.dl.ufileos.com/logos%2Flogo-mini.png" />

{ucloud_sdk_python3-0.11.136 → ucloud_sdk_python3-0.11.137}/ucloud_sdk_python3.egg-info/SOURCES.txt

@@ -75,6 +75,11 @@ ucloud/services/sandbox/client.py
 ucloud/services/sandbox/schemas/__init__.py
 ucloud/services/sandbox/schemas/apis.py
 ucloud/services/sandbox/schemas/models.py
+ucloud/services/ses/__init__.py
+ucloud/services/ses/client.py
+ucloud/services/ses/schemas/__init__.py
+ucloud/services/ses/schemas/apis.py
+ucloud/services/ses/schemas/models.py
 ucloud/services/stepflow/__init__.py
 ucloud/services/stepflow/client.py
 ucloud/services/stepflow/schemas/__init__.py

ucloud_sdk_python3-0.11.136/ucloud/version.py

@@ -1 +0,0 @@
-version = "0.11.136"