华为云用户手册

操作步骤 登录OrgID管理控制台。 单击“创建组织”。 输入组织名称，并单击“下一步”。 名称由1~60个中文、英文、数字及合法字符组成。 设置组织的域名。 输入组织简称，可使用2~30位字母、数字或它们的组合，如abc，后缀名为固定的.orgid.top，如图1所示。单击“下一步”。 图1 设置组织域名 域名是指网址中“www.”之后的内容，如: www.example.com中的example.com即为域名；或电子邮件地址中“@”符号之后的内容，如username@example.com中的example.com即为域名。 域名设置后管理员为组织创建成员时，成员的管理式华为帐号默认带有域名后缀，如设置的组织域名为abc.orgid.top，创建的成员帐号为xxx@abc.orgid.top。OrgID支持使用自有域名，可在域名管理中添加域名并在创建成员时选择帐号后缀的域名。 阅读“管理式华为帐号”相关声明，单击“同意”。 组织创建成功，您可以单击“进入控制台”，在控制台继续进行后续的组织管理操作。也可以在华为云OrgID控制台为组织开通联邦认证，开通联邦认证后，授权的用户可以通过联邦认证访问组织的华为云资源。

问题原因 由于Chrome等浏览器只支持硬解码H265（HEVC）视频，当您的PC硬件不支持解码H265（HEVC）视频时，Chrome等浏览器将无法播放H265（HEVC）视频，并获取不到视频分辨率等参数。 在Chrome浏览器中输入“chrome://gpu”后，搜索“coding”。可以检查当前PC的浏览器是否支持H265（HEVC）视频解码。 图2 查看浏览器配置 用ffmpeg检查视频的编码是否是H265（HEVC），输入命令：ffmpeg -i 视频文件名。 图3 检查视频是否是hevc编码 需要先安装ffmpeg，安装方法如下。 ffmpeg下载地址：https://github.com/BtbN/FFmpeg-Builds/releases。 ffmpeg解压后，将其下bin目录加入系统环境变量。 输入命令行ffmpeg后可以显示版本号，说明安装成功。

操作步骤 登录MetaStudio控制台。 单击“分身形象制作”下方的“开始创建”。进入分身形象制作页面，如图1所示。 图1 定制数字人形象 上传分身数字人训练数据。 界面操作详情，如表1所示。 表1 界面操作说明 区域 参数 说明 分身数字人训练数据上传 角色名称 输入分身数字人的角色名称。 示例：云笙。 训练视频 从本地上传已录制好，且符合拍摄要求的人像视频。 录制的视频要求4K，时长建议5~6分钟，分辨率≥1080P，宽高比16:9（横屏）或9:16（竖屏），建议优先使用竖屏拍摄。支持MP4、MOV格式的视频。 背景替换 选择“抠除拍摄背景”，制作分身数字人视频时，可以替换背景。 视频封面（可选） 视频封面，无需上传。 身份认证及授权数据上传 联系方式 请输入有效的11位手机号码。 身份证照片 需要分别上传身份证人像面和国徽面的照片。 单击“点击上传人像面”，从本地选择身份证人像面照片上传。 单击“点击上传国徽面”，从本地选择身份证国徽面照片上传。 形象授权 上传形象授权书。 操作如下所示： 单击“授权书模板”，将授权书模板下载本地。 打印授权书，由身份证本人完成签署操作。 扫描文件生成pdf文件，或拍摄文件生成jpg、png格式的图片。 单击“点击上传授权书”，从本地选择pdf、jpg或png格式的授权书上传。 第三方用户ID（可选） 无需填写。 单击“提交制作”。 数据上传完成后，界面提示“制作任务提交成功！”，如图2所示。 图2 制作任务提交成功 用户可以单击“查看制作任务列表”，进入分身数字人定制任务列表页面，如图3所示。 图3 任务列表 单击任务所在行的“查看详情”，进入“定制任务详情”页面，如图4所示。 查看分身数字人定制任务审核进展，当前状态为“系统审核中”。数字人定制任务提交成功后，需要等待1天左右的时间审核。 图4 定制任务详情 审核通过后，任务状态变更为“算法训练中”，如图5所示。 数字人定制任务审核通过后，启动算法训练，模型训练过程较长，约10个小时左右，请耐心等待。 图5 数字人定制任务 等待数字人模型训练完成后，任务状态变更为“算法训练完成”，如图6所示。 图6 数字人定制任务 如果训练生成的数字人形象满足需求，单击右下方的“通过”。在弹出的“确认”对话框中，单击“确认”，数字人形象生成完成。

操作步骤 登录MetaStudio控制台。 单击“声音制作”下方的“开始创建”，进入声音制作页面。 图1 定制声音 配置声音制作参数。 界面操作详情，如表1所示。 表1 界面操作说明 区域 说明 请选择声音制作服务 选择声音制作服务“基础版声音制作”。 定制声音名称 输入声音名称，示例：欢快女声。 请选择声音性别 选择声音的性别，示例：女生。 选择语言 选择声音的语言，示例：中文。 选择声音标签 声音的标签。请根据所选文案样例，选择相应的标签，如下所示： 电商：直播带货风格文案 营销：营销宣传风格文案 新闻：新闻播报风格文案 请制作声音 使用“语料上传”的方式，直接上传一个已录制好的长音频WAV文件，无需压缩，无需携带文案txt文件。 声音授权 单击“授权书模板”，下载授权书模板后打印。用户手写相关信息后，重新生成签署后的pdf文件，或者拍摄成jpg或png格式的图片后上传。 第三方用户ID（可选） 无需填写。 单击“提交制作”。 弹出“资源消耗提示”对话框。提示用户目前声音制作服务剩余数量，本次将消耗1个资源。 如果用户确认无误，单击“确认提交”。 声音制作任务提交成功后，界面提示“制作任务提交成功”，如图2所示。 声音制作任务提交成功后，需要等待1天左右的时间审核。任务审核通过后，启动声音制作。 图2 制作任务提交成功 用户可以单击“查看制作任务列表”，查看声音制作任务审核进展。 当状态变更为“系统审核完成”，自动启动算法训练。如果系统存在多个算法训练任务，可能会存在排队和延迟的现象，请耐心等待。 确认声音制作任务已训练完成后，在左侧导航栏中，单击“我的创作”。 选择“声音”，找到已生成的声音，单击试听声音效果。

功能特性 MetaStudio提供形象制作、声音定制、分身形象视频制作、分身形象 视频直播 、分身形象名片制作、智能交互等能力，如表1所示。 表1 功能特性 功能名称 功能描述 形象制作 通过拍摄真人视频，建模生成数字人分身形象。 数字人可作为虚拟主播、虚拟主持、虚拟客服、虚拟老师等形象使用。 声音制作 通过录制真人声音，建模生成自定义的数字人声音，用于为数字人配音。 也支持直接购买第三方声音套餐，使用套餐内的声音，为数字人配音。 视频制作 使用数字人形象，进行画布和音频设置，合成视频。 适用于各类培训、宣讲、知识分享等场景。 视频直播 使用数字人形象，进行画布设置、剧本设计、互动和开播设置，生成直播视频。 可用于在合作的第三方平台进行数字人视频直播。 智能交互 支持用户开箱即用的智能交互数字人场景；也支持使用智能交互API或SDK，自主开发实现与数字人对话场景。 数字人名片 支持为分身数字人制作形象名片，且支持通过名片来试听语音效果。 照片数字人 支持上传正面清晰的人像照片，生成会说话的照片数字人视频。

调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为 IAM 的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65ewtrgaggshhk1223245sghjlse684b", "is_domain": false, "parent_id": "65ewtrgaggshhk1223245sghjlse684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4adasfjljaaaakla12334jklga9sasfg" }, "id": "a4adasfjljaaaakla12334jklga9sasfg", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

API概览 表1 接口说明 类型 子类型 说明 表接口 创建表 在指定存储仓内创建表，表名在存储仓内唯一； 创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。 列举表 指定存储仓列举创建的所有表。 查询表 指定存储仓查询表属性，如容量，规模，配额。 KV接口 上传单个kv 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 查询单个kv 下载一个kv文档的全部内容，或者部分字段的内容。 更新单个kv 指定表，指定主键，指定更新文档的部分内容，如果是自描述文档，指定字段名；如果是二进制文档，指定偏移位置和长度；允许指定条件执行。 删除单个kv 指定表，指定主键，删除该文档；允许指定条件执行。 扫描所有kv 指定表，扫描表下所有kv；允许指定过滤条件。 扫描分区键内kv 指定表及分区键，携带条件查询kv；允许指定过滤条件。 批量写请求 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。

