华为云用户手册

操作步骤 进入购买全域公网带宽页面。 根据界面提示，配置全域公网带宽的基本信息，如表1所示。 表1 参数说明 参数名称 参数说明 取值样例 计费模式 计费模式包含：按需计费。 按需计费 区域 必选参数。 全域弹性公网IP的区域需要和全域公网带宽的区域保持一致，才可以将该全域弹性公网IP添加到全域公网带宽内。 区域参见如何选择区域。 华东-上海一 接入城域 必选参数。 全域弹性公网IP的接入城域需要和全域公网带宽的接入城域保持一致，才可以将该全域弹性公网IP添加到全域公网带宽内。 上海城域 线路 必选参数。 全域公网带宽默认支持动态BGP线路。 - 带宽类型 带宽类型包含：标准带宽。 标准带宽 计费方式 按需计费方式包含如下： 按传统型95计费 按传统型95计费 保底百分比 根据用户已选择的计费方式，自动生成保底百分比配置参数。 20% 带宽大小 必选参数。 选择全域公网带宽的大小，单位为Mbit/s。 100 全域公网带宽名称 可选参数。 输入全域公网带宽的名称。要求如下： 长度范围为0~64位。 名称由中文、英文字母、数字、下划线（_）、中划线（-）、点（.）组成。 ibw-test 企业项目 购买全域公网带宽时，可以将全域公网带宽加入已启用的企业项目。 企业项目管理提供了一种按企业项目管理云资源的方式，帮助您实现以企业项目为基本单元的资源及人员的统一管理，默认项目为default。 关于创建和管理企业项目的详情，请参见《企业管理用户指南》。 default 标签 用于标识全域公网带宽。包括键和值。 标签的命名规则请参考表2。 键：geip_1.1 值：10 描述 全域公网带宽的描述信息，可以定义全域公网带宽的用途及使用场景。非必填项。 - 表2 全域公网带宽标签命名规则 参数 规则 样例 键 不能为空。 对于同一全域公网带宽键值唯一。 长度不超过36个字符。 由英文字母、数字、下划线、中划线、中文字符组成。 geip_1.1 值 长度不超过43个字符。 由英文字母、数字、下划线、点、中划线、中文字符组成。 10 基本信息设置完成后，单击“下一步”。 在产品配置信息确认页面，再次核对全域公网带宽的信息，阅读并勾选“弹性公网IP服务声明”。确认无误后，单击“提交”。 返回全域公网带宽列表页面。 在全域公网带宽列表页面，查看全域公网带宽状态。 当全域公网带宽状态为“正常”时，表示创建成功。

操作场景 为弹性公网IP地址添加标签，可以方便用户识别和管理拥有的弹性公网IP地址。您可以在申请弹性公网IP地址时增加标签，或者在已经创建的弹性公网IP地址详情页添加标签，最多可以给弹性公网IP地址添加20个标签。 如您的组织已经设定弹性公网IP的相关标签策略，则需按照标签策略规则为弹性公网IP添加标签。标签如果不符合标签策略的规则，则可能会导致弹性公网IP创建失败，或已有弹性公网IP打标签失败，请联系组织管理员了解标签策略详情。 当前Organizations服务正在公测中，使用组织合规规则功能需先申请Organizations服务公测。

共享流量包的使用限制 共享流量包费用为一次性支付，即刻生效，不支持指定生效日期。 共享流量包一旦购买不支持修改和退订，到期后也不支持续订。 共享流量包支持包月和包年，到期后剩余的流量将无法再使用。 共享流量包只能针对按需计费（按流量计费）的带宽生效，且需要区分动态BGP和静态BGP类型。动态BGP共享流量包适用于动态BGP按需计费（按流量计费）的独享带宽，静态BGP共享流量包适用于静态BGP按需计费（按流量计费）的独享带宽。 共享流量包不支持对指定的某一个EIP带宽生效。 共享流量包不支持对共享带宽生效。 共享流量包不支持用于优选BGP类型的EIP。

操作步骤 进入购买共享流量包页面。 按照提示配置参数。 表1 参数说明 参数 说明 取值样例 区域 不同的区域之间的资源包不互通，每个区域需要分别购买，请根据您的实际需求谨慎选择。 具体可以参考如下示例： 如果您当前需要购买共享流量包抵扣区域A中的EIP带宽产生的流量资费，那么您必须购买区域A的共享流量包。如果购买其他区域（例如区域B）的流量包，就不能抵扣区域A中的EIP带宽产生的流量资费。 华东-上海一 类型 根据弹性公网IP的带宽类型进行设置。 动态BGP：支持类型为动态BGP的按需计费（按流量计费）带宽。 静态BGP：支持类型为静态BGP的按需计费（按流量计费）带宽。 静态BGP 套餐有效期 套餐时长。请根据您的需要选择合适的套餐时长，流量包不支持退订，流量包购买成功后即刻生效，超过有效期后未用完的流量将无法使用。 一个月 规格 共享流量包的大小，单位GB。 10GB 购买时长 套餐时长。 Default 单击“立即购买”。 在产品配置信息确认页面，再次核对共享流量包信息，单击“去支付”。 进入订单支付页面，确认订单信息，单击“确认”。

