File Stores

The File stores API returns a list of all storage units in the cloud account, and indicates which units are protected by File Storage Security and which are not. The storage unit type depends on your cloud accounts -- S3 buckets in AWS, storage accounts in Azure and storage buckets in GCP.

Prerequisite: To use the API you need a cloud account in Trend Micro Cloud One. See How to set up an AWS cloud account.

List File Stores

get/file-stores

List the file storage units in your cloud accounts. The File Stores API can be run on your cloud accounts on a set schedule using a job scheduler. There will be some delay to see the latest file stores in the API response. You can check the 'monitoredBy' attribute to see whether a file storage unit is protected by File Storage Security or not. Currently, the API only supports listing S3 Buckets in AWS.

SecurityTrend Micro Cloud One API Key
Request
query Parameters
cursor
string <byte>

An encoded value used to retrieve the next set of results for a query that returns more than limit results.

limit
integer <= 100
Default: 25

The maximum number of records to return.

provider
string

Cloud provider. If this parameter is not provided, the query will return file stores of all cloud providers in the Cloud One account. Currently support AWS only

Value: "aws"
providerAccount
string

Cloud account. If this parameter is not provided, the query will return file stores of all cloud accounts in the Cloud One account.

header Parameters
Api-Version
required
any

API version.

Example: v1
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too Many Requests

500

Internal Server Error

503

Service Unavailable

Response samples
application/json
{
  • "fileStores": [
    ],
  • "next": "dGhpcyB2YWx1ZSBpcyBvcGFxdWUsIGRlY29kaW5nIGl0IHdvbid0IGJlIHVzZWZ1bAo="
}