概述 欢迎使用键值存储服务（Key-Value Storage Service, KVS）。键值存储服务提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。 您可以使用本文档提供API对键值存储服务进行相关操作，如创建、查询、删除、更新等。支持的全部操作请参见API概览。 在调用键值存储服务API之前，请确保已经充分了解键值存储服务相关概念，详细信息请参见《用户指南》的“产品介绍”。 父主题： 使用前必读

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": $ADMIN_PASS, //IAM用户密码，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，$ADMIN_PASS表示用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "$ADMIN_PASS", //建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 Bad Request KVS.00001001 BadRequest 请求参数不合法。 根据返回的错误消息体提示进行修改。 400 Bad Request KVS.00001002 InvalidStore 请求访问的Store已不存在。或者状态不正确。 更换Store名。 400 Bad Request KVS.00001003 InvalidTable 请求访问的Table已不存在。或者状态不正确。 更换Table名。 400 Bad Request KVS.00001004 EntityTooLarge 请求超过大小限制 减少大小。 400 Bad Request KVS.00001005 IncompleteBody 由于网络原因或其他问题导致请求体未接受完整。 重试。 400 Bad Request KVS.00001006 InvalidRequest 无效请求。 body体不合法，或者没有携带。根据返回的错误消息体提示进行修改。 400 Bad Request KVS.00001007 TooManyStores 用户拥有的Store的数量达到了系统的上限，并且请求试图创建一个新Store。 删除部分Store后重试。 400 Bad Request KVS.00001008 TooManyTables 用户Store拥有的Tables的数量达到了系统的上限，并且请求试图创建一个新Tables。 删除部分Table后重试。或选取其他Store。 400 Bad Request KVS.00001009 TooManyKeyValues 超出单分区键的kv限制 - 403 Forbidden KVS.00001010 AccessDenied 拒绝访问，请求没有携带日期头域或者头域格式错误。 请求携带正确的日期头域。 403 Forbidden KVS.00001011 AccessForbidden 权限不足。 检查权限配置。 403 Forbidden KVS.00001012 InArrearOrInsufficientBalance 用户欠费或余额不足而没有权限进行某种操作。 充值。 403 Forbidden KVS.00001013 InsufficientStorageSpace 存储空间不足。 超过配额限制，增加配额或删除部分对象。 404 Not Found KVS.00001014 NoSuchStore 指定的Store不存在。 先创Store再操作。 404 Not Found KVS.00001015 NoSuchTable 指定的Table不存在。 先创Table再操作。 404 Not Found KVS.00001016 NoSuchKey 指定的Key不存在。 先PUT。 408 Request Timeout KVS.00001017 RequestTimeout 用户与Server之间的socket连接在超时时间内没有进行读写操作。 检查网络后重试，或联系技术支持。 409 Conflict KVS.00001018 StoreAlreadyExists 请求的Store名已经存在。Store的命名空间是系统中所有用户共用的，选择一个不同的Store名再重试一次。 更换Store名。 409 Conflict KVS.00001019 StoreNotEmpty 用户尝试删除的Store不为空。 先删除Store中对象，然后再删Store。 409 Conflict KVS.00001020 TableAlreadyExists 请求的Table名已经存在。选择一个不同的Table名再重试一次。 更换Table名。 409 Conflict KVS.00001021 TableNotEmpty 用户尝试删除的Table不为空。 先删除Table中对象，然后再删Table。 409 Conflict KVS.00001022 OperationAborted 另外一个冲突的操作当前正作用在这个资源上，请重试。 等待一段时间后重试。 500 Internal Server Error KVS.00000001 InternalError 系统遇到内部错误，请重试。 请联系技术支持。 501 Not Implemented KVS.00000002 ServiceNotImplemented 请求的方法服务端没有实现。 当前不支持，请联系技术支持。 503 Service Unavailable KVS.00000003 ServiceUnavailable 服务器过载或者内部错误异常。 等待一段时间后重试，或联系技术支持。 503 Service Unavailable KVS.00001023 SlowDown 请降低请求频率。 请降低请求频率。 400 Bad Request KVS.00005000 RegionIsNotOnService Region不支持创建store 更换Region 400 Bad Request KVS.00005001 RegionNumberExceedLimit Region数量超过限制 减少Region数量 400 Bad Request KVS.00005002 TableAlreadySwitchOnPITR 下面的某个表已经打开了PITR 无需重复开启PITR 400 Bad Request KVS.00005003 StoreIsNotEmpty Store为非空 删除store下的table后再delete-store 400 Bad Request KVS.00005004 BackupNameConflict 备份名冲突 更换备份名 400 Bad Request KVS.00005005 BackupIsCreating 备份状态创建 正在创建备份 400 Bad Request KVS.00005006 BackupNameNotExit 备份名存在 - 400 Bad Request KVS.00005007 BackupNameIsCreateing 备份正在创建 等待备份完成 400 Bad Request KVS.00005008 BackupNameNotAvailable 备份名无效 更换备份名 400 Bad Request KVS.00005009 RecoveryTimeStampInvalid 恢复时间点无效 更换恢复时间点 400 Bad Request KVS.00005010 Local2ndIndexNumberExceedLimit 本地二级索引数量超过限制 减少本地二级索引数量 400 Bad Request KVS.00005011 Global2ndIndexNumberExceedLimit 全局二级索引数量超过限制 减少本地二级索引数量 400 Bad Request KVS.00005012 PrimaryKeyIndexSchemaInvalid 主键二级索引模板定义无效 未定义ShardKey 或 多余的描述 或 ShardMode非法 400 Bad Request KVS.00005013 Local2ndIndexSchemaInvalid 本地二级索引模板定义无效 重复的SortKey 400 Bad Request KVS.00005014 Global2ndIndexSchemaInvalid 本地二级索引模板定义无效 未定义ShardKey 或 多余的描述 或 ShardMode非法 400 Bad Request KVS.00005015 StoreAlreadySwitchOnPITR store已经打开了PITR 无需重复开启PITR 400 Bad Request KVS.00005016 CondtionExpressionInvalid 条件表达式超过上线，或者语法不正确，或者预定义变量找不到 检查条件表达式定义 400 Bad Request KVS.00005017 CondtionIsFalse 条件表达式非真 - 400 Bad Request KVS.00005018 keyValueSizeExceedLimited KV文档大小超过限制 缩减文档数据量 400 Bad Request KVS.00005019 ReturnPartialBlobIsInvalid ReturnPartialBlob指定的偏移无效 修改偏移参数值 400 Bad Request KVS.00005020 BatchExceedLimit batch大小或操作个数超限 减少操作个数

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下，您可以查看项目ID。 企业项目 企业项目是项目的升级版，针对企业不同项目间的资源进行分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 父主题： 使用前必读