共享流量包的使用限制 共享流量包费用为一次性支付，即刻生效，不支持指定生效日期。 共享流量包一旦购买不支持修改和退订，到期后也不支持续订。 共享流量包支持包月和包年，到期后剩余的流量将无法再使用。 共享流量包只能针对按需计费（按流量计费）的带宽生效，且需要区分动态BGP和静态BGP类型。动态BGP共享流量包适用于动态BGP按需计费（按流量计费）的独享带宽，静态BGP共享流量包适用于静态BGP按需计费（按流量计费）的独享带宽。 共享流量包不支持对指定的某一个EIP带宽生效。 共享流量包不支持对共享带宽生效。 共享流量包不支持用于优选BGP类型的EIP。

操作场景 您可以根据需要修改共享带宽的名称和带宽大小。 按需计费的共享带宽，修改成功后立即生效，请参见修改共享带宽（按需计费）。 包年/包月的共享带宽，包括以下模式： 补差价升配（包年/包月）：修改成功后立即生效 续费降配（包年/包月）：修改成功后在新的计费周期生效 使用带宽加油包临时升配（包年/包月）：购买后立即生效 如果要修改共享带宽的计费方式，请参考如何切换计费模式中的“按需”和“包年包月”？。

操作步骤 进入购买共享带宽页面。 根据界面提示配置参数。 表1 参数说明 参数 说明 取值样例 计费模式 购买共享带宽时使用的计费模式，分为以下两种： 包年/包月：在使用前一次性支付一定期限（如1个月、1年等）的费用，后续使用期限内不再针对此共享带宽资源扣费。 按需计费：按照共享带宽的使用时长进行计费。 包年/包月 区域 不同区域的资源之间内网不互通。请选择靠近您客户的区域，可以降低网络时延、提高访问速度。 华东-上海一 线路 共享带宽的线路类型。共享带宽支持添加线路类型与带宽线路类型相匹配的EIP，具体匹配关系如下： 普通带宽：支持加入线路类型为全动态BGP、优选BGP类型的EIP。 优选BGP：支持加入线路类型为优选BGP类型的EIP。 说明： 在“中国-香港”区域，普通带宽线路类型的共享带宽仅支持加入线路类型为全动态BGP类型的EIP。 普通带宽 计费方式 共享带宽的计费方式。 支持按带宽计费、按增强型95计费。 说明： 按需计费模式下，才能选择按增强型95计费。 用户等级大于等于V4才可以选购增强型95计费。增强型95计费将按照多次去峰值后的实际使用带宽付费，按月结算。您可以设置保底带宽（带宽大小*保底百分比），如果实际的月峰值带宽小于等于保底带宽，将按照保底带宽计费，否则，将按照实际的月峰值带宽计费。 如果选择增强型95计费，共享带宽300Mbit/s起售。 关于增强型95计费的更多信息请参见什么是增强型95计费？ 按带宽计费 带宽大小 共享带宽的大小，单位Mbit/s，5M起售。 10 企业级QoS功能 开启企业级QoS功能，共享带宽将支持对带宽下的单个IP限速，带宽分配更加合理，提升共享带宽利用率。设置限速，不做计费。详情请参考企业级QoS功能。 该功能目前已上线的区域有：西南-贵阳一、中国-香港、华南-深圳、华南-广州、华南-广州-友好用户环境、华北-北京四。 - 企业项目 申请共享带宽时，可以将共享带宽加入已启用的企业项目。 企业项目管理提供了一种按企业项目管理云资源的方式，帮助您实现以企业项目为基本单元的资源及人员的统一管理，默认项目为default。 关于创建和管理企业项目的详情，请参见《企业管理用户指南》。 default 名称 共享带宽的名称。 Bandwidth-001 购买时长 包年包月场景需要选择，购买共享带宽的时长。 2个月 自动续费 选择包年包月计费模式时，可以选择开启自动续费。自动续费周期根据用户指定的购买时长确定。 按月购买：自动续费周期为一个月。 按年购买：自动续费周期为一年。 - 单击“立即购买”。 在产品配置信息确认页面，再次核对共享带宽信息，阅读并勾选“弹性公网IP服务声明”。 选择按需计费的共享带宽时，单击“提交”。 选择包年/包月计费的共享带宽时，单击“去支付”。 进入订单支付页面，确认订单信息，单击“确认”。

大区/跨区带宽使用场景（中心网络） 本示例中，以云连接中接入ER为例： 连接ER1和ER2：ER1位所在区域为华东-上海一，ER2所在区域为华南-广州，华东-上海一和华南-广州都属于中国大陆大区，因此连接ER1和ER2的全域互联带宽应该选择大区带宽。 连接ER1和ER3：ER1位所在区域为华东-上海一，ER3所在区域为中国-香港，华东-上海一属于中国大陆大区，中国-香港属于亚太大区，因此连接ER1和ER3的全域互联带宽应该选择跨区带宽。 本端大区：选择ER1所在大区，此处为中国大陆。 对端大区：选择ER3所在大区，此处为亚太。 本端也可以选择ER3所在大区，对端选择ER1所在大区，本端和对端不做严格区分，只要确保两端的ER均已接入带宽中即可。 连接ER2和ER3：ER2位所在区域为华南-广州，ER3所在区域为中国-香港，华南-广州属于中国大陆大区，中国-香港属于亚太大区，因此连接ER2和ER3的全域互联带宽应该选择跨区带宽。 本端大区：选择ER2所在大区，此处为中国大陆。 对端大区：选择ER3所在大区，此处为亚太。

