检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
存储仓管理 存储仓简介 创建存储仓 查询存储仓列表 查询存储仓详细信息
如何调用API 构造请求 认证鉴权 返回结果
数据保护技术 KVS通过多种数据保护手段和特性,保障存储在KVS中的数据安全可靠。 表1 KVS数据保护手段和特性 数据保护手段 简要说明 传输加密(HTTPS) KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法。 操作认证 所有KVS API都会进行身份认证。
创建索引 操作场景 本章节指导用户在指定仓中创建指定表的索引。 前提条件 已成功创建要指定索引的表。 约束与限制 一个表支持创建5个本地二级索引和20个全局二级索引。 仅支持在创建表的过程中创建索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。
存储仓简介 存储仓,简称仓,是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分,创建不同的仓。 KVS自顶向下按照仓、表、KV的结构存储数据,仓中包含至少1个或多个表,表中包含至少1个或多个KV。例如,用一张表记录某个部门所有员工的信息,每一个仓就代表一个部门。
例如:exampleprefix-cn-north-4-exampledomainid。如何获取账号ID请参见获取账号ID Endpoint 指定承载KVS服务端点的服务器域名或IP。Endpoint需要通过购买VPC终端节点,创建内网域名来获取,具体操作请参见VPC终端节点对接KVS。 resource-path
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于创建表接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头
获取项目ID 操作场景 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式: 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考:查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下:
更新KV 操作场景 本章节指导用户更新指定KV。 前提条件 要更新的KV数据已存在。 约束与限制 分区键和排序键不支持更新修改。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要更新KV的仓,单击表名进入要更新KV的表。 选择“KV信息”页签。
single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件,多个相同优先级的单字段条件。 composed_expression
身份认证与访问控制 IAM身份认证 用户访问KVS的方式有多种,包括KVS控制台、API、SDK,无论访问方式封装成何种形式,其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值,该签名值以请求者的访问密钥(
provisioned_throughput object 预置吞吐读写请求单元数,在bill_mode="provisioned"有效。 primary_key_schema 是 primary_key_schema object 主键模板, 最多1个,必须指定主键schema。
single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件,多个相同优先级的单字段条件。 composed_expression
condition_expression 否 condition_expression object 条件表达式,参见conditional小节,禁止携带主键字段。 长度:[8,4096] update_fields 否 update_fields object 对kv_doc有效。 表3 condition_expression
single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件,多个相同优先级的单字段条件。 composed_expression
查询单个kv 功能介绍 下载一个kv文档的全部内容,或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名,全域唯一,不同租户的仓名不能相同。 格式:${prefix}-${
列举仓 功能介绍 一个账户下可以创建最多25个仓,每个仓可以创建最多100个store,响应中一次性返回所有仓名称。 URI POST /v1/list-store 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 cursor_name 否 String 上次返回的游标位置,本次响应包含该仓名。
KVS控制台使用类问题 出现“客户端与服务器的时间相差15分钟”的报错
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 用户购买VPC终端节点,创建内网域名,内网域名即用户使用API访问KVS过程中使用到的终端节点。 父主题: 使用前必读
长度:[3, 63] 取值字符限制:[a-z0-9_-]+ primary_key_schema primary_key_schema object 主键模板, 最多1个,必须指定主键schema。 local_secondary_index_schema Array of secondary_index