行操作
更新时间：2025-08-21
单条写入PutRow
描述
写入一行数据，只能通过request body将写入数据的各项参数传递给云数据库 TableStorage。
请求
| Verb | URI |
|---|---|
| PUT | /v{version}/instance/{instanceName}/table/{tableName}/row |
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| rowkey | 是 | string | 行主键，需rawurlencode |
| cells | 是 | list | 每个column，value对的列表 |
| +column | 是 | string | 列名，命名规则满足正则[a-zA-Z_][a-za-z0-9\_]{0,254} |
| +value | 是 | string | rawurlencode后的string |
响应参数
无
错误码
| http_code | code | 说明 |
|---|---|---|
| 20x | - | 返回20x表示请求成功，例如200，204等 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 400 | EmptyRowkey | 请求的rowkey传递为空值或未传递 |
| 400 | EmptyColumn | 请求的column传递为空值或未传递 |
| 400 | InvalidColumnName | 请求的column名称不合法 |
| 400 | EmptyCell | 请求的cell传递为空或未传递 |
| 413 | PayloadTooLarge | 请求列数／整行大小／单列大小超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1PUT /v1/instance/ins1/table/table1/row HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "rowkey": "k1%E5%B8",
10 "cells": [
11 {
12 "column": "c1",
13 "value": "v1"
14 },
15 {
16 "column": "c2",
17 "value": "v2"
18 }
19 ]
20}注意:rowkey和value均需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 200 OK
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
6
7{}批量写入BatchPutRow
描述
批量写入多行数据，只能通过request body将写入数据的各项参数传递给云数据库 TableStorage。
请求
| Verb | URI |
|---|---|
| PUT | /v{version}/instance/{instanceName}/table/{tableName}/rows |
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| rows | 是 | list | |
| +rowkey | 是 | string | 行主键，需rawurlencode |
| +cells | 是 | list | 每个column，value对的列表 |
| ++column | 是 | string | 列名，命名规则满足正则[a-zA-Z_][a-za-z0-9\_]{0,254} |
| ++value | 是 | string | rawurlencode后的string |
响应参数
无
错误码
| http_code | code | 说明 |
|---|---|---|
| 20x | - | 返回20x表示请求成功，例如200，204等 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 400 | EmptyRows | 请求的rows为空或未传递 |
| 400 | EmptyRowkey | 请求的rowkey传递为空值或未传递 |
| 400 | EmptyColumn | 请求的column传递为空值或未传递 |
| 400 | InvalidColumnName | 请求的column名称不合法 |
| 400 | EmptyCell | 请求的cell传递为空或未传递 |
| 413 | PayloadTooLarge | 请求行数/列数／整行大小／单列大小超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1PUT /v1/instance/ins1/table/table1/rows HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "rows": [
10 {
11 "rowkey": "k1%E5%B8",
12 "cells": [
13 {
14 "column": "c1",
15 "value": "v1"
16 },
17 {
18 "column": "c2",
19 "value": "v2"
20 }
21 ]
22 }
23 ]
24}注意:rowkey和value均需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 200 OK
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
6
7{}单条删除DeleteRow
描述
删除一整行数据或该行数据的部分列。
- 删除指定的列：将待删除的列指定在columns字段。
- 删除整行：cells参数传空list。
暂时无法支持return_old_value和condition_delete功能。
请求
| Verb | URI |
|---|---|
| DELETE | /v{version}/instance/{instanceName}/table/{tableName}/row |
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| rowkey | 是 | string | 行主键，需rawurlencode |
| cells | 否 | list | 待删除column列表 |
| +column | 否 | string | 待删除的列名称 |
响应参数
无
错误码
| http_code | code | 说明 |
|---|---|---|
| 20x | - | 返回20x类表示请求成功 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 400 | EmptyRowkey | 请求的rowkey传递为空值或未传递 |
| 400 | EmptyColumn | 请求的column传递为空值或未传递 |
| 400 | InvalidColumnName | 请求的column名称不合法 |
| 413 | PayloadTooLarge | 请求列数超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1DELETE /v1/instance/ins1/table/table1/row HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "rowkey": "k1%E5%B8",
10 "cells": [
11 {
12 "column": "c1"
13 },
14 {
15 "column": "c2"
16 }
17 ]
18}注意:rowkey需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 200 OK
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
6
7{}注意:传递的字段只要有非法格式，即报错。
批量删除BatchDeleteRow
描述
批量删除若干行数据，只能通过request body将写入数据的各项参数传递给云数据库 TableStorage。
请求
| Verb | URI |
|---|---|
| DELETE | /v{version}/instance/{instanceName}/table/{tableName}/rows |
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| rows | 是 | list | |
| +rowkey | 是 | string | 行主键，需rawurlencode |
| +cells | 是 | list | 待删除column列表 |
| ++column | 是 | string | 待删除的列名称 |
响应参数
无
错误码
| http_code | code | 说明 |
|---|---|---|
| 20x | - | 返回20x类表示请求成功 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 400 | EmptyRows | 请求的rows传递为空或未传递 |
| 400 | EmptyRowkey | 请求的rowkey传递为空值或未传递 |
| 400 | EmptyColumn | 请求的column传递为空值或未传递 |
| 400 | InvalidColumnName | 请求的column名称不合法 |
| 413 | PayloadTooLarge | 请求行数/列数超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1DELETE /v1/instance/ins1/table/table1/rows HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "rows": [
10 {
11 "rowkey": "k1%E5%B8",
12 "cells": [
13 {
14 "column": "c1"
15 },
16 {
17 "column": "c2"
18 }
19 ]
20 }
21 ]
22}注意:rowkey需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 200 OK
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
6
7{}单条随机读GetRow
描述
查询一行，或一行中的某些列。
请求
| Verb | URI |
|---|---|
| GET | /v{version}/instance/{instanceName}/table/{tableName}/row |
请求头:x-bce-if-none-match 响应头:ETag
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| rowkey | 是 | string | 行主键，需rawurlencode |
| cells | 否 | list | 待查询的column列表 |
| +column | 否 | string | 待查询的列名称 |
| maxVersions | 否 | int | 最多保留版本数，取值范围[1, 50000] |
响应参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| result | list | 查询到的行结果，GetRow最多只会有一个result |
| +rowkey | string | rawurlencode(rowkey)，用户需rawurldecode |
| +cells | list | 查询到的column列表 |
| ++column | string | 属性列名称 |
| ++value | string | rawurlencode(属性列值)，用户需rawurldecode |
| ++timestamp | int | 指定列的版本号，毫秒级的时间戳 |
错误码
| http_code | code | 说明 |
|---|---|---|
| 200 | - | 请求成功 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 400 | EmptyRowkey | 请求的rowkey传递为空值或未传递 |
| 400 | EmptyColumn | 请求的column传递为空值或未传递 |
| 400 | InvalidColumnName | 请求的column名称不合法 |
| 413 | PayloadTooLarge | 请求列数超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1GET /v1/instance/ins1/table/table1/row HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "rowkey": "k1%E5%B8",
10 "cells": [
11 {
12 "column": "c1"
13 },
14 {
15 "column": "c2"
16 }
17 ]
18}注意:rowkey需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 200 OK
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5ETag: 3f80f-1b6-3e1cb03b
6x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
7
8{
9 "result": [
10 {
11 "rowkey": "k1%E5%B8",
12 "cells": [
13 {
14 "column": "c1",
15 "value": "v1",
16 "timestamp": 1571049818321
17 },
18 {
19 "column": "c2",
20 "value": "v2",
21 "timestamp": 1571049818321
22 }
23 ]
24 }
25 ]
26}注意:rowkey和value均需要rawurldecode。
批量读BatchGetRow
描述
查询多行，或多行中的某些列，只能通过request body将写入数据的各项参数传递给云数据库 TableStorage。
请求
| Verb | URI |
|---|---|
| GET | /v{version}/instance/{instanceName}/table/{tableName}/rows |
请求头: x-bce-if-none-match 响应头: ETag
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| rows | 是 | list | |
| +rowkey | 是 | string | 行主键，需rawurlencode |
| +cells | 否 | list | 待查询的column列表 |
| ++column | 否 | string | 待查询的列名称 |
| maxVersions | 否 | int | 最多保留版本数，取值范围[1, 50000] |
响应参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| result | list | 查询到的行结果 |
| +rowkey | string | rawurlencode(rowkey)，用户需rawurldecode |
| +cells | list | 查询到的column列表 |
| ++column | string | 属性列名称 |
| ++value | string | rawurlencode(属性列值)，用户需rawurldecode |
| ++timestamp | int | 指定列的版本号，毫秒级的时间戳 |
错误码
| http_code | code | 说明 |
|---|---|---|
| 200 | - | 请求成功 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 400 | EmptyRows | 请求的rows传递为空或未传递 |
| 400 | EmptyRowkey | 请求的rowkey传递为空值或未传递 |
| 400 | EmptyColumn | 请求的column传递为空值或未传递 |
| 400 | InvalidColumnName | 请求的column名称不合法 |
| 413 | PayloadTooLarge | 请求行数/列数超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1GET /v1/instance/ins1/table/table1/row/k1%E5%B8 HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "rows": [
10 {
11 "rowkey": "k1%E5%B8",
12 "cells": [
13 {
14 "column": "c1"
15 },
16 {
17 "column": "c2"
18 }
19 ]
20 },
21 {
22 "rowkey": "k2%E5%B8",
23 "cells": [
24 {
25 "column": "c3"
26 },
27 {
28 "column": "c4"
29 }
30 ]
31 }
32 ]
33}注意:rowkey需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 200 OK
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5ETag: 3f80f-1b6-3e1cb03b
6x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
7
8{
9 "result": [
10 {
11 "rowkey": "k1%E5%B8",
12 "cells": [
13 {
14 "column": "c1",
15 "value": "v1",
16 "timestamp": 1571049818321
17 },
18 {
19 "column": "c2",
20 "value": "v2",
21 "timestamp": 1571049818321
22 }
23 ]
24 },
25 {
26 "rowkey": "k2%E5%B8",
27 "cells": [
28 {
29 "column": "c3",
30 "value": "v3",
31 "timestamp": 1571049818321
32 },
33 {
34 "column": "c4",
35 "value": "v4",
36 "timestamp": 1571049818321
37 }
38 ]
39 }
40 ]
41}注意:rowkey和value均需要rawurldecode。
区间读Scan
描述
顺序扫描若干行数据。
请求
| Verb | URI |
|---|---|
| GET | /v{version}/instance/{instanceName}/table/{tableName}/rows |
请求头: x-bce-if-none-match 响应头： ETag
请求参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| startRowkey | 否 | string | scan的起始rowkey，需rawurlencode，不填时默认为表的第一个rowkey |
| includeStart | 否 | bool | 是否包含起始rowkey，默认包含 |
| stopRowkey | 否 | string | scan的终止rowkey，需rawurlencode，不填时默认为表的最后一个rowkey |
| includeStop | 否 | bool | 是否包含终止rowkey，默认不包含 |
| selector | 否 | list | 待查询的column列表，不写默认返回全部列 |
| +column | 否 | string | 待查询的列名称 |
| limit | 否 | int | 限定查询行数，其值必须为整型，设为其他类型无效 |
| maxVersions | 否 | int | 最多保留版本数，取值范围[1, 50000] |
注意:startRowkey和stopRowkey指定的区间只需要包含用户所读数据即可，不需要一定是真实存在于表中的rowkey。
响应参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| result | list | 记录列表 |
| +rowkey | string | rawurlencode(rowkey)，用户需rawurldecode |
| +cells | list | cell列表 |
| ++column | string | 列名 |
| ++value | string | rawurlencode(列值)，用户需rawurldecode |
| ++timestamp | int | 指定列的版本号，毫秒级的时间戳 |
| nextStartKey | string | 若本次扫描未结束（返回206），后端会返回nextStartKey作为下一次扫描的起始key，用户应使用此值填充至startRowkey发起下一次scan操作 |
错误码
| http_code | code | 说明 |
|---|---|---|
| 200 | - | 请求成功 |
| 206 | - | 请求成功，但是后端未返回全部数据，需要用户发起下一次请求来读取剩余数据 |
| 401 | AuthenticationFailed | 认证失败 |
| 400 | InvalidURI | URI非法 |
| 405 | MethodNotAllowed | 传递了不支持的HTTP方法 |
| 400 | InvalidContentType | 请求头域Content-Type是不支持的类型 |
| 400 | InvalidAutherization | 请求头域Autherization没有传递 |
| 400 | EmptyDate | 请求头域Date或x-bce-date都没有传递 |
| 400 | InvalidContentLength | 请求头域Content-Length没有传递 |
| 400 | ContentLengthMismatchBodySize | 请求头域的Content-Length和实际Request body大小不等 |
| 400 | MalformedJSON | 请求体传递的json无法解析 |
| 500 | InternalError | 服务内部错误，需联系技术人员解决 |
| 503 | ServerBusy | 请求过于频繁，需要降低请求频率 |
| 404 | InstanceNotExist | Instance不存在 |
| 404 | TableNotExist | Table不存在 |
| 403 | AccessDenied | 请求了不属于自己创建的Instance |
| 413 | PayloadTooLarge | 请求列数超过限制 |
| 403 | InstanceCreating | 实例创建中，请稍候 |
| 403 | AccountOverdue | 账号欠费，请充值后访问 |
请求示例
Plain Text
1GET /v1/instance/instance/table/table1/rows HTTP/1.1
2HOST: bts.bd.baidubce.com
3Authorization: bce-auth-v1/table-access-key/2018-05-24T13:41:13Z/1800/x-bce-date/{signature}
4Content-Type: application/json
5Content-Length: {payloadSizeBytes}
6x-bce-date: 2018-05-24T13:41:13Z
7
8{
9 "startRowkey": "k1%E5%B8",
10 "includeStart": true,
11 "stopRowkey": "k5%E5%B8",
12 "includeStop": false,
13 "selector": [
14 "column": "c1",
15 "column": "c2",
16 "column": "c3"
17 ],
18 "limit": 1000
19}注意:rowkey需要rawurlencode。
响应示例
Plain Text
1HTTP/1.1 206 Partial Content
2Date: Sat, 18 Aug 2018 18:18:18 GMT
3Content-Type: application/json; charset=utf-8
4Content-Length: {payloadSizeBytes}
5ETag: 3f80f-1b6-3e1cb03b
6x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
7
8{
9 "result": [
10 {
11 "rowkey": "k1%E5%B8",
12 "cells": [
13 {
14 "column": "c1",
15 "value": "v1",
16 "timestamp": 1571049818321
17 },
18 {
19 "column": "c2",
20 "value": "v2",
21 "timestamp": 1571049818321
22 }
23 ]
24 },
25 {
26 "rowkey": "k2%E5%B8",
27 "cells": [
28 {
29 "column": "c3",
30 "value": "v3",
31 "timestamp": 1571049818321
32 }
33 ]
34 }
35 ],
36 "nextStartKey": "k3%E5B8"
37}注意:rowkey和value均需要rawurldecode。