用户指南
更新时间:2020年6月18日
4.1购买浪潮云码实例
首先,您需要在浪潮云官网页面的"产品"导航列表中,找到浪潮云码服务,点击进入浪潮云码服务的官网页面,从购买页面中选择区域、计费模式、规格、码制等。配置后,点击"立即购买"按钮,进入订单确认页面,订单显示您刚才选择的信息,并显示订单类型和控制台流水号;点击"去支付"进入BSS的支付页面,支付成功后创建实例。
4.1.1 计费模式
计费模式分为包年/包月和按需计费两种。
包年/包月:预付费模式,按订单的购买周期计费,适用于可预估资源使用周期的场景,价格比按需计费模式更优惠。
按需付费:精确到秒级计费,按实际开通时长以小时为单位进行结算。
计费资源周期(仅针对包年/包月实例):
账期日:购买包年/包月云码实例后,购买次日为账期日(具体时刻为当日0时整)。云码实例中的按月累计资源将在每个账期日进行资源重置。购买时刻至账期日0时这段时间的实例免费使用。
计费周期:用户购买包年/包月云码实例后,从一个账期日起到下个账期日的逻辑月记为一个计费周期。
包年包月资源超限:
在一个计费周期内,若某项资源使用量超出当前套餐配额限制,系统将限制对该资源的使用具体情况如下:
数据托管空间容量、集合超限时,将无法存储或处理更多数据,主题数据同步将暂停。除非清理数据到上限值以下或升级到更高配额套餐。
发码操作数、验码操作数超、推送操作数、拉取操作数超限时,在下个计费周期前,将无法使用资源,除非升级到更高配额套餐。
发码验码同时操作数、数据推送拉取同时操作数达到上限后,后续的连接都将被拒,直到某些现有连接关闭为止,除非升级到更高配额套餐。
云码实例到期后,实例进入[已过期]状态,到期停服后:
发码验码、数据推送和拉取接口均无法使用
依赖到期云码实例的附加功能无法使用
对于数据共享:
主题数据同步将停止
数据推送消息将停止
4.1.2 区域
不同区域的云服务产品之间内网互不相通,目前仅支持华北三。
4.1.3 规格
浪潮云码提供动态码、静态码、链接活码三种方式。在购买实例时,计费模式、定价等详见[3.价格说明] 。
4.1.4码制选择
码制配置项分别如下(配置项设置后不可变更)。
动态码:身份载荷是否加密(默认不加密)。
身份载荷是编码核心内容,即"为谁进行动态编码"。如果是指代人,一般用姓名+身份证号;如果是指代物品,一般用产品编码或条形码等,长度小于128个字符。
静态码:业务编码长度(默认值为0,范围为0~4),是否使用时间戳及格式(默认不使用时间戳),序列号长度(默认值为10,范围为4~10)。
业务编码是指定业务场景或区分业务主体的标识,由应用开发者自行设置,也可以多个开发者约定规则后设置,由1-4位数字组成,也可以不设置。
时间戳是编码生成时刻的UTC时间,最高精确到毫秒,有多种格式可选,也可以不设置。
序列号即编码产生的顺序号,由4-10位数字组成,由系统根据编码请求顺序自动生成,一个业务编码独享一个序列,如未设置业务编码,则为一个APPID独享一个序列,其生成的序列号根据请求先后顺序连续。
链接活码:无配置项。
4.2实例管理使用
4.2.1实例生命周期状态
云码生命周期状态表如下:
状态 | |
启动中 | 在控制台上或通过API接口执行启动操作或在控制台执行变更配置操作后,实例进入运行中之前的状态。如果长时间处于该状态,说明出现异常。 |
运行中 | 服务正常运行,当且仅当云码实例处于运行中状态时,才能对外提供业务访问。 |
即将过期 | 包年包月实例过期前7天即进入即将过期状态。 |
停止中 | 在控制台上或通过API接口执行停止操作后,实例进入已停止之前的状态。如果长时间处于该状态,说明出现异常。 |
已停止 | 实例被正常停止,所有接口均不可访问,主题数据同步暂停 |
已过期 | 包年包月实例到期,或者按量付费实例因账号欠费而停止服务,都会使实例进入已过期状态。 |
过期回收中 | 包年包月实例在到期7天后,实例维持一段时间的已过期状态后,随时会从已过期进入过期回收中。 |
进入过期回收中之前,您可以续费实例。续费成功,则所有资源保留,不受影响。 | |
进入过期回收中状态后,您所有加入的数据主题将被自动退出,所有授权的验码权限自动取消,数据托管空间不再保留。此时,不可续费。 | |
过期回收中状态结束后,实例被删除,列表中无法看到,APPID作废。 | |
欠费回收中 | 按量付费实例在欠费停止服务7天后,实例维持一段时间的已过期状态后,随时会从已过期进入欠费回收中。 |
进入欠费回收中之前,您可以充值账号并尝试恢复启动实例。恢复启动成功,则所有资源保留,不受影响。 | |
进入欠费回收中状态后,您所有加入的数据主题将被自动退出,所有授权的验码权限自动取消,数据托管空间不再保留。此时,即使充值账号也无法恢复启动。 | |
欠费回收中状态结束后,实例被删除,列表中无法看到,APPID作废。 | |
已锁定 | 因为账户欠费(主要是线下合同客户或试用客户)或者安全原因(访问异常、业务内容存在违法违规风险),运营人员可以在运营管理平台对实例进行锁定。您可以提交浪潮云工单或联系客户经理申请解锁。这种状态等于已停止或已过期状态,但不会自动转化为过期/欠费回收中状态。 |
等待释放 |
4.2.2更多操作
- 查看/重置APP secret
应用实例的APP secret只在创建时展示一次,平台不再提供查看功能,如果遗忘了秘钥,只能使用重置功能获取新的APP secret,重置需要进行相关验证(浪潮云使用手机号+验证码,运营管理平台使用管理员手机号+验证码),验证通过后向平台发起重置请求,平台返回新的APP secret,同时注销旧的APP secret。
- 启动/停止服务
实例被正常停止,所有接口均不可访问,主题数据同步暂停。暂停后可启动服务。
- 释放服务
释放实例时,需要进行两次确认,一次要发送手机短信,确认操作人身份,第二次要求用户输入实例名称,点击释放按钮,按量计费实例将进入等待释放状态,当天晚上正常进行计量、推送计量账单并计费,操作日次日晚上随其他过期/欠费回收中状态实例一并完成实例释放。实例销毁操作不可撤销,每个用户每月仅可以进行3次实例释放操作,包年包月实例暂不提供实例释放功能。
4.3安全管理
4.3.1 安全组配置
为保证接口调用的安全性,您需要通过配置安全组(安全入站IP组成的权限组)来管理应用的访问安全。每一个安全组通过配置若干规则决定哪个IP可以访问哪些接口,并通过安全组关联应用实例功能将规则施加于应用实例(即APPID)。
创建安全组
在安全组功能中创建一个新的安全组,创建时需要输入安全组名称(仅支持大小写字母、数字、下划线和短横线,只能以字母开头,长度2-128个字符)、安全组描述(不能以http://或https://开头,长度2-256个字符)。创建后系统自动为安全组生成全局唯一ID(以“sg-”开头,后面接20位由小写字母和数字组成的随机字符串)。安全组名称和描述支持后续修改。实例开通时,系统默认创建一个安全组,以sg-default命名,描述为“System Default Safe Group”,规则为空,绑定实例为空。默认安全组不允许删除。
- 规则配置
每一个安全组需要配置规则,这些规则可以看做是IP的白名单。每一条规则由授权策略(允许、拒绝)、授权类型(目前仅支持IPV4)、授权对象(目前仅支持ip地址或CIDR规则,且每次只能配置一条)、描述(不能以http://或https://开头,长度2-256个字符)构成。每个安全组最多可以配置100条规则,默认安全组支持授权对象以“0.0.0.0/0”表示任意IP。
绑定实例
安全组内可以通过实例列表查看当前安全组所绑定的应用实例列表,并添加实例或者解绑。一个安全组可以绑定最多100个应用实例,也可以不绑定实例。但是每一个应用实例至少要绑定一个安全组,应用创建时默认绑定默认安全组,只有当前实例绑定的安全组大于等于2时,才可以解绑其中一个安全组。
- 删除安全组
除了默认安全组,用户自己创建的安全组可以被删除,但是绑定实例的安全组无法被删除,如果要删除,则需要先解绑所有实例。
4.3.2密钥管理
- 生成密钥
生成密钥时,输入密钥名称(仅支持大小写字母、数字、下划线和短横线,只能以字母开头,长度2-128个字符)、选择密钥类型(对称加密密钥、非对称加密密钥),点击生成后,创建对应的密钥(对),并生成公钥指纹(公钥的哈希值)。生成密钥的同时,会立即从平台下载密钥文件(对称加密下载的是公钥文件,非对称加密下载的是私钥文件),下载后无法再从平台下载。一个账号可以生成100个对称加密密钥和100个非对称加密密钥。
- 绑定和解绑
每一个应用实例可以绑定一个对称加密密钥和一个非对称加密密钥,更换绑定密钥时,需要先解绑同类型密钥。
删除秘钥
如出现密钥文件泄露、丢失等情况,用户可以删除平台上的密钥,但是必须先解绑改密钥绑定的所有实例。
4.4用量统计使用
可以在上方的实例选择下拉框中选择实例,可选择实例是在该区域下的非回收中状态、非等待初始化状态的实例。
计量账单
套餐内发码/验码额度
分别为所购套餐内发码操作数、验码操作数和发码验码同时操作数。
- 套餐内数据托管空间额度
分别为数据托管空间容量、推送操作数、拉取操作数、集合限制、托管空间同时操作数。
用量统计
本月总用量
统计本月发码操作数、验码操作数、数据托管空间容量、推送操作数、拉取操作数数据。"本月"是指实力购买的逻辑月。
- 昨日发码/验码用量
统计昨日发码/验码用量,昨日数据托管空间推送/拉取操作数。