Oracle Cloud Infrastructure Documentation

Managing File Systems

In the File Storage service, file systems are associated with a single compartment. When you select a compartment, the Console displays all file systems in the compartment. You can also see mount targets and snapshots associated with each file system. The compartment has policies that indicate what actions a user can perform on a file system. UNIX permissions control what actions a user can take on the files stored in the file system. See About Security for more information.

Actions you can take to manage a file system include:

  • Viewing file system details
  • Editing file system settings
  • Viewing associated file system resources
  • Associating a new or previously created mount target with a file system
  • Deleting a file system

You can perform most administrative tasks for your file systems using the Console, Command Line Interface (CLI), or API. You can use the Console to list mount targets exporting a specific file system. Use the API or CLI if you want to list all mount targets in a compartment.

To mount a file system to write files, use a command window on Ubuntu and Linux systems. For more information, see Mounting File Systems.

Details About Your File System

The file system details page provides the following information about your file system:

File System OCID
Every Oracle Cloud Infrastructure resource has an Oracle-assigned unique ID called an Oracle Cloud Identifier (OCID). You need your file system's OCID to use the Command Line Interface (CLI) or the API. You'll also need it when contacting support.
Availability Domain
When you create a file system, you specify the availability domain that it resides in. An availability domain is one or more data centers located within a region. You need your file system's availability domain to use the Command Line Interface (CLI) or the API. For more information, see Regions and Availability Domains.
Launched
The date and time that the file system was launched.
Compartment
When you create a file system, you specify the compartment that it resides in. A compartment is a collection of related resources (such as cloud networks, compute instances, or file systems) that are only accessible to those groups that have been given permission by an administrator in your organization. You need your file system's compartment to use the Command Line Interface (CLI) or the API. For more information, see Managing Compartments.
Utilization
Storage provisioning is fully managed and automatic as your usage scales up and down. File system utilization is calculated by block usage. We use a variable block size optimized for best performance.
Important

There can be a delay of up to 1 hour when reporting file system usage.
Resources
Resources such as mount targets and snapshots that are associated with the file system are listed here. Click on the resource type link to see a list of each individual resource. Each mount target in the list contains an export path for the file system. You need the export path to mount a file system.

Warning

Avoid entering confidential information when assigning descriptions, tags, or friendly names to your cloud resources through the Oracle Cloud Infrastructure Console, API, or CLI.

Required IAM Service Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. you should work in.

For administrators: The policy in Let users create, manage, and delete file systems allows users to manage file systems.

If you're new to policies, see Getting Started with Policies and Common Policies.

Tagging Resources

You can apply tags to your resources to help you organize them according to your business needs. You can apply tags at the time you create a resource, or you can update the resource later with the desired tags. For general information about applying tags, see Resource Tags.

Using the Console

To view file system details
To add a mount target to a file system
To manage tags for a file system
To delete a file system

Using the Command Line Interface (CLI)

For information about using the CLI, see Command Line Interface (CLI).

To list file systems
To get a specific file system
To update a file system
To delete a file system
To set the file system reported free space

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use the following operations to manage file systems: