openspecimen/rest/ng/storage-containers/{containerId}
Use this resource for patch the storage container. Use HTTP PATCH method to call this API by passing the below details in JSON format.
Parameter | Details |
|---|---|
| containerId | Id of storage container to be updated |
| name | Container Name. It should be unique in application |
| activityStatus | Activity Status of container |
| barcode [Optional] | Container Barcode, By default it will be null. It should be unique in application if barcode is provided |
| comments [optional] | Comments for container, By default it will be null |
| holdsCPTitles[Optinal] | Title of collection protocols to restrict specific protocol for storage. |
| holdsSpecimenTypes[Optional] | Specimen of specified types are allowed in container |
| createdBy | User Info object containing loginName and domainName of user, who had been created the container |
| oneDimensionCapacity | Max capacity of dimension one eg.30 |
| parentContainerName[Optional] | Parent container name. By default is will be null |
| siteName | Site name in which the container is present. Either siteName or parentContainerName is mandatory. |
| tempratureInCentigrade[Optional] | Temperature of storage container.By default it will be null.Either siteName or parentContainerName is mandatory. |
| twoDimensionCapacity | Max capacity of dimension two eg.30 |
| oneDimentionLabelingScheme[Optional] | By Default it will be {Numbers, Alphabates Upper Case, Alphabates Lower Case, Roman Upper Case, Roman Lower Case} |
| twoDimentionLabelingScheme[Optional] | By Default it will be {Numbers, Alphabates Upper Case, Alphabates Lower Case, Roman Upper Case, Roman Lower Case} |
http[s]:<host>:<port>/openspecimen/rest/ng/storage-containers/{containerId}
Use this URL to update storage container in openSpecimen application.
Result:
The response of this request will contains the details of the updated storage container.
Below is the example of the update storage container:
| URL | http://<host>:<port>/opespecimen/rest/ng/storage-containers/{containerId} |
| Method | PATCH |
| Request | application/json |
| json | { "name":"Container1", "barcode":"2-edpwesdadas-343", "activityStatus":"Active", "createdBy" : { "loginName" : "admin@admin.com", "domainName" :"catissue" }, "tempratureInCentigrade":22.22, "siteName":"My Site", "parentContainerName": "Freezer", "holdsCPTitles":["Cp1","My CP"], "holdsSpecimenTypes" : ["Blood","Tissue"], "comments":"Blah blah blah", "oneDimensionCapacity":10, "twoDimensionCapacity":10 } |
Response | { "id" : 1, "name":"Container1", "barcode":"2-edpwesdadas-343", "activityStatus":"Active", "createdBy" : { "loginName" : "admin@admin.com", "domainName" :"catissue" }, "tempratureInCentigrade":22.22, "siteName":"My Site", "parentContainerName": "Freezer", "holdsCPTitles":["Cp1","My CP"], "holdsSpecimenTypes" : ["Blood","Tissue"], "comments":"Blah blah blah", "oneDimensionCapacity":10, "twoDimensionCapacity":10, "oneDimentionalLabellingScheme ": "Numbers", "twoDimentionalLabellingScheme ": "Numbers" } |
Error Cases :
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | Storage container has been patched successfully |
| 400 | All requests | Invalid parameters, e.g duplicate container Name, blank container Name etc |
| 401 | All requests | Authorization failed, User doesn’t have Authority |
| 404 | All requests | Container not found, container with given details not present in the system |
| 500 | All requests | Internal server error, Encountered server error while performing operations |