华为云用户手册

to_iso8601函数 将日期类型或时间戳类型的日期时间表达式转换为ISO8601格式的日期时间表达式。 语法：to_iso8601(expr) 表19 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd或yyyy-MM-dd HH:mm:ss.SSS String类型 是 返回值类型：String类型 示例：SELECT TO_ISO8601('2023-04-15'), TO_ISO8601('2023-04-15 11:13:35.954') 表20 查询分析结果 类型 场景1 场景2 查询语句 TO_ISO8601('2023-04-15') TO_ISO8601('2023-04-15 11:13:35.954') 返回结果 2023-04-15 2023-04-15T11:13:35.954Z

from_iso8601_timestamp函数 将ISO8601格式的日期表达式expr转换为格式为yyyy-MM-dd HH:mm:ss.SSS的String类型的日期表达式。 语法：from_iso8601_timestamp(expr) 表5 参数说明 参数名称 描述 类型 是否必选 expr ISO8601格式的日期表达式 String 是 返回值类型：String类型 示例：SELECT FROM_ISO8601_TIMESTAMP('2018-05-14T11:51:50.153+08:00') 表6 查询分析结果 类型 场景 查询语句 FROM_ISO8601_TIMESTAMP('2018-05-14T11:51:50.153+08:00') 返回结果 2018-05-14 11:51:50.153

mills_to_timestamp函数 将UNIX时间戳转换为日期和时间表达式。 将UNIX时间戳转化为没有时区的时间戳类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS。 语法：mills_to_timestamp(expr) 表7 参数说明 参数名称 描述 类型 是否必选 expr UNIX时间戳 Long 是 返回值类型：String类型 示例：SELECT MILLS_TO_TIMESTAMP(1626774758000) 表8 查询分析结果 类型 场景 查询语句 MILLS_TO_TIMESTAMP(1626774758000) 返回结果 2021-07-20 09:52:38.000 将UNIX时间戳转化为带时区的timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone。 语法：mills_to_timestamp(expr, timezone) 表9 参数说明 参数名称 描述 类型 是否必选 expr UNIX时间戳 Long 是 timezone 时区 String 是 返回值类型：String类型 示例：SELECT MILLS_TO_TIMESTAMP(1626774758000, 'Asia/Shanghai') 表10 查询分析结果 类型 场景 查询语句 MILLS_TO_TIMESTAMP(1626774758000, 'Asia/Shanghai') 返回结果 2021-07-20 17:52:38.000 Asia/Shanghai 将UNIX时间戳expr转换为具有时区的时间戳类型的日期和时间表达式。表达式中，hour和minute表示时区偏移量，格式为yyyy-MM-dd HH:mm:ss.SSS 时区偏移量。 语法：mills_to_timestamp(expr, hour, minutes) 表11 参数说明 参数名称 描述 类型 是否必选 expr UNIX时间戳 Long 是 hour 小时 Integer 是 minute 分钟 Integer 是 返回值类型：String类型 示例：SELECT MILLS_TO_TIMESTAMP(1626774758000, -2, 0) 表12 查询分析结果 类型 场景 查询语句 MILLS_TO_TIMESTAMP(1626774758000, -2, 0) 返回结果 2021-07-20 07:52:38.000-02:00

from_iso8601_date函数 将ISO8601格式的日期表达式expr转换为格式为yyyy-MM-dd的String类型的日期表达式。 语法：from_iso8601_date(expr) 表3 参数说明 参数名称 描述 类型 是否必选 expr ISO8601格式的日期表达式 String 是 返回值类型：String类型 示例：SELECT FROM_ISO8601_DATE('2018-05-14T11:51:50.153+08:00') 表4 查询分析结果 类型 场景 查询语句 FROM_ISO8601_DATE('2018-05-14T11:51:50.153+08:00') 返回结果 2018-05-14

函数列表 表1 日期和时间函数 函数 描述 current_timestamp函数 返回当前日期和时间，格式为yyyy-MM-dd HH:mm:ss.SSS from_iso8601_date函数 将ISO8601格式的日期表达式expr转换为date类型的日期表达式，格式为yyyy-MM-dd from_iso8601_timestamp函数 将ISO8601格式的日期表达式expr转换为timestamp类型的日期表达式，格式为yyyy-MM-dd HH:mm:ss.SSS mills_to_timestamp函数 将UNIX时间戳转换为日期和时间表达式。 from_unixtime函数 将UNIX时间戳转换为日期和时间表达式。与mills_to_timestamp函数用法一致。 to_iso8601函数 将日期类型或时间戳类型的日期时间表达式转换为ISO8601格式的日期时间表达式。 timestamp_to_mills函数 将时间戳类型的日期和时间表达式转换为UNIX时间戳。 to_unixtime函数 将时间戳类型的日期和时间表达式转换为UNIX时间戳。与timestamp_to_mills函数用法一致。 time_ceil函数 将时间戳舍入，将其作为新的时间戳返回。Period可以是任何ISO8601的周期，如P3M（季度）或PT12H（半天）。指定Origin作为时间戳，以设置舍入的参考时间。例如，TIME_CEIL(time, 'PT1H', '2016-06-27 00:30:00')测量的小时周期从00:30-01:30而不是00:00-01:00。时区（如果提供）应该是时区名称，如“America/Los_Angeles”或偏移量，如“-08:00”。此功能与ceil_to类似，但更灵活。 time_floor函数 向下舍入时间戳，将其作为新的时间戳返回。Period可以是任何ISO8601的周期，如P3M（季度）或PT12H（半天）。指定Origin作为时间戳，以设置舍入的参考时间。例如，TIME_FLOOR(time, 'PT1H', '2016-06-27 00:30:00')测量的小时周期从00:30-01:30而不是00:00-01:00。时区（如果提供）应该是时区名称，如“America/Los_Angeles”或偏移量，如“-08:00”。此功能与floor_to类似，但更灵活。 ceil函数 使用时间单位对时间戳进行四舍五入，单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。 floor函数 使用时间单位对时间戳进行向下舍入，单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。 time_shift函数 将时间戳expr移动一个Period（步长时间）。Period可以是任何ISO8601的Period。 timezone_hour函数 计算系统时区和utc时区的小时偏移量。如果提供了时区，则计算系统时区与给定时区的偏移量。 timezone_minute函数 计算系统时区和utc时区的分钟偏移量。如果提供了时区，则计算系统时区与给定时区的偏移量。 time_format函数 将时间戳类型的日期和时间表达式转换为指定格式的日期和时间表达式。 date_format函数 将时间戳类型的日期和时间表达式转换为指定格式的日期和时间表达式。与time_format函数功能一致。 time_parse函数 将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。 date_parse函数 将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。与time_parse函数功能一致。 time_extract函数 通过指定字段提取日期时间表达式的日期或时间部分。EPOCH, SECOND, MINUTE, HOUR, DAY(月的日), DOW（周的日）, DOY（年的日）, WEEK（年周）, MONTH（1到12）, QUARTER（1到4）,或YEAR,时区（如果提供）应为时区名称，如"America/Los_Angeles"或偏移量，如"-08:00" date_trunc函数 根据您指定的时间单位截断日期和时间表达式，并以毫秒、秒、分钟、小时、天、月或年为单位对齐。 date_diff函数 返回时间戳expr1和时间戳expr2之间的单位数（有符号）。 current_date函数 返回当前日期，格式是“yyyy-MM-dd”。 now函数 返回当前日期和时间，格式是“yyyy-MM-dd HH:mm:ss.SSS”。功能与current_timestamp一致 date_add函数 给时间加上给定的时间间隔 current_time函数 返回当前时间，格式为HH:mm:ss.SSSSSS。 current_timezone函数 返回当前时区。 localtime函数 返回本地时间。 localtimestamp函数 返回本地的日期和时间。 year_of_week函数 返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。 yow函数 返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。 time_series函数 用于补全您查询时间窗口内缺失的数据。

