alibabacloud-sls20201230 5.4.0__py3-none-any.whl → 5.5.0__py3-none-any.whl

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.
@@ -1081,12 +1081,20 @@ class Client(OpenApiClient):
1081
1081
  runtime: util_models.RuntimeOptions,
1082
1082
  ) -> sls_20201230_models.CreateConsumerGroupResponse:
1083
1083
  """
1084
- @summary Creates a consumer group for a specified Logstore.
1084
+ @summary Creates a consumer group for a Logstore.
1085
1085
 
1086
1086
  @description ### Usage notes
1087
1087
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
1088
- You can create up to 30 consumer groups for a Logstore.
1089
- Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDKs for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1088
+ You can create up to 30 consumer groups for a Logstore. The name of a consumer group must be unique in a project.
1089
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
1090
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
1091
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
1092
+ Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDK for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1093
+ ### Authentication resources
1094
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
1095
+ |Action|Resource|
1096
+ |:---|:---|
1097
+ |`log:CreateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
1090
1098
 
1091
1099
  @param request: CreateConsumerGroupRequest
1092
1100
  @param headers: map
@@ -1133,12 +1141,20 @@ class Client(OpenApiClient):
1133
1141
  runtime: util_models.RuntimeOptions,
1134
1142
  ) -> sls_20201230_models.CreateConsumerGroupResponse:
1135
1143
  """
1136
- @summary Creates a consumer group for a specified Logstore.
1144
+ @summary Creates a consumer group for a Logstore.
1137
1145
 
1138
1146
  @description ### Usage notes
1139
1147
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
1140
- You can create up to 30 consumer groups for a Logstore.
1141
- Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDKs for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1148
+ You can create up to 30 consumer groups for a Logstore. The name of a consumer group must be unique in a project.
1149
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
1150
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
1151
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
1152
+ Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDK for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1153
+ ### Authentication resources
1154
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
1155
+ |Action|Resource|
1156
+ |:---|:---|
1157
+ |`log:CreateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
1142
1158
 
1143
1159
  @param request: CreateConsumerGroupRequest
1144
1160
  @param headers: map
@@ -1183,12 +1199,20 @@ class Client(OpenApiClient):
1183
1199
  request: sls_20201230_models.CreateConsumerGroupRequest,
1184
1200
  ) -> sls_20201230_models.CreateConsumerGroupResponse:
1185
1201
  """
1186
- @summary Creates a consumer group for a specified Logstore.
1202
+ @summary Creates a consumer group for a Logstore.
1187
1203
 
1188
1204
  @description ### Usage notes
1189
1205
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
1190
- You can create up to 30 consumer groups for a Logstore.
1191
- Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDKs for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1206
+ You can create up to 30 consumer groups for a Logstore. The name of a consumer group must be unique in a project.
1207
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
1208
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
1209
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
1210
+ Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDK for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1211
+ ### Authentication resources
1212
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
1213
+ |Action|Resource|
1214
+ |:---|:---|
1215
+ |`log:CreateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
1192
1216
 
1193
1217
  @param request: CreateConsumerGroupRequest
1194
1218
  @return: CreateConsumerGroupResponse
@@ -1204,12 +1228,20 @@ class Client(OpenApiClient):
1204
1228
  request: sls_20201230_models.CreateConsumerGroupRequest,
1205
1229
  ) -> sls_20201230_models.CreateConsumerGroupResponse:
1206
1230
  """
1207
- @summary Creates a consumer group for a specified Logstore.
1231
+ @summary Creates a consumer group for a Logstore.
1208
1232
 
1209
1233
  @description ### Usage notes
1210
1234
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
1211
- You can create up to 30 consumer groups for a Logstore.
1212
- Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDKs for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1235
+ You can create up to 30 consumer groups for a Logstore. The name of a consumer group must be unique in a project.
1236
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
1237
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
1238
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
1239
+ Simple Log Service provides examples of both regular log consumption and consumer group-based log consumption by using Simple Log Service SDK for Java. For more information, see [Consume log data](https://help.aliyun.com/document_detail/120035.html) and [Use consumer groups to consume data](https://help.aliyun.com/document_detail/28998.html).
1240
+ ### Authentication resources
1241
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
1242
+ |Action|Resource|
1243
+ |:---|:---|
1244
+ |`log:CreateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
1213
1245
 
1214
1246
  @param request: CreateConsumerGroupRequest
1215
1247
  @return: CreateConsumerGroupResponse
@@ -1745,25 +1777,10 @@ class Client(OpenApiClient):
1745
1777
  UtilClient.validate_model(request)
1746
1778
  host_map = {}
1747
1779
  host_map['project'] = project
1748
- body = {}
1749
- if not UtilClient.is_unset(request.keys):
1750
- body['keys'] = request.keys
1751
- if not UtilClient.is_unset(request.line):
1752
- body['line'] = request.line
1753
- if not UtilClient.is_unset(request.log_reduce):
1754
- body['log_reduce'] = request.log_reduce
1755
- if not UtilClient.is_unset(request.log_reduce_black_list):
1756
- body['log_reduce_black_list'] = request.log_reduce_black_list
1757
- if not UtilClient.is_unset(request.log_reduce_white_list):
1758
- body['log_reduce_white_list'] = request.log_reduce_white_list
1759
- if not UtilClient.is_unset(request.max_text_len):
1760
- body['max_text_len'] = request.max_text_len
1761
- if not UtilClient.is_unset(request.ttl):
1762
- body['ttl'] = request.ttl
1763
1780
  req = open_api_models.OpenApiRequest(
1764
1781
  host_map=host_map,
1765
1782
  headers=headers,
1766
- body=OpenApiUtilClient.parse_to_map(body)
1783
+ body=OpenApiUtilClient.parse_to_map(request.body)
1767
1784
  )
1768
1785
  params = open_api_models.Params(
1769
1786
  action='CreateIndex',
@@ -1802,25 +1819,10 @@ class Client(OpenApiClient):
1802
1819
  UtilClient.validate_model(request)
1803
1820
  host_map = {}
1804
1821
  host_map['project'] = project
1805
- body = {}
1806
- if not UtilClient.is_unset(request.keys):
1807
- body['keys'] = request.keys
1808
- if not UtilClient.is_unset(request.line):
1809
- body['line'] = request.line
1810
- if not UtilClient.is_unset(request.log_reduce):
1811
- body['log_reduce'] = request.log_reduce
1812
- if not UtilClient.is_unset(request.log_reduce_black_list):
1813
- body['log_reduce_black_list'] = request.log_reduce_black_list
1814
- if not UtilClient.is_unset(request.log_reduce_white_list):
1815
- body['log_reduce_white_list'] = request.log_reduce_white_list
1816
- if not UtilClient.is_unset(request.max_text_len):
1817
- body['max_text_len'] = request.max_text_len
1818
- if not UtilClient.is_unset(request.ttl):
1819
- body['ttl'] = request.ttl
1820
1822
  req = open_api_models.OpenApiRequest(
1821
1823
  host_map=host_map,
1822
1824
  headers=headers,
1823
- body=OpenApiUtilClient.parse_to_map(body)
1825
+ body=OpenApiUtilClient.parse_to_map(request.body)
1824
1826
  )
1825
1827
  params = open_api_models.Params(
1826
1828
  action='CreateIndex',
@@ -2510,7 +2512,15 @@ class Client(OpenApiClient):
2510
2512
  runtime: util_models.RuntimeOptions,
2511
2513
  ) -> sls_20201230_models.CreateMetricStoreResponse:
2512
2514
  """
2513
- @summary 创建时序库
2515
+ @summary Creates a Metricstore to store metric data.
2516
+
2517
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
2518
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
2519
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
2520
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
2521
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
2522
+ You can create up to 200 Logstores or Metricstores in a project.
2523
+ Metric data is automatically deleted when the retention period of the metric data ends.
2514
2524
 
2515
2525
  @param request: CreateMetricStoreRequest
2516
2526
  @param headers: map
@@ -2564,7 +2574,15 @@ class Client(OpenApiClient):
2564
2574
  runtime: util_models.RuntimeOptions,
2565
2575
  ) -> sls_20201230_models.CreateMetricStoreResponse:
2566
2576
  """
2567
- @summary 创建时序库
2577
+ @summary Creates a Metricstore to store metric data.
2578
+
2579
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
2580
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
2581
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
2582
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
2583
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
2584
+ You can create up to 200 Logstores or Metricstores in a project.
2585
+ Metric data is automatically deleted when the retention period of the metric data ends.
2568
2586
 
2569
2587
  @param request: CreateMetricStoreRequest
2570
2588
  @param headers: map
@@ -2616,7 +2634,15 @@ class Client(OpenApiClient):
2616
2634
  request: sls_20201230_models.CreateMetricStoreRequest,
2617
2635
  ) -> sls_20201230_models.CreateMetricStoreResponse:
2618
2636
  """
2619
- @summary 创建时序库
2637
+ @summary Creates a Metricstore to store metric data.
2638
+
2639
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
2640
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
2641
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
2642
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
2643
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
2644
+ You can create up to 200 Logstores or Metricstores in a project.
2645
+ Metric data is automatically deleted when the retention period of the metric data ends.
2620
2646
 
2621
2647
  @param request: CreateMetricStoreRequest
2622
2648
  @return: CreateMetricStoreResponse
@@ -2631,7 +2657,15 @@ class Client(OpenApiClient):
2631
2657
  request: sls_20201230_models.CreateMetricStoreRequest,
2632
2658
  ) -> sls_20201230_models.CreateMetricStoreResponse:
2633
2659
  """
2634
- @summary 创建时序库
2660
+ @summary Creates a Metricstore to store metric data.
2661
+
2662
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
2663
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
2664
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
2665
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
2666
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
2667
+ You can create up to 200 Logstores or Metricstores in a project.
2668
+ Metric data is automatically deleted when the retention period of the metric data ends.
2635
2669
 
2636
2670
  @param request: CreateMetricStoreRequest
2637
2671
  @return: CreateMetricStoreResponse
@@ -2774,7 +2808,7 @@ class Client(OpenApiClient):
2774
2808
  runtime: util_models.RuntimeOptions,
2775
2809
  ) -> sls_20201230_models.CreateOSSHDFSExportResponse:
2776
2810
  """
2777
- @summary 创建OSSHDFS投递任务
2811
+ @summary Creates an OSS-HDFS data shipping job in a project.
2778
2812
 
2779
2813
  @param request: CreateOSSHDFSExportRequest
2780
2814
  @param headers: map
@@ -2822,7 +2856,7 @@ class Client(OpenApiClient):
2822
2856
  runtime: util_models.RuntimeOptions,
2823
2857
  ) -> sls_20201230_models.CreateOSSHDFSExportResponse:
2824
2858
  """
2825
- @summary 创建OSSHDFS投递任务
2859
+ @summary Creates an OSS-HDFS data shipping job in a project.
2826
2860
 
2827
2861
  @param request: CreateOSSHDFSExportRequest
2828
2862
  @param headers: map
@@ -2868,7 +2902,7 @@ class Client(OpenApiClient):
2868
2902
  request: sls_20201230_models.CreateOSSHDFSExportRequest,
2869
2903
  ) -> sls_20201230_models.CreateOSSHDFSExportResponse:
2870
2904
  """
2871
- @summary 创建OSSHDFS投递任务
2905
+ @summary Creates an OSS-HDFS data shipping job in a project.
2872
2906
 
2873
2907
  @param request: CreateOSSHDFSExportRequest
2874
2908
  @return: CreateOSSHDFSExportResponse
@@ -2883,7 +2917,7 @@ class Client(OpenApiClient):
2883
2917
  request: sls_20201230_models.CreateOSSHDFSExportRequest,
2884
2918
  ) -> sls_20201230_models.CreateOSSHDFSExportResponse:
2885
2919
  """
2886
- @summary 创建OSSHDFS投递任务
2920
+ @summary Creates an OSS-HDFS data shipping job in a project.
2887
2921
 
2888
2922
  @param request: CreateOSSHDFSExportRequest
2889
2923
  @return: CreateOSSHDFSExportResponse
@@ -3929,7 +3963,7 @@ class Client(OpenApiClient):
3929
3963
  runtime: util_models.RuntimeOptions,
3930
3964
  ) -> sls_20201230_models.CreateTicketResponse:
3931
3965
  """
3932
- @summary 创建Ticket
3966
+ @summary Creates a ticket to enable logon-free access to the Simple Log Service console or embed console pages into a third-party system.
3933
3967
 
3934
3968
  @param request: CreateTicketRequest
3935
3969
  @param headers: map
@@ -3969,7 +4003,7 @@ class Client(OpenApiClient):
3969
4003
  runtime: util_models.RuntimeOptions,
3970
4004
  ) -> sls_20201230_models.CreateTicketResponse:
3971
4005
  """
3972
- @summary 创建Ticket
4006
+ @summary Creates a ticket to enable logon-free access to the Simple Log Service console or embed console pages into a third-party system.
3973
4007
 
3974
4008
  @param request: CreateTicketRequest
3975
4009
  @param headers: map
@@ -4007,7 +4041,7 @@ class Client(OpenApiClient):
4007
4041
  request: sls_20201230_models.CreateTicketRequest,
4008
4042
  ) -> sls_20201230_models.CreateTicketResponse:
4009
4043
  """
