Veritas NetBackup™ DataStore SDK Programmer's Guide for XBSA 1.1.0
- Introduction to NetBackup XBSA
- How to set up the SDK
- Using the NetBackup XBSA interface
- NetBackup XBSA data structures
- NetBackup XBSA environment
- XBSA sessions and transactions
- Creating a NetBackup XBSA application
- Initiating a session
- Backup - creating an object
- Query - finding an object descriptor
- Restore - retrieving an object's data
- Delete - deleting an object or image
- Media IDs - obtaining media IDs
- How to build an XBSA application
- How to run a NetBackup XBSA application
- About How to run a NetBackup XBSA application
- API reference
- Function calls
- Function specifications
- Type definitions
- Process flow and troubleshooting
- How to use the sample files
- Support and updates
- Appendix A. Register authorized locations
Delete - deleting an object or image
Deleting a NetBackup XBSA object is done with the BSADeleteObject() function. BSADeleteObject() does not always delete the object specified, even if it returns a success status. The only objects that can be deleted using BSADeleteObject() are objects in which there was only one object created per transaction.
Based on those limitations, the BSADeleteObject() function is pretty straightforward. It takes a copyId as its parameter and deletes this object. Multiple objects can be deleted in one transaction and it is permissible to have query operations within a delete transaction. The object is not deleted until the transaction is committed, so these query operations in a delete transaction can return a deleted object.
Deleting a NetBackup image is done with the NBBSADeleteImage() function. NBBSADeleteImage() deletes an entire image that can contain one or more objects created per transaction.
The NBBSADeleteImage() function takes a copyId of any object contained in the image as its parameter and deletes the entire image. Multiple images can be deleted in one transaction and it is permissible to have query operations within a delete transaction. Unlike BSADeleteObject(), the deletion of the image takes place during the NBBSADeleteImage() call.
Deletion only removes an entry from the NetBackup catalog and not from the storage media. NetBackup allows media to be imported to recreate all of the images that are stored on them, and doing so may cause a deleted object or image to reappear.