We have released new version 3.0.0 of our BlackPearl Software Development Kit (SDK) for C#/.NET. It is now available for download on GitHub. You can also view code documentation, code examples, and installation instructions on our Documentation page.
This new SDK is compatible with our current BlackPearl 3.0.1 release and allows access to all BlackPearl 3.0 API commands. Note that the previous version of the C#/.NET SDK (1.2.5) is also compatible with the current BlackPearl 3.0.1 release but does not give access to all API commands.
We call this 3.0.0 release a “Release Candidate” (RC) because, while it has been tested internally, it is not yet in use by any of our partners or customers.
If you have any questions or run into any problems, please post your questions to our Forum.
The following Global Bucket ACL permissions can be granted to users and groups:
List -- The user can see all buckets and can list the objects in all buckets.
Read -- The user can get objects and create GET jobs in all buckets.
Write -- The user can put objects and create PUT jobs in all buckets.
Delete -- The user can delete objects in all buckets, but cannot delete buckets.
Job -- The user can modify or cancel jobs in all buckets created by other users. The user can also see the details of jobs created by other users. Note that all users can view all jobs, but by default, only the initiator of the job can see the full details of a job.
Owner -- The user receives full access to all buckets, including all permissions listed above.
How to Use Global Bucket ACLs
Allowing certain users to access all the buckets on a BlackPearl system might be a key administration requirement at some BlackPearl sites.
In the below example the user has been granted global “List” rights. This means when this user logs in not only can they list every bucket on the system they can also list the contents of every bucket.
The Java Command Line Interface (CLI) is a simple BlackPearl client can be used to view these settings in action. The Java CLI get_service command will provide a list of all buckets on the BlackPearl to which a user has access. Because the user account being used by the Java CLI has global “List” rights, all buckets on the BlackPearl are displayed as shown below.
The “List” rights also allow the user to get a list of objects in a bucket, in this case the “Jom” bucket. The results are shown below.
The user does not have rights to retrieve/GET objects from any buckets. As shown in the image below, if the user attempts to get a file, they receive an error.
We could give the user the ability to retrieve/GET objects from BlackPearl by checking the “Read” permission box as shown in the image below.
When to Use Global Bucket ACLs
The main reason to use Global Bucket ACLs is for ease of administration. Use of Global Bucket ACLs could allow a user or set of users to administer all the buckets without having to log in with the primary administrator “Spectra” user account. One way to do that would be to set up a group of users and to apply the Global Bucket ACLs to that group. That way there is no need to edit individual user accounts to change access levels. You just simply add or remove users from the group. You can see an example below in the group settings dialog.
By using the Global Bucket ACLs, users are being granted access not only to existing buckets, but also buckets that will be created in the future. This may save the administrator the time of having to grant access to individual buckets as the buckets are created.