4.17. storageconnection
The
storageconnection
resource type allows you to add, edit, and delete storage connections.
Name | Type | Description | Required | User Creatable | User Updatable |
---|---|---|---|---|---|
--address
|
string
|
The hostname or IP address of the storage domain.
|
Yes (NFS and iSCSI only)
|
Yes
|
Yes
|
--correlation_id
|
string
|
A tagging identifier for the storage connection.
|
No
|
No
|
Yes
|
--expect
|
'201-created'
|
Request becomes asynchronous until the expected HTTP header is returned. Useful for long-running tasks that would otherwise return as successful before the task is completed.
|
No
|
No
|
No
|
--iqn
|
string
|
The target IQN for the storage device.
|
Yes (iSCSI only)
|
Yes
|
Yes
|
--mount_options
|
string
|
The options for mounting the PosixFS share.
|
No
|
Yes
|
Yes
|
--nfs_retrans
|
integer
|
The number of retransmissions the NFS client will attempt to complete a request.
|
No
|
Yes
|
Yes
|
--nfs_timeo
|
integer
|
The amount of time, in deciseconds, the NFS client will wait for a request to complete.
|
No
|
Yes
|
Yes
|
--nfs_version
|
string
|
The version of NFS used.
|
No
|
Yes
|
Yes
|
--password
|
string
|
A CHAP password for logging into a target of an iSCSI storage domain.
|
No
|
Yes
|
Yes
|
--path
|
string
|
The mounted file path of the storage domain. The path cannot be updated to one already used by a storage connection.
|
Yes (NFS, local, and PosixFS only)
|
Yes
|
Yes
|
--port
|
integer
|
The TCP port used for the iSCSI storage domain.
|
Yes (iSCSI only)
|
Yes
|
Yes
|
--storagedomain-identifier
|
string
|
A reference to a storage domain for the disk.
|
No
|
No
|
No
|
--type
|
string
|
The type of storage domain.
|
Yes
|
Yes
|
No
|
--username
|
string
|
A CHAP user name for logging into a target of an iSCSI storage domain.
|
No
|
Yes
|
Yes
|
--vfs_type
|
string
|
The Linux-supported file system type of the PosixFS share.
|
Yes (PosixFS only)
|
Yes
|
Yes
|
Example 4.35. Creating a new storage connection
[RHEVM shell (connected)]# add storageconnection --address storage.example.com --path /storage/nfs --type nfs