tencentcloud-sdk-python-teo 3.1.189__tar.gz → 3.1.193__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/PKG-INFO +2 -2
  2. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/setup.py +1 -1
  3. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/__init__.py +1 -1
  4. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220901/models.py +389 -36
  5. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220901/teo_client.py +38 -7
  6. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220901/teo_client_async.py +33 -7
  7. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud_sdk_python_teo.egg-info/PKG-INFO +2 -2
  8. tencentcloud_sdk_python_teo-3.1.193/tencentcloud_sdk_python_teo.egg-info/requires.txt +1 -0
  9. tencentcloud_sdk_python_teo-3.1.189/tencentcloud_sdk_python_teo.egg-info/requires.txt +0 -1
  10. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/README.rst +0 -0
  11. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/setup.cfg +0 -0
  12. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/__init__.py +0 -0
  13. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220106/__init__.py +0 -0
  14. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220106/errorcodes.py +0 -0
  15. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220106/models.py +0 -0
  16. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220106/teo_client.py +0 -0
  17. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220106/teo_client_async.py +0 -0
  18. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220901/__init__.py +0 -0
  19. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud/teo/v20220901/errorcodes.py +0 -0
  20. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud_sdk_python_teo.egg-info/SOURCES.txt +0 -0
  21. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud_sdk_python_teo.egg-info/dependency_links.txt +0 -0
  22. {tencentcloud_sdk_python_teo-3.1.189 → tencentcloud_sdk_python_teo-3.1.193}/tencentcloud_sdk_python_teo.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: tencentcloud-sdk-python-teo
3
- Version: 3.1.189
3
+ Version: 3.1.193
4
4
  Summary: Tencent Cloud Teo SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
15
15
  Classifier: Programming Language :: Python :: 3
16
16
  Classifier: Programming Language :: Python :: 3.6
17
17
  Classifier: Programming Language :: Python :: 3.7
18
- Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.189
18
+ Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.193
19
19
 
20
20
  ============================
21
21
  Tencent Cloud SDK for Python
@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
8
8
 
