Cloud Storage Service

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

Authentication

HTTP Authentication, scheme: bearer

Object

Retrieve a signed URL for object file upload.

Code samples

URL obj = new URL("/cloud-storage/projects/{projectId}/upload-url?object_name=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

GET /cloud-storage/projects/{projectId}/upload-url

This endpoint provides a signed URL for uploading the specified object file.
You need to call the returned signed-url using the "PUT" HTTP method with the file included in the request body.

Parameters

Name	In	Type	Required	Description
projectId	path	integer	true	The ID of the project to be accessed.
object_name	query	string	true	The name of the object file to be uploaded.

Example responses

200 Response

"https://example.url/ex?ex=e"

default Response

{
  "code": "string",
  "message": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Operation successful.	string
default	Default	An unexpected error occurred.	Inline

Response Schema

Status Code default

Name	Type	Required	Restrictions	Description
» code	string	true	none	none
» message	string	true	none	none

Download an object file.

Code samples

URL obj = new URL("/cloud-storage/projects/{projectId}/download?object_name=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

GET /cloud-storage/projects/{projectId}/download

This endpoint retrieves an object file from the specified project ID's folder.

Parameters

Name	In	Type	Required	Description
projectId	path	integer	true	The ID of the project to be accessed.
object_name	query	string	true	The name of the object file to be downloaded.

Example responses

200 Response

default Response

{
  "code": "string",
  "message": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Operation successful. The response includes a binary string body.	string
default	Default	An unexpected error occurred.	Inline

Response Schema

Status Code default

Name	Type	Required	Restrictions	Description
» code	string	true	none	none
» message	string	true	none	none

Retrieve a signed URL for object file download.

Code samples

URL obj = new URL("/cloud-storage/projects/{projectId}/download-url?object_name=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

GET /cloud-storage/projects/{projectId}/download-url

This endpoint provides a signed URL for downloading the specified object file.
The returned signed URL should be invoked using the "GET" method.

Parameters

Name	In	Type	Required	Description
projectId	path	integer	true	The ID of the project to be accessed.
object_name	query	string	true	The name of the object file to be downloaded.
url_duration	query	string	false	The duration for which the download URL should be valid.

Example responses

200 Response

"https://example.url/ex?ex=e"

default Response

{
  "code": "string",
  "message": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Operation successful.	string
default	Default	An unexpected error occurred.	Inline

Response Schema

Status Code default

Name	Type	Required	Restrictions	Description
» code	string	true	none	none
» message	string	true	none	none

List object attributes.

Code samples

URL obj = new URL("/cloud-storage/projects/{projectId}/list?path=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

GET /cloud-storage/projects/{projectId}/list

This endpoint lists the attributes (name & size) of objects located at the specified path.

Parameters

Name	In	Type	Required	Description
projectId	path	integer	true	The ID of the project to be accessed.
path	query	string	true	The path from which to retrieve objects.

Example responses

200 Response

[
  {
    "name": "string",
    "size": 0
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	Operation successful.	Inline
default	Default	An unexpected error occurred.	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» name	string	true	none	none
» size	integer	true	none	none

Status Code default

Name	Type	Required	Restrictions	Description
» code	string	true	none	none
» message	string	true	none	none

Delete an object file.

Code samples

URL obj = new URL("/cloud-storage/projects/{projectId}/delete?object_name=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("DELETE");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

DELETE /cloud-storage/projects/{projectId}/delete

This endpoint deletes the specified object file from the project ID's folder.

Parameters

Name	In	Type	Required	Description
projectId	path	integer	true	The ID of the project to be accessed.
object_name	query	string	true	The name of the object file to be deleted.

Example responses

default Response

{
  "code": "string",
  "message": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	Operation successful. In the absence of automatic redirection, a 307 response will be received with the signed URL located in the 'Location' header.	None
default	Default	An unexpected error occurred.	Inline

Response Schema

Status Code default

Name	Type	Required	Restrictions	Description
» code	string	true	none	none
» message	string	true	none	none

Schemas

ObjectInfo

{
  "name": "string",
  "size": 0
}

Properties

Name	Type	Required	Restrictions	Description
name	string	true	none	none
size	integer	true	none	none

Error

{
  "code": "string",
  "message": "string"
}

Properties

Name	Type	Required	Restrictions	Description
code	string	true	none	none
message	string	true	none	none

Essential Cookies

These cookies are essential as they enable you to move around the website. This category cannot be disabled.

Analytical/Performance Cookies

These cookies collect information about how you use our website. for example which pages you visit most often. All information these cookies collect is used to improve how the website works.

Functionality Cookies

These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and tailor the website to provide enhanced features and content for you.

Advertising Cookies

These cookies gather information about your browser habits. They remember that you've visited our website and share this information with other organizations such as advertisers.

Cloud Storage Service

Authentication

Object

Retrieve a signed URL for object file upload.

Parameters

Responses

Response Schema

Download an object file.

Parameters

Responses

Response Schema

Retrieve a signed URL for object file download.

Parameters

Responses

Response Schema

List object attributes.

Parameters

Responses

Response Schema

Delete an object file.

Parameters

Responses

Response Schema

Schemas

ObjectInfo

Properties

Error

Properties

Manage Your Cookies

Essential Cookies

Analytical/Performance Cookies

Functionality Cookies

Advertising Cookies

Preferences Submitted