4010
- @summary 创建Ticket
4044
+ @summary Creates a ticket to enable logon-free access to the Simple Log Service console or embed console pages into a third-party system.
4011
4045
 
4012
4046
  @param request: CreateTicketRequest
4013
4047
  @return: CreateTicketResponse
@@ -4021,7 +4055,7 @@ class Client(OpenApiClient):
4021
4055
  request: sls_20201230_models.CreateTicketRequest,
4022
4056
  ) -> sls_20201230_models.CreateTicketResponse:
4023
4057
  """
4024
- @summary 创建Ticket
4058
+ @summary Creates a ticket to enable logon-free access to the Simple Log Service console or embed console pages into a third-party system.
4025
4059
 
4026
4060
  @param request: CreateTicketRequest
4027
4061
  @return: CreateTicketResponse
@@ -4428,7 +4462,7 @@ class Client(OpenApiClient):
4428
4462
  runtime: util_models.RuntimeOptions,
4429
4463
  ) -> sls_20201230_models.DeleteCollectionPolicyResponse:
4430
4464
  """
4431
- @summary 通过调用DeleteCollectionPolicy删除配置的日志采集规则
4465
+ @summary Deletes a log collection policy from a cloud service.
4432
4466
 
4433
4467
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
4434
4468
 
@@ -4471,7 +4505,7 @@ class Client(OpenApiClient):
4471
4505
  runtime: util_models.RuntimeOptions,
4472
4506
  ) -> sls_20201230_models.DeleteCollectionPolicyResponse:
4473
4507
  """
4474
- @summary 通过调用DeleteCollectionPolicy删除配置的日志采集规则
4508
+ @summary Deletes a log collection policy from a cloud service.
4475
4509
 
4476
4510
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
4477
4511
 
@@ -4512,7 +4546,7 @@ class Client(OpenApiClient):
4512
4546
  request: sls_20201230_models.DeleteCollectionPolicyRequest,
4513
4547
  ) -> sls_20201230_models.DeleteCollectionPolicyResponse:
4514
4548
  """
4515
- @summary 通过调用DeleteCollectionPolicy删除配置的日志采集规则
4549
+ @summary Deletes a log collection policy from a cloud service.
4516
4550
 
4517
4551
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
4518
4552
 
@@ -4529,7 +4563,7 @@ class Client(OpenApiClient):
4529
4563
  request: sls_20201230_models.DeleteCollectionPolicyRequest,
4530
4564
  ) -> sls_20201230_models.DeleteCollectionPolicyResponse:
4531
4565
  """
4532
- @summary 通过调用DeleteCollectionPolicy删除配置的日志采集规则
4566
+ @summary Deletes a log collection policy from a cloud service.
4533
4567
 
4534
4568
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
4535
4569
 
@@ -5064,7 +5098,7 @@ class Client(OpenApiClient):
5064
5098
  runtime: util_models.RuntimeOptions,
5065
5099
  ) -> sls_20201230_models.DeleteDownloadJobResponse:
5066
5100
  """
5067
- @summary 删除下载任务
5101
+ @summary Deletes a download task.
5068
5102
 
5069
5103
  @param headers: map
5070
5104
  @param runtime: runtime options for this request RuntimeOptions
@@ -5100,7 +5134,7 @@ class Client(OpenApiClient):
5100
5134
  runtime: util_models.RuntimeOptions,
5101
5135
  ) -> sls_20201230_models.DeleteDownloadJobResponse:
5102
5136
  """
5103
- @summary 删除下载任务
5137
+ @summary Deletes a download task.
5104
5138
 
5105
5139
  @param headers: map
5106
5140
  @param runtime: runtime options for this request RuntimeOptions
@@ -5134,7 +5168,7 @@ class Client(OpenApiClient):
5134
5168
  download_job_name: str,
5135
5169
  ) -> sls_20201230_models.DeleteDownloadJobResponse:
5136
5170
  """
5137
- @summary 删除下载任务
5171
+ @summary Deletes a download task.
5138
5172
 
5139
5173
  @return: DeleteDownloadJobResponse
5140
5174
  """
@@ -5148,7 +5182,7 @@ class Client(OpenApiClient):
5148
5182
  download_job_name: str,
5149
5183
  ) -> sls_20201230_models.DeleteDownloadJobResponse:
5150
5184
  """
5151
- @summary 删除下载任务
5185
+ @summary Deletes a download task.
5152
5186
 
5153
5187
  @return: DeleteDownloadJobResponse
5154
5188
  """
@@ -5912,7 +5946,16 @@ class Client(OpenApiClient):
5912
5946
  runtime: util_models.RuntimeOptions,
5913
5947
  ) -> sls_20201230_models.DeleteMetricStoreResponse:
5914
5948
  """
5915
- @summary 删除时序库
5949
+ @summary Deletes an existing Metricstore. When you delete a Metricstore, the metric data stored in the Metricstore and associated resources such as associated collection settings and transformation settings are also deleted.
5950
+
5951
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
5952
+ You must specify an existing Metricstore.
5953
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
5954
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
5955
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
5956
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
5957
+ You can create up to 200 Logstores or Metricstores in a project.
5958
+ Metric data is automatically deleted when the retention period of the metric data ends.
5916
5959
 
5917
5960
  @param headers: map
5918
5961
  @param runtime: runtime options for this request RuntimeOptions
@@ -5948,7 +5991,16 @@ class Client(OpenApiClient):
5948
5991
  runtime: util_models.RuntimeOptions,
5949
5992
  ) -> sls_20201230_models.DeleteMetricStoreResponse:
5950
5993
  """
5951
- @summary 删除时序库
5994
+ @summary Deletes an existing Metricstore. When you delete a Metricstore, the metric data stored in the Metricstore and associated resources such as associated collection settings and transformation settings are also deleted.
5995
+
5996
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
5997
+ You must specify an existing Metricstore.
5998
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
5999
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6000
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6001
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
6002
+ You can create up to 200 Logstores or Metricstores in a project.
6003
+ Metric data is automatically deleted when the retention period of the metric data ends.
5952
6004
 
5953
6005
  @param headers: map
5954
6006
  @param runtime: runtime options for this request RuntimeOptions
@@ -5982,7 +6034,16 @@ class Client(OpenApiClient):
5982
6034
  name: str,
5983
6035
  ) -> sls_20201230_models.DeleteMetricStoreResponse:
5984
6036
  """
5985
- @summary 删除时序库
6037
+ @summary Deletes an existing Metricstore. When you delete a Metricstore, the metric data stored in the Metricstore and associated resources such as associated collection settings and transformation settings are also deleted.
6038
+
6039
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
6040
+ You must specify an existing Metricstore.
6041
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6042
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6043
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6044
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
6045
+ You can create up to 200 Logstores or Metricstores in a project.
6046
+ Metric data is automatically deleted when the retention period of the metric data ends.
5986
6047
 
5987
6048
  @return: DeleteMetricStoreResponse
5988
6049
  """
@@ -5996,7 +6057,16 @@ class Client(OpenApiClient):
5996
6057
  name: str,
5997
6058
  ) -> sls_20201230_models.DeleteMetricStoreResponse:
5998
6059
  """
5999
- @summary 删除时序库
6060
+ @summary Deletes an existing Metricstore. When you delete a Metricstore, the metric data stored in the Metricstore and associated resources such as associated collection settings and transformation settings are also deleted.
6061
+
6062
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
6063
+ You must specify an existing Metricstore.
6064
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6065
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6066
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6067
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
6068
+ You can create up to 200 Logstores or Metricstores in a project.
6069
+ Metric data is automatically deleted when the retention period of the metric data ends.
6000
6070
 
6001
6071
  @return: DeleteMetricStoreResponse
6002
6072
  """
@@ -6453,8 +6523,11 @@ class Client(OpenApiClient):
6453
6523
  """
6454
6524
  @summary Deletes a project policy.
6455
6525
 
6456
- @description ### Usage notes
6526
+ @description ### [](#)Usage notes
6457
6527
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6528
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6529
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6530
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html)
6458
6531
 
6459
6532
  @param headers: map
6460
6533
  @param runtime: runtime options for this request RuntimeOptions
@@ -6491,8 +6564,11 @@ class Client(OpenApiClient):
6491
6564
  """
6492
6565
  @summary Deletes a project policy.
6493
6566
 
6494
- @description ### Usage notes
6567
+ @description ### [](#)Usage notes
6495
6568
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6569
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6570
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6571
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html)
6496
6572
 
6497
6573
  @param headers: map
6498
6574
  @param runtime: runtime options for this request RuntimeOptions
@@ -6527,8 +6603,11 @@ class Client(OpenApiClient):
6527
6603
  """
6528
6604
  @summary Deletes a project policy.
6529
6605
 
6530
- @description ### Usage notes
6606
+ @description ### [](#)Usage notes
6531
6607
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6608
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6609
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6610
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html)
6532
6611
 
6533
6612
  @return: DeleteProjectPolicyResponse
6534
6613
  """
@@ -6543,8 +6622,11 @@ class Client(OpenApiClient):
6543
6622
  """
6544
6623
  @summary Deletes a project policy.
6545
6624
 
6546
- @description ### Usage notes
6625
+ @description ### [](#)Usage notes
6547
6626
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6627
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6628
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6629
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html)
6548
6630
 
6549
6631
  @return: DeleteProjectPolicyResponse
6550
6632
  """
@@ -6564,6 +6646,15 @@ class Client(OpenApiClient):
6564
6646
 
6565
6647
  @description ### Usage notes
6566
6648
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6649
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6650
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6651
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
6652
+ After you delete a saved search, it cannot be restored. Proceed with caution.
6653
+ ### Authentication resources
6654
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
6655
+ |Action|Resource|
6656
+ |:---|:---|
6657
+ |`log:DeleteSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
6567
6658
 
6568
6659
  @param headers: map
6569
6660
  @param runtime: runtime options for this request RuntimeOptions
@@ -6603,6 +6694,15 @@ class Client(OpenApiClient):
6603
6694
 
6604
6695
  @description ### Usage notes
6605
6696
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6697
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6698
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6699
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
6700
+ After you delete a saved search, it cannot be restored. Proceed with caution.
6701
+ ### Authentication resources
6702
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
6703
+ |Action|Resource|
6704
+ |:---|:---|
6705
+ |`log:DeleteSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
6606
6706
 
6607
6707
  @param headers: map
6608
6708
  @param runtime: runtime options for this request RuntimeOptions
@@ -6640,6 +6740,15 @@ class Client(OpenApiClient):
6640
6740
 
6641
6741
  @description ### Usage notes
6642
6742
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6743
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6744
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6745
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
6746
+ After you delete a saved search, it cannot be restored. Proceed with caution.
6747
+ ### Authentication resources
6748
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
6749
+ |Action|Resource|
6750
+ |:---|:---|
6751
+ |`log:DeleteSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
6643
6752
 
6644
6753
  @return: DeleteSavedSearchResponse
6645
6754
  """
@@ -6657,6 +6766,15 @@ class Client(OpenApiClient):
6657
6766
 
6658
6767
  @description ### Usage notes