跨区带宽使用场景（GEIP） 本示例中，以GEIP绑定至ECS为例： GEIP绑定的ECS所在区域为中国-香港，GEIP接入点为华东-杭州，中国-香港属于亚太大区，华东-杭州属于中国大陆大区 ，因此全域互联带宽应该选择跨区带宽。 本端大区：选择ECS所在大区，此处为亚太。 对端大区：选择GEIP接入点所在大区，此处为中国大陆。 本端必须选择GEIP绑定资源所在的大区，对端选择GEIP接入点所在的大区，请务必确保本端和对端大区选择正确。 图3 跨区带宽使用场景（GEIP）

简介 企业级QOS功能，可以针对共享带宽下的每个EIP，进行分别限速，每个EIP的流量大小会被限制在指定的带宽范围内，不会强占共享带宽的全部带宽，使得每个EIP的带宽大小可以相互不影响，提升共享带宽利用率。 该功能支持IPv4 EIP，也支持IPv6 EIP。 保证带宽 共享带宽下，分配给该EIP的最小带宽值。在共享带宽拥塞时，该EIP流量的最小带宽值可以得到保证。 最大带宽 共享带宽下，分配给该EIP的最大带宽值。在共享带宽空闲时，该EIP流量可以到达的最大带宽值，该值不会超过共享带宽的带宽大小。 该功能目前已上线的区域有：西南-贵阳一、中国-香港、华南-深圳、华南-广州、华南-广州-友好用户环境、华北-北京四。

约束与限制 企业级QoS功能会依照共享带宽中对具体的IP设定的限速阈值生效，实际限速阈值会在设定阈值上下一定区间内保持弹性浮动。 仅当共享带宽大小大于等于 50 Mbit/s时，才能开启企业级QoS功能。 共享带宽中对保证带宽的限制最大为2000Mbit/s。 共享带宽下所有EIP进行设置限速后，保证带宽之和，不能超过共享带宽的总带宽大小。 当共享带宽大小变更时（包括带宽加油包到期或者修改带宽降配），可能会影响到共享带宽公网IP的保证带宽和最大带宽值，请提前确认对业务的影响。 共享带宽正在使用带宽加油包时，加油包到期时，带宽限速规则将停用。

操作步骤 进入购买全域弹性公网IP页面。 根据界面提示，配置全域弹性公网IP的基本信息，如表1所示。 表1 参数说明 参数名称 参数说明 取值样例 区域 必选参数。 全域弹性公网IP的区域需要和全域公网带宽的区域保持一致，才可以将该全域弹性公网IP添加到全域公网带宽内。 区域参见如何选择区域。 华东-上海一 接入城域 必选参数。 全域弹性公网IP的接入城域需要和全域公网带宽的接入城域保持一致，才可以将该全域弹性公网IP添加到全域公网带宽内。 上海城域 类型 选择公网IP或者公网IP段。 公网IP 协议类型 选择IPv4或者IPv6。 IPv4 线路 必选参数。 全域弹性公网IP默认支持动态BGP线路。 选择某个IP地址资源池，系统将会为您在资源池中分配IP地址，请您选择靠近您业务的资源池，时延更小。 - 掩码长度 类型选择公网IP段时，该项可见。增加掩码长度字段，首先需要调用下面的接口获取所有可用掩码范围： GET /v3/{domain_id}/global-eip-segments/support-masks 如果接口报错，采用默认值：IPv4取值范围:[24,28]；IPv6取值范围48|56|64|96。 24 全域公网带宽 必选参数。 新创建：当您需要购买新的全域公网带宽，可以选择此处。 选择已有：当您需要通过该全域公网IP访问互联网时，需要在此处选择已有的全域公网带宽，将该IP加入到带宽中。 - 计费模式 默认按需计费。 按需计费 带宽类型 默认标准带宽。 标准带宽 计费方式 按需计费方式包含如下： 按传统型95计费 按传统型95计费 保底百分比 根据用户已选择的计费方式，自动生成保底百分比配置参数。 0% 带宽大小 带宽大小，单位Mbit/s。 300 全域弹性公网IP名称 可选参数。 输入全域弹性公网IP的名称。要求如下： 长度范围为0~64位。 名称由中文、英文字母、数字、下划线（_）、中划线（-）、点（.）组成。 geip-test 企业项目 购买全域弹性公网IP时，可以将全域弹性公网IP加入已启用的企业项目。 企业项目管理提供了一种按企业项目管理云资源的方式，帮助您实现以企业项目为基本单元的资源及人员的统一管理，默认项目为default。 关于创建和管理企业项目的详情，请参见《企业管理用户指南》。 default 高级配置 单击下拉箭头，可配置全域弹性公网IP的高级参数，包括带宽名称、标签等。 默认配置 带宽名称 可选参数。 输入全域公网带宽的名称。要求如下： 长度范围为0~64位。 名称由中文、英文字母、数字、下划线（_）、中划线（-）、点（.）组成。 ibw-test 标签 全域弹性公网IP的标识，包括键和值。 标签的命名规则请参考表2。 键：geip_1 值：184.100.101.102 监控 系统免费为您的全域弹性公网IP提供监控，通过云监控服务，可以监控以下指标： 分钟级粒度的流量监控。 监控带宽流量波动、出入网带宽速率等指标详情。 - 全域弹性公网IP数量 类型选择公网IP时，该项可见。本次需要创建全域弹性公网IP的数量。 3 表2 全域弹性公网IP标签命名规则 参数 规则 样例 键 不能为空。 对于同一全域公网带宽键值唯一。 长度不超过36个字符。 由英文字母、数字、下划线、中划线、中文字符组成。 geip_1 值 长度不超过43个字符。 由英文字母、数字、下划线、点、中划线、中文字符组成。 184.100.101.102 基本信息设置完成后，单击“立即创建”。 在产品配置信息确认页面，再次核对全域弹性公网IP的信息，阅读并勾选“弹性公网IP服务声明”。确认无误后，单击“提交”。 返回全域弹性公网IP列表页面。 在全域弹性公网IP列表页面，查看全域弹性公网IP状态。 当全域弹性公网IP状态为“未绑定”时，表示创建成功。

