42 Storage Property

This section describes the Compute Classic CLI commands that you can use to view storage properties.

Storage properties are used to determine the placement of storage volume when a volume is created.

You must specify a storage property while creating a storage volume. For storage volumes that require low latency and high IOPS, such as for storing database files, select the /oracle/public/storage/latency storage property. For all other storage volumes, select /oracle/public/storage/default.

Before running the CLI commands described in this section, make sure that you've installed the CLI client and set up the required environment variables as described in Preparing to Use the CLI.

storage-property list

Retrieves details of all the storage properties in the specified container.

Required Role

To complete this task, you must have the Compute_Monitor or Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Syntax

opc compute storage-property list container [--name name]

For help with the parameters and options of this command, run the command with the -h option.

Example

opc -f json compute storage-property list /oracle/public

Sample Output

Some lines have been truncated with ellipses (...) for readability. When you run the command in your environment, you'll see the full output.

{
 "result": [
  {
   "description": "Default storageproperty for all StoragePools and StorageVolumes",
   "name": "/oracle/public/storage/default",
   "uri": "https://api-z999.compute.us0.oraclecloud.com/property/storage/oracle/public/storage/default"
  },
  {
   "description": "for accessing iSCSI volumes optimized for latency",
   "name": "/oracle/public/storage/latency",
   "uri": "https://api-z999.compute.us0.oraclecloud.com/property/storage/oracle/public/storage/latency"
  },
  {
   "description": "Default property used for storing snapshot",
   "name": "/oracle/public/storage/snapshot/default",
   "uri": "https://api-z999.compute.us0.oraclecloud.com/property/storage/oracle/public/storage/snapshot/default"
  }
 ]
}

Note:

Other storage properties might be listed. But don’t use any of them. For storage volumes that require low latency and high IOPS, such as for storing database files, select /oracle/public/storage/latency. For all other storage volumes, select /oracle/public/storage/default.

storage-property discover

Retrieves a list of the storage properties in the specified container.

Required Role

To complete this task, you must have the Compute_Monitor or Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Syntax

opc compute storage-property discover container

For help with the parameters and options of this command, run the command with the -h option.

Example

opc -f json compute storage-property discover /oracle/public/storage

Sample Output

{
 "result": [
  "/oracle/public/storage/default",
  "/oracle/public/storage/latency",
  "/oracle/public/storage/snapshot/"
 ]
}

storage-property get

Retrieves details of the specified storage property.

Required Role

To complete this task, you must have the Compute_Monitor or Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Syntax

opc compute storage-property get name

For help with the parameters and options of this command, run the command with the -h option.

Example

opc -f json compute storage-property get /oracle/public/storage/default

Sample Output

{
   "description": "Default storageproperty for all StoragePools and StorageVolumes",
   "name": "/oracle/public/storage/default",
   "uri": "https://api-z999.compute.us0.oraclecloud.com/property/storage/oracle/public/storage/default"
}