tencentcloud-sdk-python 3.0.1422__py2.py3-none-any.whl → 3.0.1423__py2.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.
@@ -14,17 +14,8 @@
14
14
  # limitations under the License.
15
15
 
16
16
 
17
- # 未开通。
18
- FAILEDOPERATION_ERRNOTOPEN = 'FailedOperation.ErrNotOpen'
19
-
20
- # 欠费。
21
- FAILEDOPERATION_ERROWED = 'FailedOperation.ErrOwed'
22
-
23
17
  # 内部错误。
24
18
  INTERNALERROR = 'InternalError'
25
19
 
26
- # 参数取值错误。
27
- INVALIDPARAMETERVALUE = 'InvalidParameterValue'
28
-
29
- # 操作不支持。
30
- UNSUPPORTEDOPERATION = 'UnsupportedOperation'
20
+ # 参数错误。
21
+ INVALIDPARAMETER = 'InvalidParameter'
@@ -18,216 +18,83 @@ import warnings
18
18
  from tencentcloud.common.abstract_model import AbstractModel
19
19
 
20
20
 
21
- class DataPoint(AbstractModel):
22
- """监控数据点
21
+ class DescribeAlarmNotifyHistoriesRequest(AbstractModel):
22
+ """DescribeAlarmNotifyHistories请求参数结构体
23
23
 
24
24
  """
25
25
 
26
26
  def __init__(self):
27
27
  r"""
28
- :param _Dimensions: 实例对象维度组合
29
- :type Dimensions: list of Dimension
30
- :param _Timestamps: 时间戳数组,表示那些时间点有数据,缺失的时间戳,没有数据点,可以理解为掉点了
31
- :type Timestamps: list of float
32
- :param _Values: 监控值数组,该数组和Timestamps一一对应
33
- :type Values: list of float
34
- """
35
- self._Dimensions = None
36
- self._Timestamps = None
37
- self._Values = None
38
-
39
- @property
40
- def Dimensions(self):
41
- """实例对象维度组合
42
- :rtype: list of Dimension
43
- """
44
- return self._Dimensions
45
-
46
- @Dimensions.setter
47
- def Dimensions(self, Dimensions):
48
- self._Dimensions = Dimensions
49
-
50
- @property
51
- def Timestamps(self):
52
- """时间戳数组,表示那些时间点有数据,缺失的时间戳,没有数据点,可以理解为掉点了
53
- :rtype: list of float
54
- """
55
- return self._Timestamps
56
-
57
- @Timestamps.setter
58
- def Timestamps(self, Timestamps):
59
- self._Timestamps = Timestamps
60
-
61
- @property
62
- def Values(self):
63
- """监控值数组,该数组和Timestamps一一对应
64
- :rtype: list of float
65
- """
66
- return self._Values
67
-
68
- @Values.setter
69
- def Values(self, Values):
70
- self._Values = Values
71
-
72
-
73
- def _deserialize(self, params):
74
- if params.get("Dimensions") is not None:
75
- self._Dimensions = []
76
- for item in params.get("Dimensions"):
77
- obj = Dimension()
78
- obj._deserialize(item)
79
- self._Dimensions.append(obj)
80
- self._Timestamps = params.get("Timestamps")
81
- self._Values = params.get("Values")
82
- memeber_set = set(params.keys())
83
- for name, value in vars(self).items():
84
- property_name = name[1:]
85
- if property_name in memeber_set:
86
- memeber_set.remove(property_name)
87
- if len(memeber_set) > 0:
88
- warnings.warn("%s fileds are useless." % ",".join(memeber_set))
89
-
90
-
91
-
92
- class Dimension(AbstractModel):
93
- """实例对象的维度组合
94
-
95
- """
96
-
97
- def __init__(self):
98
- r"""
99
- :param _Name: 实例维度名称
100
- 注意:此字段可能返回 null,表示取不到有效值。
101
- :type Name: str
102
- :param _Value: 实例维度值
103
- 注意:此字段可能返回 null,表示取不到有效值。
104
- :type Value: str
105
- """
106
- self._Name = None
107
- self._Value = None
28
+ :param _MonitorType: 监控类型
29
+ :type MonitorType: str
30
+ :param _QueryBaseTime: 起始时间点,unix秒级时间戳
31
+ :type QueryBaseTime: int
32
+ :param _QueryBeforeSeconds: 从 QueryBaseTime 开始,需要查询往前多久的时间,单位秒
33
+ :type QueryBeforeSeconds: int
34
+ :param _PageParams: 分页参数
35
+ :type PageParams: :class:`tencentcloud.monitor.v20230616.models.PageByNoParams`
36
+ :param _Namespace: 当监控类型为 MT_QCE 时候需要填写,归属的命名空间
37
+ :type Namespace: str
38
+ :param _ModelName: 当监控类型为 MT_QCE 时候需要填写, 告警策略类型
39
+ :type ModelName: str
40
+ :param _PolicyId: 查询某个策略的通知历史
41
+ :type PolicyId: str
42
+ """
43
+ self._MonitorType = None
44
+ self._QueryBaseTime = None
45
+ self._QueryBeforeSeconds = None
46
+ self._PageParams = None
47
+ self._Namespace = None
48
+ self._ModelName = None
49
+ self._PolicyId = None
108
50
 
