Using cURL Commands with Swarm Storage and Gateway
Note
If you are using Gateway instead of a Swarm Storage node, remove the --post301 --location-trusted
cURL options and you must add -u '<gateway username>:<password>'
for Gateway authentication.
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://ipaddress/api?domain=domain&createdomain"
Notes: Replace
domain
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://ipaddress/api/testbucket?domain=domain"
Notes: Replace
domain
with the appropriate domain andtestbucket
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://ipaddress/api/testbucket/NamedObject-$i.txt?domain=domain" -u "admin:admin"; done
Notes: Replace
yourFileName
with the file you are uploading, anddomain
with the domain. Adjust the number of iterations ({1..10}
) as needed.
Upload a Single Object
To upload a single object to a bucket:
Notes: Replace
yourFileName
with the file you are uploading, anddomain
with the domain.
Managing Objects and Domains
Enable Policy Versioning on a Domain
To enable policy versioning on a domain:
Notes: Replace
domain
with the target domain.
Check Object Integrity
To check the integrity of an object:
Notes: Replace
ObjectName.txt
with the object's name, anddomain
with the domain.
Capture Manifest of a Version
To retrieve the manifest of a specific version of an object:
Notes: Replace
versionID
with the version identifier.
List All Information of an EC Object
To get the detailed information about an erasure-coded object:
Notes: Replace
ObjectName.txt
with the object's name, anddomain
with the domain.
Setting Cluster and Node Configurations
Update Cluster Setting
To update a cluster setting, such as erasure coding conversion percentage:
Notes: Replace
ec.conversionPercentage?value=40
with the desired setting and its value, andipaddress:port
with your cluster's address.
Configure Node Setting
To configure node-level settings, such as health limits:
Notes: Replace
health.neonatalAgeLimit?value=30
with the desired cluster setting and its value, andipaddress:port
with the node's address.
Additional Operations
Change Admin Password
To update the admin password for a cluster:
Notes: Replace
newPassword
andoldPassword
with the appropriate values.
Set Lifepoint
To configure the lifepoint for an object:
Notes: Replace
[Date]
with the desired date format like [Wed, 20 Oct 2025 11:08:00 GMT] anddomain
with the domain.
Delete a Bucket
To remove a bucket and all its contained objects:
Notes: Replace
domain
with the domain.
Create an EC Object
To create an erasure-coded object wih the specified encoding:
Notes: Replace
yourFileName
with the file to be used anddomain
with the domain.
General Tips
Replace Placeholders: Always replace
ipaddress
,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 and Gateway using cURL commands. For further details or troubleshooting, refer to the SWARM Storage documentation or your internal support resources.
For Waggle API documentation, please refer to https://docs.cloud.caringo.com/internal/swarm-storage-api.html
© DataCore Software Corporation. · https://www.datacore.com · All rights reserved.