操作场景 当您购买弹性公网IP时，无论是哪种计费模式，只要没有加入共享带宽，那么您的弹性公网IP使用的是独享带宽。独享带宽支持对单个弹性公网IP进行限速。 本章节指导用户修改独享带宽大小，您可以增加或者降低带宽大小，修改带宽大小不会更换EIP的地址。 当您修改带宽大小时，不同计费方式的带宽收费和生效时间不同，请您参考表1了解详情，适用于独享带宽和共享带宽两种情况。 降低带宽大小，可能会影响业务流量造成丢包，请确认对业务产生的影响，谨慎操作。 表1 修改带宽大小的费用情况 计费模式 计费方式 变更操作 对费用的影响 包年/包月 按带宽计费 增加带宽大小（补差价升配） 升配后，新带宽大小将在原来已有的计费周期内立即生效。 您需要按照与原带宽的价格差，结合使用周期内的剩余时间，补齐差价。 例如：（以下价格仅作示例，实际价格以控制台显示为准） 客户于2018/11/1 购买了1Mbit/s的带宽，购买时长为1个月，此时价格为18.4元/月，客户使用余额支付18.4元，实付金额为18.4元。 客户在2018/11/24 将带宽升级为5Mbit/s，价格为92元/月。 这时，剩余天数为 30 - 24 = 6天，升配费用=92 / 30 * 6 - 18.4 / 30 * 6 = 14.72元。 了解更多变更资源计费信息，请参见变更资源费用说明。 按带宽计费 降低带宽大小（续费降配） 降配后，新带宽大小不会立即生效。 您需要选择续费时长并根据新的带宽大小进行续费，续费成功后，新带宽大小在新的计费周期内生效。 续费降配订单在资源未生效前支持退订。 续费降配后，当前计费周期的剩余时间内不能再对带宽进行任何修改，请谨慎操作。 按带宽计费 临时增加带宽大小（使用带宽加油包临时升配） 带宽加油包单独计费，您可以在带宽的使用周期内选择任意时间段使用带宽加油包临时增加带宽，带宽加油包到期后带宽自动回落。 按需计费 按带宽计费 增加/降低带宽大小 增加/降低带宽大小后，新的带宽大小和计费方式将立即生效。 按流量计费 增加/降低带宽大小 增加/降低带宽大小后，新的带宽大小将立即生效。 按流量计费的EIP，带宽仅做限速使用，带宽大小不影响实际费用。

共享带宽的使用限制 共享带宽只能加入按需计费的EIP。 共享带宽支持按带宽计费、增强型95计费。按带宽计费5Mbit/s起售，增强型95计费300Mbit/s起售。 通用可用区的共享带宽不支持添加边缘可用区的EIP，边缘可用区的共享带宽也不支持添加通用可用区的EIP。 关于边缘可用区和普通可用区的区别请参考《智能边缘小站用户指南》。 包年包月共享带宽到期释放，EIP会被移出共享带宽并按照加入共享带宽之前的模式计费。 当共享带宽的计费方式选择“按增强型95计费”，保底百分比为20%，不支持修改。 共享带宽不支持跨账号使用。 独享带宽与共享带宽不支持直接互相转换，但针对按需计费的弹性公网IP，您可以购买一个共享带宽，进行如下操作： 将弹性公网IP添加到共享带宽，则弹性公网IP使用共享带宽。 将弹性公网IP移出共享带宽，则弹性公网IP使用独享带宽。 工单提交请参见提交工单。

