Targets

These are various directories for storing files, each with a special purpose and use in the system.

Overview

Each section is a root directory with its own address /rest/v1/fs/targets/<section>. Within a section, files are addressed by a path relative to its root.

By design, sections are divided into two kinds. The section kind comes in the structure field of the section description.

The composition of available sections differs by domains and roles. Some sections belong to the entire system and are available only in the master domain; some store data of a specific domain and are available in working domains; some are available in any domain. In addition to the domain type, the account’s role policy is taken into account, so two accounts of the same domain may see a different composition of sections.

A machine-readable description of the sections available to the account in the current domain — design, method set, restrictions, and cautious operation flags — is returned by GET /rest/v1/fs/targets, see Section descriptions. GET /rest/v1/fs/targets/ with a trailing slash returns only the list of section names.