云服务器内容精选

华为云首页用户手册

消息

消息&短信 MSGSMS-修改短信模板:请求示例

请求示例修改短信模板，请求方式：PUT ，请求URL：/v2/{project_id}/msgsms/templates/{id}，路径参数：id，project_id，请求头参数：X-Auth-Token，Content-Type，请求体：app_id，region，template_content，template_name，template_type。 PUT /v2/845ada5bc7444f1295cd517af0123da1/msgsms/templates/c3f641aa-4e87-4a70-b84d-a2d685599072 HTTP/1.1 Host: 100.85.***.***:30300 Content-Type: application/json X-Auth-Token: *** Content-Length: 311 { "app_id": "******9c-1a6b-4ee5-9651-5bca450694b3", "brackets": "GB", "region": "cn", "sign_id": "******58-e866-4b30-9ca5-a476a00e8775", "template_content": "测试", "template_name": "auto_test000", "template_type": "NOTIFY_TYPE", "universal_template": 0 }

消息&短信 MSGSMS 短信模板
消息&短信 MSGSMS-修改短信模板:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 Content-Type 是 String 请求体参数类型，该字段必须设置为：application/json X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）表3 请求Body参数参数是否必选参数类型描述 app_id 是 String 应用主键ID，参考表5 响应SmsAppQueryResp参数中的ID brackets 否 String 中括号类型。支持枚举值： CN：中文类型：【】 GB：英文类型： [] 须知：默认值为：CN 输入值不在上述枚举值范围内的，也按CN处理。只有地域为国内时，该字段有效。 region 是 String 地域 cn：国内 intl：国际 send_country 否 Array of Integers 发送国家ID列表，只有地域为国际时，该字段有效 sign_id 否 String 签名ID，对应表5 响应SmsSignatureResp参数中的ID。只有地域为国内时，该字段有效 template_content 是 String 模板内容 template_desc 否 String 模板描述 template_name 是 String 模板名称 template_type 是 String 模板类型。只有地域为国内时，该字段有效。支持枚举值： VERIFY_CODE_TYPE：验证码类 PROMOTION_TYPE：推广类 NOTIFY_TYPE：通知类 universal_template 否 Integer 是否为通用模板 0：非通用模板 1：通用模板 variable_attributes 否 Array of SmsTemplateVariableAttrReq objects 模板参数 flow_status 否 String 流程状态 Pending：待提交 Reviewing：待审核表4 SmsTemplateVariableAttrReq 参数是否必选参数类型描述 variable_desc 否 String 变量说明，当变量类型为TEXT时，必填 variable_index 是 Integer 变量索引，对应模板内容变量索引 variable_type 是 String 变量类型，目前支持：PHONE|CHARDIGIT|DATETIME|MONEY|TEXT|NEWTEXT

消息&短信 MSGSMS 短信模板
消息&短信 MSGSMS-接收上行短信:请求示例

请求示例 POST /smsRecive HTTP/1.1 Host: 205.145.111.168:9330 Content-Type: application/x-www-form-urlencoded Connection: close Pooltype: approxy Ompsid: 56514cc1880e40638f16c7c674265658 TerminalIP: 205.141.112.17 TrcModule: AP UserTrace: application TraceHandle: DMZ_818405 from=%2B86155****5172&to=201804131431201234&body=********&smsMsgId=9692b5be-c427-4525-8e73-cf4a6ac5b3f7

消息&短信 MSGSMS
消息&短信 MSGSMS-接收上行短信:接口类型

接口类型表1 接口类型说明请求方法 POST 访问URI 用户接收上行短信的地址。通信协议 HTTPS/HTTP 回调接口使用HTTPS协议时，服务端需支持TLS1.2，加密套件需支持TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384，TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384中的一种或多种。

消息&短信 MSGSMS
消息&短信 MSGSMS-接收上行短信:请求参数