9
9
  setup(
10
10
  name='tencentcloud-sdk-python-teo',
11
- install_requires=["tencentcloud-sdk-python-common>=3.1.189,<4.0.0"],
11
+ install_requires=["tencentcloud-sdk-python-common>=3.1.193,<4.0.0"],
12
12
 
13
13
  version=tencentcloud.__version__,
14
14
  description='Tencent Cloud Teo SDK for Python',
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
 
16
16
 
17
- __version__ = '3.1.189'
17
+ __version__ = '3.1.193'
@@ -262,6 +262,102 @@ class APIService(AbstractModel):
262
262
 
263
263
 
264
264
 
265
+ class AWSS3(AbstractModel):
266
+ r"""AWS S3 目的地信息。通过 IAM 角色 + External ID 授权 EdgeOne 将实时日志投递至客户的 AWS S3 桶,无需提供长期访问密钥,详情见 [推送至 AWS S3](https://cloud.tencent.com/document/product/1552/96007)。
267
+
268
+ """
269
+
270
+ def __init__(self):
271
+ r"""
272
+ :param _Endpoint: <p>AWS S3 存储桶对应的服务端点域名,取值可参考 <a href="https://docs.aws.amazon.com/zh_cn/general/latest/gr/rande.html#regional-endpoints">AWS 服务端点</a>。例如:s3.us-west-2.amazonaws.com 。</p>
273
+ :type Endpoint: str
274
+ :param _BucketName: <p>AWS S3 存储桶名称。可在 AWS S3 控制台 Buckets(存储桶)列表中查看对应桶名。<br>长度须为 3–63 个字符,只能包含小写字母、数字、句点(.)和连字符(-),且必须以字母或数字开头和结尾。</p>
275
+ :type BucketName: str
276
+ :param _Path: <p>日志文件在 AWS S3 桶中的存储目录路径,以 <code>/</code> 分隔可创建多级目录,且不能包含 <code>./..</code> 等相对路径段,路径总长度不超过 1024 个字节。<br>当目录路径存在时直接使用该路径,当目录路径不存在时会自动创建。<br>目录名仅允许由字母、数字、 及 <code>!-_.*&#39;()</code> 构成。<br>示例:<code>eo-logs/l7-access-logs</code> 。</p>
277
+ :type Path: str
278
+ :param _RoleARN: <p>授权 EdgeOne 访问 AWS S3 桶的 IAM 角色的 ARN。<br>需先在 AWS 账号中创建一个授予 EdgeOne 写入权限的 IAM 角色(创建方式详情见 <a href="https://cloud.tencent.com/document/product/1552/96007">推送至 AWS S3</a>),创建后可在 AWS IAM 控制台的角色详情页顶部查看并复制该角色的 ARN。<br>例如:<code>arn:aws:iam::123456789012:role/eo-logs</code> 。</p>
279
+ :type RoleARN: str
280
+ :param _CompressType: <p>数据压缩类型,取值有: <ul><li> gzip:gzip压缩。</li></ul>不填表示不启用压缩。</p>
281
+ :type CompressType: str
282
+ """
283
+ self._Endpoint = None
284
+ self._BucketName = None
285
+ self._Path = None
286
+ self._RoleARN = None
287
+ self._CompressType = None
288
+
289
+ @property
290
+ def Endpoint(self):
291
+ r"""<p>AWS S3 存储桶对应的服务端点域名,取值可参考 <a href="https://docs.aws.amazon.com/zh_cn/general/latest/gr/rande.html#regional-endpoints">AWS 服务端点</a>。例如:s3.us-west-2.amazonaws.com 。</p>
292
+ :rtype: str
293
+ """
294
+ return self._Endpoint
295
+
296
+ @Endpoint.setter
297
+ def Endpoint(self, Endpoint):
298
+ self._Endpoint = Endpoint
299
+
300
+ @property
301
+ def BucketName(self):
302
+ r"""<p>AWS S3 存储桶名称。可在 AWS S3 控制台 Buckets(存储桶)列表中查看对应桶名。<br>长度须为 3–63 个字符,只能包含小写字母、数字、句点(.)和连字符(-),且必须以字母或数字开头和结尾。</p>
303
+ :rtype: str
304
+ """
305
+ return self._BucketName
306
+
307
+ @BucketName.setter
308
+ def BucketName(self, BucketName):
309
+ self._BucketName = BucketName
310
+
311
+ @property
312
+ def Path(self):
313
+ r"""<p>日志文件在 AWS S3 桶中的存储目录路径,以 <code>/</code> 分隔可创建多级目录,且不能包含 <code>./..</code> 等相对路径段,路径总长度不超过 1024 个字节。<br>当目录路径存在时直接使用该路径,当目录路径不存在时会自动创建。<br>目录名仅允许由字母、数字、 及 <code>!-_.*&#39;()</code> 构成。<br>示例:<code>eo-logs/l7-access-logs</code> 。</p>
314
+ :rtype: str
315
+ """
316
+ return self._Path
317
+
318
+ @Path.setter
319
+ def Path(self, Path):
320
+ self._Path = Path
321
+
322
+ @property
323
+ def RoleARN(self):
324
+ r"""<p>授权 EdgeOne 访问 AWS S3 桶的 IAM 角色的 ARN。<br>需先在 AWS 账号中创建一个授予 EdgeOne 写入权限的 IAM 角色(创建方式详情见 <a href="https://cloud.tencent.com/document/product/1552/96007">推送至 AWS S3</a>),创建后可在 AWS IAM 控制台的角色详情页顶部查看并复制该角色的 ARN。<br>例如:<code>arn:aws:iam::123456789012:role/eo-logs</code> 。</p>
325
+ :rtype: str
326
+ """
327
+ return self._RoleARN
328
+
329
+ @RoleARN.setter
330
+ def RoleARN(self, RoleARN):
331
+ self._RoleARN = RoleARN
332
+
333
+ @property
334
+ def CompressType(self):
335
+ r"""<p>数据压缩类型,取值有: <ul><li> gzip:gzip压缩。</li></ul>不填表示不启用压缩。</p>
336
+ :rtype: str
337
+ """
338
+ return self._CompressType
339
+
340
+ @CompressType.setter
341
+ def CompressType(self, CompressType):
342
+ self._CompressType = CompressType
343
+
344
+
345
+ def _deserialize(self, params):
346
+ self._Endpoint = params.get("Endpoint")
347
+ self._BucketName = params.get("BucketName")
348
+ self._Path = params.get("Path")
349
+ self._RoleARN = params.get("RoleARN")
350
+ self._CompressType = params.get("CompressType")
351
+ memeber_set = set(params.keys())
352
+ for name, value in vars(self).items():
353
+ property_name = name[1:]
354
+ if property_name in memeber_set:
355
+ memeber_set.remove(property_name)
356
+ if len(memeber_set) > 0:
357
+ warnings.warn("%s fileds are useless." % ",".join(memeber_set))
358
+
359
+
360
+
265
361
  class AccelerateMainland(AbstractModel):
266
362
  r"""中国大陆加速优化配置。
267
363
 
@@ -754,20 +850,17 @@ class AccessURLRedirectParameters(AbstractModel):
754
850
 
755
851
  def __init__(self):
756
852
  r"""
757
- :param _StatusCode: 状态码,取值为 301、302、303、307、308 之一。
853
+ :param _StatusCode: <p>状态码,取值为 301、302、303、307、308 之一。</p>
758
854
  :type StatusCode: int
759
- :param _Protocol: 目标请求协议,取值有:
760
- <li>http:目标请求协议 HTTP;</li>
761
- <li>https:目标请求协议 HTTPS;</li>
762
- <li>follow:跟随请求。</li>
855
+ :param _Protocol: <p>目标请求协议。</p><p>枚举值:</p><ul><li>http: 目标请求协议为 HTTP。</li><li>https: 目标请求协议为 HTTPS。</li><li>follow: 跟随请求。</li></ul>
763
856
  :type Protocol: str
764
- :param _HostName: 目标 HostName 。
857
+ :param _HostName: <p>目标 HostName。</p>
765
858
  注意:此字段可能返回 null,表示取不到有效值。
766
859
  :type HostName: :class:`tencentcloud.teo.v20220901.models.HostName`
767
- :param _URLPath: 目标路径。
860
+ :param _URLPath: <p>目标路径。</p>
768
861
  注意:此字段可能返回 null,表示取不到有效值。
769
862
  :type URLPath: :class:`tencentcloud.teo.v20220901.models.URLPath`
770
- :param _QueryString: 携带查询参数。
863
+ :param _QueryString: <p>携带查询参数。</p>
771
864
  注意:此字段可能返回 null,表示取不到有效值。
772
865
  :type QueryString: :class:`tencentcloud.teo.v20220901.models.AccessURLRedirectQueryString`
773
866
  """
@@ -779,7 +872,7 @@ class AccessURLRedirectParameters(AbstractModel):
779
872
 
780
873
  @property
781
874
  def StatusCode(self):
782
- r"""状态码,取值为 301、302、303、307、308 之一。
875
+ r"""<p>状态码,取值为 301、302、303、307、308 之一。</p>
783
876
  :rtype: int
784
877
  """
785
878
  return self._StatusCode
@@ -790,10 +883,7 @@ class AccessURLRedirectParameters(AbstractModel):
790
883
 
791
884
  @property
792
885
  def Protocol(self):
793
- r"""目标请求协议,取值有:
794
- <li>http:目标请求协议 HTTP;</li>
795
- <li>https:目标请求协议 HTTPS;</li>
796
- <li>follow:跟随请求。</li>
886
+ r"""<p>目标请求协议。</p><p>枚举值:</p><ul><li>http: 目标请求协议为 HTTP。</li><li>https: 目标请求协议为 HTTPS。</li><li>follow: 跟随请求。</li></ul>
797
887
  :rtype: str
798
888
  """
799
889
  return self._Protocol
@@ -804,7 +894,7 @@ class AccessURLRedirectParameters(AbstractModel):
804
894
 
805
895
  @property
806
896
  def HostName(self):
807
- r"""目标 HostName 。
897
+ r"""<p>目标 HostName。</p>
808
898
  注意:此字段可能返回 null,表示取不到有效值。
809
899
  :rtype: :class:`tencentcloud.teo.v20220901.models.HostName`
810
900
  """
@@ -816,7 +906,7 @@ class AccessURLRedirectParameters(AbstractModel):
816
906
 
817
907
  @property
818
908
  def URLPath(self):
819
- r"""目标路径。
909
+ r"""<p>目标路径。</p>
820
910
  注意:此字段可能返回 null,表示取不到有效值。
821
911
  :rtype: :class:`tencentcloud.teo.v20220901.models.URLPath`
822
912
  """
@@ -828,7 +918,7 @@ class AccessURLRedirectParameters(AbstractModel):
828
918
 
829
919
  @property
830
920
  def QueryString(self):
831
- r"""携带查询参数。
921
+ r"""<p>携带查询参数。</p>
832
922
  注意:此字段可能返回 null,表示取不到有效值。
833
923
  :rtype: :class:`tencentcloud.teo.v20220901.models.AccessURLRedirectQueryString`
834
924
  """
@@ -14422,7 +14512,7 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14422
14512
  :type LogType: str
14423
14513
  :param _TaskName: <p>实时日志投递任务的名称,格式为数字、英文、-和_组合,最多 200 个字符。</p>
14424
14514
  :type TaskName: str
14425
- :param _TaskType: <p>实时日志投递任务类型,取值有:<ul><li>cls: 推送到腾讯云 CLS;</li><li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li><li>s3:推送到 AWS S3 兼容存储桶地址;</li><li>log_analysis:推送到 EdgeOne 日志分析,仅当 LogType = l7-access-logs 或 web-attack 时支持。</li></ul></p>
14515
+ :param _TaskType: <p>实时日志投递任务类型,取值有:<ul><li>cls: 推送到腾讯云 CLS;</li><li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li><li>s3:推送到 S3 兼容(兼容 SigV4 鉴权算法)的对象存储的地址,当 <code>LogType = web-attack</code> 时不支持该任务类型;</li><li>aws_s3:推送到 AWS S3 存储桶地址,使用 IAM 角色授权,免长期密钥,仅适用于 AWS 原生 S3;</li><li>log_analysis:推送到 EdgeOne 日志分析,仅当 <code>LogType = l7-access-logs</code> 或 <code>web-attack</code> 时支持。</li></ul></p>
14426
14516
  :type TaskType: str
14427
14517
  :param _EntityList: <p>实时日志投递任务对应的实体列表。取值示例如下:<ul><li>七层域名:domain.example.com</li><li>四层代理实例:sid-2s69eb5wcms7</li><li>边缘函数实例:test-zone-2mxigizoh9l9-1257626257</li></ul></p><p>取值参考:<a href="https://cloud.tencent.com/document/api/1552/103413">DescribeL4Proxy</a></p>
14428
14518
  :type EntityList: list of str
@@ -14430,20 +14520,22 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14430
14520
  :type Fields: list of str
14431
14521
  :param _CustomFields: <p>投递的自定义字段列表,支持在 HTTP 请求头、响应头、Cookie、请求正文中提取指定内容。<br>自定义字段名称不能重复,仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE)。</p>
