Ordering File Storage for Classic

Ordering File Storage for Classic in the console

1. Log in to the IBM Cloud® catalog and click Storage. Then, select File Storage for Classic. Click Create.

2. Select your deployment location (region, location, zone).

   • Ensure that the new file share is added in the same location as the Compute host or hosts that you have.

3. Billing. You can choose between Monthly or Hourly Billing.

   • With hourly billing, the number of hours that the file volume existed on the account is calculated at the time the volume is deleted or at the end of the billing cycle. Which ever comes first. Hourly billing is a good choice for storage that is used for a few days or less than a full month.
   • With monthly billing, the calculation for the price is pro-rated from the date of creation to the end of the billing cycle and billed immediately. If a file volume is deleted before the end of the billing cycle, the difference is not refunded. Monthly billing is a good choice for storage that is used in production workloads that use data that needs to be stored and accessed for long periods of time (month or longer).

4. Enter your storage size in the Size field.

5. Select the size of the Snapshot space from the list.

   This space is in addition to your usable space. For snapshot space considerations and recommendations, read Ordering Snapshots.

6. Select your IOPS profile. You can choose between the predefined values of Endurance (Tiers) or enter your custom IOPS value for Performance.

7. In the side panel, review your order summary, and apply your Promo Code if you have one.

   Discounts are applied when the order is processed.

8. Review your order, and read the service agreement. If you agree with the terms, check the box.

9. Click Create. Your new storage allocation is available in a few minutes.

Ordering File Storage for Classic from the CLI

Before you begin, decide on the CLI client that you want to use.

• You can either install the IBM Cloud CLI and install the SL plug-in with ibmcloud plugin install sl. For more information, see Extending IBM Cloud CLI with plug-ins.
• Or, you can install the SLCLI.

Each order must have an associated location (data center). When you order File Storage for Classic, make sure that it is provisioned in the same location as your Compute instances.

$ ibmcloud sl file volume-order --storage-type endurance --size 500 --tier 4 -d dal13 --snapshot-size 500
This action will incur charges on your account. Continue?> y
OK
Order 110526870 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)

You may run 'ibmcloud sl file volume-list --order 110526870' to find this file volume after it is ready.

$ slcli file volume-order --storage-type performance --size 20 --location dal10 --iops 100
Order #32076317 placed successfully!
> Storage as a Service
> File Storage
> 20 GBs
> 100 IOPS

Ordering File Storage for Classic with the API

The method order_file_volume (storage_type, location, size, iops=None, tier_level=None, snapshot_size=None, service_offering='storage_as_a_service', hourly_billing_flag=False) places an order for a file share.

You must specify the following parameters for a successful order.

• storage_type – "performance" or "endurance".
• location – Data center in which to order the share.
• size – Size of the new volume, in GB.
• iops – Number of IOPS for a “Performance” order.
• tier_level – Tier level to use for an “Endurance” order.
• snapshot_size – The size of optional snapshot space, if snapshot space is also to be ordered. (None if not ordered.)
• service_offering – Requested offering package to use in the order ("storage_as_a_service").
• hourly_billing_flag – Billing type, monthly (False) or hourly (True), default to monthly.

To be able to access all the new features, order Storage-as-a-Service Package 759.

For more information about ordering File Storage for Classic through the API, see order_file_volume.

Ordering File Storage for Classic with Terraform

To use Terraform, download the Terraform CLI and configure the IBM Cloud Provider plug-in. For more information, see Getting started with Terraform.

resource "ibm_storage_file" "fs_endurance" {
  type       = "Endurance"
  datacenter = "dal09"
  capacity   = 20
  iops       = 0.25

  # Optional fields
  allowed_virtual_guest_ids = ["28961689"]
  allowed_subnets           = ["10.146.139.64/26"]
  allowed_ip_addresses      = ["10.146.139.84"]
  snapshot_capacity         = 10
  hourly_billing            = true

  # Optional fields for snapshot
  snapshot_schedule {
    schedule_type   = "WEEKLY"
    retention_count = 20
    minute          = 2
    hour            = 13
    day_of_week     = "SUNDAY"
    enable          = true
  }
}

resource "ibm_storage_file" "fs_performance" {
  type       = "Performance"
  datacenter = "dal09"
  capacity   = 20
  iops       = 100

  # Optional fields
  allowed_virtual_guest_ids = ["28961689"]
  allowed_subnets           = ["10.146.139.64/26"]
  allowed_ip_addresses      = ["10.146.139.84"]
  hourly_billing            = true
}