华为云用户手册

Cluster集群实例受限使用的Redis命令 表1 Cluster集群实例受限使用的Redis命令 命令类型 命令描述 Set（集合） SINTER 返回一个集合的全部成员，该集合是所有给定集合的交集 SINTERSTORE 类似SINTER，但结果保存到destination集合 SUNION 返回一个集合的全部成员，该集合是所有给定集合的并集 SUNIONSTORE 和SUNION类似，但它将结果保存到destination集合 SDIFF 返回一个集合的全部成员，该集合是所有给定集合之间的差集 SDIFFSTORE 和SDIFF类似，但它将结果保存到destination集合 SMOVE 将member元素从source集合移动到destination集合 SortedSet（有序集合） ZUNIONSTORE 计算给定的一个或多个有序集的并集 ZINTERSTORE 计算给定的一个或多个有序集的交集 HyperLogLog PFCOUNT 返回储存在给定键（或多个键）的HyperLogLog的近似基数 PFMERGE 将多个HyperLogLog合并（merge）为一个HyperLogLog Keys（键） RENAME 将key改名 RENAMENX 将key改名，新key必须是之前不存在的 BITOP 对一个或多个保存二进制位的字符串key进行位元操作，并将结果保存到destkey上 RPOPLPUSH 返回并移除存储在source的列表的最后一个元素（列表尾部元素）， 并把该元素放入存储在destination的列表的第一个元素位置（列表头部） String（字符串） MSETNX 同时设置一个或多个key-value对

Proxy集群多Key命令说明 表3 Proxy集群多Key命令说明 类型 命令 支持跨slot的多Key命令 DEL、MGET、MSET、EXISTS、SUNION、SINTER、SDIFF、SUNIONSTORE、SINTERSTORE、SDIFFSTORE、ZUNIONSTORE、ZINTERSTORE 不支持跨slot的多Key命令 SMOVE、SORT、BITOP、MSETNX、RENAME、RENAMENX、BLPOP、BRPOP、RPOPLPUSH、BRPOPLPUSH、PFMERGE、PFCOUNT、BLMOVE、COPY、GEOSEARCHSTORE、LMOVE、ZRANGESTORE

示例 以下示例中出现的费用价格仅供参考，实际价格请参见产品价格详情中“ 对象存储服务 ”的内容。 示例一：某用户的标准存储单AZ桶中的数据为2.8TB，于3月18日购买了容量为2TB的标准存储单AZ资源包A，又于3月25日购买了容量为1TB的资源包B，则3月18日-4月18日间，占用资源包A的容量为2TB，占用资源包B的容量为0.8TB。4月18日资源包A过期，如不续订，4月18日-4月25日间，占用资源包B的容量为1TB，剩余1.8T数据将使用账户余额进行按需计费。

购买说明 在购买一个资源包后，可继续购买除特价体验资源包外的任意规格资源包。40GB存储包和50GB公网流出流量包为特价体验套餐包，每个用户在同一时间只能分别购买一次，套餐包过期后，才可重复购买，其余规格可任意叠加购买。 叠加购买资源包后，会优先使用原购买资源包的容量。如在购买资源包前，已产生按需扣费，已按需使用的部分不可以使用新购买的资源包进行抵扣。建议您在资源包未到期或容量不足前，及时叠加购买资源包或进行资源包升配。

计费公式 费用的计算公式为：费用=实际资源使用量*资源单价 按需计费模式下各计费项的具体价格，请参见产品价格详情。你可以通过OBS提供的价格计算器，根据您的业务诉求，来快速计算出购买OBS的参考价格。 如果需要计算每小时产生的费用，则需要将资源单价转换为以小时计费。如标准存储（单AZ）单价为0.0990元/GB/月，则每小时的单价为：0.0990元/GB/月*(1/24)*(1/30)=0.0001375元/GB/小时。示例中出现的费用价格仅供参考，实际价格请参见产品价格详情中“对象存储服务”的内容。