终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，云桌面的终端节点如终端节点所示，请您根据业务需要选择对应区域的终端节点。您可以从地区和终端节点中查询所有服务的终端节点。 表1 云桌面的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四 cn-north-4 workspace.cn-north-4.myhuaweicloud.com 华东-上海一 cn-east-3 workspace.cn-east-3.myhuaweicloud.com 华东-青岛 cn-east-5 workspace.cn-east-5.myhuaweicloud.com 华南-广州 cn-south-1 workspace.cn-south-1.myhuaweicloud.com 西南-贵阳一 cn-southwest-2 workspace.cn-southwest-2.myhuaweicloud.com 拉美-圣地亚哥 la-south-2 workspace.la-south-2.myhuaweicloud.com 中国-香港 ap-southeast-1 workspace.ap-southeast-1.myhuaweicloud.com 父主题： 使用前必读

请求示例 { "desktops" : [ { "desktop_id" : "42cafe3c-c8bb-408f-9210-c1d3267ed749", "tags" : [ { "key" : "key10", "value" : "value10last4" }, { "key" : "key11", "value" : "value11last4" } ] } ] }

请求示例 { "desktops" : [ { "desktop_id" : "42cafe3c-c8bb-408f-9210-c1d3267ed749", "tags" : [ { "key" : "key10", "value" : "value10last4" }, { "key" : "key11", "value" : "value11last4" } ] } ] }

现象描述 查询与销售部所有员工的信息： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 --建表 CREATE TABLE staffs (staff_id NUMBER(6) NOT NULL, first_name VARCHAR2(20), last_name VARCHAR2(25), employment_id VARCHAR2(10), section_id NUMBER(4), state_name VARCHAR2(10), city VARCHAR2(10)); CREATE TABLE sections(section_id NUMBER(4), place_id NUMBER(4), section_name VARCHAR2(20)); CREATE TABLE states(state_id NUMBER(4)); CREATE TABLE places(place_id NUMBER(4), state_id NUMBER(4)); --优化前查询 EXPLAIN SELECT staff_id,first_name,last_name,employment_id,state_name,city FROM staffs,sections,states,places WHERE sections.section_name='Sales' AND staffs.section_id = sections.section_id AND sections.place_id = places.place_id AND places.state_id = states.state_id ORDER BY staff_id; --优化后查询 CREATE INDEX loc_id_pk ON places(place_id); CREATE INDEX state_c_id_pk ON states(state_id); EXPLAIN SELECT staff_id,first_name,last_name,employment_id,state_name,city FROM staffs,sections,states,places WHERE sections.section_name='Sales' AND staffs.section_id = sections.section_id AND sections.place_id = places.place_id AND places.state_id = states.state_id ORDER BY staff_id;

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下，您可以查看项目ID。 企业项目 企业项目是项目的升级版，针对企业不同项目间的资源进行分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 父主题： 使用前必读

请求示例 向用户发送短信，短信通道号为882306039，模板ID为1512。 https://koomessage.myhuaweicloud.cn/v1/aim/sms/messages { "channel_num" : "8823060****39", "template_id" : "1512****", "signature" : "测试签名", "app_name" : "OPACCOUNT688", "task_name" : "测试发送", "to" : [ "139274****98", "15527****78" ], "template_params" : [ "kXfvIwzs" ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 task_id String 任务ID。 最小长度：1 最大长度：50 status String 任务状态。 Success：发送成功 Failed：发送失败 说明： 此状态仅代表任务提交状态，不代表智能信息发送结果。用户手机接收智能信息结果请以收到的回执结果为准，也可通过查询智能信息发送明细API获取或登录KooMessage控制台查看。 最小长度：1 最大长度：20 result Array of SmsDetailResponse objects 短信ID列表，当目标号码存在多个时，每个号码都会返回一个SmsID。 当返回异常响应时不携带此字段。 表4 SmsDetailResponse 参数 参数类型 描述 to String 短信接收方的号码。 最小长度：1 最大长度：21 channel_num String 短信发送方的号码。 最小长度：1 最大长度：21 msg_id String 短信的唯一标识。 最小长度：1 最大长度：50 send_status String 短信状态码。 以下举例状态码及其说明，具体处理建议请参考API错误码。 000000：短信平台处理请求成功 E200015：待发送短信数量太大 E200028：模板变量校验失败 E200029：模板类型校验失败 E200030：模板未激活 E200031：协议校验失败 E200033：模板类型不正确 E200041：同一短信内容接收号码重复 最小长度：1 最大长度：7 create_time String 短信资源的创建时间。 即短信平台接收到用户发送短信请求的时间，为UTC时间。 格式为：yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度：1 最大长度：20 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 最小长度：0 最大长度：32 error_msg String 结果详情。 最小长度：0 最大长度：32 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 最小长度：0 最大长度：32 error_msg String 结果详情。 最小长度：0 最大长度：32