状态码 正常状态码 描述 200 OK 201 Created 202 Accepted 204 No Content 错误状态码 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method Not Allowed 409 Conflict 413 Request Entity Too Large 415 Unsupported Media Type 429 Too Many Requests 500 Internal Server Error 501 Not Implemented 503 Service Unavailable 父主题： 附录

分区键和排序键有什么区别？ 分区键和排序键之间的对比如表1所示 表1 分区键、排序键对比 对比维度 分区键 排序键 应用场景 分区键用于确定该表中的每一个KV所在的分区。例如，对于一个用户表，可以指定用户名属性作为分区键。 KVS会根据此用户名的名称（KV）选择分区，同样的用户名名称存储在同一个分区。 表中的KV会根据排序键进行排序以后存储。查询数据时，您可以按照排序键输出数据。 支持主键 简单主键（分区键）和复合主键（分区键和排序键）。 复合主键（分区键和排序键）。 父主题： 概念类

本地二级索引与全局二级索引有什么区别？ 本地二级索引和全局二级索引之间的对比如表1所示。 每个索引属于一个表，该表称为索引的主表。 表1 本地二级索引、全局二级索引对比 对比维度 本地二级索引 全局二级索引 概念 对于复合主键（分区键+排序键）的表，支持创建本地二级索引，实现分区键下的多个键值的辅助索引。 表支持创建非主键字段的全局检索，全局二级索引只保存索引记录，不保存完整键值内容。 应用场景 创建一个用户运动信息统计表，此表包含属性：用户名、所在城市、运动时长、运动日期、热量消耗。 主索引的分区键为用户名，排序键为运动时长；本地二级索引的排序键为运动日期，通过该索引可快速查询某一天的运动时长最长或最短的用户信息。 创建一个用户运动信息统计表，此表包含属性：用户名、所在城市、运动时长、运动日期、热量消耗。 主索引的分区键为用户名，排序键为运动时长；全局二级索引的分区键为所在城市，排序键为热量消耗，由于主键字段会投影到全局二级索引的键值中，即全局二级索引记录中包含用户名和运动时长的信息，通过该索引可快速查询到在某城市热量消耗最多或者最少的用户信息。 键架构 复合主键（分区键和排序键）。 简单主键（分区键）或复合主键（分区键和排序键）。 特点 分区键与主表相同但排序键不同。 分区键和排序键可与主表中的对应键不同。 一致性 KV写入时，自动生成并存储本地二级索引记录，并保证KV写入与本地二级索引记录的强一致。 KV写入时，自动生成索引记录，并异步写入全局二级索引，KV写入与全局二级索引记录为最终一致。 创建数量 一个表最多支持创建5个本地二级索引。 一个表最多支持创建20个全局二级索引。 父主题： 概念类