14432
14522
  :type CustomFields: list of CustomField
14433
- :param _CustomExpressionFields: <p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式]()。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
14523
+ :param _CustomExpressionFields: <p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式](https://cloud.tencent.com/document/product/1552/105794)。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
14434
14524
  :type CustomExpressionFields: list of CustomExpressionField
14435
14525
  :param _DeliveryConditions: <p>日志投递的过滤条件,不填表示投递全量日志。</p>
14436
14526
  :type DeliveryConditions: list of DeliveryCondition
14437
14527
  :param _Sample: <p>采样比例,采用千分制,取值范围为1-1000,例如:填写 605 表示采样比例为 60.5%。不填表示采样比例为 100%。</p>
14438
14528
  :type Sample: int
14439
- :param _LogFormat: <p>日志投递的输出格式,使用详情见 <a href="https://cloud.tencent.com/document/product/1552/110448">自定义日志输出格式</a>。不填表示为默认格式,默认格式逻辑如下:<ul><li>当 TaskType 取值为 custom_endpoint 时,默认格式为多个 JSON 对象组成的数组,每个 JSON 对象为一条日志;</li><li>当 TaskType 取值为 s3 时,默认格式为 JSON Lines;</li></ul>特别地,当 TaskType 取值为 cls 或 log_analysis 时,LogFormat.FormatType 的值只能为 json,且 LogFormat 中其他参数将被忽略,建议不传 LogFormat。</p>
14529
+ :param _LogFormat: <p>日志投递的输出格式,使用详情见 <a href="https://cloud.tencent.com/document/product/1552/110448">自定义日志输出格式</a>。不填表示为默认格式,默认格式逻辑如下:<ul><li>当 TaskType 取值为 custom_endpoint 时,默认格式为多个 JSON 对象组成的数组,每个 JSON 对象为一条日志;</li><li>当 TaskType 取值为 s3 或 aws_s3 时,默认格式为 JSON Lines;</li></ul>特别地,当 TaskType 取值为 cls 或 log_analysis 时,LogFormat.FormatType 的值只能为 json,且 LogFormat 中其他参数将被忽略,建议不传 LogFormat。</p>
14440
14530
  :type LogFormat: :class:`tencentcloud.teo.v20220901.models.LogFormat`
14441
14531
  :param _CLS: <p>CLS 的配置信息。当 TaskType 取值为 cls 时,该参数必填。</p>
14442
14532
  :type CLS: :class:`tencentcloud.teo.v20220901.models.CLSTopic`
14443
14533
  :param _CustomEndpoint: <p>自定义 HTTP 服务的配置信息。当 TaskType 取值为 custom_endpoint 时,该参数必填。</p>
14444
14534
  :type CustomEndpoint: :class:`tencentcloud.teo.v20220901.models.CustomEndpoint`
14445
- :param _S3: <p>AWS S3 兼容存储桶的配置信息。当 TaskType 取值为 s3 时,该参数必填。</p>
14535
+ :param _S3: <p>S3 兼容(兼容 SigV4 鉴权算法)的对象存储的配置信息。当 TaskType 取值为 s3 时,该参数必填。</p>
14446
14536
  :type S3: :class:`tencentcloud.teo.v20220901.models.S3`
14537
+ :param _AWSS3: <p>AWS S3 的对象存储的配置信息,使用 IAM 角色授权,免长期密钥,仅适用于 AWS 原生 S3 。当 TaskType 为 aws_s3 时,该参数必填。</p>
14538
+ :type AWSS3: :class:`tencentcloud.teo.v20220901.models.AWSS3`
14447
14539
  """
14448
14540
  self._ZoneId = None
14449
14541
  self._Area = None
@@ -14460,6 +14552,7 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14460
14552
  self._CLS = None
14461
14553
  self._CustomEndpoint = None
14462
14554
  self._S3 = None
14555
+ self._AWSS3 = None
14463
14556
 
14464
14557
  @property
14465
14558
  def ZoneId(self):
@@ -14507,7 +14600,7 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14507
14600
 
14508
14601
  @property
14509
14602
  def TaskType(self):
14510
- r"""<p>实时日志投递任务类型,取值有:<ul><li>cls: 推送到腾讯云 CLS;</li><li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li><li>s3:推送到 AWS S3 兼容存储桶地址;</li><li>log_analysis:推送到 EdgeOne 日志分析,仅当 LogType = l7-access-logs 或 web-attack 时支持。</li></ul></p>
14603
+ r"""<p>实时日志投递任务类型,取值有:<ul><li>cls: 推送到腾讯云 CLS;</li><li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li><li>s3:推送到 S3 兼容(兼容 SigV4 鉴权算法)的对象存储的地址,当 <code>LogType = web-attack</code> 时不支持该任务类型;</li><li>aws_s3:推送到 AWS S3 存储桶地址,使用 IAM 角色授权,免长期密钥,仅适用于 AWS 原生 S3;</li><li>log_analysis:推送到 EdgeOne 日志分析,仅当 <code>LogType = l7-access-logs</code> 或 <code>web-attack</code> 时支持。</li></ul></p>
14511
14604
  :rtype: str
14512
14605
  """
14513
14606
  return self._TaskType
@@ -14551,7 +14644,7 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14551
14644
 
14552
14645
  @property
14553
14646
  def CustomExpressionFields(self):
14554
- r"""<p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式]()。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
14647
+ r"""<p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式](https://cloud.tencent.com/document/product/1552/105794)。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
14555
14648
  :rtype: list of CustomExpressionField
14556
14649
  """
14557
14650
  return self._CustomExpressionFields
@@ -14584,7 +14677,7 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14584
14677
 
14585
14678
  @property
14586
14679
  def LogFormat(self):
14587
- r"""<p>日志投递的输出格式,使用详情见 <a href="https://cloud.tencent.com/document/product/1552/110448">自定义日志输出格式</a>。不填表示为默认格式,默认格式逻辑如下:<ul><li>当 TaskType 取值为 custom_endpoint 时,默认格式为多个 JSON 对象组成的数组,每个 JSON 对象为一条日志;</li><li>当 TaskType 取值为 s3 时,默认格式为 JSON Lines;</li></ul>特别地,当 TaskType 取值为 cls 或 log_analysis 时,LogFormat.FormatType 的值只能为 json,且 LogFormat 中其他参数将被忽略,建议不传 LogFormat。</p>
14680
+ r"""<p>日志投递的输出格式,使用详情见 <a href="https://cloud.tencent.com/document/product/1552/110448">自定义日志输出格式</a>。不填表示为默认格式,默认格式逻辑如下:<ul><li>当 TaskType 取值为 custom_endpoint 时,默认格式为多个 JSON 对象组成的数组,每个 JSON 对象为一条日志;</li><li>当 TaskType 取值为 s3 或 aws_s3 时,默认格式为 JSON Lines;</li></ul>特别地,当 TaskType 取值为 cls 或 log_analysis 时,LogFormat.FormatType 的值只能为 json,且 LogFormat 中其他参数将被忽略,建议不传 LogFormat。</p>
14588
14681
  :rtype: :class:`tencentcloud.teo.v20220901.models.LogFormat`
14589
14682
  """
14590
14683
  return self._LogFormat
@@ -14617,7 +14710,7 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14617
14710
 
14618
14711
  @property
14619
14712
  def S3(self):
14620
- r"""<p>AWS S3 兼容存储桶的配置信息。当 TaskType 取值为 s3 时,该参数必填。</p>
14713
+ r"""<p>S3 兼容(兼容 SigV4 鉴权算法)的对象存储的配置信息。当 TaskType 取值为 s3 时,该参数必填。</p>
14621
14714
  :rtype: :class:`tencentcloud.teo.v20220901.models.S3`
14622
14715
  """
14623
14716
  return self._S3
@@ -14626,6 +14719,17 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14626
14719
  def S3(self, S3):
14627
14720
  self._S3 = S3
14628
14721
 
14722
+ @property
14723
+ def AWSS3(self):
14724
+ r"""<p>AWS S3 的对象存储的配置信息,使用 IAM 角色授权,免长期密钥,仅适用于 AWS 原生 S3 。当 TaskType 为 aws_s3 时,该参数必填。</p>
14725
+ :rtype: :class:`tencentcloud.teo.v20220901.models.AWSS3`
14726
+ """
14727
+ return self._AWSS3
14728
+
14729
+ @AWSS3.setter
14730
+ def AWSS3(self, AWSS3):
14731
+ self._AWSS3 = AWSS3
14732
+
14629
14733
 
14630
14734
  def _deserialize(self, params):
14631
14735
  self._ZoneId = params.get("ZoneId")
@@ -14666,6 +14770,9 @@ class CreateRealtimeLogDeliveryTaskRequest(AbstractModel):
14666
14770
  if params.get("S3") is not None:
14667
14771
  self._S3 = S3()
14668
14772
  self._S3._deserialize(params.get("S3"))
14773
+ if params.get("AWSS3") is not None:
14774
+ self._AWSS3 = AWSS3()
14775
+ self._AWSS3._deserialize(params.get("AWSS3"))
14669
14776
  memeber_set = set(params.keys())
14670
14777
  for name, value in vars(self).items():
14671
14778
  property_name = name[1:]
@@ -27838,6 +27945,180 @@ class DescribeLogAnalysisDownloadTasksResponse(AbstractModel):
27838
27945
  self._RequestId = params.get("RequestId")
27839
27946
 
27840
27947
 
27948
+ class DescribeLogAnalysisStatisticsRequest(AbstractModel):
27949
+ r"""DescribeLogAnalysisStatistics请求参数结构体
27950
+
27951
+ """
27952
+
27953
+ def __init__(self):
27954
+ r"""
27955
+ :param _ZoneId: <p>站点 ID。</p>
27956
+ :type ZoneId: str
27957
+ :param _Area: <p>数据归属地区,可选值:</p><ul><li>mainland:中国大陆境内;</li><li>overseas:全球(不含中国大陆)。</li></ul>注意:若站点服务区域为“全球可用区”,获取全部数据需要分别查询 mainland 和 overseas 的数据。<p></p>
27958
+ :type Area: str
27959
+ :param _LogType: <p>日志类型,可选值:</p><ul><li> l7-access-logs:七层访问日志;</li><li>web-attack:托管规则日志。</li></ul>默认为 l7-access-logs 。<p></p>
27960
+ :type LogType: str
27961
+ :param _StartTime: <p>开始时间,示例值:2020-04-29T00:00:00Z。套餐版本不同,支持的可查询开始时间至今的最大时间跨度不同,详情请见 <a href="https://cloud.tencent.com/document/product/1552/94165#45435466-9103-4ff6-be22-e31717044fb2">套餐选型对比</a>。</p>
27962
+ :type StartTime: str
27963
+ :param _EndTime: <p>结束时间,示例值:2020-04-30T00:00:00Z。单次查询的开始时间到结束时间跨度最大为 31 天。</p>
27964
+ :type EndTime: str
27965
+ :param _Query: <p>统计查询语句,由 [<a href="https://cloud.tencent.com/document/product/1552/124662">检索条件</a>] | [<a href="https://cloud.tencent.com/document/product/1552/124662">SQL语句</a>] 构成,管道符 “|” 后的 SQL 段必填;检索条件段可为空(如 | SELECT ...),表示在全量数据上聚合。长度上限 12KB,SQL 默认 Limit 100,最大 Limit 10000 。<br>示例:</p><p>带检索条件: <code>${EdgeCacheStatus} in [&#39;miss&#39;,&#39;other&#39;] | select EdgeCacheStatus as status, count(\*) as cnt group by status limit 2</code></p><p>不带检索条件:<code>| select EdgeCacheStatus as status, count(\*) as cnt group by status</code></p>
27966
+ :type Query: str
27967
+ """
27968
+ self._ZoneId = None
27969
+ self._Area = None
27970
+ self._LogType = None
27971
+ self._StartTime = None
27972
+ self._EndTime = None
27973
+ self._Query = None
27974
+
27975
+ @property
27976
+ def ZoneId(self):
27977
+ r"""<p>站点 ID。</p>
27978
+ :rtype: str
27979
+ """
27980
+ return self._ZoneId
27981
+
27982
+ @ZoneId.setter
27983
+ def ZoneId(self, ZoneId):
27984
+ self._ZoneId = ZoneId
27985
+
27986
+ @property
27987
+ def Area(self):
27988
+ r"""<p>数据归属地区,可选值:</p><ul><li>mainland:中国大陆境内;</li><li>overseas:全球(不含中国大陆)。</li></ul>注意:若站点服务区域为“全球可用区”,获取全部数据需要分别查询 mainland 和 overseas 的数据。<p></p>
27989
+ :rtype: str
27990
+ """
27991
+ return self._Area
27992
+
27993
+ @Area.setter
27994
+ def Area(self, Area):
27995
+ self._Area = Area
27996
+
27997
+ @property
27998
+ def LogType(self):
27999
+ r"""<p>日志类型,可选值:</p><ul><li> l7-access-logs:七层访问日志;</li><li>web-attack:托管规则日志。</li></ul>默认为 l7-access-logs 。<p></p>
28000
+ :rtype: str
28001
+ """
28002
+ return self._LogType
28003
+
28004
+ @LogType.setter
28005
+ def LogType(self, LogType):
28006
+ self._LogType = LogType
28007
+
28008
+ @property
28009
+ def StartTime(self):
28010
+ r"""<p>开始时间,示例值:2020-04-29T00:00:00Z。套餐版本不同,支持的可查询开始时间至今的最大时间跨度不同,详情请见 <a href="https://cloud.tencent.com/document/product/1552/94165#45435466-9103-4ff6-be22-e31717044fb2">套餐选型对比</a>。</p>
28011
+ :rtype: str
28012
+ """
28013
+ return self._StartTime
28014
+
28015
+ @StartTime.setter
28016
+ def StartTime(self, StartTime):
28017
+ self._StartTime = StartTime
28018
+
28019
+ @property
28020
+ def EndTime(self):
28021
+ r"""<p>结束时间,示例值:2020-04-30T00:00:00Z。单次查询的开始时间到结束时间跨度最大为 31 天。</p>
28022
+ :rtype: str
28023
+ """
28024
+ return self._EndTime
28025
+
28026
+ @EndTime.setter
28027
+ def EndTime(self, EndTime):
28028
+ self._EndTime = EndTime
28029
+
28030
+ @property
28031
+ def Query(self):
28032
+ r"""<p>统计查询语句,由 [<a href="https://cloud.tencent.com/document/product/1552/124662">检索条件</a>] | [<a href="https://cloud.tencent.com/document/product/1552/124662">SQL语句</a>] 构成,管道符 “|” 后的 SQL 段必填;检索条件段可为空(如 | SELECT ...),表示在全量数据上聚合。长度上限 12KB,SQL 默认 Limit 100,最大 Limit 10000 。<br>示例:</p><p>带检索条件: <code>${EdgeCacheStatus} in [&#39;miss&#39;,&#39;other&#39;] | select EdgeCacheStatus as status, count(\*) as cnt group by status limit 2</code></p><p>不带检索条件:<code>| select EdgeCacheStatus as status, count(\*) as cnt group by status</code></p>
28033
+ :rtype: str
28034
+ """
28035
+ return self._Query
28036
+
28037
+ @Query.setter
28038
+ def Query(self, Query):
28039
+ self._Query = Query
28040
+
28041
+
28042
+ def _deserialize(self, params):
28043
+ self._ZoneId = params.get("ZoneId")
28044
+ self._Area = params.get("Area")
28045
+ self._LogType = params.get("LogType")
28046
+ self._StartTime = params.get("StartTime")
28047
+ self._EndTime = params.get("EndTime")
28048
+ self._Query = params.get("Query")
28049
+ memeber_set = set(params.keys())
28050
+ for name, value in vars(self).items():
28051
+ property_name = name[1:]
28052
+ if property_name in memeber_set:
28053
+ memeber_set.remove(property_name)
28054
+ if len(memeber_set) > 0:
28055
+ warnings.warn("%s fileds are useless." % ",".join(memeber_set))
28056
+
28057
+
28058
+
28059
+ class DescribeLogAnalysisStatisticsResponse(AbstractModel):
28060
+ r"""DescribeLogAnalysisStatistics返回参数结构体
28061
+
28062
+ """
28063
+
28064
+ def __init__(self):
28065
+ r"""
28066
+ :param _Columns: <p>日志分析统计结果的列名,对应入参 Query 中 SQL 部分 SELECT 的字段。<br>示例:<br>入参 Query = <code>${EdgeCacheStatus} in [&#39;miss&#39;,&#39;other&#39;] | select EdgeCacheStatus as status, count(*) as cnt group by status limit 2</code><br>出参 Columns = <code>[&quot;status&quot;,&quot;cnt&quot;]</code></p>
28067
+ :type Columns: list of str
28068
+ :param _Records: <p>日志分析统计结果的数据行,每行值下标与列下标一一对应。<br>示例:<br>Columns = <code>[&quot;status&quot;,&quot;cnt&quot;]</code><br>Records = <code>[[&quot;miss&quot;,&quot;9695&quot;],[&quot;other&quot;,&quot;278&quot;]]</code></p>
28069
+ :type Records: list of StatisticsRecord
28070
+ :param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
28071
+ :type RequestId: str
28072
+ """
28073
+ self._Columns = None
28074
+ self._Records = None
28075
+ self._RequestId = None
28076
+
28077
+ @property
28078
+ def Columns(self):
28079
+ r"""<p>日志分析统计结果的列名,对应入参 Query 中 SQL 部分 SELECT 的字段。<br>示例:<br>入参 Query = <code>${EdgeCacheStatus} in [&#39;miss&#39;,&#39;other&#39;] | select EdgeCacheStatus as status, count(*) as cnt group by status limit 2</code><br>出参 Columns = <code>[&quot;status&quot;,&quot;cnt&quot;]</code></p>
28080
+ :rtype: list of str
28081
+ """
28082
+ return self._Columns
28083
+
28084
+ @Columns.setter
28085
+ def Columns(self, Columns):
28086
+ self._Columns = Columns
28087
+
28088
+ @property
28089
+ def Records(self):
28090
+ r"""<p>日志分析统计结果的数据行,每行值下标与列下标一一对应。<br>示例:<br>Columns = <code>[&quot;status&quot;,&quot;cnt&quot;]</code><br>Records = <code>[[&quot;miss&quot;,&quot;9695&quot;],[&quot;other&quot;,&quot;278&quot;]]</code></p>
28091
+ :rtype: list of StatisticsRecord
28092
+ """
28093
+ return self._Records
28094
+
28095
+ @Records.setter
28096
+ def Records(self, Records):
28097
+ self._Records = Records
28098
+
28099
+ @property
28100
+ def RequestId(self):
28101
+ r"""唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
28102
+ :rtype: str
28103
+ """
28104
+ return self._RequestId
28105
+
28106
+ @RequestId.setter
28107
+ def RequestId(self, RequestId):
28108
+ self._RequestId = RequestId
28109
+
28110
+
28111
+ def _deserialize(self, params):
28112
+ self._Columns = params.get("Columns")
28113
+ if params.get("Records") is not None:
28114
+ self._Records = []
28115
+ for item in params.get("Records"):
28116
+ obj = StatisticsRecord()
28117
+ obj._deserialize(item)
28118
+ self._Records.append(obj)
28119
+ self._RequestId = params.get("RequestId")
28120
+
28121
+
27841
28122
  class DescribeMultiPathGatewayLineRequest(AbstractModel):
27842
28123
  r"""DescribeMultiPathGatewayLine请求参数结构体
27843
28124
 
@@ -45374,8 +45655,8 @@ class L4ProxyRule(AbstractModel):
45374
45655
  :type OriginType: str
45375
45656
  :param _OriginValue: 源站地址:
45376
45657
  <li>当 OriginType 为 IP_DOMAIN 时,填写 IP 或域名,如 8.8.8.8 或 test.com ;</li>
45377
- <li>当 OriginType 为 ORIGIN_GROUP 时,填写源站组 ID,如 og-537y24vf5b41;</li>
45378
- <li>当 OriginType 为 LB 时,填写负载均衡实例 ID,如 lb-2qwk30xf7s9g。</li>
45658
+ <li>当 OriginType 为 ORIGIN_GROUP 时,填写源站组 ID,如 og-537y24vf5b41;如果引用了其它站点的源站组,格式为{源站组 ID}@{ZoneID}。例如:og-testorigin@zone-38moq1z10wwwy;</li>
45659
+ <li>当 OriginType 为 LB 时,填写负载均衡实例 ID,如 lb-2qwk30xf7s9g;如果引用了其它站点的负载均衡,格式为{负载均衡 ID}@{ZoneID}。例如:lb-2rxpamcyqfzg@zone-38moq1z10wwwy。</li>
45379
45660
  注意:L4ProxyRule 在 CreateL4ProxyRules 作为入参使用时,该参数必填;在 ModifyL4ProxyRules 作为入参使用时,该参数选填,不填写时表示不修改。
45380
45661
 
45381
45662
  :type OriginValue: list of str
@@ -45491,8 +45772,8 @@ class L4ProxyRule(AbstractModel):
45491
45772
  def OriginValue(self):
45492
45773
  r"""源站地址:
45493
45774
  <li>当 OriginType 为 IP_DOMAIN 时,填写 IP 或域名,如 8.8.8.8 或 test.com ;</li>
45494
- <li>当 OriginType 为 ORIGIN_GROUP 时,填写源站组 ID,如 og-537y24vf5b41;</li>
45495
- <li>当 OriginType 为 LB 时,填写负载均衡实例 ID,如 lb-2qwk30xf7s9g。</li>
45775
+ <li>当 OriginType 为 ORIGIN_GROUP 时,填写源站组 ID,如 og-537y24vf5b41;如果引用了其它站点的源站组,格式为{源站组 ID}@{ZoneID}。例如:og-testorigin@zone-38moq1z10wwwy;</li>
45776
+ <li>当 OriginType 为 LB 时,填写负载均衡实例 ID,如 lb-2qwk30xf7s9g;如果引用了其它站点的负载均衡,格式为{负载均衡 ID}@{ZoneID}。例如:lb-2rxpamcyqfzg@zone-38moq1z10wwwy。</li>
45496
45777
  注意:L4ProxyRule 在 CreateL4ProxyRules 作为入参使用时,该参数必填;在 ModifyL4ProxyRules 作为入参使用时,该参数选填,不填写时表示不修改。
45497
45778
 
45498
45779
  :rtype: list of str
@@ -51792,9 +52073,9 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51792
52073
  :type EntityList: list of str
51793
52074
  :param _Fields: <p>投递的预设字段列表。不填保持原有配置。</p><p>取值参考:DescribeLogFields</p>
51794
52075
  :type Fields: list of str
51795
- :param _CustomFields: <p>投递的自定义日志字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,详见 <a href="">自定义日志字段表达式</a>。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段,允许配置的自定义字段个数有配额限制,如遇配额不足请 <a href="https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE">联系我们</a> 。</p>
52076
+ :param _CustomFields: <p>投递的自定义字段列表,支持在 HTTP 请求头、响应头、Cookie、请求正文中提取指定内容。<br>自定义字段名称不能重复,仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE)。</p>
51796
52077
  :type CustomFields: list of CustomField
51797
- :param _CustomExpressionFields: <p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式]()。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
52078
+ :param _CustomExpressionFields: <p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式](https://cloud.tencent.com/document/product/1552/105794)。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
51798
52079
  :type CustomExpressionFields: list of CustomExpressionField
51799
52080
  :param _DeliveryConditions: <p>日志投递的过滤条件。不填表示投递全量日志。</p>
51800
52081
  :type DeliveryConditions: list of DeliveryCondition
@@ -51804,8 +52085,10 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51804
52085
  :type LogFormat: :class:`tencentcloud.teo.v20220901.models.LogFormat`
51805
52086
  :param _CustomEndpoint: <p>自定义 HTTP 服务的配置信息,不填保持原有配置。</p>
51806
52087
  :type CustomEndpoint: :class:`tencentcloud.teo.v20220901.models.CustomEndpoint`
51807
- :param _S3: <p>AWS S3 兼容存储桶的配置信息,不填保持原有配置。</p>
52088
+ :param _S3: <p>S3 兼容(兼容 SigV4 鉴权算法)的对象存储的配置信息,不填保持原有配置。</p>
51808
52089
  :type S3: :class:`tencentcloud.teo.v20220901.models.S3`
52090
+ :param _AWSS3: <p>AWS S3 对象存储的配置信息,不填保持原有配置。</p>
52091
+ :type AWSS3: :class:`tencentcloud.teo.v20220901.models.AWSS3`
51809
52092
  """
51810
52093
  self._ZoneId = None
51811
52094
  self._TaskId = None
@@ -51820,6 +52103,7 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51820
52103
  self._LogFormat = None
51821
52104
  self._CustomEndpoint = None
51822
52105
  self._S3 = None
52106
+ self._AWSS3 = None
51823
52107
 
51824
52108
  @property
51825
52109
  def ZoneId(self):
@@ -51889,7 +52173,7 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51889
52173
 
51890
52174
  @property
51891
52175
  def CustomFields(self):
51892
- r"""<p>投递的自定义日志字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,详见 <a href="">自定义日志字段表达式</a>。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段,允许配置的自定义字段个数有配额限制,如遇配额不足请 <a href="https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE">联系我们</a> 。</p>
52176
+ r"""<p>投递的自定义字段列表,支持在 HTTP 请求头、响应头、Cookie、请求正文中提取指定内容。<br>自定义字段名称不能重复,仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE)。</p>
51893
52177
  :rtype: list of CustomField
51894
52178
  """
51895
52179
  return self._CustomFields
@@ -51900,7 +52184,7 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51900
52184
 
51901
52185
  @property
51902
52186
  def CustomExpressionFields(self):
51903
- r"""<p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式]()。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
52187
+ r"""<p>投递的自定义表达式字段列表,可以通过自定义日志推送字段名称和取值表达式,实现个性化的实时日志内容推送,使用详情见 [自定义日志字段表达式](https://cloud.tencent.com/document/product/1552/105794)。<br>仅七层访问日志(LogType= l7-access-logs 或 domain)支持添加自定义字段。<br>允许配置的自定义字段个数有配额限制,如遇配额不足请 [联系我们](https://cloud.tencent.com/online-service?from=sales&amp;source=PRESALE) 。<br>**注意**:若 CustomExpressionFields 中存在命名 与 Fields 和 CustomFields 中同名的字段,以 CustomExpressionFields 中的取值为准。</p>
51904
52188
  :rtype: list of CustomExpressionField
51905
52189
  """
51906
52190
  return self._CustomExpressionFields
@@ -51955,7 +52239,7 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51955
52239
 
51956
52240
  @property
51957
52241
  def S3(self):
51958
- r"""<p>AWS S3 兼容存储桶的配置信息,不填保持原有配置。</p>
52242
+ r"""<p>S3 兼容(兼容 SigV4 鉴权算法)的对象存储的配置信息,不填保持原有配置。</p>
51959
52243
  :rtype: :class:`tencentcloud.teo.v20220901.models.S3`
51960
52244
  """
51961
52245
  return self._S3
@@ -51964,6 +52248,17 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
51964
52248
  def S3(self, S3):
51965
52249
  self._S3 = S3
51966
52250
 
52251
+ @property
52252
+ def AWSS3(self):
52253
+ r"""<p>AWS S3 对象存储的配置信息,不填保持原有配置。</p>
52254
+ :rtype: :class:`tencentcloud.teo.v20220901.models.AWSS3`
52255
+ """
52256
+ return self._AWSS3
52257
+
52258
+ @AWSS3.setter
52259
+ def AWSS3(self, AWSS3):
52260
+ self._AWSS3 = AWSS3
52261
+
51967
52262
 
51968
52263
  def _deserialize(self, params):
51969
52264
  self._ZoneId = params.get("ZoneId")
@@ -52000,6 +52295,9 @@ class ModifyRealtimeLogDeliveryTaskRequest(AbstractModel):
52000
52295
  if params.get("S3") is not None:
52001
52296
  self._S3 = S3()
52002
52297
  self._S3._deserialize(params.get("S3"))
52298
+ if params.get("AWSS3") is not None:
52299
+ self._AWSS3 = AWSS3()
52300
+ self._AWSS3._deserialize(params.get("AWSS3"))
52003
52301
  memeber_set = set(params.keys())
52004
52302
  for name, value in vars(self).items():
52005
52303
  property_name = name[1:]
@@ -59794,7 +60092,7 @@ class RealtimeLogDeliveryTask(AbstractModel):
59794
60092
  :type TaskName: str
59795
60093
  :param _DeliveryStatus: <p>实时日志投递任务的状态,取值有: <li>enabled: 已启用;</li> <li>disabled: 已停用;</li><li>deleted: 异常删除状态,请检查目的地腾讯云 CLS 日志集/日志主题是否已被删除。</li></p>
59796
60094
  :type DeliveryStatus: str
59797
- :param _TaskType: <p>实时日志投递任务类型,取值有: <ul><li>cls: 推送到腾讯云 CLS;</li> <li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li> <li>s3:推送到 S3 兼容(兼容 SigV4 鉴权算法)的对象存储的地址;</li><li>log_analysis:推送到 EdgeOne 日志分析。</li></ul></p>
60095
+ :param _TaskType: <p>实时日志投递任务类型,取值有: <ul><li>cls: 推送到腾讯云 CLS;</li> <li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li> <li>s3:推送到 S3 兼容(兼容 SigV4 鉴权算法)的对象存储的地址;</li><li>aws_s3:推送到 AWS S3 存储桶地址;</li><li>log_analysis:推送到 EdgeOne 日志分析。</li></ul></p>
59798
60096
  :type TaskType: str
59799
60097
  :param _EntityList: <p>实时日志投递任务对应的实体(七层域名或者四层代理实例)列表。取值示例如下: <li>七层域名:domain.example.com;</li> <li>四层代理实例:sid-2s69eb5wcms7。</li></p>
59800
60098
  :type EntityList: list of str
@@ -59824,6 +60122,9 @@ class RealtimeLogDeliveryTask(AbstractModel):
59824
60122
  :param _S3: <p>S3 兼容(兼容 SigV4 鉴权算法)的对象存储的配置信息。</p>
59825
60123
  注意:此字段可能返回 null,表示取不到有效值。
59826
60124
  :type S3: :class:`tencentcloud.teo.v20220901.models.S3`
60125
+ :param _AWSS3: <p>AWS S3 的对象存储的配置信息,使用 IAM 角色授权,免长期密钥,仅适用于 AWS 原生 S3 。</p>
60126
+ 注意:此字段可能返回 null,表示取不到有效值。
60127
+ :type AWSS3: :class:`tencentcloud.teo.v20220901.models.AWSS3`
59827
60128
  :param _CreateTime: <p>创建时间。</p>
59828
60129
  :type CreateTime: str
59829
60130
  :param _UpdateTime: <p>更新时间。</p>
@@ -59845,6 +60146,7 @@ class RealtimeLogDeliveryTask(AbstractModel):
59845
60146
  self._CLS = None
59846
60147
  self._CustomEndpoint = None
59847
60148
  self._S3 = None
60149
+ self._AWSS3 = None
59848
60150
  self._CreateTime = None
59849
60151
  self._UpdateTime = None
59850
60152
 
@@ -59883,7 +60185,7 @@ class RealtimeLogDeliveryTask(AbstractModel):
59883
60185
 
59884
60186
  @property
59885
60187
  def TaskType(self):
59886
- r"""<p>实时日志投递任务类型,取值有: <ul><li>cls: 推送到腾讯云 CLS;</li> <li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li> <li>s3:推送到 S3 兼容(兼容 SigV4 鉴权算法)的对象存储的地址;</li><li>log_analysis:推送到 EdgeOne 日志分析。</li></ul></p>
60188
+ r"""<p>实时日志投递任务类型,取值有: <ul><li>cls: 推送到腾讯云 CLS;</li> <li>custom_endpoint:推送到自定义 HTTP(S) 地址;</li> <li>s3:推送到 S3 兼容(兼容 SigV4 鉴权算法)的对象存储的地址;</li><li>aws_s3:推送到 AWS S3 存储桶地址;</li><li>log_analysis:推送到 EdgeOne 日志分析。</li></ul></p>
59887
60189
  :rtype: str
59888
60190
  """
59889
60191
  return self._TaskType
@@ -60028,6 +60330,18 @@ class RealtimeLogDeliveryTask(AbstractModel):
60028
60330
  def S3(self, S3):
60029
60331
  self._S3 = S3
60030
60332
 
60333
+ @property
60334
+ def AWSS3(self):
60335
+ r"""<p>AWS S3 的对象存储的配置信息,使用 IAM 角色授权,免长期密钥,仅适用于 AWS 原生 S3 。</p>
60336
+ 注意:此字段可能返回 null,表示取不到有效值。
60337
+ :rtype: :class:`tencentcloud.teo.v20220901.models.AWSS3`
60338
+ """
60339
+ return self._AWSS3
60340
+
60341
+ @AWSS3.setter
60342
+ def AWSS3(self, AWSS3):
60343
+ self._AWSS3 = AWSS3
60344
+
60031
60345
  @property
60032
60346
  def CreateTime(self):
60033
60347
  r"""<p>创建时间。</p>
@@ -60091,6 +60405,9 @@ class RealtimeLogDeliveryTask(AbstractModel):
60091
60405
  if params.get("S3") is not None:
60092
60406
  self._S3 = S3()
60093
60407
  self._S3._deserialize(params.get("S3"))
60408
+ if params.get("AWSS3") is not None:
60409
+ self._AWSS3 = AWSS3()
60410
+ self._AWSS3._deserialize(params.get("AWSS3"))
60094
60411
  self._CreateTime = params.get("CreateTime")
60095
60412
  self._UpdateTime = params.get("UpdateTime")
60096
60413
  memeber_set = set(params.keys())
@@ -66317,6 +66634,42 @@ class StandardDebugParameters(AbstractModel):
66317
66634
 
66318
66635
 
66319
66636
 
66637
+ class StatisticsRecord(AbstractModel):
66638
+ r"""统计结果行。
66639
+
66640
+ """
66641
+
66642
+ def __init__(self):
66643
+ r"""
66644
+ :param _Record: <p>列表单行记录。</p>
66645
+ :type Record: list of str
66646
+ """
66647
+ self._Record = None
66648
+
66649
+ @property
66650
+ def Record(self):
66651
+ r"""<p>列表单行记录。</p>
66652
+ :rtype: list of str
66653
+ """
66654
+ return self._Record
66655
+
66656
+ @Record.setter
66657
+ def Record(self, Record):
66658
+ self._Record = Record
66659
+
66660
+
66661
+ def _deserialize(self, params):
66662
+ self._Record = params.get("Record")
66663
+ memeber_set = set(params.keys())
66664
+ for name, value in vars(self).items():
66665
+ property_name = name[1:]
66666
+ if property_name in memeber_set:
66667
+ memeber_set.remove(property_name)
66668
+ if len(memeber_set) > 0:
66669
+ warnings.warn("%s fileds are useless." % ",".join(memeber_set))
66670
+
66671
+
66672
+
66320
66673
  class StatusCodeCacheParam(AbstractModel):
66321
66674
  r"""状态码缓存 TTL 配置参数内部结构。
66322
66675
 
@@ -930,14 +930,22 @@ class TeoClient(AbstractClient):
930
930
 
931
931
 
932
932
  def CreateRealtimeLogDeliveryTask(self, request):
933
- r"""本接口用于创建实时日志投递任务。本接口有如下限制:
934
- - 当数据投递类型(LogType)为七层访问日志、四层代理日志、边缘函数运行日志时,同一个实体(七层域名、四层代理实例、边缘函数实例)在同种数据投递类型(LogType)和数据投递区域(Area)的组合下,只能被添加到如下实时日志投递任务类型(TaskType)组合中:
935
- - 一个推送至腾讯云 CLS 的任务,加上另一个推送至自定义 HTTP(S) 地址的任务;
936
- - 一个推送至腾讯云 CLS 的任务,加上另一个推送至 AWS S3 兼容对象存储的任务;
937
- - 当数据投递类型(LogType)为速率限制和 CC 攻击防护日志、托管规则日志、自定义规则日志、Bot 管理日志时,同一个实体在同种数据投递类型(LogType)和数据投递区域(Area)的组合下,只能被添加到一个实时日志投递任务中。
938
- - 当实时日志投递任务类型(TaskType)为 EdgeOne 日志分析(log_analysis)时,只支持数据投递类型(LogType)为七层访问日志(l7-access-logs)或托管规则日志(web-attack);在同一站点(ZoneId)、同一数据投递区域(Area)和数据的组合下,每种数据投递类型(LogType)只能添加一个推送至 EdgeOne 日志分析的实时日志投递任务。
933
+ r"""本接口用于创建实时日志投递任务。
939
934
 
940
- 建议先通过 [DescribeRealtimeLogDeliveryTasks](https://cloud.tencent.com/document/product/1552/104110) 接口根据实体查询实时日志投递任务列表,检查实体是否已经被添加到另一实时日志投递任务中。
935
+ **限制规则**
936
+
937
+ 同一实体(七层域名、四层代理实例、边缘函数实例)在同一 `LogType` + `Area` 组合下,每种 `TaskType` 仅允许创建一个任务。不同 `LogType` 的互斥规则如下:
938
+
939
+ | LogType | 互斥的 TaskType |
940
+ | --- | --- |
941
+ | 四层代理日志、边缘函数运行日志 | `custom_endpoint`、`s3`、`aws_s3` 三选一 |
942
+
943
+ 当 `TaskType` 为 `log_analysis` 时:
944
+
945
+ - 仅支持 `LogType` 为 `l7-access-logs` 或 `web-attack`。
946
+ - 同一 `ZoneId` + `Area` 下,每种 `LogType` 仅允许创建一个任务。
947
+
948
+ **建议**:创建前先通过 [DescribeRealtimeLogDeliveryTasks](https://cloud.tencent.com/document/product/1552/104110) 接口查询已有任务,避免重复添加。
941
949
 
942
950
  :param request: Request instance for CreateRealtimeLogDeliveryTask.
943
951
  :type request: :class:`tencentcloud.teo.v20220901.models.CreateRealtimeLogDeliveryTaskRequest`
@@ -2938,6 +2946,29 @@ class TeoClient(AbstractClient):
2938
2946
  raise TencentCloudSDKException(type(e).__name__, str(e))
2939
2947
 
2940
2948
 
2949
+ def DescribeLogAnalysisStatistics(self, request):
2950
+ r"""本接口用于日志分析统计结果查询。用户在检索语句后追加 SQL 聚合语句([检索条件] | [SQL语句]),后端执行聚合并返回列式统计结果(列定义 + 数据行)。
2951
+
2952
+ :param request: Request instance for DescribeLogAnalysisStatistics.
2953
+ :type request: :class:`tencentcloud.teo.v20220901.models.DescribeLogAnalysisStatisticsRequest`
2954
+ :rtype: :class:`tencentcloud.teo.v20220901.models.DescribeLogAnalysisStatisticsResponse`
2955
+
2956
+ """
2957
+ try:
2958
+ params = request._serialize()
2959
+ headers = request.headers
2960
+ body = self.call("DescribeLogAnalysisStatistics", params, headers=headers)
2961
+ response = json.loads(body)
2962
+ model = models.DescribeLogAnalysisStatisticsResponse()
2963
+ model._deserialize(response["Response"])
2964
+ return model
2965
+ except Exception as e:
2966
+ if isinstance(e, TencentCloudSDKException):
2967
+ raise
2968
+ else:
2969
+ raise TencentCloudSDKException(type(e).__name__, str(e))
2970
+
2971
+
2941
2972
  def DescribeMultiPathGateway(self, request):
2942
2973
  r"""通过本接口查询多通道安全加速网关详情。如名称、网关 ID、IP、端口、类型等。
2943
2974
 
@@ -744,14 +744,22 @@ class TeoClient(AbstractClient):
744
744
  opts: Dict = None,
745
745
  ) -> models.CreateRealtimeLogDeliveryTaskResponse:
746
746
  """
747
- 本接口用于创建实时日志投递任务。本接口有如下限制:
748
- - 当数据投递类型(LogType)为七层访问日志、四层代理日志、边缘函数运行日志时,同一个实体(七层域名、四层代理实例、边缘函数实例)在同种数据投递类型(LogType)和数据投递区域(Area)的组合下,只能被添加到如下实时日志投递任务类型(TaskType)组合中:
749
- - 一个推送至腾讯云 CLS 的任务,加上另一个推送至自定义 HTTP(S) 地址的任务;
750
- - 一个推送至腾讯云 CLS 的任务,加上另一个推送至 AWS S3 兼容对象存储的任务;
751
- - 当数据投递类型(LogType)为速率限制和 CC 攻击防护日志、托管规则日志、自定义规则日志、Bot 管理日志时,同一个实体在同种数据投递类型(LogType)和数据投递区域(Area)的组合下,只能被添加到一个实时日志投递任务中。
752
- - 当实时日志投递任务类型(TaskType)为 EdgeOne 日志分析(log_analysis)时,只支持数据投递类型(LogType)为七层访问日志(l7-access-logs)或托管规则日志(web-attack);在同一站点(ZoneId)、同一数据投递区域(Area)和数据的组合下,每种数据投递类型(LogType)只能添加一个推送至 EdgeOne 日志分析的实时日志投递任务。
747
+ 本接口用于创建实时日志投递任务。
753
748
 
754
- 建议先通过 [DescribeRealtimeLogDeliveryTasks](https://cloud.tencent.com/document/product/1552/104110) 接口根据实体查询实时日志投递任务列表,检查实体是否已经被添加到另一实时日志投递任务中。
749
+ **限制规则**
750
+
751
+ 同一实体(七层域名、四层代理实例、边缘函数实例)在同一 `LogType` + `Area` 组合下,每种 `TaskType` 仅允许创建一个任务。不同 `LogType` 的互斥规则如下:
752
+
753
+ | LogType | 互斥的 TaskType |
754
+ | --- | --- |
755
+ | 四层代理日志、边缘函数运行日志 | `custom_endpoint`、`s3`、`aws_s3` 三选一 |
756
+
757
+ 当 `TaskType` 为 `log_analysis` 时:
758
+
759
+ - 仅支持 `LogType` 为 `l7-access-logs` 或 `web-attack`。
760
+ - 同一 `ZoneId` + `Area` 下,每种 `LogType` 仅允许创建一个任务。
761
+
762
+ **建议**:创建前先通过 [DescribeRealtimeLogDeliveryTasks](https://cloud.tencent.com/document/product/1552/104110) 接口查询已有任务,避免重复添加。
755
763
  """
756
764
 
757
765
  kwargs = {}
@@ -2317,6 +2325,24 @@ class TeoClient(AbstractClient):
2317
2325
 
2318
2326
  return await self.call_and_deserialize(**kwargs)
2319
2327
 
2328
+ async def DescribeLogAnalysisStatistics(
2329
+ self,
2330
+ request: models.DescribeLogAnalysisStatisticsRequest,
2331
+ opts: Dict = None,
2332
+ ) -> models.DescribeLogAnalysisStatisticsResponse:
2333
+ """
2334
+ 本接口用于日志分析统计结果查询。用户在检索语句后追加 SQL 聚合语句([检索条件] | [SQL语句]),后端执行聚合并返回列式统计结果(列定义 + 数据行)。
2335
+ """
2336
+
2337
+ kwargs = {}
2338
+ kwargs["action"] = "DescribeLogAnalysisStatistics"
2339
+ kwargs["params"] = request._serialize()
2340
+ kwargs["resp_cls"] = models.DescribeLogAnalysisStatisticsResponse
2341
+ kwargs["headers"] = request.headers
2342
+ kwargs["opts"] = opts or {}
2343
+
2344
+ return await self.call_and_deserialize(**kwargs)
2345
+
2320
2346
  async def DescribeMultiPathGateway(
2321
2347
  self,
2322
2348
  request: models.DescribeMultiPathGatewayRequest,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: tencentcloud-sdk-python-teo
3
- Version: 3.1.189
3
+ Version: 3.1.193
4
4
  Summary: Tencent Cloud Teo SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
15
15
  Classifier: Programming Language :: Python :: 3
16
16
  Classifier: Programming Language :: Python :: 3.6
17
17
  Classifier: Programming Language :: Python :: 3.7
18
- Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.189
18
+ Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.193
19
19
 
20
20
  ============================
21
21
  Tencent Cloud SDK for Python
@@ -0,0 +1 @@
1
+ tencentcloud-sdk-python-common<4.0.0,>=3.1.193
@@ -1 +0,0 @@
1
- tencentcloud-sdk-python-common<4.0.0,>=3.1.189