请求参数表2 请求Headers参数参数名称是否必选参数类型默认值说明 Content-Type 是 String 无固定填application/x-www-form-urlencoded。表3 请求Body参数说明参数名称是否必选参数类型默认值说明 smsMsgId 是 String(1-50) 无上行短信的唯一标识。 from 是 String(1-21) 无上行短信发送方的号码。 to 是 String(1-21) 无上行短信接收方的号码。 body 是 String(1-160) 无上行短信发送的内容。 createTime 否 String(1-20) 无上行短信创建时间，即短信平台接收到用户发送的上行短信的时间（采用标准UTC格式，例如：2018-02-12T15:30:20Z。不同编程语言中的时间格式转换方式不同，部分语言可参考表不同编程语言的时间格式）。在控制台创建应用时，配置需要“接收上行短信回复时间”后（缓存原因，配置后需等待5分钟左右生效），平台才会在Body中附带此字段，该字段只对http协议的短信生效。

消息&短信 MSGSMS
消息&短信 MSGSMS-修订记录

修订记录发布日期修改记录 2024-11-15 第二十次正式发布。本次变更如下：状态回执错误码章节新增GB:0014、S:43、908、SVC6001、SVC4001错误码。 2024-11-06 第十九次正式发布。本次变更如下：修改短信模板接口优化功能描述，并新增“flow_status”字段，表示流程状态。 API错误码（应用、签名、模板）章节新增MSG SMS .0186、MSGSMS.0187、MSGSMS.0188错误码。 2024-10-24 第十八次正式发布。本次变更如下：新增批量删除短信模板接口。查询签名信息接口中请求参数“status”新增枚举值、新增“qualification_id”、“qualification_name”字段，表示资质ID和资质名。创建短信签名/修改短信签名接口新增“qualification_id”字段，表示资质ID。获取签名详情接口新增“qualification_id”、“qualification_name”字段，表示资质ID和资质名。 2024-08-23 第十七次正式发布。本次变更如下：下线批量删除短信模板接口。发送短信/发送分批短信章节新增E000630错误码。状态回执错误码（国内短信）章节新增E000632错误码。 2024-08-02 第十六次正式发布。本次变更如下：新增批量删除短信模板接口。接收状态报告/批量接收状态报告接口新增请求参数statusDesc，表示错误码描述。发送短信/发送分批短信/API错误码（发送短信）章节新增E000041、E000042、E000043、E000044、E000045错误码。 2024-07-15 第十五次正式发布。本次变更如下： “API错误码（发送短信）”章节新增E000630错误码。 2024-07-03 第十四次正式发布。本次变更如下：下线“策略和授权项说明”章节内容。 2024-05-16 第十三次正式发布。本次变更如下：状态回执错误码（国内短信）新增E200047错误码。 2024-01-26 第十二次正式发布。本次变更如下：状态回执错误码（国内短信）新增UT:0023错误码。 2022-10-28 第十一次正式发布。本次变更如下： API文档结构优化，新增“使用前必读”、“API概况”、“如何调用API”与“附录”等章节。 2022-7-21 第十次正式发布。本次变更如下：新增短信应用、模板和签名接口。 2019-10-16 第九次正式发布。本次变更如下：发送短信/发送分批短信：响应参数status新增取值E200041。接收状态报告：请求参数status和orgCode状态码归一。具体变更如下：请求参数status删除取值RTE_ERR。请求参数orgCode取值合入status。其中，请求参数status新增取值E200018-E200027、E200032、E200034-E200036、E200038，删除原orgCode参数取值E200040、E200041、E200042、E200045。 2019-09-05 第八次正式发布。本次变更如下：接收状态报告接口：请求参数status新增取值SC:0016-SC:0018。 2019-06-30 第七次正式发布。本次变更如下：发送短信/发送分批短信接口：结果码E200037变更为E000510。接收状态报告接口：请求参数status新增取值SC:0013-SC:0015。 2019-03-30 第六次正式发布。本次变更如下：接收状态报告接口：请求参数source新增取值3。请求参数status新增取值SC:0001-SC:0012。 2019-01-18 第五次正式发布。本次变更如下：接收状态报告接口：请求参数orgCode新增取值E200040、E200041、E200042、E200045。 2018-12-24 第四次正式发布。本次变更如下：发送短信/发送分批短信接口：新增请求参数signature，对应通用模板功能。 2018-09-30 第三次正式发布。本次变更如下：发送短信/发送分批短信接口：新增结果码E200037。接收状态报告接口：请求参数orgCode新增取值E200038。 2018-08-17 第二次正式发布。本次变更如下：发送短信/发送分批短信接口：新增请求参数extend。响应参数status新增取值E200031。新增结果码E000027。接收状态报告接口：新增请求参数extend、to。请求参数orgCode新增取值E200034、E200035、E200036。 2018-01-01 第一次正式发布。

