...
# | Sub interface | Method | Scenario | HTTP Response Code | Body |
---|---|---|---|---|---|
1 | Data | HTTP: GET - /v1/ch/{cm-handle}/data/ds/ncmp-datastore:passthrough-operational NetworkCmProxyApi.getResourceDataOperationalForCmHandle() | Get resource data from pass-through operational for given cm handle | Specified: 200, 400, 401, 403, 404 Implemented: 200, 500 | |
2 | Data | GET - /v1/ch/{cm-handle}/data/ds/ncmp-datastore:passthrough-running NetworkCmProxyApi.getResourceDataRunningForCmHandle() | Get resource data from pass-through running for given cm handle | Specified: 200, 400, 401, 403, 404 Implemented: 200, 500 | |
3 | Data | PUT- /v1/ch/{cm-handle}/data/ds/ncmp-datastore:passthrough-running NetworkCmProxyApi.updateResourceDataRunningForCmHandle() | Update resource data from pass-through running for the given cm handle | Specified: 200, 400, 401, 403, 404 Implemented: 200, 500 | |
4 | Data | POST - /v1/ch/{cm-handle}/data/ds/ncmp-datastore:passthrough-running NetworkCmProxyApi.createResourceDataRunningForCmHandle() | Create resource data from pass-through running for given cm handle | Specified: 201, 400, 401, 403, 404 Implemented: 201, 500 | |
5 | Data | PATCH - /v1/ch/{cm-handle}/data/ds/ncmp-datastore:passthrough-running NetworkCmProxyApi.patchResourceDataRunningForCmHandle() | Patch resource data from pass-through running for the given cm handle | Specified: 200, 400, 401, 403, 404 Implemented: 200, 500 | |
6 | Model | GET - /v1/ch/{cm-handle}/modules NetworkCmProxyApi.getModuleReferencesByCmHandle | Fetch all module references (name and revision) for a given cm handle | Specified: 200, 400, 401, 403, 404 Implemented: 200, 500 | |
7 | Model | POST - /v1/ch/searches NetworkCmProxyApi.executeCmHandleSearch | Execute cm handle searches using 'hasAllModules' condition to get all cm handles for the given module names | Specified: 200, 400, 401, 403 Implemented: 200, 500 | |
8 | Inventory | POST /v1/ch NetworkCmProxyInventoryApi.updateDmiPluginRegistration() | Register, update or remove cm handles | Specified: 201, 400, 401, 403 Implemented: 201, 500 Comment: Invalid requests should return 4xx with an explanation message instead of 500 without information (ex: Invalid combination of plugin service names, URI is not absolute, ...) |
DMI-Plugin
# | Sub interface | Method | Scenario | Specified HTTP Response Code | Implemented HTTP Response Code | Comments |
---|---|---|---|---|---|---|
1 | DMI Plugin Internal | POST - /v1/inventory/cmHandles | Register given list of cm handles (internal use only) | 201 400 401 403 | ||
2 | DMI Plugin | POST - /v1/ch/{cmHandle}/modules | Get all modules for given cm handle | 200 400 401 403 | ||
3 | DMI Plugin | POST - /v1/ch/{cmHandle}/moduleResources | Retrieve module resources for one or more modules | 200 400 401 403 | ||
4 | DMI Plugin | POST - /v1/ch/{cmHandle}/data/ds/ncmp-datastore:passthrough-operational | Get resource data from passthrough-operational for cm handle. Will support read operations only. | 200 400 401 403 | ||
5 | DMI Plugin | POST - /v1/ch/{cmHandle}/data/ds/ncmp-datastore:passthrough-running | Post request to Get, Create or to Update resource data for a cm-handle. Since all requests need to include additional information in a request body HTTP Post is used for all use cases and the actual operation is defined in the request body instead. | 201 400 401 403 |
|
CPS-Temporal
# | Sub interface | Method | Scenario | Specified HTTP Response Code | Implemented HTTP Response Code | To DoComments |
---|---|---|---|---|---|---|
1 | Query | GET - /v1/dataspaces/{dataspace-name}/anchors/{anchor-name}/history CpsTemporalQueryApi.getAnchorDataByName() | Get anchor data by name | 200 400 401 403 | 200 - ok 400 - for input data validation errors 500 - for unexpected system errors |
|
2 | Query | GET - /v1/dataspaces/{dataspace-name}/anchors/history CpsTemporalQueryApi.getAnchorsDataByFilter() | Get anchors data based on filter criteria | 200 400 401 403 | 200 - ok 400 - for input data validation errors 500 - for unexpected system errors |
|
...