操作步骤 进入购买弹性公网IP页面。 根据界面提示配置参数。 图1 购买EIP 表1 参数说明 参数 说明 取值样例 计费模式 计费模式分为以下两种： 包年/包月 按需计费 按需计费 区域 不同区域的资源之间内网不互通。请选择靠近您客户的区域，可以降低网络时延、提高访问速度。购买EIP时所选择的区域即为EIP的归属地。 说明： 在“华北-乌兰察布一”区域购买的EIP的归属地为北京。 华东-上海一 线路 全动态BGP：可以根据设定的寻路协议实时自动优化网络结构，以保持客户使用的网络持续稳定、高效。 静态BGP：网络结构发生变化时，无法实时自动调整网络设置以保障用户体验。 优选BGP：是特定方向的优质线路。使用BGP协议与多家主流运营商线路互联对接，建立直连中国内地的公网互联路径，提供中国-香港区域与中国内地间的低时延、高质量的网络互通。（该线路资源仅在“中国-香港”区域支持。） 边缘线路：计费模式为按需计费并且已购买边缘小站时，该项可见。边缘线路是通过靠近用户和终端的网络边缘站点，实现区域内低时延高带宽的网络服务。边缘小站详细信息请参见 智能边缘小站。 公网IP池：计费模式为按需计费时，该项可见。公网IP池是一种批量EIP开通到管理的专属解决方案。公网IP池为EIP分配全动态BGP线路，持续保证网络稳定、高效。公网IP池详细信息请参见公网IP池简介。 更多静态BGP与全动态BGP区别信息请参见静态BGP与全动态BGP有何区别？ 全动态BGP 公网IP池 选择已购买的公网IP池。 仅当EIP的计费模式为按需计费，线路为公网IP池时，该项可见。 eipPool-test 公网带宽 选择按需计费时，需要选择公网带宽的计费方式。 按带宽计费：指定带宽上限，按使用时间计费，与使用的流量无关。适用于流量较大或较稳定场景使用。 按流量计费：指定带宽上限，按实际使用的出公网流量计费，与使用时间无关。适用于流量小或流量波动较大的场景。 加入共享带宽：带宽可以加入多个弹性公网IP，带宽被多个弹性公网IP地址共用。适用于多业务流量错峰分布场景。 按带宽计费 带宽大小 带宽大小，单位Mbit/s。 100 IPv6转换 开启IPv6转换后，将提供IPv4和IPv6弹性公网IP地址，原有IPv4业务可以快速为IPv6用户提供访问能力。 开启 DDos防护 DDoS原生基础防护 免费提供不高于5Gbps的DDoS攻击防护，如超过防护阈值，EIP会被封堵。 - 弹性公网IP名称 弹性公网IP的名称。 eip-test 企业项目 申请弹性公网IP时，可以将弹性公网IP加入已启用的企业项目。 企业项目管理提供了一种按企业项目管理云资源的方式，帮助您实现以企业项目为基本单元的资源及人员的统一管理，默认项目为default。 关于创建和管理企业项目的详情，请参见《企业管理用户指南》。 default 高级配置 单击下拉箭头，可配置弹性公网IP的高级参数，包括带宽名称、标签等。 - 带宽名称 带宽的名称。 bandwidth 标签 用于标识弹性公网IP地址。包括键和值。 标签的命名规则请参考表2。 说明： 如您的组织已经设定弹性公网IP的相关标签策略，则需按照标签策略规则为弹性公网IP添加标签。标签如果不符合标签策略的规则，则可能会导致弹性公网IP创建失败，请联系组织管理员了解标签策略详情。 键：Ipv4_key1 值：3005eip 监控 用于开启弹性公网IP的基础监控。默认开启。 开启基础监控后，用户可以通过云监控提供的管理控制台或API接口来检索弹性公网IP和带宽产生的监控指标和告警信息。 - 购买时长 选择包年包月计费模式时，需要选择购买时长。 1个月 自动续费 选择包年包月计费模式时，可以选择开启自动续费。自动续费周期根据用户指定的购买时长确定。 按月购买：自动续费周期为一个月。 按年购买：自动续费周期为一年。 - 购买量 弹性公网IP数量。 仅在按需计费时可以选择弹性公网IP数量。 1 表2 弹性公网IP地址标签命名规则 参数 规则 样例 键 不能为空。 对于同一弹性公网IP键值唯一。 长度不超过36个字符。 由英文字母、数字、下划线、中划线、中文字符组成。 Ipv4_key1 值 长度不超过43个字符。 由英文字母、数字、下划线、点、中划线、中文字符组成。 eip-01 对于按需计费的弹性公网IP，当带宽类型选择“共享带宽”时，只能在“带宽名称”的下拉选项中选择已有的共享带宽加入。如果带宽名称不可选，说明您没有可用共享带宽，请先创建。 独享带宽与共享带宽不支持直接互相转换，但针对按需计费的弹性公网IP，您可以购买一个共享带宽，进行如下操作： 将弹性公网IP添加到共享带宽，则弹性公网IP使用共享带宽。 将弹性公网IP移出共享带宽，则弹性公网IP使用独享带宽。 单击“立即购买”。 当您创建资源时配额为0，不支持创建，如需更多配额请申请扩大配额，具体请参见如何申请扩大配额？。 当您批量创建资源时配额不足，系统会出现信息提示页面，提示所需资源配额不足，并列出参数信息“资源类型”、“所需配额”和“剩余配额”，您可以根据需要选择“申请扩大配额”或者“取消”。 在产品配置信息确认页面，再次核对弹性公网IP信息，阅读并勾选“弹性公网IP服务声明”。 选择按需计费的弹性公网IP时，单击“提交”。 选择包年/包月计费的弹性公网IP时，单击“去支付”。 进入订单支付页面，确认订单信息，单击“确认付款”。 当申请弹性公网IP选择“新建共享带宽”时，需要同时购买共享带宽。

