tencentcloud-sdk-nodejs 4.0.624 → 4.0.626

package/src/services/live/v20180801/live_client.ts

@@ -79,6 +79,7 @@ import {
   StopRecordTaskResponse,
   CommonMixControlParams,
   DescribeTranscodeTaskNumResponse,
+  DescribeLivePullStreamTaskStatusResponse,
   ModifyLiveStreamMonitorResponse,
   DeleteLivePadRuleResponse,
   DescribeLiveRecordTemplateRequest,
@@ -200,6 +201,7 @@ import {
   ModifyLiveCallbackTemplateResponse,
   DescribeLiveCallbackTemplatesResponse,
   DescribeLivePushAuthKeyResponse,
+  DescribeLivePullStreamTaskStatusRequest,
   RestartLivePullStreamTaskRequest,
   DelayInfo,
   DescribeLiveStreamMonitorRequest,
@@ -278,6 +280,7 @@ import {
   DescribeLiveTranscodeTemplatesResponse,
   DeleteLiveCallbackRuleRequest,
   DescribeAllStreamPlayInfoListResponse,
+  TaskStatusInfo,
   DescribeVisitTopSumInfoListResponse,
   TimeShiftBillData,
   HlsSpecialParam,
@@ -1212,13 +1215,13 @@ DomainName+AppName+StreamName+TemplateId唯一标识单个转码规则，如需
   }
 
   /**
-   * 获取转码规则列表
+   * 查询直播拉流任务状态信息。
    */
-  async DescribeLiveTranscodeRules(
-    req: DescribeLiveTranscodeRulesRequest,
-    cb?: (error: string, rep: DescribeLiveTranscodeRulesResponse) => void
-  ): Promise<DescribeLiveTranscodeRulesResponse> {
-    return this.request("DescribeLiveTranscodeRules", req, cb)
+  async DescribeLivePullStreamTaskStatus(
+    req: DescribeLivePullStreamTaskStatusRequest,
+    cb?: (error: string, rep: DescribeLivePullStreamTaskStatusResponse) => void
+  ): Promise<DescribeLivePullStreamTaskStatusResponse> {
+    return this.request("DescribeLivePullStreamTaskStatus", req, cb)
   }
 
   /**
@@ -1924,6 +1927,16 @@ DomainName+AppName+StreamName+TemplateId唯一标识单个转码规则，如需
     return this.request("DescribeLiveCerts", req, cb)
   }
 
+  /**
+   * 获取转码规则列表
+   */
+  async DescribeLiveTranscodeRules(
+    req: DescribeLiveTranscodeRulesRequest,
+    cb?: (error: string, rep: DescribeLiveTranscodeRulesResponse) => void
+  ): Promise<DescribeLiveTranscodeRulesResponse> {
+    return this.request("DescribeLiveTranscodeRules", req, cb)
+  }
+
   /**
    * 启用状态为停用的直播域名。
    */

package/src/services/live/v20180801/live_models.ts

@@ -1428,6 +1428,20 @@ export interface DescribeTranscodeTaskNumResponse {
   RequestId?: string
 }
 
+/**
+ * DescribeLivePullStreamTaskStatus返回参数结构体
+ */
+export interface DescribeLivePullStreamTaskStatusResponse {
+  /**
+   * 任务状态信息。
+   */
+  TaskStatusInfo: TaskStatusInfo
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * ModifyLiveStreamMonitor返回参数结构体
  */
@@ -4069,6 +4083,13 @@ export interface StreamOnlineInfo {
    * 推流域名。
    */
   DomainName: string
+  /**
+   * 流是否推送到延播。
+0 - 无延播，
+1 - 有延播。
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  PushToDelay?: number
 }
 
 /**
@@ -4520,6 +4541,16 @@ export interface DescribeLivePushAuthKeyResponse {
   RequestId?: string
 }
 
+/**
+ * DescribeLivePullStreamTaskStatus请求参数结构体
+ */
+export interface DescribeLivePullStreamTaskStatusRequest {
+  /**
+   * 任务 ID。
+   */
+  TaskId: string
+}
+
 /**
  * RestartLivePullStreamTask请求参数结构体
  */
@@ -6524,6 +6555,44 @@ export interface DescribeAllStreamPlayInfoListResponse {
   RequestId?: string
 }
 
+/**
+ * 直播拉流任务状态信息。
+ */
+export interface TaskStatusInfo {
+  /**
+   * 当前使用的源 URL。
+   */
+  FileUrl: string
+  /**
+   * 点播源任务的轮播次数。
+   */
+  LoopedTimes: number
+  /**
+   * 点播源的播放偏移，单位：秒。
+   */
+  OffsetTime: number
+  /**
+   * 最新心跳上报时间。UTC时间，例如：
+2022-02-11T10:00:00Z。
+注意：UTC时间与北京时间相差八小时。
+   */
+  ReportTime: string
+  /**
+   * 实际运行状态：
+active - 活跃，
+inactive - 不活跃。
+   */
+  RunStatus: string
+  /**
+   * 点播源的文件时长，单位：秒。
+   */
+  FileDuration: number
+  /**
+   * 下一进度点播文件 URL。
+   */
+  NextFileUrl: string
+}
+
 /**
  * DescribeVisitTopSumInfoList返回参数结构体
  */

package/src/services/mariadb/v20170312/mariadb_client.ts

@@ -20,7 +20,7 @@ import { ClientConfig } from "../../../common/interface"
 import {
   IsolateHourDBInstanceResponse,
   CreateDBInstanceRequest,
-  ZonesInfo,
+  DescribeDBTmpInstancesRequest,
   DescribeAccountPrivilegesResponse,
   DescribeDatabasesRequest,
   ParamDesc,
@@ -91,6 +91,7 @@ import {
   DescribePriceRequest,
   CreateDBInstanceResponse,
   ModifyRealServerAccessStrategyRequest,
+  ZonesInfo,
   DescribeBackupTimeRequest,
   DescribeSaleInfoResponse,
   ModifyDBEncryptAttributesResponse,
@@ -106,6 +107,7 @@ import {
   SwitchDBInstanceHARequest,
   DBParamValue,
   SpecConfigInfo,
+  TmpInstance,
   ModifyDBParametersRequest,
   ModifyDBInstanceSecurityGroupsRequest,
   DescribeDcnDetailRequest,
@@ -162,6 +164,7 @@ import {
   DCNReplicaConfig,
   ModifyAccountPrivilegesRequest,
   DatabaseProcedure,
+  DescribeDBTmpInstancesResponse,
   ModifyDBSyncModeRequest,
   ActivateHourDBInstanceResponse,
   DescribeInstanceNodeInfoRequest,
@@ -775,6 +778,16 @@ export class Client extends AbstractClient {
     return this.request("CopyAccountPrivileges", req, cb)
   }
 
+  /**
+   * 本接口（DescribeDBTmpInstances）用于获取实例回档生成的临时实例
+   */
+  async DescribeDBTmpInstances(
+    req: DescribeDBTmpInstancesRequest,
+    cb?: (error: string, rep: DescribeDBTmpInstancesResponse) => void
+  ): Promise<DescribeDBTmpInstancesResponse> {
+    return this.request("DescribeDBTmpInstances", req, cb)
+  }
+
   /**
    * 隔离MariaDB按量计费实例
    */

package/src/services/mariadb/v20170312/mariadb_models.ts

@@ -123,25 +123,13 @@ export interface CreateDBInstanceRequest {
 }
 
 /**
- * 可用区信息
+ * DescribeDBTmpInstances请求参数结构体
  */
-export interface ZonesInfo {
-  /**
-   * 可用区英文ID
-   */
-  Zone: string
+export interface DescribeDBTmpInstancesRequest {
   /**
-   * 可用区数字ID
-   */
-  ZoneId: number
-  /**
-   * 可用区中文名
-   */
-  ZoneName: string
-  /**
-   * 是否在售
+   * 实例ID
    */
-  OnSale: boolean
+  InstanceId: string
 }
 
 /**
@@ -1762,6 +1750,28 @@ export interface ModifyRealServerAccessStrategyRequest {
   RsAccessStrategy: number
 }
 
+/**
+ * 可用区信息
+ */
+export interface ZonesInfo {
+  /**
+   * 可用区英文ID
+   */
+  Zone: string
+  /**
+   * 可用区数字ID
+   */
+  ZoneId: number
+  /**
+   * 可用区中文名
+   */
+  ZoneName: string
+  /**
+   * 是否在售
+   */
+  OnSale: boolean
+}
+
 /**
  * DescribeBackupTime请求参数结构体
  */
@@ -2139,6 +2149,87 @@ export interface SpecConfigInfo {
   Cpu: number
 }
 
+/**
+ * 临时实例
+ */
+export interface TmpInstance {
+  /**
+   * 应用ID
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  AppId: number
+  /**
+   * 创建时间
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  CreateTime: string
+  /**
+   * 实例备注
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  InstanceRemark: string
+  /**
+   * 0:非临时实例 ,1:无效临时实例, 2:回档成功的有效临时实例
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  TempType: number
+  /**
+   * 实例状态,0:待初始化,1:流程处理中,2:有效状态,-1:已隔离，-2：已下线
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Status: number
+  /**
+   * 实例 ID，形如：tdsql-ow728lmc。
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  InstanceId: string
+  /**
+   * 实例虚IP
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Vip: string
+  /**
+   * 实例虚端口
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Vport: number
+  /**
+   * 有效期结束时间
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  PeriodEndTime: string
+  /**
+   * 源实例 ID，形如：tdsql-ow728lmc。
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  SrcInstanceId: string
+  /**
+   * 实例状态描述
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  StatusDesc: string
+  /**
+   * 实例所在地域
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Region: string
+  /**
+   * 实例所在可用区
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Zone: string
+  /**
+   * 实例虚IPv6
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Vipv6: string
+  /**
+   * 实例IPv6标志
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Ipv6Flag: number
+}
+
 /**
  * ModifyDBParameters请求参数结构体
  */
@@ -3387,6 +3478,20 @@ export interface DatabaseProcedure {
   Proc: string
 }
 
+/**
+ * DescribeDBTmpInstances返回参数结构体
+ */
+export interface DescribeDBTmpInstancesResponse {
+  /**
+   * 临时实例
+   */
+  TmpInstances: Array<TmpInstance>
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * ModifyDBSyncMode请求参数结构体
  */

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

@@ -548,7 +548,7 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 创建 Grafana 实例
+   * 本接口（CreateGrafanaInstance）用于创建 Grafana 包年包月实例，默认基础版、到期自动续费、不可使用代金券。
    */
   async CreateGrafanaInstance(
     req: CreateGrafanaInstanceRequest,
@@ -1135,7 +1135,7 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 删除 Grafana 实例
+   * 本接口（DeleteGrafanaInstance）用于 Grafana 包年包月实例的退费，调用后实例处于停服状态，不可使用，7天后自动销毁。
    */
   async DeleteGrafanaInstance(
     req: DeleteGrafanaInstanceRequest,
@@ -1215,7 +1215,7 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 恢复 Grafana 实例
+   * 本接口（ResumeGrafanaInstance）用于 Grafana 包年包月实例的停服续费，调用后按原版本续费一个月。仍在运行中的实例无法使用该接口进行续费。
    */
   async ResumeGrafanaInstance(
     req: ResumeGrafanaInstanceRequest,

package/src/services/partners/v20180321/partners_models.ts

@@ -666,6 +666,11 @@ export interface AgentDealNewElem {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   UpdateTime: string
+  /**
+   * 资源id
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ResourceIds?: Array<string>
 }
 
 /**

package/src/services/smh/v20210712/smh_models.ts

@@ -32,11 +32,11 @@ export interface DescribeLibrariesResponse {
   /**
    * 媒体库列表
    */
-  List: Array<Library>
+  List?: Array<Library>
   /**
    * 总数
    */
-  TotalCount: number
+  TotalCount?: number
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -508,7 +508,7 @@ export interface CreateLibraryResponse {
   /**
    * 媒体库 ID
    */
-  LibraryId: string
+  LibraryId?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -570,21 +570,21 @@ export interface CreateLibraryRequest {
    */
   Name: string
   /**
-   * 存储桶全名，新建后不可更改
+   * 备注，最多 250 个字符
    */
-  BucketName: string
+  Remark?: string
   /**
-   * 存储桶所在地域，新建后不可更改
+   * 存储桶全名，新建后不可更改。当前版本不再支持指定存储桶。
    */
-  BucketRegion: string
+  BucketName?: string
   /**
-   * 媒体库配置项，部分参数新建后不可更改
+   * 存储桶所在地域，新建后不可更改。当前版本不再支持指定存储桶所在地域。
    */
-  LibraryExtension: LibraryExtension
+  BucketRegion?: string
   /**
-   * 备注，最多 250 个字符
+   * 媒体库配置项，部分参数新建后不可更改
    */
-  Remark?: string
+  LibraryExtension?: LibraryExtension
 }
 
 /**

package/src/services/sms/v20190711/sms_client.ts

@@ -121,7 +121,6 @@ export class Client extends AbstractClient {
      * 短信发送接口，用于给用户发短信验证码、通知类短信或营销短信。
 >- 注：由于云 **API3.0 安全性**有所提升，所以**接口鉴权**较为复杂，建议使用 [SDK](https://cloud.tencent.com/document/product/382/43193) 来使用云短信服务。
 >- 您可以在 [API 3.0 Explorer](https://console.cloud.tencent.com/api/explorer?Product=sms&Version=2019-07-11&Action=SendSms) 中直接运行该接口，可以先免去签名计算步骤。运行成功后，API Explorer可以**自动生成**SDK代码示例。
-
      */
   async SendSms(
     req: SendSmsRequest,

package/src/services/sms/v20190711/sms_models.ts

@@ -479,7 +479,7 @@ export interface SendSmsResponse {
   /**
    * 短信发送状态。
    */
-  SendStatusSet: Array<SendStatus>
+  SendStatusSet?: Array<SendStatus>
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -530,7 +530,7 @@ export interface SendSmsRequest {
    */
   ExtendCode?: string
   /**
-   * 用户的 session 内容，可以携带用户侧 ID 等上下文信息，server 会原样返回。
+   * 用户的 session 内容，可以携带用户侧 ID 等上下文信息，server 会原样返回。注意长度需小于512字节。
    */
   SessionContext?: string
   /**

package/src/services/sms/v20210111/sms_models.ts

@@ -526,7 +526,7 @@ export interface SendSmsResponse {
   /**
    * 短信发送状态。
    */
-  SendStatusSet: Array<SendStatus>
+  SendStatusSet?: Array<SendStatus>
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -580,7 +580,7 @@ export interface SendSmsRequest {
    */
   ExtendCode?: string
   /**
-   * 用户的 session 内容，可以携带用户侧 ID 等上下文信息，server 会原样返回。
+   * 用户的 session 内容，可以携带用户侧 ID 等上下文信息，server 会原样返回。注意长度需小于512字节。
    */
   SessionContext?: string
   /**

package/src/services/sts/v20180813/sts_client.ts

@@ -45,8 +45,16 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 获取联合身份临时访问凭证
-   */
+     * **使用说明**
+
+返回一组临时访问凭证，典型的应用场景是代理应用程序集中申请临时访问凭证，下发给企业网络内其他分布式终端应用，比如终端应用上传文件到COS场景，本接口仅支持永久密钥调用。
+
+**最佳实践**
+
+1. 临时访问凭据在有效期内都可以使用，建议在有效期内重复使用，以避免业务请求速率上升后被限频
+2. 授予临时访问凭证权限的CAM策略，建议按权限最小化原则
+3. 调用接口的永久密钥，建议不要使用主账号
+     */
   async GetFederationToken(
     req: GetFederationTokenRequest,
     cb?: (error: string, rep: GetFederationTokenResponse) => void
@@ -65,7 +73,7 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 申请扮演角色
+   * 申请扮演角色临时访问凭证。
    */
   async AssumeRole(
     req: AssumeRoleRequest,
@@ -75,8 +83,10 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 申请OIDC角色临时密钥
-   */
+     * 申请OIDC角色临时访问凭证。
+
+注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
+     */
   async AssumeRoleWithWebIdentity(
     req: AssumeRoleWithWebIdentityRequest,
     cb?: (error: string, rep: AssumeRoleWithWebIdentityResponse) => void
@@ -86,7 +96,8 @@ export class Client extends AbstractClient {
 
   /**
      * 获取当前调用者的身份信息。
-接口支持主账号，子账号长期密钥以及AssumeRole，GetFederationToken生成的临时凭据的身份获取。
+
+接口支持主账号，子账号长期密钥以及AssumeRole，GetFederationToken生成的临时访问凭证身份获取。
      */
   async GetCallerIdentity(
     req?: GetCallerIdentityRequest,
@@ -96,8 +107,10 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 本接口（AssumeRoleWithSAML）用于根据 SAML 断言申请角色临时凭证。
-   */
+     * 本接口（AssumeRoleWithSAML）用于根据 SAML 断言申请角色临时访问凭证。
+
+注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
+     */
   async AssumeRoleWithSAML(
     req: AssumeRoleWithSAMLRequest,
     cb?: (error: string, rep: AssumeRoleWithSAMLResponse) => void

package/src/services/sts/v20180813/sts_models.ts

@@ -24,11 +24,11 @@ export interface AssumeRoleWithSAMLResponse {
    */
   Credentials?: Credentials
   /**
-   * 证书无效的时间，返回 Unix 时间戳，精确到秒
+   * 临时访问凭证的过期时间，返回 Unix 时间戳，精确到秒
    */
   ExpiredTime?: number
   /**
-   * 证书无效的时间，以 ISO8601 格式的 UTC 时间表示
+   * 临时访问凭证的过期时间，以 ISO8601 格式的 UTC 时间表示
    */
   Expiration?: string
   /**
@@ -76,7 +76,7 @@ export interface AssumeRoleWithWebIdentityRequest {
    */
   RoleSessionName: string
   /**
-   * 指定临时证书的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
+   * 指定临时访问凭证的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
    */
   DurationSeconds?: number
 }
@@ -86,17 +86,17 @@ export interface AssumeRoleWithWebIdentityRequest {
  */
 export interface AssumeRoleWithWebIdentityResponse {
   /**
-   * 临时密钥过期时间(时间戳)
+   * 临时访问凭证过期时间(时间戳)
    */
-  ExpiredTime: number
+  ExpiredTime?: number
   /**
-   * 临时密钥过期时间
+   * 临时访问凭证过期时间
    */
-  Expiration: string
+  Expiration?: string
   /**
-   * 临时密钥
+   * 临时访问凭证
    */
-  Credentials: Credentials
+  Credentials?: Credentials
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -108,15 +108,15 @@ export interface AssumeRoleWithWebIdentityResponse {
  */
 export interface GetFederationTokenResponse {
   /**
-   * 临时证书
+   * 临时访问凭证
    */
   Credentials?: Credentials
   /**
-   * 临时证书有效的时间，返回 Unix 时间戳，精确到秒
+   * 临时访问凭证有效的时间，返回 Unix 时间戳，精确到秒
    */
   ExpiredTime?: number
   /**
-   * 证书有效的时间，以 iso8601 格式的 UTC 时间表示
+   * 临时访问凭证有效的时间，以 iso8601 格式的 UTC 时间表示
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Expiration?: string
@@ -145,17 +145,17 @@ export interface QueryApiKeyResponse {
  */
 export interface AssumeRoleResponse {
   /**
-   * 临时安全证书
+   * 临时访问凭证
    */
-  Credentials: Credentials
+  Credentials?: Credentials
   /**
-   * 证书无效的时间，返回 Unix 时间戳，精确到秒
+   * 临时访问凭证的过期时间，返回 Unix 时间戳，精确到秒
    */
-  ExpiredTime: number
+  ExpiredTime?: number
   /**
-   * 证书无效的时间，以 iso8601 格式的 UTC 时间表示
+   * 临时访问凭证的过期时间，以 iso8601 格式的 UTC 时间表示
    */
-  Expiration: string
+  Expiration?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -181,7 +181,7 @@ export interface GetFederationTokenRequest {
    */
   Name: string
   /**
-   * 授予该临时证书权限的CAM策略
+   * 授予该临时访问凭证权限的CAM策略
 注意：
 1、策略语法参照[ CAM 策略语法](https://cloud.tencent.com/document/product/598/10603)。
 2、策略中不能包含 principal 元素。
@@ -279,7 +279,7 @@ qcs::cam::uin/12345678:role/tencentcloudServiceRole/4611686018427397920、qcs::c
    */
   RoleSessionName: string
   /**
-   * 指定临时证书的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
+   * 指定临时访问凭证的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
    */
   DurationSeconds?: number
   /**
@@ -331,7 +331,7 @@ export interface AssumeRoleWithSAMLRequest {
    */
   RoleSessionName: string
   /**
-   * 指定临时证书的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
+   * 指定临时访问凭证的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
    */
   DurationSeconds?: number
 }