109
51
  @property
110
- def Name(self):
111
- """实例维度名称
112
- 注意:此字段可能返回 null,表示取不到有效值。
52
+ def MonitorType(self):
53
+ """监控类型
113
54
  :rtype: str
114
55
  """
115
- return self._Name
56
+ return self._MonitorType
116
57
 
117
- @Name.setter
118
- def Name(self, Name):
119
- self._Name = Name
58
+ @MonitorType.setter
59
+ def MonitorType(self, MonitorType):
60
+ self._MonitorType = MonitorType
120
61
 
121
62
  @property
122
- def Value(self):
123
- """实例维度值
124
- 注意:此字段可能返回 null,表示取不到有效值。
125
- :rtype: str
63
+ def QueryBaseTime(self):
64
+ """起始时间点,unix秒级时间戳
65
+ :rtype: int
126
66
  """
127
- return self._Value
128
-
129
- @Value.setter
130
- def Value(self, Value):
131
- self._Value = Value
132
-
133
-
134
- def _deserialize(self, params):
135
- self._Name = params.get("Name")
136
- self._Value = params.get("Value")
137
- memeber_set = set(params.keys())
138
- for name, value in vars(self).items():
139
- property_name = name[1:]
140
- if property_name in memeber_set:
141
- memeber_set.remove(property_name)
142
- if len(memeber_set) > 0:
143
- warnings.warn("%s fileds are useless." % ",".join(memeber_set))
144
-
67
+ return self._QueryBaseTime
145
68
 
146
-
147
- class Expr(AbstractModel):
148
- """计算算子
149
-
150
- """
151
-
152
- def __init__(self):
153
- r"""
154
- :param _Function: 算子名称
155
- :type Function: str
156
- :param _N: 算子入参值
157
- :type N: float
158
- """
159
- self._Function = None
160
- self._N = None
69
+ @QueryBaseTime.setter
70
+ def QueryBaseTime(self, QueryBaseTime):
71
+ self._QueryBaseTime = QueryBaseTime
161
72
 
162
73
  @property
163
- def Function(self):
164
- """算子名称
165
- :rtype: str
74
+ def QueryBeforeSeconds(self):
75
+ """从 QueryBaseTime 开始,需要查询往前多久的时间,单位秒
76
+ :rtype: int
166
77
  """
167
- return self._Function
78
+ return self._QueryBeforeSeconds
168
79
 
169
- @Function.setter
170
- def Function(self, Function):
171
- self._Function = Function
80
+ @QueryBeforeSeconds.setter
81
+ def QueryBeforeSeconds(self, QueryBeforeSeconds):
82
+ self._QueryBeforeSeconds = QueryBeforeSeconds
172
83
 
173
84
  @property
174
- def N(self):
175
- """算子入参值
176
- :rtype: float
85
+ def PageParams(self):
86
+ """分页参数
87
+ :rtype: :class:`tencentcloud.monitor.v20230616.models.PageByNoParams`
177
88
  """