适用计费项 以下计费项支持按需计费。 表1 按需计费说明 计费项 说明 存储费用 标准存储数据容量 OBS中存储的标准存储数据所占用的存储空间容量，区分单AZ存储和多AZ存储。了解单AZ和多AZ的区别 存储时间按照数据在OBS中存储的实际天数计算。 存储单个对象小于64KB按64KB计算，大于64KB按实际大小计算。 低频访问存储数据容量 OBS中存储的低频访问存储数据所占用的存储空间容量，区分单AZ存储和多AZ存储。了解单AZ和多AZ的区别 存储时间小于30天按30天计算，大于30天按实际天数计算。早于30天删除或转换为其他存储类别，需要补足剩余天数的存储费用。费用为一次性收取，收取的费用=低频访问存储的存储空间单价*容量*剩余天数/30。 存储单个对象小于64KB按64KB计算，大于64KB按实际大小计算。 归档存储数据容量 OBS中存储的归档存储数据所占用的存储空间容量。 存储时间小于90天按90天计算，大于90天按实际天数计算。早于90天删除或转换为其他存储类别，需要补足剩余天数的存储费用。费用为一次性收取，收取的费用=归档存储的存储空间单价*容量*剩余天数/30。补足的费用将直接从账户余额中扣除，而不使用资源包进行抵扣。 存储单个对象小于64KB按64KB计算，大于64KB按实际大小计算。 深度归档存储数据容量（受限公测） OBS中存储的深度归档存储数据所占用的存储空间容量。 存储时间小于180天按180天计算，大于180天按实际天数计算。早于180天删除或转换为其他存储类别，需要补足剩余天数的存储费用。 存储单个对象小于64KB按64KB计算，大于64KB按实际大小计算。 请求费用 GET类请求、PUT类请求、生命周期转换请求 GET类请求、PUT类请求、生命周期转换请求的请求次数，包括PUT/POST/COPY/LIST/GET/HEAD等。 流量费用 公网流出流量 通过互联网从OBS下载标准存储类型的数据所产生的流出流量。 恢复低频访问存储、恢复归档存储和深度归档存储类别的对象后，下载该对象产生的公网流出流量，只能按需计费。 说明： 只要通过互联网下载OBS的数据，无论是否成功，均会产生公网的流量。 下载低频访问存储、归档存储和深度归档存储类别的对象产生的公网流出流量，将无法使用公网流出流量包进行抵扣。 跨区域复制流量 使用跨区域复制功能将源桶数据复制到另一个区域的目标桶时所产生的流出流量。 CDN回源流量 通过华为云CDN下载OBS 3.0的桶中数据时所产生的回源流量。（下载OBS 2.0的桶中数据走公网流出流量，可用公网流出流量包抵扣） 数据恢复费用 数据读取流量 访问低频访问存储类别的对象时，会根据对象大小产生额外的数据恢复费用。 访问归档存储类别的对象时，会根据对象大小和设置的恢复速度级别产生额外的数据恢复费用。 访问深度归档存储类别的对象时，会根据对象大小和设置的恢复速度级别产生额外的数据恢复费用。 此项费用不管通过内、外网访问均会产生；如果使用外网访问，则会同时计入到公网流出流量费用。 归档存储数据恢复后，会产生一个标准存储类别的对象副本，在恢复的有效期内，会同时收取这份数据在标准存储和归档存储中的存储费用，有效期到期后副本自动删除。其中，标准存储类别对象副本在整个有效期内的存储费用会在恢复时一次性扣除。 低频访问存储数据恢复和归档存储直读功能不产生对象副本，不会产生标准存储的存储费用。 开启归档数据直读后，下载和拷贝归档存储对象均会产生数据读取流量。 说明： 重复恢复归档存储数据时，分为以下两种情况： 延长有效期：在延长恢复有效期的同时，也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类别的对象副本有效期将会延长，并且收取延长时间段产生的标准存储副本费用。 缩短有效期：将会报错，错误码为409 ObjectHasAlreadyRestored。将不会产生恢复费用，也不会新增标准存储类别的对象副本的存储费用。 数据处理费用 图片处理 被处理的原图片的实际大小。 具体请参见图片处理如何收费？

计费周期 系统每小时会统计前一个小时（整点区间，如18:00~19:00）的实际用量，根据实际用量产生话单并结算扣费。例如，在19:30结算的费用一般为18:00~19:00期间产生的费用，也可能存在延迟，即19:30结算的费用也可能为17:00~18:00期间产生的费用。 费用结算的最小时长为1小时，与具体的上传时刻无关。例如在结算18:00~19:00的存储费用时，无论对象是在18:00~19:00之间哪个时刻上传的，都以存储时长为1小时结算。

计费示例 以下示例中出现的费用价格仅供参考，实际价格请参见产品价格详情中“对象存储服务”的内容。 假设某用户于2023年7月1日上传了一个10GB低频存储单AZ类型的数据至华北-北京四的 OBS 存储桶，产生了100次请求，第2天08:00-24:00（忙时）读取该数据，产生了100次请求，其余时间无其他操作。 账单是按小时进行结算。 低频存储容量费用：在2023年7月1日0时开始结算。 低频存储数据取回费用：在2023年7月2日结算。 低频存储请求费用：在2023年7月1、2日结算。 公网流出流量费用：在2023年7月2日结算。 由于数据取回费用无适用的资源包，则按照按需计费方式分析如下： 按量计费： 低频存储容量费用 = (0.08元/GB/月 /30天/24小时) * 10GB * 48小时 = 0.053元 低频存储数据恢复费用 = 0.0325元/GB * 10GB = 0.325元 低频存储请求费用 = 0.05元/万次 * (100次/10000次) * 2 = 0.001元 公网流出流量费用 = 0.5元/GB * 10GB = 5元（忙时费用） 综合上面分析得出，整个7月用户 B 总花费0.053元 + 0.325元 + 0.001元 + 5元 = 5.379元。

计费说明 资费项 计费项 含义 适用的计费模式 数据恢复费用 数据读取流量 访问低频访问存储类别的对象时，会根据对象大小产生额外的数据恢复费用。 访问归档存储类别的对象时，会根据对象大小和设置的恢复速度级别产生额外的数据恢复费用。 访问深度归档存储类别的对象时，会根据对象大小和设置的恢复速度级别产生额外的数据恢复费用。 此项费用不管通过内、外网访问均会产生；如果使用外网访问，则会同时计入到公网流出流量费用。 归档存储数据恢复后，会产生一个标准存储类别的对象副本，在恢复的有效期内，会同时收取这份数据在标准存储和归档存储中的存储费用，有效期到期后副本自动删除。其中，标准存储类别对象副本在整个有效期内的存储费用会在恢复时一次性扣除，扣除方式可以按需，也可以从资源包中抵扣。 低频访问存储数据恢复和归档存储直读功能不产生对象副本，不会产生标准存储的存储费用。 开启归档数据直读后，下载和拷贝归档存储对象均会产生数据读取流量。 说明： 重复恢复归档存储数据时，分为以下两种情况： 延长有效期：在延长恢复有效期的同时，也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类别的对象副本有效期将会延长，并且收取延长时间段产生的标准存储副本费用。 例如：您在昨天执行了一次恢复操作，有效期设置为7天，在今天同一时间又执行了一次恢复操作，有效期设置为8天，那么该归档存储对象的有效期为8天，收取的费用包含：两次恢复的费用，以及一个标准存储对象副本9天的费用。 缩短有效期：将会报错，错误码为409 ObjectHasAlreadyRestored。将不会产生恢复费用，也不会新增标准存储类别的对象副本的存储费用。 按需计费

操作步骤 在OBS管理控制台左侧导航栏选择“资源包管理”。 选择需要升配的资源包所属区域和类型。 在操作栏单击“升配”，进入资源包升配页面，如图1所示。 医疗影像单AZ存储包不支持升配。 如果资源包规格已经是最高级别，支持进入升配操作页面，但仅支持查看不支持选择规格进行升配。 正在升配中的资源包不支持进行再次升配操作。 如果资源包在1个小时后到期，资源包不支持升配。 图1 选择“升配”操作 配置升配后的规格。 在升配规格区单击变更后的规格。下方展示升配后的资源包规格信息。如图2所示。 选择资源包变更后的规格时，仅支持选择大于当前规格的规格。 资源包升配不支持批量操作。 图2 资源包升配页面 单击右下角“立即购买”。 查看并确认升配信息，单击“去支付”，并在支付页面完成付款。 资源包升配成功，资源包类型、起止时间（有效期）不变。 资源包升配后，原资源包继续生效，下一重置周期（按整点重置）新资源包才会生效。例如：在9点45分升配资源包，10点整新资源包升配成功并生效。 在升配订单未完成前，继续升配相同规格，规格补交费用为0。例如：你原来的资源包为100GB，你升配到了500GB，但后台处理完这个升配需求大概需要10~30秒的时间，在此期间，如果你继续升配，并升配到相同的500GB，这时候规格补交费用为0。 支持资源包到期当天进行升配，可升配到最大规格且规格补交费用为0。但支持升配时间将在当晚23：00截止，最后一小时不允许升配。 如果升配未生效的资源包，则升配操作立即生效，但该资源包依然处于未生效状态。 如果您的包月资源包进行了升配，赠送的请求次数也会进行升级。剩余请求次数＝升配后的请求次数-原来已使用的请求次数。 如果您升配的资源包是流量包，剩余的容量＝升配后的容量-原来已消耗的容量。 图3 支付规格补交费用

约束与限制 以下情况暂不支持资源包升配： 资源包类型为医疗影像单AZ存储包 资源包规格已经是最高级别 资源包正在升配中 在1个小时后资源包到期 资源包支持升配的规格为： 资源包类型相同 升配后的规格大于当前规格 起止时间（有效期）不变 资源包升配不支持批量操作。 资源包升配后，原资源包继续生效，下一重置周期（按整点重置）新资源包才会生效。例如：在9点45分升配资源包，10点新资源包生效。 如果升配未生效的资源包，则升配操作立即生效，但该资源包依然处于未生效状态。

资源包说明 您也可以通过包年包月（资源包）的方式，提前购买使用额度和时长，获取更多的优惠。超出资源包的部分自动转按需计费。如何购买资源包？ 对象存储服务暂不支持退订资源包，建议您在购买资源包前提前规划资源的使用额度和时长。 对象存储服务资源包仅支持抵扣资源包购买后产生的费用，不支持抵扣资源包购买前产生的费用。例如，某用户有500GB文件存储在华北-北京四的OBS桶中，存储类别为单AZ标准存储。该用户于2023年6月30日购买了华北-北京四的单AZ标准存储资源包，资源包于购买当天生效。那么2023年6月30日前该500GB文件存储产生的存储费用不能用资源包抵扣，2023年6月30日后该500GB文件存储产生的存储费用可以用资源包抵扣。 购买包月的标准存储包（时长小于1年），会同时赠送读写请求次数。 购买包年的标准存储包（时长大于等于1年），其存储费用相比包月更加优惠，故不再赠送读写请求次数。此时，读写请求将根据实际使用情况进行按需计费。如希望赠送读写请求次数，建议选择包月的标准存储包。 OBS提供的资源包如表1所示，各资源包在不同规格及时长下的具体价格，请参见产品价格详情。你可以通过OBS提供的价格计算器，根据您的业务诉求，来快速计算出购买OBS的参考价格。 表1 包年包月资源包说明 资源包 作用 使用限制 标准存储包（单AZ） 用于抵扣单AZ桶产生的标准存储数据容量费用。 只适用于单AZ桶产生的标准存储数据容量计费，且只能用于资源包所属区域。 标准存储包（多AZ存储） 用于抵扣多AZ桶产生的标准存储数据容量费用。 只适用于多AZ桶产生的标准存储数据容量计费，且只能用于资源包所属区域。 归档存储包 用于抵扣归档存储类别的数据存储容量费用。 只能用于资源包所属区域。归档存储数据均以单AZ模式存储。 公网流出流量包 用于抵扣通过互联网从OBS下载标准存储类型的数据到本地所产生的公网流出流量费用。 只能用于资源包所属区域。单AZ和多AZ桶通用。 恢复低频访问存储和恢复归档存储类别的对象后，下载该对象产生的公网流出流量，将无法使用公网流出流量包进行抵扣，只能按需计费。 回源流量包 用于抵扣使用OBS作为华为云 CDN加速 域名源站时，CDN向源站OBS获取文件产生的回源流量费用。 只适用于OBS 3.0的桶，且只能用于资源包所属区域。单AZ和多AZ桶通用。 仅以下两种情况才能使用回源流量包： 通过OBS控制台绑定用户加速 域名 。 通过CDN控制台添加加速域名，并选择“源站类型”为“OBS桶域名”。 使用第三方云厂商的CDN获取华为云OBS的文件产生的回源流量无法使用回源流量包进行抵扣。 跨区域复制流量包 用于抵扣通过跨区域复制功能将源桶数据复制到另一个区域的目标桶时所产生的流出流量费用。 只适用于OBS 3.0的桶，且只能用于资源包所属区域（复制起点区域）。例如：您从区域A将源桶数据复制到区域B的目标桶，那么用于抵扣费用的是区域A的流量包。 单AZ和多AZ桶通用。 医疗影像单AZ存储包 用于抵扣桶类型为标准存储、数据冗余存储策略为单AZ的医疗影像专属存储容量。 只适用于单AZ标准存储桶产生的医疗影像数据容量计费，且只能用于资源包所属区域。 购买时长仅支持指定15年。15年时长的存储资源包由于系统原因将会分为3个5年时长的资源包，但不影响使用，即0-5年时使用第一个5年资源包，以此类推。 OBS提供的以下资源包也同时支持并行文件系统： 表2 并行文件系统资源包说明 资源包 作用 使用限制 标准存储包（单AZ） 用于抵扣单AZ并行文件系统产生的标准存储数据容量费用。 只适用于单AZ并行文件系统产生的标准存储数据容量计费，且只能用于资源包所属区域。 标准存储包（多AZ） 用于抵扣多AZ并行文件系统产生的标准存储数据容量费用。 只适用于多AZ并行文件系统产生的标准存储数据容量计费，且只能用于资源包所属区域。 归档存储包 用于抵扣归档存储类别的数据存储容量费用。 只能用于资源包所属区域。归档存储数据均以单AZ模式存储。 公网流出流量包 用于抵扣通过互联网从并行文件系统下载标准存储类型的数据到本地所产生的公网流出流量费用。 只能用于资源包所属区域。单AZ和多AZ通用。

资源包抵扣顺序 抵扣顺序原则 当购买了多个相同属性的资源包，会按照资源包过期时间顺序进行抵扣，优先抵扣过期时间近的资源包。 示例 场景 某客户分别购买了两个华北-北京四区域的标准存储包（多AZ） 资源包A：规格100GB，2020年10月1日生效，购买时长2个月，即12月1日过期。 资源包B：规格500GB，2020年10月10日生效，购买时长2个月，即12月10日过期。 抵扣顺序 10月1日~10月9日 只有资源包A生效。 使用资源包A抵扣，超出100GB部分按需计费。 10月10日~11月30日 资源包A、B同时生效，叠加使用。 优先使用资源包A抵扣，超出100GB部分使用资源包B抵扣，超出600GB部分按需计费。 12月1日~12月9日 资源包A过期，只有资源包B生效。 使用资源包B抵扣，超出500GB部分按需计费。 12月10日~ 资源包A、B均已过期，此时为按需计费。

共享版及企业版对比 容器镜像服务 目前有共享版和企业版。差异如下： 表1 容器 镜像服务 共享版和容器镜像服务企业版对比表 大类 功能项 共享版 企业版 通用 页面入口 登录华为云控制台，单击服务列表，搜索“容器镜像服务”，单击进入的是共享版容器镜像服务。 在共享版容器镜像服务页面单击“企业版”链接，进入的则是企业版容器镜像服务 是否收费 否 是 制品托管 容器镜像 √ √ 镜像管理 标签管理 × √ 支持的制品类型 Docker Image Manifest V2 Schema 2 (与 Docker 版本 1.10 和更新版本配合使用) Docker Image Manifest V2 Schema 2 (与 Docker 版本 1.10 和更新版本配合使用) Open Container Initiative（OCI）规范（v1.0 和 v1.1） 单个镜像老化 √ √ 批量镜像老化 × √ 触发器支持触发用户自定义的请求(http/https) × √ 镜像分发 共享私有镜像 √ × 自动同步单个镜像 √ √ 自动同步批量镜像 × √ 镜像安全 镜像签名 × √ 镜像版本不可变 × √ 访问管理 网络访问控制 × √ 自定义域名 × √ 企业版目前支持“华东-上海一、华北-乌兰察布一、华北-北京四、亚太-新加坡、华南-广州、西南-贵阳一、华东二、中国-香港、中国-约翰内斯堡”区域。

SWR权限 默认情况下，管理员创建的 IAM 用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 SWR部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如中国-香港）对应的项目（ap-southeast-1）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问SWR时，需要先切换至授权区域。 表1 SWR共享版权限 名称 描述 类型 SWR Admin 容器镜像服务的管理员权限，拥有该服务下的所有权限。 系统角色 Tenant Administrator 除IAM服务外，其他所有服务的管理员权限，拥有容器镜像服务下的所有权限。 系统角色 ServiceStage Developer 应用管理与运维平台（ServiceStage）开发者，拥有容器镜像服务下载镜像等权限。 系统角色 表2 SWR企业版权限 名称 描述 类型 SWR FullAccess 容器镜像仓库所有权限 系统策略 SWR OperateAccess 容器镜像仓库操作权限 系统策略 SWR ReadOnlyAccess 容器镜像仓库只读权限 系统策略 在容器镜像服务中进行授权管理，可以添加对某个镜像或组织中所有镜像的读取、编辑或管理权限。 除以上权限外，SWR的权限还有SWR FullAccess、SWR OperateAccess、SWR ReadOnlyAccess。但SWR FullAccess、SWR OperateAccess、SWR ReadOnlyAccess仅限容器镜像服务企业版使用，目前企业版已暂停公测。非企业版用户暂不支持使用此权限。

URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/jobs/{job_id}/status?offset=offset&limit=limit 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 job_id 是 String Job ID。 offset 否 Integer 本次查询偏移量，默认为0。 limit 否 Integer 本次查询返回最大数量(最大100000)，默认为100000。

响应示例 状态码： 200 成功响应示例 Http Status Code: 200 { "data": { "outputs": { "data_return_size": 2, "vertices": [ { "id": "Sarah", "label": "user", "properties": { "Occupation": [ "other or not specified" ], "Name": [ "莎拉" ], "Zip-code": [ "55105" ], "Gender": [ "F" ], "Age": [ "18-24" ] } }, { "id": "Sidney", "label": "user", "properties": { "Occupation": [ "writer" ], "Name": [ "西德尼" ], "Zip-code": [ "85296" ], "Gender": [ "M" ], "Age": [ "18-24" ] } } ], "data_offset": 0, "data_total_size": 19 } }, "status": "success" }

响应参数 表2 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 status String 查询成功时返回任务状态，包括以下四种状态： pending：等待中。 running：运行中。 success：成功。 failed：失败。 查询失败时字段为空。 data Object 算法运行的结果。查询失败时字段为空。 表3 data参数说明 参数 类型 说明 vertices List 点上关联的算法结果。 edges List 边上关联的算法结果。 outputs Object 其他输出结果。 data_return_size Integer 本次查询返回结果数量。 data_offset Integer 本次查询返回结果偏移量。 data_total_size Integer 异步任务产生的结果数据总量。

响应示例 状态码： 200 OK { "graph": { "id": "f1529b88-c958-493e-8452-fccfe932cde1", "name": "demo", "regionCode": "cn-north-1", "azCode": "cn-north-1a", "schemaPath": [ { "path": "ges-graphs/demo_movie/schema.xml", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "edgesetPath": [ { "path": "ges-graphs/demo_movie/edge.csv", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "vertexsetPath": [ { "path": "", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "status": "200", "graphSizeTypeIndex": "1", "vpcId": "2d8af840-fd57-4e3b-a8f1-cda0f55ccd99", "subnetId": "dc018ec3-67d1-46c9-b2fc-19d83367f4e2", "securityGroupId": "11d27338-8649-4076-8579-5ebc1a60f79e", "created": "2018-07-23T04:09:44", "privateIp": "192.168.0.4", "publicIp": "49.4.81.183", "dataStoreVersion": "1.0.5", "arch": "x86_64" } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 schema_count Integer 元数据返回个数。请求失败时，字段为空。 schema_list Array of schema_list objects 当前project_id下的所有元数据列表。请求失败时，字段为空。 表5 schema_list 参数 参数类型 描述 id String 元数据 ID。 name String 元数据名称。 start_time String 元数据创建时间。 last_update_time String 元数据最后更新时间。 encrypted Boolean 元数据是否加密。 master_key_name String 秘钥名称。 master_key_id String 秘钥id。 description String 元数据 描述。 metadata_path String 元数据对应路径。 status String 元数据是否可用。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 error_msg String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。

响应示例 状态码： 200 成功响应示例 { "schema_count" : 2, "schema_list" : [ { "start_time" : "2022-01-21T10:13:31", "last_update_time" : "2022-01-21T10:13:31", "encrypted" : true, "master_key_name" : "Autouse_No_Delete", "name" : "schema_748e", "master_key_id" : "106be30a-733d-45d0-84f3-1c5439381313", "description" : "xxxxx", "id" : "6634c50e-13aa-4395-8088-6b327f7da694", "metadata_path" : "devdata/schema_748e.xml", "status" : "200" }, { "start_time" : "2022-04-12T03:15:17", "last_update_time" : "2022-11-16T08:18:32", "encrypted" : false, "name" : "unionsdk_schema", "id" : "6b74069d-3cf3-4cc0-9118-2478e23b87aa", "metadata_path" : "devdata/unionsdk/unionsdk_schema.xml", "status" : "200" } ] } 状态码： 500 失败响应示例 { "error_code" : "GES.7006", "error_msg" : "The underlying graph engine has internal error." }

响应示例 状态码： 200 成功响应示例 { "project_id": "xxx", "id": "xxxxx", "name": "baiwan_demo", "timestamp": 1699506387592, "node_metrics": [ { "overview": { "network_io_rate": 2.99, "role": "slave", "disk_io_write": 107.23, "mem_cached": 2.57, "cpu_usage_usr": 7.15, "cpu_usage_sys": 3.07, "disk_io_read": 3.03, "ges_instance_name": "baiwan_demo-ges-cn-cn-2-1", "disk_used": 5.48, "swap_total": 0, "mem_buffer": 192.5, "disk_available": 144.47, "cpu_iowait": 0.17, "cpu_idle": 89.61, "mem_total": 15.15, "instance_id": "xxxxxxxx", "mem_usage": 7.22, "disk_total": 149.95, "host_stat": 200, "mem_free": 11.29, "swap_free": 0, "cpu_usage": 10.22, "disk_usage_avg": 3.65, "work_ip": "172.16.25.224", "host_name": "baiwan_demo-ges-cn-cn-2-1" }, "disk_details": [ { "svctm": 0, "total": 50, "util": 0.61, "write_rate": 96.48, "disk_name": "vda", "disk_type": "system", "used_percentage": 0.09, "available": 45.68, "await": 18.16, "read_rate": 2.99, "used": 4.32 } ], "network_details": [ { "send_rate": 0.05, "packets_drop": 0, "packets_recv": 1001419, "packets_send": 342518, "interface_name": "eth0", "recv_rate": 0.06, "status": 1 } ] } ], "performance_metrics": { "tomcat_connections_usage": 0, "network_io_rate": 3.11, "swap_disk_usage": 0, "vertex_capacity": 1200000, "memory_usage": 23.83, "vertex_number": 1071803, "jvm_heap_usage": 0.23, "edge_capacity": 1200000, "read_waiting_queue_length": 0, "disk_io_rate": 0, "qps": 0, "write_running_queue_length": 0, "write_waiting_queue_length": 0, "disk_usage": 1.77, "edge_number": 1200000, "edge_usage": 100, "cpu_usage": 9.23, "read_running_queue_length": 0, "vertex_usage": 89.32 } } 状态码： 400 失败响应示例 Http Status Code: 400 { "errorMessage": "query metrics error.", "errorCode": "GES.8602" }

URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/om/metrics?real_time=&with_performance_metrics= 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID，获取方法请参见获取项目ID。 graph_name 是 String 图名称。 real_time 否 Boolean 是否查询实时监控指标，取值为true或者false，默认为false。 false：会查询图实例2分钟内的指标。 true：会查询实时监控指标，请求响应在3-5秒之间。 with_performance_metrics 否 Boolean 是否查询性能指标，会返回图实例性能指标和各个节点的指标。取值为true或者false，默认为true，如果设置为true，只返回节点的指标，响应时间会减少1-2秒。

响应示例 状态码： 200 成功响应示例 { "backup_count" : 3, "backup_list" : [ { "id" : "ada3e720-ab87-48cb-bff7-3ec5ae1a9652", "name" : "ges060803_nodelete-20210608135513", "backup_method" : "manual", "graph_id" : "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name" : "ges060803_nodelete", "graph_status" : "200", "graph_size_type_index" : "1", "data_store_version" : "2.2.21", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623160513000, "start_time" : "2021-06-08T13:55:13", "end_timestamp" : 1623160568000, "end_time" : "2021-06-08T13:56:08", "size" : 1, "duration" : 54, "encrypted" : false }, { "id" : "7ed3f51d-816d-4651-9129-fe21b64b5c91", "name" : "ges060803_nodelete_20210609203323_auto", "backup_method" : "auto", "graph_id" : "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name" : "ges060803_nodelete", "graph_status" : "200", "graph_size_type_index" : "1", "data_store_version" : "2.2.21", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623242004000, "start_time" : "2021-06-09T12:33:24", "end_timestamp" : 1623242004000, "end_time" : "2021-06-09T12:33:24", "size" : 1, "duration" : 0, "encrypted" : false }, { "id" : "604bfb46-04dd-45fc-a9ae-df24a0705b9d", "name" : "ges060802_nodelete-20210608135523", "backup_method" : "manual", "graph_id" : "9b9a05c2-0cdb-41ac-b55f-93caffb0519a", "graph_name" : "ges060802_nodelete", "graph_status" : "400", "graph_size_type_index" : "0", "data_store_version" : "2.2.23", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623160524000, "start_time" : "2021-06-08T13:55:24", "end_timestamp" : 1623160577000, "end_time" : "2021-06-08T13:56:17", "size" : 1, "duration" : 53, "encrypted" : false } ] } 状态码： 400 失败响应示例 { "error_code" : "GES.7006", "error_msg" : "The underlying graph engine has internal error." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 backup_count Integer 备份总个数。请求失败时，字段为空。 backup_list Array of backup_list objects 当前Project ID下的所有图的备份列表。请求失败时，字段为空。 表5 backup_list 参数 参数类型 描述 id String 备份ID。 name String 备份名称。 backup_method String 备份方法，取值为auto，manual或者import。 graph_id String 备份关联的图ID。 graph_name String 备份关联的图Name。 graph_status String 备份关联的图状态。 graph_size_type_index String 备份关联的图规格。 data_store_version String 备份关联的图版本。 arch String 备份关联的图CPU架构。 status String 备份状态。 backing_up：备份中 success：备份成功 failed：备份失败 start_timestamp Long 备份开始时间戳。 start_time String 备份开始时间。 end_timestamp Long 备份结束时间戳。 end_time String 备份结束时间。 size Long 备份文件大小，单位为MB。 duration Long 备份时间，单位为秒。 encrypted Boolean 是否加密。默认值为"false"，不加密。 true：表示加密。 false：表示不加密。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 error_msg String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。

请求示例 创建一个图，图名称为demo，图规模类型索引为百万边，图实例CPU架构类型为X86 64位架构 ，虚拟私有云ID为2d8af840-fd57-4e3b-a8f1-cda0f55ccd99，子网ID为dc018ec3-67d1-46c9-b2fc-19d83367f4e2，安全组ID为11d27338-8649-4076-8579-5ebc1a60f79e。 POST https://Endpoint/v2/{project_id}/graphs { "graph" : { "name" : "demo", "graph_size_type_index" : "1", "arch" : "x86_64", "vpc_id" : "2d8af840-fd57-4e3b-a8f1-cda0f55ccd99", "subnet_id" : "dc018ec3-67d1-46c9-b2fc-19d83367f4e2", "security_group_id" : "11d27338-8649-4076-8579-5ebc1a60f79e", "public_ip" : { "public_bind_type" : "bind_existing", "eip_id" : "30ef2d58-08a9-4481-b526-b2cbe67d020d" }, "enable_multi_az" : false, "encryption" : { "enable" : true, "master_key_id" : "b00b9356-73fb-4d49-8f79-f0a5da5354d1" }, "sys_tags" : [ { "key" : "_sys_enterprise_project_id", "value" : "54c0b33c-8627-462f-948e-bae08c0887b4" } ], "enable_rbac" : true, "enable_full_text_index" : true, "enable_hyg" : true, "crypt_algorithm" : "generalCipher", "enable_https" : false } }

响应参数 状态码： 200 表11 响应Body参数 参数 参数类型 描述 id String 图ID。 name String 图名称。 状态码： 400 表12 响应Body参数 参数 参数类型 描述 error_msg String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 error_code String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见 获取Token 接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 graph 是 graph object 图类型。 表4 graph 参数 是否必选 参数类型 描述 name 是 String 图名称（输入长度在4位到50位之间，必须以字母开头，可以包含字母、数字或者下划线，不能包含其他的特殊字符）。 graph_size_type_index 是 String 图规模类型索引。 0：一万边 1：百万边 2：千万边 3：一亿边 4：十亿边 5：百亿边 6：持久化版 401：十亿增强边 arch 否 String 图实例CPU架构类型，取值为x86_64和aarch64。默认取x86_64。 x86_64：X86 64位架构。 aarch64：ARM 64位架构。 vpc_id 是 String 虚拟私有云ID。 subnet_id 是 String 指定虚拟私有云下的子网ID。 security_group_id 是 String 安全组ID。 public_ip 否 public_ip object 公网IP地址，如果未指定，则默认不使用公网连接。 enable_multi_az 否 Boolean 创建的图是否支持跨可用区（AZ），默认值是false，如果设置为true，系统将会把图中的E CS 建在两个可用区中。 如果创建图时，不加该参数，则会将图中的ECS都建在一个可用区中。 encryption 否 encryption object 图实例是否加密，默认不加密。 lts_operation_trace 否 lts_operation_trace object 图实例是否开启审计日志，默认不开启。 sys_tags 否 Array of sys_tags objects 企业项目信息，如果未指定则不开启，默认不开启。 tags 否 Array of tags objects 支持标签TMS，做费用归集，默认不开启。 enable_rbac 否 Boolean 创建的图是否启用细粒度权限控制，默认不启用，值为false。如果设置为true，创建的图所有用户都没有权限，需要调用业务面细粒度权限控制API进行授权操作才可以访问图。 enable_full_text_index 否 Boolean 创建的图是否开启全文索引控制，默认不启用，值为false。 如果设置为true，十亿增强版-规格版图支持全文索引，创建图时会创建 云搜索服务 集群。 说明： 开启全文索引功能。如果 CSS 服务已经部署，图实例会自动创建CSS集群，图创建时间较长。如果CSS服务没有部署则图创建失败。 enable_hyg 否 Boolean 该参数只对持久化版规格图生效。 crypt_algorithm 是 String 图实例加密算法，取值为： generalCipher：国密算法 SMcompatible：商密算法（兼容国际） enable_https 是 Boolean 是否开启安全模式，开启安全模式会对性能有较大影响 product_type 否 String 图产品类型，取值为InMemory和Persistence，默认为InMemory，当graph_size_type_index取值为"6"时，默认为Persistence。 InMemory：内存版 Persistence：持久化版 vertex_id_type 否 vertex_id_type object 点的id类型，仅持久化图需要填写。 说明： 点ID类型确定后，将无法更改，请用户谨慎选择! enable_multi_label 否 Boolean 是否启用多标签 。 capacity_ratio 否 Integer 图的容量倍率。该参数只有持久化版百亿规格图支持，且从2.3.18版本后开始支持。 is_dynamic_graph 否 Boolean 是否为动态图。 sort_key_type 否 String 持久化版图数据的sortKey的类型，通过配置不同SortKey的值来区分重复边（源点，终点，Label三者都相同的边），仅持久化图需要填写。取值为： "int"：整型。 "string"：字节长度小于40的字符串。 "varString"：不限长度字符串，过长会影响读写性能，建议长度控制在1K字节以内，最大不要超过2K字节。 表5 public_ip 参数 是否必选 参数类型 描述 public_bind_type 否 String 弹性IP绑定类型，取值如下。 auto_assign：自动绑定。 bind_existing：使用已有。 eip_id 否 String 弹性IP的id，当publicBindType设置为bind_existing时，该值为用户某个已创建但尚未绑定的EIP的ID；当publicBindType设置为auto_assign时，该值设置为空。 表6 encryption 参数 是否必选 参数类型 描述 enable 否 Boolean 是否启动加密特性。取值为“true”或者“false”。默认为“false”。 master_key_id 否 String 与建图对应的project下，华为云 数据加密 服务创建的用户主密钥ID。 表7 lts_operation_trace 参数 是否必选 参数类型 描述 enable_audit 否 Boolean 是否开启图审计，默认“false”。 audit_log_group_name 否 String LTS日志组名称。 表8 sys_tags 参数 是否必选 参数类型 描述 key 否 String 企业项目的key填：_sys_enterprise_project_id。 value 否 String 企业项目的id。可以从企业项目获取。 表9 tags 参数 是否必选 参数类型 描述 key 否 String 标签key value 否 String 标签value 表10 vertex_id_type 参数 是否必选 参数类型 描述 id_type 是 String id类型，目前支持固定长度fixedLengthString和hash。 fixedLengthString：固定长度String格式下，实际点ID直接用于内部存储与计算，用户需指定一长度，实际点ID不可超过此长度。长度过大，可能影响查询性能，建议用户根据数据集状态进行设置。 hash：哈希格式下，内部计算时将实际点ID转换成哈希码进行存储与计算，对实际点ID长度无限制，但是存在极低的概率(约10^(-43))出现点ID碰撞。若用户无法确定点ID的最大长度，建议选择哈希类型。 id_length 否 Integer 当id_type取值为fixedLengthString时必填，取值范围：1-128。

URI GET /v1.0/{project_id}/graphs/{graph_id}/backups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_id 是 String 图ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页资源数量的最大值，默认为10。 offset 否 Integer 本次请求的起始位置，默认为0。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 backupCount Integer 备份总个数。请求失败时，该字段为空。 backupList Array of backup objects 当前Project下指定Graph的备份列表。请求失败时，该字段为空。 表5 backup 参数 参数类型 描述 id String 备份ID。 name String 备份名称。 backupMethod String 备份方法，取值为auto或manual。 graphId String 备份关联的图ID。 graph_name String 备份关联的图Name。 graphStatus String 备份关联的图状态。 graphSizeTypeIndex String 备份关联的图规格。 dataStoreVersion String 备份关联的图版本。 arch String 备份关联的图CPU架构。 status String 备份状态。 backing_up：备份中 success：备份成功 failed：备份失败 startTimestamp Long 备份开始时间戳。 startTime String 备份时间。 endTimestamp Long 备份结束时间戳。 endTime String 备份时间。 size Long 备份文件大小，单位为MB。 duration Long 备份时间，单位为秒。 encrypted Boolean 是否加密。true表示加密，默认值为"false"，不加密。