Using cURL Commands with Swarm Storage and Gateway

This document provides instructions for using curl commands to interact with SWARM Storage. Commands are organized into categories for creating and managing domains, buckets, objects, and configurations.

Creating Domains and Buckets

Create a Domain

To create a new domain in SWARM Storage, use the following command:

curl -i --location-trusted --post301 --data-binary "" "http://hostname/api?domain=yourDomainName&createdomain"

• Notes: Replace yourDomainName with the desired domain name.

Create a Bucket

To create a bucket within a specified domain, use this command:

curl -i --location-trusted --post301 -XPOST --data-binary "" "http://hostname/api/testbucket?domain=yourDomainName"

• Notes: Replace yourDomainName with the appropriate domain and testbucket with the bucket name.

Uploading Objects

Upload Multiple Objects

To upload multiple objects to a bucket, use the following loop:

for i in {1..10}; do curl -i --location-trusted -XPOST --post301 --data-binary @yourFileName "http://hostname/api/testbucket/NamedObject-$i.txt?domain=yourDomainName" -u "admin:admin"; done

• Notes: Replace yourFileName with the file you are uploading, and yourDomainName with the domain. Adjust the number of iterations ({1..10}) as needed.

Upload a Single Object

To upload a single object to a bucket:

curl -i --location-trusted --post301 -XPOST --data-binary @yourFileName "http://hostname/api/testbucket/NamedObject.txt?domain=yourDomainName"

• Notes: Replace yourFileName with the file you are uploading, and yourDomainName with the domain.

Setting Cluster and Node Configurations

Update Cluster Setting

To update a cluster setting, such as erasure coding conversion percentage:

curl -X PUT --header "Content-Type: application/json" --header "Accept: text/plain" -d "{}" "http://hostname:port/api/storage/clusters/_self/settings/ec.conversionPercentage?value=40" --digest -u "admin:password"

• Notes: Replace ec.conversionPercentage?value=40 with the desired setting and its value, and hostname:port with your cluster's address.

Configure Node Setting

To configure node-level settings, such as health limits:

curl -i --location-trusted -X PUT --header "Content-Type: application/json" --header "Accept: text/plain" -d "{}" "http://hostname:port/api/storage/nodes/_self/settings/health.neonatalAgeLimit?value=30" -u "admin:password"

• Notes: Replace health.neonatalAgeLimit?value=30 with the desired cluster setting and its value, and hostname:port with the node's address.

Managing Objects and Domains

Enable Policy Versioning on a Domain

To enable policy versioning on a domain:

curl -i --location-trusted -XPUT --post301 --data-binary '' -H "Policy-Versioning: enabled" "http://hostname/api?domain=yourDomainName&replicate=immediate&admin" -u "admin:password"

• Notes: Replace yourDomainName with the target domain.

Check Object Integrity

To check the integrity of an object:

curl -i --location-trusted "http://hostname/api/testbucket/ObjectName.txt?domain=yourDomainName&checkintegrity"

• Notes: Replace ObjectName.txt with the object's name, and yourDomainName with the domain.

Capture Manifest of a Version

To retrieve the manifest of a specific version of an object:

curl -i --location-trusted "http://hostname/api/testbucket/ObjectName.txt?domain=yourDomainName&readmanifest&version=versionID"

• Notes: Replace versionID with the version identifier.

List All Information of an EC Object

To get the detailed information about an erasure-coded object:

curl -i --location-trusted "http://hostname/api/testbucket?domain=yourDomainName&format=json&name=ObjectName.txt&versions&field=all"

• Notes: Replace ObjectName.txt with the object's name, and yourDomainName with the domain.

Additional Operations

Change Admin Password

To update the admin password for a cluster:

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' 'http://hostname:port/api/storage/clusters/_self/administrators/admin?password=newPassword' -u admin:oldPassword

• Notes: Replace newPassword and oldPassword with the appropriate values.

Set Lifepoint

To configure the lifepoint for an object:

curl -v --post301 -XPOST -H 'Content-type: text/html' -H 'lifepoint: [Date] reps=2, deletable=False, [] delete' --location-trusted 'http://hostname/api/bucket/lifePointObject?domain=yourDomainName'

• Notes: Replace [Date] with the desired date format like [Wed, 20 Oct 2025 11:08:00 GMT] and yourDomainName with the domain.

Delete a Bucket

To remove a bucket and all its contained objects:

curl -i --location-trusted -XDELETE "http://hostname/api/testbucket?domain=yourDomainName&recursive=now"

• Notes: Replace yourDomainName with the domain.

Create an EC Object

To create an erasure-coded object wih the specified encoding:

curl -i --location-trusted --post301 --data-binary @yourFileName "http://hostname/api/testbucket/ec-named-1.txt?domain=yourDomainName&erasurecoded=yes&encoding=2:2"

• Notes: Replace yourFileName with the file to be used and yourDomainName with the domain.

General Tips

• Replace Placeholders: Always replace hostname, domain, yourFileName, and other placeholders with actual values relevant to your environment.

• Permissions: Ensure that you have the necessary permissions for performing these operations.

• Security: Use secure methods for handling sensitive information like passwords.

This document provides a structured approach to managing SWARM Storage using curl commands. For further details or troubleshooting, refer to the SWARM Storage documentation or your internal support resources.