File: //lib/mysqlsh/lib/python3.8/site-packages/oci/core/models/i_scsi_volume_attachment.py
# coding: utf-8
# Copyright (c) 2016, 2025, Oracle and/or its affiliates. All rights reserved.
# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918
from .volume_attachment import VolumeAttachment
from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401
from oci.decorators import init_model_state_from_kwargs
@init_model_state_from_kwargs
class IScsiVolumeAttachment(VolumeAttachment):
"""
An ISCSI volume attachment.
"""
#: A constant which can be used with the encryption_in_transit_type property of a IScsiVolumeAttachment.
#: This constant has a value of "NONE"
ENCRYPTION_IN_TRANSIT_TYPE_NONE = "NONE"
#: A constant which can be used with the encryption_in_transit_type property of a IScsiVolumeAttachment.
#: This constant has a value of "BM_ENCRYPTION_IN_TRANSIT"
ENCRYPTION_IN_TRANSIT_TYPE_BM_ENCRYPTION_IN_TRANSIT = "BM_ENCRYPTION_IN_TRANSIT"
def __init__(self, **kwargs):
"""
Initializes a new IScsiVolumeAttachment object with values from keyword arguments. The default value of the :py:attr:`~oci.core.models.IScsiVolumeAttachment.attachment_type` attribute
of this class is ``iscsi`` and it should not be changed.
The following keyword arguments are supported (corresponding to the getters/setters of this class):
:param attachment_type:
The value to assign to the attachment_type property of this IScsiVolumeAttachment.
:type attachment_type: str
:param availability_domain:
The value to assign to the availability_domain property of this IScsiVolumeAttachment.
:type availability_domain: str
:param compartment_id:
The value to assign to the compartment_id property of this IScsiVolumeAttachment.
:type compartment_id: str
:param device:
The value to assign to the device property of this IScsiVolumeAttachment.
:type device: str
:param display_name:
The value to assign to the display_name property of this IScsiVolumeAttachment.
:type display_name: str
:param id:
The value to assign to the id property of this IScsiVolumeAttachment.
:type id: str
:param instance_id:
The value to assign to the instance_id property of this IScsiVolumeAttachment.
:type instance_id: str
:param is_read_only:
The value to assign to the is_read_only property of this IScsiVolumeAttachment.
:type is_read_only: bool
:param is_shareable:
The value to assign to the is_shareable property of this IScsiVolumeAttachment.
:type is_shareable: bool
:param lifecycle_state:
The value to assign to the lifecycle_state property of this IScsiVolumeAttachment.
Allowed values for this property are: "ATTACHING", "ATTACHED", "DETACHING", "DETACHED", 'UNKNOWN_ENUM_VALUE'.
Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
:type lifecycle_state: str
:param time_created:
The value to assign to the time_created property of this IScsiVolumeAttachment.
:type time_created: datetime
:param volume_id:
The value to assign to the volume_id property of this IScsiVolumeAttachment.
:type volume_id: str
:param is_pv_encryption_in_transit_enabled:
The value to assign to the is_pv_encryption_in_transit_enabled property of this IScsiVolumeAttachment.
:type is_pv_encryption_in_transit_enabled: bool
:param is_multipath:
The value to assign to the is_multipath property of this IScsiVolumeAttachment.
:type is_multipath: bool
:param iscsi_login_state:
The value to assign to the iscsi_login_state property of this IScsiVolumeAttachment.
Allowed values for this property are: "UNKNOWN", "LOGGING_IN", "LOGIN_SUCCEEDED", "LOGIN_FAILED", "LOGGING_OUT", "LOGOUT_SUCCEEDED", "LOGOUT_FAILED", 'UNKNOWN_ENUM_VALUE'.
Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
:type iscsi_login_state: str
:param is_volume_created_during_launch:
The value to assign to the is_volume_created_during_launch property of this IScsiVolumeAttachment.
:type is_volume_created_during_launch: bool
:param chap_secret:
The value to assign to the chap_secret property of this IScsiVolumeAttachment.
:type chap_secret: str
:param chap_username:
The value to assign to the chap_username property of this IScsiVolumeAttachment.
:type chap_username: str
:param ipv4:
The value to assign to the ipv4 property of this IScsiVolumeAttachment.
:type ipv4: str
:param iqn:
The value to assign to the iqn property of this IScsiVolumeAttachment.
:type iqn: str
:param port:
The value to assign to the port property of this IScsiVolumeAttachment.
:type port: int
:param multipath_devices:
The value to assign to the multipath_devices property of this IScsiVolumeAttachment.
:type multipath_devices: list[oci.core.models.MultipathDevice]
:param encryption_in_transit_type:
The value to assign to the encryption_in_transit_type property of this IScsiVolumeAttachment.
Allowed values for this property are: "NONE", "BM_ENCRYPTION_IN_TRANSIT", 'UNKNOWN_ENUM_VALUE'.
Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
:type encryption_in_transit_type: str
:param is_agent_auto_iscsi_login_enabled:
The value to assign to the is_agent_auto_iscsi_login_enabled property of this IScsiVolumeAttachment.
:type is_agent_auto_iscsi_login_enabled: bool
"""
self.swagger_types = {
'attachment_type': 'str',
'availability_domain': 'str',
'compartment_id': 'str',
'device': 'str',
'display_name': 'str',
'id': 'str',
'instance_id': 'str',
'is_read_only': 'bool',
'is_shareable': 'bool',
'lifecycle_state': 'str',
'time_created': 'datetime',
'volume_id': 'str',
'is_pv_encryption_in_transit_enabled': 'bool',
'is_multipath': 'bool',
'iscsi_login_state': 'str',
'is_volume_created_during_launch': 'bool',
'chap_secret': 'str',
'chap_username': 'str',
'ipv4': 'str',
'iqn': 'str',
'port': 'int',
'multipath_devices': 'list[MultipathDevice]',
'encryption_in_transit_type': 'str',
'is_agent_auto_iscsi_login_enabled': 'bool'
}
self.attribute_map = {
'attachment_type': 'attachmentType',
'availability_domain': 'availabilityDomain',
'compartment_id': 'compartmentId',
'device': 'device',
'display_name': 'displayName',
'id': 'id',
'instance_id': 'instanceId',
'is_read_only': 'isReadOnly',
'is_shareable': 'isShareable',
'lifecycle_state': 'lifecycleState',
'time_created': 'timeCreated',
'volume_id': 'volumeId',
'is_pv_encryption_in_transit_enabled': 'isPvEncryptionInTransitEnabled',
'is_multipath': 'isMultipath',
'iscsi_login_state': 'iscsiLoginState',
'is_volume_created_during_launch': 'isVolumeCreatedDuringLaunch',
'chap_secret': 'chapSecret',
'chap_username': 'chapUsername',
'ipv4': 'ipv4',
'iqn': 'iqn',
'port': 'port',
'multipath_devices': 'multipathDevices',
'encryption_in_transit_type': 'encryptionInTransitType',
'is_agent_auto_iscsi_login_enabled': 'isAgentAutoIscsiLoginEnabled'
}
self._attachment_type = None
self._availability_domain = None
self._compartment_id = None
self._device = None
self._display_name = None
self._id = None
self._instance_id = None
self._is_read_only = None
self._is_shareable = None
self._lifecycle_state = None
self._time_created = None
self._volume_id = None
self._is_pv_encryption_in_transit_enabled = None
self._is_multipath = None
self._iscsi_login_state = None
self._is_volume_created_during_launch = None
self._chap_secret = None
self._chap_username = None
self._ipv4 = None
self._iqn = None
self._port = None
self._multipath_devices = None
self._encryption_in_transit_type = None
self._is_agent_auto_iscsi_login_enabled = None
self._attachment_type = 'iscsi'
@property
def chap_secret(self):
"""
Gets the chap_secret of this IScsiVolumeAttachment.
The Challenge-Handshake-Authentication-Protocol (CHAP) secret
valid for the associated CHAP user name.
(Also called the \"CHAP password\".)
:return: The chap_secret of this IScsiVolumeAttachment.
:rtype: str
"""
return self._chap_secret
@chap_secret.setter
def chap_secret(self, chap_secret):
"""
Sets the chap_secret of this IScsiVolumeAttachment.
The Challenge-Handshake-Authentication-Protocol (CHAP) secret
valid for the associated CHAP user name.
(Also called the \"CHAP password\".)
:param chap_secret: The chap_secret of this IScsiVolumeAttachment.
:type: str
"""
self._chap_secret = chap_secret
@property
def chap_username(self):
"""
Gets the chap_username of this IScsiVolumeAttachment.
The volume's system-generated Challenge-Handshake-Authentication-Protocol
(CHAP) user name. See `RFC 1994`__ for more on CHAP.
Example: `ocid1.volume.oc1.phx.<unique_ID>`
__ https://tools.ietf.org/html/rfc1994
:return: The chap_username of this IScsiVolumeAttachment.
:rtype: str
"""
return self._chap_username
@chap_username.setter
def chap_username(self, chap_username):
"""
Sets the chap_username of this IScsiVolumeAttachment.
The volume's system-generated Challenge-Handshake-Authentication-Protocol
(CHAP) user name. See `RFC 1994`__ for more on CHAP.
Example: `ocid1.volume.oc1.phx.<unique_ID>`
__ https://tools.ietf.org/html/rfc1994
:param chap_username: The chap_username of this IScsiVolumeAttachment.
:type: str
"""
self._chap_username = chap_username
@property
def ipv4(self):
"""
**[Required]** Gets the ipv4 of this IScsiVolumeAttachment.
The volume's iSCSI IP address.
Example: `169.254.0.2`
:return: The ipv4 of this IScsiVolumeAttachment.
:rtype: str
"""
return self._ipv4
@ipv4.setter
def ipv4(self, ipv4):
"""
Sets the ipv4 of this IScsiVolumeAttachment.
The volume's iSCSI IP address.
Example: `169.254.0.2`
:param ipv4: The ipv4 of this IScsiVolumeAttachment.
:type: str
"""
self._ipv4 = ipv4
@property
def iqn(self):
"""
**[Required]** Gets the iqn of this IScsiVolumeAttachment.
The target volume's iSCSI Qualified Name in the format defined
by `RFC 3720`__.
Example: `iqn.2015-12.us.oracle.com:<CHAP_username>`
__ https://tools.ietf.org/html/rfc3720#page-32
:return: The iqn of this IScsiVolumeAttachment.
:rtype: str
"""
return self._iqn
@iqn.setter
def iqn(self, iqn):
"""
Sets the iqn of this IScsiVolumeAttachment.
The target volume's iSCSI Qualified Name in the format defined
by `RFC 3720`__.
Example: `iqn.2015-12.us.oracle.com:<CHAP_username>`
__ https://tools.ietf.org/html/rfc3720#page-32
:param iqn: The iqn of this IScsiVolumeAttachment.
:type: str
"""
self._iqn = iqn
@property
def port(self):
"""
**[Required]** Gets the port of this IScsiVolumeAttachment.
The volume's iSCSI port, usually port 860 or 3260.
Example: `3260`
:return: The port of this IScsiVolumeAttachment.
:rtype: int
"""
return self._port
@port.setter
def port(self, port):
"""
Sets the port of this IScsiVolumeAttachment.
The volume's iSCSI port, usually port 860 or 3260.
Example: `3260`
:param port: The port of this IScsiVolumeAttachment.
:type: int
"""
self._port = port
@property
def multipath_devices(self):
"""
Gets the multipath_devices of this IScsiVolumeAttachment.
A list of secondary multipath devices
:return: The multipath_devices of this IScsiVolumeAttachment.
:rtype: list[oci.core.models.MultipathDevice]
"""
return self._multipath_devices
@multipath_devices.setter
def multipath_devices(self, multipath_devices):
"""
Sets the multipath_devices of this IScsiVolumeAttachment.
A list of secondary multipath devices
:param multipath_devices: The multipath_devices of this IScsiVolumeAttachment.
:type: list[oci.core.models.MultipathDevice]
"""
self._multipath_devices = multipath_devices
@property
def encryption_in_transit_type(self):
"""
Gets the encryption_in_transit_type of this IScsiVolumeAttachment.
Refer the top-level definition of encryptionInTransitType.
The default value is NONE.
Allowed values for this property are: "NONE", "BM_ENCRYPTION_IN_TRANSIT", 'UNKNOWN_ENUM_VALUE'.
Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
:return: The encryption_in_transit_type of this IScsiVolumeAttachment.
:rtype: str
"""
return self._encryption_in_transit_type
@encryption_in_transit_type.setter
def encryption_in_transit_type(self, encryption_in_transit_type):
"""
Sets the encryption_in_transit_type of this IScsiVolumeAttachment.
Refer the top-level definition of encryptionInTransitType.
The default value is NONE.
:param encryption_in_transit_type: The encryption_in_transit_type of this IScsiVolumeAttachment.
:type: str
"""
allowed_values = ["NONE", "BM_ENCRYPTION_IN_TRANSIT"]
if not value_allowed_none_or_none_sentinel(encryption_in_transit_type, allowed_values):
encryption_in_transit_type = 'UNKNOWN_ENUM_VALUE'
self._encryption_in_transit_type = encryption_in_transit_type
@property
def is_agent_auto_iscsi_login_enabled(self):
"""
Gets the is_agent_auto_iscsi_login_enabled of this IScsiVolumeAttachment.
Whether Oracle Cloud Agent is enabled perform the iSCSI login and logout commands after the volume attach or detach operations for non multipath-enabled iSCSI attachments.
:return: The is_agent_auto_iscsi_login_enabled of this IScsiVolumeAttachment.
:rtype: bool
"""
return self._is_agent_auto_iscsi_login_enabled
@is_agent_auto_iscsi_login_enabled.setter
def is_agent_auto_iscsi_login_enabled(self, is_agent_auto_iscsi_login_enabled):
"""
Sets the is_agent_auto_iscsi_login_enabled of this IScsiVolumeAttachment.
Whether Oracle Cloud Agent is enabled perform the iSCSI login and logout commands after the volume attach or detach operations for non multipath-enabled iSCSI attachments.
:param is_agent_auto_iscsi_login_enabled: The is_agent_auto_iscsi_login_enabled of this IScsiVolumeAttachment.
:type: bool
"""
self._is_agent_auto_iscsi_login_enabled = is_agent_auto_iscsi_login_enabled
def __repr__(self):
return formatted_flat_dict(self)
def __eq__(self, other):
if other is None:
return False
return self.__dict__ == other.__dict__
def __ne__(self, other):
return not self == other