6659
6768
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
6769
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
6770
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
6771
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
6772
+ After you delete a saved search, it cannot be restored. Proceed with caution.
6773
+ ### Authentication resources
6774
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
6775
+ |Action|Resource|
6776
+ |:---|:---|
6777
+ |`log:DeleteSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
6660
6778
 
6661
6779
  @return: DeleteSavedSearchResponse
6662
6780
  """
@@ -6864,6 +6982,110 @@ class Client(OpenApiClient):
6864
6982
  headers = {}
6865
6983
  return await self.delete_store_view_with_options_async(project, name, headers, runtime)
6866
6984
 
6985
+ def describe_regions_with_options(
6986
+ self,
6987
+ request: sls_20201230_models.DescribeRegionsRequest,
6988
+ headers: Dict[str, str],
6989
+ runtime: util_models.RuntimeOptions,
6990
+ ) -> sls_20201230_models.DescribeRegionsResponse:
6991
+ """
6992
+ @summary 查询可用的区域
6993
+
6994
+ @param request: DescribeRegionsRequest
6995
+ @param headers: map
6996
+ @param runtime: runtime options for this request RuntimeOptions
6997
+ @return: DescribeRegionsResponse
6998
+ """
6999
+ UtilClient.validate_model(request)
7000
+ query = {}
7001
+ if not UtilClient.is_unset(request.language):
7002
+ query['language'] = request.language
7003
+ req = open_api_models.OpenApiRequest(
7004
+ headers=headers,
7005
+ query=OpenApiUtilClient.query(query)
7006
+ )
7007
+ params = open_api_models.Params(
7008
+ action='DescribeRegions',
7009
+ version='2020-12-30',
7010
+ protocol='HTTPS',
7011
+ pathname=f'/regions',
7012
+ method='GET',
7013
+ auth_type='AK',
7014
+ style='ROA',
7015
+ req_body_type='json',
7016
+ body_type='json'
7017
+ )
7018
+ return TeaCore.from_map(
7019
+ sls_20201230_models.DescribeRegionsResponse(),
7020
+ self.execute(params, req, runtime)
7021
+ )
7022
+
7023
+ async def describe_regions_with_options_async(
7024
+ self,
7025
+ request: sls_20201230_models.DescribeRegionsRequest,
7026
+ headers: Dict[str, str],
7027
+ runtime: util_models.RuntimeOptions,
7028
+ ) -> sls_20201230_models.DescribeRegionsResponse:
7029
+ """
7030
+ @summary 查询可用的区域
7031
+
7032
+ @param request: DescribeRegionsRequest
7033
+ @param headers: map
7034
+ @param runtime: runtime options for this request RuntimeOptions
7035
+ @return: DescribeRegionsResponse
7036
+ """
7037
+ UtilClient.validate_model(request)
7038
+ query = {}
7039
+ if not UtilClient.is_unset(request.language):
7040
+ query['language'] = request.language
7041
+ req = open_api_models.OpenApiRequest(
7042
+ headers=headers,
7043
+ query=OpenApiUtilClient.query(query)
7044
+ )
7045
+ params = open_api_models.Params(
7046
+ action='DescribeRegions',
7047
+ version='2020-12-30',
7048
+ protocol='HTTPS',
7049
+ pathname=f'/regions',
7050
+ method='GET',
7051
+ auth_type='AK',
7052
+ style='ROA',
7053
+ req_body_type='json',
7054
+ body_type='json'
7055
+ )
7056
+ return TeaCore.from_map(
7057
+ sls_20201230_models.DescribeRegionsResponse(),
7058
+ await self.execute_async(params, req, runtime)
7059
+ )
7060
+
7061
+ def describe_regions(
7062
+ self,
7063
+ request: sls_20201230_models.DescribeRegionsRequest,
7064
+ ) -> sls_20201230_models.DescribeRegionsResponse:
7065
+ """
7066
+ @summary 查询可用的区域
7067
+
7068
+ @param request: DescribeRegionsRequest
7069
+ @return: DescribeRegionsResponse
7070
+ """
7071
+ runtime = util_models.RuntimeOptions()
7072
+ headers = {}
7073
+ return self.describe_regions_with_options(request, headers, runtime)
7074
+
7075
+ async def describe_regions_async(
7076
+ self,
7077
+ request: sls_20201230_models.DescribeRegionsRequest,
7078
+ ) -> sls_20201230_models.DescribeRegionsResponse:
7079
+ """
7080
+ @summary 查询可用的区域
7081
+
7082
+ @param request: DescribeRegionsRequest
7083
+ @return: DescribeRegionsResponse
7084
+ """
7085
+ runtime = util_models.RuntimeOptions()
7086
+ headers = {}
7087
+ return await self.describe_regions_with_options_async(request, headers, runtime)
7088
+
6867
7089
  def disable_alert_with_options(
6868
7090
  self,
6869
7091
  project: str,
@@ -7172,7 +7394,7 @@ class Client(OpenApiClient):
7172
7394
  runtime: util_models.RuntimeOptions,
7173
7395
  ) -> sls_20201230_models.EnableScheduledSQLResponse:
7174
7396
  """
7175
- @summary 启用定时SQL任务
7397
+ @summary Enables the Scheduled SQL feature.
7176
7398
 
7177
7399
  @param headers: map
7178
7400
  @param runtime: runtime options for this request RuntimeOptions
@@ -7208,7 +7430,7 @@ class Client(OpenApiClient):
7208
7430
  runtime: util_models.RuntimeOptions,
7209
7431
  ) -> sls_20201230_models.EnableScheduledSQLResponse:
7210
7432
  """
7211
- @summary 启用定时SQL任务
7433
+ @summary Enables the Scheduled SQL feature.
7212
7434
 
7213
7435
  @param headers: map
7214
7436
  @param runtime: runtime options for this request RuntimeOptions
@@ -7242,7 +7464,7 @@ class Client(OpenApiClient):
7242
7464
  scheduled_sqlname: str,
7243
7465
  ) -> sls_20201230_models.EnableScheduledSQLResponse:
7244
7466
  """
7245
- @summary 启用定时SQL任务
7467
+ @summary Enables the Scheduled SQL feature.
7246
7468
 
7247
7469
  @return: EnableScheduledSQLResponse
7248
7470
  """
@@ -7256,7 +7478,7 @@ class Client(OpenApiClient):
7256
7478
  scheduled_sqlname: str,
7257
7479
  ) -> sls_20201230_models.EnableScheduledSQLResponse:
7258
7480
  """
7259
- @summary 启用定时SQL任务
7481
+ @summary Enables the Scheduled SQL feature.
7260
7482
 
7261
7483
  @return: EnableScheduledSQLResponse
7262
7484
  """
@@ -8266,8 +8488,6 @@ class Client(OpenApiClient):
8266
8488
  query['pack_id'] = request.pack_id
8267
8489
  if not UtilClient.is_unset(request.pack_meta):
8268
8490
  query['pack_meta'] = request.pack_meta
8269
- if not UtilClient.is_unset(request.type):
8270
- query['type'] = request.type
8271
8491
  req = open_api_models.OpenApiRequest(
8272
8492
  host_map=host_map,
8273
8493
  headers=headers,
@@ -8277,7 +8497,7 @@ class Client(OpenApiClient):
8277
8497
  action='GetContextLogs',
8278
8498
  version='2020-12-30',
8279
8499
  protocol='HTTPS',
8280
- pathname=f'/logstores/{logstore}',
8500
+ pathname=f'/logstores/{logstore}?type=context_log',
8281
8501
  method='GET',
8282
8502
  auth_type='AK',
8283
8503
  style='ROA',
@@ -8331,8 +8551,6 @@ class Client(OpenApiClient):
8331
8551
  query['pack_id'] = request.pack_id
8332
8552
  if not UtilClient.is_unset(request.pack_meta):
8333
8553
  query['pack_meta'] = request.pack_meta
8334
- if not UtilClient.is_unset(request.type):
8335
- query['type'] = request.type
8336
8554
  req = open_api_models.OpenApiRequest(
8337
8555
  host_map=host_map,
8338
8556
  headers=headers,
@@ -8342,7 +8560,7 @@ class Client(OpenApiClient):
8342
8560
  action='GetContextLogs',
8343
8561
  version='2020-12-30',
8344
8562
  protocol='HTTPS',
8345
- pathname=f'/logstores/{logstore}',
8563
+ pathname=f'/logstores/{logstore}?type=context_log',
8346
8564
  method='GET',
8347
8565
  auth_type='AK',
8348
8566
  style='ROA',
@@ -8818,7 +9036,7 @@ class Client(OpenApiClient):
8818
9036
  runtime: util_models.RuntimeOptions,
8819
9037
  ) -> sls_20201230_models.GetDownloadJobResponse:
8820
9038
  """
8821
- @summary 获取下载任务信息
9039
+ @summary Queries the information about a download task.
8822
9040
 
8823
9041
  @param headers: map
8824
9042
  @param runtime: runtime options for this request RuntimeOptions
@@ -8854,7 +9072,7 @@ class Client(OpenApiClient):
8854
9072
  runtime: util_models.RuntimeOptions,
8855
9073
  ) -> sls_20201230_models.GetDownloadJobResponse:
8856
9074
  """
8857
- @summary 获取下载任务信息
9075
+ @summary Queries the information about a download task.
8858
9076
 
8859
9077
  @param headers: map
8860
9078
  @param runtime: runtime options for this request RuntimeOptions
@@ -8888,7 +9106,7 @@ class Client(OpenApiClient):
8888
9106
  download_job_name: str,
8889
9107
  ) -> sls_20201230_models.GetDownloadJobResponse:
8890
9108
  """
8891
- @summary 获取下载任务信息
9109
+ @summary Queries the information about a download task.
8892
9110
 
8893
9111
  @return: GetDownloadJobResponse
8894
9112
  """
@@ -8902,7 +9120,7 @@ class Client(OpenApiClient):
8902
9120
  download_job_name: str,
8903
9121
  ) -> sls_20201230_models.GetDownloadJobResponse:
8904
9122
  """
8905
- @summary 获取下载任务信息
9123
+ @summary Queries the information about a download task.
8906
9124
 
8907
9125
  @return: GetDownloadJobResponse
8908
9126
  """
@@ -9736,15 +9954,24 @@ class Client(OpenApiClient):
9736
9954
  @summary Queries the logs of a Logstore in a project.
9737
9955
 
9738
9956
  @description ### Usage notes
9739
- > Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a Scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
9957
+ *Note** Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
9740
9958
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
9741
- If the number of logs in a Logstore significantly changes, Simple Log Service cannot forecast the number of times that you must call this operation to obtain the complete result. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete result. Each time you call this operation, the same number of charge units (CUs) are consumed.
9742
- After a log is written to a Logstore, you can call the GetHistograms or GetLogs operation to query the log after a short latency. The latency of a query varies based on the type of the log. Simple Log Service classifies logs into the following types based on the log time:
9743
- Real-time data: The difference between the time record in a log and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
9744
- Historical data: The difference between the time record in a log and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios.
9745
- After real-time data is written to a Logstore, the data can be queried with a maximum latency of 3 seconds. For 99.9% of queries, the latency is no more than 1 second.
9746
- > Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:*receive_time** field for each log. The receiving time indicates the time at which Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
9959
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
9960
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
9961
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
9962
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
9963
+ Indexes are configured before you query logs. For more information, see [Create indexes](https://help.aliyun.com/document_detail/90732.html).
9964
+ If the number of logs in a Logstore significantly changes, Simple Log Service cannot predict the number of times that you must call this operation to obtain the complete results. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete results. Each time you call this operation, the same number of charge units (CUs) are consumed.
9965
+ After a log is written to a Logstore, you can call the GetHistograms or the GetLogs operation to query the log. The latency of the query varies based on the type of the log. Simple Log Service classifies logs into the following types based on log timestamps:
9966
+ Real-time data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds\\]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
9967
+ Historical data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios. After real-time data is written to a Logstore, the data can be queried with an approximate latency of 3 seconds.
9968
+ *Note** Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:**receive_time** field for each log. The receiving time indicates when Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds\\], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
9747
9969
  Simple Log Service provides examples on how to call the GetLogs operation by using Simple Log Service SDK for Java and Simple Log Service SDK for Python. For more information, see [Examples of calling the GetLogs operation by using Simple Log Service SDK for Java](https://help.aliyun.com/document_detail/407683.html) and [Examples of calling the GetLogs operation by using Simple Log Service SDK for Python](https://help.aliyun.com/document_detail/407684.html).
9970
+ ### Authentication resources
9971
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
9972
+ |Action|Resource|
9973
+ |:---|:---|
9974
+ |`log:GetLogStoreLogs`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`|
9748
9975
 
9749
9976
  @param request: GetLogsRequest
9750
9977
  @param headers: map
@@ -9804,15 +10031,24 @@ class Client(OpenApiClient):
9804
10031
  @summary Queries the logs of a Logstore in a project.
9805
10032
 
9806
10033
  @description ### Usage notes
