tencentcloud-sdk-nodejs 4.1.272 → 4.1.274

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/es/common/sdk_version.js +1 -1
  2. package/es/services/cfw/v20190904/cfw_client.js +3 -0
  3. package/es/services/chdfs/v20201112/chdfs_client.js +12 -0
  4. package/es/services/dlc/v20210125/dlc_client.js +17 -2
  5. package/es/services/ga2/v20250115/ga2_client.js +24 -0
  6. package/es/services/mps/v20190612/mps_client.js +3 -0
  7. package/es/services/rce/v20260130/rce_client.js +6 -0
  8. package/package.json +1 -1
  9. package/tencentcloud/common/sdk_version.d.ts +1 -1
  10. package/tencentcloud/common/sdk_version.js +1 -1
  11. package/tencentcloud/services/adp/v20260520/adp_models.d.ts +52 -16
  12. package/tencentcloud/services/cbs/v20170312/cbs_models.d.ts +8 -0
  13. package/tencentcloud/services/cfw/v20190904/cfw_client.d.ts +7 -3
  14. package/tencentcloud/services/cfw/v20190904/cfw_client.js +8 -2
  15. package/tencentcloud/services/cfw/v20190904/cfw_models.d.ts +295 -269
  16. package/tencentcloud/services/chdfs/v20201112/chdfs_client.d.ts +17 -1
  17. package/tencentcloud/services/chdfs/v20201112/chdfs_client.js +24 -0
  18. package/tencentcloud/services/chdfs/v20201112/chdfs_models.d.ts +173 -48
  19. package/tencentcloud/services/dlc/v20210125/dlc_client.d.ts +25 -5
  20. package/tencentcloud/services/dlc/v20210125/dlc_client.js +33 -3
  21. package/tencentcloud/services/dlc/v20210125/dlc_models.d.ts +384 -48
  22. package/tencentcloud/services/ga2/v20250115/ga2_client.d.ts +33 -1
  23. package/tencentcloud/services/ga2/v20250115/ga2_client.js +48 -0
  24. package/tencentcloud/services/ga2/v20250115/ga2_models.d.ts +383 -58
  25. package/tencentcloud/services/ioa/v20220601/ioa_client.d.ts +3 -1
  26. package/tencentcloud/services/ioa/v20220601/ioa_client.js +3 -1
  27. package/tencentcloud/services/live/v20180801/live_models.d.ts +4 -0
  28. package/tencentcloud/services/mongodb/v20190725/mongodb_models.d.ts +10 -14
  29. package/tencentcloud/services/mps/v20190612/mps_client.d.ts +7 -1
  30. package/tencentcloud/services/mps/v20190612/mps_client.js +8 -0
  31. package/tencentcloud/services/mps/v20190612/mps_models.d.ts +216 -83
  32. package/tencentcloud/services/oceanus/v20190422/oceanus_models.d.ts +48 -12
  33. package/tencentcloud/services/rce/v20260130/rce_client.d.ts +9 -1
  34. package/tencentcloud/services/rce/v20260130/rce_client.js +12 -0
  35. package/tencentcloud/services/rce/v20260130/rce_models.d.ts +158 -17
  36. package/tencentcloud/services/ssm/v20190923/ssm_models.d.ts +45 -11
  37. package/tencentcloud/services/tione/v20211111/tione_models.d.ts +65 -64
  38. package/tencentcloud/services/vod/v20180717/vod_models.d.ts +13 -0
  39. package/tencentcloud/services/vpc/v20170312/vpc_models.d.ts +4 -4
  40. package/tencentcloud/services/wedata/v20210820/wedata_models.d.ts +7 -7
