检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用API、SDK方式访问KVS时需要提前获取终端节点(Endpoint),具体操作请参见步骤三:获取终端节点。 使用SDK前,需要先下载对应工具或SDK源码,并进行初始化配置,具体操作请参见步骤四:下载SDK并初始化。 存储仓是用来存储表数据的单元,在创建表前需要先创建存储仓,具体操作请参见步骤五:创建存储仓。
调用说明 键值存储服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题: 使用前必读
KVS通过多种数据保护手段和特性,保障存储在KVS中的数据安全可靠。 表1 KVS数据保护手段和特性 数据保护手段 简要说明 传输加密(HTTPS) KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法。 操作认证 所有KVS API都会进行身份认证。 父主题: 安全
表1 URI中的参数说明 参数 描述 URI-scheme 请求使用的协议类型,如HTTP、HTTPS。HTTPS表示通过安全的HTTPS访问该资源,键值存储服务支持HTTP,HTTPS两种传输协议。 store-name 请求使用的仓名称,是可选部分,并不是每个API都有仓名称
TooManyKeyValues 超出单分区键的kv限制 - 403 Forbidden KVS.00001011 AccessForbidden 权限不足 检查权限配置 403 Forbidden KVS.00001012 InArrearsOrInsufficientBalance 用户欠费或余额不足而没有权限进行某种操作
服务韧性 KVS提供多级可靠性架构,通过跨区域复制、多AZ容灾、全冗余部署、慢节点检测等技术方案,保障数据的持久性和可靠性。 图1 KVS可靠性架构保证数据稳定,业务可靠 父主题: 安全
任一可用区故障均不影响业务,数据可用性达99.99%,数据持久度达99.9999999999%。 数据安全可靠 KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法; 支持KMS数据加密功能,消除在保护敏感数据时涉及的操作负担和复杂性。 弹性扩展无上限
error_msg String 请求返回的错误信息。 请求示例 列举用户账户下的仓,从指定仓名位置开始返回,限制返回仓名数量2个。 POST https://{endpoint}/v1/list-store { "limit" : 2 } 响应示例 状态码:200 表示列举仓成功。
请求返回的错误信息。 请求示例 下载一个kv,表名为test-table-1,设置分区键值为user1,排序键值为test-file-1。 POST https://{endpoint}/v1/get-kv { "table_name" : "test-table-1", "primary_key"
请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 列举指定仓中的表,限制返回表数量为2 POST https://{endpoint}/v1/list-table { "limit" : 2 } 响应示例 状态码:200 表示列举表请求成功
数组元素:请求内的操作编码,未成功的操作返回该标识。 请求示例 批量写请求,向test-table-1表中插入和删除一个kv POST https://{endpoint}/v1/batch-write-kv { "table_opers" : [ { "table_batch"
error_msg String 请求返回的错误信息。 请求示例 删除单个kv,删除kv的分区键为user,排序键为test-file-1 POST https://{endpoint}/v1/delete-kv { "table_name" : "test-table-1", "primary_key"
请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 上传单个kv,表名为test-table-1。 POST https://{endpoint}/v1/put-kv { "table_name" : "test-table-1", "kv_doc"
请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 查询表名为test-table的表信息 POST https://{endpoint}/v1/describe-table { "table_name" : "test-table" } 响应示例
更新的kv分区键值为user1,排序键为test-file-1,将updateKey字段的值更新为updateValue。 POST https://{endpoint}/v1/update-kv { "table_name" : "test-table-1", "primary_key"
参数 参数类型 描述 kv_doc Document 对kv_doc有效。 请求示例 扫描分区键值等于user1的所有kv POST https://{endpoint}/v1/scan-skey-kv { "table_name" : "test-table-1", "shard_key"
请求返回的错误信息。 请求示例 创建表,表名为test-table,分区键字段名为owner,排序键字段名称为filename POST https://{endpoint}/v1/create-table { "table_name" : "test-table", "primary_key_schema"
参数类型 描述 kv_doc Document 对kv_doc有效。 请求示例 扫描所有kv,扫描条件为分区键的值为user2 POST https://{endpoint}/v1/scan-kv { "table_name" : "test-table-1", "filter_expression"
域。 如何选择可用区? 是否将资源放在同一可用区内,主要取决于您对容灾能力和网络时延的要求。 如果您的应用需要较高的容灾能力,建议您将资源部署在同一区域的不同可用区内。 如果您的应用要求实例之间的网络延时较低,则建议您将资源创建在同一可用区内。 区域和终端节点 当您通过API使用