The "createwelltopbytopset" web service creates a new well top within an individual well top set

A typical URL is http://myserver.mycompany.com:8080/INTGeoServer/api/ds/{datasourcetype}/v1/sources/{datasource}/topsets/{topsetuniqueid}/tops with the POST method.

where

datasourcetype: type of a datasource, i.e. mongo, s3, etc.

datasource: a unique id of a datasource

topsetuniqueid: a unique id of a well top set

The following payload is expected (pass application/json as Content-Type):

{

"name":"NewTop-2",

"wellboreuniqueid":"90afe2a1-abc9-4fd3-bc33-ec7ad0b80ba8",

"index":"1996.15",

"indexunit":"m"

}

name is the name of a well top

wellboreuniqueid is the unique id of a well bore

index is the depth of this well top

indexUnit: is the unit symbol associated with this well top. This is an optional parameter.

Here is an example response. This response has been formatted to improve readability.

{

"from": {

"actor": "akka://DefaultActorSystemControllerActorSystem:CreateTopByTopSetJsonActor:CreateTopByTopSetResponse for CreateTopByTopSetRequest:CreateTopByTopSetRequest{klassUpdater=AbstractWellTopUpdater, klassFinder=AbstractWellTopFinder, sourceName=c9db3458-6698-49d9-ae8f-f407ce26ae2e, topSetUniqueId=3014098d-dd43-4e54-b05e-4064129e46d9, wellBoreUniqueId=90afe2a1-abc9-4fd3-bc33-ec7ad0b80ba8, name=NewTop-2, index=1996.15, indexUnit=m, pathInfo=/ds/mongo/v1/sources/c9db3458-6698-49d9-ae8f-f407ce26ae2e/topsets/3014098d-dd43-4e54-b05e-4064129e46d9/tops, properties=com.interactive.ivaap.data.propertyvalues.serializers.SerializableProperties@39282654, wellBoreSourceType=mongo, wellBoreSourceName=c9db3458-6698-49d9-ae8f-f407ce26ae2e, parentWellBoreType=IWellData}"

},

"data": {

"id": "5a3c1f6a-fc02-4dfb-b907-aeed7a6fc879",

"content": {

"topSetUUID": "3014098d-dd43-4e54-b05e-4064129e46d9",

"wellboreUID": "90afe2a1-abc9-4fd3-bc33-ec7ad0b80ba8",

"name": "NewTop-2",

"index": 1996.15,

"indexUnit": "m"

},

"links": [

{

"rel": "self",

"relEntity": "v1/schema/int/top",

"href": "/ivaap/api/ds/mongo/v1/sources/c9db3458-6698-49d9-ae8f-f407ce26ae2e/tops/5a3c1f6a-fc02-4dfb-b907-aeed7a6fc879",

"children": false,

"hasProjectEntityChildren": false,

"isProjectEntity": false

}

]

}

}

The id entry is a unique id of a well top.

In content section

• topSetUUID is the unique id of a parent well top set

• wellboreUID is the unique id of a parent well bore

• name is the name of a well top

• index is the depth of this well top

• indexUnit specifies unit symbol associated with this well top set, i.e. s, ft, m, ms or undefined

The links section provides HATEOAS links to the "Well Top Data Web Service (v3)" service.

If the specified topsetuniqueid doesn't match a valid well top set, no JSON response will be provided. The HTTP response will only show a "InvalidUniqueId" (error 404) in its headers.