操作场景 为资源申请和绑定弹性公网IP后，可以直接访问Internet。 当您想找回已释放的弹性公网IP或申请一个指定地址的弹性公网IP时，您可以通过API接口来实现。在申请弹性公网IP时请将“ip_address”的值设置为您想找回或指定的IP地址。详情请参见《弹性公网IP API参考》。 如果该地址已被分配给其他用户则无法申请成功。 通过API接口不支持找回或创建指定的包年/包月的弹性公网IP。 管理控制台不支持找回或创建指定地址的弹性公网IP。

发送状态报告通知请求示例 POST /openchatbot/v2/DeliveryInfoNotification HTTP/1.1 Authorization: Username="chatbottest12swt70",Password="******" Content-Type: application/json Date: Sun, 28 Jun 2020 06:23:33 GMT Accept: */* Accept-Encoding: gzip, deflate, br Cookie: JSESSIONID=A4F1AE0967E87AD57CF106D295505CA4 traceUniqueID: 504021504652012181433190002002 Host: 10.179.126.105:8451 Connection: close Content-Length: 358 { "deliveryInfo": { "address": "tel:+8612345678911", "messageId": "2827c3a6-ee61-11ea-a172-fa163e6a8a4e", "deliveryStatus": "DeliveredToTerminal", "description": "SVC5001" }, "link": [ { "rel": "OutboundMessageRequest", "href": "http://example.com/exampleAPI/messaging/v1/outbound/sip%3A12599%40botplatform.rcs.chinamobile.com/requests/27437fcf-aa6e-4656-bdb1-695477cdddd9" } ] }

消息关键参数 发送消息体关键字 序号 字段 数据类型 可选属性 描述 HTTP 请求,响应消息体部分（遵循RFC2616） 1 deliveryInfo DeliveryInfo M 状态报告信息，对应表1 6 link Link数组 O 可选字段，对应源消息resourceURL。 表1 DeliveryInfo(消息报告通知) 序号 字段 数据类型 可选属性 描述 1 address String M 发送回执消息的发送方地址（原消息的目的方地址） 2 deliveryStatus Enum M 消息发送状态 MessageSent 消息已发送到平台，由MaaP产生。 DeliveredToTerminal RCS消息达到终端 DeliveryImpossible 发送失败 DeliveredToNetwork 运营商网络已转短消息发送 MessageDisplayed 消息已阅 DeliveredToVms 转视频短信发送成功 DeliveredToVmsFailed 转视频短信发送失败 DeliverdToSMS 通道转短信下发成功 DeliverdToSMSFailed 通道转短信下发失败 参见表2详细描述 3 messageId string O 源消息ID 4 description String O 状态报告相关描述，成功和失败回执都通过description增加细分描述信息。 DeliveryImpossible回执填写应用层错误码，具体请参见错误码。 DeliveredToTerminal回执填写，发送UP2.4成功回执填写UP2。 DeliveredToNetwork回执填写，转短成功回执填写 SMS 5 text String O 状态报告相关描述，全部回执都通过此字段增加细分描述信息。 DeliveryImpossible回执填写错误描述，具体请参见错误码。 表2 Chatbot下行消息的状态报告 deliveryStatus deliveryStatus含义 description 业务含义 MessageSent 消息已发出 - 消息已发送到5GMC，由MaaP平台转发到5GMC时产生。 DeliveredToTerminal 以消息的形态达到终端，包括MaaP消息和普通P2P消息送达。 UP2 以Chatbot消息形态投递到终端 DeliveryImpossible 下行消息投递失败 800 不提供网络自动回落的Chatbot消息在5GMC已超过最大可撤回时间 SVCXXX错误码 网络自动回落短信，但发送失败 DeliveredToNetwork 已转短消息发送，即转短信发送到短息终端成功。 SMS 已转短信投递到终端 MessageDisplayed 消息已阅 UP2 终端已点击打开消息

请求消息示例 DELETE /openchatbot/v2/sip:12024.jlf002@botplatform.rcs.chinamobile.com/files HTTP/1.1 tid: 6679391739583830575 Authorization:Username="a20a9716-8577-4e5e-8333-490df5b72e9f", Password=“******” Terminal-type: Chatbot Cache-Control: no-cache Pragma: no-cache Host: 10.120.207.128:8323 Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Proxy-Connection: keep-alive Connection: keep-alive

请求消息示例 POST /openchatbot/v2/auditnotification HTTP/1.1 Authorization: Username="appId32itc1",Password="******" tid: 3412316345 Authstatus: 0 Date: Mon, 09 Jun 2020 06:23:33 GMT Content-Type: application/json Accept: */* Postman-Token: e3e074fa-2ff7-4f6b-81a1-24af65d7200c Accept-Encoding: gzip, deflate, br Cookie: JSESSIONID=A3AEA3BBD0158B95AF548971EF430011 traceUniqueID: 504021504652012181504150002002 Host: 10.134.204.203:8087 Connection: close Content-Length: 741 { "file-info": [{ "content-type": "image/png", "data": { "until": "2099-12-31T23:59:59Z", "url": "https://conent-5g.obs.cn-north-4.myhuaweicloud.com:443/content_audit_service/chatbotId/pictures/2d39d4d7-0711-4710-987d-f1d91209b3a7.png" }, "file-name": "logo.png", "file-size": "16307", "type": "file" }, { "content-type": "image/jpeg", "data": { "until": "2099-12-31T23:59:59Z", "url": "https://conent-5g.obs.cn-north-4.myhuaweicloud.com:443/content_audit_service/chatbotId/pictures/91bc7489-c608-4796-ac53-7ef8d9ec8de0.jpg" }, "file-name": "10k1.jpg", "file-size": "9509", "type": "thumbnail" }] }

