Amazon S3 Object Storage Buckets and Folders

The /S3Resources resource collection represents Amazon S3 object storage buckets and folders.

Get Buckets

Returns a list of Amazon S3 buckets.

SecurityBearer
Request
query Parameters
accountId
required
string <uuid>

Specifies the identification number of the cloud account. For more information on how to get this parameter, see Get Accounts.

RegionType
required
string (AmazonS3AwsRegionType)

Specifies a region type.

Enum: "Global" "USGovernment" "China"
RegionId
string

Specifies a region ID to which the bucket belongs.

Name
string

Specifies a bucket name. To filter objects, you can use * and ? wildcard characters.

Responses
200

OK

default

Operation failure response.

get/v8/S3Resources/buckets
Request samples
Response samples
application/json
[
  • {
    }
]

Get Bucket by Name

Returns information about an Amazon S3 bucket with the specified name.

SecurityBearer
Request
path Parameters
Name
required
string

Specifies the bucket name. For more information on how to get this parameter, see Get Buckets.

query Parameters
accountId
required
string <uuid>

Specifies the identification number of the cloud account. For more information on how to get this parameter, see Get Accounts.

RegionType
required
string (AmazonS3AwsRegionType)

Specifies a region type.

Enum: "Global" "USGovernment" "China"
Responses
200

OK

default

Operation failure response.

get/v8/S3Resources/buckets/{Name}
Request samples
Response samples
application/json
{
  • "regionType": "Global",
  • "regionName": "string",
  • "regionId": "string",
  • "name": "string",
  • "_links": {
    }
}

Get Folders

Returns a list of Amazon folders created in the specified bucket.

SecurityBearer
Request
path Parameters
bucketName
required
string

Specifies the bucket name. For more information on how to get this parameter, see Get Buckets.

query Parameters
accountId
required
string <uuid>

Specifies the identification number of the cloud account. For more information on how to get this parameter, see Get Accounts.

RegionType
required
string (AmazonS3AwsRegionType)

Specifies a region type.

Enum: "Global" "USGovernment" "China"
Name
string

Specifies a folder name. To filter objects, you can use * and ? wildcard characters.

Responses
200

OK

default

Operation failure response.

get/v8/S3Resources/buckets/{bucketName}/folders
Request samples
Response samples
application/json
[
  • {
    }
]

Create Folders

Creates a new folder in the specified Amazon bucket.

x-codegen-request-body-name: folderJson
SecurityBearer
Request
path Parameters
bucketName
required
string

Specifies the bucket name. For more information on how to get this parameter, see Get Buckets.

query Parameters
accountId
required
string <uuid>

Specifies the identification number of the cloud account. For more information on how to get this parameter, see Get Accounts.

RegionType
required
string (AmazonS3AwsRegionType)

Specifies a region type.

Enum: "Global" "USGovernment" "China"
Request Body schema: application/json
required
name
string

Specifies a name for a new folder.

object (RESTLinkHALDictionary)

Related resources.

Responses
201

Created

default

Operation failure response.

post/v8/S3Resources/buckets/{bucketName}/folders
Request samples
application/json
{
  • "name": "string",
  • "_links": {
    }
}
Response samples
application/json
{
  • "path": "string",
  • "name": "string",
  • "_links": {
    }
}

Get Folder by Name

Returns information about an Amazon folder with the specified name.

SecurityBearer
Request
path Parameters
Name
required
string

Specifies the folder name. For more information on how to get this parameter, see Get Folders.

bucketName
required
string

Specifies the bucket name. For more information on how to get this parameter, see Get Buckets.

query Parameters
accountId
required
string <uuid>

Specifies the identification number of the cloud account. For more information on how to get this parameter, see Get Accounts.

RegionType
required
string (AmazonS3AwsRegionType)

Specifies a region type.

Enum: "Global" "USGovernment" "China"
Responses
200

OK

default

Operation failure response.

get/v8/S3Resources/buckets/{bucketName}/folders/{Name}
Request samples
Response samples
application/json
{
  • "path": "string",
  • "name": "string",
  • "_links": {
    }
}

Document updated 12/18/2025

Page content applies to build 8.3.0.2201