178
- return self._N
89
+ return self._PageParams
179
90
 
180
- @N.setter
181
- def N(self, N):
182
- self._N = N
183
-
184
-
185
- def _deserialize(self, params):
186
- self._Function = params.get("Function")
187
- self._N = params.get("N")
188
- memeber_set = set(params.keys())
189
- for name, value in vars(self).items():
190
- property_name = name[1:]
191
- if property_name in memeber_set:
192
- memeber_set.remove(property_name)
193
- if len(memeber_set) > 0:
194
- warnings.warn("%s fileds are useless." % ",".join(memeber_set))
195
-
196
-
197
-
198
- class GetMonitorDataRequest(AbstractModel):
199
- """GetMonitorData请求参数结构体
200
-
201
- """
202
-
203
- def __init__(self):
204
- r"""
205
- :param _Namespace: 命名空间,如QCE/CVM。各个云产品的详细命名空间说明请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档
206
- :type Namespace: str
207
- :param _MetricName: 指标名称,如CPUUsage,仅支持单指标拉取。各个云产品的详细指标说明请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档,对应的指标英文名即为MetricName
208
- :type MetricName: str
209
- :param _Instances: 实例对象的维度组合,格式为key-value键值对形式的集合。不同类型的实例字段完全不同,如CVM为[{"Name":"InstanceId","Value":"ins-j0hk02zo"}],Ckafka为[{"Name":"instanceId","Value":"ckafka-l49k54dd"}],COS为[{"Name":"appid","Value":"1258344699"},{"Name":"bucket","Value":"rig-1258344699"}]。各个云产品的维度请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档,对应的维度列即为维度组合的key,value为key对应的值。单请求最多支持批量拉取10个实例的监控数据。
210
- :type Instances: list of Instance
211
- :param _Period: 监控统计周期,如60。默认为取值为300,单位为s。每个指标支持的统计周期不一定相同,各个云产品支持的统计周期请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档,对应的统计周期列即为支持的统计周期。单请求的数据点数限制为1440个。
212
- :type Period: int
213
- :param _StartTime: 起始时间,如2018-09-22T19:51:23+08:00
214
- :type StartTime: str
215
- :param _EndTime: 结束时间,如2018-09-22T20:51:23+08:00,默认为当前时间。 EndTime不能小于StartTime
216
- :type EndTime: str
217
- :param _Expr: 计算算子
218
- :type Expr: :class:`tencentcloud.monitor.v20230616.models.Expr`
219
- """
220
- self._Namespace = None
221
- self._MetricName = None
222
- self._Instances = None
223
- self._Period = None
224
- self._StartTime = None
225
- self._EndTime = None
226
- self._Expr = None
91
+ @PageParams.setter
92
+ def PageParams(self, PageParams):
93
+ self._PageParams = PageParams
227
94
 
228
95
  @property
229
96
  def Namespace(self):
230
- """命名空间,如QCE/CVM。各个云产品的详细命名空间说明请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档
97
+ """当监控类型为 MT_QCE 时候需要填写,归属的命名空间
231
98
  :rtype: str