响应消息示例 HTTP/1.1 201 Created Content-Type: application/json; charset=utf-8 Connection: keep-alive Date: Fri, 18 Feb 2022 03:02:50 GMT { "messageId": "5eae954c-42ca-4181-9ab4-9c0ef2e8v811", "clientCorrelator": "567896", "code": "00000", "msg": "SUCCESS" }

消息关键参数 发送消息消息体关键字段 序号 字段 数据类型 可选属性 描述 1 address String M 接受方地址Request-URI，群发时填群发列表中第一个地址。 2 destinationAddress String M 接收方地址To。 说明： 仅移动支持群发，群发消息中可携带接收方地址列表，多个接收方地址之间使用英文逗号分割，最多支持100个号码。 样例："destinationAddress": "tel:+86139******30,tel:+86139******31", 为提高网络侧性能，建议群发消息相同内容单次请求不少于10个号码。 最大发送速率（每秒发送号码数）不要超过该chatbot的速率上限。 3 senderAddress String M 发送方地址From，群发时填写Chatbot的URI，广播时填写Chatbot的URI（暂不提供） 4 senderName String O 发送方名称 5 productType String O 5G产品类型，不传默认为1。 1：通知 2：营销 6 clientCorrelator string O 用户端关联数据，需要networkAPI在响应中带回内容。 7 outboundIMMessage OutboundIMMessage M 复合类型对应表1 8 taskId string O 任务 id，由北向传入。 9 taskName string O 任务名称，由北向传入。 表1 OutboundIMMessage 序号 字段 数据类型 可选属性 描述 1 contentType Enum M 消息类型。 text/plain 普通文本(包含地位位置消息)。5G消息系统中默认Chatbot下发位置信息采用Geolocation fallback SMS方式。 application/vnd.gsma.rcs-ft-http+xml，普通文件消息，可以是图片、音频、视频、名片等消息。 application/vnd.gsma.botmessage.v1.0+json，chatbot卡片消息。 multipart/mixed; boundary="[delimiter]" 携带悬浮菜单的消息。 2 conversationID string M conversationID， 会话ID，建议使用UUID，同一个会话中conversationID需保持一致。同一用户同一chatbot，会话ID保持唯一。 3 contributionID string M contributionID，与inReplyToContributionID字段配合使用，用户回复消息、点击按钮时，会在inReplyToContributionID字段携带被回复消息的contributionID，建议使用UUID，且每个消息需要重新生成一个新的uuid。 4 bodyText string M 消息内容。 contentEncoding为base64时，内容为编码后的base64字符串。 contentType为"text/plain"时，内容为字符串。 contentType为其他的类型时，内容为json对象。 5 subject string O 主题 6 destinationTerminal string O 目的终端 7 reportRequest Enum数组 O 状态事件报告列表，每个状态事件的可选值为: Sent：消息已发送到网络中的下一节点 Delivered: 消息已发送到被叫侧用户 Displayed：消息已在被叫侧终端上显示 Failed: 消息没有发送到被叫侧 Interworking：消息转短信或转彩信 8 inReplyToContributionID string O 标识是对一条上行消息的回复，主动下发消息时不用携带，由上行消息触发的下行消息必须携带，值是上行消息中的contributionID。上行消息存在有效期，若超过有效期则本条交互消息无法下发，当前为30分钟。 9 contentEncoding Enum O 消息内容(bodyText元素的内容)编码方式。 缺省，utf8字符编码。 base64，base64编码。 10 shortMessageSupported string O 是否转短信。 false:不转，true:转，缺省false 11 storeSupported string O 是否离线存储。 false:不存也不重试，true:存，缺省true 12 serviceCapability ServiceCapability数组 O 由SAG赋默认值。 capabilityId=”chatbotSA” version=” +g.gsma.rcs.botversion="#=2"” 13 imFormat Enum O IM消息格式，可选值包括IM 14 smsBodyText string O 转短消息时的短信内容。 转短标志为false时此字段无效。 15 trafficType string O 流量类型标识，值如 advertisement、payment、premium、subscription、plugin