消息&短信 MSGSMS
消息&短信 MSGSMS-接收状态报告:请求示例

请求示例 POST /report HTTP/1.1 Host: 205.145.111.168:9330 Content-Type: application/x-www-form-urlencoded Connection: close Pooltype: approxy Ompsid: 7f540777fe4b40dfb3c21d10f48781e3 TerminalIP: ****** TrcModule: AP UserTrace: application TraceHandle: DMZ_818405 sequence=1&total=1&orgCode=000&updateTime=2018-04-13T06%3A31%3A46Z&source=2&smsMsgId=b9d9b4fe-ad0e-4a2a-a2c7-445505b674ac_6&status=DELIVRD

消息&短信 MSGSMS
消息&短信 MSGSMS-接收状态报告:请求参数

请求参数表2 请求Headers参数参数名称是否必选参数类型默认值说明 Content-Type 是 String 无固定填application/x-www-form-urlencoded。表3 请求Body参数说明参数名称是否必选参数类型默认值说明 smsMsgId 是 String(1-50) 无发送短信成功时返回的短信唯一标识。 total 否 String(1-2) 无长短信拆分后的短信条数。当短信未拆分时该参数取值为1。 sequence 否 String(1-2) 无长短信拆分后的短信序号，当total参数取值大于1时，该参数才有效。当短信未拆分时该参数取值为1。 status 是 String(1-7) 无短信状态报告枚举值，常见取值请参考表 Status常见取值，处理方法请参考状态报告错误码。 statusDesc 否 String(1-500) 无错误码描述，常见取值请参考表 Status常见取值。 source 否 String(枚举) 无短信状态报告来源： 1：短信平台自行产生的状态报告。 2：短信中心返回的状态报告。 3：华为平台产生的状态报告。 updateTime 否 String(1-20) 无短信资源的更新时间，通常为短信平台接收短信状态报告的时间，为UTC时间，格式为：yyyy-MM-dd'T'HH:mm:ss'Z'，该时间会通过urlencode转义为%3a。当短信平台未收到短信中心上报的状态报告时，会自行构造状态报告，该状态报告中不携带“updateTime”参数。 extend 否 String(1-128) 无扩展字段，由用户在发送短信的请求中携带。若用户发送短信时未携带extend参数，则状态报告中也不会携带extend参数。 to 否 String(1-21) 无本条状态报告对应的短信的接收方号码，仅当状态报告中携带了extend参数时才会同时携带该参数。表4 Status常见取值取值含义 DELIVRD 用户已成功收到短信。 EXPIRED 短信已超时。 DELETED 短信已删除。 UNDELIV 短信递送失败。 ACCEPTD 短信已接收。 UNKNOWN 短信状态未知。 REJECTD 短信被拒绝。 E200018 国内短信发送方通道校验失败。 E200019 国内短信发送方匹配通道失败。 E200020 国内短信签名通道校验失败。 E200021 国内短信签名匹配通道失败。 E200022 国内短信接收方通道校验失败。 E200023 国内短信接收方匹配通道失败。 E200025 国际短信接收方通道校验失败。 E200026 国际短信接收方匹配通道失败。 E200027 匹配网关失败。 E200032 短信需要模板。 E200034 短信重传超时。 E200035 短信协议字段替换失败。 E200036 南向速率管控配置为0。 E200038 接收长短信超时。 MILIMIT 号码达到分钟下发限制。 LIMIT 号码达到下发限制。 BEYONDN KEYWORD 短信关键字拦截。 BLACK 号码黑名单。 MBBLACK DJ:0255 运营商拦截，一般是因为短信内容不允许发送。 1 此类错误码多为手机号码问题，如手机为空号，关机，停机等。 24 MK:xxxx MN:xxxx LT:0001 MA:xxxx SMSC未返回响应消息。 MB:xxxx SMSC返回错误响应消息。 MC:xxxx 未从SMSC处接收到状态报告。 CA:xxxx SCP未返回响应消息。 CB:xxxx SCP返回错误响应消息。 DA:xxxx DSMP未返回响应消息。 DB:xxxx DSMP返回错误响应消息。 SA:xxxx SP未返回响应消息。 SB:xxxx SP返回错误响应消息。 IA:xxxx 下一级ISMG未返回响应消息。 IB:xxxx 下一级ISMG返回错误响应消息。 IC:xxxx 没有从下一级ISMG处接收到状态报告。 SC:0001 人工审核拦截 SC:0002 人工审核告警拦截 SC:0003 黑名单拦截 SC:0004 红名单拦截 SC:0005 投诉黑名单 SC:0006 禁用关键字拦截 SC:0007 特征关键字拦截 SC:0008 管控关键字拦截 SC:0009 缺失必备关键字 SC:0010 短信超频拦截 SC:0011 时段管控拦截 SC:0012 人工审核超时处理 SC:0013 签名黑名单拦截 SC:0014 免审核模板匹配 SC:0015 拦截模板匹配 SC:0016 退订黑名单拦截 SC:0017 非报备模板拦截 SC:0018 非报备签名拦截