如何使用KVS 图2 KVS入门流程示意图 创建存储仓。 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在页面右上角单击“创建仓”。 根据界面提示，配置“仓详细信息”参数。参数信息详见“仓详细信息”参数说明。 根据界面提示，配置“表详细信息”参数。参数信息详见“表详细信息”参数说明。 根据界面提示，配置“二级索引”参数。支持创建本地二级索引和全局二级索引。参数信息详见“创建本地二级索引”和“创建全局二级索引”参数说明。 信息设置完成后，单击“确定”。 创建表。 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到需要创建表的仓，在仓对应的操作列，单击“创建表”，或者单击仓名称进入仓的详情页面，在“表信息”下单击“创建表”。 根据界面提示，配置“表详细信息”参数。参数信息详见“表详细信息”参数说明。 根据界面提示，配置“二级索引”参数。支持创建本地二级索引或全局二级索引。参数信息详见“创建本地二级索引”和“创建全局二级索引”参数说明。 信息设置完成后，单击“确定”。 插入KV数据。 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要插入KV的仓，单击表名进入要插入KV的表。 选择“KV信息”页签。 单击左上角的“插入KV”。 填写必选属性的属性值，即KV分区键和排序键的值。 【可选】如果您除了分区键和排序键外，还需要新增其他属性，可以单击属性表单下方的“添加KV”，自定义属性和属性值。 所有属性和属性值填写完成后，单击右下角的“确定”，完成KV插入。 查看KV列表，检查新插入的KV是否在列表中，KV存在则插入成功，KV不存在则插入失败。

广告归因业务诉求 广告归因（Advertising Tracking）帮助用户量化移动广告推广效果，让广告主投放的每一个广告，成本低效果好。这就需要满足两个基本要求：广告推广的指标量化、指标计算实时性，这就强依赖广告检测。广告检测平台需要接受大量曝光、点击、浏览等事件数据，并实时处理。在落地过程中存在诸多挑战： 数据量大 广告监测平台会收到大量的曝光、点击、浏览时间，其中可能包括大量的造假时间，每天存储数据条数，达到几十到几百亿条，而且很需要长期存储（通常为90天）。 业务请求规模不可预知 广告主推广广告，推广效果无法预知，可能会发生轰动效果，造成大量突发性曝光、点击、浏览事件产生。 数据实时处理 广告主依赖广告监测平台实时处理结果来调整推放广告策略，广告监测平台处理事件数据的实时性直接影响推广策略调整的效率。

