华为云用户手册

  • 响应参数 状态码: 200 表6 响应Body参数 参数 参数类型 描述 meta Meta object 请求元数据,例如表征本次请求的唯一标注uuid。 result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID,用户自定义,不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。 count Integer 执行检测的数量,与resp_data字段对应。 resp_data Array of ExtentionRespDataByIdCardImage objects 请求列表,用于支持批量调用。目前暂时只支持单个数据查询。 表9 ExtentionRespDataByIdCardImage 参数 参数类型 描述 verification_result String 审核校验结果: "valid"表示身份审核通过; "invalid"表示身份审核不通过; "nonexistent"表示数据源没有该身份证号码,这种情况一般是被验证人正在办理户籍迁移,或者被验证人是军人或政要。 verification_message String 审核校验信息,具体参考校验信息说明 verification_code Integer 审核校验代码,具体参考校验信息说明 idcard_result IdcardResult object 身份证图像的 文字识别 结果,具体参见IdcardResult。 表10 IdcardResult 参数 参数类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String 民族。 address String 地址。 issue String 发证机关。 valid_from String 有效起始日期。 valid_to String 有效结束日期。 状态码: 400 表11 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String X-Auth-Token值获取方法请参见认证鉴权。 Enterprise-Project-Id 否 String 企业项目ID。IVS支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。 企业项目创建步骤请参见用户指南。 说明: 说明: 创建企业项目后,在传参时,有以下三类场景。 携带正确的ID,正常使用IVS服务,账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID,正常使用IVS服务,账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID(包含特殊字符等),正常使用IVS服务,账单的企业项目会被分类到"default"中。 表2 请求Body参数 参数 是否必选 参数类型 描述 meta 是 Meta object 请求元数据,例如表征本次请求的唯一标注uuid。 data 是 data object 请求消息的数据部分。 表3 Meta 参数 是否必选 参数类型 描述 uuid 否 String 唯一标识此次请求的ID,用户自定义,不超过64位。 表4 data 参数 是否必选 参数类型 描述 req_data 否 Array of ExtentionReqDataByIdCardImage objects 请求列表,用于支持批量调用。目前暂时只支持单个数据查询。 表5 ExtentionReqDataByIdCardImage 参数 是否必选 参数类型 描述 idcard_image1 是 String 身份证人像面图像数据,使用base64编码,要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间,支持JPG格式。 idcard_image2 否 String 身份证国徽面图像数据,使用base64编码,要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间,支持JPG格式。
  • 请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候,PATCH可能会去创建一个新的资源。 人证核身 标准版(三要素)的URI部分,您可以看到其请求方法为“POST”,则其请求为: POST https://ivs.cn-north-4.myhuaweicloud.com/v2.0/ivs-standard
  • 请求消息体 请求消息体通常以结构化格式发出,与请求消息头中Content-type对应,传递除请求消息头之外的内容。若请求消息体中参数支持中文,则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于人证核身标准版(三要素)接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。 POST https://ivs.cn-north-4.myhuaweicloud.com/v2.0/ivs-standard Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT... Request Body: { "meta": { "uuid": "user_defined" }, "data": { "req_data": [ { "idcard_image1": "/9j/4AAQSkZJRgABAgEASA...", "idcard_image2": "/9j/4AAAAABQSkZJRgABAgEASB...", "face_image": "/9j/4BBQSkZJRgABAgEASB..." } ] } } 到这里为止这个请求需要的内容就具备齐全了,您可以使用curl、Postman或直接编写代码等方式发送请求调用API。
  • 请求消息头 附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type:消息体的类型(格式),必选,默认取值为“application/json”,有其他取值时会在具体接口中专门说明。 X-Auth-Token:用户Token,可选,当使用Token方式认证时,必须填充该字段。用户Token请参考认证鉴权。 添加消息头后的请求如下所示。 POST https://ivs.cn-north-4.myhuaweicloud.com/v2.0/ivs-standard Content-Type: application/json x-auth-token: MIIaBgYJKoZIhvcNAQcC……
  • 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中,但大多数语言或框架都要求您从请求消息中单独传递它,所以在此单独强调。 表1 URI中的参数说明 参数 说明 URI-scheme 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 endpoint 指定承载REST服务端点的服务器 域名 或IP,不同服务不同区域的endpoint不同,您可以从地区和终端节点获取。 例如IVS服务在“华北-北京四”区域的“endpoint”为“ivs.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径,也即API访问路径。 从具体API的URI模块获取,例如人证核身标准版(三要素)API的“resource-path”为“/v2.0/ivs-standard”。 query-string 查询参数,是可选部分,并不是每个API都有查询参数。查询参数前面需要带一个“?”,形式为“参数名=参数取值”,例如“limit=10”,表示查询不超过10条数据。 例如,您需要在“华北-北京四”区域调用人证核身标准版(三要素)API,则需使用“华北-北京四”区域的Endpoint(ivs.cn-north-4.myhuaweicloud.com),并在标准版(三要素)的URI部分找到resource-path(/v2.0/ivs-standard),拼接起来如下所示。 https://ivs.cn-north-4.myhuaweicloud.com/v2.0/ivs-standard 图1 URI示意图 为查看方便,在每个具体API的URI部分,只给出resource-path部分,并将请求方法写在一起。这是因为URI-scheme都是HTTPS,而endpoint在同一个区域也相同,所以简洁起见将这两部分省略。
  • GaussDB (DWS)的数据库概念 数据库 数据库用于管理各类数据对象,与其他数据库隔离。创建数据库时可以指定对应的表空间,如果不指定相应的表空间,相关的对象会默认保存在PG_DEFAULT空间中。数据库管理的对象可分布在多个表空间上。 联机分析处理 联机分析处理(Online Analytical Processing,简称OLAP),是GaussDB(DWS)集群的主要工作方式,支持复杂的分析操作,侧重决策支持,并且提供直观易懂的查询结果。 大规模并行处理 大规模并行处理(Massive Parallel Processing,简称MPP,也可称为无共享架构),是指在GaussDB(DWS)集群的每个节点中,都有独立的内存计算和磁盘存储系统,GaussDB(DWS)根据数据库模型和应用特点,将业务数据划分到不同节点上,通过节点间的网络彼此连接协同计算,使集群作为整体提供数据库服务以满足业务需要。 无共享架构 无共享架构(Shared Nothing Architecture)是一种分布式计算架构。这种架构中的每一个节点都是独立、自给的,使整个系统中不出现单点竞争的情况,以提高工作效率。 数据库版本 每个GaussDB(DWS)集群对应一个数据库版本,用户在创建GaussDB(DWS)集群时确认此集群的版本。 数据库连接 用户通过客户端连接GaussDB(DWS)集群的方式,实现数据库的连接。支持在华为云平台以及互联网环境上使用客户端进行连接。 数据库用户和角色 GaussDB(DWS)使用用户和角色来控制对数据库的访问。根据角色自身的设置不同,一个角色可以看做是一个数据库用户,或者一组数据库用户。在GaussDB(DWS)中角色和用户之间的区别只在于角色默认是没有 LOG IN权限的。在GaussDB(DWS)中一个用户唯一对应一个角色,不过可以使用角色叠加来更灵活地进行管理。 实例 实例在GaussDB(DWS)中是运行在内存中的一组数据库进程,一个实例可以管理一个或多个数据库,这些数据库组成一个集簇。集簇是存储磁盘上的一个区域,这个区域在安装时初始化并由一个目录组成,所有数据都存储在这个目录中,这个目录被称为数据目录,使用initdb创建。理论上来说一个服务器上可以在不同的端口启动多个实例,但是GaussDB(DWS)一次只能管理一个实例,启动和停止都是依赖于具体的数据目录。以后由于兼容的需要不排除引入实例名这个概念的可能。 表空间 在GaussDB(DWS)中,表空间是一个目录,可以存在多个,里面存储的是它所包含的数据库的各种物理文件。由于表空间是一个目录,仅是起到了物理隔离的作用,其管理功能依赖于文件系统。 模式 GaussDB(DWS)的模式是对数据库做一个逻辑分割。所有的数据库对象都建立在模式下面。GaussDB(DWS)的模式和用户是弱绑定的,所谓的弱绑定是指虽然创建用户的同时会自动创建一个同名模式,但用户也可以单独创建模式,并且为用户指定其他的模式。 事务管理 在事务管理上,GaussDB(DWS)采取了MVCC(多版本并发控制)结合两阶段锁的方式,其特点是读写之间不阻塞。GaussDB(DWS)的MVCC没有将历史版本数据统一存放,而是和当前元组的版本放在了一起。GaussDB(DWS)没有回滚段的概念,但是为了定期清除历史版本数据GaussDB(DWS)引入了一个VACUUM进程。一般情况下用户不用关注它,除非要做性能调优。此外,GaussDB(DWS)是自动提交事务。
  • GaussDB(DWS)的管理概念 集群 表示由多个节点组成的服务器群组。GaussDB(DWS)以集群为单位进行组织,一个GaussDB(DWS)集群由多个在相同子网中的相同规格的节点组成,共同提供服务。 节点 每个GaussDB(DWS)集群部署节点取值范围为3~256,其中实时数仓(单机模式)取值为1,每个节点都支持存储与分析数据。详情请参见GaussDB(DWS)技术指标。 规格 用户创建GaussDB(DWS)集群时需要指定集群节点的规格,不同规格节点使用的CPU、内存和存储资源不同。 快照 快照是用户根据需要创建的GaussDB(DWS)集群备份,用于还原创建快照时的集群数据。快照会一直保存,直到用户使用管理控制台将此快照删除(自动快照不支持手动删除)。快照会占用用户购买使用的OBS配额。 Project Project用于将OpenStack的资源(计算资源、存储资源和网络资源)进行分组和隔离。Project可以是一个部门或者一个项目组。一个账户中可以创建多个Project。
  • 使用限制 本文介绍使用GaussDB(DWS)产品重点功能限制以及注意事项。 创建GaussDB(DWS)集群后,您不需要做数据库的基础运维(例如高可用、打安全补丁等),但需要重点关注如下事项: 表1 GaussDB(DWS)约束限制 事项 说明 创建集群 设置的节点数量不能大于用户可使用的节点配额或256个。如果可使用的节点配额不足,用户可以单击“申请扩大配额”以提工单的形式申请更多节点配额。 集群创建成功后,“产品类型”不能再进行更改,请参考 数据仓库 类型了解不同产品类型功能上的具体差异。 推荐使用包年/包月方式购买集群,包月时长到期之后,集群会自动释放。 连接集群 用户需要在与集群相同的虚拟私有云子网中使用客户端连接GaussDB(DWS)集群。 数据仓库服务只支持用户管理集群,不支持直接访问集群节点。用户或应用程序使用数据库对应的集群访问IP地址和端口,访问数据仓库。 SQL语法 实时数仓(单机部署)暂不支持全文检索、OBS和HDFS外表导入导出、自动创建分区、SEQUENCE及相关函数。 实时数仓(单机部署)由于只有单DN,因此分布规则会被忽略,也不支持针对分布规则的修改。 从文档直接复制命令到执行环境中粘贴时可能自动换行,导致运行出错,请注意删除换行。 在实际业务中,根据需要创建新的Database,不建议直接使用集群默认的gaussdb数据库。 规格变更 弹性变更规格仅8.1.1.300及以上集群版本支持。 弹性变更规格当前仅支持离线变更规格,变更时间大约需要10分钟左右。 若创建本地盘或者存算一体形态的集群,则创建好以后不支持修改规格,如果需要使用更高规格的节点,请重新创建一个新的集群。弹性变更规格目前仅支持SSD云盘形态的标准数仓或实时数仓集群。 包年/包月计费模式集群进行弹性变更规格操作时,默认按照包年包月计费。 如果当前集群是包年/包月计费模式,将不支持经典变更规格功能。 在经典变更规格期间新集群是不计费的,当变更成功后开始计费。变更完成后老集群处于保留期,不再计费。 经典变更规格功能目前仅支持标准数仓和实时数仓(单机部署不支持)。逻辑集群不支持经典变更规格。 经典变更规格最大支持调整到240节点,且原节点数量加调整后节点数量不大于480节点。 磁盘扩容功能仅8.1.1.203及以上版本支持,并且创建集群规格需要为标准数仓SSD云盘和实时数仓类型。 集群状态为“可用”、“待重启”、“只读”、“非均衡”、“节点故障”或者 “不可用”的情况下才能下发磁盘扩容。 节点扩容 如果当前集群是包年/包月计费模式,那么新增节点也是按照包年包月模式进行计费。 标准数仓集群扩容时使用与当前集群相同的存储规格。 实时数仓(单机部署)不支持扩容集群。 重分布功能8.1.1.200及以上集群版本支持。 只有在扩容之后,集群任务信息为“待重分布”状态时才能手动使用“重分布”功能,其他时段该功能不可使用。 缩容集群仅8.1.1.300及以上版本支持,包周期计费模式的集群仅8.2.1及以上版本支持。 缩容的节点默认是按节点数计费。 标准数仓集群缩容时只支持缩容与当前集群相同的存储规格。 实时数仓(集群部署)不支持缩容至单机部署集群。 备份集群 GaussDB(DWS)根据快照创建的新集群与生成快照的原始集群具有相同的配置,即节点的数量和规格、内存、磁盘与原集群要一致。 根据快照创建新集群时,如果没有指定其他值,则参数默认与生成快照时的备份信息保持一致。 实时数仓(单机部署)暂不支持快照功能。 快照生成期间,请避免进行Vacuum Full操作,否则可能会导致集群只读。 创建快照时因备份数据会降低磁盘I/O性能,建议您在业务相对空闲的时期进行快照操作。 快照期间会保留一些中间文件,需额外占用磁盘空间,因此请避开业务高峰期并保证磁盘容量在70%以下。 支持恢复快照到当前集群,但不支持恢复逻辑集群与资源池到当前集群。 版本升级 8.1.1及以上集群版本支持用户自助通过控制台下发集群升级操作。 如果节点故障/系统升级导致集群长时间中断,请联系技术支持人员进行处理。 数据迁移 OBS导入导出数据时,不支持中文路径。 OBS导入导出数据时,暂不支持跨Region进行OBS数据导入导出,必须确保OBS和DWS集群在同一个Region中。 故障切换 容灾创建后,生产集群快照功能正常使用,但是灾备集群禁用快照功能,同时生产、灾备集群均禁用恢复功能。 容灾不支持同步配置的外部数据源数据。 容灾管理为同一租户下的双集群容灾。 创建容灾需要生产集群与灾备集群类型、版本号一致且逻辑同构。 Region内容灾生产集群和灾备集群需要在同一个VPC内。 Region内容灾在生产集群与容灾集群切换后绑定的弹性负载均衡(ELB)会自动切换到新的生产集群,过程中会有短暂的连接中断,请注意在变更时间窗内尽量避免业务语句写入。 Region内容灾在生产集群与容灾集群,原生产集群所在的EIP和内网域名,连接IP地址不会自动切换,业务系统中如果有使用EIP,域名或者IP方式连接,需要切换到新集群。 冷热数据管理 实时数仓(单机部署)暂不支持冷热分区切换功能。 冷热表只支持列存2.0版本的分区表,外表不支持冷热分区。 仅支持从热数据切换为冷数据,不支持从冷数据切换为热数据。 对于同一分区在同一DN只会存在冷或热的一种情况,对于同一分区在不同DN可能存在部分DN为热数据,部分DN为冷数据。 只支持修改冷热表的冷热切换策略,不支持修改冷热表的冷数据的表空间。
  • GaussDB(DWS)技术指标 GaussDB(DWS)不同版本的技术指标如下所示。 表1 GaussDB(DWS)技术指标8.1.3-9.1.0版本 技术指标 8.1.3最大值 8.2.0最大值 8.2.1最大值 8.3.0最大值 9.1.0最大值 集群节点数 2048 2048 2048 2048 存算一体:2048 存算分离:采用多VW技术,最大支持256个VW,每个VW 1024个DN,建议VW不超过32个,每个VW不超过128个DN。 并发连接数 分钟级复杂查询并发数:80 秒级短查询并发数:500 毫秒级短事务并发数:5000 分钟级复杂查询并发数:80 秒级短查询并发数:500 毫秒级短事务并发数:5000 分钟级复杂查询并发数:80 秒级短查询并发数:500 毫秒级短事务并发数:5000 分钟级复杂查询并发数:80 秒级短查询并发数:500 毫秒级短事务并发数:5000 存算一体: 分钟级复杂查询并发数:80 秒级短查询并发数:500 毫秒级短事务并发数:5000 存算分离: 多VW技术,可以实现并发数目的叠加,随着VW个数增加,支撑的并发数也可以相应的扩展,集群总的并发数目受GTM/CCN排队影响,建议不超过8192。 集群数据容量 20PB 20PB 20PB 20PB 存算一体: 20PB 存算分离: 数据存储在OBS上,理论上容量可以无限扩展。 单表大小 1PB 1PB 1PB 1PB 1PB 单行数据大小 1GB 1GB 1GB 1GB 1GB 单表列数(除Hudi表外) 1600 1600 1600 1600 行存:1600 列存:1600 HStore:5000 Hudi表列数 - - 5000 5000 5000 分区表的分区个数 32768 32768 32768 32768 最大32768,建议不超过1000 集群内单点故障RTO 60s 60s 60s 60s 60s 集群内单点故障RPO 0 0 0 0 0 集群故障容灾切换RTO 60min 60min 60min 60min 60min 集群故障容灾切换RPO 60min 60min 60min 60min 60min VW(Virtual Warehouse):也称逻辑集群,DWS存算分离支持把一个物理集群拆分成多个VW,不同业务可以绑定不同VW,实现业务负载隔离和并发数目扩展。 表2 GaussDB(DWS)技术指标8.0.x-8.1.1版本 技术指标 8.0.x最大值 8.1.0最大值 8.1.1最大值 数据容量 10PB 10PB 20PB 集群节点数 256 256 2048 单表大小 1PB 1PB 1PB 单行数据大小 1GB 1GB 1GB 每条记录单个字段的大小 1GB 1GB 1GB 单表记录数 255 255 255 单表列数 1600 1600 1600 单表中的索引个数 无限制 无限制 无限制 单表索引包含列数 32 32 32 单表约束个数 无限制 无限制 无限制 并发连接数 分钟级复杂查询并发数:60 毫秒级短事务并发数:5000 分钟级复杂查询并发数:60 毫秒级短事务并发数:5000 分钟级复杂查询并发数:80 毫秒级短事务并发数:5000 分区表的分区个数 32768 32768 32768 分区表的单个分区大小 1PB 1PB 1PB 分区表的单个分区记录数 255 255 255 并发连接数的最大值基于数仓规格48 vCPU和64 vCPU。例如,标准数仓云盘规格dwsk.12xlarge(48 vCPU | 384GB | 24000GB SSD)或dwsx2.16xlarge.m7 (64 vCPU | 512GB | 32000GB SSD)。
  • 实时数仓规格 创建实时数仓时,用户可根据需求选择集群部署或单机部署: 集群部署:创建集群时可选择带有h的节点规格,规格详情请参见表5,此时实时数仓支持集群部署,支持节点扩容、资源池等功能。 单机部署:创建集群时可选择带有h1的节点规格,规格详情请参见表6,此时实时数仓只支持单机部署,单机形态不提供高可用服务,因此存储成本可减半,单机模式服务可用性通过E CS 自动重建实现,数据可靠性通过EVS多副本机制保证。单机形态性价比更高,建议用于轻量化业务。 表5 实时数仓(集群形态)规格 规格名称 CPU架构 vCPU 内存(GB) 单节点存储容量 步长(GB) DN数量 使用场景 dwsx2.h.xlarge.4.c7 X86 4 16 20GB ~ 2000GB 20 1 DWS的入门规格,一般用于测试、学习环境或者小型分析系统。 dwsk2.h.xlarge.4.kc1 ARM 4 16 20GB ~ 2000GB 20 1 dwsx2.h.xlarge.4.c7n X86 4 16 20GB ~ 2000GB 20 1 dwsx2.h.2xlarge.4.c6 X86 8 32 100GB ~ 4000GB 100 1 适用于中小企规模企业内部数据仓库构建和报表分析。 dwsx2.h.2xlarge.4.c7 X86 8 32 100GB ~ 4000GB 100 1 dwsk2.h.2xlarge.4.kc1 ARM 8 32 100GB ~ 4000GB 100 1 dwsx2.h.2xlarge.4.c7n X86 8 32 100GB ~ 4000GB 100 1 dwsx2.h.4xlarge.4.c7 X86 16 64 100GB ~ 8000GB 100 1 推荐在生产环境下使用,适用于绝大部分企业大数据量OLAP分析系统,BI报表,可视化大屏等场景。 dwsk2.h.4xlarge.4.kc1 ARM 16 64 100GB ~ 8000GB 100 1 dwsx2.h.4xlarge.4.c7 X86 16 64 100GB ~ 8000GB 100 1 dwsx2.h.8xlarge.4.c7 X86 32 128 100GB ~ 16000GB 100 2 dwsk2.h.8xlarge.4.kc1 ARM 32 128 100GB ~ 16000GB 100 2 dwsx2.h.8xlarge.4.c7n X86 32 128 100GB ~ 16000GB 100 2 dwsk2.h.12xlarge.4.kc1 ARM 48 192 100GB ~ 24000GB 100 4 有着极致的性能,适用于高吞吐数仓加工,高并发在线查询生产环境。 dwsx2.h.16xlarge.4.c7 X86 64 256 100GB ~ 32000GB 100 4 dwsx2.h.16xlarge.4.c7n X86 64 256 100GB ~ 32000GB 100 4 表6 实时数仓(单机形态)规格 规格名称 CPU架构 vCPU 内存(GB) 单节点存储容量 步长(GB) DN数量 使用场景 dwsx2.h1.xlarge.2.c7 X86 4 8 20GB ~ 2000GB 20 1 DWS的入门规格,一般用于测试、学习环境或者小型分析系统。 dwsk2.h1.xlarge.2.kc1 ARM 4 8 20GB ~ 2000GB 20 1 dwsx2.h1.xlarge.2.c7n X86 4 8 20GB ~ 2000GB 20 1 dwsx2.h1.2xlarge.4.c7 X86 8 32 100GB ~ 4000GB 100 1 适用于中小企规模企业内部数据仓库构建和报表分析。 dwsk2.h1.2xlarge.4.kc1 ARM 8 32 100GB ~ 4000GB 100 1 dwsx2.h1.2xlarge.4.c7n X86 8 32 100GB ~ 4000GB 100 1 dwsx2.h1.4xlarge.4.c7 X86 16 64 100GB ~ 8000GB 100 1 推荐在生产环境下使用,适用于绝大部分企业大数据量OLAP分析系统,BI报表,可视化大屏场景。 dwsk2.h1.4xlarge.4.kc1 ARM 16 64 100GB ~ 8000GB 100 1 dwsx2.h1.4xlarge.4.c7n X86 16 64 100GB ~ 8000GB 100 1 dwsx2.h1.8xlarge.4.c7 X86 32 128 100GB ~ 16000GB 100 2 dwsk2.h1.8xlarge.4.kc1 ARM 32 128 100GB ~ 16000GB 100 2 dwsx2.h1.8xlarge.4.c7n X86 32 128 100GB ~ 16000GB 100 2 dwsk2.h1.12xlarge.4.kc1 ARM 48 192 100GB ~ 24000GB 100 4 有着极致的性能,适用于高吞吐数仓加工,高并发在线查询生产环境。 dwsx2.h1.16xlarge.4.c7 X86 64 256 100GB ~ 32000GB 100 4 dwsx2.h1.16xlarge.4.c7n X86 64 256 100GB~32000GB 100 4
  • 概览 数据库智能运维(DMS)是一个为GaussDB(DWS)数据库提供多维度监控服务的系统,为用户数据库的快速、稳定运行提供保驾护航的能力。该功能对业务数据库所使用磁盘、网络、OS指标数据,集群运行关键性能指标数据进行收集、监控、分析。通过综合收集到的多种类型指标,对数据库主机、实例及业务SQL进行诊断,及时暴露数据库中关键故障及性能问题,指导用户进行优化解决。 8.1.1.200及以上版本支持数据库监控功能。 存算一体(单机部署)暂不支持DMS功能。 DMS与Cloud Eye监控的数据源不同,采集数据库的大小为该数据库使用的全部磁盘空间,会包含膨胀表的数据。
  • 细粒度策略授权 登录 IAM 服务管理控制台,创建自定义策略。 具体操作,请参见《 统一身份认证 服务用户指南》中的创建自定义策略。 说明如下: 您必须使用IAM管理员用户,即属于admin用户组的用户,因为只有IAM管理员用户具备创建用户组及用户、修改用户组权限等操作权限。 由于GaussDB(DWS)服务属于项目级服务,“作用范围”必须选择“项目级服务”,如果需要该策略对多个项目生效,需要对多个项目分别授权。 在IAM中,预置了以下两种GaussDB(DWS)策略模板。在创建自定义策略时,您可以选择以下模板,然后基于模板修改策略授权语句。 DWS Admin:拥有对数据仓库服务的所有执行权限。 DWS Viewer:拥有对数据仓库服务的只读权限。 在策略授权语句中,您可以在Action列表中,添加如授权项列表所述的GaussDB(DWS)资源操作或REST API对应的“授权项”,从而使策略获得相应的操作权限。 例如,在策略语句的Action列表中,添加“dws:cluster:create”,那么该策略就拥有了创建/恢复集群的权限。 如果需要使用其他服务,您同时还需授予其他服务的相关操作权限,具体内容请查阅相关服务的帮助文档。 例如,创建GaussDB(DWS) 集群时,需要配置集群所属的虚拟私有云,为了能获取VPC列表,您需在策略语句中添加授权项“vpc:*:get*”。 创建用户组。 具体操作,请参见《统一身份认证服务用户指南》中的创建用户组。 将用户加入用户组,并将新创建的自定义策略授权给用户组,使用户组中的用户具有策略定义的权限。 具体操作,请参见《统一身份认证服务用户指南》中的查看或修改用户组。
  • 检查规则 当用户被授予多个策略,或者一个策略中包含多个授权语句,这些策略中既有Allow又有Deny的授权语句时,遵循Deny优先的原则。在用户访问资源时,权限检查逻辑如下。 图3 系统鉴权逻辑图 每条策略做评估时, Action之间是或(or)的关系。 用户访问系统,发起操作请求。 系统评估用户被授予的访问策略,鉴权开始。 在用户被授予的访问策略中,系统将优先寻找显式拒绝指令。如找到一个适用的显式拒绝,系统将返回Deny决定。 如果没有找到显式拒绝指令,系统将寻找适用于请求的任何Allow指令。如果找到一个显式允许指令,系统将返回Allow决定。 如果找不到显式允许,最终决定为Deny,鉴权结束。
  • 授权项列表 在IAM中创建自定义策略时,您可以根据需求在策略授权语句的Action列表中添加GaussDB(DWS)资源操作或REST API所对应的“授权项”,使得该策略具有相应的操作权限。GaussDB(DWS) 细粒度策略的授权项列表如下: REST API GaussDB(DWS) REST API的授权项列表,请参见权限策略和授权项。 管理控制台操作 GaussDB(DWS)资源操作及对应的授权项如表1所示。 GaussDB(DWS)部分授权项依赖的授权项包括了ECS、VPC、EVS、ELB、 MRS 或OBS等服务的授权项,如果这些服务没有对接相应的服务授权项,则需要添加对应服务的Admin系统权限。 由于GaussDB(DWS)接口较多,以下列表仅列举了重点高频操作接口,剩余未展示接口仅支持project项目(即IAM鉴权),不支持企业项目鉴权,故如果要使用,请在IAM鉴权界面配置。 表1 GaussDB(DWS) 资源操作授权项列表 GaussDB(DWS) 资源操作 授权项 依赖的授权项 授权项作用域 创建集群 "dws:cluster:create" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "vpc:securityGroupRules:delete", "vpc:ports:update", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 获取集群列表 "dws:cluster:list" "dws:*:get*", "dws:*:list*", 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 获取单个集群详情 "dws:cluster:getDetail" "dws:*:get*", "dws:*:list*", "vpc:vpcs:list", "vpc:securityGroups:get" 支持: 项目(Project) 企业项目(Enterprise Project) 设置自动快照 "dws:cluster:setAutomatedSnapshot" "dws:backupPolicy:list" 支持: 项目(Project) 企业项目(Enterprise Project) 设置安全参数/参数组 "dws:cluster:setSecuritySettings" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 重启集群 "dws:cluster:restart" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 扩容集群 "dws:cluster:scaleOut" "dws:*:get*", "dws:*:list*", "dws:cluster:scaleOutOrOpenAPIResize", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "vpc:*:update*", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 使用API扩容集群或调整大小 "dws:cluster:scaleOutOrOpenAPIResize" "dws:*:get*", "dws:*:list*", "vpc:vpcs:list", "vpc:ports:create", "vpc:ports:get", "vpc:ports:update", "vpc:subnets:get", "vpc:subnets:update", "vpc:subnets:create", "vpc:routers:get", "vpc:routers:update", "vpc:networks:create", "vpc:networks:get", "vpc:networks:update", "ecs:serverInterfaces:use", "ecs:serverInterfaces:get", "ecs:cloudServerFlavors:get" 支持: 项目(Project) 企业项目(Enterprise Project) 重置密码 "dws:cluster:resetPassword" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 删除集群 "dws:cluster:delete" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:delete*", "vpc:*:get*", "vpc:*:list*", "vpc:*:delete*", "evs:*:get*", "evs:*:list*", "evs:*:delete*", 支持: 项目(Project) 企业项目(Enterprise Project) 设置可维护时间段 "dws:cluster:setMaintainceWindow" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 绑定EIP "dws:eip:operate" "dws:*:get*", "dws:*:list*", "eip:*:get*", "eip:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 解绑EIP "dws:eip:operate" "dws:*:get*", "dws:*:list*", "eip:*:get*", "eip:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 创建DNS域名 "dws:dns:create" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 释放DNS域名 "dws:dns:release" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 修改DNS域名 "dws:dns:edit" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 创建MRS连接 "dws:MRSConnection:create" "dws:*:get*", "dws:*:list*", "mrs:*:get*", "mrs:*:list*", "mrs:cluster:create", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*" 支持: 项目(Project) 企业项目(Enterprise Project) 更新MRS连接 "dws:MRSConnection:update" "dws:*:get*", "dws:*:list*", "mrs:*:get*", "mrs:*:list*", "mrs:cluster:create", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*" 支持: 项目(Project) 企业项目(Enterprise Project) 删除MRS连接 "dws:MRSConnection:delete" "dws:*:get*", "dws:*:list*", "mrs:*:get*", "mrs:*:list*", "mrs:cluster:create" "ecs:*:get*", "ecs:*:list*", "ecs:*:delete*", "vpc:*:get*", "vpc:*:list*", "vpc:*:delete*", "evs:*:get*", "evs:*:list*", "evs:*:delete*", 支持: 项目(Project) 企业项目(Enterprise Project) MRS数据源列表 "dws:MRSSource:list" "mrs:cluster:list", "mrs:tag:listResource", "mrs:tag:list", "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 添加/删除标签 "dws:tag:addAndDelete" "dws:*:get*", "dws:*:list*", "dws:openAPITag:update", "dws:openAPITag:getResourceTag", 支持: 项目(Project) 企业项目(Enterprise Project) 编辑标签 "dws:tag:edit" "dws:*:get*", "dws:*:list*", "dws:openAPITag:update", "dws:openAPITag:getResourceTag", 支持: 项目(Project) 企业项目(Enterprise Project) 创建快照 "dws:snapshot:create" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 获取快照列表 "dws:snapshot:list" -- 支持: 项目(Project) 企业项目(Enterprise Project) 查看单个集群快照列表 "dws:clusterSnapshot:list" "dws:cluster:list", "dws:openAPICluster:getDetail" 支持: 项目(Project) 企业项目(Enterprise Project) 删除快照 "dws:snapshot:delete" "dws:snapshot:list" 支持: 项目(Project) 企业项目(Enterprise Project) 复制快照 "dws:snapshot:copy" "dws:snapshot:list", "dws:snapshot:create" 支持: 项目(Project) 企业项目(Enterprise Project) 恢复到新集群 "dws:cluster:restore" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*" 支持: 项目(Project) 企业项目(Enterprise Project) 集群调整大小 "dws:cluster:resize" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "ecs:*:delete*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "vpc:*:delete*", "evs:*:get*", "evs:*:list*", "evs:*:create*", "evs:*:delete*" 支持: 项目(Project) 企业项目(Enterprise Project) 主备恢复 "dws:cluster:switchover" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 查询弹性负载均衡列表 "dws:elb:list" "dws:*:get*", "dws:*:list*", "elb:*:get*", "elb:*:list*", 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 绑定弹性负载均衡 "dws:elb:bind" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "vpc:*:get*", "vpc:*:list*", "evs:*:get*", "evs:*:list*", "elb:*:get*", "elb:*:list*", "elb:*:delete*", "elb:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 解绑弹性负载均衡 "dws:elb:unbind" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "vpc:*:get*", "vpc:*:list*", "evs:*:get*", "evs:*:list*", "elb:*:get*", "elb:*:list*", "elb:*:delete*", 支持: 项目(Project) 企业项目(Enterprise Project) 查询快照配置参数 "dws:snapshotConfig:list" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 更新快照策略 "dws:backupPolicyDetail:update" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 删除快照策略 "dws:backupPolicy:delete" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 查询快照策略 "dws:backupPolicy:list" "dws:cluster:list" 支持: 项目(Project) 企业项目(Enterprise Project) 查询集群加密信息 "dws:clusterEncryptInfo:list" "dws:*:get*", "dws:*:list*", "KMS Administrator" 支持: 项目(Project) 企业项目(Enterprise Project) 创建代理 "dws:createAgency:create" "dws:*:get*", "dws:*:list*", "security administrator" 支持: 项目(Project) 企业项目(Enterprise Project) 查询obs桶信息 "dws:queryBuckets:list" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 扩容节点 "dws:expandWithExistedNodes:update" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "vpc:*:update*", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 删除容灾备份 "dws:disasterRecovery:delete" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:delete*", "vpc:*:get*", "vpc:*:list*", "vpc:*:delete*", "evs:*:get*", "evs:*:list*", "evs:*:delete*" 支持: 项目(Project) 企业项目(Enterprise Project) 创建容灾备份 "dws:disasterRecovery:create" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 容灾备份其他操作 "dws:disasterRecovery:otherOperate" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*" 支持: 项目(Project) 企业项目(Enterprise Project) 容灾备份查询操作 "dws:disasterRecovery:get" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "vpc:*:get*", "vpc:*:list*", "evs:*:get*", "evs:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 增加CN节点 "dws:module:install" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 删除CN节点 "dws:module:uninstall" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 删除节点 "dws:clusterNodes:operate" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 更新节点别名 dws:instanceAliasName:update dws:cluster:list 支持: 项目(Project) 企业项目(Enterprise Project) 实施重分布 "dws:redistribution:operate" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 查询重分布 "dws:redistributionInfo:list" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 停止重分布 "dws:redistribution:suspend" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 恢复重分布 "dws:redistribution:recover" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 磁盘扩容 "dws:disk:expand" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 集群缩容 "dws:cluster:shrink" "dws:*:get*", "dws:*:list*", "dws:createAgency:create", "ecs:*:get*", "ecs:*:list*", "ecs:*:delete*", "vpc:*:get*", "vpc:*:list*", "vpc:*:delete*", "evs:*:get*", "evs:*:list*", "evs:*:delete*" 支持: 项目(Project) 企业项目(Enterprise Project) 查询规格产品信息 "dws:specProduct:list" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 按需转包周期 "dws:ondemandToPeriod:operate" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "vpc:securityGroupRules:delete", "evs:*:get*", "evs:*:list*", "evs:*:create*", "bss:coupon:view", "bss:order:pay", "bss:order:view", "bss:contract:update", "bss:balance:view", "bss:renewal:view", "bss:unsubscribe:update", "bss:renewal:update", "bss:order:update" 支持: 项目(Project) 企业项目(Enterprise Project) 获取DWS资源 "dws:resources:list" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*", "bss:coupon:view", "bss:order:pay", "bss:order:view", "bss:contract:update", "bss:balance:view", "bss:renewal:view", "bss:unsubscribe:update", "bss:renewal:update", "bss:order:update" 支持: 项目(Project) 企业项目(Enterprise Project) 修改包周期集群 "dws:periodCluster:modify" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:delete*", "vpc:*:get*", "vpc:*:list*", "vpc:*:delete*", "evs:*:get*", "evs:*:list*", "evs:*:delete*", "bss:coupon:view", "bss:order:pay", "bss:order:view", "bss:contract:update", "bss:balance:view", "bss:renewal:view", "bss:unsubscribe:update", "bss:renewal:update", "bss:order:update" 支持: 项目(Project) 企业项目(Enterprise Project) 创建包周期集群 "dws:periodCluster:create" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*", "bss:coupon:view", "bss:order:pay", "bss:order:view", "bss:contract:update", "bss:balance:view", "bss:renewal:view", "bss:unsubscribe:update", "bss:renewal:update", "bss:order:update" 支持: 项目(Project) 企业项目(Enterprise Project) 创建集群前检查 "dws:checkCluster:create" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 包周期集群磁盘扩容前检查 "dws:periodExpandPrecheck:operate" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*", "vpc:*:get*", "vpc:*:list*", "vpc:*:create*", "evs:*:get*", "evs:*:list*", "evs:*:create*", 支持: 项目(Project) 企业项目(Enterprise Project) 绑定管理面IP "dws:bindManageIp:operate" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 获取用户授权 "dws:checkAuthorize:operate" "dws:*:get*", "dws:*:list*", "dws:checkSupport:operate" 支持: 项目(Project) 企业项目(Enterprise Project) 用户授权 "dws:authorize:operate" "dws:*:get*", "dws:*:list*", "dws:checkSupport:operate" 支持: 项目(Project) 企业项目(Enterprise Project) 获取用户数据库 "dws:userDatabase:list" "dws:*:get*", "dws:*:list*", "dws:checkSupport:operate" 支持: 项目(Project) 企业项目(Enterprise Project) 获取用户结构 "dws:schemas:list" "dws:*:get*", "dws:*:list*", "dws:checkSupport:operate" 支持: 项目(Project) 企业项目(Enterprise Project) 获取用户表 "dws:tables:list" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 表恢复 "dws:tableRestore:operate" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 用户恢复表名检测 "dws:tableRestoreCheck:operate" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 检测集群是否支持细粒度备份 "dws:checkSupport:operate" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 查询支持变更的规格列表 "dws:supportFlavors:list" "dws:*:get*", "dws:*:list*", 支持: 项目(Project) 企业项目(Enterprise Project) 执行弹性变更规格 "dws:specResize:operate" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:create*" 支持: 项目(Project) 企业项目(Enterprise Project) 停止快照 "dws:snapshot:stop" "dws:snapshot:list" 支持: 项目(Project) 企业项目(Enterprise Project) 终止会话 "dws:dmsSession:terminate" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 负荷诊断报告操作 "dws:dmsWorkloadDiagnosisReport:create" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 修改告警规则 "dws:dmsAlarmRule:update" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 启用告警规则 "dws:dmsAlarmRule:enable" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 启用集群告警 "dws:dmsClusterAlarm:enable" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 禁用集群告警 "dws:dmsClusterAlarm:disable" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) GRPC对外服务 "dws:dmsGrpcOuter:operation" "dws:dmsQuery:list", "dws:cluster:setSecuritySettings", "obs:bucket:ListAllMyBuckets" 支持: 项目(Project) 企业项目(Enterprise Project) 新增SQL探针 "dws:dmsProbe:add" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 修改SQL探针 "dws:dmsProbe:update" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 删除SQL探针 "dws:dmsProbe:delete" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 启用/禁用SQL探针 "dws:dmsProbe:enable" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 创建用户面板 "dws:dmsUserBoard:create" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 修改用户面板 "dws:dmsUserBoard:update" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 删除用户面板 "dws:dmsUserBoard:delete" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 终止查询 "dws:dmsQuery:terminate" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 启停DMS监控服务 "dws:dmsService:enableOrDisable" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 修改DMS存储配置 "dws:dmsStorageConfig:modify" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) DDL审核创建获取 "dws:dmsDdlExamine:getOrCreate" "dws:dmsGrpcOuter:operation" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 负荷快照操作 "dws:dmsWorkloadDiagnosisSnapshot:create" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 创建告警规则 "dws:dmsAlarmRule:add" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 删除告警规则 "dws:dmsAlarmRule:delete" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 执行SQL探针 "dws:dmsProbe:execute" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 删除监控项 "dws:dmsPerformanceMonitor:delete" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 启停DMS监控采集项 "dws:dmsCollectItem:enableOrDisable" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 修改DMS监控采集配置 "dws:dmsCollectConfig:modify" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 条件查询 "dws:dmsQuery:list" "dws:cluster:list" 支持: 项目(Project) 企业项目(Enterprise Project) OPENAPI条件查询 "dws:dmsOpenapiQuery:list" "dws:cluster:list" 支持: 项目(Project) 企业项目(Enterprise Project) 禁用告警规则 "dws:dmsAlarmRule:disable" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 删除告警记录 "dws:dmsAlarmRecord:delete" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 检查SQL探针 "dws:dmsProbe:check" "dws:dmsGrpcOuter:operation" 支持: 项目(Project) 企业项目(Enterprise Project) 新增监控项 "dws:dmsPerformanceMonitor:add" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 修改监控项 "dws:dmsPerformanceMonitor:update" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 下载历史监控趋势 "dws:dmsTrendHistory:down" "dws:dmsQuery:list" 支持: 项目(Project) 企业项目(Enterprise Project) 获取集群ring环信息 "dws:ring:list" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 获取群进程拓扑 "dws:processTopo:list" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 查询智能运维信息 "dws:operationalTask:get" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 智能运维执行操作 "dws:operationalTask:operate" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 逻辑集群增删改操作 "dws:logicalCluster:operate" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 逻辑集群查询操作 "dws:logicalCluster:get" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 逻辑集群弹性计划操作 "dws:logicalClusterPlan:operate" "dws:*:get*", "dws:*:list*", "dws:logicalCluster:*", "dws:cluster:scaleOut", "iam:agencies:*", "iam:permissions:*Agency*" 支持: 项目(Project) 企业项目(Enterprise Project) 创建终端节点服务 "dws:vpcEndpointService:create" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 查询资源管理信息 "dws:workLoadManager:get" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 资源管理相关操作 "dws:workLoadManager:operate" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 云日志 服务相关操作 "dws:ltsAccess:operate" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 查询云日志服务信息 "dws:ltsAccess:get" "dws:*:get*", "dws:*:list*" 支持: 项目(Project) 企业项目(Enterprise Project) 查询事件信息 "dws:event:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询事件规格信息 "dws:event:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询事件订阅信息 "dws:eventSub:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 创建事件订阅信息 "dws:eventSub:create" "dws:*:get*", "dws:*:list*", 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 更新事件订阅信息 "dws:eventSub:update" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 删除事件订阅信息 "dws:eventSub:delete" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询告警统计信息 "dws:alarmStatistic:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询告警详情信息 "dws:alarmDetail:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询告警配置信息 "dws:alarmConfig:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询告警订阅信息 "dws:alarmSub:list" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 创建告警订阅信息 "dws:alarmSub:create" "dws:*:get*", "dws:*:list*", 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 更新告警订阅信息 "dws:alarmSub:update" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 删除告警订阅信息 "dws:alarmSub:delete" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 下发集群升级相关操作(升级、回滚、提交、重试) "dws:cluster:doUpdate" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询集群可用的升级路径信息 "dws:cluster:getUpgradePaths" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 查询集群升级记录 "dws:cluster:getUpgradeRecords" "dws:*:get*", "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 启动集群 "dws:cluster:startCluster" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:start", "ecs:*:stop" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 停止集群 "dws:cluster:stopCluster" "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "ecs:*:start", "ecs:*:stop" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 获取集群折扣节点 "dws:cluster:listDiscountNode" "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 获取标签 "dws:openAPItag:list" "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 服务eps列表 "dws:service:listEps" "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 容灾信息获取 "dws:disasterRecovery:get" "dws:*:*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 集群恢复检查 "dws:cluster:checkRestore" "dws:*:*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 告警静态列表 "dws:alarmStatistic:list" "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 获取资源静态信息 "dws:service:getResourceStatistics" "dws:*:*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 告警细节列表 "dws:alarmDetail:list" "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 获取集群细节 "dws:openAPICluster:getDetail" "dws:*:*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 集群事件规格列表 "dws:eventSpec:list" "dws:*:list*" 不支持 企业项目(Enterprise Project) 支持: 项目(Project) 集群容灾列表 "dws:cluster:listDisasterRecovery" "dws:*:list*", 不支持 企业项目(Enterprise Project) 支持: 项目(Project)
  • 策略语法 在IAM左侧导航窗格中,单击“策略”,单击策略名称,可以查看策略的详细内容,以“DWS ReadOnlyAccess”为例,说明细粒度策略的语法。 图2 设置策略 { "Version": "1.1", "Depends": [], "Statement": [ { "Effect": "Allow", "Action": [ "dws:*:get*", "dws:*:list*", "ecs:*:get*", "ecs:*:list*", "vpc:*:get*", "vpc:*:list*", "evs:*:get*", "evs:*:list*", "mrs:*:get*", "bss:*:list*", "bss:*:get*" ] } ] } Version:标识策略的版本号,主要用于区分Role-Based Access Control(RBAC)策略和细粒度策略。 1.0:RBAC策略。RBAC策略是将服务作为一个整体进行授权,授权后,用户可以拥有这个服务的所有权限。 1.1:经典细粒度策略。相比RBAC策略,细粒度策略基于服务的API接口进行权限拆分,授权更加精细。授权后,用户可以对这个服务执行特定的操作。细粒度策略包括系统预置和用户自定义两种。 Depends:依赖项。 Statement:策略授权语句,描述策略的详细信息,包含Effect(作用)和Action(授权项)。 Effect(作用) 作用包含两种:Allow(允许)和Deny(拒绝),系统预置策略仅包含Allow(允许)的授权语句,自定义策略中可以同时包含Allow(允许)和Deny(拒绝)的授权语句,当策略中既有Allow(允许)又有Deny(拒绝)的授权语句时,遵循Deny(拒绝)优先的原则。 Action(授权项) 对资源的具体操作权限,格式为:“服务名:资源类型:操作”,支持单个或多个操作权限,支持通配符号*,通配符号表示所有。 示例:"dws:cluster:create",其中dws为服务名,cluster为资源类型,create为操作,该授权项表示创建GaussDB(DWS) 集群的权限。
  • 告警解释 GaussDB(DWS)每30秒采集集群各节点所有磁盘的使用情况。 如果存在磁盘最近10分钟(可配置)内的最大使用率超过80%(可配置),则上报节点数据盘使用率超阈值的重要告警;如果平均使用率低于75%(即上报阈值减去5%),则消除该重要告警。 如果存在磁盘最近10分钟(可配置)内的最大使用率超过85%(可配置),则上报节点数据盘使用率超阈值的紧急告警;如果平均使用率低于80%(即上报阈值减去5%),则消除该紧急告警。 如果存在磁盘的最大使用率一直大于上报阈值,那么在24小时(可配置)后将再次发起告警。
  • 使用流程 从MRS导入数据到集群流程如下: 前提条件 创建一个MRS集群,具体操作步骤请参见购买自定义集群。 创建一个HDFS外表,外表通过外部服务器的接口,从MRS集群查询数据。 具体操作步骤请参见《数据仓库服务数据迁移与同步》中从MRS导入数据到集群章节。 同一个网络下可以有多个MRS数据源, 但是GaussDB(DWS)集群每次只能和一个MRS集群建立连接。 在GaussDB(DWS) 集群创建一个MRS数据源连接,具体操作步骤请参见创建MRS数据源连接。 使用MRS数据源导入数据到集群,具体操作请参见使用MRS数据源。 (可选)当MRS集群的HDFS配置发生变更时,在GaussDB(DWS)服务中,需要执行MRS数据源配置的更新操作,详情请参见更新MRS数据源配置。
  • MRS集群简介 MapReduce服务 (MapReduce Service,简称MRS)是一个基于开源Hadoop生态环境而运行的大数据集群,对外提供大容量数据的存储和分析能力,可解决用户的数据存储和处理需求。有关MRS服务的详细信息,请参考《MapReduce服务用户指南》。 用户可以将海量业务数据,存储在MRS的分析集群,即使用Hive/Spark组件保存。Hive/Spark的数据文件则保存在HDFS中。GaussDB(DWS) 支持在相同网络中,配置一个GaussDB(DWS) 集群连接到MRS集群,然后将数据从HDFS中的文件读取到GaussDB(DWS) 。 存算一体(单机部署)暂不支持从MRS导入数据。
  • 智能运维概览 GaussDB(DWS)提供智能运维功能,帮助用户快速高效地执行运维任务。智能运维会根据集群负载情况,选择合理时间窗、并发度完成用户指定的任务。在运维任务执行过程中,智能运维会时刻关注用户业务的变化,及时调整运维任务执行策略,以减轻对用户业务的影响。智能运维支持周期型和单次型任务的创建,执行时间窗可按照不同用户业务负载定制化。 智能运维具备一定的高可用性,在集群异常的情况下,智能运维将重新执行失败的运维任务,若由于集群异常导致运维任务部分步骤无法完成,智能运维将尝试跳过失败的步骤,以节省用户运维时间窗开销。 智能运维界面主要由以下部分构成: 运维任务公共配置: 用户表VacuumFull运维任务最大并发数:配置应用于每个用户表VacuumFull运维任务,建议依据剩余磁盘空间和时间窗内IO负载情况合理配置。配置范围为1~24,建议配置值为5。 进行中的运维任务:显示正在运行的运维任务信息(目前仅支持Vacuum运维任务,用户数据膨胀,磁盘内存不足可进行Vacuum操作,详情请参见数据膨胀磁盘空间不足,导致性能降低)。 用户频繁创建、删除表,导致系统表膨胀严重,可对系统表执行Vacuum。 用户频繁执行UPDATE、DELETE语句,导致用户表膨胀严重,可对用户表执行Vacuum/Vacuum Full。 运维详情:运维详情包括两部分,运维计划和运维状态。运维计划将展示全部运维任务基本信息,运维状态将展示运维任务运行状态信息。 该特性仅8.1.3及以上版本支持。 智能运维功能暂不支持存算一体(单机部署)。 VacuumFull运维任务完成后系统会自动进行Analyze操作,用户无需手动。 运维任务公共配置模块仅8.1.3及以上集群版本支持,历史版本需要联系技术支持人员升级使用。 父主题: Vacuum回收GaussDB(DWS)空间
  • 支持审计的关键操作列表 通过 云审计 服务,您可以记录与GaussDB(DWS)服务相关的操作事件,便于日后的查询、审计和回溯。 自动快照的创建、删除走系统内部调度,非用户操作,不记录审计日志。 因GaussDB(DWS)集群操作事件较多,下表仅展示部分高频支持审计的GaussDB(DWS)操作。 表1 云审计服务支持审计的GaussDB(DWS)操作列表 操作名称 资源类型 事件名称 创建集群 cluster createCluster 删除集群 cluster deleteCluster 集群巡检 cluster createInspection 终止巡检 cluster AbortInspection 扩容集群 cluster growCluster 空闲节点扩容 cluster resizeWithFreeNodes 集群重分布 cluster redistributeCluster 查询重分布详情 cluster queryRedisInfo 磁盘扩容 cluster executeDiskExpand 集群规格变更 cluster flavorResize 重启集群 cluster rebootCluster 集群主备切换 cluster activeStandySwitchover 重置密码 cluster resetPassword 集群修复 cluster repairCluster 创建集群连接信息 cluster createClusterConnection 修改集群连接信息 cluster modifyClusterConnection 删除集群连接信息 cluster deleteClusterConnection 调整集群大小 cluster resizeCluster 绑定或解绑弹性IP cluster bindOrUnbindEIP 创建或绑定Elb cluster createOrBindElb 解绑Elb cluster unbindElb 添加CN cluster addCN 删除CN cluster deleteCN 集群升级 cluster clusterUpdateMgr 集群缩容 cluster shrinkCluster 添加资源管理计划 cluster addWorkloadPlan 删除资源池 cluster deleteWorkloadQueueInfo 添加资源池 cluster addWorkloadQueueInfo 修改集群guc参数 cluster updateClusterConfigurations 解除只读 cluster cancelReadonly 修改运维时间窗 cluster modifyMaintenanceWindow 批量增加CN节点 cluster batchCreateCn 批量删除CN节点 cluster batchDeleteCn 批量添加标签 cluster batchCreateResourceTag 批量删除标签 cluster batchDeleteResourceTag 创建逻辑集群 cluster createLogicalCluster 删除逻辑集群 cluster deleteLogicalCluster 编辑逻辑集群 cluster editLogicalCluster 重启逻辑集群 cluster restartLogicalCluster 转换到逻辑集群 cluster switchLogicalCluster 启动集群 cluster startCluster 停止集群 cluster stopCluster 修改集群安全组 cluster changeSecurityGroup 修改集群时区 cluster modifyClusterTimezone 创建快照 backup createBackup 删除快照 backup deleteBackup 恢复集群 backup restoreCluster 复制快照 backup copySnapshot 删除快照策略 backup deleteBackupPolicy 更新快照策略 backup updateClustersBackupPolicy 创建容灾 disasterRecovery createDisasterRecovery 删除容灾 disasterRecovery deleteDisasterRecovery 启动容灾 disasterRecovery startDisasterRecoveryAction 停止容灾 disasterRecovery stopDisasterRecoveryAction 灾备切换 disasterRecovery switchoverDisasterRecoveryAction 异常切换 disasterRecovery failoverDisasterRecoveryAction 恢复容灾 disasterRecovery recoveryDisaster 更新容灾配置 disasterRecovery updateRecoveryDisaster 查询容灾详情 disasterRecovery disasterRecoveryOperate 设置安全参数 configurations updateConfigurations 创建扩展资源 dataSource createExtDataSource 删除扩展资源 dataSource deleteExtDataSource 更新扩展资源 dataSource updateExtDataSource 创建MRS数据源 dataSource createExtDataSource 删除MRS数据源 dataSource deleteExtDataSource 更新MRS数据源 dataSource updateExtDataSource
  • 超流量停机 单卡当月已用流量超出套餐额度则自动停机,次月自动恢复。单卡当月剩余流量不支持累计到次月。 前向流量池内单卡已用流量超过套餐额度可正常使用,前向流量池内所有卡当月已用流量总和超出前向流量池内SIM卡的套餐额度总和则自动停机。前向流量池当月剩余流量不支持累计到次月。 超流量停机之后,无论是当月充值恢复使用,还是次月自动恢复使用,设备无需重启即可正常联网。若存在部分设备无法联网的问题时,请重启设备。 父主题: 使用物联网卡
  • 创建规则 登录 全球SIM联接 控制台,在左侧选择“自动化规则”进入自动化规则列表页面,单击“创建规则”进入创建自动化规则页面。 表1 创建规则参数说明 参数名称 说明 规则名称 自定义规则的名称,便于管理。 规则类型 规则的类型包括订单管理、用量监控、卡状态变更监控、流量池监控。 触发器 触发器的类型分为五种情况: SIM卡套餐到期:订单管理规则的触发器。 周期累计数据用量:用量监控规则的触发器。 卡状态变更:卡状态变更监控规则的触发器。 前向流量池周期累计数据用量:流量池监控规则的触发器。 后向流量池周期累计数据用量:流量池监控规则的触发器。 触发条件 触发条件的类型分为三种情况: 到期天数(天):订单管理规则的触发条件。 剩余流量(MB):用量监控规则或流量池监控规则的触发条件。 卡状态(未激活、可激活、在用、已停用、拆机)变更:卡状态变更监控规则的触发条件。 执行 选择规则触发后的通知方式,包括短信&邮件或API推送。 短信&邮件: 提醒周期:根据需要设置短信提醒的周期。 发送短信:此处展示短信通知的模板示例。 API推送: API推送地址:选择指定的API推送地址。若先前未创建推送地址,可单击右侧“推送地址管理界面创建”按钮跳转到推送地址管理页面新增推送地址。 合并发送:若不勾选“合并发送”,API推送的报文请参考API推送报文;若勾选“合并发送”,API推送的报文请参考API合并推送报文。 提醒周期:根据需要设置API推送的提醒周期。 推送失败提醒:若开启了推送失败提醒,当推送失败时,用户会在消息中心收到API推送失败提醒,在消息接收管理中对应消息类型下配置消息接收人即可收到短信或邮件提醒。 筛选器 筛选器类型分为四种情况(默认情况下是监控您平台的所有SIM卡): 主套餐:通过购卡下单时选择的套餐筛选,过滤出您想要监控的SIM卡。 标签:通过标签筛选,过滤出您想要监控的SIM卡。 前向流量池:通过前向流量池的名称筛选过滤您想要监控的SIM卡。 后向流量池:通过后向流量池的名称筛选过滤您想要监控的SIM卡。
  • API合并推送报文 推送body参数 参数 参数类型 描述 ruleType int 规则类型: 1:订单管理 。 2:用量监控 。 4:卡状态变更监控。 templateName string 模板名称: api_rule_price_plan_expired:SIM卡套餐到期模板。 api_rule_flow_usage_remain:周期累计数据用量模板。 api_rule_sim_status_modify:卡状态变更模板。 templateParamsList array 包含多个卡信息的模板参数集合,最多包含500张卡的信息。 templateParamsList.templateParams array 单个卡信息的模板参数集合,建议按照key值进行解析,后续可能会添加其他key值。 SIM卡套餐到期(api_rule_price_plan_expired)报文示例: { "ruleType": 1, "templateName": "api_rule_price_plan_expired", "templateParamsList": [ { "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "daysToExpire", "value": "9" } ] }, { "templateParams": [...] } ... ] } 周期 累计数据用量(api_rule_flow_usage_remain)报文示例 { "ruleType": 2, "templateName": "api_rule_flow_usage", "templateParamsList": [ { "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "usageFlow", "value": "100" } ] }, { "templateParams": [...] } ... ] } 卡状态变更(api_rule_sim_status_modify)报文示例 { "ruleType": 4, "templateName": "api_rule_sim_status_modify", "templateParamsList": [ { "templateParams": [ { "key": "cid", "value": "2021080621060000T" }, { "key": "modifyTime", "value": "2022-05-16 03:24:08" }, { "key": "oldStatus", "value": "未激活" }, { "key": "newStatus", "value": "可激活" } ] }, { "templateParams": [...] } ... ] }
  • API推送失败提醒 用户只有在自动化规则选了API推送,且开启了推送失败提醒,当推送失败,消息中心会收到提醒信息。 自动化规则API推送失败提醒示例: 尊敬的{accountName}客户, 您好!您配置的自动化规则{ruleName},在{pushTime}执行API推送时失败,推送地址: {pushUrl},推送内容请查看附件。 本邮件由华为全球SIM联接系统自动发送,请勿直接回复! 感谢您的配合与支持! 用户如果选择了API推送,并且勾选了“合并发送”,推送的报文与没有勾选“合并发送”的报文不同。 当前流量池周期累计数据用量不支持合并推送。 附件内容为推送失败的报文内容。
  • API推送报文 推送body参数 参数 参数类型 描述 cid string 容器ID。 ruleType int 规则类型: 1:订单管理。 2:用量监控。 3:流量池监控。 4:卡状态变更监控。 templateName string 模板名称: api_rule_price_plan_expired:SIM卡套餐到期模板。 api_rule_flow_usage_remain:周期累计数据用量模板。 api_rule_sim_status_modify:卡状态变更模板。 api_sim_pool_rule_flow_usage_remain:流量池周期累计数据用量模板。 sim_pool_rule_flow_usage:前向流量池邮件发送模板。 sim_pool_rule_flow_usage_remain:前向流量池邮件发送模板。 back_pool_rule_flow_usage:后向流量池邮件发送模板。 api_back_pool_rule_flow_usage:后向流量池周期累计数据用量API推送模板。 templateParams list 模板参数集合,建议按照key值进行解析,后续可能会添加其他key值。 SIM卡套餐到期(api_rule_price_plan_expired) 【全球SIM联接】尊敬的{accountName}客户,您好!{cid}购买的套餐{pricePlanName}将在{daysToExpire}天后过期,请及时续费。 { "cid": "4441380627973120", "ruleType": 1, "templateName": "api_rule_price_plan_expired", "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "poolId", "value": "0" }, { "key": "daysToExpire", "value": "9" } ] } 周期累计数据用量(api_rule_flow_usage_remain) 【全球SIM联接】尊敬的{accountName}客户,您好!您的SIM卡(容器ID:{cid})购买的套餐({pricePlanName})剩余流量已不足{remainFlow}MB,请合理使用,需要避免流量达量断网。 { "cid": "4441380627973120", "ruleType": 1, "templateName": "api_rule_flow_usage_remain", "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "remainFlow", "value": "100" } ] } 卡状态变更(api_rule_sim_status_modify) 【全球SIM联接】尊敬的{accountName}客户,您好!您的SIM卡(容器ID:{cid})状态于{modifyTime}由{oldStatus}变为{newStatus}。 { "cid":"2021080621060000T", "ruleType":4, "templateName":"api_rule_sim_status_modify", "templateParams":[ { "key":"cid","value":"2021080621060000T" }, { "key":"modifyTime","value":"2022-05-16 03:24:08" }, { "key":"oldStatus","value":"未激活" }, { "key":"newStatus","value":"可激活" } ] } 流量池周期累计数据用量(api_sim_pool_rule_flow_usage_remain) 【全球SIM联接】尊敬的{accountName}客户,您好!{poolId}流量池名:{poolName},套餐名称:{pricePlanName},已用流量{remainFlow}MB,请合理使用,需要避免达量断网。 { "cid": "4441380627973120", "ruleType": 1, "templateName": "api_sim_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "remainFlow", "value": "100" } ] } 前向流量池邮件发送模板(sim_pool_rule_flow_usage) 【华为云】尊敬的{Account}客户,您好!您的前向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})已用流量{usageFlow}MB,请合理使用,需要避免流量达量断网。 { "cid": "null", "ruleType": 3, "templateName": "api_back_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国电信消费级阶梯流量池联接服务" }, { "key": "usageFlow", "value": "100" } ] } 前向流量池邮件发送模板(sim_pool_rule_flow_usage_remain) 【华为云】尊敬的{Account}客户,您好!您的前向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})剩余流量{remainFlow}MB,请合理使用,需要避免流量达量断网。 { "cid": "4441380627973120", "ruleType": 1, "templateName": "api_sim_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "remainFlow", "value": "100" } ] } 后向流量池邮件发送模板(back_pool_rule_flow_usage) 【华为云】尊敬的{Account}客户,您好!您的后向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})已用流量{usageFlow}MB,请合理使用,避免产生过量的费用。 { "cid": "null", "ruleType": 3, "templateName": "api_back_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国电信消费级阶梯流量池联接服务" }, { "key": "usageFlow", "value": "100" } ] } 后向流量池周期累计数据用量API推送模板(api_back_pool_rule_flow_usage) 【华为云】尊敬的{Account}客户,您好!您的后向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})已用流量{usageFlow}MB,请合理使用,避免产生过量的费用。 { "cid": "null", "ruleType": 3, "templateName": "api_back_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国电信消费级阶梯流量池联接服务" }, { "key": "usageFlow", "value": "100" } ] }
  • 简介 实体卡是真实的、实际存在的物质卡,是指可以放到设备里进行使用的硬件芯片,也是用户识别卡,它存储着用户的数据、鉴权方法和密码,可供系统对用户的身份进行鉴别。同时,用户通过它完成与系统的连接和信息的交换。 当前全球SIM联接的实体卡包括消费级和工业级两种。主要使用场景如下: 消费级卡:普通塑料等材质,适用于普通消费使用场景。 工业级卡:注塑、陶瓷等材质,面对需要特殊环境中使用的场景,工业级卡有耐高温、防潮湿、抗震动、抗腐蚀、抗电磁干扰、使用寿命长等优势。 普通消费级卡与工业级卡的区别如下: 产品指标 消费级卡 工业级卡 产品形态 插拔卡 贴片卡 插拔卡 贴片卡 封装材料 ABS或PVC ABS或PVC 工业塑料或陶瓷 工业塑料或陶瓷 耐高低温 -25℃~85℃ -25℃~85℃ -40℃~105℃ -40℃~105℃ 抗震动 5Hz~500Hz 20Hz~2,000Hz 5Hz~500Hz 20Hz~2,000Hz 使用寿命 10万次 10万次 50万次 50万次 全球SIM联接服务支持的实体卡类型如下: 类型 说明 消费级 消费级实体卡包括消费级插拔大卡、消费级插拔双切卡、消费级插拔三切卡和消费级贴片卡四种类型: 消费级插拔大卡:支持普通SIM卡(2FF)。 消费级插拔双切卡:支持普通SIM卡(Mini-SIM)和Micro-SIM卡,不支持Nano-SIM卡。 消费级插拔三切卡:同时支持普通SIM卡(Mini-SIM)、Micro-SIM卡和Nano-SIM卡。 消费级贴片卡:支持(5mm*6mm)贴片卡、(2mm*2mm)贴片卡,可焊接在设备上。 工业级 工业级实体卡包括工业级插拔大卡、工业级插拔双切卡和工业级贴片卡三种类型: 工业级插拔大卡:支持普通SIM卡(2FF)。 工业级插拔双切卡:支持普通SIM卡(Mini-SIM)和Micro-SIM卡,不支持Nano-SIM卡。 工业级贴片卡:支持(5mm*6mm)贴片卡、(2mm*2mm)贴片卡,可焊接在设备上。 父主题: 实体卡
  • 实体卡订单续费 选择需要续费的订单。 登录全球SIM联接控制台,单击左侧“订单及续费管理”菜单,进入订单管理页面,勾选出需要续费的单个或多个订单,单击页面上方的“续费”,进入续费操作页面。 如果在复选框勾选了多个订单,则按照指定订单中满足续费条件的订单续费;如果不选择订单,则对所有订单中满足续费条件的订单续费。 若所选订单中包含不支持续费的批次号(仅卡类型为实体卡,订单状态为已完成,订单类型为新购或卡转移,未组后向流量池的订单支持续费),系统会为您自动过滤掉。 续费时,若勾选订单,则勾选的订单数量不能超过10个;若不勾选订单,则系统自动选择满足续费条件的所有订单(订单的数量不能超过50个,否则无法进行后续操作)。 选择操作方式。 当不选择订单时,单击“续费”,可对用户所有满足续费条件且包含可续费卡的订单进行续费。 操作方式为“订单”,即按订单续费。 操作方式为“文件”,即按实体卡续费,表示对订单下满足条件的特定实体卡进行续费。“下载可续费卡”可以获取可续费卡的容器ID,可自行删减数据。 修改excel文件后上传。 操作方式为“30天到期”、“60天到期”或“90天到期”。根据标签和SIM卡状态设置筛选条件,以筛选订单下满足条件,且在30/60/90天内到期的特定实体卡进行续费。 当选择订单续费时,会带入续费订单批次号,给所选择的订单进行续费,系统会过滤掉不满足续费条件的订单。操作方式可选择按“订单”、“文件”、“30天到期”、“60天到期”或“90天到期”。 按订单 按文件 按“30天到期”、“60天到期”或“90天到期” 确认续费订单信息。 单击“确定”,进入“订单确认”页面,可以选择订单的购买时长。确认续费订单详情是否正确。 如有疑问,请联系华为工程师处理。 完成订单支付。 订单信息确认完成后,单击“去支付”,进入支付页面,完成订单支付。 跟踪续费订单状态至完成即可。 在订单管理页面,通过单击批次号,进入订单详情页面,可以查看本次续费涉及的SIM卡列表(当前仅当订单已经审核通过后才会展示)。
  • 管理自定义属性 自定义属性添加后,您也可以根据实际需求停用、启用或修改已添加的自定义属性。 登录全球SIM联接控制台。 在左侧导航树中选择“自定义属性”,进入“自定义属性”页面。 请根据实际需求选择以下操作。 停用自定义属性 若您需要停用某个自定义属性,可以在需要停用的自定义属性行单击“停用”。当“状态”变为“停用”时,表示自定义属性停用成功。 启用自定义属性 若您需要将某个已停用的自定义属性重新启用,可以在需要启用的自定义属性行单击“启用”。当“状态”变为“已启用”时,表示自定义属性启用成功。 修改自定义属性 若您需要修改某个自定义属性,可以在需要修改的自定义属性行单击“修改”。在弹出的“修改自定义属性”对话框中设置自定义属性名称,单击“提交”即可。 自定义属性名称支持输入32位以内的字符,只能包含数字、英文字母、下划线、中划线和中文,且不能与之前的自定义属性名称重复。
  • 前向流量池组池 创建流量池 在前向流量池管理页面,单击左上角“创建流量池”,可选择未组池的实体卡订单创建前向流量池,创建成功后,订单中的卡就组成了一个前向流量池,可以共享流量。 选择多个订单时,要求是同一运营商同一档位的套餐,单击确定后,会创建业务受理单,业务受理时限为5个工作日内。 已有流量池加入新成员 在前向流量池管理页面,单击指定前向流量池订单右侧的“新增成员”,可以将未组池的实体卡订单加入到现有前向流量池中,系统会自动过滤掉和选定流量中卡不同套餐的订单,只可选择相同套餐的订单加入。 温馨提示: 多个订单组成一个前向流量池的场景,需要确保这些订单是相同运营商、相同流量类型以及相同套餐。 组池成功与否取决于运营商套餐和 定价 策略,如果运营商套餐和定价有变,则会组池失败。 组池成功后,最迟次月生效。 测试卡不支持组建前向流量池。 中国电信卡仅支持购卡时组建前向流量池。 因平台切换,新购中国移动实体卡订单无法加入2021年8月17号之前的前向流量池中。 中国移动、中国联通卡因运营商政策限制,购买后基本不支持再组池,建议在购买时选择组池。 如果组池失败请联系华为工程师沟通处理。 因平台切换,新购中国联通实体卡订单无法加入2024年8月1日之前的前向流量池中。 因平台切换,新购中国电信实体卡订单无法加入2024年8月1号之前的前向流量池中。
共100000条