消息&短信 MSGSMS
消息&短信 MSGSMS-接收状态报告:接口类型

接口类型表1 接口类型说明请求方法 POST 访问URI “发送短信”、“发送分批短信”接口中指定的用户回调地址。通信协议 HTTPS/HTTP 回调接口使用HTTPS协议时，服务端需支持TLS1.2，加密套件需支持TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384，TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384中的一种或多种。

消息&短信 MSGSMS
消息&短信 MSGSMS-批量接收状态报告:注意事项

注意事项短信发送成功后，平台收到状态报告，会实时推送状态报告给用户，最迟不超过72小时。平台推送汇聚后的状态报告，状态报告存在一定时延。短信平台批量推送状态报告，单次最多推送50条。若“statusCallback”字段已设置，则优先使用该字段的取值作为短信状态报告的回调地址。若“statusCallback”字段未设置，则使用应用中配置的批量接收状态报告地址。若“statusCallback”字段未设置且未在应用端配置批量接收状态报告地址，则用户无法接收短信平台主动发送的状态报告。

消息&短信 MSGSMS 发送接收短信
消息&短信 MSGSMS-批量接收状态报告:请求示例

请求示例 POST /batchReport HTTP/1.1 Host: 205.145.111.168:9330 Content-Type: application/JSON;charset=UTF-8 Connection: close Pooltype: approxy Ompsid: 7f540777fe4b40dfb3c21d10f48781e3 TerminalIP: ****** TrcModule: AP UserTrace: application TraceHandle: DMZ_818405 {"statusReportList":[{"sequence":"1","total":"1","updateTime":"2023-04-18T07:26:00Z","source":"2","smsMsgId":"f6dcba15-ced9-45f7-9f5e-af82328c5253_1188602","status":"DELIVRD"},{"sequence":"1","total":"1","updateTime":"2023-04-18T07:26:00Z","source":"2","smsMsgId":"f6dcba15-ced9-45f7-9f5e-af82328c5253_123456","status":"DELIVRD"}]}

消息&短信 MSGSMS 发送接收短信
消息&短信 MSGSMS-批量接收状态报告:接口类型

接口类型表1 接口类型说明请求方法 POST 访问URI 用户在应用中配置的批量接收状态报告地址。通信协议 HTTPS/HTTP 回调接口使用HTTPS协议时，服务端需支持TLS1.2，加密套件需支持 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384，TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384中的一种或多种。

