CloudCron Schedule Next API

S3

Endpoint:https://api.cloudharness.com

List available S3 buckets

GET
https://api.cloudharness.com
/v1/s3/buckets

List available S3 bucketsHeaders

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List available S3 bucketsResponses

OK

  • successboolean · required
  • metadataobject · required
  • statusstring · required

    Descriptive status message

  • dataobject

List objects in a specified bucket

GET
https://api.cloudharness.com
/v1/s3/{bucket}

List objects in a specified bucketpath Parameters

  • bucketstring · required

List objects in a specified bucketquery Parameters

  • prefixstring
  • maxKeysinteger · min: 1 · max: 1000
    Default: 1000
  • continuationTokenstring

List objects in a specified bucketHeaders

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List objects in a specified bucketResponses

OK

  • successboolean · required
  • metadataobject · required
  • statusstring · required

    Descriptive status message

  • dataobject

Retrieve metadata for a specific object

GET
https://api.cloudharness.com
/v1/s3/{bucket}/{object_key}

Retrieve metadata for a specific objectpath Parameters

  • bucketstring · required
  • object_keystring · required

Retrieve metadata for a specific objectHeaders

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Retrieve metadata for a specific objectResponses

OK

  • successboolean · required
  • metadataobject · required
  • statusstring · required

    Descriptive status message

  • dataobject

Upload an object to a bucket

PUT
https://api.cloudharness.com
/v1/s3/{bucket}/{object_key}

Uploads or overwrites an object in the specified bucket. Returns metadata for the stored object.

  • 200 indicates an overwrite of an existing key.
  • 201 indicates a new object was created.

Upload an object to a bucketpath Parameters

  • bucketstring · required
  • object_keystring · required

Upload an object to a bucketHeaders

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Upload an object to a bucketRequest Body

  • filestring · binary · required
  • contentTypestring

    Optional content type to set for the object

Upload an object to a bucketResponses

OK (overwrote existing object)

  • successboolean · required
  • metadataobject · required
  • statusstring · required

    Descriptive status message

  • dataobject

Delete a specific object

DELETE
https://api.cloudharness.com
/v1/s3/{bucket}/{object_key}

Delete a specific objectpath Parameters

  • bucketstring · required
  • object_keystring · required

Delete a specific objectHeaders

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Delete a specific objectResponses

OK

  • successboolean · required
  • metadataobject · required
  • statusstring · required

    Descriptive status message

  • dataobject