UpdateLaunchOptions

class oci.core.models.UpdateLaunchOptions(**kwargs)

Bases: object

Options for tuning the compatibility and performance of VM shapes.

Attributes

BOOT_VOLUME_TYPE_ISCSI A constant which can be used with the boot_volume_type property of a UpdateLaunchOptions.
BOOT_VOLUME_TYPE_PARAVIRTUALIZED A constant which can be used with the boot_volume_type property of a UpdateLaunchOptions.
NETWORK_TYPE_PARAVIRTUALIZED A constant which can be used with the network_type property of a UpdateLaunchOptions.
NETWORK_TYPE_VFIO A constant which can be used with the network_type property of a UpdateLaunchOptions.
boot_volume_type Gets the boot_volume_type of this UpdateLaunchOptions.
is_pv_encryption_in_transit_enabled Gets the is_pv_encryption_in_transit_enabled of this UpdateLaunchOptions.
network_type Gets the network_type of this UpdateLaunchOptions.

Methods

__init__(**kwargs) Initializes a new UpdateLaunchOptions object with values from keyword arguments.
BOOT_VOLUME_TYPE_ISCSI = 'ISCSI'

A constant which can be used with the boot_volume_type property of a UpdateLaunchOptions. This constant has a value of “ISCSI”

BOOT_VOLUME_TYPE_PARAVIRTUALIZED = 'PARAVIRTUALIZED'

A constant which can be used with the boot_volume_type property of a UpdateLaunchOptions. This constant has a value of “PARAVIRTUALIZED”

NETWORK_TYPE_PARAVIRTUALIZED = 'PARAVIRTUALIZED'

A constant which can be used with the network_type property of a UpdateLaunchOptions. This constant has a value of “PARAVIRTUALIZED”

NETWORK_TYPE_VFIO = 'VFIO'

A constant which can be used with the network_type property of a UpdateLaunchOptions. This constant has a value of “VFIO”

__init__(**kwargs)

Initializes a new UpdateLaunchOptions object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:
  • boot_volume_type (str) – The value to assign to the boot_volume_type property of this UpdateLaunchOptions. Allowed values for this property are: “ISCSI”, “PARAVIRTUALIZED”
  • network_type (str) – The value to assign to the network_type property of this UpdateLaunchOptions. Allowed values for this property are: “VFIO”, “PARAVIRTUALIZED”
  • is_pv_encryption_in_transit_enabled (bool) – The value to assign to the is_pv_encryption_in_transit_enabled property of this UpdateLaunchOptions.
boot_volume_type

Gets the boot_volume_type of this UpdateLaunchOptions. Emulation type for the boot volume. * ISCSI - ISCSI attached block storage device. * PARAVIRTUALIZED - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.

Before you change the boot volume attachment type, detach all block volumes and VNICs except for the boot volume and the primary VNIC.

If the instance is running when you change the boot volume attachment type, it will be rebooted.

Note: Some instances might not function properly if you change the boot volume attachment type. After the instance reboots and is running, connect to it. If the connection fails or the OS doesn’t behave as expected, the changes are not supported. Revert the instance to the original boot volume attachment type.

Allowed values for this property are: “ISCSI”, “PARAVIRTUALIZED”

Returns:The boot_volume_type of this UpdateLaunchOptions.
Return type:str
is_pv_encryption_in_transit_enabled

Gets the is_pv_encryption_in_transit_enabled of this UpdateLaunchOptions. Whether to enable in-transit encryption for the volume’s paravirtualized attachment. To enable in-transit encryption for block volumes and boot volumes, this field must be set to true.

Data in transit is transferred over an internal and highly secure network. If you have specific compliance requirements related to the encryption of the data while it is moving between the instance and the boot volume or the block volume, you can enable in-transit encryption. In-transit encryption is not enabled by default.

All boot volumes and block volumes are encrypted at rest.

For more information, see Block Volume Encryption.

Returns:The is_pv_encryption_in_transit_enabled of this UpdateLaunchOptions.
Return type:bool
network_type

Gets the network_type of this UpdateLaunchOptions. Emulation type for the physical network interface card (NIC). * VFIO - Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking. * PARAVIRTUALIZED - VM instances launch with paravirtualized devices using VirtIO drivers.

Before you change the networking type, detach all VNICs and block volumes except for the primary VNIC and the boot volume.

The image must have paravirtualized drivers installed. For more information, see Editing an Instance.

If the instance is running when you change the network type, it will be rebooted.

Note: Some instances might not function properly if you change the networking type. After the instance reboots and is running, connect to it. If the connection fails or the OS doesn’t behave as expected, the changes are not supported. Revert the instance to the original networking type.

Allowed values for this property are: “VFIO”, “PARAVIRTUALIZED”

Returns:The network_type of this UpdateLaunchOptions.
Return type:str