消息&短信 MSGSMS 发送接收短信
分布式消息服务ROCKETMQ版-购买RocketMQ实例:自定义购买RocketMQ实例

自定义购买RocketMQ实例进入购买RocketMQ实例页面。在“自定义购买”页签中，设置实例基础配置。表8 实例基础配置参数说明参数名称说明计费模式 RocketMQ实例的计费模式。取值范围：包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。按需付费：一种后付费模式，即先使用再付费，按照RocketMQ实例实际使用时长计费，秒级计费，按小时结算。区域不同区域的云服务产品之间内网互不相通。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。可用区可用区指在同一区域下，电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。请根据实际情况选择可用区。RocketMQ实例创建成功后，不支持修改可用区。设置实例规格信息。表9 实例规格参数说明参数名称说明规格选择模式取值仅包含“默认”。版本 RocketMQ的版本号。取值包含“5.x”和“4.8.0”。 RocketMQ实例创建成功后，不支持修改版本号。实例类型 RocketMQ实例的类型。 5.x版本取值包含“基础版”和“专业版”，4.8.0版本取值固定为“默认”。说明：专业版目前还处于公测阶段。部署架构根据需求选择“单机”或“集群”。4.8.0版本仅支持“集群”。代理/实例规格请根据业务需求选择相应的代理/实例规格。 5.x版本时，该参数显示为“实例规格”。 4.8.0版本时，该参数显示为“代理规格”。请根据实际情况选择。代理数量选择代理数量。 4.8.0版本时才显示该参数。单个代理存储空间/存储空间存储空间用于存储消息（包括副本中的消息）、日志和元数据，建议根据业务消息体积、副本数量以及预留磁盘大小选择存储空间大小。 5.x版本时，该参数显示为“存储空间”。 4.8.0版本时，该参数显示为“单个代理存储空间”。磁盘类型和磁盘大小根据实际需求进行设置。RocketMQ实例创建后，磁盘类型不支持修改。磁盘类型支持高I/O、超高I/O、通用型SSD和极速型SSD。对于测试环境使用的RocketMQ实例，推荐选择高I/O磁盘。对于生产环境使用的RocketMQ实例，推荐选择通用型SSD及以上的磁盘规格。具体如何选择磁盘类型可以参考磁盘类型及性能介绍和磁盘类型对RocketMQ实例性能有什么影响？。设置网络信息。表10 实例网络参数说明参数名称说明虚拟私有云选择已经创建好的或共享的虚拟私有云。虚拟私有云可以为您的RocketMQ实例构建隔离的、能自主配置和管理的虚拟网络环境。您可以单击右侧的“管理虚拟私有云”，跳转到网络控制台的“虚拟私有云”页面，查看或创建虚拟私有云。 RocketMQ实例创建完成后，不支持修改虚拟私有云。子网选择已经创建好的或共享的子网。子网在RocketMQ实例创建完成后，不支持修改。子网开启IPv6后，RocketMQ实例支持IPv6功能。 IPv6 子网开启IPv6后，页面才显示此参数。开启IPv6后，客户端可以使用IPv6地址连接RocketMQ实例。 RocketMQ实例创建完成后，不支持修改IPv6开关。此功能仅在“华东二”区域上线。使用内网IPv6方式连接实例需要通过 VPC终端节点实现，使用期间会产生VPC终端节点的费用，收费标准请参考计费说明。安全组选择已经创建好的安全组。安全组是一组对RocketMQ实例的访问规则的集合。您可以单击右侧的“管理安全组”，跳转到网络控制台的“安全组”页面，查看或创建安全组。客户端连接RocketMQ实例前，请根据不同的连接方式配置对应的安全组规则，否则会连接失败。具体的安全组规则请参考表3。设置实例访问方式。表11 实例访问方式参数说明参数名称说明公网访问通过公网连接RocketMQ实例。默认为关闭状态。开启公网访问后，还需要为RocketMQ实例设置对应的IPv4弹性IP地址。加密方式 RocketMQ实例支持的接入加密方式。取值范围： SSL：服务端与客户端之间通过密文传输，安全性较高，性能较低。 PLAINTEXT：服务端与客户端之间通过明文传输，安全性较低，性能较高。 PERMISSIVE：服务端与客户端之间即能通过明文传输又能通过密文传输，传输方式由客户端决定。请根据实际情况选择。设置高级配置。表12 高级配置参数说明参数名称说明实例名称名称支持自定义，但需要符合命名规则：长度为4~64个字符，由英文字母开头，只能由英文字母、数字、中划线、下划线组成。企业项目该参数针对企业用户使用。企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理，默认项目为default。 ACL访问控制开启ACL访问控制可以对生产消息和消费消息进行权限管理。关闭ACL访问控制后，将无法使用用户管理功能。标签标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。如您的组织已经设定分布式消息服务RocketMQ版的相关标签策略，则需按照标签策略规则为RocketMQ实例添加标签。标签如果不符合标签策略的规则，则可能会导致RocketMQ实例创建失败，请联系组织管理员了解标签策略详情。如果您已经预定义了标签，在“标签键”和“标签值”中选择已经定义的标签键值对。另外，您可以单击“创建预定义标签”，跳转到标签管理服务页面，查看已经预定义的标签，或者创建新的标签。您也可以直接单击“添加新标签”，在“标签键”和“标签值”中设置标签信息。当前每个RocketMQ实例最多支持添加20个不同标签，标签的命名规格，请参考配置RocketMQ实例标签章节。描述设置实例的描述信息，长度为0~1024个字符。设置实例购买时长。当选择了“包年/包月”付费模式时，页面才显示“购买时长”参数，您可以根据业务需要选择购买时长。如果勾选“自动续费”，在“包年/包月”资源到期后，自动进行续费。按月购买的实例：自动续费周期为1个月。按年购买的实例：自动续费周期为1年。在页面右侧“配置概要”中，查看已选择的实例配置。确认配置无误后，单击“确认订单”，进入“确认配置”页面。确认实例信息无误且阅读并同意《华为云用户协议》后，如果“计费模式”选择“包年/包月”，单击“去支付”。根据界面提示信息，支付费用。如果“计费模式”选择“按需付费”，单击“提交”。在实例列表页面，查看RocketMQ实例是否创建成功。创建实例大约需要3到15分钟，此时实例的“状态”为“创建中”。当实例的“状态”变为“运行中”时，说明实例创建成功。当实例的“状态”变为“创建失败”，请参考删除RocketMQ实例，删除创建失败的实例，然后重新创建。如果重新创建仍然失败，请联系客服。创建失败的实例，不会占用其他资源。

