VoSpace 2.x

DeleteNode

Delete a node from VoSpace .

Parameters

• Target - The URI of an existing data node. note
  • vos://[service]/000-517
  • vos:///000-517
  • vos://[service]/path/my%20results
  • vos:///path/my%20results
  • vos:///my%20results

Returns

For a synchronous operation, this method returns void.

Throws

• The service will throw a NodeNotFound exception if the target node does not exist.

• The service may throw an InternalFault exception if an operation fails.
• The service may throw a PermissionDenied exception if the user does not have permissions to perform the operation.

• The service will throw a LinkFound exception if the target path includes a link. note

Notes

• If the target node is a link, then this will delete the link, not the node the link points to.

• The <target> identifier in the request can be full a URI including the service identifier and node path.
  • vos://[service]/000-517
  • vos://[service]/path/my%20results

• The <target> identifier in the request can be a relative URI just containing the node path.
  • vos:///000-517
  • vos:///path/my%20results

• Link nodes are not part of the V1.0 specification, they will be defined in a future version of the specification.
• LinkFound exceptions are defined in this version of the specification to enable future versions to extend the current interface, rather than require a completely new interface type.

• There is a strong case for making this an asynchronous operation.
• Recursive deletion of a deep tree of nodes may take time, and could throw permissions errors late in the sequence.

Questions

• Should the <target> identifier be a full URIs or just the local path ?
• For a recursive delete of a tree, should the service check permissions on each child node ?

-- DaveMorris - 18 May 2006