232
99
  """
233
100
  return self._Namespace
@@ -237,87 +104,38 @@ class GetMonitorDataRequest(AbstractModel):
237
104
  self._Namespace = Namespace
238
105
 
239
106
  @property
240
- def MetricName(self):
241
- """指标名称,如CPUUsage,仅支持单指标拉取。各个云产品的详细指标说明请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档,对应的指标英文名即为MetricName
242
- :rtype: str
243
- """
244
- return self._MetricName
245
-
246
- @MetricName.setter
247
- def MetricName(self, MetricName):
248
- self._MetricName = MetricName
249
-
250
- @property
251
- def Instances(self):
252
- """实例对象的维度组合,格式为key-value键值对形式的集合。不同类型的实例字段完全不同,如CVM为[{"Name":"InstanceId","Value":"ins-j0hk02zo"}],Ckafka为[{"Name":"instanceId","Value":"ckafka-l49k54dd"}],COS为[{"Name":"appid","Value":"1258344699"},{"Name":"bucket","Value":"rig-1258344699"}]。各个云产品的维度请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档,对应的维度列即为维度组合的key,value为key对应的值。单请求最多支持批量拉取10个实例的监控数据。
253
- :rtype: list of Instance
254
- """
255
- return self._Instances
256
-
257
- @Instances.setter
258
- def Instances(self, Instances):
259
- self._Instances = Instances
260
-
261
- @property
262
- def Period(self):
263
- """监控统计周期,如60。默认为取值为300,单位为s。每个指标支持的统计周期不一定相同,各个云产品支持的统计周期请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档,对应的统计周期列即为支持的统计周期。单请求的数据点数限制为1440个。
264
- :rtype: int
265
- """
266
- return self._Period
267
-
268
- @Period.setter
269
- def Period(self, Period):
270
- self._Period = Period
271
-
272
- @property
273
- def StartTime(self):
274
- """起始时间,如2018-09-22T19:51:23+08:00
107
+ def ModelName(self):
108
+ """当监控类型为 MT_QCE 时候需要填写, 告警策略类型
275
109
  :rtype: str
276
110
  """
277
- return self._StartTime
111
+ return self._ModelName
278
112
 
279
- @StartTime.setter
280
- def StartTime(self, StartTime):
281
- self._StartTime = StartTime
113
+ @ModelName.setter
114
+ def ModelName(self, ModelName):
115
+ self._ModelName = ModelName
282
116
 
283
117
  @property
284
- def EndTime(self):
285
- """结束时间,如2018-09-22T20:51:23+08:00,默认为当前时间。 EndTime不能小于StartTime
118
+ def PolicyId(self):
119
+ """查询某个策略的通知历史
286
120
  :rtype: str
287
121
  """
288
- return self._EndTime
289
-
290
- @EndTime.setter
291
- def EndTime(self, EndTime):
292
- self._EndTime = EndTime
293
-
294
- @property
295
- def Expr(self):
296
- """计算算子
297
- :rtype: :class:`tencentcloud.monitor.v20230616.models.Expr`
298
- """
299
- return self._Expr
122
+ return self._PolicyId
300
123
 
301
- @Expr.setter
302
- def Expr(self, Expr):
303
- self._Expr = Expr
124
+ @PolicyId.setter
125
+ def PolicyId(self, PolicyId):
126
+ self._PolicyId = PolicyId
304
127
 
305
128
 
306
129
  def _deserialize(self, params):
130
+ self._MonitorType = params.get("MonitorType")
131
+ self._QueryBaseTime = params.get("QueryBaseTime")
132
+ self._QueryBeforeSeconds = params.get("QueryBeforeSeconds")
133
+ if params.get("PageParams") is not None:
134
+ self._PageParams = PageByNoParams()
135
+ self._PageParams._deserialize(params.get("PageParams"))
307
136
  self._Namespace = params.get("Namespace")
308
- self._MetricName = params.get("MetricName")
309
- if params.get("Instances") is not None:
310
- self._Instances = []
311
- for item in params.get("Instances"):
312
- obj = Instance()
313
- obj._deserialize(item)
314
- self._Instances.append(obj)
315
- self._Period = params.get("Period")
316
- self._StartTime = params.get("StartTime")
317
- self._EndTime = params.get("EndTime")
318
- if params.get("Expr") is not None:
319
- self._Expr = Expr()
320
- self._Expr._deserialize(params.get("Expr"))
137
+ self._ModelName = params.get("ModelName")
138
+ self._PolicyId = params.get("PolicyId")
321
139
  memeber_set = set(params.keys())
322
140
  for name, value in vars(self).items():
323
141
  property_name = name[1:]
@@ -328,102 +146,18 @@ class GetMonitorDataRequest(AbstractModel):
328
146
 
329
147
 
330
148
 
331
- class GetMonitorDataResponse(AbstractModel):
332
- """GetMonitorData返回参数结构体
149
+ class DescribeAlarmNotifyHistoriesResponse(AbstractModel):
150
+ """DescribeAlarmNotifyHistories返回参数结构体
333
151
 
334
152
  """
