Insert - 插入单条数据_关系型数据库-阿里云帮助中心

调用Insert接口向表中插入一条数据。

接口说明

本接口当前仅支持华东1（杭州）地域的Serverless实例使用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
SecretArn	string	是	Data API账号的用户凭证，您可调用DescribeSecrets接口获取该参数的值。格式如下：`acs:rds:{{region}}:{{accountId}}:rds-db-credentials/{{secretName}}-{{6 digits random string}}`。	acs:rds-api:cn-hangzhou:1266348003****:rds-db-credentials/mySecret-Uy**
ResourceArn	string	是	用于指向用户希望访问的资源，格式如下：`acs:rds:{{regionId}}:{{accountId}}:dbinstance/{{instanceId}}`。参数说明如下： regionId：地域ID，可调用DescribeSecrets接口获取。 accountId：阿里云账号ID，可调用DescribeSecrets接口获取。 instanceId：实例ID。	acs:rds:cn-hangzhou:13357869165****:dbinstance/rm-bp1m7l3j633****
Database	string	否	数据库名称。	photoview
Table	string	是	表名称。	users
TransactionId	string	否	已启动的事务ID，您可调用BeginTransaction接口获取该参数的值。	8609**-94e1-45ce-8e25-354e3dd8**
Record	object	否	要插入的数据，数据结构为map key为表字段名称，value为字段值示例：`{ name: "jack", age: 18 }`
	any	否	每个字段的值。	Value1

返回参数

名称	类型	描述	示例值
	object	返回参数。
RequestId	string	请求ID。	9689CF67-B653-5A0F-B9E3-3CC6BBD580ED
Success	boolean	请求是否成功，返回值如下： true：请求成功。 false：请求失败。	true
Code	string	状态码。	200
Message	string	错误信息。说明请求成功时该参数返回为空。	There is an error in the call
Data	InsertResult	Insert的返回值，详情请参见InsertResult。

示例

正常返回示例

JSON格式

{
  "RequestId": "9689CF67-B653-5A0F-B9E3-3CC6BBD580ED",
  "Success": true,
  "Code": "200",
  "Message": "There is an error in the call",
  "Data": {
    "NumberOfRecordsUpdated": 1,
    "AutoIncrementKey": 1
  }
}

错误码

访问错误中心查看更多错误码。