CreateNode^?

Creates a new node in a space.

This is the primary method for creating new nodes in a VoSpace^? service.

The initial V1.0 specification only supports data nodes.

Parameters

• Name - A (optional) human readable name for the new node. note
  • my results

• Properties - An optional set of name value properties for the new node

Returns

A full <node> element for the new node, containing

• The full URI encoded identifier for the new node. note
  • vos://[service]/000-517
  • vos://[service]/my%20results
  • vos://[service]/path/path/my%20results

• Properties - The set of name value properties for the new node

Throws

• The service will throw a DuplicateNode exception if a node already exists with the same name.

• The service may throw an OperationNotSupported exception if it does not support user defined names.

• 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.

Notes

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

• If the <name> in the request is null or empty, then the service will generate a new unique name for the node.

• Name cannot contain a '/'

Questions

-- DaveMorris - 16 May 2006