操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要更新KV的仓，单击表名进入要更新KV的表。 选择“KV信息”页签。 找到要更新的KV，在右侧操作列，单击“编辑”，进入KV属性表单。 图1 “编辑”界面 修改KV属性。注意，您只能修改除分区键和排序键以外的属性名称和属性的值。 修改完成后，单击右下角的“确定”，完成KV更新。 查看KV列表，检查KV信息是否为最新值，如果是最新值则更新KV成功。

操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到需要创建表的仓，在仓对应的操作列，单击“创建表”，或者单击仓名称进入仓的详情页面，在“表信息”下单击“创建表”。 根据界面提示，配置“表详细信息”参数。 图1 “表详细信息”界面 表1 “表详细信息”参数说明 参数名称 子参数名称 描述 表详细信息 表名称 必选参数。 表的名称。表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 根据界面提示，配置“二级索引”。支持创建本地二级索引或全局二级索引。 单击“创建本地二级索引”，配置参数信息如表2所示。确认配置信息后单击“确定”。 图2 “创建本地二级索引”界面 表2 “创建本地二级索引”参数说明 参数名称 子参数名称 描述 创建本地二级索引 名称 必选参数。 本地二级索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 排序键 必选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 本地二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 单击“创建全局二级索引”，配置参数信息如表3所示。确认配置信息后单击“确定”。 图3 “创建全局二级索引”界面 表3 “创建全局二级索引”参数说明 参数名称 子参数名称 描述 创建全局二级索引 名称 必选参数。 本地全局索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 全局二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 信息设置完成后，单击“确定”。

存储仓简介 存储仓，简称仓，是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分，创建不同的仓。 KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含至少1个或多个表，表中包含至少1个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。 图1 存储仓简介 KVS云服务支持创建存储仓，查询存储仓及详细信息。 表1 KVS云服务支持的存储仓相关功能 功能 描述 创建存储仓 在KVS管理控制台创建存储仓，同时创建一个表并指定索引。 查询存储仓列表 在KVS管理控制台查看存储仓列表。 查询存储仓详细信息 查看存储仓的详情。 父主题： 存储仓管理

操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要插入KV的仓，单击表名进入要插入KV的表。 选择“KV信息”页签。 单击左上角的“插入KV”。 图1 “插入KV”界面 填写必选属性的属性值，即KV分区键和排序键的值。 【可选】如果您除了分区键和排序键外，还需要新增其他属性，可以单击属性表单下方的“添加KV”，自定义属性和属性值。 所有属性和属性值填写完成后，单击右下角的“确定”，完成KV插入。 查看KV列表，检查新插入的KV是否在列表中，KV存在则插入成功，KV不存在则插入失败。

表简介 表是用来存储键值数据（Key-Value，简称KV）的集合，归属于某个仓。 用户可以在一个仓中创建至少1个或多个表，用来储存键值数据。例如，用一张表记录某个部门所有员工的信息，每一个表就代表一张记录所有员工信息的表。 图1 表简介 KVS云服务支持创建表，查询所有表及详细信息。 表1 KVS云服务支持的表相关功能 功能 描述 创建表 在指定存储仓创建表，同时指定索引。 查询所有表 在指定存储仓查询所有表。 查询表详细信息 在指定存储仓查看某个表的详情 父主题： 表管理

操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到需要创建索引的表所在的仓，在仓对应的操作列，单击“创建表”，或者单击仓名称进入仓的详情页面，在“表信息”下单击“创建表”。 根据界面提示，配置“表详细信息”参数。 图1 “表详细信息”界面 表1 “表详细信息”参数说明 参数名称 子参数名称 描述 表详细信息 表名称 必选参数。 表的名称。表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 根据界面提示，配置“二级索引”。支持创建本地二级索引或全局二级索引。 单击“创建本地二级索引”，配置参数信息如表2所示。确认配置信息后单击“确定”。 图2 “创建本地二级索引”界面 表2 “创建本地二级索引”参数说明 参数名称 子参数名称 描述 创建本地二级索引 名称 必选参数。 本地二级索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 排序键 必选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 本地二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 单击“创建全局二级索引”，配置参数信息如表3所示。确认配置信息后单击“确定”。 图3 “创建全局二级索引”界面 表3 “创建全局二级索引”参数说明 参数名称 子参数名称 描述 创建全局二级索引 名称 必选参数。 本地全局索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 全局二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 信息设置完成后，单击“确定”。