分布式消息服务ROCKETMQ版
分布式消息服务ROCKETMQ版-购买RocketMQ实例:快速购买RocketMQ实例

快速购买RocketMQ实例进入购买RocketMQ实例页面。在“快速购买”页签中，设置实例基础配置。表4 实例基础配置参数说明参数名称说明计费模式 RocketMQ实例的计费模式。取值范围：包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。按需付费：一种后付费模式，即先使用再付费，按照RocketMQ实例实际使用时长计费，秒级计费，按小时结算。区域不同区域的云服务产品之间内网互不相通。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。可用区可用区指在同一区域下，电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。请根据实际情况选择可用区。RocketMQ实例创建成功后，不支持修改可用区。设置套餐规格。综合推荐：分布式消息服务RocketMQ版已经预设了几种规格，请根据需要选择。磁盘类型和磁盘大小根据实际需求进行设置。RocketMQ实例创建后，磁盘类型不支持修改。磁盘类型支持高I/O、超高I/O、通用型SSD和极速型SSD。对于测试环境使用的RocketMQ实例，推荐选择高I/O磁盘。对于生产环境使用的RocketMQ实例，推荐选择通用型SSD及以上的磁盘规格。具体如何选择磁盘类型可以参考磁盘类型及性能介绍和磁盘类型对RocketMQ实例性能有什么影响？。图1 综合推荐规格测算：系统根据您输入的参数（Topic个数、生产TPS峰值、消费TPS峰值、平均消息大小和日生产消息数），为您计算出不同规格所需的代理个数和代理存储空间，您根据实际情况选择。5.x版本不支持规格测算。图2 规格测算设置网络信息。表5 实例网络参数说明参数名称说明虚拟私有云选择已经创建好的或共享的虚拟私有云。虚拟私有云可以为您的RocketMQ实例构建隔离的、能自主配置和管理的虚拟网络环境。您可以单击右侧的“管理虚拟私有云”，跳转到网络控制台的“虚拟私有云”页面，查看或创建虚拟私有云。 RocketMQ实例创建完成后，不支持修改虚拟私有云。子网选择已经创建好的或共享的子网。子网在RocketMQ实例创建完成后，不支持修改。子网开启IPv6后，RocketMQ实例支持IPv6功能。 IPv6 子网开启IPv6后，页面才显示此参数。开启IPv6后，客户端可以使用IPv6地址连接RocketMQ实例。 RocketMQ实例创建完成后，不支持修改IPv6开关。此功能仅在“华东二”区域上线。使用内网IPv6方式连接实例需要通过VPC终端节点实现，使用期间会产生VPC终端节点的费用，收费标准请参考计费说明。安全组选择已经创建好的安全组。安全组是一组对RocketMQ实例的访问规则的集合。您可以单击右侧的“管理安全组”，跳转到网络控制台的“安全组”页面，查看或创建安全组。客户端连接RocketMQ实例前，请根据不同的连接方式配置对应的安全组规则，否则会连接失败。具体的安全组规则请参考表3。设置实例访问方式。表6 实例访问方式参数说明参数名称说明公网访问通过公网连接RocketMQ实例。默认为关闭状态。开启公网访问后，还需要为RocketMQ实例设置对应的IPv4弹性IP地址。加密方式 RocketMQ实例支持的接入加密方式。取值范围： SSL：服务端与客户端之间通过密文传输，安全性较高，性能较低。 PLAINTEXT：服务端与客户端之间通过明文传输，安全性较低，性能较高。 PERMISSIVE：服务端与客户端之间即能通过明文传输又能通过密文传输，传输方式由客户端决定。请根据实际情况选择。设置高级配置。表7 高级配置参数说明参数名称说明实例名称名称支持自定义，但需要符合命名规则：长度为4~64个字符，由英文字母开头，只能由英文字母、数字、中划线、下划线组成。企业项目该参数针对企业用户使用。企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理，默认项目为default。 ACL访问控制开启ACL访问控制可以对生产消息和消费消息进行权限管理。关闭ACL访问控制后，将无法使用用户管理功能。标签标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。如您的组织已经设定分布式消息服务RocketMQ版的相关标签策略，则需按照标签策略规则为RocketMQ实例添加标签。标签如果不符合标签策略的规则，则可能会导致RocketMQ实例创建失败，请联系组织管理员了解标签策略详情。如果您已经预定义了标签，在“标签键”和“标签值”中选择已经定义的标签键值对。另外，您可以单击“创建预定义标签”，跳转到标签管理服务页面，查看已经预定义的标签，或者创建新的标签。您也可以直接单击“添加新标签”，在“标签键”和“标签值”中设置标签信息。当前每个RocketMQ实例最多支持添加20个不同标签，标签的命名规格，请参考配置RocketMQ实例标签章节。描述设置实例的描述信息，长度为0~1024个字符。设置实例购买时长。当选择了“包年/包月”付费模式时，页面才显示“购买时长”参数，您可以根据业务需要选择购买时长。如果勾选“自动续费”，在“包年/包月”资源到期后，自动进行续费。按月购买的实例：自动续费周期为1个月。按年购买的实例：自动续费周期为1年。单击“确认订单”，进入“确认配置”页面。确认实例信息无误且阅读并同意《华为云用户协议》后，如果“计费模式”选择“包年/包月”，单击“去支付”。根据界面提示信息，支付费用。如果“计费模式”选择“按需付费”，单击“提交”。在实例列表页面，查看RocketMQ实例是否创建成功。创建实例大约需要3到15分钟，此时实例的“状态”为“创建中”。当实例的“状态”变为“运行中”时，说明实例创建成功。当实例的“状态”变为“创建失败”，请参考删除RocketMQ实例，删除创建失败的实例，然后重新创建。如果重新创建仍然失败，请联系客服。创建失败的实例，不会占用其他资源。

