SysIncrementData

tip

This method is not sharding safe - and thus is not recommended for custom entities that you may want to shard for greater performance and scalability in the future. Consider using SysIncrementDataSharded() version of this method instead.

Increments the specified fields by the specified amount within custom entity data on the server, bypassing ownership/ACL permissions checks.

Service	Operation
customEntity	SYS_INCREMENT_DATA

Method Parameters

Parameter	Description
entityType	The type of custom entity being updated.
entityId	The id of custom entity being updated.
fieldsJson	Specific fields, as JSON, within entity's custom data, with respective increment amount.

Usage

http://localhost:3000

C#

// Cloud Code only. To view example, switch to the Cloud Code tab

C++

// Cloud Code only. To view example, switch to the Cloud Code tab

Objective-C

// Cloud Code only. To view example, switch to the Cloud Code tab

Java

// Cloud Code only. To view example, switch to the Cloud Code tab

JavaScript

// Cloud Code only. To view example, switch to the Cloud Code tab

Dart

// Cloud Code only. To view example, switch to the Cloud Code tab

Cloud Code

var entityType = "athletes";
var entityId = "aaaa-bbbb-cccc-dddd";
var fieldsJson = { 
    "goals": 3, 
    "assists": 5 
};
var customEntityProxy = bridge.getCustomEntityServiceProxy();

var postResult = customEntityProxy.sysIncrementData(entityType, entityId, fieldsJson);
if (postResult.status == 200) {
    // Success!
}

Raw

{
    "service": "customEntity",
    "operation": "SYS_INCREMENT_DATA",
    "data": {
        "entityType": "athletes",
        "entityId": "aaaa-bbbb-cccc-dddd",
        "fieldsJson": { 
            "goals": 3, 
            "assists": 5 
        }
    }
}

JSON Response

{
  "data": {
    "entityId": "aaaa-bbbb-cccc-dddd",
    "version": 2,
    "acl": {
      "other": 2
    },
    "ownerId": null,
    "expiresAt": null,
    "timeToLive": null,
    "createdAt": 1586047449214,
    "updatedAt": 1591290232477,
    "data": {
        "goals": 3, 
        "assists": 5 
    },
    "entityType": "athletes"
  },
  "status": 200
}