操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到需要删除索引的表所在的仓，在仓对应的操作列，单击“创建表”，或者单击仓名称进入仓的详情页面，在“表信息”下单击“创建表”。 根据界面提示，配置“表详细信息”参数。 图1 “表详细信息”界面 表1 “表详细信息”参数说明 参数名称 子参数名称 描述 表详细信息 表名称 必选参数。 表的名称。表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 根据界面提示，配置“二级索引”。支持创建本地二级索引或全局二级索引。 单击“创建本地二级索引”，配置参数信息如表2所示。确认配置信息后单击“确定”。 图2 “创建本地二级索引”界面 表2 “创建本地二级索引”参数说明 参数名称 子参数名称 描述 创建本地二级索引 名称 必选参数。 本地二级索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 排序键 必选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 本地二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 单击“创建全局二级索引”，配置参数信息如表3所示。确认配置信息后单击“确定”。 图3 “创建全局二级索引”界面 表3 “创建全局二级索引”参数说明 参数名称 子参数名称 描述 创建全局二级索引 名称 必选参数。 本地全局索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 全局二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 在“二级索引”区域，单击二级索引操作列的“删除”，即可删除已创建的本地二级索引或全局二级索引。 图4 删除索引

操作步骤 进入KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”。 在页面右上角单击“创建仓”。 根据界面提示，配置“仓详细信息”参数，如表1所示。 图1 “仓详细信息”界面 表1 “仓详细信息”参数说明 参数名称 子参数名称 描述 仓详细信息 仓名称 必选参数。 存储仓的名称。存储仓的名称长度范围为16-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”组成，“-”不能出现在名字头部或尾部。仓名称全域唯一，不同租户的仓名不能相同。 存储仓的命名规范为{用户自定义前缀}-{当前控制台所在区域的区域名}-{账号ID} 。 须知： 区域名和账号ID为仓名称的固定部分，用户只需填写自定义前缀部分。 根据界面提示，配置“表详细信息”参数，如表2所示。 图2 “表详细信息”界面 表2 “表详细信息”参数说明 参数名称 子参数名称 描述 表详细信息 表名称 必选参数。 表的名称。表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表名称在存储仓内唯一。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 根据界面提示，配置“二级索引”。支持创建本地二级索引和全局二级索引。 单击“创建本地二级索引”，配置参数信息如表3所示。确认配置信息后单击“确定”。 图3 “创建本地二级索引”界面 表3 “创建本地二级索引”参数说明 参数名称 子参数名称 描述 创建本地二级索引 名称 必选参数。 本地二级索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 排序键 必选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 摘要 可选参数。 本地二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 单击“创建全局二级索引”，配置参数信息如表4所示。确认配置信息后单击“确定”。 图4 “创建全局二级索引”界面 表4 “创建全局二级索引”参数说明 参数名称 子参数名称 描述 创建全局二级索引 名称 必选参数。 全局二级索引的名称。名称的长度范围为1-255个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。 分区键 必选参数。 分区键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 排序键 可选参数。 排序键的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。 首字母不支持设置为“_”。 摘要 可选参数。 全局二级索引的概述。支持创建多个摘要。摘要的长度范围为1-63个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成。首字母不支持设置为“_”。 信息设置完成后，单击“确定”。

约束与限制 存储仓的名称长度范围为16-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”组成，“-”不能出现在名字头部或尾部。仓名称全域唯一，不同租户的仓名不能相同。存储仓的命名规范为{用户自定义前缀}-{当前控制台所在区域的区域名}-{账号ID} ，例如：exampleprefix-cn-north-4-exampledomainid。 为存储仓命名时字母大小写不敏感。例如，KVS已存在存储仓exampleprefix-cn-north-4-exampledomainid，如果您再创建存储仓Exampleprefix-cn-north-4-exampledomainid，系统会认定为同一种仓名，导致创建存储仓失败。 单个账号支持创建的存储仓数量不超过25个。