9807
- > Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a Scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
10034
+ *Note** Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
9808
10035
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
9809
- If the number of logs in a Logstore significantly changes, Simple Log Service cannot forecast the number of times that you must call this operation to obtain the complete result. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete result. Each time you call this operation, the same number of charge units (CUs) are consumed.
9810
- After a log is written to a Logstore, you can call the GetHistograms or GetLogs operation to query the log after a short latency. The latency of a query varies based on the type of the log. Simple Log Service classifies logs into the following types based on the log time:
9811
- Real-time data: The difference between the time record in a log and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
9812
- Historical data: The difference between the time record in a log and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios.
9813
- After real-time data is written to a Logstore, the data can be queried with a maximum latency of 3 seconds. For 99.9% of queries, the latency is no more than 1 second.
9814
- > Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:*receive_time** field for each log. The receiving time indicates the time at which Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
10036
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10037
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10038
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
10039
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
10040
+ Indexes are configured before you query logs. For more information, see [Create indexes](https://help.aliyun.com/document_detail/90732.html).
10041
+ If the number of logs in a Logstore significantly changes, Simple Log Service cannot predict the number of times that you must call this operation to obtain the complete results. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete results. Each time you call this operation, the same number of charge units (CUs) are consumed.
10042
+ After a log is written to a Logstore, you can call the GetHistograms or the GetLogs operation to query the log. The latency of the query varies based on the type of the log. Simple Log Service classifies logs into the following types based on log timestamps:
10043
+ Real-time data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds\\]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
10044
+ Historical data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios. After real-time data is written to a Logstore, the data can be queried with an approximate latency of 3 seconds.
10045
+ *Note** Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:**receive_time** field for each log. The receiving time indicates when Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds\\], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
9815
10046
  Simple Log Service provides examples on how to call the GetLogs operation by using Simple Log Service SDK for Java and Simple Log Service SDK for Python. For more information, see [Examples of calling the GetLogs operation by using Simple Log Service SDK for Java](https://help.aliyun.com/document_detail/407683.html) and [Examples of calling the GetLogs operation by using Simple Log Service SDK for Python](https://help.aliyun.com/document_detail/407684.html).
10047
+ ### Authentication resources
10048
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
10049
+ |Action|Resource|
10050
+ |:---|:---|
10051
+ |`log:GetLogStoreLogs`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`|
9816
10052
 
9817
10053
  @param request: GetLogsRequest
9818
10054
  @param headers: map
@@ -9870,15 +10106,24 @@ class Client(OpenApiClient):
9870
10106
  @summary Queries the logs of a Logstore in a project.
9871
10107
 
9872
10108
  @description ### Usage notes
9873
- > Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a Scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
10109
+ *Note** Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
9874
10110
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
9875
- If the number of logs in a Logstore significantly changes, Simple Log Service cannot forecast the number of times that you must call this operation to obtain the complete result. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete result. Each time you call this operation, the same number of charge units (CUs) are consumed.
9876
- After a log is written to a Logstore, you can call the GetHistograms or GetLogs operation to query the log after a short latency. The latency of a query varies based on the type of the log. Simple Log Service classifies logs into the following types based on the log time:
9877
- Real-time data: The difference between the time record in a log and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
9878
- Historical data: The difference between the time record in a log and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios.
9879
- After real-time data is written to a Logstore, the data can be queried with a maximum latency of 3 seconds. For 99.9% of queries, the latency is no more than 1 second.
9880
- > Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:*receive_time** field for each log. The receiving time indicates the time at which Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
10111
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10112
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10113
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
10114
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
10115
+ Indexes are configured before you query logs. For more information, see [Create indexes](https://help.aliyun.com/document_detail/90732.html).
10116
+ If the number of logs in a Logstore significantly changes, Simple Log Service cannot predict the number of times that you must call this operation to obtain the complete results. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete results. Each time you call this operation, the same number of charge units (CUs) are consumed.
10117
+ After a log is written to a Logstore, you can call the GetHistograms or the GetLogs operation to query the log. The latency of the query varies based on the type of the log. Simple Log Service classifies logs into the following types based on log timestamps:
10118
+ Real-time data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds\\]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
10119
+ Historical data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios. After real-time data is written to a Logstore, the data can be queried with an approximate latency of 3 seconds.
10120
+ *Note** Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:**receive_time** field for each log. The receiving time indicates when Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds\\], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
9881
10121
  Simple Log Service provides examples on how to call the GetLogs operation by using Simple Log Service SDK for Java and Simple Log Service SDK for Python. For more information, see [Examples of calling the GetLogs operation by using Simple Log Service SDK for Java](https://help.aliyun.com/document_detail/407683.html) and [Examples of calling the GetLogs operation by using Simple Log Service SDK for Python](https://help.aliyun.com/document_detail/407684.html).
10122
+ ### Authentication resources
10123
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
10124
+ |Action|Resource|
10125
+ |:---|:---|
10126
+ |`log:GetLogStoreLogs`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`|
9882
10127
 
9883
10128
  @param request: GetLogsRequest
9884
10129
  @return: GetLogsResponse
@@ -9897,15 +10142,24 @@ class Client(OpenApiClient):
9897
10142
  @summary Queries the logs of a Logstore in a project.
9898
10143
 
9899
10144
  @description ### Usage notes
9900
- > Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a Scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
10145
+ *Note** Simple Log Service allows you to create a Scheduled SQL job. For more information, see [Create a scheduled SQL job](https://help.aliyun.com/document_detail/286457.html).
9901
10146
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
9902
- If the number of logs in a Logstore significantly changes, Simple Log Service cannot forecast the number of times that you must call this operation to obtain the complete result. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete result. Each time you call this operation, the same number of charge units (CUs) are consumed.
9903
- After a log is written to a Logstore, you can call the GetHistograms or GetLogs operation to query the log after a short latency. The latency of a query varies based on the type of the log. Simple Log Service classifies logs into the following types based on the log time:
9904
- Real-time data: The difference between the time record in a log and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
9905
- Historical data: The difference between the time record in a log and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios.
9906
- After real-time data is written to a Logstore, the data can be queried with a maximum latency of 3 seconds. For 99.9% of queries, the latency is no more than 1 second.
9907
- > Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:*receive_time** field for each log. The receiving time indicates the time at which Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
10147
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10148
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10149
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
10150
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
10151
+ Indexes are configured before you query logs. For more information, see [Create indexes](https://help.aliyun.com/document_detail/90732.html).
10152
+ If the number of logs in a Logstore significantly changes, Simple Log Service cannot predict the number of times that you must call this operation to obtain the complete results. In this case, you must check the value of the x-log-progress parameter in the response of each request and determine whether to call this operation one more time to obtain the complete results. Each time you call this operation, the same number of charge units (CUs) are consumed.
10153
+ After a log is written to a Logstore, you can call the GetHistograms or the GetLogs operation to query the log. The latency of the query varies based on the type of the log. Simple Log Service classifies logs into the following types based on log timestamps:
10154
+ Real-time data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval (-180 seconds,900 seconds\\]. For example, if a log was generated at 12:03:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as real-time data. This type of log is usually generated in common scenarios.
10155
+ Historical data: The difference between the time record in a log of this type and the current time on Simple Log Service is within the interval [-604,800 seconds,-180 seconds). For example, if a log was generated at 12:00:00, September 25, 2014 (UTC) and Simple Log Service received the log at 12:05:00, September 25, 2014 (UTC), Simple Log Service processes the log as historical data. This type of log is usually generated in data backfill scenarios. After real-time data is written to a Logstore, the data can be queried with an approximate latency of 3 seconds.
10156
+ *Note** Simple Log Service calculates the difference between the log time that is specified by the __time__ field and the receiving time that is specified by the __tag__:**receive_time** field for each log. The receiving time indicates when Simple Log Service receives the log. If the difference is within the interval (-180 seconds,900 seconds\\], Simple Log Service processes the log as real-time data. If the difference is within the interval [-604,800 seconds,-180 seconds), Simple Log Service processes the log as historical data.
9908
10157
  Simple Log Service provides examples on how to call the GetLogs operation by using Simple Log Service SDK for Java and Simple Log Service SDK for Python. For more information, see [Examples of calling the GetLogs operation by using Simple Log Service SDK for Java](https://help.aliyun.com/document_detail/407683.html) and [Examples of calling the GetLogs operation by using Simple Log Service SDK for Python](https://help.aliyun.com/document_detail/407684.html).
10158
+ ### Authentication resources
10159
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
10160
+ |Action|Resource|
10161
+ |:---|:---|
10162
+ |`log:GetLogStoreLogs`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`|
9909
10163
 
9910
10164
  @param request: GetLogsRequest
9911
10165
  @return: GetLogsResponse
@@ -10436,7 +10690,16 @@ class Client(OpenApiClient):
10436
10690
  runtime: util_models.RuntimeOptions,
10437
10691
  ) -> sls_20201230_models.GetMetricStoreResponse:
10438
10692
  """
10439
- @summary 查询时序库
10693
+ @summary Queries a Metricstore.
10694
+
10695
+ @description Metricstores are used to store metric data. For more information about Metricstores, see [Metricstores](https://help.aliyun.com/document_detail/171723.html). For more information about metric data, see [Metric data](https://help.aliyun.com/document_detail/174965.html). You can call this operation to query the settings of a Metricstore. To query the metric data in a Metricstore, see [Query and analysis](https://help.aliyun.com/document_detail/174968.html) and [GetLogsV2](https://help.aliyun.com/document_detail/2771318.html).
10696
+ You must specify an existing Metricstore.
10697
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
10698
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10699
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10700
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
10701
+ You can create up to 200 Logstores or Metricstores in a project.
10702
+ Metric data is automatically deleted when the retention period of the metric data ends.
10440
10703
 
10441
10704
  @param headers: map
10442
10705
  @param runtime: runtime options for this request RuntimeOptions
@@ -10472,7 +10735,16 @@ class Client(OpenApiClient):
10472
10735
  runtime: util_models.RuntimeOptions,
10473
10736
  ) -> sls_20201230_models.GetMetricStoreResponse:
10474
10737
  """
10475
- @summary 查询时序库
10738
+ @summary Queries a Metricstore.
10739
+
10740
+ @description Metricstores are used to store metric data. For more information about Metricstores, see [Metricstores](https://help.aliyun.com/document_detail/171723.html). For more information about metric data, see [Metric data](https://help.aliyun.com/document_detail/174965.html). You can call this operation to query the settings of a Metricstore. To query the metric data in a Metricstore, see [Query and analysis](https://help.aliyun.com/document_detail/174968.html) and [GetLogsV2](https://help.aliyun.com/document_detail/2771318.html).
10741
+ You must specify an existing Metricstore.
10742
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
10743
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10744
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10745
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
10746
+ You can create up to 200 Logstores or Metricstores in a project.
10747
+ Metric data is automatically deleted when the retention period of the metric data ends.
10476
10748
 
10477
10749
  @param headers: map
10478
10750
  @param runtime: runtime options for this request RuntimeOptions
@@ -10506,7 +10778,16 @@ class Client(OpenApiClient):
10506
10778
  name: str,
10507
10779
  ) -> sls_20201230_models.GetMetricStoreResponse:
10508
10780
  """
10509
- @summary 查询时序库
10781
+ @summary Queries a Metricstore.
10782
+
10783
+ @description Metricstores are used to store metric data. For more information about Metricstores, see [Metricstores](https://help.aliyun.com/document_detail/171723.html). For more information about metric data, see [Metric data](https://help.aliyun.com/document_detail/174965.html). You can call this operation to query the settings of a Metricstore. To query the metric data in a Metricstore, see [Query and analysis](https://help.aliyun.com/document_detail/174968.html) and [GetLogsV2](https://help.aliyun.com/document_detail/2771318.html).
10784
+ You must specify an existing Metricstore.
10785
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
10786
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10787
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10788
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
10789
+ You can create up to 200 Logstores or Metricstores in a project.
10790
+ Metric data is automatically deleted when the retention period of the metric data ends.
10510
10791
 
10511
10792
  @return: GetMetricStoreResponse
10512
10793
  """
@@ -10520,7 +10801,16 @@ class Client(OpenApiClient):
10520
10801
  name: str,
10521
10802
  ) -> sls_20201230_models.GetMetricStoreResponse:
10522
10803
  """
10523
- @summary 查询时序库
10804
+ @summary Queries a Metricstore.
10805
+
10806
+ @description Metricstores are used to store metric data. For more information about Metricstores, see [Metricstores](https://help.aliyun.com/document_detail/171723.html). For more information about metric data, see [Metric data](https://help.aliyun.com/document_detail/174965.html). You can call this operation to query the settings of a Metricstore. To query the metric data in a Metricstore, see [Query and analysis](https://help.aliyun.com/document_detail/174968.html) and [GetLogsV2](https://help.aliyun.com/document_detail/2771318.html).
10807
+ You must specify an existing Metricstore.
10808
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
10809
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
10810
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
10811
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
10812
+ You can create up to 200 Logstores or Metricstores in a project.
10813
+ Metric data is automatically deleted when the retention period of the metric data ends.
10524
10814
 
10525
10815
  @return: GetMetricStoreResponse
10526
10816
  """
@@ -11350,6 +11640,15 @@ class Client(OpenApiClient):
11350
11640
 
11351
11641
  @description ### Usage notes
11352
11642
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
11643
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
11644
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
11645
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
11646
+ You can call the ListSavedSearch operation to query the name of a saved search.
11647
+ ### Authentication resources
11648
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
11649
+ |Action|Resource|
11650
+ |:---|:---|
11651
+ |`log:GetSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
11353
11652
 
11354
11653
  @param headers: map
11355
11654
  @param runtime: runtime options for this request RuntimeOptions
@@ -11389,6 +11688,15 @@ class Client(OpenApiClient):
11389
11688
 
11390
11689
  @description ### Usage notes
11391
11690
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
11691
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
11692
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
11693
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
11694
+ You can call the ListSavedSearch operation to query the name of a saved search.
11695
+ ### Authentication resources
11696
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
11697
+ |Action|Resource|
11698
+ |:---|:---|
11699
+ |`log:GetSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
11392
11700
 
11393
11701
  @param headers: map
11394
11702
  @param runtime: runtime options for this request RuntimeOptions
@@ -11426,6 +11734,15 @@ class Client(OpenApiClient):
11426
11734
 
11427
11735
  @description ### Usage notes
11428
11736
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
11737
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
11738
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
11739
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
11740
+ You can call the ListSavedSearch operation to query the name of a saved search.
11741
+ ### Authentication resources
11742
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
11743
+ |Action|Resource|
11744
+ |:---|:---|
11745
+ |`log:GetSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
11429
11746
 
11430
11747
  @return: GetSavedSearchResponse
11431
11748
  """
@@ -11443,6 +11760,15 @@ class Client(OpenApiClient):
11443
11760
 
11444
11761
  @description ### Usage notes
11445
11762
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
11763
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
11764
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
11765
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
11766
+ You can call the ListSavedSearch operation to query the name of a saved search.
11767
+ ### Authentication resources
11768
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
11769
+ |Action|Resource|
11770
+ |:---|:---|
11771
+ |`log:GetSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
11446
11772
 
11447
11773
  @return: GetSavedSearchResponse
11448
11774
  """
@@ -12385,7 +12711,7 @@ class Client(OpenApiClient):
12385
12711
  runtime: util_models.RuntimeOptions,
12386
12712
  ) -> sls_20201230_models.ListCollectionPoliciesResponse:
12387
12713
  """
12388
- @summary 通过调用ListCollectionPolicies接口查看配置的日志采集规则
12714
+ @summary Queries a list of log collection policies for cloud services.
12389
12715
 
12390
12716
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
12391
12717
 
@@ -12437,7 +12763,7 @@ class Client(OpenApiClient):
12437
12763
  runtime: util_models.RuntimeOptions,
12438
12764
  ) -> sls_20201230_models.ListCollectionPoliciesResponse:
12439
12765
  """
12440
- @summary 通过调用ListCollectionPolicies接口查看配置的日志采集规则
12766
+ @summary Queries a list of log collection policies for cloud services.
12441
12767
 
12442
12768
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
12443
12769
 
@@ -12487,7 +12813,7 @@ class Client(OpenApiClient):
12487
12813
  request: sls_20201230_models.ListCollectionPoliciesRequest,
12488
12814
  ) -> sls_20201230_models.ListCollectionPoliciesResponse:
12489
12815
  """
12490
- @summary 通过调用ListCollectionPolicies接口查看配置的日志采集规则
12816
+ @summary Queries a list of log collection policies for cloud services.
12491
12817
 
12492
12818
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
12493
12819
 
@@ -12503,7 +12829,7 @@ class Client(OpenApiClient):
12503
12829
  request: sls_20201230_models.ListCollectionPoliciesRequest,
12504
12830
  ) -> sls_20201230_models.ListCollectionPoliciesResponse:
12505
12831
  """
12506
- @summary 通过调用ListCollectionPolicies接口查看配置的日志采集规则
12832
+ @summary Queries a list of log collection policies for cloud services.
12507
12833
 
12508
12834
  @description You must use the Simple Log Service endpoint for the China (Shanghai) or Singapore region to call the operation.
12509
12835
 
@@ -12676,6 +13002,14 @@ class Client(OpenApiClient):
12676
13002
 
12677
13003
  @description ### Usage notes
12678
13004
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
13005
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
13006
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
13007
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
13008
+ ### Authentication resources
13009
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
13010
+ |Action|Resource|
13011
+ |:---|:---|
13012
+ |`log:ListConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}/consumergroup/`|
12679
13013
 
12680
13014
  @param headers: map
12681
13015
  @param runtime: runtime options for this request RuntimeOptions
@@ -12715,6 +13049,14 @@ class Client(OpenApiClient):
12715
13049
 
12716
13050
  @description ### Usage notes
12717
13051
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
13052
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
13053
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
13054
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
13055
+ ### Authentication resources
13056
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
13057
+ |Action|Resource|
13058
+ |:---|:---|
13059
+ |`log:ListConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}/consumergroup/`|
12718
13060
 
12719
13061
  @param headers: map
12720
13062
  @param runtime: runtime options for this request RuntimeOptions
@@ -12752,6 +13094,14 @@ class Client(OpenApiClient):
12752
13094
 
12753
13095
  @description ### Usage notes
12754
13096
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
13097
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
13098
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
13099
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
13100
+ ### Authentication resources
13101
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
13102
+ |Action|Resource|
13103
+ |:---|:---|
13104
+ |`log:ListConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}/consumergroup/`|
12755
13105
 
12756
13106
  @return: ListConsumerGroupResponse
12757
13107
  """
@@ -12769,6 +13119,14 @@ class Client(OpenApiClient):
12769
13119
 
12770
13120
  @description ### Usage notes
12771
13121
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
13122
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
13123
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
13124
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
13125
+ ### Authentication resources
13126
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
13127
+ |Action|Resource|
13128
+ |:---|:---|
13129
+ |`log:ListConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}/consumergroup/`|
12772
13130
 
12773
13131
  @return: ListConsumerGroupResponse
12774
13132
  """
@@ -13872,7 +14230,12 @@ class Client(OpenApiClient):
13872
14230
  runtime: util_models.RuntimeOptions,
13873
14231
  ) -> sls_20201230_models.ListMetricStoresResponse:
13874
14232
  """
13875
- @summary 查询时序库
14233
+ @summary Queries the list of Metricstores in a project. You can use fuzzy search to query the Metricstores by Metricstore name.
14234
+
14235
+ @description Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
14236
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
14237
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
14238
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
13876
14239
 
13877
14240
  @param request: ListMetricStoresRequest
13878
14241
  @param headers: map
@@ -13920,7 +14283,12 @@ class Client(OpenApiClient):
13920
14283
  runtime: util_models.RuntimeOptions,
13921
14284
  ) -> sls_20201230_models.ListMetricStoresResponse:
13922
14285
  """
13923
- @summary 查询时序库
14286
+ @summary Queries the list of Metricstores in a project. You can use fuzzy search to query the Metricstores by Metricstore name.
14287
+
14288
+ @description Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
14289
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
14290
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
14291
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
13924
14292
 
13925
14293
  @param request: ListMetricStoresRequest
13926
14294
  @param headers: map
@@ -13966,7 +14334,12 @@ class Client(OpenApiClient):
13966
14334
  request: sls_20201230_models.ListMetricStoresRequest,
13967
14335
  ) -> sls_20201230_models.ListMetricStoresResponse:
