Oracle Cloud Infrastructure Documentation

Updating Mount Target Performance

The performance of a File Storage mount target is partially dependent upon the maximum throughput available to the mount target. A mount target can have a Standard performance level or a specific High Performance level.

Important

High performance mount targets require a 30-day commitment and are billed in 30-day cycles. When you change the performance of an existing mount target to a high performance shape, that 30-day billing cycle begins.

For specific pricing details, see Oracle Storage Cloud Pricing.

You can upgrade a mount target to a high performance mount target at any time. If requirements change, and you don't need the same performance, you can schedule a downgrade to occur at the end of the billing cycle.

For more information, see Mount Target Performance and Limitations and Considerations for mount targets.

Required IAM Policy

Permissions to manage mount targets include the ability to update mount target performance. Consider more restrictive permissions if you don't want managers to change performance levels. A more specific policy for mount target performance management follows:

allow group <groupName> to {MOUNT_TARGET_SHAPE_DOWNGRADE, MOUNT_TARGET_SHAPE_UPGRADE } in compartment <compartmentName>

If you're new to policies, see Getting Started with Policies and Details for the File Storage Service.

    1. Open the navigation menu and click Storage. Under File Storage, click Mount Targets.

    2. In the List scope section, under Compartment, select a compartment.

    3. Select the mount target for which you want to update performance.

    4. In the Performance section, next to Mount target throughput, change performance:

      • To upgrade performance, or schedule a performance downgrade, select Edit. Set the mount target read throughput. Select from:

        • 1 Gbps of throughput (Standard)
        • 20 Gbps of throughput (HPMT-20)
        • 40 Gbps of throughput (HPMT-40)
        • 80 Gbps of throughput (HPMT-80)
      • To cancel a scheduled performance downgrade, select Cancel scheduled downgrade.
    5. Select Save changes.

  • Use the oci fs mount-target upgrade-shape command and required parameters to immediately upgrade a mount target's performance level:

    oci fs mount-target upgrade-shape --mount-target-id <mount_target_OCID> --requested-throughput <performance_value>

    Use the oci fs mount-target schedule-downgrade-shape command and required parameters to downgrade a mount target's performance level at the end of its billing cycle:

    oci fs mount-target schedule-downgrade-shape --mount-target-id <mount_target_OCID> --requested-throughput <lower_performance_value>

    To cancel the scheduled downgrade of a mount target's performance level, use the oci fs mount-target cancel-downgrade-shape command:

    oci fs mount-target cancel-downgrade-shape --mount-target-id <mount_target_OCID>

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • To immediately upgrade the performance level of a mount target and start the billing cycle, run the UpgradeShapeMountTarget operation.

    To downgrade the performance level of a mount target at the end of its billing cycle, run the ScheduleDowngradeShapeMountTarget operation. To cancel a scheduled performance level downgrade, run the CancelDowngradeShapeMountTarget operation.

    To immediately release a mount target's resources, with the understanding that you'll still be billed for those resources until the cycle's end date, you can delete the mount target.

    For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.