335
153
 
336
154
  def __init__(self):
337
155
  r"""
338
- :param _Period: 统计周期
339
- :type Period: int
340
- :param _MetricName: 指标名
341
- :type MetricName: str
342
- :param _DataPoints: 数据点数组
343
- :type DataPoints: list of DataPoint
344
- :param _StartTime: 开始时间
345
- :type StartTime: str
346
- :param _EndTime: 结束时间
347
- :type EndTime: str
348
- :param _Msg: 返回信息
349
- :type Msg: str
350
156
  :param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
351
157
  :type RequestId: str
352
158
  """
353
- self._Period = None
354
- self._MetricName = None
355
- self._DataPoints = None
356
- self._StartTime = None
357
- self._EndTime = None
358
- self._Msg = None
359
159
  self._RequestId = None
360
160
 
361
- @property
362
- def Period(self):
363
- """统计周期
364
- :rtype: int
365
- """
366
- return self._Period
367
-
368
- @Period.setter
369
- def Period(self, Period):
370
- self._Period = Period
371
-
372
- @property
373
- def MetricName(self):
374
- """指标名
375
- :rtype: str
376
- """
377
- return self._MetricName
378
-
379
- @MetricName.setter
380
- def MetricName(self, MetricName):
381
- self._MetricName = MetricName
382
-
383
- @property
384
- def DataPoints(self):
385
- """数据点数组
386
- :rtype: list of DataPoint
387
- """
388
- return self._DataPoints
389
-
390
- @DataPoints.setter
391
- def DataPoints(self, DataPoints):
392
- self._DataPoints = DataPoints
393
-
394
- @property
395
- def StartTime(self):
396
- """开始时间
397
- :rtype: str
398
- """
399
- return self._StartTime
400
-
401
- @StartTime.setter
402
- def StartTime(self, StartTime):
403
- self._StartTime = StartTime
404
-
405
- @property
406
- def EndTime(self):
407
- """结束时间
408
- :rtype: str
409
- """
410
- return self._EndTime
411
-
412
- @EndTime.setter
413
- def EndTime(self, EndTime):
414
- self._EndTime = EndTime
415
-
416
- @property
417
- def Msg(self):
418
- """返回信息
419
- :rtype: str
420
- """
421
- return self._Msg
422
-
423
- @Msg.setter
424
- def Msg(self, Msg):
425
- self._Msg = Msg
426
-
427
161
  @property
428
162
  def RequestId(self):
429
163
  """唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
@@ -437,53 +171,54 @@ class GetMonitorDataResponse(AbstractModel):
437
171
 
438
172
 
439
173
  def _deserialize(self, params):
440
- self._Period = params.get("Period")
441
- self._MetricName = params.get("MetricName")
442
- if params.get("DataPoints") is not None:
443
- self._DataPoints = []
444
- for item in params.get("DataPoints"):
445
- obj = DataPoint()
446
- obj._deserialize(item)
447
- self._DataPoints.append(obj)
448
- self._StartTime = params.get("StartTime")
449
- self._EndTime = params.get("EndTime")
450
- self._Msg = params.get("Msg")
451
174
  self._RequestId = params.get("RequestId")
452
175
 
453
176
 
454
- class Instance(AbstractModel):
455
- """实例维度组合数组
177
+ class PageByNoParams(AbstractModel):
178
+ """分页请求参数
456
179
 
457
180
  """
458
181
 
459
182
  def __init__(self):
460
183
  r"""
461
- :param _Dimensions: 实例的维度组合
184
+ :param _PerPage: 每个分页的数量是多少
462
185
  注意:此字段可能返回 null,表示取不到有效值。
463
- :type Dimensions: list of Dimension
186
+ :type PerPage: int
187
+ :param _PageNo: 第几个分页,从1开始
188
+ 注意:此字段可能返回 null,表示取不到有效值。
189
+ :type PageNo: str
190
+ """
191
+ self._PerPage = None
192
+ self._PageNo = None
193
+
194
+ @property
195
+ def PerPage(self):
196
+ """每个分页的数量是多少
197
+ 注意:此字段可能返回 null,表示取不到有效值。
198
+ :rtype: int
464
199
  """
