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.
-
Flat (
flat) — files are placed directly in the section root; there are no nested directories. -
Tree (
tree) — nested directories of arbitrary depth are supported. Only in such sections are directory operations and downloading and uploading a directory as an archive available.
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.