响应示例 状态码： 200 发送短信响应体。 { "status" : "Success", "result" : [ { "to" : "+86139274****8", "channel_num" : "8823060****9", "msg_id" : "b24f1f03-556e-468e-9fe1-23729b9414d7_72****6", "create_time" : "2023-08-11T12:11:24", "send_status" : "000000" }, { "to" : "+861552****978", "channel_num" : "8823060806439", "msg_id" : "b24f1f03-556e-468e-9fe1-23729b9414d7_****407", "create_time" : "2023-08-11T12:11:24", "send_status" : "000000" } ], "task_id" : "a914ca57-09cf-4899-af62-f9a****06c3c" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 task_id String 任务ID。 最小长度：1 最大长度：50 status String 任务状态。 Success：发送成功 Failed：发送失败 说明： 此状态仅代表任务提交状态，不代表智能信息发送结果。用户手机接收智能信息结果请以收到的回执结果为准，也可通过查询智能信息发送明细API获取或登录KooMessage控制台查看。 最小长度：1 最大长度：20 result Array of SmsDetailResponse objects 短信ID列表，当目标号码存在多个时，每个号码都会返回一个SmsID。 当返回异常响应时不携带此字段。 表5 SmsDetailResponse 参数 参数类型 描述 to String 短信接收方的号码。 最小长度：1 最大长度：21 channel_num String 短信发送方的号码。 最小长度：1 最大长度：21 msg_id String 短信的唯一标识。 最小长度：1 最大长度：50 send_status String 短信状态码。 以下举例状态码及其说明，具体处理建议请参考API错误码。 000000：短信平台处理请求成功 E200015：待发送短信数量太大 E200028：模板变量校验失败 E200029：模板类型校验失败 E200030：模板未激活 E200031：协议校验失败 E200033：模板类型不正确 E200041：同一短信内容接收号码重复 最小长度：1 最大长度：7 create_time String 短信资源的创建时间。 即短信平台接收到用户发送短信请求的时间，为UTC时间。 格式为：yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度：1 最大长度：20 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 最小长度：0 最大长度：32 error_msg String 结果详情。 最小长度：0 最大长度：32 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 最小长度：0 最大长度：32 error_msg String 结果详情。 最小长度：0 最大长度：32

请求示例 向不同用户发送不同内容的短信。 https://koomessage.myhuaweicloud.cn/v1/aim/sms/diff-messages { "channel_num" : "882306284****", "task_name" : "多模板API", "sms_content" : [ { "to" : [ "1552785****" ], "template_id" : "151**334", "template_params" : [ "fnafc.cc/kXfvIwzs" ] }, { "to" : [ "1392740****" ], "template_id" : "151**335", "template_params" : [ "(KM:F49C3EGz)" ] } ] }

响应示例 状态码： 200 发送短信响应体。 { "status" : "Success", "result" : [ { "to" : "+86139274****8", "channel_num" : "8823060****9", "msg_id" : "b24f1f03-556e-468e-9fe1-23729b9414d7_72****6", "create_time" : "2023-07-20 09:22:59", "send_status" : "000000" }, { "to" : "+861552785****", "channel_num" : "8823060806439", "msg_id" : "b24f1f03-556e-468e-9fe1-23729b9414d7_****407", "create_time" : "2023-07-20 09:22:59", "send_status" : "000000" } ], "task_id" : "a914ca57-09cf-4899-af62-f9a****06c3c" }

支持的授权项 细粒度策略支持的操作与API相对应，授权项列表说明如下： 权限：自定义策略中授权项定义的内容即为权限。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 授权范围：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM项目和企业项目的区别。 云消息服务管理控制操作相关的授权项，明细如下表所示。用户调用如下API时，需要获取对应的权限。权限获取请参考统一身份认证服务（IAM）的帮助指导。 “√”表示支持，“x”表示暂不支持。 表1 云消息服务权限明细 权限描述 授权项 对应的API IAM项目（Project） 企业项目（Enterprise Project） 查询智能信息模板 kooMessage:devTemplate:list GET /v1/aim/templates √ × 查询智能信息模板报表 kooMessage:devTemplateReport:list POST /v1/aim/tempalte-reports/query √ × 生成智能信息解析任务 kooMessage:devResolveTask:create POST /v1/aim/resolve-tasks √ × 查询智能信息解析任务 kooMessage:devResolveTask:list GET /v1/aim/resolve-tasks √ × 查询手机号码智能信息解析能力 kooMessage:devMobileCapability:check POST /v1/aim/mobile-capabilities/check √ × 发送智能信息 kooMessage:devSendTask:create POST /v1/aim/send-tasks POST /v1/aim/sms/messages POST /v1/aim/sms/diff-messages √ × 查询智能信息发送任务 kooMessage:devSendTask:list GET /v1/aim/send-tasks √ × 查询短信应用 kooMessage:aimMsgApp:list GET /v1/sms/apps GET /v1/sms/apps/{app_id} √ × 创建短信应用 kooMessage:aimMsgApp:create POST /v1/sms/apps √ × 修改短信应用 kooMessage:aimMsgApp:update PUT /v1/sms/apps/{app_id} √ × 查询短信签名 kooMessage:aimMsgSignature:list GET /v1/sms/signatures GET /v1/sms/signatures/{signature_id} GET /v1/sms/signatures/files √ × 创建短信签名 kooMessage:aimMsgSignature:create POST /v1/sms/signatures POST /v1/sms/signatures/files √ × 删除短信签名 kooMessage:aimMsgSignature:delete DELETE /v1/sms/signatures/{signature_id} √ × 修改短信签名 kooMessage:aimMsgSignature:update PUT /v1/sms/signatures/{signature_id} √ × 创建短信模板 kooMessage:aimMsgTemplate:create POST /v1/sms/templates √ × 查询短信模板 kooMessage:aimMsgTemplate:list GET /v1/sms/templates GET /v1/sms/templates/{template_id} √ × 删除短信模板 kooMessage:aimMsgTemplate:delete DELETE /v1/sms/templates/{template_id} √ × 修改短信模板 kooMessage:aimMsgTemplate:update PUT /v1/sms/templates/{template_id} √ × 创建企业基本信息 kooMessage:aimSaCompany:create POST /v1/aim-sa/companies √ × 查询企业基本信息 kooMessage:aimSaCompany:list GET /v1/aim-sa/companies √ × 下载企业资料模板 kooMessage:aimSaCompany:upload GET /v1/aim-sa/companies/download √ × 上传企业资料 kooMessage:aimSaCompany:upload POST /v1/aim-sa/companies/upload √ × 更新企业资料 kooMessage:aimSaCompany:update PUT /v1/aim-sa/companies/{company_id} √ × 上传智能信息服务号的资源 kooMessage:aimSaMedia:upload POST /v1/aim-sa/media/upload √ × 查询智能信息服务号的资源 kooMessage:aimSaMedia:list GET /v1/aim-sa/media/upload √ × 创建智能信息服务号的菜单 kooMessage:aimSaMenu:create POST /v1/aim-sa/menu √ × 更新智能信息服务号的菜单 kooMessage:aimSaMenu:update PUT /v1/aim-sa/menus/{menu_id} √ × 查询智能信息服务号的菜单 kooMessage:aimSaMenu:list GET /v1/aim-sa/menus √ × 创建智能信息服务号的商家 kooMessage:aimSaMerchant:create POST /v1/aim-sa/merchants √ × 更新智能信息服务号的商家 kooMessage:aimSaMerchant:update PUT /v1/aim-sa/merchants/{merchant_id} √ × 查询智能信息服务号的商家 kooMessage:aimSaMerchant:list GET /v1/aim-sa/merchants √ × 创建智能信息服务号的主页 kooMessage:aimSaPortal:create POST /v1/aim-sa/portals √ × 更新智能信息服务号的主页 kooMessage:aimSaPortal:update PUT /v1/aim-sa/portals/{portal_id} √ × 查询智能信息服务号的主页 kooMessage:aimSaPortal:list GET /v1/aim-sa/portals √ × 创建智能信息服务号的端口号 kooMessage:aimSaPort:create POST /v1/aim-sa/ports √ × 查询智能信息服务号的端口号 kooMessage:aimSaPort:list GET /v1/aim-sa/ports √ × 通道号绑定服务号 kooMessage:aimSaPortAssociate:create POST /v1/aim-sa/ports/associate √ × 通道号解绑服务号 kooMessage:aimSaPortAssociate:delete POST /v1/aim-sa/ports/disassociate √ × 删除通道号 kooMessage:aimSaPort:delete DELETE /v1/aim-sa/ports/{port_id} √ × 创建服务号 kooMessage:aimSaPub:create POST /v1/aim-sa/pubs √ × 更新服务号 kooMessage:aimSaPub:update POST /v1/aim-sa/pubs/{pub_id} √ × 冻结服务号 kooMessage:aimSaPub:freeze POST /v1/aim-sa/pubs/{pub_id}/freeze √ × 查询服务号 kooMessage:aimSaPub:list GET /v1/aim-sa/pubs √ × 创建智能信息基础版模板 kooMessage:devAimBasicTemplate:create POST /v1/aim-basic/templates √ × 查询智能信息基础版模板 kooMessage:devAimBasicTemplate:list GET /v1/aim-basic/templates √ × 创建智能信息基础版发送任务 kooMessage:devAimBasicMsgTask:create POST /v1/aim-basic/send-tasks √ × 查询智能信息基础版发送任务 kooMessage:devAimBasicMsgTask:list GET /v1/aim-basic/send-tasks √ ×

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 KM.00001075 短信签名为空 短信签名为空 请检查并在更改错误参数后重试 400 KM.00001076 短信签名的长度范围在1-18个字符之间 短信签名的长度范围在1-18个字符之间 请检查并在更改错误参数后重试 400 KM.00001080 模板ID不存在 模板ID不存在 请检查并在更改错误参数后重试 400 KM.00001081 模板ID为空 模板ID为空 请检查并在更改错误参数后重试 400 KM.00001082 模板ID不存在 模板ID不存在 请检查并在更改错误参数后重试 400 KM.00001083 手机号列表为空 手机号列表为空 请检查并在更改错误参数后重试 400 KM.00001098 短信通道号的字符长度范围必须在1-21之间 短信通道号的字符长度范围必须在1-21之间 请检查并在更改错误参数后重试 400 KM.00001124 短信应用名称不能为空 短信应用名称不能为空 请检查并在更改错误参数后重试 400 KM.00001125 短信应用名称不匹配 短信应用名称不匹配 请检查并在更改错误参数后重试 400 KM.00001126 短信发送通道参数不能为空 短信发送通道参数不能为空 请检查并在更改错误参数后重试 400 KM.00001127 短信签名不能为空 短信签名不能为空 请检查并在更改错误参数后重试 400 KM.00001128 短信签名不匹配 短信签名不匹配 请检查并在更改错误参数后重试 400 KM.00001129 短信模板ID不能为空 短信模板ID不能为空 请检查并在更改错误参数后重试 400 KM.00001134 短信模板ID必须为数字 短信模板ID必须为数字 请检查并在更改错误参数后重试 400 KM.00001135 短信模板不存在 短信模板不存在 请检查并在更改错误参数后重试 400 KM.00001138 该短信模板不属于当前用户，无权限使用该短信模板 该短信模板不属于当前用户，无权限使用该短信模板 请检查并在更改错误参数后重试 400 KM.00001189 signature_id不可为空 signature_id不可为空 请检查参数填写是否正确 400 KM.00001375 短信模板参数校验失败，PHONE类型1-15个字符，CHARDIGIT|DATETIME|MONEY|TEXT类型1-20个字符 短信模板参数校验失败，PHONE类型1-15个字符，CHARDIGIT|DATETIME|MONEY|TEXT类型1-20个字符 请检查并在更改错误参数后重试 400 KM.00001376 短信模板参数和发送输入的参数个数不匹配 短信模板参数和发送输入的参数个数不匹配 请检查参数sms_params，更改后重试 400 KM.00001377 创建的短信模板缺少解析标识类型参数 创建的短信模板缺少解析标识类型参数 请添加解析标识类型参数 400 KM.00001378 短信模板中出现连续参数 短信模板中出现连续参数 短信模板的参数不能连续插入 400 KM.00001402 短信模板参数校验失败，电话类型变量规则不匹配 短信模板参数校验失败，电话类型变量规则不匹配 请参考接口文档修改后重试 400 KM.00001403 短信模板参数校验失败，时间类型变量规则不匹配 短信模板参数校验失败，时间类型变量规则不匹配 请参考接口文档修改后重试 400 KM.00001404 短信模板参数校验失败，其他号码类型变量规则不匹配 短信模板参数校验失败，其他号码类型变量规则不匹配 请参考接口文档修改后重试 400 KM.00001448 短信模板不存在 短信模板不存在 请输入正确的短信模板ID 400 KM.00001452 应用名称重复 应用名称重复 请修改后重试 400 KM.00001453 签名已存在 签名已存在 请修改后重试 400 KM.00001459 应用名称不能超过30个字符 应用名称不能超过30个字符 请修改 400 KM.00001460 上行短信接收地址不能超过255个字符 上行短信接收地址不能超过255个字符 请修改 400 KM.00001461 应用不存在 应用不存在 请检查应用ID 400 KM.00001462 签名长度不能超过30个字符 签名长度不能超过30个字符 请修改 400 KM.00001463 申请说明字段长度不能超过100个字符 申请说明字段长度不能超过100个字符 请修改 400 KM.00001467 APP应用下载地址不能为空 APP应用下载地址不能为空 请输入 400 KM.00001468 电商平台店铺地址不能为空 电商平台店铺地址不能为空 请输入 400 KM.00001469 营业执照不能为空 营业执照不能为空 请上传营业执照 400 KM.00001470 授权委托书不能为空 授权委托书不能为空 请上传授权委托书 400 KM.00001471 签名来源不能为空 签名来源不能为空 请填写签名来源 400 KM.00001472 不支持的签名来源 不支持的签名来源 请修改后重试 400 KM.00001473 签名不存在 签名不存在 请检查签名ID 400 KM.00001475 待激活的签名才可以激活 待激活的签名才可以激活 请检查签名状态 400 KM.00001476 模板名称不能超过30个字符 模板名称不能超过30个字符 请修改模板名称 400 KM.00001477 不支持的模板类型 不支持的模板类型 请修改 400 KM.00001478 模板不存在 模板不存在 请检查模板ID 400 KM.00001482 “是否涉及第三方权益”输入有误 “是否涉及第三方权益”输入有误 请输入yes或no 400 KM.00001483 短信签名审核通过后才可以创建模板 短信签名审核通过后才可以创建模板 请检查签名状态 400 KM.00001484 审核不通过的模板才可以修改 审核不通过的模板才可以修改 请检查模板状态 400 KM.00001485 签名名称长度设置错误 签名名称长度设置错误 请控制签名名称的长度在2-16之间 400 KM.00001486 签名已存在 签名已存在 请更换签名名称或签名类型 400 KM.00001492 接收方号码不能为空 接收方号码不能为空 请输入接收方号码 400 KM.00001493 短链不存在 短链不存在 请检查并更改错误参数后重试 400 KM.00001494 不支持的签名类型 不支持的签名类型 请检查并更改签名类型后重试 400 KM.00001495 应用不存在 应用不存在 请检查应用ID 400 KM.00001496 文件名称不能为空 文件名称不能为空 请修改后重新上传 400 KM.00001497 文件名称不能包含空格 文件名称不能包含空格 请修改后重新上传 400 KM.00001498 文件名称不能包含特殊字符 文件名称不能包含特殊字符 请修改后重新上传 400 KM.00001499 文件名称不能超过64个字符 文件名称不能超过64个字符 请修改后重新上传 400 KM.00001500 接收方号码数超过最大值 接收方号码数超过最大值 请修改后重试 400 KM.00001501 扩展参数超过最大长度限制 扩展参数超过最大长度限制 请修改后重试 400 KM.00001502 接收方号码格式错误 接收方号码格式错误 请修改后重试 400 KM.00001503 短信模板参数校验失败 短信模板参数校验失败 请修改后重试 400 KM.00001504 短信签名校验失败 短信签名校验失败 请修改后重试 400 KM.00001505 短信模板校验失败 短信模板校验失败 请修改后重试 400 KM.00001506 通道号不存在 通道号不存在 请检查通道号输入是否正确 400 KM.00001511 扩展参数校验失败 扩展参数校验失败 请修改后重试 400 KM.00001518 模板名称已被使用 模板名称已被使用 请修改后重试 400 KM.00002024 创建的短信应用已达到上限 创建的短信应用已达到上限 请联系运营技术支持 400 KM.00002194 创建短信模板失败 创建短信模板失败 请检查参数后重试 400 KM.80000001 操作失败 操作失败 请联系技术支持 400 KM.80000002 参数无效 参数无效 请联系技术支持 400 KM.80000003 读取配置失败 读取配置失败 请联系技术支持 400 KM.80020000 未经授权的操作 未经授权的操作 请联系技术支持 400 KM.80020001 操作失败 操作失败 请联系技术支持 400 KM.80020002 查询模板素材失败 查询模板素材失败 请联系技术支持 400 KM.80020003 删除模板素材失败 删除模板素材失败 请联系技术支持 400 KM.80020004 文件类型无效，可接受的格式 文件类型无效，可接受的格式 请联系技术支持 400 KM.80020005 资源类型无效，可接受的格式 资源类型无效，可接受的格式 请联系技术支持 400 KM.80020006 找不到文件 找不到文件 请联系技术支持 400 KM.80020007 文件上传失败 文件上传失败 请联系技术支持 400 KM.80020008 文件下载失败 文件下载失败 请联系技术支持 400 KM.80020009 此素材不是视频素材 此素材不是视频素材 请联系技术支持 400 KM.80020010 读取文件失败 读取文件失败 请联系技术支持 400 KM.80020011 素材ID无效 素材ID无效 请联系技术支持 400 KM.80020012 文件流无效 文件流无效 请联系技术支持 400 KM.80020013 找不到文件URL 找不到文件URL 请联系技术支持 400 KM.80020014 文件名不能超过100个字符 文件名不能超过100个字符 请联系技术支持 400 KM.80020015 图片速率无效 图片速率无效 请联系技术支持 400 KM.80020016 文件描述不能超过50个字符 文件描述不能超过50个字符 请联系技术支持 400 KM.80020017 文件URL不能超过1000个字符 文件URL不能超过1000个字符 请联系技术支持 400 KM.80020018 文件无效，文件URL应以http或https开头 文件无效，文件URL应以http或https开头 请联系技术支持 400 KM.80020019 图片大小不能超过100KB 图片大小不能超过100KB 请联系技术支持 400 KM.80020020 视频大小不能超过10MB 视频大小不能超过10MB 请联系技术支持 400 KM.80020021 图片格式应为png、jpg、jpeg其中之一 图片格式应为png、jpg、jpeg其中之一 请联系技术支持 400 KM.80020022 视频格式应为mp4 视频格式应为mp4 请联系技术支持 400 KM.80020023 素材ID长度不能超过36个字符 素材ID长度不能超过36个字符 请联系技术支持 400 KM.80020025 创建封面素材失败 创建封面素材失败 请联系技术支持 400 KM.80030000 未经授权的操作 未经授权的操作 请联系技术支持 400 KM.80030001 操作失败 操作失败 请联系技术支持 400 KM.80030010 查询智能信息模板失败 查询智能信息模板失败 请联系技术支持 400 KM.80030020 由于类型是其中之一[文本，按钮]，页面内容无效 由于类型是其中之一[文本，按钮]，页面内容无效 请联系技术支持 400 KM.80030021 由于类型是其中之一[文本，按钮]，页面内容无效 由于类型是其中之一[文本，按钮]，页面内容无效 请联系技术支持 400 KM.80030022 找不到智能信息模板 找不到智能信息模板 请联系技术支持 400 KM.80030023 请求无效 请求无效 请联系技术支持 400 KM.80040001 操作失败 操作失败 请联系技术支持 400 KM.80040002 解析响应失败 解析响应失败 请联系技术支持 400 KM.80040003 上传素材失败 上传素材失败 请联系技术支持 400 KM.80040004 创建智能信息模板失败 创建智能信息模板失败 请联系技术支持 400 KM.80040005 更新智能信息模板失败 更新智能信息模板失败 请联系技术支持 400 KM.80040006 删除智能信息模板失败 删除智能信息模板失败 请联系技术支持 400 KM.80040007 创建智能信息模板失败，无法识别的JSON 创建智能信息模板失败，无法识别的JSON 请联系技术支持 400 KM.80050001 操作失败 操作失败 请联系技术支持 400 KM.80050002 文件未上传 文件未上传 请联系技术支持 400 KM.80050003 文件下载失败 文件下载失败 请联系技术支持 400 KM.80050004 文件删除失败 文件删除失败 请联系技术支持 400 KM.80050005 无法生成链接 无法生成链接 请联系技术支持 400 KM.90022042 回调地址连通性测试失败 回调地址连通性测试失败 检查上报URL是否已发布，或重试 400 KM.00000400 参数校验失败 参数校验失败 请参考返回的Error Message检查请求参数并修改 400 KM.90014016 更新模板状态失败 更新模板状态失败 请参考返回的Error Message检查请求参数并修改 400 KM.90014017 查询模板列表失败 查询模板列表失败 请参考返回的Error Message检查请求参数并修改 400 KM.90014020 查询模板审核状态失败 查询模板审核状态失败 请参考返回的Error Message检查请求参数并修改 400 KM.90014023 智能短信模板素材上传失败 智能短信模板素材上传失败 请参考返回的Error Message检查请求参数并修改 400 KM.90014105 无法下载资源文件 无法下载资源文件 请参考返回的Error Message，或者请联系技术支持 400 KM.90014106 文件名称过长，请修改后重新上传 文件名称过长，请修改后重新上传 请修改文件名称长度 400 KM.90014107 上传素材失败，非法的文件类型 上传素材失败，非法的文件类型 请修改文件类型 400 KM.90014108 上传素材失败，文件大小超出限制 上传素材失败，文件大小超出限制 请修改文件大小 400 KM.90015015 认证失败，用户所属企业为空 认证失败，用户所属企业为空 请完善用户企业信息 400 KM.90016009 上传素材失败 上传素材失败 请参考返回的Error Message检查素材类型及大小 400 KM.90016101 模板审核中，删除模板失败 模板审核中，删除模板失败 请等待模板审核后再删除 400 KM.90016102 企业用户无法删除公共模板，删除模板失败 企业用户无法删除公共模板，删除模板失败 请勿删除公共模板 400 KM.90016103 删除模板失败 删除模板失败 请检查模板类型是否为非审核状态下的个人模板 400 KM.90016104 模板已删除，无法再次删除，删除模板失败 模板已删除，无法再次删除，删除模板失败 请检查模板是否已删除 400 KM.90016105 模板不存在，删除模板失败 模板不存在，删除模板失败 请检查请求模板信息是否有误 400 KM.90016106 启用/禁用模板失败，未提交或审核中的模板不可修改状态 启用/禁用模板失败，未提交或审核中的模板不可修改状态 请提交并审核通过之后修改模板 400 KM.90016107 企业用户无法修改公共模板状态 企业用户无法修改公共模板状态 请勿修改公共模板状态 400 KM.90016108 设置模板状态异常 设置模板状态异常 请参考返回的Error Message，或者请联系技术支持 400 KM.90016112 禁用原因不能为空 禁用原因不能为空 请填写禁用原因 400 KM.90016113 启用/禁用的模板不存在 启用/禁用的模板不存在 请启用/禁用存在的模板 400 KM.90016209 查询模板列表失败 查询模板列表失败 请参考返回的Error Message，或者请联系技术支持 400 KM.90016301 手机号码数超过最大值 手机号码数超过最大值 请修改单次请求手机号码数量并分批次请求 400 KM.90016403 请求短链数量超过限制 请求短链数量超过限制 请修改单次短链请求数量并分批次请求 400 KM.90016405 模板不存在，不能生成短链 模板不存在，不能生成短链 请选择存在的模板 400 KM.90016406 模板未生效，生成短链失败 模板未生效，生成短链失败 请选择已生效的模板 400 KM.90016407 生成短链失败 生成短链失败 请参考返回的Error Message，或者请联系技术支持 400 KM.90016408 非法模板，不能生成短链 非法模板，不能生成短链 请选择合法模板 400 KM.90016410 当前timestamp已过期 当前timestamp已过期 请检查timestamp并修改 400 KM.90016411 当前账号已被禁用 当前账号已被禁用 请参考返回的Error Message，或者请联系技术支持 400 KM.90016412 当前账号已失效 当前账号已失效 请参考返回的Error Message，或者请联系技术支持 400 KM.90016413 扣费失败 扣费失败 请参考返回的Error Message，或者请联系技术支持 400 KM.90016414 入参为空 入参为空 请传入参数 400 KM.90016415 参数对象集合为空 参数对象集合为空 请设置非空参数集合 400 KM.90016416 请求短码数量超过限制 请求短码数量超过限制 请修改单次短码请求数量并分批次请求 400 KM.90016417 签名个数不合法 签名个数不合法 请填写合法签名个数 400 KM.90016418 智能短信编码类型不合法 智能短信编码类型不合法 请检查短信编码类型并修改 400 KM.90016419 展示次数不合法 展示次数不合法 请检查展示次数并修改 400 KM.90016420 签名长度不合法 签名长度不合法 请检查签名长度并修改 400 KM.90016421 客户标志不合法 客户标志不合法 请检查客户标志并修改 400 KM.90016422 自定义消息ID过长 自定义消息ID过长 请检查自定义消息ID并修改 400 KM.90016423 自定义跳转链接过长 自定义跳转链接过长 请检查自定义跳转链接长度并修改 400 KM.90016424 自定义参数过长 自定义参数过长 请修改自定义参数长度 400 KM.90016425 变参个数不合法 变参个数不合法 请检查变参个数并修改 400 KM.90016426 变参名或变参序号不合法 变参名或变参序号不合法 请参考返回的Error Message，或者请联系技术支持 400 KM.90016427 非法企业模板，无法生成短链 非法企业模板，无法生成短链 请选择合法企业模板 400 KM.90016428 非法代理商模板，无法生成短链 非法代理商模板，无法生成短链 请选择合法代理商模板 400 KM.90016435 批量查询账号余额的个数不符 批量查询账号余额的个数不符 请参考返回的Error Message，或者请联系技术支持 400 KM.90016436 产品类型非法 产品类型非法 请填写合法产品类型 400 KM.90016437 查询余额失败 查询余额失败 请参考返回的Error Message，或者请联系技术支持 400 KM.90016439 查询的发送账号所属公司不符 查询的发送账号所属公司不符 请检查发送账号所属公司 400 KM.90016440 失效时间不合法 失效时间不合法 请修改失效时间 400 KM.90016441 发送账号不存在 发送账号不存在 请联系技术支持 400 KM.90016442 OPPO每次申请短链不能超过10个 OPPO每次申请短链不能超过10个 请减少申请短链数在10个以内 400 KM.90016455 查询开始时间或结束时间参数为空 查询开始时间或结束时间参数为空 请同时传入开始时间和结束时间 400 KM.90016456 分页信息为空 分页信息为空 请添加分页信息 400 KM.90016457 分页信息不合法 分页信息不合法 请修改分页信息 400 KM.90016458 查询开始时间或结束时间参数不合法 查询开始时间或结束时间参数不合法 请检查时间格式是否与接口要求一致 400 KM.90016459 查询开始时间和结束时间间隔过大 查询开始时间和结束时间间隔过大 请缩短查询时间段 400 KM.90016462 参数内容包含敏感词 参数内容包含敏感词 请检查参数内容中是否包含敏感词 400 KM.90016463 OPPO模板一次只允许申请一个群发短链 OPPO模板一次只允许申请一个群发短链 请更换为非OPPO模板或单次只申请一个群发短链 400 KM.90016464 模板不属于该企业 模板不属于该企业 请检查模板是否属于该企业 400 KM.90016482 存在重复的自定义短链 存在重复的自定义短链 请检查自定义短链是否重复，修改后重试 400 KM.90016801 包含敏感词 包含敏感词 请检查请求参数中的敏感词，删除敏感词并重试 400 KM.90016802 卡片动参数据与协议动参数据不一致 卡片动参数据与协议动参数据不一致 请修改卡片动参与协议动参一致 400 KM.90016803 请求参数错误 请求参数错误 请参考返回的Error Message检查请求参数并修改 400 KM.90016804 提交模板失败 提交模板失败 请参考返回的Error Message检查请求参数并修改 400 KM.90016805 模板协议错误，请检查协议格式 模板协议错误，请检查协议格式 请检查协议格式并修改 400 KM.90018111 资源文本中存在http链接，无法转换 资源文本中存在http链接，无法转换 请去除资源文本中的http链接 400 KM.90019000 请求参数不合法 请求参数不合法 请参考返回的Error Message检查请求参数 400 KM.90019001 鉴权失败 鉴权失败 请前往控制台完成账号授权 400 KM.90020000 未识别错误码 未识别错误码 请联系技术支持 400 KM.90022015 待发送短信数量太大 待发送短信数量太大 请修改单词发送数量并分批次发送 400 KM.90022028 模板变量校验失败 模板变量校验失败 请修改模板变量 400 KM.90022029 模板类型校验失败 模板类型校验失败 请修改模板类型 400 KM.90022030 模板未激活 模板未激活 请激活模板 400 KM.90022031 协议校验失败 协议校验失败 请检查协议并修改 400 KM.90022033 模板类型不正确 模板类型不正确 请检查模板类型并修改 400 KM.90022041 同一短信内容接收号码重复 同一短信内容接收号码重复 请去除重复接收号码 400 KM.90022042 回调地址为空 回调地址为空 检查是否存上报回调地址 403 KM.00000403 鉴权失败 鉴权失败 前往控制台完成账号授权 403 KM.90019004 API Token校验失败 API Token校验失败 重新获取Token 500 KM.00000001 内部错误 内部错误 请联系技术支持 500 KM.90010000 未识别错误码 未识别错误码 请联系技术支持 500 KM.90011001 请求外部系统获取解析短链失败 请求外部系统获取解析短链失败 请联系技术支持 500 KM.90019003 服务异常 服务异常 请联系技术支持 父主题： 附录

为什么带宽使用率指标会超过100% 带宽使用率基本信息如下: 指标ID 指标名称 含义 取值范围 测量对象&维度 监控周期（原始指标） bandwidth_usage 带宽使用率 当前流量带宽与最大带宽限制的百分比 0-200% 测量对象： Redis 4.0及以上版本 主备、读写分离、集群实例数据节点 测量维度： dcs_cluster_node 1分钟 其中，带宽使用率的计算公式为：带宽使用率=（网络瞬时输入流量+网络瞬时输出流量）/（2*最大带宽限制）* 100%。 该公式中同时计算了网络瞬时输入流量和网络瞬时输出流量，这两个指标值是有统计主从同步的流量的。所以统计的总流量使用量会比正常的业务流量大一些，会发生带宽使用率指标超过100%的情况。 判断当前是否被限流，请使用流控次数这个指标，这个指标值大于0时，表示当前已使用的带宽超过最大带宽限制，产生流控。 限流时，流控次数指标是不统计主从同步流量的，所以有时候会出现带宽使用率指标超过100%，但流控次数为0的情况。 父主题： 监控告警

Redis的安全加固方面有哪些建议？ 在众多开源缓存技术中，Redis无疑是目前功能最为强大，应用最多的缓存技术之一，但是原生Redis版本在安全方面非常薄弱，很多地方不满足安全要求，如果暴露在公网上，极易受到恶意攻击，导致数据泄露和丢失。 针对DCS的Redis实例，您在使用过程中，可参考如下建议： 网络连接配置 敏感数据加密后存储在Redis实例，且实例不开启公网访问。 对于敏感数据，尽量加密后存储。如无特殊需要，尽量不使用公网访问。 对安全组设置有限的、必须的允许访问规则。 安全组与VPC均是用于网络安全访问控制的配置，以端口最少放开原则配置安全组规则，降低网络入侵风险。 客户端应用所在ECS设置防火墙。 客户端应用所在的服务器建议配置防火墙过滤规则。 设置实例访问密码。 配置实例白名单。 Redis-cli使用 隐藏密码 安全问题：通过在redis-cli指定-a参数，密码会被ps出来，属于敏感信息。 解决方案：修改Redis源码，在main方法进入后，立即隐藏掉密码，避免被ps出来。 禁用脚本通过sudo方式执行 安全问题： redis-cli访问参数带密码敏感信息，会被ps出来，也容易被系统记录操作日志。 解决方案：改为通过API方式（Python可以使用redis-py）来安全访问，禁止通过sudo方式切换到dbuser账号使用redis-cli。 父主题： 安全性

配置自定义公有依赖仓库 在Maven构建步骤中，展开“setting配置”。 添加公有依赖仓库，输入仓库地址，根据需要勾选“release仓库”和“snapshot仓库”。 release仓库：勾选后，构建过程将尝试从仓库中下载release版本依赖。 snapshot仓库：勾选后，构建过程将尝试从仓库中下载snapshot版本依赖。 release仓库和snapshot仓库至少勾选一个，也可以同时勾选。

配置说明 如果用户需要使用非软件开发生产线提供的依赖仓库进行构建，可通过本页指导配置依赖仓库。为区分不同仓库，Maven构建将仓库按其来源、网络、权限等特征分为公有依赖仓库和私有依赖仓库。 公有依赖仓库 开源镜像站：编译构建服务默认配置，无需任何修改即可在构建任务中使用。 自定义公有依赖仓库：非软件开发生产线提供的公有依赖仓库（公开访问的），需在构建步骤“Maven构建”中配置自定义公有依赖仓库才能使用。 私有依赖仓库 私有依赖库：用户开通后，编译构建服务默认配置，无需任何修改即可在构建任务中使用。 自定义私有依赖仓库：非软件开发生产线提供的私有依赖仓库（企业私有，访问需要授权账号认证），需在构建步骤“Maven构建”中配置自定义私有依赖仓库才能使用。

操作步骤 新建构建任务时，在“源码源”处选择“通用Git”。首次使用通用Git连接，需要新建扩展点实例。 单击“扩展点实例”右侧的“新建”。 弹出“新建服务扩展点”对话框，请填写相应参数。 表1 参数说明 参数名称 功能描述 连接名称 服务扩展点的名称。 Git仓库Url Git仓库的Url（https协议地址）。 用户名 Git仓库用户名。 密码或Access Token Git仓库密码或Access Token。 参数设置完成后，单击“确定”，完成后续任务配置即可。

处理方法 进入编译构建服务首页。 选择对应的构建任务，单击任务所在行的，单击“编辑”。 在“构建步骤”页面编辑“NPM构建”。 在NPM构建步骤里，添加如下命令，修改Npm镜像仓地址： 1 npm config set registry https://repo.xxcloud.com/repository/npm/ 或 npm config set registry https://registry.npm.taobao.org 单击“保存并执行”，重新执行构建任务。

处理方法 进入编译构建服务首页。 选择对应的构建任务，单击任务所在行的，单击“编辑”。 在“构建步骤”页面编辑“制作镜像并推送到SWR仓库”。 单击“管理IAM账号”。 单击“新建扩展服务点”，选择“IAM账户”。 在弹出的窗口中填写参数信息。 Access Key Id和Secret Access Key获取方式如下： 单击页面左上角“控制台”。 单击页面右上角账号名称，选择“我的凭证”。 单击“访问密钥”。 单击“新增访问密钥”，填写相关描述，单击“确定”。 在弹出的窗口中单击“立即下载”，可将密钥信息下载到本地。 步骤4中的IAM账号选择步骤6中新建的服务扩展点。

购买服务 进入购买编译构建服务页面。 确认服务规格信息，单击“免费开通”。 表1 资源规格 资源项 资源规格 构建时长（分钟/月） 1800分钟/月。 构建并发（个） 1个内置执行机（2U8G）和1个自定义执行机并发。 确认套餐包配置信息，勾选“我已经阅读并同意”协议，单击页面右下角“立即开通”，即可下单成功。 表2 套餐包配置 配置项 配置详情 计费模式 包年/包月。 区域 选择需要使用的区域。不同区域购买的资源不能跨区使用，需慎重选择。 产品 选择“Build专业版”。 产品描述 免费使用构建时长1800分钟/月，单租户1个内置执行机(2U8G)并发和1个自定义执行机并发，使用限制性资源池，超过并发数时构建任务会进行排队。用户可额外购买构建加速包提升效率和购买构建并发包扩容。 购买时长 选择“1个月”。 自动续费 勾选后将开启自动续费。自动续费规则请参考自动续费规则说明。 下单成功即服务开通成功。

购买须知 在CodeArts支持的区域内，各区域独立开通购买、独立计费。 您可以购买CodeArts Build套餐，或者开通/购买软件开发生产线服务组合套餐，体验一站式、全流程、安全可信的软件开发生产线。 购买编译构建服务需要您拥有租户账号，或拥有Tenant Administrator权限的IAM用户账号，配置权限策略方法请参考创建用户组并授权。 若已经购买了CodeArts套餐，则无需再单独购买CodeArts Build套餐。

规则说明 2020年10月16日前，未在CodeArts某个区域下产生过费用的用户，按照新版计费规则，需在该区域开通/购买CodeArts或单独购买CodeArts Build套餐后使用。 在该区域内产生过费用的用户，延续旧版计费规则，可参考购买服务在该区域开通编译构建服务包年/包月套餐。 例如： 用户于2020年3月在“华北-北京四”购买了半年期的包月套餐。由于疫情影响业务，套餐到期后关闭了CodeArts服务；2020年10月20日将重新启用CodeArts。 若用户仍使用“华北-北京四”，可以购买旧版套餐使用。 若用户使用其它区域，则需购买CodeArts或者编译构建服务新版计费。 更多计费详情，请参考计费说明。

到期后影响 图1描述了包年/包月CodeArts Build套餐各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图1 包年/包月CodeArts Build套餐生命周期 到期预警 包年/包月CodeArts Build套餐在到期前第15天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年/包月CodeArts Build套餐到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常使用编译构建服务。 如果您在宽限期内仍未续费包年/包月CodeArts Build套餐，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，若包年/包月CodeArts Build套餐仍未续费，那么将无法继续使用编译构建服务。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，如电商促销季、节假日等，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。