465
- self._Dimensions = None
200
+ return self._PerPage
201
+
202
+ @PerPage.setter
203
+ def PerPage(self, PerPage):
204
+ self._PerPage = PerPage
466
205
 
467
206
  @property
468
- def Dimensions(self):
469
- """实例的维度组合
207
+ def PageNo(self):
208
+ """第几个分页,从1开始
470
209
  注意:此字段可能返回 null,表示取不到有效值。
471
- :rtype: list of Dimension
210
+ :rtype: str
472
211
  """
473
- return self._Dimensions
212
+ return self._PageNo
474
213
 
475
- @Dimensions.setter
476
- def Dimensions(self, Dimensions):
477
- self._Dimensions = Dimensions
214
+ @PageNo.setter
215
+ def PageNo(self, PageNo):
216
+ self._PageNo = PageNo
478
217
 
479
218
 
480
219
  def _deserialize(self, params):
481
- if params.get("Dimensions") is not None:
482
- self._Dimensions = []
483
- for item in params.get("Dimensions"):
484
- obj = Dimension()
485
- obj._deserialize(item)
486
- self._Dimensions.append(obj)
220
+ self._PerPage = params.get("PerPage")
221
+ self._PageNo = params.get("PageNo")
487
222
  memeber_set = set(params.keys())
488
223
  for name, value in vars(self).items():
489
224
  property_name = name[1:]
@@ -26,26 +26,20 @@ class MonitorClient(AbstractClient):
26
26
  _service = 'monitor'
27
27
 
28
28
 
29
- def GetMonitorData(self, request):
30
- """获取云产品的监控数据。此接口不适用于拉取容器服务监控数据,如需拉取容器服务监控数据,请使用[根据维度条件查询监控数据](https://cloud.tencent.com/document/product/248/51845)接口。
31
- 传入产品的命名空间、对象维度描述和监控指标即可获得相应的监控数据。
32
- 接口调用限制:单请求最多可支持批量拉取10个实例的监控数据,单请求的数据点数限制为1440个。
33
- 若您需要调用的指标、对象较多,可能存在因限频出现拉取失败的情况,建议尽量将请求按时间维度均摊。
29
+ def DescribeAlarmNotifyHistories(self, request):
30
+ """按需查询告警的通知历史
34
31
 
35
- >?
36
- >- 2022年9月1日起,云监控开始对GetMonitorData接口计费。每个主账号每月可获得100万次免费请求额度,超过免费额度后如需继续调用接口需要开通 [API请求按量付费](https://buy.cloud.tencent.com/APIRequestBuy)。计费规则可查看[API计费文档](https://cloud.tencent.com/document/product/248/77914)。
37
-
38
- :param request: Request instance for GetMonitorData.
39
- :type request: :class:`tencentcloud.monitor.v20230616.models.GetMonitorDataRequest`
40
- :rtype: :class:`tencentcloud.monitor.v20230616.models.GetMonitorDataResponse`
32
+ :param request: Request instance for DescribeAlarmNotifyHistories.
33
+ :type request: :class:`tencentcloud.monitor.v20230616.models.DescribeAlarmNotifyHistoriesRequest`
34
+ :rtype: :class:`tencentcloud.monitor.v20230616.models.DescribeAlarmNotifyHistoriesResponse`
41
35
 
42
36
  """
43
37
  try:
44
38
  params = request._serialize()
45
39
  headers = request.headers
46
- body = self.call("GetMonitorData", params, headers=headers)
40
+ body = self.call("DescribeAlarmNotifyHistories", params, headers=headers)
47
41
  response = json.loads(body)
48
- model = models.GetMonitorDataResponse()
42
+ model = models.DescribeAlarmNotifyHistoriesResponse()
49
43
  model._deserialize(response["Response"])
50
44
  return model
51
45
  except Exception as e: