华为云用户手册

备件出库申请单管理相关操作 在“备件出库申请单管理”页面，您还可以进行如表1所示的操作。 表1 备件出库申请单管理相关操作 操作 描述 查看备件出库申请单 在“备件出库申请单管理”页面，单击备件出库申请单“操作”列的“单据详情”，查看备件出库申请单明细。 查询备件出库申请单 在“备件出库申请单管理”页面，在顶部输入框输入“申请单号”或“申请人”信息，或者选择指定申请单状态、开始申请时间与结束申请时间，再单击“查询”，查询备件出库申请单信息。

备件入库申请单管理相关操作 在“备件入库申请单管理”页面，您还可以进行如表1所示的操作。 表1 备件入库申请单管理相关操作 操作 描述 查看备件入库申请单 在“备件入库申请单管理”页面，单击备件入库申请单“操作”列的“单据详情”，查看备件入库申请单明细。 查询备件入库申请单 在“备件入库申请单管理”页面，在顶部输入框输入“申请单号”或“申请人”信息，或者选择指定申请单状态、开始申请时间与结束申请时间，再单击“查询”，查询备件入库申请单信息。

备件入库申请单审核相关操作 在“备件入库申请单审核”页面，您还可以进行如表1所示的操作。 表1 备件入库申请单审核相关操作 操作 描述 查看待审批备件入库申请单 在“备件入库申请单审核”页面，单击备件入库申请单“操作”列的“单据详情”，查看待审批的备件入库申请单明细。 查询待审批备件入库申请单 在“备件入库申请单审核”页面，在顶部输入框输入“申请单号”或“申请人”信息，或者选择指定开始申请时间与结束申请时间，再单击“查询”，查询待审批的备件入库申请单信息。

服务简介 硬件开发工具链平台云服务（CraftArts IPDCenter）是基于统一数据模型，实现端到端数据管理和协同的平台云服务。CraftArts IPDCenter依托华为产品数字化转型及IPD协同最佳实践，基于统一同源的产品生命周期数据模型，打造围绕产品、面向业务对象的数据管理能力，构建以角色和业务流为中心的数字化协同，提升作业效率和数据质量，助力企业数字化转型。 硬件开发工具链平台云服务目前提供如下服务： IPDCenter基础服务 提供统一产品生命周期数据模型(需求/架构/项目/任务/结构/BOM/仿真/工艺…)、统一产品生命周期角色工程流模板及编排框架，集中调取多系统领域数据，支持企业为产品经理/硬件工程师/互联工程师/结构工程师等各角色设计协同平台，高效跨领域协同。

统一产品生命周期角色工程流模板及编排框架 CraftArts IPDCenter内置华为工程作业流模板，并提供快速复制和编排能力，用户通过简单的拖、拉、拽形成企业自己的工程流，快速沉淀工程知识经验、固化作业流程，能快速、低成本的将线下作业转移到线上，实现在线协同；同时可以集中调取跨领域多系统数据，自定义角色工作桌面，将日常工作固化下来，待办和任务集中管理，让作业人员直达作业现场，避免多系统穿梭作业。 图2 统一生命周期

内置华为IPD的工程实践经验和数据管理经验 内置IPD流程模板：内置IPD核心工程流模板，助力IPD的经验快速在企业落地生根。 工业分类标准：分类架构可扩展、分类属性可配置，实现不同分类Part差异化、精细化管理。 变更闭环：变更影响清晰、变更过程可追溯、变更数据可信、变更执行可落地。 BOM多视图管理：支持同一个编码Early BOM、量产BOM、试制BOM并存，高效转换，做到可追溯、可对比。 物料替代：支持Part层级、BOM层级单双向替代，解决物料升级、停产等问题。 供应商物料管理：多厂商物料归一化管理、多元化柔性供应，质量可追溯，减少客户界面变更。 物料优选等级管理：支持按集团、产业等多维度配置优选策略，实现采购编码归一，提升规模效应。

企业产品数字化转型 企业面对市场需求多样化，生产过程复杂化，产业协作多维化，产品服务数字化，通过数字化技术应对未来世界的不确定性已成为大势所趋。IPD支撑华为持续研发创新和稳定高速发展。 CraftArts IPDCenter作为IPD研发支撑平台核心，是华为产品数字化转型的核心成果，基于元数据理念，围绕产品业务对象进行梳理重构，实现产品全生命周期的数据模型统一，能够满足企业数字化转型的要求。 图1 企业产品数字化转型

Notebook自定义镜像故障基础排查 当制作的自定义镜像使用出现故障时，可能由以下原因导致： 用户自定义镜像没有ma-user用户及ma-group用户组； 用户自定义镜像中/home/ma-user目录，属主和用户组不是ma-user和ma-group； 用户自定义镜像必须满足用户目录/home/ma-user权限为750，不能为其他权限； 用户制作的自定义镜像，在本地执行docker run启动，无法正常运行； 用户自行安装了Jupyterlab服务导致冲突的，需要用户本地使用Jupyterlab命令罗列出相关的静态文件路径，删除并且卸载镜像中的Jupyterlab服务； 用户自己业务占用了开发环境官方的8888、8889端口的，需要用户修改自己的进程端口号； 用户的镜像指定了PYTHONPATH、sys.path导致服务启动调用冲突的，需在实例启动后，再指定PYTHONPATH、sys.path； 用户使用了已开启sudo权限的专属池，使用自定义镜像时，sudo工具未安装或安装错误； 用户使用的cann、cuda环境有兼容性问题； 用户的docker镜像配置错误、网络或防火墙限制、镜像构建问题（文件权限、依赖缺失或构建命令错误）等原因导致； 用户的Anaconda环境中是否出现了以下问题： 在“{python_env}/lib”目录下存在以python开头的非法目录（例如“pythonNone”），正常目录名应该是python+版本号（例如“python3.7”），这可能是由于环境配置错误或意外操作导致的。 用户可能手动在Anaconda环境目录“{conda}/envs”下创建了空目录或在环境的“lib”目录下创建了非法目录，这种操作会破坏Anaconda的目录结构。 用户可能手动清空了某个环境目录内的文件，而这些文件是Anaconda环境所必需的，导致环境无法正常工作。 用户自定义镜像使用远程ssh功能，OpenSSH版本不兼容或低于8.0； 用户使用ssh连接Notebook实例时，同时建立的连接数超过10个，可能会被限制或拒绝连接； 用户修改“/home/ma-user/.ssh”目录权限导致ssh无法使用。解决方法有以下两种，请按需选择： 在制作镜像时直接删除“/home/ma-user/.ssh”目录（用户无需配置ssh，Notebook启动时会自动生成）。 参考以下命令，修改.ssh相关文件权限。 cd /home/ma-user chmod 750 .ssh chmod 644 .ssh/authorized_keys chmod 644 .ssh/config chmod 640 .ssh/environment chmod 750 .ssh/etc chmod 640 .ssh/known_hosts chmod 750 .ssh/var chmod 600 .ssh/etc/ssh_host_rsa_key chmod 640 .ssh/etc/ssh_host_rsa_key.pub chmod 750 .ssh/etc/sshd_config chmod 750 .ssh/var/run/sshd.pid 父主题： 自定义镜像故障

处理方法 排查数据集大小、数据集解压后的大小，checkpoint保存文件大小，是否占满了磁盘空间。具体规格的空间大小可参见训练环境中不同规格资源“/cache”目录的大小 如数据大小已超过/cache目录大小，则可以考虑通过SFS来额外挂载数据盘进行扩容。 将数据和checkpoint保存在/cache目录或者/home/ma-user/modelarts/目录。 检查checkpoint相关逻辑，保证历史checkpoint不会不断积压，导致/cache目录用完。 如文件大小小于/cache目录大小并且文件数量超过50w，则考虑为inode不足或者触发了操作系统的文件索引相关问题。需要： 分目录处理，减少单个目录文件量。 减慢创建文件的速度。如数据解压过程中，sleep 5s后再进行下一个数据的解压。 如果训练作业的工作目录下有core文件生成，可以在启动脚本最前面加上如下代码，来关闭core文件产生。并推荐先在开发环境中进行代码调试。 import os os.system("ulimit -c 0")

原因分析 出现该问题的可能原因如下： 本地数据、文件保存将"/cache"目录空间用完。 数据处理过程中对数据进行解压，导致数据大小膨胀，将"/cache"目录空间用完。 数据未保存至/cache目录或者/home/ma-user/modelarts/目录，导致数据占满系统目录。系统目录仅支持系统功能基本运行，无法支持大数据存储。 部分训练任务会在训练过程中生成checkpoint文件，并进行更新。如更新过程中，未删除历史的checkpoint文件，会导致/cache目录逐步被用完。 实际存储空间足够，却依旧报错“No Space left on device”。可能是inode不足，或者是触发操作系统的文件索引缓存问题，导致操作系统无法创建文件，造成用户磁盘占满。 触发条件和下面的因素有关： 文件名越长，文件数量的上限越小。 blocksize越小，文件数量的上限越小。 blocksize系统默认为4096B，总共有三种大小：1024B、2048B、4096B。 创建文件越快，越容易触发（机制大概是：有一个缓存，这块大小和上面的1和2有关，目录下文件数量比较大时会启动，使用方式是边用边释放）。 程序运行过程中，产生了core文件，core文件占满了"/"根目录空间。

计费示例 假设您在2023/04/18 9:59:30为一台主机开启了按需计费 企业主机安全 企业版防护，然后在2023/04/18 10:45:46关闭防护，则： 第一个计费周期为9:00:00 ~ 10:00:00，在9:59:30 ~ 10:00:00间产生费用，该计费周期内的计费时长为30秒。 第二个计费周期为10:00:00 ~ 11:00:00，在10:00:00 ~ 10:45:46间产生费用，该计费周期内的计费时长为2746秒。 您需要为每个计费周期付费，计费公式如表 计费公式所示。产品价格详情中标出了资源的每小时价格，您需要将每小时价格除以3600，得到每秒价格。 表2 计费公式 资源类型 计费公式 资源单价 防护配额（企业版、容器版、网页防篡改版） 防护配额单价*计费时长 请参见企业主机安全价格详情中的规格单价。 图 按需计费HSS费用计算示例给出了上述示例配置的费用计算过程。 图中价格仅供参考，实际计算请以企业主机安全价格详情中的价格为准。 图1 按需计费企业主机安全费用计算示例

SDK列表 在开始使用之前，请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以在 SDK中心 查询版本信息。 表 SDK列表提供了HSS服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 如果无法正常打开GitHub仓库，请检查您所使用的网络是否可以正常访问公网。由于GitHub的服务器部署在国外，国内用户访问时容易遇到无法打开的情况，请切换网络后再尝试打开。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 NodeJs huaweicloud-sdk-nodejs-v3 NodeJs SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导

Presto多实例 MRS 支持安装Presto多实例，即一个Core/Task节点上安装多个Worker实例，分别为Worker1，Worker2，Worker3… ，多个Worker实例共同与Coordinator交互执行计算任务，相比较单实例，能够大大提高节点资源的利用率和计算效率。 Presto多实例仅作用于ARM架构规格，当前单节点最多支持4个实例。 更多Presto部署信息请参考：https://prestodb.io/docs/current/installation/deployment.html或https://trino.io/docs/current/installation/deployment.html。

入门指引 一、分阶段操作说明 1. 邮箱开通阶段 操作平台：华为云商店管理台 说明：在首次购买华为云 企业邮箱 服务后，下面四步必须配置一次。 2. 邮箱管理阶段 操作平台：华为云商店管理台 + 企业邮箱管理端 说明：该阶段主要为管理员日常管理邮箱开通、邮箱搬迁、创建邮件组、安全管理等操作。除创建员工要到华为云商店管理台外，其他管理功能均在企业邮箱管理端完成； 3. 邮箱使用阶段 操作平台：企业邮箱用户端 说明：该阶段主要为企业员工日常写信、读信、设置客户端登录、员工邮箱搬家等操作。 二、相关操作文档 使用阶段 功能操作 帮助文档 操作平台 邮箱开通 （首次必须） 第一步：企业邮箱购买后开通 开通使用流程 华为云商店管理台 第二步：创建使用企业邮箱服务的企业 创建企业 第三步：将已购的邮箱服务授权给企业 授权企业 第四步：配置邮箱服务使用的 域名 域名配置 添加邮箱管理员 如何添加邮箱管理员？ 邮箱管理 创建企业成员并为其开通邮箱 为成员开通邮箱 企业邮箱管理端登录 邮箱登录地址 企业邮箱管理端 原企业邮箱数据迁移 邮箱搬迁流程 设置员工登录邮箱的IP/IP段 登录限制 设置员工的收发邮件范围 收发限制 邮箱使用 企业邮箱用户端登录 邮箱登录地址 企业邮箱用户端 生成客户端登录密码（客户端登录必需） 第三方客户端绑定专有密码生成 绑定第三方客户端的指导说明 第三方客户端绑定 写信 新建邮件 读信 邮件列表 员工邮箱搬家（管理员开启后） 邮箱搬家 通讯录管理 个人通讯录 日程管理 新建日程

腾讯服务商接入指南 1. 域名注册 域名注册地址https://dnspod.cloud.tencent.com 注册流程参考https://cloud.tencent.com/document/product/242/9595 2. DNS解析设置说明 1) 登录腾讯云DNSPod控制台。 进入域名解析列表。 2) 在在域名列表选择要配置的域名，点击右侧解析。 3) 添加MX记录 点击解析列表左上角添加记录，MX记录如下表，分别添加优先级5、10的两条记录。 记录类型 主机记录 线路类型 邮件服务器 MX优先级 TTL MX @ 默认 mx1.sparkspace.huaweicloud.com 5 600 MX @ 默认 mx2.sparkspace.huaweicloud.com 10 600 腾讯云MX设置1 腾讯云MX设置2 4) 添加SPF记录 添加下表所示的SPF记录 记录类型 主机记录 线路类型 文本内容 TTL TXT @ 默认 v=spf1 include:spf.sparkspace.huaweicloud.com -all 600秒 腾讯云SPF设置 5) 添加CNAME（DKIM）记录 记录类型 主机记录 线路类型 文本内容 TTL CNAME dkim._domainkey 默认 dkim.mail.sparkspace.huaweicloud.com 300秒 父主题： 其他平台域名接入指南

西部数码服务商接入指南 1. 域名注册 域名注册地址https://www.west.cn/services/domain/ 注册流程参考https://www.west.cn/faq/list.asp?unid=837 2. DNS解析设置说明 1）登录域名管理中心，进入域名解析列表。 2）在域名列表选择要配置的域名，点击右侧解析。 3）添加MX、SPF、CNAME记录 点击解析列表上方添加记录，将MX、SPF、CNAME记录填写后保存 MX记录如下表，分别添加优先级5、10的两条记录。 记录类型 主机记录 线路类型 对应值 MX优先级 TTL MX @ 默认 mx1.sparkspace.huaweicloud.com 5 600 MX @ 默认 mx2.sparkspace.huaweicloud.com 10 600 4）添加下表所示的SPF记录 记录类型 主机记录 线路类型 文本内容 TTL TXT @ 默认 v=spf1 include:spf.sparkspace.huaweicloud.com -all 600秒 5）添加CNAME（DKIM）记录 记录类型 主机记录 线路类型 文本内容 TTL CNAME dkim._domainkey 默认 dkim.mail.sparkspace.huaweicloud.com 300秒 父主题： 其他平台域名接入指南

阿里服务商接入指南 1. 域名注册 阿里云域名注册地址：https://wangwang.aliyun.com 注册流程参考通用域名注册流程 2. DNS解析设置说明 1) 登录阿里云解析DNS控制台。 进入域名解析列表。 2) 在域名列表选择要配置的域名，点击解析设置。 3) 添加MX记录 点击解析列表左上角的添加记录，MX记录如下表，分别添加优先级5、10的两条记录。 记录类型 主机记录 解析线路 记录值 MX优先级 TTL MX @ 默认 mx1.sparkspace.huaweicloud.com 5 10分钟 MX @ 默认 mx2.sparkspace.huaweicloud.com 10 10分钟 阿里云MX配置1 阿里云MX配置2 4) 添加SPF记录 添加下表所示SPF记录 记录类型 主机记录 解析线路 记录值 TTL TXT @ 默认 v=spf1 include:spf.sparkspace.huaweicloud.com -all 10分钟 阿里云SPF配置 5) 添加CNAME（DKIM）记录 记录类型 主机记录 解析线路 记录值 TTL CNAME dkim._domainkey 默认 dkim.mail.sparkspace.huaweicloud.com 5分钟 父主题： 其他平台域名接入指南

支持审计的关键操作列表 表1 云审计 服务支持的云服务器操作列表 操作名称 资源类型 事件名称 操作说明 创建直播域名 domain createDomain 创建直播播放域名或推流域名。 删除直播域名 domain deleteDomain 删除域名。 修改直播域名 domain updateDomain 修改播放域名或推流域名。 域名映射 domain createDomainsMapping 将用户已创建的播放域名和推流域名建立域名映射关系。 删除直播域名映射关系 domain deleteDomainsMapping 将播放域名和推流域名的域名映射关系删除。 新增或覆盖直播推流通知配置 domain updateStreamNotification 新增、修改直播推流通知配置。 删除直播推流通知配置 domain deleteStreamNotification 删除直播推流通知配置。 创建直播域名配置项 domain createCDNConfig 创建直播域名配置项。 修改直播域名配置项 domain updateCDNConfig 修改直播域名配置项。 删除直播域名配置项 domain deleteCDNConfig 删除直播域名配置项。 修改IP黑白名单 domain updateIPAuthList 修改推流域名或播放域名的IP黑白名单，当前仅支持ipv4。 黑名单模式：禁止指定的IP或网段 白名单模式：仅允许指定的IP或网段 默认：全放通。 修改直播业务地域限制列表 domain updateGeoBlocking 修改播放域名的地域限制，选中地域允许接入。 设置referer防盗链黑白名单 domain updateRefererChain 设置Referer黑白名单，直播服务会根据配置的referer黑白名单，对访问者的身份进行识别和过滤，符合规则的可以顺利访问到该内容。 如果不符合规则，该访问请求将会被禁止。 删除referer防盗链黑白名单 domain deleteRefererChain 删除Referer防盗链黑白名单。 创建录制规则 transcode createTranscodingsTemplate 创建录制规则，录制规则对新推送的流生效，对已经推送中的流不生效。 使用此功能将产生直播录制费用。 修改录制规则 transcode deleteTranscodingsTemplate 修改录制规则，如果规则更新，对正在录制的流无效，仅对新流有效。 删除录制规则 transcode updateTranscodingsTemplate 删除录制规则。 添加转码SEI信息 transcode createSEI 添加转码SEI信息。 禁止直播推流 stream createStreamForbidden 禁止直播推流。 禁推恢复 stream deleteStreamForbidden 恢复直播推流。 修改禁推属性 stream updateStreamForbidden 修改禁推属性。 直播流闪断 stream createStreamForbiddenOnce 直播流闪断。 创建外网拉流注入任务 stream createPullTask 创建直播拉流任务，支持将外部已有的直播源拉取过来转推至指定的目标地址。 删除外网拉流注入任务 stream deletePullTask 删除直播拉流任务。 设置计费模式 tenant updateChargingMode 设置计费模式。 创建录制规则 record createRule 创建录制规则，录制规则对新推送的流生效，对已经推送中的流不生效。 使用此功能将产生直播录制费用。 修改录制规则 record updateRule 修改录制规则，如果规则更新，对正在录制的流无效，仅对新流有效。 删除录制规则 record deleteRule 删除录制规则。 提交录制控制命令 record createCommand 控制单条流的实时录制。 创建录制回调配置 record createCallback 创建录制回调配置。 修改录制回调配置 record updateCallback 修改录制回调配置。 删除录制回调配置 record deleteCallback 删除录制回调配置。 添加直播截图配置 snapshot createRule 创建直播截图配置。 修改直播截图配置 snapshot updateRule 修改直播截图配置。 删除直播截图配置 snapshot deleteRule 删除直播截图配置。

典型应用场景 首次接入：当您的域名首次接入CDN时，您可以将视频等大文件预热，提升用户体验。 安装包发布：新版本安装包或是升级包发布前，提前将资源预热至 CDN加速 节点。正式上线后，海量用户的下载请求将直接由全球加速节点响应，提升下载速度的同时，大幅度降低源站压力。 运营活动：运营活动发布前，提前将活动页涉及到的静态资源预热至CDN加速节点。活动开始后，用户访问中所有静态资源均由加速节点响应，海量带宽储备保障用户服务可用性，提升用户体验。

注意事项 只有处于“已开启”和“配置中”状态且未被禁用的域名才能执行缓存预热操作。相关域名状态说明请参见查看域名基本信息。 预热完成时间取决于用户提交预热文件数量、文件大小以及网络状况等诸多因素。 当历史记录中的对应URL的缓存预热状态为“成功”时，表示预热完成。 执行大批量文件预热，可能会导致您的源站带宽资源被占满，预热时请尽量分批次执行。 动态文件（如：asp、jsp、php等格式的文件）不能被预热，请勿对动态文件执行预热操作。 如果您预热的资源在CDN节点不缓存，将导致预热失败。 您也可以通过API接口的方式创建域名的缓存预热任务。

请求示例 批量写请求，向test-store仓内的test-table-1表中插入和删除一个kv POST https://test-store.{endpoint}/v1/batch-write-kv { "table_opers" : [ { "table_batch" : { "table_name" : "test-table-1", "kv_opers" : [ { "put_kv" : { "oper_id" : 1, "kv_doc" : { "owner" : "user-1", "filename" : "test-file-1" } } }, { "delete_kv" : { "oper_id" : 2, "primary_key" : { "owner" : "user-2", "filename" : "test-file-2" } } } ] } } ] }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_opers 是 Array of table_batch objects 行操作数组，可以是多个表的操作。 表3 table_batch 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ kv_opers 是 Array of oper_item objects kv操作数组。 表4 oper_item 参数 是否必选 参数类型 描述 put_kv 否 put_kv object 上传kv操作。 delete_kv 否 delete_kv object 删除kv操作。 表5 put_kv 参数 是否必选 参数类型 描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 kv_doc 否 Document 用户文档。 表6 delete_kv 参数 是否必选 参数类型 描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 primary_key 是 Document 用户自定义的主键名及值。

响应参数 状态码：200 表7 响应Body参数 参数 参数类型 描述 unprocessed_opers Array of table_oper_ids objects 未处理的操作列表。 表8 table_oper_ids 参数 参数类型 描述 table_name String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ kv_oper_ids kv_oper_ids object kv操作数组。 表9 kv_oper_ids 参数 参数类型 描述 put_kv_ids Array of integers 上传kv操作, "oper_id"数组。 数组元素：请求内的操作编码，未成功的操作返回该标识。 delete_kv_ids Array of integers 请求内的操作编码，未成功的操作返回该标识。 数组元素：请求内的操作编码，未成功的操作返回该标识。

URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

URI POST /v1/delete-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ primary_key 是 Document 用户自定义的主键名及值。 说明： 内容字段为主键字段名和值，组合索引多个元素。 condition_expression 否 condition_expression object 条件表达式，参见conditional小节。 说明： 禁止携带主键字段, 参见conditional小节的定义。 长度：[8,4096] 表3 condition_expression 参数 是否必选 参数类型 描述 single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件，多个相同优先级的单字段条件。 composed_expression 否 composed_expression object 组合条件, 逐层同级的子表达式嵌套。 表4 composed_expression 参数 是否必选 参数类型 描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects 多个相同优先级且相同逻辑的单字段或多字段条件。 表5 expression 参数 是否必选 参数类型 描述 single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件，多个相同优先级的单字段条件。 composed_expression 否 composed_expression object 组合条件, 逐层同级的子表达式嵌套。 表6 single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。 value 否 Document value和value_array二选一。 value条件值，适用于除"$in", "$nin"外的func。 字段名无意义，可以传空，也可以传字段名。 $exists值为true/false。 说明： $prefix操作只适用于string和binary类型。 value_array 否 Array of strings "value"和"value_array"二选一。 "value_array" 条件值列表, 值用于"$in", "$nin"。 表7 multi_field_expression 参数 是否必选 参数类型 描述 logic 否 String 多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of single_field_expression objects 多个相同逻辑操作的单字段条件。

请求示例 删除单个kv，删除kv的分区键为user，排序键为test-file-1，表名为test-table-1,仓名为test-store。 POST https://test-store.{endpoint}/v1/delete-kv { "table_name" : "test-table-1", "primary_key" : { "owner" : "user-1", "filename" : "test-file-1" } }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 cursor_name String 本次响应后的游标位置，下次请求时携带，如果为空，表示后面无更多。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ 说明： 如果为空，表示后面无更多。 table_names Array of strings 返回的表名列表。 长度：最大100 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。

URI POST /v1/list-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部