osc block-storage attachment create354

Create an attachment.

This method can be used to create an empty attachment (reserve) or to create and initialize a volume attachment based on the provided input parameters.

If the caller does not yet have the connector information but needs to reserve an attachment for the volume (ie Nova BootFromVolume) the create can be called with just the volume-uuid and the server identifier. This will reserve an attachment, mark the volume as reserved and prevent any new attachment_create calls from being made until the attachment is updated (completed).

The alternative is that the connection can be reserved and initialized all at once with a single call if the caller has all of the required information (connector data) at the time of the call.

NOTE: In Nova terms server == instance, the server_id parameter referenced below is the UUID of the Instance, for non-nova consumers this can be a server UUID or some other arbitrary unique identifier.

Starting from microversion 3.54, we can pass the attach mode as argument in the request body.

Expected format of the input parameter 'body':


{ "attachment": { "volume_uuid": "volume-uuid", "instance_uuid": "null|nova-server-uuid", "connector": "null|<connector-object>", "mode": "null|rw|ro" } }

Example connector:


{ "connector": { "initiator": "iqn.1993-08.org.debian:01:cad181614cec", "ip": "192.168.1.20", "platform": "x86_64", "host": "tempest-1", "os_type": "linux2", "multipath": false, "mountpoint": "/dev/vdb", "mode": "null|rw|ro" } }

NOTE all that's required for a reserve is volume_uuid and an instance_uuid.

returns: A summary view of the attachment object

Usage: osc block-storage attachment create354 [OPTIONS] --volume-uuid <VOLUME_UUID>

Options:

  • --connector <key=value> — The connector object

  • --instance-uuid <INSTANCE_UUID> — The UUID of the volume which the attachment belongs to

  • --mode <MODE> — The attach mode of attachment, acceptable values are read-only (‘ro’) and read-and-write (‘rw’).

    New in version 3.54

    Possible values: ro, rw

  • --volume-uuid <VOLUME_UUID> — The UUID of the volume which the attachment belongs to