文本消息示例 POST /openchatbot/v2/MessageStatusNotification HTTP/1.1 Content-Type: application/json Date: Sun, 28 Jun 2020 06:23:33 GMT User-Agent: SP/sip:888.chatbot@botplatform.rcs.chinamobile.com Accept: */* Accept-Encoding: gzip, deflate, br Connection: keep-alive Cookie: JSESSIONID=A4F1AE0967E87AD57CF106D295505CA4 Authorization: Username="chatbottest12swt70",Password="******" traceUniqueID: 504021504652012181438100002002 Host: 10.165.73.119:19088 Connection: close Content-Length: 273 { "address": "tel:+8612345678911", "messageId": "2827c3a6-ee61-11ea-a172-fa163e6a8a4e", "status": "Revoked", "link": [ { "rel": "OutboundMessageRequest", "href": "http://10.165.73.119:19088/messaging/v1/outbound/sip:888.chatbot@botplatform.rcs.chinamobile.com/requests/123456/status" } ] }

消息关键参数 发送消息URL关键字段 序号 字段 数据类型 可选属性 描述 HTTP URL 部分（遵循RFC2616） 1 userId string M 被叫用户号码 消息上报通知消息关键字段 序号 字段 数据类型 可选属性 描述 HTTP 消息体 部分（遵循RFC2616） 1 link Link数组 O 原消息的resourceURL。 路径中最后一节是源消息的messageId。 2 address String M 撤回消息的被叫地址（原消息的目的方地址） 3 messageId String O 源消息ID 4 status ENUM O 消息撤回结果 Revoked，成功撤回 RevokeFailed，撤回失败。

发送撤回消息示例 PUT /messaging/v2/sip:888.chatbot@botplatform.rcs.chinamobile.com/22ed8552-e5d2-11ea-b483-fa163e6a8a4e/outbound HTTP/1.1 Content-Type: application/json Authorization:Username="a20a9716-8577-4e5e-8333-490df5b72e9f", Password=“******” Address: tel:+8619585550104 Cache-Control: no-cache Pragma: no-cache Host: 10.120.207.128:8319 Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Connection: keep-alive Content-Length: 319 { "address":"tel:+8619585550104", "status":"RevokeRequested" }

消息关键参数 发送消息URL关键字段 (其他字段见 接口消息URL关键字段) 序号 字段 数据类型 可选属性 描述 HTTP URL 部分（遵循RFC2616） 1 messageId String M 待撤回消息的ID。 表1 消息URL关键字段 序号 字段 数据类型 可选属性 描述 1 serverRoot string M 服务器基础URL: hostname(或ip)+port+base path Port和base path可选 例: ip:port/openchatbot 2 apiVersion string M 客户端想使用的API版本号. 例: “v2”. 3 chatbotAddress string M 行业消息的统一服务地址，客户端可根据此地址将所有通知集合展现。 chatbotAddress是5G云服务平台分配给购买者的chatbotID。如果您已经购买了5G消息应用资产，则可以登录消费者门户，选择”应用管理”查看chatbotID。 发送消息HTTP头关键字段 序号 字段 数据类型 可选属性 描述 HTTP 消息头部分（遵循RFC2616） 1 Address string M 接受方地址Request-URI 消息上报通知消息关键字段 序号 字段 数据类型 可选属性 描述 HTTP 消息体 部分（遵循RFC2616） 1 status ENUM M 值RevokeRequested，请求撤回消息 2 address string M 源消息接收方地址。

请求消息示例 GET /openchatbot/v2/123456/files HTTP/1.1 Authorization: Username="a20a9716-8577-4e5e-8333-490df5b72e9f", Password=“******” Accept: */* Host: 10.186.76.175:8323 accept-encoding: gzip, deflate Connection: keep-alive

响应消息示例 HTTP/1.1 200 OK Server: Apache-Coyote/1.1 Content-Disposition: form-data; name="File"; filename="1.jpg" Content-Type: image/jpeg Content-Transfer-Encoding: 8bit DATE: Tue, 12 Jul 2016 06:00:00 GMT Content-Range: bytes 0-123455/123456 Content-Length: 123456

文件上传请求消息示例 POST /openchatbot/v2/sip:chatbotid32itc1@botplatform.rcs.chinamobile.com/files HTTP/1.1 Authorization: Username="appId32itc1",Password="******" Accept: */* Host: 10.120.207.128:8323 Accept-Encoding: gzip, deflate, br Connection: keep-alive Content-Type: multipart/form-data; boundary=--------------------------413122496398836876848661 Cookie: JSESSIONID=429751BCFD903F626E0FF31378F8A79A Content-Length: 213 ----------------------------413122496398836876848661 Content-Disposition: form-data; name="File"; filename="zh123.txt" Content-Type: text/plain 123123 ----------------------------413122496398836876848661--

消息关键参数 请求消息头关键参数： 序号 字段 数据类型 可选属性 描述 1 Content-Length string M 内容大小 请求消息关键参数（消息体采用multipart/form-data格式）： 序号 字段 数据类型 可选属性 描述 1 Thumbnail Binary O 缩略图，可以为空（如语音片段可以由客户端使用默认缩略图）；非空时包含以下信息： 文件名 文件大小 文件类型（图片） 缩略图内容 3 File Binary M 文件，包含以下信息： 文件名 文件大小 文件类型 文件内容 响应消息关键参数： 序号 字段 数据类型 可选属性 描述 1 响应码 string M 200 OK成功响应（文件相关信息需等待媒体审核结束后通知） 2 tid string M 文件传输ID