EntityResource
Entity management operations as REST API. An entity is an "instance" of a Type. Entities conform to the definition of the Type they correspond with.
The following resources are applicable:
- /entities
- /entities/{guid}
- /entities/{guid}/traits
- /entities/{guid}/traits/{traitName}
- /entities/qualifiedName
/entities
The following operations are supported on this resource:
POST
Submits the entity definitions (instances). The body contains the JSONArray of entity json. The service takes care of de-duping the entities based on any unique attribute for the give type.
Response Body
| element: | (custom) |
| media types: | application/json |
(no documentation provided)
PUT
Complete update of a set of entities - the values not specified will be replaced with null/removed Adds/Updates given entities identified by its GUID or unique attribute
Response Body
| element: | (custom) |
| media types: | application/json |
response payload as json
GET
Parameters
| name | description | type | default |
|---|---|---|---|
| type | (no documentation provided) | query | |
| property | (no documentation provided) | query | |
| value | (no documentation provided) | query |
Response Body
| element: | (custom) |
| media types: | application/json |
(no documentation provided)
/entities/{guid}
POST
Updates entity identified by its GUID Support Partial update of an entity - Adds/updates any new values specified Does not support removal of attribute values
Parameters
| name | description | type | default |
|---|---|---|---|
| guid | (no documentation provided) | path | |
| property | (no documentation provided) | query |
Response Body
| element: | (custom) |
| media types: | application/json |
(no documentation provided)
GET
Fetch the complete definition of an entity given its GUID.
Parameters
| name | description | type | default |
|---|---|---|---|
| guid | GUID for the entity | path |
Response Body
| element: | (custom) |
| media types: | application/json |
(no documentation provided)
/entities/{guid}/traits
GET
Gets the list of trait names for a given entity represented by a guid.
Parameters
| name | description | type | default |
|---|---|---|---|
| guid | globally unique identifier for the entity | path |
Response Body
| element: | (custom) |
| media types: | application/json |
a list of trait names for the given entity guid
POST
Adds a new trait to an existing entity represented by a guid.
Parameters
| name | description | type | default |
|---|---|---|---|
| guid | globally unique identifier for the entity | path |
Response Body
| element: | (custom) |
| media types: | application/json |
(no documentation provided)
/entities/{guid}/traits/{traitName}
DELETE
Deletes a given trait from an existing entity represented by a guid.
Parameters
| name | description | type | default |
|---|---|---|---|
| guid | globally unique identifier for the entity | path | |
| traitName | name of the trait | path |
Response Body
| element: | (custom) |
| media types: | application/json |
(no documentation provided)
/entities/qualifiedName
POST
Adds/Updates given entity identified by its unique attribute( entityType, attributeName and value) Updates support only partial update of an entity - Adds/updates any new values specified Updates do not support removal of attribute values
Parameters
| name | description | type | default |
|---|---|---|---|
| type | the entity type | query | |
| property | the unique attribute used to identify the entity | query | |
| value | the unique attributes value | query |
Response Body
| element: | (custom) |
| media types: | application/json |
response payload as json The body contains the JSONArray of entity json. The service takes care of de-duping the entities based on any unique attribute for the give type.