tencentcloud-sdk-nodejs 4.0.1032 → 4.0.1033

package/src/services/mna/v20210119/mna_client.ts

@@ -36,6 +36,7 @@ import {
   GetFlowPackagesResponse,
   DeleteL3ConnRequest,
   GetVendorHardwareResponse,
+  GetActiveDeviceCountResponse,
   DeviceBaseInfo,
   AddGroupRequest,
   GetGroupListRequest,
@@ -73,18 +74,19 @@ import {
   SetNotifyUrlRequest,
   GetDevicePayModeRequest,
   Capacity,
-  Context,
+  GetFlowStatisticRequest,
   SlotNetInfo,
   DeviceNetInfo,
   NetDetails,
   CreateQosResponse,
   ActivateHardware,
+  DownloadActiveDeviceCountResponse,
   GetHardwareListRequest,
   FlowDetails,
   GroupDeleteDeviceRequest,
   DeviceDetails,
   GetFlowStatisticByRegionResponse,
-  ActivateHardwareRequest,
+  ActiveDeviceList,
   GetMultiFlowStatisticRequest,
   ExpectedThreshold,
   GetFlowAlarmInfoResponse,
@@ -93,6 +95,7 @@ import {
   UpdateGroupResponse,
   GetL3ConnListRequest,
   FlowPackageInfo,
+  DownloadActiveDeviceCountRequest,
   GetHardwareListResponse,
   AddDeviceRequest,
   OrderPerLicenseRequest,
@@ -105,15 +108,17 @@ import {
   OrderFlowPackageResponse,
   UpdateDeviceResponse,
   L3ConnInfo,
+  ActivateHardwareRequest,
   GroupAddDeviceResponse,
   GetStatisticDataRequest,
   UpdateDeviceRequest,
   DeleteGroupResponse,
   GetPublicKeyResponse,
   AddHardwareResponse,
-  GetFlowStatisticRequest,
+  Context,
   AddDeviceResponse,
   GetDevicePayModeResponse,
+  GetActiveDeviceCountRequest,
   UpdateL3ConnRequest,
   DevicePayModeInfo,
   MonitorData,
@@ -154,6 +159,16 @@ export class Client extends AbstractClient {
     return this.request("UpdateHardware", req, cb)
   }
 
+  /**
+   * 下载活跃设备数量统计
+   */
+  async DownloadActiveDeviceCount(
+    req: DownloadActiveDeviceCountRequest,
+    cb?: (error: string, rep: DownloadActiveDeviceCountResponse) => void
+  ): Promise<DownloadActiveDeviceCountResponse> {
+    return this.request("DownloadActiveDeviceCount", req, cb)
+  }
+
   /**
    * 可开启/关闭流量包自动续费，不影响当前周期正在生效的流量包。
    */
@@ -308,6 +323,16 @@ export class Client extends AbstractClient {
     return this.request("DescribeQos", req, cb)
   }
 
+  /**
+   * 活跃设备数量统计
+   */
+  async GetActiveDeviceCount(
+    req: GetActiveDeviceCountRequest,
+    cb?: (error: string, rep: GetActiveDeviceCountResponse) => void
+  ): Promise<GetActiveDeviceCountResponse> {
+    return this.request("GetActiveDeviceCount", req, cb)
+  }
+
   /**
    * 删除设备信息
    */

package/src/services/mna/v20210119/mna_models.ts

@@ -311,6 +311,44 @@ export interface GetVendorHardwareResponse {
   RequestId?: string
 }
 
+/**
+ * GetActiveDeviceCount返回参数结构体
+ */
+export interface GetActiveDeviceCountResponse {
+  /**
+   * 激活设备统计
+   */
+  ActiveDeviceList?: Array<ActiveDeviceList>
+  /**
+   * 查询粒度，0:day, 1:week, 2:month, 不传默认为day
+   */
+  Period?: number
+  /**
+   * 开始时间
+   */
+  StartTime?: string
+  /**
+   * 结束时间
+   */
+  EndTime?: string
+  /**
+   * 设备组
+   */
+  DevGroup?: string
+  /**
+   * license类型, 不传查询全部, 1: 租户月付，2：厂商月付，3：永久授权
+   */
+  LicenseType?: string
+  /**
+   * 租户ID
+   */
+  AppId?: string
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * 设备的基本信息
  */
@@ -1109,21 +1147,41 @@ export interface Capacity {
 }
 
 /**
- * 加速策略关键数据
+ * GetFlowStatistic请求参数结构体
  */
-export interface Context {
+export interface GetFlowStatisticRequest {
   /**
-   * 测速数据
+   * 设备ID
    */
-  NetworkData?: NetworkData
+  DeviceId: string
   /**
-   * 用户期望最低门限
+   * 开始查找时间
    */
-  ExpectedLowThreshold?: ExpectedThreshold
+  BeginTime: number
   /**
-   * 用户期望最高门限
+   * 截止时间
    */
-  ExpectedHighThreshold?: ExpectedThreshold
+  EndTime: number
+  /**
+   * 流量种类（1：上行流量，2：下行流量，3：上下行总和）
+   */
+  Type: number
+  /**
+   * 时间粒度（1：按小时统计，2：按天统计）
+   */
+  TimeGranularity: number
+  /**
+   * 接入区域。取值范围：['MC','AP','EU','AM'] MC=中国大陆 AP=亚太 EU=欧洲 AM=美洲。不填代表全量区域。
+   */
+  AccessRegion?: string
+  /**
+   * 网关类型。0：公有云网关；1：自有网关。不传默认为0。
+   */
+  GatewayType?: number
+  /**
+   * 设备ID列表，用于查询多设备流量，该字段启用时DeviceId可传"-1"
+   */
+  DeviceList?: Array<string>
 }
 
 /**
@@ -1310,6 +1368,20 @@ export interface ActivateHardware {
   DeviceId?: string
 }
 
+/**
+ * DownloadActiveDeviceCount返回参数结构体
+ */
+export interface DownloadActiveDeviceCountResponse {
+  /**
+   * URL地址
+   */
+  FilePath?: string
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * GetHardwareList请求参数结构体
  */
@@ -1421,13 +1493,17 @@ export interface GetFlowStatisticByRegionResponse {
 }
 
 /**
- * ActivateHardware请求参数结构体
+ * 激活设备数统计
  */
-export interface ActivateHardwareRequest {
+export interface ActiveDeviceList {
   /**
-   * 待激活的设备列表
+   * 数量
    */
-  Hardware: Array<ActivateHardware>
+  Count?: number
+  /**
+   * 时间
+   */
+  Time?: string
 }
 
 /**
@@ -1677,6 +1753,32 @@ DEVICE_5_FLOW_500G，分别代表20G、50G、100G、500G档位的流量包。
   CapacityRemainPrecise?: number
 }
 
+/**
+ * DownloadActiveDeviceCount请求参数结构体
+ */
+export interface DownloadActiveDeviceCountRequest {
+  /**
+   * 查询粒度。0:day, 1:week, 2:month, 不传默认为day
+   */
+  Period?: number
+  /**
+   * 开始时间。单位秒
+   */
+  StartTime?: number
+  /**
+   * 结束时间。单位秒
+   */
+  EndTime?: number
+  /**
+   * 设备组, 不传查询全部
+   */
+  DevGroup?: string
+  /**
+   * license类型, 不传查询全部, 1: 租户月付，2：厂商月付，3：永久授权
+   */
+  LicenseType?: number
+}
+
 /**
  * GetHardwareList返回参数结构体
  */
@@ -1959,6 +2061,16 @@ export interface L3ConnInfo {
   Description?: string
 }
 
+/**
+ * ActivateHardware请求参数结构体
+ */
+export interface ActivateHardwareRequest {
+  /**
+   * 待激活的设备列表
+   */
+  Hardware: Array<ActivateHardware>
+}
+
 /**
  * GroupAddDevice返回参数结构体
  */
@@ -2078,41 +2190,21 @@ export interface AddHardwareResponse {
 }
 
 /**
- * GetFlowStatistic请求参数结构体
+ * 加速策略关键数据
  */
-export interface GetFlowStatisticRequest {
-  /**
-   * 设备ID
-   */
-  DeviceId: string
-  /**
-   * 开始查找时间
-   */
-  BeginTime: number
-  /**
-   * 截止时间
-   */
-  EndTime: number
-  /**
-   * 流量种类（1：上行流量，2：下行流量，3：上下行总和）
-   */
-  Type: number
-  /**
-   * 时间粒度（1：按小时统计，2：按天统计）
-   */
-  TimeGranularity: number
+export interface Context {
   /**
-   * 接入区域。取值范围：['MC','AP','EU','AM'] MC=中国大陆 AP=亚太 EU=欧洲 AM=美洲。不填代表全量区域。
+   * 测速数据
    */
-  AccessRegion?: string
+  NetworkData?: NetworkData
   /**
-   * 网关类型。0：公有云网关；1：自有网关。不传默认为0。
+   * 用户期望最低门限
    */
-  GatewayType?: number
+  ExpectedLowThreshold?: ExpectedThreshold
   /**
-   * 设备ID列表，用于查询多设备流量，该字段启用时DeviceId可传"-1"
+   * 用户期望最高门限
    */
-  DeviceList?: Array<string>
+  ExpectedHighThreshold?: ExpectedThreshold
 }
 
 /**
@@ -2151,6 +2243,32 @@ export interface GetDevicePayModeResponse {
   RequestId?: string
 }
 
+/**
+ * GetActiveDeviceCount请求参数结构体
+ */
+export interface GetActiveDeviceCountRequest {
+  /**
+   * 查询粒度。0:day, 1:week, 2:month, 不传默认为day
+   */
+  Period?: number
+  /**
+   * 开始时间。单位秒
+   */
+  StartTime?: number
+  /**
+   * 结束时间。单位秒
+   */
+  EndTime?: number
+  /**
+   * 设备组, 不传查询全部
+   */
+  DevGroup?: string
+  /**
+   * license类型, 不传查询全部, 1: 租户月付，2：厂商月付，3：永久授权
+   */
+  LicenseType?: number
+}
+
 /**
  * UpdateL3Conn请求参数结构体
  */

package/src/services/monitor/index.ts

@@ -1,5 +1,7 @@
+import { v20230616 } from "./v20230616"
 import { v20180724 } from "./v20180724"
 
 export const monitor = {
+  v20230616: v20230616,
   v20180724: v20180724,
 }

package/src/services/monitor/v20230616/index.ts

@@ -0,0 +1,6 @@
+import * as Models from "./monitor_models"
+import { Client } from "./monitor_client"
+export const v20230616 = {
+  Client: Client,
+  Models: Models,
+}

package/src/services/monitor/v20230616/monitor_client.ts

@@ -0,0 +1,53 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/*
+ * Copyright (c) 2018 THL A29 Limited, a Tencent company. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { AbstractClient } from "../../../common/abstract_client"
+import { ClientConfig } from "../../../common/interface"
+import {
+  GetMonitorDataResponse,
+  Expr,
+  GetMonitorDataRequest,
+  Instance,
+  DataPoint,
+  Dimension,
+} from "./monitor_models"
+
+/**
+ * monitor client
+ * @class
+ */
+export class Client extends AbstractClient {
+  constructor(clientConfig: ClientConfig) {
+    super("monitor.tencentcloudapi.com", "2023-06-16", clientConfig)
+  }
+
+  /**
+     * 获取云产品的监控数据。此接口不适用于拉取容器服务监控数据，如需拉取容器服务监控数据，请使用[根据维度条件查询监控数据](https://cloud.tencent.com/document/product/248/51845)接口。
+传入产品的命名空间、对象维度描述和监控指标即可获得相应的监控数据。
+接口调用限制：单请求最多可支持批量拉取10个实例的监控数据，单请求的数据点数限制为1440个。
+若您需要调用的指标、对象较多，可能存在因限频出现拉取失败的情况，建议尽量将请求按时间维度均摊。
+
+>?
+>- 2022年9月1日起，云监控开始对GetMonitorData接口计费。每个主账号每月可获得100万次免费请求额度，超过免费额度后如需继续调用接口需要开通 [API请求按量付费](https://buy.cloud.tencent.com/APIRequestBuy)。计费规则可查看[API计费文档](https://cloud.tencent.com/document/product/248/77914)。
+     */
+  async GetMonitorData(
+    req: GetMonitorDataRequest,
+    cb?: (error: string, rep: GetMonitorDataResponse) => void
+  ): Promise<GetMonitorDataResponse> {
+    return this.request("GetMonitorData", req, cb)
+  }
+}

package/src/services/monitor/v20230616/monitor_models.ts

@@ -0,0 +1,143 @@
+/*
+ * Copyright (c) 2018 THL A29 Limited, a Tencent company. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * GetMonitorData返回参数结构体
+ */
+export interface GetMonitorDataResponse {
+  /**
+   * 统计周期
+   */
+  Period?: number
+  /**
+   * 指标名
+   */
+  MetricName?: string
+  /**
+   * 数据点数组
+   */
+  DataPoints?: Array<DataPoint>
+  /**
+   * 开始时间
+   */
+  StartTime?: string
+  /**
+   * 结束时间
+   */
+  EndTime?: string
+  /**
+   * 返回信息
+   */
+  Msg?: string
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
+/**
+ * 计算算子
+ */
+export interface Expr {
+  /**
+   * 算子名称
+   */
+  Function?: string
+  /**
+   * 算子入参值
+   */
+  N?: number
+}
+
+/**
+ * GetMonitorData请求参数结构体
+ */
+export interface GetMonitorDataRequest {
+  /**
+   * 命名空间，如QCE/CVM。各个云产品的详细命名空间说明请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档
+   */
+  Namespace: string
+  /**
+   * 指标名称，如CPUUsage，仅支持单指标拉取。各个云产品的详细指标说明请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档，对应的指标英文名即为MetricName
+   */
+  MetricName: string
+  /**
+   * 实例对象的维度组合，格式为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个实例的监控数据。
+   */
+  Instances: Array<Instance>
+  /**
+   * 监控统计周期，如60。默认为取值为300，单位为s。每个指标支持的统计周期不一定相同，各个云产品支持的统计周期请参阅各个产品[监控指标](https://cloud.tencent.com/document/product/248/6140)文档，对应的统计周期列即为支持的统计周期。单请求的数据点数限制为1440个。
+   */
+  Period?: number
+  /**
+   * 起始时间，如2018-09-22T19:51:23+08:00
+   */
+  StartTime?: string
+  /**
+   * 结束时间，如2018-09-22T20:51:23+08:00，默认为当前时间。 EndTime不能小于StartTime
+   */
+  EndTime?: string
+  /**
+   * 计算算子
+   */
+  Expr?: Expr
+}
+
+/**
+ * 实例维度组合数组
+ */
+export interface Instance {
+  /**
+   * 实例的维度组合
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Dimensions: Array<Dimension>
+}
+
+/**
+ * 监控数据点
+ */
+export interface DataPoint {
+  /**
+   * 实例对象维度组合
+   */
+  Dimensions?: Array<Dimension>
+  /**
+   * 时间戳数组，表示那些时间点有数据，缺失的时间戳，没有数据点，可以理解为掉点了
+   */
+  Timestamps?: Array<number>
+  /**
+   * 监控值数组，该数组和Timestamps一一对应
+   */
+  Values?: Array<number>
+}
+
+/**
+ * 实例对象的维度组合
+ */
+export interface Dimension {
+  /**
+   * 实例维度名称
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Name: string
+  /**
+   * 实例维度值
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Value: string
+}