アイテムの更新
説明
このAPIを使用すると、プロジェクト内のNoSQLテーブルの既存データからアイテムを更新できます。テーブルは一意のIDまたは名前で参照されます。
カスタムJSON形式で、条件を指定してもしなくても更新する属性を渡すことができます。
リクエスト詳細
リクエストURL
{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item
リクエストヘッダー
Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json
オプションヘッダー
CATALYST-ORG: {org_id}
Environment: Development
スコープ
ZohoCatalyst.nosql.item.UPDATE
リクエストJSONプロパティ
更新する属性とその値を示します。更新にはPUT（アイテム内に新しい属性を追加）とDELETE（アイテムから属性を削除）の2種類があります。attribute_pathは、実際の操作が行われるアイテム内のパスを示します。更新する値には2種類があります：
使用できる4つの関数があります：
if_not_exists - 属性の存在を確認し、存在しない場合に値を宣言します。
append_list - リストにデータを追加します。
add - 既存の値に値を追加するか、セットに要素を追加します。
reduction - 既存の値から値を減算するか、セットから要素を削除します。
テーブルの既存データが取得され、この条件に対して評価されます。評価がtrueの場合にのみアイテムが挿入されます。既存データがない場合、条件は無視されアイテムが挿入されます。条件を初期化するには3つの方法があります：
レスポンス詳細
レスポンスには、挿入操作のステータスと、設定されている場合はtable_name、partition_key、sort_keyなど更新されたアイテムの詳細が返されます。
curl -X PUT
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type:application/json”
-d ‘{
keys:{
partition_key:{
“S”:“Country”
},
sort_key:{
“N”:“EmpID”
},
}
update_attributes:{
“item”: {
“EmpID”: {
“N”: “10999”
},
“FirstName”:{
“S”: “Paul”
},
“LastName”:{
“S”: “Smith”
},
“PriorExperience”:{
“BOOL”: false
},
“Location”: {
“M”: {
“Country”: {
“S”: “USA”
},
“City”: {
“S”: “New York”
}
}
}
}
}
}’
{
"status": "success",
"data": {
"table_name": "employeeDetails",
"project_details": {
"id": 4000000006007,
"project_name": "EmpDatabase",
"project_type": "Live"
}
}
}
Yes
No
Thank you for your feedback!
Send your feedback to us