检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
当您的账号因预置KVS资源自动扣费导致欠费后，账号将变成欠费状态。欠费后，预置资源不会立即停止服务，资源进入宽限期。您需支付预置资源在宽限期内产生的费用，相关费用可在“管理控制台 > 费用中心＞总览”的“欠费金额”查看，华为云将在您充值时自动扣取欠费金额。 如果您在宽限期内仍未支付欠款，那么就会进入保留期，资源状态
调用说明 键值存储服务提供了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都有仓名称
终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 kvs.cn-north-4.myhuaweicloud.com HTTPS/HTTP 父主题： 使用前必读
任一可用区故障均不影响业务，数据可用性达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，表名为test-table-1。 POST https://{endpoint}/v1/put-kv { "table_name" : "test-table-1", "kv_doc"
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 请求返回的错误信息。 请求示例 查询表名为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"
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