13968
14336
  """
13969
- @summary 查询时序库
14337
+ @summary Queries the list of Metricstores in a project. You can use fuzzy search to query the Metricstores by Metricstore name.
14338
+
14339
+ @description Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
14340
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
14341
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
14342
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
13970
14343
 
13971
14344
  @param request: ListMetricStoresRequest
13972
14345
  @return: ListMetricStoresResponse
@@ -13981,7 +14354,12 @@ class Client(OpenApiClient):
13981
14354
  request: sls_20201230_models.ListMetricStoresRequest,
13982
14355
  ) -> sls_20201230_models.ListMetricStoresResponse:
13983
14356
  """
13984
- @summary 查询时序库
14357
+ @summary Queries the list of Metricstores in a project. You can use fuzzy search to query the Metricstores by Metricstore name.
14358
+
14359
+ @description Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
14360
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
14361
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
14362
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
13985
14363
 
13986
14364
  @param request: ListMetricStoresRequest
13987
14365
  @return: ListMetricStoresResponse
@@ -15324,6 +15702,152 @@ class Client(OpenApiClient):
15324
15702
  headers = {}
15325
15703
  return await self.open_sls_service_with_options_async(headers, runtime)
15326
15704
 
15705
+ def pull_logs_with_options(
15706
+ self,
15707
+ project: str,
15708
+ log_store: str,
15709
+ shard_id: str,
15710
+ request: sls_20201230_models.PullLogsRequest,
15711
+ headers: sls_20201230_models.PullLogsHeaders,
15712
+ runtime: util_models.RuntimeOptions,
15713
+ ) -> sls_20201230_models.PullLogsResponse:
15714
+ """
15715
+ @summary Queries logs based on the specified cursors. You can call this operation to obtain raw logs. To query and analyze logs, you can call the GetLogsV2 operation.
15716
+
15717
+ @description You cannot call this operation in OpenAPI Explorer. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
15718
+
15719
+ @param request: PullLogsRequest
15720
+ @param headers: PullLogsHeaders
15721
+ @param runtime: runtime options for this request RuntimeOptions
15722
+ @return: PullLogsResponse
15723
+ """
15724
+ UtilClient.validate_model(request)
15725
+ query = {}
15726
+ if not UtilClient.is_unset(request.count):
15727
+ query['count'] = request.count
15728
+ if not UtilClient.is_unset(request.cursor):
15729
+ query['cursor'] = request.cursor
15730
+ if not UtilClient.is_unset(request.end_cursor):
15731
+ query['end_cursor'] = request.end_cursor
15732
+ if not UtilClient.is_unset(request.query):
15733
+ query['query'] = request.query
15734
+ real_headers = {}
15735
+ if not UtilClient.is_unset(headers.common_headers):
15736
+ real_headers = headers.common_headers
15737
+ if not UtilClient.is_unset(headers.accept_encoding):
15738
+ real_headers['Accept-Encoding'] = UtilClient.to_jsonstring(headers.accept_encoding)
15739
+ req = open_api_models.OpenApiRequest(
15740
+ headers=real_headers,
15741
+ query=OpenApiUtilClient.query(query)
15742
+ )
15743
+ params = open_api_models.Params(
15744
+ action='PullLogs',
15745
+ version='2020-12-30',
15746
+ protocol='HTTPS',
15747
+ pathname=f'/logstores/{log_store}/shards/{shard_id}?type=log',
15748
+ method='GET',
15749
+ auth_type='AK',
15750
+ style='ROA',
15751
+ req_body_type='none',
15752
+ body_type='json'
15753
+ )
15754
+ return TeaCore.from_map(
15755
+ sls_20201230_models.PullLogsResponse(),
15756
+ self.execute(params, req, runtime)
15757
+ )
15758
+
15759
+ async def pull_logs_with_options_async(
15760
+ self,
15761
+ project: str,
15762
+ log_store: str,
15763
+ shard_id: str,
15764
+ request: sls_20201230_models.PullLogsRequest,
15765
+ headers: sls_20201230_models.PullLogsHeaders,
15766
+ runtime: util_models.RuntimeOptions,
15767
+ ) -> sls_20201230_models.PullLogsResponse:
15768
+ """
15769
+ @summary Queries logs based on the specified cursors. You can call this operation to obtain raw logs. To query and analyze logs, you can call the GetLogsV2 operation.
15770
+
15771
+ @description You cannot call this operation in OpenAPI Explorer. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
15772
+
15773
+ @param request: PullLogsRequest
15774
+ @param headers: PullLogsHeaders
15775
+ @param runtime: runtime options for this request RuntimeOptions
15776
+ @return: PullLogsResponse
15777
+ """
15778
+ UtilClient.validate_model(request)
15779
+ query = {}
15780
+ if not UtilClient.is_unset(request.count):
15781
+ query['count'] = request.count
15782
+ if not UtilClient.is_unset(request.cursor):
15783
+ query['cursor'] = request.cursor
15784
+ if not UtilClient.is_unset(request.end_cursor):
15785
+ query['end_cursor'] = request.end_cursor
15786
+ if not UtilClient.is_unset(request.query):
15787
+ query['query'] = request.query
15788
+ real_headers = {}
15789
+ if not UtilClient.is_unset(headers.common_headers):
15790
+ real_headers = headers.common_headers
15791
+ if not UtilClient.is_unset(headers.accept_encoding):
15792
+ real_headers['Accept-Encoding'] = UtilClient.to_jsonstring(headers.accept_encoding)
15793
+ req = open_api_models.OpenApiRequest(
15794
+ headers=real_headers,
15795
+ query=OpenApiUtilClient.query(query)
15796
+ )
15797
+ params = open_api_models.Params(
15798
+ action='PullLogs',
15799
+ version='2020-12-30',
15800
+ protocol='HTTPS',
15801
+ pathname=f'/logstores/{log_store}/shards/{shard_id}?type=log',
15802
+ method='GET',
15803
+ auth_type='AK',
15804
+ style='ROA',
15805
+ req_body_type='none',
15806
+ body_type='json'
15807
+ )
15808
+ return TeaCore.from_map(
15809
+ sls_20201230_models.PullLogsResponse(),
15810
+ await self.execute_async(params, req, runtime)
15811
+ )
15812
+
15813
+ def pull_logs(
15814
+ self,
15815
+ project: str,
15816
+ log_store: str,
15817
+ shard_id: str,
15818
+ request: sls_20201230_models.PullLogsRequest,
15819
+ ) -> sls_20201230_models.PullLogsResponse:
15820
+ """
15821
+ @summary Queries logs based on the specified cursors. You can call this operation to obtain raw logs. To query and analyze logs, you can call the GetLogsV2 operation.
15822
+
15823
+ @description You cannot call this operation in OpenAPI Explorer. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
15824
+
15825
+ @param request: PullLogsRequest
15826
+ @return: PullLogsResponse
15827
+ """
15828
+ runtime = util_models.RuntimeOptions()
15829
+ headers = sls_20201230_models.PullLogsHeaders()
15830
+ return self.pull_logs_with_options(project, log_store, shard_id, request, headers, runtime)
15831
+
15832
+ async def pull_logs_async(
15833
+ self,
15834
+ project: str,
15835
+ log_store: str,
15836
+ shard_id: str,
15837
+ request: sls_20201230_models.PullLogsRequest,
15838
+ ) -> sls_20201230_models.PullLogsResponse:
15839
+ """
15840
+ @summary Queries logs based on the specified cursors. You can call this operation to obtain raw logs. To query and analyze logs, you can call the GetLogsV2 operation.
15841
+
15842
+ @description You cannot call this operation in OpenAPI Explorer. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
15843
+
15844
+ @param request: PullLogsRequest
15845
+ @return: PullLogsResponse
15846
+ """
15847
+ runtime = util_models.RuntimeOptions()
15848
+ headers = sls_20201230_models.PullLogsHeaders()
15849
+ return await self.pull_logs_with_options_async(project, log_store, shard_id, request, headers, runtime)
15850
+
15327
15851
  def put_annotation_data_with_options(
15328
15852
  self,
15329
15853
  dataset_id: str,
@@ -15444,6 +15968,136 @@ class Client(OpenApiClient):
15444
15968
  headers = {}
15445
15969
  return await self.put_annotation_data_with_options_async(dataset_id, request, headers, runtime)
15446
15970
 
15971
+ def put_logs_with_options(
15972
+ self,
15973
+ project: str,
15974
+ logstore: str,
15975
+ request: sls_20201230_models.PutLogsRequest,
15976
+ headers: sls_20201230_models.PutLogsHeaders,
15977
+ runtime: util_models.RuntimeOptions,
15978
+ ) -> sls_20201230_models.PutLogsResponse:
15979
+ """
15980
+ @summary Sends logs to Simple Log Service.
15981
+
15982
+ @description You cannot call this operation by using cloud service SDKs that are provided by Alibaba Cloud OpenAPI Portal. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
15983
+
15984
+ @param request: PutLogsRequest
15985
+ @param headers: PutLogsHeaders
15986
+ @param runtime: runtime options for this request RuntimeOptions
15987
+ @return: PutLogsResponse
15988
+ """
15989
+ UtilClient.validate_model(request)
15990
+ host_map = {}
15991
+ host_map['project'] = project
15992
+ real_headers = {}
15993
+ if not UtilClient.is_unset(headers.common_headers):
15994
+ real_headers = headers.common_headers
15995
+ if not UtilClient.is_unset(headers.x_log_compresstype):
15996
+ real_headers['x-log-compresstype'] = UtilClient.to_jsonstring(headers.x_log_compresstype)
15997
+ req = open_api_models.OpenApiRequest(
15998
+ host_map=host_map,
15999
+ headers=real_headers,
16000
+ body=OpenApiUtilClient.parse_to_map(request.body)
16001
+ )
16002
+ params = open_api_models.Params(
16003
+ action='PutLogs',
16004
+ version='2020-12-30',
16005
+ protocol='HTTPS',
16006
+ pathname=f'/logstores/{logstore}/shards/lb',
16007
+ method='POST',
16008
+ auth_type='AK',
16009
+ style='ROA',
16010
+ req_body_type='protobuf',
16011
+ body_type='none'
16012
+ )
16013
+ return TeaCore.from_map(
16014
+ sls_20201230_models.PutLogsResponse(),
16015
+ self.execute(params, req, runtime)
16016
+ )
16017
+
16018
+ async def put_logs_with_options_async(
16019
+ self,
16020
+ project: str,
16021
+ logstore: str,
16022
+ request: sls_20201230_models.PutLogsRequest,
16023
+ headers: sls_20201230_models.PutLogsHeaders,
16024
+ runtime: util_models.RuntimeOptions,
16025
+ ) -> sls_20201230_models.PutLogsResponse:
16026
+ """
16027
+ @summary Sends logs to Simple Log Service.
16028
+
16029
+ @description You cannot call this operation by using cloud service SDKs that are provided by Alibaba Cloud OpenAPI Portal. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
16030
+
16031
+ @param request: PutLogsRequest
16032
+ @param headers: PutLogsHeaders
16033
+ @param runtime: runtime options for this request RuntimeOptions
16034
+ @return: PutLogsResponse
16035
+ """
16036
+ UtilClient.validate_model(request)
16037
+ host_map = {}
16038
+ host_map['project'] = project
16039
+ real_headers = {}
16040
+ if not UtilClient.is_unset(headers.common_headers):
16041
+ real_headers = headers.common_headers
16042
+ if not UtilClient.is_unset(headers.x_log_compresstype):
16043
+ real_headers['x-log-compresstype'] = UtilClient.to_jsonstring(headers.x_log_compresstype)
16044
+ req = open_api_models.OpenApiRequest(
16045
+ host_map=host_map,
16046
+ headers=real_headers,
16047
+ body=OpenApiUtilClient.parse_to_map(request.body)
16048
+ )
16049
+ params = open_api_models.Params(
16050
+ action='PutLogs',
16051
+ version='2020-12-30',
16052
+ protocol='HTTPS',
16053
+ pathname=f'/logstores/{logstore}/shards/lb',
16054
+ method='POST',
16055
+ auth_type='AK',
16056
+ style='ROA',
16057
+ req_body_type='protobuf',
16058
+ body_type='none'
16059
+ )
16060
+ return TeaCore.from_map(
16061
+ sls_20201230_models.PutLogsResponse(),
16062
+ await self.execute_async(params, req, runtime)
16063
+ )
16064
+
16065
+ def put_logs(
16066
+ self,
16067
+ project: str,
16068
+ logstore: str,
16069
+ request: sls_20201230_models.PutLogsRequest,
16070
+ ) -> sls_20201230_models.PutLogsResponse:
16071
+ """
16072
+ @summary Sends logs to Simple Log Service.
16073
+
16074
+ @description You cannot call this operation by using cloud service SDKs that are provided by Alibaba Cloud OpenAPI Portal. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
16075
+
16076
+ @param request: PutLogsRequest
16077
+ @return: PutLogsResponse
16078
+ """
16079
+ runtime = util_models.RuntimeOptions()
16080
+ headers = sls_20201230_models.PutLogsHeaders()
16081
+ return self.put_logs_with_options(project, logstore, request, headers, runtime)
16082
+
16083
+ async def put_logs_async(
16084
+ self,
16085
+ project: str,
16086
+ logstore: str,
16087
+ request: sls_20201230_models.PutLogsRequest,
16088
+ ) -> sls_20201230_models.PutLogsResponse:
16089
+ """
16090
+ @summary Sends logs to Simple Log Service.
16091
+
16092
+ @description You cannot call this operation by using cloud service SDKs that are provided by Alibaba Cloud OpenAPI Portal. You can use Simple Log Service SDK to call this operation. For more information, see [SLS SDK Reference](https://help.aliyun.com/document_detail/29063.html).
16093
+
16094
+ @param request: PutLogsRequest
16095
+ @return: PutLogsResponse
16096
+ """
16097
+ runtime = util_models.RuntimeOptions()
16098
+ headers = sls_20201230_models.PutLogsHeaders()
16099
+ return await self.put_logs_with_options_async(project, logstore, request, headers, runtime)
16100
+
15447
16101
  def put_project_policy_with_options(
15448
16102
  self,
15449
16103
  project: str,
@@ -15767,220 +16421,98 @@ class Client(OpenApiClient):
15767
16421
  The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
15768
16422
  You can call this operation to collect logs from web pages or clients.
15769
16423
  If you use web tracking to collect logs and you do not call this operation, you can send only one log to Simple Log Service in a request. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
15770
- If you want to collect a large amount of log data, you can call this operation to send multiple logs to Simple Log Service in one request.
15771
- Before you can call this operation to send logs to a Logstore, you must enable web tracking for the Logstore. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
15772
- You cannot call this operation to send the logs of multiple topics to Simple Log Service at a time.
15773
- If you call this operation, anonymous users from the Internet are granted the write permissions on the Logstore. This may generate dirty data because AccessKey pair-based authentication is not performed.
15774
-
15775
- @param request: PutWebtrackingRequest
15776
- @param headers: map
15777
- @param runtime: runtime options for this request RuntimeOptions
15778
- @return: PutWebtrackingResponse
15779
- """
15780
- UtilClient.validate_model(request)
15781
- host_map = {}
15782
- host_map['project'] = project
15783
- body = {}
15784
- if not UtilClient.is_unset(request.logs):
15785
- body['__logs__'] = request.logs
15786
- if not UtilClient.is_unset(request.source):
15787
- body['__source__'] = request.source
15788
- if not UtilClient.is_unset(request.tags):
15789
- body['__tags__'] = request.tags
15790
- if not UtilClient.is_unset(request.topic):
15791
- body['__topic__'] = request.topic
15792
- req = open_api_models.OpenApiRequest(
15793
- host_map=host_map,
15794
- headers=headers,
15795
- body=OpenApiUtilClient.parse_to_map(body)
15796
- )
15797
- params = open_api_models.Params(
15798
- action='PutWebtracking',
15799
- version='2020-12-30',
15800
- protocol='HTTPS',
15801
- pathname=f'/logstores/{logstore_name}/track',
15802
- method='POST',
15803
- auth_type='Anonymous',
15804
- style='ROA',
15805
- req_body_type='json',
15806
- body_type='none'
15807
- )
15808
- return TeaCore.from_map(
15809
- sls_20201230_models.PutWebtrackingResponse(),
15810
- await self.execute_async(params, req, runtime)
15811
- )
15812
-
15813
- def put_webtracking(
15814
- self,
15815
- project: str,
15816
- logstore_name: str,
15817
- request: sls_20201230_models.PutWebtrackingRequest,
15818
- ) -> sls_20201230_models.PutWebtrackingResponse:
15819
- """
15820
- @summary Sends multiple logs to Simple Log Service in one request.
15821
-
15822
- @description ### [](#)Usage notes
15823
- The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
15824
- You can call this operation to collect logs from web pages or clients.
15825
- If you use web tracking to collect logs and you do not call this operation, you can send only one log to Simple Log Service in a request. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
15826
- If you want to collect a large amount of log data, you can call this operation to send multiple logs to Simple Log Service in one request.
15827
- Before you can call this operation to send logs to a Logstore, you must enable web tracking for the Logstore. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
15828
- You cannot call this operation to send the logs of multiple topics to Simple Log Service at a time.
15829
- If you call this operation, anonymous users from the Internet are granted the write permissions on the Logstore. This may generate dirty data because AccessKey pair-based authentication is not performed.
15830
-
15831
- @param request: PutWebtrackingRequest
15832
- @return: PutWebtrackingResponse
15833
- """
15834
- runtime = util_models.RuntimeOptions()
15835
- headers = {}
15836
- return self.put_webtracking_with_options(project, logstore_name, request, headers, runtime)
15837
-
15838
- async def put_webtracking_async(
15839
- self,
15840
- project: str,
15841
- logstore_name: str,
15842
- request: sls_20201230_models.PutWebtrackingRequest,
15843
- ) -> sls_20201230_models.PutWebtrackingResponse:
15844
- """
15845
- @summary Sends multiple logs to Simple Log Service in one request.
15846
-
15847
- @description ### [](#)Usage notes
15848
- The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
15849
- You can call this operation to collect logs from web pages or clients.
15850
- If you use web tracking to collect logs and you do not call this operation, you can send only one log to Simple Log Service in a request. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
15851
- If you want to collect a large amount of log data, you can call this operation to send multiple logs to Simple Log Service in one request.
15852
- Before you can call this operation to send logs to a Logstore, you must enable web tracking for the Logstore. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
15853
- You cannot call this operation to send the logs of multiple topics to Simple Log Service at a time.
15854
- If you call this operation, anonymous users from the Internet are granted the write permissions on the Logstore. This may generate dirty data because AccessKey pair-based authentication is not performed.
15855
-
15856
- @param request: PutWebtrackingRequest
15857
- @return: PutWebtrackingResponse
15858
- """
15859
- runtime = util_models.RuntimeOptions()
15860
- headers = {}
15861
- return await self.put_webtracking_with_options_async(project, logstore_name, request, headers, runtime)
15862
-
15863
- def query_mlservice_results_with_options(
15864
- self,
15865
- service_name: str,
15866
- request: sls_20201230_models.QueryMLServiceResultsRequest,
15867
- headers: Dict[str, str],
15868
- runtime: util_models.RuntimeOptions,
15869
- ) -> sls_20201230_models.QueryMLServiceResultsResponse:
15870
- """
15871
- @deprecated OpenAPI QueryMLServiceResults is deprecated
15872
-
15873
- @summary queryMLServiceResults
15874
-
15875
- @param request: QueryMLServiceResultsRequest
15876
- @param headers: map
15877
- @param runtime: runtime options for this request RuntimeOptions
15878
- @return: QueryMLServiceResultsResponse
15879
- Deprecated
15880
- """
15881
- UtilClient.validate_model(request)
15882
- query = {}
15883
- if not UtilClient.is_unset(request.allow_builtin):
15884
- query['allowBuiltin'] = request.allow_builtin
15885
- req = open_api_models.OpenApiRequest(
15886
- headers=headers,
15887
- query=OpenApiUtilClient.query(query),
15888
- body=OpenApiUtilClient.parse_to_map(request.body)
15889
- )
15890
- params = open_api_models.Params(
15891
- action='QueryMLServiceResults',
15892
- version='2020-12-30',
15893
- protocol='HTTPS',
15894
- pathname=f'/ml/service/{service_name}/analysis',
15895
- method='POST',
15896
- auth_type='AK',
15897
- style='ROA',
15898
- req_body_type='json',
15899
- body_type='json'
15900
- )
15901
- return TeaCore.from_map(
15902
- sls_20201230_models.QueryMLServiceResultsResponse(),
15903
- self.execute(params, req, runtime)
15904
- )
15905
-
15906
- async def query_mlservice_results_with_options_async(
15907
- self,
15908
- service_name: str,
15909
- request: sls_20201230_models.QueryMLServiceResultsRequest,
15910
- headers: Dict[str, str],
15911
- runtime: util_models.RuntimeOptions,
15912
- ) -> sls_20201230_models.QueryMLServiceResultsResponse:
15913
- """
15914
- @deprecated OpenAPI QueryMLServiceResults is deprecated
15915
-
15916
- @summary queryMLServiceResults
16424
+ If you want to collect a large amount of log data, you can call this operation to send multiple logs to Simple Log Service in one request.
16425
+ Before you can call this operation to send logs to a Logstore, you must enable web tracking for the Logstore. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
16426
+ You cannot call this operation to send the logs of multiple topics to Simple Log Service at a time.
16427
+ If you call this operation, anonymous users from the Internet are granted the write permissions on the Logstore. This may generate dirty data because AccessKey pair-based authentication is not performed.
15917
16428
 
15918
- @param request: QueryMLServiceResultsRequest
16429
+ @param request: PutWebtrackingRequest
15919
16430
  @param headers: map
15920
16431
  @param runtime: runtime options for this request RuntimeOptions
15921
- @return: QueryMLServiceResultsResponse
15922
- Deprecated
16432
+ @return: PutWebtrackingResponse
15923
16433
  """
15924
16434
  UtilClient.validate_model(request)
15925
- query = {}
15926
- if not UtilClient.is_unset(request.allow_builtin):
15927
- query['allowBuiltin'] = request.allow_builtin
16435
+ host_map = {}
16436
+ host_map['project'] = project
16437
+ body = {}
16438
+ if not UtilClient.is_unset(request.logs):
16439
+ body['__logs__'] = request.logs
16440
+ if not UtilClient.is_unset(request.source):
16441
+ body['__source__'] = request.source
16442
+ if not UtilClient.is_unset(request.tags):
16443
+ body['__tags__'] = request.tags
16444
+ if not UtilClient.is_unset(request.topic):
16445
+ body['__topic__'] = request.topic
15928
16446
  req = open_api_models.OpenApiRequest(
16447
+ host_map=host_map,
15929
16448
  headers=headers,
15930
- query=OpenApiUtilClient.query(query),
15931
- body=OpenApiUtilClient.parse_to_map(request.body)
16449
+ body=OpenApiUtilClient.parse_to_map(body)
15932
16450
  )
15933
16451
  params = open_api_models.Params(
15934
- action='QueryMLServiceResults',
16452
+ action='PutWebtracking',
15935
16453
  version='2020-12-30',
15936
16454
  protocol='HTTPS',
15937
- pathname=f'/ml/service/{service_name}/analysis',
16455
+ pathname=f'/logstores/{logstore_name}/track',
15938
16456
  method='POST',
15939
- auth_type='AK',
16457
+ auth_type='Anonymous',
15940
16458
  style='ROA',
15941
16459
  req_body_type='json',
15942
- body_type='json'
16460
+ body_type='none'
15943
16461
  )
15944
16462
  return TeaCore.from_map(
15945
- sls_20201230_models.QueryMLServiceResultsResponse(),
16463
+ sls_20201230_models.PutWebtrackingResponse(),
15946
16464
  await self.execute_async(params, req, runtime)
15947
16465
  )
15948
16466
 
15949
- def query_mlservice_results(
16467
+ def put_webtracking(
15950
16468
  self,
15951
- service_name: str,
15952
- request: sls_20201230_models.QueryMLServiceResultsRequest,
15953
- ) -> sls_20201230_models.QueryMLServiceResultsResponse:
16469
+ project: str,
16470
+ logstore_name: str,
16471
+ request: sls_20201230_models.PutWebtrackingRequest,
16472
+ ) -> sls_20201230_models.PutWebtrackingResponse:
15954
16473
  """
15955
- @deprecated OpenAPI QueryMLServiceResults is deprecated
16474
+ @summary Sends multiple logs to Simple Log Service in one request.
15956
16475
 
15957
- @summary queryMLServiceResults
16476
+ @description ### [](#)Usage notes
16477
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
16478
+ You can call this operation to collect logs from web pages or clients.
16479
+ If you use web tracking to collect logs and you do not call this operation, you can send only one log to Simple Log Service in a request. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
16480
+ If you want to collect a large amount of log data, you can call this operation to send multiple logs to Simple Log Service in one request.
16481
+ Before you can call this operation to send logs to a Logstore, you must enable web tracking for the Logstore. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
16482
+ You cannot call this operation to send the logs of multiple topics to Simple Log Service at a time.
16483
+ If you call this operation, anonymous users from the Internet are granted the write permissions on the Logstore. This may generate dirty data because AccessKey pair-based authentication is not performed.
15958
16484
 
15959
- @param request: QueryMLServiceResultsRequest
15960
- @return: QueryMLServiceResultsResponse
15961
- Deprecated
16485
+ @param request: PutWebtrackingRequest
16486
+ @return: PutWebtrackingResponse
15962
16487
  """
15963
16488
  runtime = util_models.RuntimeOptions()
15964
16489
  headers = {}
15965
- return self.query_mlservice_results_with_options(service_name, request, headers, runtime)
16490
+ return self.put_webtracking_with_options(project, logstore_name, request, headers, runtime)
15966
16491
 
15967
- async def query_mlservice_results_async(
16492
+ async def put_webtracking_async(
15968
16493
  self,
15969
- service_name: str,
15970
- request: sls_20201230_models.QueryMLServiceResultsRequest,
15971
- ) -> sls_20201230_models.QueryMLServiceResultsResponse:
16494
+ project: str,
16495
+ logstore_name: str,
16496
+ request: sls_20201230_models.PutWebtrackingRequest,
16497
+ ) -> sls_20201230_models.PutWebtrackingResponse:
15972
16498
  """
15973
- @deprecated OpenAPI QueryMLServiceResults is deprecated
16499
+ @summary Sends multiple logs to Simple Log Service in one request.
15974
16500
 
15975
- @summary queryMLServiceResults
16501
+ @description ### [](#)Usage notes
16502
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
16503
+ You can call this operation to collect logs from web pages or clients.
16504
+ If you use web tracking to collect logs and you do not call this operation, you can send only one log to Simple Log Service in a request. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
16505
+ If you want to collect a large amount of log data, you can call this operation to send multiple logs to Simple Log Service in one request.
16506
+ Before you can call this operation to send logs to a Logstore, you must enable web tracking for the Logstore. For more information, see [Use web tracking to collect logs](https://help.aliyun.com/document_detail/31752.html).
16507
+ You cannot call this operation to send the logs of multiple topics to Simple Log Service at a time.
16508
+ If you call this operation, anonymous users from the Internet are granted the write permissions on the Logstore. This may generate dirty data because AccessKey pair-based authentication is not performed.
15976
16509
 
15977
- @param request: QueryMLServiceResultsRequest
15978
- @return: QueryMLServiceResultsResponse
15979
- Deprecated
16510
+ @param request: PutWebtrackingRequest
16511
+ @return: PutWebtrackingResponse
15980
16512
  """
15981
16513
  runtime = util_models.RuntimeOptions()
15982
16514
  headers = {}
15983
- return await self.query_mlservice_results_with_options_async(service_name, request, headers, runtime)
16515
+ return await self.put_webtracking_with_options_async(project, logstore_name, request, headers, runtime)
15984
16516
 
15985
16517
  def refresh_token_with_options(
15986
16518
  self,
@@ -17960,6 +18492,14 @@ class Client(OpenApiClient):
17960
18492
 
17961
18493
  @description ### Usage notes
17962
18494
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
18495
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
18496
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
18497
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
18498
+ ### Authentication resources
18499
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
18500
+ |Action|Resource|
18501
+ |:---|:---|
18502
+ |`log:UpdateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
17963
18503
 
17964
18504
  @param request: UpdateConsumerGroupRequest
17965
18505
  @param headers: map
@@ -18009,6 +18549,14 @@ class Client(OpenApiClient):
18009
18549
 
18010
18550
  @description ### Usage notes
18011
18551
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
18552
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
18553
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
18554
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
18555
+ ### Authentication resources
18556
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
18557
+ |Action|Resource|
18558
+ |:---|:---|
18559
+ |`log:UpdateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
18012
18560
 
18013
18561
  @param request: UpdateConsumerGroupRequest
18014
18562
  @param headers: map
@@ -18056,6 +18604,14 @@ class Client(OpenApiClient):
18056
18604
 
18057
18605
  @description ### Usage notes
18058
18606
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
18607
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
18608
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
18609
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
18610
+ ### Authentication resources
18611
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
18612
+ |Action|Resource|
18613
+ |:---|:---|
18614
+ |`log:UpdateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
18059
18615
 
18060
18616
  @param request: UpdateConsumerGroupRequest
18061
18617
  @return: UpdateConsumerGroupResponse
@@ -18076,6 +18632,14 @@ class Client(OpenApiClient):
18076
18632
 
18077
18633
  @description ### Usage notes
18078
18634
  Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
18635
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
18636
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
18637
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
18638
+ ### Authentication resources
18639
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
18640
+ |Action|Resource|
18641
+ |:---|:---|
18642
+ |`log:UpdateConsumerGroup`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`|
18079
18643
 
18080
18644
  @param request: UpdateConsumerGroupRequest
18081
18645
  @return: UpdateConsumerGroupResponse
@@ -18378,25 +18942,10 @@ class Client(OpenApiClient):
18378
18942
  UtilClient.validate_model(request)
18379
18943
  host_map = {}
18380
18944
  host_map['project'] = project
18381
- body = {}
18382
- if not UtilClient.is_unset(request.keys):
18383
- body['keys'] = request.keys
18384
- if not UtilClient.is_unset(request.line):
18385
- body['line'] = request.line
18386
- if not UtilClient.is_unset(request.log_reduce):
18387
- body['log_reduce'] = request.log_reduce
18388
- if not UtilClient.is_unset(request.log_reduce_black_list):
18389
- body['log_reduce_black_list'] = request.log_reduce_black_list
18390
- if not UtilClient.is_unset(request.log_reduce_white_list):
18391
- body['log_reduce_white_list'] = request.log_reduce_white_list
18392
- if not UtilClient.is_unset(request.max_text_len):
18393
- body['max_text_len'] = request.max_text_len
18394
- if not UtilClient.is_unset(request.ttl):
18395
- body['ttl'] = request.ttl
18396
18945
  req = open_api_models.OpenApiRequest(
18397
18946
  host_map=host_map,
18398
18947
  headers=headers,
18399
- body=OpenApiUtilClient.parse_to_map(body)
18948
+ body=OpenApiUtilClient.parse_to_map(request.body)
18400
18949
  )
18401
18950
  params = open_api_models.Params(
18402
18951
  action='UpdateIndex',
@@ -18436,25 +18985,10 @@ class Client(OpenApiClient):
18436
18985
  UtilClient.validate_model(request)
18437
18986
  host_map = {}
18438
18987
  host_map['project'] = project
18439
- body = {}
18440
- if not UtilClient.is_unset(request.keys):
18441
- body['keys'] = request.keys
18442
- if not UtilClient.is_unset(request.line):
18443
- body['line'] = request.line
18444
- if not UtilClient.is_unset(request.log_reduce):
18445
- body['log_reduce'] = request.log_reduce
18446
- if not UtilClient.is_unset(request.log_reduce_black_list):
18447
- body['log_reduce_black_list'] = request.log_reduce_black_list
18448
- if not UtilClient.is_unset(request.log_reduce_white_list):
18449
- body['log_reduce_white_list'] = request.log_reduce_white_list
18450
- if not UtilClient.is_unset(request.max_text_len):
18451
- body['max_text_len'] = request.max_text_len
18452
- if not UtilClient.is_unset(request.ttl):
18453
- body['ttl'] = request.ttl
18454
18988
  req = open_api_models.OpenApiRequest(
18455
18989
  host_map=host_map,
18456
18990
  headers=headers,
18457
- body=OpenApiUtilClient.parse_to_map(body)
18991
+ body=OpenApiUtilClient.parse_to_map(request.body)
18458
18992
  )
18459
18993
  params = open_api_models.Params(
18460
18994
  action='UpdateIndex',
@@ -18552,8 +19086,6 @@ class Client(OpenApiClient):
18552
19086
  body['maxSplitShard'] = request.max_split_shard
18553
19087
  if not UtilClient.is_unset(request.mode):
18554
19088
  body['mode'] = request.mode
18555
- if not UtilClient.is_unset(request.processor_id):
18556
- body['processorId'] = request.processor_id
18557
19089
  if not UtilClient.is_unset(request.shard_count):
18558
19090
  body['shardCount'] = request.shard_count
18559
19091
  if not UtilClient.is_unset(request.telemetry_type):
@@ -18623,8 +19155,6 @@ class Client(OpenApiClient):
18623
19155
  body['maxSplitShard'] = request.max_split_shard
18624
19156
  if not UtilClient.is_unset(request.mode):
18625
19157
  body['mode'] = request.mode
18626
- if not UtilClient.is_unset(request.processor_id):
18627
- body['processorId'] = request.processor_id
18628
19158
  if not UtilClient.is_unset(request.shard_count):
18629
19159
  body['shardCount'] = request.shard_count
18630
19160
  if not UtilClient.is_unset(request.telemetry_type):
@@ -18692,6 +19222,132 @@ class Client(OpenApiClient):
18692
19222
  headers = {}
18693
19223
  return await self.update_log_store_with_options_async(project, logstore, request, headers, runtime)
18694
19224
 
19225
+ def update_log_store_encryption_with_options(
19226
+ self,
19227
+ project: str,
19228
+ logstore: str,
19229
+ request: sls_20201230_models.UpdateLogStoreEncryptionRequest,
19230
+ headers: Dict[str, str],
19231
+ runtime: util_models.RuntimeOptions,
19232
+ ) -> sls_20201230_models.UpdateLogStoreEncryptionResponse:
19233
+ """
19234
+ @summary 更新日志库的加密配置
19235
+
19236
+ @param request: UpdateLogStoreEncryptionRequest
19237
+ @param headers: map
19238
+ @param runtime: runtime options for this request RuntimeOptions
19239
+ @return: UpdateLogStoreEncryptionResponse
19240
+ """
19241
+ UtilClient.validate_model(request)
19242
+ host_map = {}
19243
+ host_map['project'] = project
19244
+ body = {}
19245
+ if not UtilClient.is_unset(request.enable):
19246
+ body['enable'] = request.enable
19247
+ if not UtilClient.is_unset(request.encrypt_type):
19248
+ body['encryptType'] = request.encrypt_type
19249
+ if not UtilClient.is_unset(request.user_cmk_info):
19250
+ body['userCmkInfo'] = request.user_cmk_info
19251
+ req = open_api_models.OpenApiRequest(
19252
+ host_map=host_map,
19253
+ headers=headers,
19254
+ body=OpenApiUtilClient.parse_to_map(body)
19255
+ )
19256
+ params = open_api_models.Params(
19257
+ action='UpdateLogStoreEncryption',
19258
+ version='2020-12-30',
19259
+ protocol='HTTPS',
19260
+ pathname=f'/logstores/{logstore}/encryption',
19261
+ method='PUT',
19262
+ auth_type='AK',
19263
+ style='ROA',
19264
+ req_body_type='json',
19265
+ body_type='none'
19266
+ )
19267
+ return TeaCore.from_map(
19268
+ sls_20201230_models.UpdateLogStoreEncryptionResponse(),
19269
+ self.execute(params, req, runtime)
19270
+ )
19271
+
19272
+ async def update_log_store_encryption_with_options_async(
19273
+ self,
19274
+ project: str,
19275
+ logstore: str,
19276
+ request: sls_20201230_models.UpdateLogStoreEncryptionRequest,
19277
+ headers: Dict[str, str],
19278
+ runtime: util_models.RuntimeOptions,
19279
+ ) -> sls_20201230_models.UpdateLogStoreEncryptionResponse:
19280
+ """
19281
+ @summary 更新日志库的加密配置
19282
+
19283
+ @param request: UpdateLogStoreEncryptionRequest
19284
+ @param headers: map
19285
+ @param runtime: runtime options for this request RuntimeOptions
19286
+ @return: UpdateLogStoreEncryptionResponse
19287
+ """
19288
+ UtilClient.validate_model(request)
19289
+ host_map = {}
19290
+ host_map['project'] = project
19291
+ body = {}
19292
+ if not UtilClient.is_unset(request.enable):
19293
+ body['enable'] = request.enable
19294
+ if not UtilClient.is_unset(request.encrypt_type):
19295
+ body['encryptType'] = request.encrypt_type
19296
+ if not UtilClient.is_unset(request.user_cmk_info):
19297
+ body['userCmkInfo'] = request.user_cmk_info
19298
+ req = open_api_models.OpenApiRequest(
19299
+ host_map=host_map,
19300
+ headers=headers,
19301
+ body=OpenApiUtilClient.parse_to_map(body)
19302
+ )
19303
+ params = open_api_models.Params(
19304
+ action='UpdateLogStoreEncryption',
19305
+ version='2020-12-30',
19306
+ protocol='HTTPS',
19307
+ pathname=f'/logstores/{logstore}/encryption',
19308
+ method='PUT',
19309
+ auth_type='AK',
19310
+ style='ROA',
19311
+ req_body_type='json',
19312
+ body_type='none'
19313
+ )
19314
+ return TeaCore.from_map(
19315
+ sls_20201230_models.UpdateLogStoreEncryptionResponse(),
19316
+ await self.execute_async(params, req, runtime)
19317
+ )
19318
+
19319
+ def update_log_store_encryption(
19320
+ self,
19321
+ project: str,
19322
+ logstore: str,
19323
+ request: sls_20201230_models.UpdateLogStoreEncryptionRequest,
19324
+ ) -> sls_20201230_models.UpdateLogStoreEncryptionResponse:
19325
+ """
19326
+ @summary 更新日志库的加密配置
19327
+
19328
+ @param request: UpdateLogStoreEncryptionRequest
19329
+ @return: UpdateLogStoreEncryptionResponse
19330
+ """
19331
+ runtime = util_models.RuntimeOptions()
19332
+ headers = {}
19333
+ return self.update_log_store_encryption_with_options(project, logstore, request, headers, runtime)
19334
+
19335
+ async def update_log_store_encryption_async(
19336
+ self,
19337
+ project: str,
19338
+ logstore: str,
19339
+ request: sls_20201230_models.UpdateLogStoreEncryptionRequest,
19340
+ ) -> sls_20201230_models.UpdateLogStoreEncryptionResponse:
19341
+ """
19342
+ @summary 更新日志库的加密配置
19343
+
19344
+ @param request: UpdateLogStoreEncryptionRequest
19345
+ @return: UpdateLogStoreEncryptionResponse
19346
+ """
19347
+ runtime = util_models.RuntimeOptions()
19348
+ headers = {}
19349
+ return await self.update_log_store_encryption_with_options_async(project, logstore, request, headers, runtime)
19350
+
18695
19351
  def update_log_store_metering_mode_with_options(
18696
19352
  self,
18697
19353
  project: str,
@@ -19365,7 +20021,16 @@ class Client(OpenApiClient):
19365
20021
  runtime: util_models.RuntimeOptions,
19366
20022
  ) -> sls_20201230_models.UpdateMetricStoreResponse:
19367
20023
  """
19368
- @summary 更新时序库
20024
+ @summary Updates the settings of an existing Metricstore. Metricstores are used to store metric data.
20025
+
20026
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
20027
+ You must specify an existing Metricstore.
20028
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
20029
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
20030
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
20031
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
20032
+ You can create up to 200 Logstores or Metricstores in a project.
20033
+ Metric data is automatically deleted when the retention period of the metric data ends.
19369
20034
 
19370
20035
  @param request: UpdateMetricStoreRequest
19371
20036
  @param headers: map
@@ -19414,7 +20079,16 @@ class Client(OpenApiClient):
19414
20079
  runtime: util_models.RuntimeOptions,
19415
20080
  ) -> sls_20201230_models.UpdateMetricStoreResponse:
19416
20081
  """
19417
- @summary 更新时序库
20082
+ @summary Updates the settings of an existing Metricstore. Metricstores are used to store metric data.
20083
+
20084
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
20085
+ You must specify an existing Metricstore.
20086
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
20087
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
20088
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
20089
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
20090
+ You can create up to 200 Logstores or Metricstores in a project.
20091
+ Metric data is automatically deleted when the retention period of the metric data ends.
19418
20092
 
19419
20093
  @param request: UpdateMetricStoreRequest
19420
20094
  @param headers: map
@@ -19461,7 +20135,16 @@ class Client(OpenApiClient):
19461
20135
  request: sls_20201230_models.UpdateMetricStoreRequest,
19462
20136
  ) -> sls_20201230_models.UpdateMetricStoreResponse:
19463
20137
  """
19464
- @summary 更新时序库
20138
+ @summary Updates the settings of an existing Metricstore. Metricstores are used to store metric data.
20139
+
20140
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
20141
+ You must specify an existing Metricstore.
20142
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
20143
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
20144
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
20145
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
20146
+ You can create up to 200 Logstores or Metricstores in a project.
20147
+ Metric data is automatically deleted when the retention period of the metric data ends.
19465
20148
 
19466
20149
  @param request: UpdateMetricStoreRequest
19467
20150
  @return: UpdateMetricStoreResponse
@@ -19477,7 +20160,16 @@ class Client(OpenApiClient):
19477
20160
  request: sls_20201230_models.UpdateMetricStoreRequest,
19478
20161
  ) -> sls_20201230_models.UpdateMetricStoreResponse:
19479
20162
  """
19480
- @summary 更新时序库
20163
+ @summary Updates the settings of an existing Metricstore. Metricstores are used to store metric data.
20164
+
20165
+ @description Metricstores are used to store metric data. For more information, see [Metric data](https://help.aliyun.com/document_detail/174965.html).
20166
+ You must specify an existing Metricstore.
20167
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
20168
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
20169
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O\\&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
20170
+ The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html).
20171
+ You can create up to 200 Logstores or Metricstores in a project.
20172
+ Metric data is automatically deleted when the retention period of the metric data ends.
19481
20173
 
19482
20174
  @param request: UpdateMetricStoreRequest
19483
20175
  @return: UpdateMetricStoreResponse
@@ -20423,6 +21115,18 @@ class Client(OpenApiClient):
20423
21115
  """
20424
21116
  @summary Updates a saved search.
20425
21117
 
21118
+ @description ### Usage notes
21119
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
21120
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
21121
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
21122
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
21123
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
21124
+ ### Authentication resources
21125
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
21126
+ |Action|Resource|
21127
+ |:---|:---|
21128
+ |`log:UpdateSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
21129
+
20426
21130
  @param request: UpdateSavedSearchRequest
20427
21131
  @param headers: map
20428
21132
  @param runtime: runtime options for this request RuntimeOptions
@@ -20474,6 +21178,18 @@ class Client(OpenApiClient):
20474
21178
  """
20475
21179
  @summary Updates a saved search.
20476
21180
 
21181
+ @description ### Usage notes
21182
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
21183
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
21184
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
21185
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
21186
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
21187
+ ### Authentication resources
21188
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
21189
+ |Action|Resource|
21190
+ |:---|:---|
21191
+ |`log:UpdateSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
21192
+
20477
21193
  @param request: UpdateSavedSearchRequest
20478
21194
  @param headers: map
20479
21195
  @param runtime: runtime options for this request RuntimeOptions
@@ -20523,6 +21239,18 @@ class Client(OpenApiClient):
20523
21239
  """
20524
21240
  @summary Updates a saved search.
20525
21241
 
21242
+ @description ### Usage notes
21243
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
21244
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
21245
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
21246
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
21247
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
21248
+ ### Authentication resources
21249
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
21250
+ |Action|Resource|
21251
+ |:---|:---|
21252
+ |`log:UpdateSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
21253
+
20526
21254
  @param request: UpdateSavedSearchRequest
20527
21255
  @return: UpdateSavedSearchResponse
20528
21256
  """
@@ -20539,6 +21267,18 @@ class Client(OpenApiClient):
20539
21267
  """
20540
21268
  @summary Updates a saved search.
20541
21269
 
21270
+ @description ### Usage notes
21271
+ Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
21272
+ An AccessKey pair is created and obtained. For more information, see [AccessKey pair](https://help.aliyun.com/document_detail/29009.html).
21273
+ The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see [Create a RAM user and authorize the RAM user to access Simple Log Service](https://help.aliyun.com/document_detail/47664.html).
21274
+ The information that is required to query logs is obtained. The information includes the name of the project to which the logs belong, the region of the project, and the name of the Logstore to which the logs belong. For more information, see [Manage a project](https://help.aliyun.com/document_detail/48984.html) and [Manage a Logstore](https://help.aliyun.com/document_detail/48990.html).
21275
+ Limits are imposed when you use Simple Log Service to query logs. We recommend that you specify query statements and query time ranges based on the limits. For more information, see [Log search overview](https://help.aliyun.com/document_detail/43772.html) and [Log analysis overview](https://help.aliyun.com/document_detail/53608.html).
21276
+ ### Authentication resources
21277
+ The following table describes the authorization information that is required for this operation. You can add the information to the Action element of a RAM policy statement to grant a RAM user or a RAM role the permissions to call this operation.
21278
+ |Action|Resource|
21279
+ |:---|:---|
21280
+ |`log:UpdateSavedSearch`|`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/savedsearch/{#SavedSearchName}`|
21281
+
20542
21282
  @param request: UpdateSavedSearchRequest
20543
21283
  @return: UpdateSavedSearchResponse
20544
21284
  """