分布式消息服务ROCKETMQ版
分布式消息服务ROCKETMQ版-购买RocketMQ实例:准备实例依赖资源

准备实例依赖资源在购买RocketMQ实例前，您需要提前准备相关依赖资源，包括虚拟私有云（Virtual Private Cloud，以下简称VPC）、子网和安全组，并配置安全组策略。每个RocketMQ实例都部署在某个VPC中，并绑定具体的子网和安全组，通过这样的方式为RocketMQ提供一个隔离的、用户自主配置和管理的虚拟网络环境以及安全保护策略，提升实例的安全性。 RocketMQ实例所需资源的具体要求和创建指导如表1所示。表1 RocketMQ实例依赖资源准备资源要求创建指导 VPC和子网 RocketMQ实例可以使用当前账号下已创建的VPC和子网，也可以使用新创建的VPC和子网，还可以使用共享VPC和子网，请根据实际需要进行配置。共享VPC是基于资源访问管理（Resource Access Manager，简称 RAM ）服务的机制，VPC的所有者可以将VPC内的子网共享给一个或者多个账号使用。通过共享VPC功能，可以简化网络配置，帮助您统一配置和运维多个账号下的资源，有助于提升资源的管控效率，降低运维成本。有关VPC子网共享的更多信息，请参见共享VPC。在创建VPC和子网时应注意如下要求：创建的VPC与使用的RocketMQ实例应在相同的区域。创建VPC和子网时，配置参数建议使用默认配置。创建VPC和子网的操作指导请参考创建虚拟私有云和子网，若需要在已有VPC上创建和使用新的子网，请参考为虚拟私有云创建新的子网。安全组不同的RocketMQ实例可以重复使用相同的安全组，也可以使用不同的安全组，请根据实际需要进行配置。使用RocketMQ实例必须添加表2或表3所示安全组规则，其他规则请根据实际需要添加。创建安全组后，系统默认添加入方向“允许安全组内的弹性云服务器彼此通信”规则和出方向“放通全部流量”规则，此时使用内网通过同一个VPC访问RocketMQ实例，无需添加表2或表3的规则。创建安全组的操作指导请参考创建安全组，为安全组添加规则的操作指导请参考添加安全组规则。弹性IP地址开启公网访问时，才需要配置弹性IP地址。在创建弹性IP地址时，应注意如下要求：创建的弹性IP地址与RocketMQ实例在相同的区域。 RocketMQ控制台无法识别开启IPv6转换功能的弹性IP地址。创建弹性IP地址的操作指导请参考申请弹性公网IP。表2 安全组规则（RocketMQ实例4.8.0版本）方向协议端口源地址说明入方向 TCP 8100 RocketMQ客户端所在的IP地址或地址段。使用TCP协议，通过内网访问元数据节点的端口。入方向 TCP 8200 使用TCP协议，通过公网访问元数据节点的端口。入方向 TCP 10100-10199 使用TCP协议，访问业务节点的端口。表3 安全组规则（RocketMQ实例5.x版本）方向协议端口源地址说明入方向 TCP 8100 RocketMQ客户端所在的IP地址或地址段。使用TCP协议，通过内网访问实例的端口。入方向 TCP 8200 使用TCP协议，通过公网访问实例的端口。入方向 TCP 10100-10199 使用TCP协议，访问业务节点的端口。入方向 TCP 8080 使用gRPC协议，通过内网访问实例的端口。入方向 TCP 8081 使用gRPC协议，通过公网访问实例的端口。

分布式消息服务ROCKETMQ版