@@ -760,56 +760,50 @@ export interface ModifyAclRuleResponse {
760
760
  */
761
761
  export interface CreateNatFwInstanceRequest {
762
762
  /**
763
- * 防火墙实例名称
763
+ * <p>防火墙实例名称</p>
764
764
  */
765
765
  Name: string;
766
766
  /**
767
- * 带宽
767
+ * <p>带宽</p>
768
768
  */
769
769
  Width: number;
770
770
  /**
771
- * 模式 1:接入模式;0:新增模式
771
+ * <p>模式 1:接入模式;0:新增模式</p>
772
772
  */
773
773
  Mode: number;
774
774
  /**
775
- * 新增模式传递参数,其中NewModeItems和NatgwList至少传递一种。
775
+ * <p>新增模式传递参数,其中NewModeItems和NatgwList至少传递一种。</p>
776
776
  */
777
777
  NewModeItems?: NewModeItems;
778
778
  /**
779
- * 接入模式接入的nat网关列表,其中NewModeItems和NatgwList至少传递一种。
779
+ * <p>接入模式接入的nat网关列表,其中NewModeItems和NatgwList至少传递一种。</p>
780
780
  */
781
781
  NatGwList?: Array<string>;
782
782
  /**
783
- * 主可用区,为空则选择默认可用区
783
+ * <p>主可用区,为空则选择默认可用区</p>
784
784
  */
785
785
  Zone?: string;
786
786
  /**
787
- * 备可用区,为空则选择默认可用区
787
+ * <p>备可用区,为空则选择默认可用区</p>
788
788
  */
789
789
  ZoneBak?: string;
790
790
  /**
791
- * 异地灾备 1:使用异地灾备;0:不使用异地灾备;为空则默认不使用异地灾备
791
+ * <p>异地灾备 1:使用异地灾备;0:不使用异地灾备;为空则默认不使用异地灾备</p>
792
792
  */
793
793
  CrossAZone?: number;
794
794
  /**
795
- * 指定防火墙使用网段信息
795
+ * <p>指定防火墙使用网段信息</p>
796
796
  */
797
797
  FwCidrInfo?: FwCidrInfo;
798
798
  }
799
799
  /**
800
- * 安全组规则
800
+ * 创建请求写入成功后返回的企业安全组规则摘要。
801
801
  */
802
802
  export interface SecurityGroupSimplifyRule {
803
803
  /**
804
- * 访问源示例:
805
- net:IP/CIDR(192.168.0.2)
806
- template:参数模板(ipm-dyodhpby)
807
- instance:资产实例(ins-123456)
808
- resourcegroup:资产分组(/全部分组/分组1/子分组1)
809
- tag:资源标签({"Key":"标签key值","Value":"标签Value值"})
810
- region:地域(ap-gaungzhou)
804
+ * 写入规则的描述。
811
805
  */
812
- SourceContent?: string;
806
+ Description?: string;
813
807
  /**
814
808
  * 访问目的示例:
815
809
  net:IP/CIDR(192.168.0.2)
@@ -821,25 +815,31 @@ export interface SecurityGroupSimplifyRule {
821
815
  */
822
816
  DestContent?: string;
823
817
  /**
824
- * 协议;TCP/UDP/ICMP/ANY
818
+ * 写入规则的协议。普通 IPv4 规则返回 ANY、TCPUDPICMP;使用服务模板时,Protocol 可省略或留空,此时返回空字符串;若仍显式填写 Protocol,则只接受 ANY 并返回 ANY。
825
819
  */
826
820
  Protocol?: string;
827
821
  /**
828
- * 描述
822
+ * 服务端写入后生成或采用的规则数据库 ID。
829
823
  */
830
- Description?: string;
824
+ RuleUuid?: number;
831
825
  /**
832
- * 规则对应的唯一id
826
+ * 写入后的规则生效范围;SG 表示安全组,LH 表示轻量应用服务器,组合范围以逗号分隔。
833
827
  */
834
- RuleUuid?: number;
828
+ Scope?: string;
835
829
  /**
836
- * 规则序号
830
+ * 服务端写入后的实际规则顺序。
837
831
  */
838
832
  Sequence?: number;
839
833
  /**
840
- * 规则生效范围,SG安全组,LH轻量服务器
834
+ * 访问源示例:
835
+ net:IP/CIDR(192.168.0.2)
836
+ template:参数模板(ipm-dyodhpby)
837
+ instance:资产实例(ins-123456)
838
+ resourcegroup:资产分组(/全部分组/分组1/子分组1)
839
+ tag:资源标签({"Key":"标签key值","Value":"标签Value值"})
840
+ region:地域(ap-gaungzhou)
841
841
  */
842
- Scope?: string;
842
+ SourceContent?: string;
843
843
  }
844
844
  /**
845
845
  * 预接入检查结果,序列化后写入 cfw_gwlb_lead_switch.check_result 列
@@ -940,165 +940,144 @@ export interface DescribeEnterpriseSecurityGroupRuleRequest {
940
940
  RuleUuid?: number;
941
941
  }
942
942
  /**
943
- * VPC内网间规则
943
+ * VPC 内网间访问控制规则。新增和修改均根据请求中的源、目的、协议、动作、端口、顺序、状态、生效范围、IP 版本和模板等配置字段重新构造规则;修改是整条替换而不是局部更新。命中信息、名称、时间及其它查询展示字段不参与规则构造。
944
944
  */
945
945
  export interface VpcRuleItem {
946
946
  /**
947
- * 访问源示例:
948
- net:IP/CIDR(192.168.0.2)
949
- */
950
- SourceContent: string;
951
- /**
952
- * 访问源类型,类型可以为:net
947
+ * <p>规则描述。新增和修改按请求中的字符串保存。</p>
953
948
  */
954
- SourceType: string;
949
+ Description: string;
955
950
  /**
956
- * 访问目的示例:
957
- net:IP/CIDR(192.168.0.2)
958
- domain:域名规则,例如*.qq.com
951
+ * <p>访问目的内容,由 DestType 决定格式和校验。net/ip 接受合法 IP 或 CIDR 的逗号分隔列表,最多 10 项;domain 接受合法域名的逗号分隔列表或单独的 *,最多 10 项,通配域名最多 5 级,段内通配域名还要求引擎支持对应能力;template 接受当前租户的地址模板标识并归一化为模板 UUID,IP 地址模板必须与 IpVersion 一致,域名地址模板按域名目的校验;dnsparse 接受单个非 IP 域名或当前租户的域名模板,可使用符合级数限制的 *. 前缀泛域名,但不接受单独的 * 或段内通配;domainiptwoverify 接受单个非 IP 精确域名或不含任何通配符的当前租户域名模板;instance 和 tag 必须在当前租户存在,其中 instance 必须具有 IpVersion 对应的私网地址;group 接受资源组标识。location 会校验地域代码,但解析出的地域代码未写入 VPC 规则且目的内容保存为空;vendor 会校验厂商名称并将其归一化代码写入目的内容。归一化后的目的内容超过 1023 字节时请求失败。</p>
959
952
  */
960
953
  DestContent: string;
961
954
  /**
962
- * 访问目的类型,类型可以为:netdomaindnsparse
955
+ * <p>访问目的类型,不区分大小写。VPC 规则可用 net(ip 为同义值)、domain、template、dnsparse、domainiptwoverify、instance、tag、group、location 或 vendor;url 虽可被通用类型映射识别,但 VPC 出向内容解析不支持。地址模板、dnsparse、domainiptwoverify、严格模式域名模板和段内通配域名分别要求当前 VPC 防火墙引擎支持对应能力,否则返回 UnsupportedOperation。类型及地址模板查询到的实际类型共同决定 DestContent 和 Protocol 的校验。</p>
963
956
  */
964
957
  DestType: string;
965
958
  /**
966
- * 协议,可选的值:
967
- TCP
968
- UDP
969
- ICMP
970
- ANY
971
- HTTP
972
- HTTPS
973
- HTTP/HTTPS
974
- SMTP
975
- SMTPS
976
- SMTP/SMTPS
977
- FTP
978
- DNS
979
- TLS/SSL
959
+ * <p>规则生效的 VPC 边范围,不区分大小写。ALL 表示全部 VPC 间,cfws- 前缀表示指定 VPC 边;其它格式返回参数错误。ALL 还要求相关 VPC 防火墙引擎支持全局规则,否则返回 UnsupportedOperation。</p>
980
960
  */
981
- Protocol: string;
961
+ EdgeId: string;
982
962
  /**
983
- * 访问控制策略中设置的流量通过云防火墙的方式。取值:
984
- accept:放行
985
- drop:拒绝
986
- log:观察
963
+ * <p>规则状态。字符串 true 表示启用,false 表示禁用,大小写不敏感;省略或传空字符串时使用租户通知配置中的默认规则状态,该配置没有可用值时默认启用;其它字符串返回参数错误。</p>
987
964
  */
988
- RuleAction: string;
965
+ Enable: string;
989
966
  /**
990
- * 访问控制策略的端口。取值:
991
- -1/-1:全部端口
992
- 80:80端口
967
+ * <p>规则在相同 IpVersion 的中间分区内的顺序。请求整数先转换为 uint32,0 归一化为 1,负整数及超出 uint32 范围的整数按该转换结果处理;写入时,顺序为 1 或不大于当前最大顺序的规则在该位置插入并将现有规则后移,通常大于当前最大顺序的值归一化为末尾。例外是 AddVpcAcRule 未使用精确值 insert_rule 且首条规则解析后的顺序为 1 时,本批每条规则都保留其解析后顺序并按该值移动现有规则,因此后续规则即使大于当前最大顺序也不会归一化为末尾。</p>
968
+ */
969
+ OrderIndex: number;
970
+ /**
971
+ * <p>访问控制策略的端口。除 ICMP 和 ICMPV6 外,该字段按逗号拆分;每项可以是正整数单端口,或以斜杠分隔且起点不大于终点的两个整数,-1/-1 表示全部端口。ICMP 和 ICMPV6 忽略请求值并保存为空字符串;其它协议的空值或非法格式返回参数错误。FTP 只接受正整数单端口,不接受逗号组合或斜杠区间。</p>
993
972
  */
994
973
  Port: string;
995
974
  /**
996
- * 描述
975
+ * <p>协议名称,不区分大小写并归一化。IP、instance、tag、group、location、vendor 及 IP 地址模板目的支持 TCP、UDP、ICMP、ICMPV6、ANY 和 FTP,其中 FTP 只接受单端口;domain 及域名地址模板目的支持 ANY、HTTP、HTTPS、HTTP/HTTPS、TLS/SSL、SMTP、SMTPS、SMTP/SMTPS 和 DNS,不支持 FTP,domain、tls、ssl 归一化为 TLS/SSL;dnsparse 和 domainiptwoverify 仅支持 TCP 或 UDP。template 按查询到的实际模板类型应用上述限制;填写 ParamTemplateId 时,组内每个协议端口项还会应用相同的目的类型限制。</p>
997
976
  */
998
- Description: string;
977
+ Protocol: string;
999
978
  /**
1000
- * 规则顺序,-1表示最低,1表示最高
979
+ * <p>流量通过云防火墙时的处理方式,不区分大小写。accept 表示放行,drop 表示拒绝,log 表示观察;isolateinaccept 和 isolateoutaccept 归一化为放行,isolateindrop 和 isolateoutdrop 归一化为拒绝;其它值返回参数错误。</p>
1001
980
  */
1002
- OrderIndex: number;
981
+ RuleAction: string;
1003
982
  /**
1004
- * 规则状态,true表示启用,false表示禁用
983
+ * <p>访问源内容,由 SourceType 决定格式和校验。net/ip 接受合法 IP 或 CIDR 的逗号分隔列表,最多 10 项;template 接受当前租户的地址模板标识并归一化为模板 UUID,只允许与 IpVersion 一致的 IP 地址模板,域名地址模板不能作为访问源;instance 和 tag 必须在当前租户存在,其中 instance 必须具有 IpVersion 对应的私网地址;group 接受资源组标识。</p>
1005
984
  */
1006
- Enable: string;
985
+ SourceContent: string;
1007
986
  /**
1008
- * 规则生效的范围,是在哪对vpc之间还是针对所有vpc间生效
987
+ * <p>访问源类型,不区分大小写。VPC 规则可用 net(ip 为同义值)、template、instance、tag 或 group;url、location 和 vendor 虽可被通用类型映射识别,但 VPC 出向源内容解析不支持。使用 template 要求当前 VPC 防火墙引擎支持地址模板能力。类型及模板查询到的实际类型共同决定 SourceContent 的校验。</p>
1009
988
  */
1010
- EdgeId: string;
989
+ SourceType: string;
1011
990
  /**
1012
- * 规则对应的唯一id,添加规则时忽略该字段,修改该规则时需要填写Uuid;查询返回时会返回该参数
991
+ * <p>规则关联的 beta 任务详情。请求中的该字段不参与新增或修改规则构造,主要用于查询返回。</p>
1013
992
  */
1014
- Uuid?: number;
993
+ BetaList?: Array<BetaInfoByACL>;
1015
994
  /**
1016
- * 规则的命中次数,增删改查规则时无需传入此参数,主要用于返回查询结果数据
995
+ * <p>规则创建时间。请求中的该字段不参与新增或修改规则构造,主要用于查询返回。</p>
1017
996
  */
1018
- DetectedTimes?: number;
997
+ CreateTime?: string;
1019
998
  /**
1020
- * EdgeId对应的这对VPC间防火墙的描述
999
+ * <p>规则删除标记,1 表示已删除,0 表示未删除。请求中的该字段不参与新增或修改规则构造,主要用于查询返回。</p>
1021
1000
  */
1022
- EdgeName?: string;
1001
+ Deleted?: number;
1023
1002
  /**
1024
- * 内部使用的uuid,一般情况下不会使用到该字段
1003
+ * <p>查询结果中对目的实际类型的补充提示,例如 template 可区分 IP 地址模板和域名地址模板。新增和修改处理程序不读取请求中的该字段;实际目的类型由 DestType、DestContent 和模板查询结果确定。</p>
1025
1004
  */
1026
- InternalUuid?: number;
1005
+ DestValueType?: string;
1027
1006
  /**
1028
- * 规则被删除:1,已删除;0,未删除
1007
+ * <p>规则命中次数。请求中的该字段不参与新增或修改规则构造,主要用于查询返回。</p>
1029
1008
  */
1030
- Deleted?: number;
1009
+ DetectedTimes?: number;
1010
+ /**
1011
+ * <p>EdgeId 对应的 VPC 边名称。请求中的该字段不参与新增或修改规则构造,主要用于查询返回和操作记录展示。</p>
1012
+ */
1013
+ EdgeName?: string;
1031
1014
  /**
1032
- * 规则生效的防火墙实例ID
1015
+ * <p>规则生效的防火墙组或 CCN 范围,格式比较不区分大小写。ALL 归一化为大写 ALL;cfwg- 前缀和 ccn- 前缀的值保留请求原文;省略、空字符串或其它格式归一化为 ALL,处理程序不因格式无效而返回错误。</p>
1033
1016
  */
1034
1017
  FwGroupId?: string;
1035
1018
  /**
1036
- * 防火墙名称
1019
+ * <p>防火墙组或 CCN 名称。请求中的该字段不参与新增或修改规则构造,主要用于查询返回和操作记录展示。</p>
1037
1020
  */
1038
1021
  FwGroupName?: string;
1039
1022
  /**
1040
- * beta任务详情
1023
+ * <p>内部规则标识。AddVpcAcRule 的精确 batch_import_cover 分支会采用正整数 InternalUuid 替换自动生成的内部标识;其它新增分支和 ModifyVpcAcRule 不读取请求中的该字段。</p>
1041
1024
  */
1042
- BetaList?: Array<BetaInfoByACL>;
1025
+ InternalUuid?: number;
1043
1026
  /**
1044
- * 端口协议组ID
1027
+ * <p>查询结果中的规则有效性标记,0 表示有效,1 表示无效。请求中的该字段不参与新增或修改规则构造。</p>
1045
1028
  */
1046
- ParamTemplateId?: string;
1029
+ Invalid?: number;
1047
1030
  /**
1048
- * 端口协议组名称
1031
+ * <p>IP 版本,0 表示 IPv4,1 表示 IPv6。省略或传入 0、1 以外的整数时按 IPv4 处理;instance 必须具有对应版本的私网地址,IP 地址模板必须与解析后的版本一致。处理程序不使用该字段校验直接填写的 net IP/CIDR 版本。</p>
1049
1032
  */
1050
- ParamTemplateName?: string;
1033
+ IpVersion?: number;
1051
1034
  /**
1052
- * 访问目的名称
1035
+ * <p>端口协议组 ID。省略或传空字符串时直接使用 Protocol 和 Port;非空时查询当前租户的端口协议组并用组内协议端口项执行目的类型和协议类别校验,模板查询失败时请求失败。无论是否填写该字段,请求中的 Protocol 和非 ICMP/ICMPV6 Port 都会先按普通规则解析,格式无效时请求失败。</p>
1053
1036
  */
1054
- TargetName?: string;
1037
+ ParamTemplateId?: string;
1055
1038
  /**
1056
- * 访问源名称
1039
+ * <p>端口协议组名称。请求中的该字段不参与新增或修改规则构造,主要用于查询返回。</p>
1057
1040
  */
1058
- SourceName?: string;
1041
+ ParamTemplateName?: string;
1059
1042
  /**
1060
- * Ip版本,0:IPv4,1:IPv6,默认为IPv4
1043
+ * <p>规则分区展示值,1 表示最前分区,2 表示中间分区,3 表示最后分区。新增和修改处理程序不读取请求中的该字段,写入时固定为中间分区;ModifyVpcAcRule 只能定位并替换中间分区中的现有规则。</p>
1061
1044
  */
1062
- IpVersion?: number;
1045
+ RulePartition?: number;
1063
1046
  /**
1064
- * 是否是无效规则,0 表示有效规则,1 表示无效规则,出参场景返回使用
1047
+ * <p>访问源名称。请求中的该字段不参与新增或修改规则构造,主要用于查询返回和操作记录展示。</p>
1065
1048
  */
1066
- Invalid?: number;
1049
+ SourceName?: string;
1067
1050
  /**
1068
- * 规则创建时间
1051
+ * <p>访问目的名称。请求中的该字段不参与新增或修改规则构造,主要用于查询返回和操作记录展示。</p>
1069
1052
  */
1070
- CreateTime?: string;
1053
+ TargetName?: string;
1071
1054
  /**
1072
- * 规则最近更新时间
1055
+ * <p>规则最近更新时间。请求中的该字段不参与新增或修改规则构造,主要用于查询返回。</p>
1073
1056
  */
1074
1057
  UpdateTime?: string;
1075
1058
  /**
1076
- * 目的值的类型,与TargetType或DestType所代表的目的类型含义有所不同,如目的类型是template,但template分ip模板和域名模板,故需通过DestValueType进一步区分
1059
+ * <p>规则数据库 ID。ModifyVpcAcRule 必须传当前租户中间分区内既有规则的正整数 Uuid;处理程序按该 ID 删除原记录并以同一 ID 插入替换后的规则。AddVpcAcRule 的普通新增、insert_rule 和 batch_import 分支忽略该字段;精确 batch_import_cover 分支会采用正整数 Uuid 作为新记录 ID,非正数值仍由数据库生成 ID。</p>
1077
1060
  */
1078
- DestValueType?: string;
1079
- /**
1080
- * 规则分区,1最前分区,2中间分区,3最后分区,增删改查规则时无需传入此参数
1081
- */
1082
- RulePartition?: number;
1061
+ Uuid?: number;
1083
1062
  }
1084
1063
  /**
1085
1064
  * CreateAlertCenterOmit请求参数结构体
1086
1065
  */
1087
1066
  export interface CreateAlertCenterOmitRequest {
1088
1067
  /**
1089
- * <p>处置对象,ID列表, IdLists和IpList二选一</p>
1068
+ * <p>直接处置的记录 ID 列表,公共请求结构要求提供。TableType=AlertTable 时元素为告警日志 logid;TableType=InterceptionTable 时元素为拦截记录 unique_id。处理时会与 HandleEventIdList 解析出的日志 ID 合并,再删除空字符串并去重;因此仅按聚合事件处置时可传 [""] 作为空占位。HandleIdList 与 HandleEventIdList 不能同时为空。</p>
1090
1069
  */
1091
1070
  HandleIdList: Array<string>;
1092
1071
  /**
1093
- * <p>忽略数据来源:<br>AlertTable 告警中心 InterceptionTable拦截列表</p>
1072
+ * <p>必填的忽略数据来源,只接受 AlertTable InterceptionTable。AlertTable 更新租户告警表中 logid 命中的记录;InterceptionTable 更新租户拦截表中 unique_id 命中的记录。字段没有默认值,缺失、空字符串或其它值均返回参数错误。</p>
1094
1073
  */
1095
1074
  TableType: string;
1096
1075
  /**
1097
- * <p>AI操作来源</p><p>枚举值:</p><ul><li>console: 控制台来源值</li><li>wechat: 微信</li></ul>
1076
+ * <p>AI操作来源</p><p>枚举值:</p><ul><li>console: 控制台来源值</li><li>wechat: 微信</li></ul>。
1098
1077
  */
1099
1078
  CfwAiAgentOperationSource?: string;
1100
1079
  /**
1101
- * <p>处置对象,事件ID列表</p>
1080
+ * <p>可选的告警聚合事件 ID 列表。处理时逐个事件 ID 查询其对应的告警日志 logid,并将查询结果并入 HandleIdList;无法解析的事件 ID 不会产生目标 ID。该解析不会改写 TableType:若 TableType=InterceptionTable,解析出的 logid 仍会作为 unique_id 查询拦截表。字段可省略或传空数组,但 HandleIdList 与本字段不能同时为空;若最终合并、去空和去重后没有目标 ID,业务状态为失败。</p>
1102
1081
  */
1103
1082
  HandleEventIdList?: Array<string>;
1104
1083
  }
@@ -2152,23 +2131,23 @@ export interface RemoveNatAcRuleResponse {
2152
2131
  RequestId?: string;
2153
2132
  }
2154
2133
  /**
2155
- * 自定义白名单规则
2134
+ * RuleType=6 使用的自定义放通规则详情。SrcIP、DstIP 至少一项必须是具体 IP;另一项可省略或使用与具体 IP 同版本的通配网段 0.0.0.0/0、::/0。两项均为具体 IP 时,当前处理器拒绝源 IPv6、目的 IPv4 的组合;源 IPv4、目的 IPv6 的反向组合当前不受该版本检查限制。资产判定中,私网 IPv4 和任意 IPv6 直接通过,公网 IPv4 必须存在于当前账号 cfw_public_ip。两项均为具体 IP 时至少一项须通过资产判定;仅一项为具体 IP 且另一项省略或为同版本通配网段时,若实际 FwType 包含互联网边界位 1,该具体 IP 也必须通过资产判定。处理器据此计算规则方向和适用引擎。
2156
2135
  */
2157
2136
  export interface CustomWhiteRule {
2158
2137
  /**
2159
- * 访问目的
2138
+ * 自定义规则的目的地址。SrcIP、DstIP 至少一项必须是具体 IP;本字段仅在 SrcIP 为具体 IP 时可省略或使用与 SrcIP 同版本的通配网段。两项均为具体 IP 时,源 IPv6、目的 IPv4 会被拒绝,源 IPv4、目的 IPv6 当前不受该版本检查限制。私网 IPv4 和任意 IPv6 直接通过资产判定,公网 IPv4 必须存在于当前账号 cfw_public_ip;是否要求通过资产判定由两侧地址与实际 FwType 联动决定。
2160
2139
  */
2161
2140
  DstIP?: string;
2162
2141
  /**
2163
- * 规则ID
2142
+ * 自定义规则关联的入侵防御规则 ID;必须是可转换为整数且在入侵防御规则模板中存在的 ID。
2164
2143
  */
2165
2144
  IdsRuleId?: string;
2166
2145
  /**
2167
- * 规则名称
2146
+ * 自定义规则名称;处理器不对内容做额外校验。
2168
2147
  */
2169
2148
  IdsRuleName?: string;
2170
2149
  /**
2171
- * 访问源
2150
+ * 自定义规则的源地址。SrcIP、DstIP 至少一项必须是具体 IP;本字段仅在 DstIP 为具体 IP 时可省略或使用与 DstIP 同版本的通配网段。两项均为具体 IP 时,源 IPv6、目的 IPv4 会被拒绝,源 IPv4、目的 IPv6 当前不受该版本检查限制。私网 IPv4 和任意 IPv6 直接通过资产判定,公网 IPv4 必须存在于当前账号 cfw_public_ip;是否要求通过资产判定由两侧地址与实际 FwType 联动决定。
2172
2151
  */
2173
2152
  SrcIP?: string;
2174
2153
  }
@@ -2411,6 +2390,19 @@ export interface DescribeNatFwVpcDnsLstResponse {
2411
2390
  */
2412
2391
  RequestId?: string;
2413
2392
  }
2393
+ /**
2394
+ * DescribeAclRegInfo返回参数结构体
2395
+ */
2396
+ export interface DescribeAclRegInfoResponse {
2397
+ /**
2398
+ * 规则支持的地域列表
2399
+ */
2400
+ Data?: Array<AclRegInfo>;
2401
+ /**
2402
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2403
+ */
2404
+ RequestId?: string;
2405
+ }
2414
2406
  /**
2415
2407
  * CreateBlockIgnoreRuleList返回参数结构体
2416
2408
  */
@@ -2942,15 +2934,15 @@ export interface OfflineExportTask {
2942
2934
  */
2943
2935
  export interface AddAclRuleRequest {
2944
2936
  /**
2945
- * <p>需要添加的访问控制规则列表</p>
2937
+ * 待添加的互联网边界规则列表,不能为空。每条规则都解析并校验方向、源目的、动作、范围、协议端口和模板;整个请求还会校验规则配额及可下发规则数量。批量覆盖的删除方向例外地只取首条规则。
2946
2938
  */
2947
2939
  Rules: Array<CreateRuleItem>;
2948
2940
  /**
2949
- * <p>AI操作来源</p><p>枚举值:</p><ul><li>console: 控制台来源值</li><li>wechat: 微信</li></ul>
2941
+ * <p>AI操作来源</p><p>枚举值:</p><ul><li>console: 控制台来源值</li><li>wechat: 微信</li></ul>。
2950
2942
  */
2951
2943
  CfwAiAgentOperationSource?: string;
2952
2944
  /**
2953
- * <p>添加规则的来源,一般不需要使用,值insert_rule 表示插入指定位置的规则;值batch_import 表示批量导入规则;为空时表示添加规则</p>
2945
+ * 添加方式。省略或空字符串执行普通新增;insert_rule 标记为指定位置新增;batch_import 标记为批量导入;batch_import_cover 执行覆盖导入,在独立事务中先删除首条规则 Direction 对应的当前账号可操作分区旧规则,再插入 Rules;删除提交后,插入失败不会恢复旧规则。覆盖导入不会校验 Rules 的 Direction 全部相同,删除范围仍只由首条规则决定。其它字符串未由入口统一拒绝,但不属于本接口定义的支持合同,调用方不得依赖其行为。
2954
2946
  */
2955
2947
  From?: string;
2956
2948
  }
@@ -3311,33 +3303,53 @@ export interface PolicyRoutePreCheckReport {
3311
3303
  AvailableNextHopQuota?: number;
3312
3304
  }
3313
3305
  /**
3314
- * Nat实例类型
3306
+ * ACL 地理位置支持地域数据
3315
3307
  */
3316
- export interface NatFwInstance {
3308
+ export interface AclRegInfo {
3317
3309
  /**
3318
- * nat实例id
3310
+ * 地域KEY
3319
3311
  */
3320
- NatinsId?: string;
3312
+ RegionCode?: string;
3321
3313
  /**
3322
- * nat实例名称
3314
+ * 地域名称
3323
3315
  */
3324
- NatinsName?: string;
3316
+ RegionName?: string;
3325
3317
  /**
3326
- * 实例所在地域
3318
+ * 上级地域信息
3327
3319
  */
3328
- Region?: string;
3320
+ Parent?: string;
3329
3321
  /**
3330
- * 0:新增模式,1:接入模式
3322
+ * 中文拼音首字母
3331
3323
  */
3332
- FwMode?: number;
3324
+ ZhKey?: string;
3333
3325
  /**
3334
- * 0:正常状态, 1: 正在创建
3326
+ * 英文首字母
3335
3327
  */
3336
- Status?: number;
3328
+ EnKey?: string;
3337
3329
  /**
3338
- * nat公网ip
3330
+ * 是否为地区
3339
3331
  */
3340
- NatIp?: string;
3332
+ Area?: number;
3333
+ /**
3334
+ * 是否为省份、城市
3335
+ */
3336
+ IsCity?: number;
3337
+ /**
3338
+ * 序号
3339
+ */
3340
+ Num?: number;
3341
+ /**
3342
+ * 是否支持旁路
3343
+ */
3344
+ ForBypass?: number;
3345
+ /**
3346
+ * 是否支持串行
3347
+ */
3348
+ ForSerial?: number;
3349
+ /**
3350
+ * 是否支持NAT
3351
+ */
3352
+ ForNat?: number;
3341
3353
  }
3342
3354
  /**
3343
3355
  * DescribeCfwLogs返回参数结构体
@@ -3370,20 +3382,19 @@ export interface ModifyAllPublicIPSwitchStatusResponse {
3370
3382
  RequestId?: string;
3371
3383
  }
3372
3384
  /**
3373
- * 封禁列表和放通列表结构体
3385
+ * 封禁或放通规则项,包含对象、适用方向和规则类型。
3374
3386
  */
3375
3387
  export interface BanAndAllowRuleDel {
3376
3388
  /**
3377
- * 封禁和放通对象
3389
+ * 规则适用方向,0 表示互联网出站,1 表示互联网入站,2 表示双向,3 表示东西向,4 表示情报误报反馈,5 表示内网访问源,6 表示内网访问目的;多个值以逗号分隔。
3378
3390
  */
3379
- Ioc?: string;
3391
+ DirectionList?: string;
3380
3392
  /**
3381
- * 0互联网出站 1互联网入站 5内网访问源 6内网访问目的 (DeleteBlockIgnoreRuleNew接口,该字段无效)
3393
+ * 封禁或放通对象值。
3382
3394
  */
3383
- DirectionList?: string;
3395
+ Ioc?: string;
3384
3396
  /**
3385
- * 规则类型
3386
- RuleType: 1黑名单 2外部IP 3域名 4情报 5资产 6自定义规则 7入侵防御规则
3397
+ * 规则类型标识。服务端定义的常用值为:1 封禁 IP,2 放通 IP,3 放通域名,4 威胁情报地址,5 资产实例,6 自定义策略,7 入侵防御规则,8 扩展 IP 规则,9 扩展自定义规则。
3387
3398
  */
3388
3399
  RuleType?: number;
3389
3400
  }
@@ -3401,82 +3412,65 @@ export interface DescribeCfwAlertsResponse {
3401
3412
  RequestId?: string;
3402
3413
  }
3403
3414
  /**
3404
- * 安全组规则
3415
+ * 企业安全组规则内容。新增和修改规则内容共用此结构;字段的校验、缺省、归一化及在两种操作中的处理行为见各字段说明。
3405
3416
  */
3406
3417
  export interface SecurityGroupRule {
3407
3418
  /**
3408
- * 访问源示例:
3409
- net:IP/CIDR(192.168.0.2)
3410
- template:参数模板id(ipm-dyodhpby)
3411
- instance:资产实例id(ins-123456)
3412
- resourcegroup:资产分组id(cfwrg-xxxx)
3413
- tag:资源标签({\"Key\":\"标签key值\",\"Value\":\"标签Value值\"})
3414
- region:地域(ap-gaungzhou)
3415
- */
3416
- SourceContent: string;
3417
- /**
3418
- * 访问源类型,类型可以为以下6种:net|template|instance|resourcegroup|tag|region
3419
+ * 规则用途或使用场景的描述,不能为空,最多 100 个 Unicode 字符。
3419
3420
  */
3420
- SourceType: string;
3421
+ Description: string;
3421
3422
  /**
3422
- * 访问目的示例:
3423
- net:IP/CIDR(192.168.0.2)
3424
- template:参数模板id(ipm-dyodhpby)
3425
- instance:资产实例id(ins-123456)
3426
- resourcegroup:资产分组id(cfwrg-xxxx)
3427
- tag:资源标签({\"Key\":\"标签key值\",\"Value\":\"标签Value值\"})
3428
- region:地域(ap-gaungzhou)
3423
+ * 访问目的内容,非空且最多 512 字节,格式由 DestType 决定:net 使用 IPv4 IP/CIDR,且不接受裸地址 0.0.0.0,表示全部 IPv4 地址时使用 0.0.0.0/0;template 使用可用的地址模板 ID;instance 使用属于当前账号的资产实例 ID;resourcegroup 使用当前账号的资产分组 ID;tag 使用当前账号已存在的资源标签 JSON 字符串,例如 {\"Key\":\"标签键\",\"Value\":\"标签值\"};region 使用支持的地域标识;dnsparse 使用合法域名。DestType=dnsparse 时服务端将内容转换为小写,并检查域名格式和域名解析配额。
3429
3424
  */
3430
3425
  DestContent: string;
3431
3426
  /**
3432
- * 访问目的类型,类型可以为以下6种:net|template|instance|resourcegroup|tag|region
3427
+ * 访问目的类型,不区分大小写,可传 nettemplateinstanceresourcegrouptagregion 或 dnsparse。instance 的具体资产类型由 DestContent 的实例 ID 前缀识别;template、instance、resourcegroup、tag、region 对应的内容必须对当前账号有效。
3433
3428
  */
3434
3429
  DestType: string;
3435
3430
  /**
3436
- * 访问控制策略中设置的流量通过云防火墙的方式。取值:
3437
- accept:放行
3438
- drop:拒绝
3431
+ * 规则顺序的十进制整数字符串;-1 转换为 uint32 最大值。新增时 Type=0 或 1 会按 Data 数组顺序重新计算最终 Sequence;Type=2 使用首条规则的 OrderIndex 作为插入位置,超过当前最大 Sequence 时按末尾新增处理。修改规则内容时 -1 会被拒绝,超过当前最大 Sequence 的值归一化为当前最大 Sequence。
3432
+ */
3433
+ OrderIndex: string;
3434
+ /**
3435
+ * 访问控制动作,不区分大小写。accept 表示放行,drop 表示拒绝,log 表示仅记录;isolateinaccept、isolateoutaccept 分别按放行动作写入并标记入向或出向隔离来源,isolateindrop、isolateoutdrop 分别按拒绝动作写入并标记入向或出向隔离来源。
3439
3436
  */
3440
3437
  RuleAction: string;
3441
3438
  /**
3442
- * 规则描述 用于规则使用或者场景的描述,最多支持50个字符
3439
+ * 访问源内容,非空且最多 512 字节,格式由 SourceType 决定:net 使用 IPv4 IP/CIDR,且不接受裸地址 0.0.0.0,表示全部 IPv4 地址时使用 0.0.0.0/0;template 使用可用的地址模板 ID;instance 使用属于当前账号的资产实例 ID;resourcegroup 使用当前账号的资产分组 ID;tag 使用当前账号已存在的资源标签 JSON 字符串,例如 {\"Key\":\"标签键\",\"Value\":\"标签值\"};region 使用支持的地域标识;dnsparse 使用字符串内容。SourceType=dnsparse 时,服务端接受该类型,但不执行目的域名的小写归一化、域名格式校验或域名解析配额检查。
3443
3440
  */
3444
- Description: string;
3441
+ SourceContent: string;
3445
3442
  /**
3446
- * 规则顺序,-1表示最低,1表示最高,请勿和外层Type冲突(和外层的Type配合使用,当中间插入时,指定添加位置)
3443
+ * 访问源类型,不区分大小写,可传 net、template、instance、resourcegroup、tag、region 或 dnsparse。instance 的具体资产类型由 SourceContent 的实例 ID 前缀识别;template、instance、resourcegroup、tag、region 对应的内容必须对当前账号有效。dnsparse 作为访问源时不执行目的域名的小写归一化、域名格式校验或域名解析配额检查。
3447
3444
  */
3448
- OrderIndex: string;
3445
+ SourceType: string;
3449
3446
  /**
3450
- * 协议;TCP/UDP/ICMP/ICMPv6/ANY
3447
+ * 规则状态字符串,不区分大小写;true 表示启用,false 表示禁用,省略或空字符串在结构转换时按 true 解析。普通新增最终使用账号的新增规则默认状态;batch_import 和 batch_import_cover 新增保留 Data.Enable 的解析结果;修改规则内容时保留原规则状态,因此 Data.Enable 不改变该修改的启停结果。
3451
3448
  */
3452
- Protocol?: string;
3449
+ Enable?: string;
3453
3450
  /**
3454
- * 访问控制策略的端口。取值:
3455
- -1/-1:全部端口
3456
- 80:80端口
3451
+ * 规则数据库数值 ID。普通新增由服务端生成;新增请求仅在 IsUseId=1 时采用 Data.Id。修改规则内容时 Data.Id 不改变目标规则 ID,服务端保留由外层 RuleUuid 定位的原 ID。当前 Schema 将本字段声明为字符串,而后端请求结构按 JSON 整数解析;传入字符串会导致请求解析失败。
3457
3452
  */
3458
- Port?: string;
3453
+ Id?: string;
3459
3454
  /**
3460
- * 端口协议类型参数模板id;协议端口模板id;与Protocol,Port互斥
3455
+ * 访问控制端口字符串,最多 200 字节。未使用服务模板时不能为空,可传 1..65535 的单端口、以斜杠连接且两端分别位于 1..65535 的范围、最多 15 个逗号分隔项,或以 -1/-1 表示全部端口;Protocol 为 ANY 或 ICMP 时必须为 -1/-1。使用服务模板时 Protocol、Port 可同时省略或留空;若任一字段非空,则只接受 Protocol=ANY 且 Port=-1/-1。
3461
3456
  */
3462
- ServiceTemplateId?: string;
3457
+ Port?: string;
3463
3458
  /**
3464
- * (入参时无需填写,自动生成)规则对应的唯一id
3459
+ * IPv4 企业安全组协议,区分大小写。未使用服务模板时必须填写 ANY、TCP、UDP 或 ICMP;ANY 和 ICMP 仅支持 Port=-1/-1。使用服务模板时 Protocol、Port 可同时省略或留空;若填写则只接受 Protocol=ANY 且 Port=-1/-1。ICMPv6 由独立的 IPv6 企业安全组接口处理。
3465
3460
  */
3466
- Id?: string;
3461
+ Protocol?: string;
3467
3462
  /**
3468
- * (入参时Enable无意义;由通用配置中新增规则启用状态控制)
3469
- 规则状态,true表示启用,false表示禁用
3463
+ * 规则生效范围,使用大写 SG、LH 或无空格的逗号分隔组合;SG 表示安全组,LH 表示轻量应用服务器。新增时省略默认补为 SG;修改规则内容时省略表示保留原范围。范围包含 LH 时,SourceType、DestType 均不能为 template,且不能使用 ServiceTemplateId。
3470
3464
  */
3471
- Enable?: string;
3465
+ Scope?: string;
3472
3466
  /**
3473
- * 规则对应的唯一内部id
3467
+ * 协议端口模板 ID,最多 50 字节,必须属于当前账号或为当前账号可用的公共模板。非空时 Protocol、Port 可同时省略或留空;若任一字段非空,则只接受 Protocol=ANY 且 Port=-1/-1。Scope 包含 LH 时不能使用服务模板。
3474
3468
  */
3475
- Uid?: string;
3469
+ ServiceTemplateId?: string;
3476
3470
  /**
3477
- * 规则生效范围,SG安全组,LH轻量服务器
3471
+ * Schema 中声明的规则内部 UUID 字段。当前新增和修改请求结构绑定的 JSON 键名为 UuId 而不是 Uid,因此传入本字段不会参与这两个接口的内部 UUID 生成或复用。
3478
3472
  */
3479
- Scope?: string;
3473
+ Uid?: string;
3480
3474
  }
3481
3475
  /**
3482
3476
  * ModifySecurityGroupItemRuleStatus返回参数结构体
@@ -3916,6 +3910,10 @@ export interface ModifyVpcAcRuleRequest {
3916
3910
  * 规则关联的beta任务
3917
3911
  */
3918
3912
  export interface BetaInfoByACL {
3913
+ /**
3914
+ * 上次执行时间
3915
+ */
3916
+ LastTime?: string;
3919
3917
  /**
3920
3918
  * 任务id
3921
3919
  */
@@ -3924,10 +3922,15 @@ export interface BetaInfoByACL {
3924
3922
  * 任务名称
3925
3923
  */
3926
3924
  TaskName?: string;
3925
+ }
3926
+ /**
3927
+ * CreateNatFwDnatRule返回参数结构体
3928
+ */
3929
+ export interface CreateNatFwDnatRuleResponse {
3927
3930
  /**
3928
- * 上次执行时间
3931
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
3929
3932
  */
3930
- LastTime?: string;
3933
+ RequestId?: string;
3931
3934
  }
3932
3935
  /**
3933
3936
  * DescribeAcLists返回参数结构体
@@ -4115,13 +4118,13 @@ export interface CreateAddressTemplateResponse {
4115
4118
  RequestId?: string;
4116
4119
  }
4117
4120
  /**
4118
- * CreateNatFwDnatRule返回参数结构体
4121
+ * DescribeAclRegInfo请求参数结构体
4119
4122
  */
4120
- export interface CreateNatFwDnatRuleResponse {
4123
+ export interface DescribeAclRegInfoRequest {
4121
4124
  /**
4122
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
4125
+ * 防火墙类型 SERIAL:串行、NAT:NAT防火墙,BYPASS:旁路防火墙
4123
4126
  */
4124
- RequestId?: string;
4127
+ FwType?: Array<string>;
4125
4128
  }
4126
4129
  /**
4127
4130
  * DescribeResourceGroupNew返回参数结构体
@@ -6513,7 +6516,7 @@ export interface DescribeNatCcnFwSwitchResponse {
6513
6516
  */
6514
6517
  export interface ModifyRunSyncAssetResponse {
6515
6518
  /**
6516
- * 0:同步成功,1:资产更新中,2:后台同步调用失败
6519
+ * <p>0:同步成功,1:资产更新中,2:后台同步调用失败</p>
6517
6520
  */
6518
6521
  Status?: number;
6519
6522
  /**
@@ -6934,31 +6937,31 @@ export interface TemplateListInfo {
6934
6937
  IpVersion?: number;
6935
6938
  }
6936
6939
  /**
6937
- * 封禁列表和放通列表结构体
6940
+ * 封禁或放通规则条目;各字段的校验、归一化和实际用途由 RuleType 决定。
6938
6941
  */
6939
6942
  export interface BanAndAllowRule {
6940
6943
  /**
6941
- * 规则评论
6944
+ * 规则备注,最多 200 个字符。
6942
6945
  */
6943
6946
  Comment?: string;
6944
6947
  /**
6945
- * 自定义白名单规则
6948
+ * 自定义放通规则详情。RuleType=6 时使用;其它规则类型不读取此字段。
6946
6949
  */
6947
6950
  CustomRule?: CustomWhiteRule;
6948
6951
  /**
6949
- * 0互联网出站 1互联网入站 5内网访问源 6内网访问目的
6952
+ * 生效方向,使用逗号分隔的整数:0 互联网出站、1 互联网入站、2 双向、3 东西向、4 情报误报反馈、5 内网访问源、6 内网访问目的;每项都必须属于 0 至 6。该字段不可为空;RuleType=6 时通过初始校验后,处理器会根据 CustomRule 的源、目的地址重新计算方向。
6950
6953
  */
6951
6954
  DirectionList?: string;
6952
6955
  /**
6953
- * 规则截止时间
6956
+ * 规则截止时间,必须使用 YYYY-MM-DD HH:MM:SS 格式且不得早于服务器处理时刻;3000-01-01 00:00:00 作为长期有效时间。
6954
6957
  */
6955
6958
  EndTime?: string;
6956
6959
  /**
6957
- * 放通的引擎: 1针对互联网边界 2针对nat防火墙 4针对vpc防火墙
6960
+ * 自定义放通规则的生效引擎位图:1 互联网边界旁路、2 NAT 防火墙、4 VPC 防火墙、8 互联网边界串行、16 NDR,组合值按位相加。处理器接受 0 至 31。RuleType=6 时,非零值会按源、目的地址组合与适用引擎位求交,并保留 NDR 位 16;归一化结果大于 0 时使用该结果,结果为 0 时与省略或传 0 相同:任一地址为 IPv6 或私网 IPv4 则实际使用 6,否则实际使用 15。其它 RuleType 仅校验该字段而不使用其值。
6958
6961
  */
6959
6962
  FwType?: number;
6960
6963
  /**
6961
- * 封禁和放通对象
6964
+ * 规则对象。RuleType=1 或 2 时必须是 IP 地址,RuleType=3 时必须是合法域名,RuleType=4 时不能为空,RuleType=5 时必须是资产表中存在的实例 ID;RuleType=6 时表示自定义规则 ID:新增时可省略并由处理器生成;修改时作为既有规则的查询和更新键,省略时不会命中既有规则。其它受理的 RuleType 不校验对象格式。
6962
6965
  */
6963
6966
  Ioc?: string;
6964
6967
  }
@@ -7352,7 +7355,7 @@ export interface FwVpcCidr {
7352
7355
  */
7353
7356
  export interface ModifyRunSyncAssetRequest {
7354
7357
  /**
7355
- * 0: 互联网防火墙开关,1:vpc 防火墙开关
7358
+ * <p>0: 互联网防火墙开关,1:vpc 防火墙开关</p>
7356
7359
  */
7357
7360
  Type?: number;
7358
7361
  }
@@ -7475,79 +7478,73 @@ export interface DescribeFwEdgeIpsRequest {
7475
7478
  By?: string;
7476
7479
  }
7477
7480
  /**
7478
- * 创建互联网边界规则参数结构
7481
+ * 互联网边界访问控制规则参数结构,供新增和修改共用。每个对象都会被解析为一条完整的新规则记录;替换现有规则时,请求中省略的字段不会从旧记录自动继承,仅内部 AutoTask 字段由服务端保留。
7479
7482
  */
7480
7483
  export interface CreateRuleItem {
7481
7484
  /**
7482
- * 访问源示例: net:IP/CIDR(192.168.0.2)
7485
+ * 规则方向:1 表示入站,0 表示出站;其它整数或省略会校验失败。方向还决定 SourceType、TargetType、Scope 与 Protocol 的可用组合。
7483
7486
  */
7484
- SourceContent: string;
7485
- /**
7486
- * 访问源类型:入向规则时类型可以为 ip,net,template,location;出向规则时可以为 ip,net,template,instance,group,tag
7487
- */
7488
- SourceType: string;
7487
+ Direction: number;
7489
7488
  /**
7490
- * 访问目的示例: net:IP/CIDR(192.168.0.2) domain:域名规则,例如*.qq.com
7489
+ * 规则在当前方向可操作分区内的序号。Handler 先把 int64 转为 uint32:转换结果 0 归一化为 1;结果不超过当前最大序号时在该位置插入并顺延后续规则,否则追加到末尾。省略或传 -1 会追加;超出 uint32 范围的整数会绕回,调用方不应依赖该转换。当 Rules 含多条规则时,只用首条规则的序号和方向决定整批进入插入或追加分支:追加时整批改写为该方向末尾的连续序号,插入时其余规则保留各自解析后的序号。
7491
7490
  */
7492
- TargetContent: string;
7491
+ OrderIndex: number;
7493
7492
  /**
7494
- * 访问目的类型:入向规则时类型可以为ip,net,template,instance,group,tag;出向规则时可以为 ip,net,domain,template,location
7493
+ * 目的端口。Protocol 归一化为 ICMP 时本字段被忽略并保存为空字符串;其它协议必须提供可解析字符串,按逗号分隔为单个正整数或“起始/结束”整数范围,范围起始值不得大于结束值,Handler 未对范围端点设置显式上下界,-1/-1 表示全部端口。FTP 只接受不含逗号和斜杠的单个正整数。domain 或域名模板目的在 side 或 all 范围下不接受除 -1/-1、0/65535 之外的端口范围。
7495
7494
  */
7496
- TargetType: string;
7495
+ Port: string;
7497
7496
  /**
7498
- * 协议,可选的值: TCP UDP ICMP ANY HTTP HTTPS HTTP/HTTPS SMTP SMTPS SMTP/SMTPS FTP DNS
7499
- 1. 入方向 旁路防火墙/全局规则 仅支持TCP
7500
-
7501
- 2.出方向 旁路防火墙/全局规则 仅支持TCP HTTP/HTTPS TLS/SSL
7502
-
7503
- 3.domain 请选择七层协议 如HTTP/HTTPS
7504
-
7497
+ * 协议,解析不区分大小写。四层值 TCPUDPICMP、ICMPV6、ANY 归一化为大写;应用层值 HTTPHTTPSHTTP/HTTPSSMTPSMTPSSMTP/SMTPS、FTP、DNS、TLS/SSL 及别名 domain、TLS、SSL 归一化为对应标准值。ANY 同时属于可解析的四层协议和应用协议,domain、TLS、SSL 均归一化为 TLS/SSL。domain 或域名模板目的接受上述应用层协议及 ANY,但不接受 FTP 和其它四层协议;dnsparse、domainiptwoverify 仅接受 TCP 或 UDP 且仅支持 serial;其它目的在公有云环境不接受 FTP、ANY 之外的应用层协议。side 或 all 范围下,入站仅接受 TCP,出站仅接受 TCP、HTTP/HTTPS 或 TLS/SSL。DNS 用于非 domain 目的且目的不是 * 时,目的内容还必须是非 IP 的合法域名规则列表。使用协议端口模板时,模板中的每组协议和端口也执行这些联动校验。
7505
7498
  */
7506
7499
  Protocol: string;
7507
7500
  /**
7508
- * 访问控制策略中设置的流量通过云防火墙的方式。取值: accept:放行 drop:拒绝 log:观察
7501
+ * 流量处理动作,解析不区分大小写。accept 表示放行,drop 表示拒绝,log 表示观察;isolateinaccept、isolateoutaccept 归一化为放行,isolateindrop、isolateoutdrop 归一化为拒绝。drop 及其拒绝别名还会校验当前账号是否具备互联网边界阻断能力。
7509
7502
  */
7510
7503
  RuleAction: string;
7511
7504
  /**
7512
- * 访问控制策略的端口。取值: -1/-1:全部端口 80:80端口
7505
+ * 访问源内容。ip 或 net 使用合法 IP/CIDR 列表,普通列表最多 10 项;template 使用当前账号可解析的地址模板标识;Direction=0 时,instance、group、tag 使用相应资源标识,其中 instance 必须能解析到公网 IP,tag 必须存在;Direction=1 时,location 使用地域 code CSV 并须通过当前账号的新地域规则能力校验,vendor 使用 tencent、aliyun、aws、huawei、azure 或 all 的 CSV。location、vendor 保存时会转换为地域或厂商匹配信息。
7513
7506
  */
7514
- Port: string;
7507
+ SourceContent: string;
7515
7508
  /**
7516
- * 规则方向:1,入站;0,出站
7509
+ * 访问源类型,解析不区分大小写。Direction=1 接受 ip、net、template、location、vendor;Direction=0 接受 ip、net、template、instance、group、tag。ip 与 net 归一化为同一 IP/CIDR 类型;其它已解析但不在对应方向处理分支中的类型会校验失败。
7517
7510
  */
7518
- Direction: number;
7511
+ SourceType: string;
7519
7512
  /**
7520
- * 规则序号
7513
+ * 访问目的内容。ip 或 net 使用合法 IP/CIDR 列表;domain 使用后端域名规则校验接受的列表(包括 IP、普通域名和通配域名)或 *;普通 IP/CIDR/domain 列表最多 10 项,通配域名最多 5 级。domain 配合 DNS 协议时例外地不接受 IP。dnsparse 使用单个合法域名、泛域名或当前账号可解析的 mb_ 域名模板,domainiptwoverify 使用单个不含任何通配符的合法域名或此类 mb_ 域名模板;两者都不接受单独的 *、IP、逗号列表或段内通配域名。串行 domain 段内通配和串行 domainiptwoverify 的 mb_ 域名模板分别要求对应集群引擎版本支持。template 使用当前账号可解析的地址模板标识;Direction=1 时,instance、group、tag 使用相应资源标识,其中 instance 必须能解析到公网 IP,tag 必须存在;Direction=0 时,location 使用地域 code CSV 并须通过当前账号的新地域规则能力校验,vendor 使用 tencent、aliyun、aws、huawei、azure 或 all 的 CSV。解析并归一化后的目的内容长度不得超过 1023。
7521
7514
  */
7522
- OrderIndex: number;
7515
+ TargetContent: string;
7523
7516
  /**
7524
- * 规则对应的唯一id,创建规则时无需填写
7517
+ * 访问目的类型,解析不区分大小写。Direction=1 接受 ip、net、template、domain、instance、group、tag;Direction=0 接受 ip、net、template、domain、dnsparse、domainiptwoverify、location、vendor。ip 与 net 归一化为同一 IP/CIDR 类型;其它已解析但不在对应方向处理分支中的类型会校验失败。
7525
7518
  */
7526
- Uuid?: number;
7519
+ TargetType: string;
7527
7520
  /**
7528
- * 规则状态,true表示启用,false表示禁用
7521
+ * 规则描述。省略或传空字符串时保存为空;替换现有规则时不继承旧值。Handler 未对字符数设置显式限制。
7522
+ */
7523
+ Description?: string;
7524
+ /**
7525
+ * 启用状态。非空值不区分大小写接受字符串 true 或 false,并归一化为启用或停用;省略或传空字符串时读取当前账号的访问控制默认启用配置,该配置不可用时默认启用。替换现有规则时不继承旧值。
7529
7526
  */
7530
7527
  Enable?: string;
7531
7528
  /**
7532
- * 描述
7529
+ * 关联告警或来源事件 ID。省略或传空字符串时保存为空,替换现有规则时不继承旧值;From=batch_import_cover 时,非空值还会作为覆盖导入后规则的内部字符串 UUID 复用。
7533
7530
  */
7534
- Description?: string;
7531
+ LogId?: string;
7535
7532
  /**
7536
- * all
7533
+ * 协议端口模板 ID。省略或传空字符串表示不使用模板;非空时按当前账号和 ID 加载模板,找不到会失败。受支持输入应指向内容格式为“协议:端口”的协议端口模板;其中格式有效的每组协议和端口都会执行 Direction、TargetType 与 Scope 联动校验,异常模板内容不属于受支持输入。Protocol 和 Port 仍会在加载模板前按各自字段规则解析,原生 Handler 不要求固定填写 ANY、-1/-1 或 serial。
7537
7534
  */
7538
- Scope?: string;
7535
+ ParamTemplateId?: string;
7539
7536
  /**
7540
- * 0,正常规则添加;1,入侵检测添加
7537
+ * 规则来源。整数 2 原样保存;省略或传入其它整数均归一化为 0
7541
7538
  */
7542
7539
  RuleSource?: number;
7543
7540
  /**
7544
- * 告警Id
7541
+ * 生效范围,解析不区分大小写:serial 表示串行,side 表示旁路,all 表示全局;省略、空字符串或其它值会校验失败。国际站环境会将有效输入统一归一化为 serial。协议、端口、目的类型及协议端口模板的联动限制见 Protocol、Port 和 ParamTemplateId。
7545
7542
  */
7546
- LogId?: string;
7543
+ Scope?: string;
7547
7544
  /**
7548
- * 端都协议组ID
7545
+ * 规则数值 ID。普通新增、指定位置新增和批量导入会忽略该字段;From=batch_import_cover 时正整数 ID 会作为覆盖导入后的规则 ID 复用;修改时必须提供当前账号可操作分区内已存在的正整数 ID,用于定位并替换原规则,省略、非正整数或不存在的 ID 会导致规则查询失败。
7549
7546
  */
7550
- ParamTemplateId?: string;
7547
+ Uuid?: number;
7551
7548
  }
7552
7549
  /**
7553
7550
  * CloseClusterNatFwSwitch请求参数结构体
@@ -7669,6 +7666,35 @@ export interface ModifyAddressTemplateRequest {
7669
7666
  */
7670
7667
  ProtocolType?: string;
7671
7668
  }
7669
+ /**
7670
+ * Nat实例类型
7671
+ */
7672
+ export interface NatFwInstance {
7673
+ /**
7674
+ * nat实例id
7675
+ */
7676
+ NatinsId?: string;
7677
+ /**
7678
+ * nat实例名称
7679
+ */
7680
+ NatinsName?: string;
7681
+ /**
7682
+ * 实例所在地域
7683
+ */
7684
+ Region?: string;
7685
+ /**
7686
+ * 0:新增模式,1:接入模式
7687
+ */
7688
+ FwMode?: number;
7689
+ /**
7690
+ * 0:正常状态, 1: 正在创建
7691
+ */
7692
+ Status?: number;
7693
+ /**
7694
+ * nat公网ip
7695
+ */
7696
+ NatIp?: string;
7697
+ }
7672
7698
  /**
7673
7699
  * NAT防火墙Dnat规则
7674
7700
  */
@@ -7974,7 +8000,7 @@ export interface DescribeVpcAcRuleRequest {
7974
8000
  */
7975
8001
  export interface AddAclRuleResponse {
7976
8002
  /**
7977
- * <p>创建成功后返回新策略ID列表</p>
8003
+ * 数据库插入成功后返回的新规则数值 ID 列表,顺序与已插入的 Rules 顺序一致;不表示异步规则下发已经完成。
7978
8004
  */
7979
8005
  RuleUuid?: Array<number | bigint>;
7980
8006
  /**
@@ -8014,69 +8040,69 @@ export interface CreateAlertCenterIsolateRequest {
8014
8040
  OmMode?: number;
8015
8041
  }
8016
8042
  /**
8017
- * 创建NAT ACL规则参数结构
8043
+ * NAT 访问控制规则参数结构。新增和修改使用相同的字段解析;字段组合按 Direction、源和目的类型与内容、Protocol、Port、ParamTemplateId、RuleAction 和 Scope 校验。
8018
8044
  */
8019
8045
  export interface CreateNatRuleItem {
8020
8046
  /**
8021
- * <p>访问源示例: net:IP/CIDR(192.168.0.2)</p>
8047
+ * <p>规则方向,JSON 整数:0 表示出站,1 表示入站;其他值被拒绝。方向决定可用的源和目的类型及协议组合。</p>
8022
8048
  */
8023
- SourceContent: string;
8024
- /**
8025
- * <p>访问源类型:入向规则时类型可以为 ip,net,template,location;出向规则时可以为 ip,net,template,instance,group,tag</p>
8026
- */
8027
- SourceType: string;
8049
+ Direction: number;
8028
8050
  /**
8029
- * <p>访问目的示例: net:IP/CIDR(192.168.0.2) domain:域名规则,例如*.qq.com</p>
8051
+ * <p>规则序号。入口按 int64 读取后转换为 uint32,转换结果为 0 时归一化为 1;负值不会被单独拒绝,而会按 uint32 转换。写入中间分区时,序号为 1 或不大于当前同方向最大序号会按该位置插入并后移原规则,超过最大序号时通常归一化为末尾序号。新增且 From 不等于 insert_rule 时,如果本批首条规则转换后的序号为 1,则批内后续规则即使超过最大序号也按各自转换后的序号直接插入。</p>
8030
8052
  */
8031
- TargetContent: string;
8053
+ OrderIndex: number;
8032
8054
  /**
8033
- * <p>访问目的类型:入向规则时类型可以为ip,net,template,instance,group,tag;出向规则时可以为 ip,net,domain,template,location</p>
8055
+ * <p>目的端口字符串。支持逗号分隔的单端口或以斜杠分隔的起止范围,例如 80、80,443、80/443;-1/-1 表示全部端口。单端口必须是大于 0 的整数;范围只要求两个端点均为整数且起点不大于终点。Protocol 归一化为 ICMP 时忽略该字段并保存为空字符串;FTP 只接受单端口,不接受逗号列表或斜杠范围。</p>
8034
8056
  */
8035
- TargetType: string;
8057
+ Port: string;
8036
8058
  /**
8037
- * <p>协议,可选的值: TCP UDP ICMP ANY HTTP HTTPS HTTP/HTTPS SMTP SMTPS SMTP/SMTPS FTP DNS</p>
8059
+ * <p>协议,大小写不敏感并归一化为大写。四层值为 TCPUDPICMP、ICMPV6、ANY;应用层值为 HTTPHTTPSHTTP/HTTPS、TLS/SSL、SMTPSMTPSSMTP/SMTPS、FTP、DNS,其中 domain、tls、ssl 也归一化为 TLS/SSL;ANY 同时可按四层协议和应用协议解析。入站仅允许 ANY、TCP、UDP;domain 目的及解析为域名模板的 template 目的接受上述应用层协议及 ANY,但不接受 FTP;dnsparse 和 domainiptwoverify 目的仅允许 TCP 或 UDP;其他目的不接受 FTP 和 ANY 之外的应用层协议。Protocol=DNS 且目的不是域名模板或单独的 * 时,目的列表只能包含域名,不能包含 IP。</p>
8038
8060
  */
8039
8061
  Protocol: string;
8040
8062
  /**
8041
- * <p>访问控制策略中设置的流量通过云防火墙的方式。取值: accept:放行 drop:拒绝 log:观察</p>
8063
+ * <p>流量处理方式,大小写不敏感:accept 表示放行,drop 表示拒绝,log 表示观察;isolateinaccept、isolateoutaccept 归一化为 accept,isolateindrop、isolateoutdrop 归一化为 drop。</p>
8042
8064
  */
8043
8065
  RuleAction: string;
8044
8066
  /**
8045
- * <p>访问控制策略的端口。取值: -1/-1:全部端口 80:80端口</p>
8046
- */
8047
- Port: string;
8048
- /**
8049
- * <p>规则方向:1,入站;0,出站</p>
8067
+ * <p>访问源内容,格式由 SourceType 和 Direction 决定。net/ip 使用合法 IP 或 CIDR 的逗号列表,最多 10 项;location 使用地域 code,空字符串归一化为默认全地域掩码;vendor 使用 tencent、aliyun、aws、huawei、azure 或 all,可用逗号分隔;template 使用当前账号可解析的地址模板标识;instance 和 tag 必须引用当前账号已有对象;group 使用资源组标识,入口不校验其是否存在。</p>
8050
8068
  */
8051
- Direction: number;
8069
+ SourceContent: string;
8052
8070
  /**
8053
- * <p>规则序号</p>
8071
+ * <p>访问源类型,大小写不敏感。入站支持 net、ip、template、location、vendor;出站支持 net、ip、template、instance、group、tag。ip 和 net 均归一化为 IP 类型;template 会解析为模板的实际类型。</p>
8054
8072
  */
8055
- OrderIndex: number;
8073
+ SourceType: string;
8056
8074
  /**
8057
- * <p>规则状态,true表示启用,false表示禁用</p>
8075
+ * <p>访问目的内容,格式由 TargetType 和 Direction 决定。net/ip 使用合法 IP 或 CIDR 的逗号列表;domain 使用合法域名或 IP 的逗号列表,也接受单独的 *,标准泛域名和段内通配域名最多 5 级,段内通配域名还要求对应引擎版本支持;dnsparse 使用单个精确域名、最多 5 级的标准泛域名或相应域名模板,不接受单独的 *、段内通配域名、IP 或逗号列表;domainiptwoverify 使用单个精确域名或不含通配符的相应域名模板,不接受单独的 *、任何通配域名、IP 或逗号列表;location 使用地域 code,空字符串归一化为默认全地域掩码;vendor 使用 tencent、aliyun、aws、huawei、azure 或 all,可用逗号分隔;template 使用当前账号可解析的地址模板标识;instance 和 tag 必须引用当前账号已有对象;group 使用资源组标识,入口不校验其是否存在。解析后的目的内容最长 1023 字节;IP 或 domain 目的最多包含 10 个逗号分隔项。</p>
8058
8076
  */
8059
- Enable?: string;
8077
+ TargetContent: string;
8060
8078
  /**
8061
- * <p>规则对应的唯一id,创建规则AddNatAcRule时无需填写;修改规则ModifyNatAcRule时必须填写</p><p>创建规则AddNatAcRule时无需填写;修改规则ModifyNatAcRule时必须填写</p>
8079
+ * <p>访问目的类型,大小写不敏感。入站支持 net、ip、template、instance、group、tag;出站支持 net、ip、template、domain、dnsparse、domainiptwoverify、location、vendor。ip 和 net 均归一化为 IP 类型;template 会解析为模板的实际类型,入站解析为域名模板时被拒绝。dnsparse 和 domainiptwoverify 分别要求对应引擎版本支持;domainiptwoverify 使用域名模板时还要求严格模式域名模板版本支持;domain 目的使用段内通配域名时要求段内通配域名版本支持。</p>
8062
8080
  */
8063
- Uuid?: number;
8081
+ TargetType: string;
8064
8082
  /**
8065
- * <p>描述</p>
8083
+ * <p>规则描述。省略或传空字符串时保存为空;入口不裁剪内容,也不执行长度归一化或字符数校验。</p>
8066
8084
  */
8067
8085
  Description?: string;
8068
8086
  /**
8069
- * <p>端口协议组ID</p>
8087
+ * <p>规则状态。字符串 true 表示启用,false 表示禁用,大小写不敏感。省略或传空字符串时读取当前账号的访问控制规则默认状态;配置不存在或无法解析时默认为启用。</p>
8070
8088
  */
8071
- ParamTemplateId?: string;
8089
+ Enable?: string;
8072
8090
  /**
8073
- * <p>内部id</p>
8091
+ * <p>规则内部 UUID。新增请求仅在 From=batch_import_cover 时采用正整数值替换自动生成的内部 UUID;其他新增路径和修改请求忽略该字段。</p>
8074
8092
  */
8075
8093
  InternalUuid?: number;
8076
8094
  /**
8077
- * <p>规则生效的范围:ALL,全局生效;ap-guangzhou,生效的地域;cfwnat-xxx,生效基于实例维度</p>
8095
+ * <p>端口协议模板 ID。省略或传空字符串时直接使用请求中的 Protocol 和 Port;非空时必须指向当前账号已有的端口协议模板,模板条目会逐项参与协议与目的类型联动校验。使用模板时,入口仍先校验请求中的 Protocol,并在该协议不是 ICMP 时校验请求中的 Port;请求值不要求固定为 ANY 和 -1/-1。</p>
8096
+ */
8097
+ ParamTemplateId?: string;
8098
+ /**
8099
+ * <p>规则生效范围,值中不能含空白字符。ALL 表示全部 NAT 实例;地域 ID(如 ap-guangzhou)表示地域范围;cfwnat- 或 nat- 开头的实例 ID 表示实例范围。非空值必须是已知地域或当前账号已有的 NAT 实例。省略或传空字符串时,有请求 Region 则使用 Region,否则归一化为 ALL。</p>
8078
8100
  */
8079
8101
  Scope?: string;
8102
+ /**
8103
+ * <p>规则数据库 ID。普通新增、insert_rule 和 batch_import 忽略该字段;batch_import_cover 新增会采用正整数值作为待写入记录 ID。修改请求使用正整数定位中间分区中的现有规则,先删除该记录再以同一 Uuid 重建并返回该 ID;省略、0 或负值无法定位修改目标。</p>
8104
+ */
8105
+ Uuid?: number;
8080
8106
  }
8081
8107
  /**
8082
8108
  * 企业安全组规则执行顺序修改对象
@@ -8347,7 +8373,7 @@ export interface DescribeEdgeIpSimpleRequest {
8347
8373
  */
8348
8374
  export interface CreateNatFwInstanceResponse {
8349
8375
  /**
8350
- * 防火墙实例id
8376
+ * <p>防火墙实例id</p>
8351
8377
  */
8352
8378
  CfwInsId?: string;
8353
8379
  /**
@@ -8919,15 +8945,15 @@ export interface DescribeEnterpriseSecurityGroupRuleListRequest {
8919
8945
  */
8920
8946
  export interface CreateAlertCenterOmitResponse {
8921
8947
  /**
8922
- * <p>返回状态码:<br>0 成功<br>非0 失败</p>
8948
+ * <p>Cloud API 处理返回码。0 表示 Action 处理函数未返回顶层错误,-1 表示入口参数校验或路由处理失败。忽略记录的数据库处理结果由 Status 表示;ReturnCode=0 不代表一定有记录被更新。</p>
8923
8949
  */
8924
8950
  ReturnCode?: number;
8925
8951
  /**
8926
- * <p>返回信息:<br>success 成功<br>其他</p>
8952
+ * <p>Cloud API 处理信息。Action 处理函数未返回顶层错误时为 success;入口参数校验或路由处理失败时为 failed,并同时返回 Error。</p>
8927
8953
  */
8928
8954
  ReturnMsg?: string;
8929
8955
  /**
8930
- * <p>处置状态码:<br>0 处置成功<br>-1 通用错误,不用处理<br>-3 表示重复,需重新刷新列表<br>其他</p>
8956
+ * <p>忽略处理状态。0 表示目标表更新语句执行时未返回数据库错误,但接口不检查受影响行数,因此不保证有记录命中;-1 表示参数归一化后无有效目标或下游处理失败;-3 表示下游报告重复记录错误。应结合 ReturnCode 判断入口校验是否通过。</p>
8931
8957
  */
8932
8958
  Status?: number;
8933
8959
  /**