Vtap¶

class oci.core.models.Vtap(**kwargs)¶

Bases: object

A virtual test access point (VTAP) provides a way to mirror all traffic from a designated source to a selected target in order to facilitate troubleshooting, security analysis, and data monitoring. A VTAP is functionally similar to a test access point (TAP) you might deploy in your on-premises network.

A :class:`CaptureFilter` contains a set of :func:`capture_filter_rule_details` governing what traffic a VTAP mirrors.

Attributes

`ENCAPSULATION_PROTOCOL_VXLAN`	A constant which can be used with the encapsulation_protocol property of a Vtap.
`LIFECYCLE_STATE_AVAILABLE`	A constant which can be used with the lifecycle_state property of a Vtap.
`LIFECYCLE_STATE_DETAILS_RUNNING`	A constant which can be used with the lifecycle_state_details property of a Vtap.
`LIFECYCLE_STATE_DETAILS_STOPPED`	A constant which can be used with the lifecycle_state_details property of a Vtap.
`LIFECYCLE_STATE_PROVISIONING`	A constant which can be used with the lifecycle_state property of a Vtap.
`LIFECYCLE_STATE_TERMINATED`	A constant which can be used with the lifecycle_state property of a Vtap.
`LIFECYCLE_STATE_TERMINATING`	A constant which can be used with the lifecycle_state property of a Vtap.
`LIFECYCLE_STATE_UPDATING`	A constant which can be used with the lifecycle_state property of a Vtap.
`SOURCE_TYPE_AUTONOMOUS_DATA_WAREHOUSE`	A constant which can be used with the source_type property of a Vtap.
`SOURCE_TYPE_DB_SYSTEM`	A constant which can be used with the source_type property of a Vtap.
`SOURCE_TYPE_EXADATA_VM_CLUSTER`	A constant which can be used with the source_type property of a Vtap.
`SOURCE_TYPE_LOAD_BALANCER`	A constant which can be used with the source_type property of a Vtap.
`SOURCE_TYPE_SUBNET`	A constant which can be used with the source_type property of a Vtap.
`SOURCE_TYPE_VNIC`	A constant which can be used with the source_type property of a Vtap.
`TARGET_TYPE_IP_ADDRESS`	A constant which can be used with the target_type property of a Vtap.
`TARGET_TYPE_NETWORK_LOAD_BALANCER`	A constant which can be used with the target_type property of a Vtap.
`TARGET_TYPE_VNIC`	A constant which can be used with the target_type property of a Vtap.
`TRAFFIC_MODE_DEFAULT`	A constant which can be used with the traffic_mode property of a Vtap.
`TRAFFIC_MODE_PRIORITY`	A constant which can be used with the traffic_mode property of a Vtap.
`capture_filter_id`	[Required] Gets the capture_filter_id of this Vtap.
`compartment_id`	[Required] Gets the compartment_id of this Vtap.
`defined_tags`	Gets the defined_tags of this Vtap.
`display_name`	Gets the display_name of this Vtap.
`encapsulation_protocol`	Gets the encapsulation_protocol of this Vtap.
`freeform_tags`	Gets the freeform_tags of this Vtap.
`id`	[Required] Gets the id of this Vtap.
`is_vtap_enabled`	Gets the is_vtap_enabled of this Vtap.
`lifecycle_state`	[Required] Gets the lifecycle_state of this Vtap.
`lifecycle_state_details`	Gets the lifecycle_state_details of this Vtap.
`max_packet_size`	Gets the max_packet_size of this Vtap.
`source_id`	[Required] Gets the source_id of this Vtap.
`source_private_endpoint_ip`	Gets the source_private_endpoint_ip of this Vtap.
`source_private_endpoint_subnet_id`	Gets the source_private_endpoint_subnet_id of this Vtap.
`source_type`	Gets the source_type of this Vtap.
`target_id`	Gets the target_id of this Vtap.
`target_ip`	Gets the target_ip of this Vtap.
`target_type`	Gets the target_type of this Vtap.
`time_created`	Gets the time_created of this Vtap.
`traffic_mode`	Gets the traffic_mode of this Vtap.
`vcn_id`	[Required] Gets the vcn_id of this Vtap.
`vxlan_network_identifier`	Gets the vxlan_network_identifier of this Vtap.

Methods

__init__(**kwargs) Initializes a new Vtap object with values from keyword arguments.

ENCAPSULATION_PROTOCOL_VXLAN = 'VXLAN'¶: A constant which can be used with the encapsulation_protocol property of a Vtap. This constant has a value of “VXLAN”

LIFECYCLE_STATE_AVAILABLE = 'AVAILABLE'¶: A constant which can be used with the lifecycle_state property of a Vtap. This constant has a value of “AVAILABLE”

LIFECYCLE_STATE_DETAILS_RUNNING = 'RUNNING'¶: A constant which can be used with the lifecycle_state_details property of a Vtap. This constant has a value of “RUNNING”

LIFECYCLE_STATE_DETAILS_STOPPED = 'STOPPED'¶: A constant which can be used with the lifecycle_state_details property of a Vtap. This constant has a value of “STOPPED”

LIFECYCLE_STATE_PROVISIONING = 'PROVISIONING'¶: A constant which can be used with the lifecycle_state property of a Vtap. This constant has a value of “PROVISIONING”

LIFECYCLE_STATE_TERMINATED = 'TERMINATED'¶: A constant which can be used with the lifecycle_state property of a Vtap. This constant has a value of “TERMINATED”

LIFECYCLE_STATE_TERMINATING = 'TERMINATING'¶: A constant which can be used with the lifecycle_state property of a Vtap. This constant has a value of “TERMINATING”

LIFECYCLE_STATE_UPDATING = 'UPDATING'¶: A constant which can be used with the lifecycle_state property of a Vtap. This constant has a value of “UPDATING”

SOURCE_TYPE_AUTONOMOUS_DATA_WAREHOUSE = 'AUTONOMOUS_DATA_WAREHOUSE'¶: A constant which can be used with the source_type property of a Vtap. This constant has a value of “AUTONOMOUS_DATA_WAREHOUSE”

SOURCE_TYPE_DB_SYSTEM = 'DB_SYSTEM'¶: A constant which can be used with the source_type property of a Vtap. This constant has a value of “DB_SYSTEM”

SOURCE_TYPE_EXADATA_VM_CLUSTER = 'EXADATA_VM_CLUSTER'¶: A constant which can be used with the source_type property of a Vtap. This constant has a value of “EXADATA_VM_CLUSTER”

SOURCE_TYPE_LOAD_BALANCER = 'LOAD_BALANCER'¶: A constant which can be used with the source_type property of a Vtap. This constant has a value of “LOAD_BALANCER”

SOURCE_TYPE_SUBNET = 'SUBNET'¶: A constant which can be used with the source_type property of a Vtap. This constant has a value of “SUBNET”

SOURCE_TYPE_VNIC = 'VNIC'¶: A constant which can be used with the source_type property of a Vtap. This constant has a value of “VNIC”

TARGET_TYPE_IP_ADDRESS = 'IP_ADDRESS'¶: A constant which can be used with the target_type property of a Vtap. This constant has a value of “IP_ADDRESS”

TARGET_TYPE_NETWORK_LOAD_BALANCER = 'NETWORK_LOAD_BALANCER'¶: A constant which can be used with the target_type property of a Vtap. This constant has a value of “NETWORK_LOAD_BALANCER”

TARGET_TYPE_VNIC = 'VNIC'¶: A constant which can be used with the target_type property of a Vtap. This constant has a value of “VNIC”

TRAFFIC_MODE_DEFAULT = 'DEFAULT'¶: A constant which can be used with the traffic_mode property of a Vtap. This constant has a value of “DEFAULT”

TRAFFIC_MODE_PRIORITY = 'PRIORITY'¶: A constant which can be used with the traffic_mode property of a Vtap. This constant has a value of “PRIORITY”

__init__(**kwargs)¶

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

Parameters:

compartment_id (str) – The value to assign to the compartment_id property of this Vtap.
vcn_id (str) – The value to assign to the vcn_id property of this Vtap.
defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this Vtap.
display_name (str) – The value to assign to the display_name property of this Vtap.
freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this Vtap.
id (str) – The value to assign to the id property of this Vtap.
lifecycle_state (str) – The value to assign to the lifecycle_state property of this Vtap. Allowed values for this property are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
lifecycle_state_details (str) – The value to assign to the lifecycle_state_details property of this Vtap. Allowed values for this property are: “RUNNING”, “STOPPED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
time_created (datetime) – The value to assign to the time_created property of this Vtap.
source_id (str) – The value to assign to the source_id property of this Vtap.
target_id (str) – The value to assign to the target_id property of this Vtap.
target_ip (str) – The value to assign to the target_ip property of this Vtap.
capture_filter_id (str) – The value to assign to the capture_filter_id property of this Vtap.
encapsulation_protocol (str) – The value to assign to the encapsulation_protocol property of this Vtap. Allowed values for this property are: “VXLAN”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
vxlan_network_identifier (int) – The value to assign to the vxlan_network_identifier property of this Vtap.
is_vtap_enabled (bool) – The value to assign to the is_vtap_enabled property of this Vtap.
source_type (str) – The value to assign to the source_type property of this Vtap. Allowed values for this property are: “VNIC”, “SUBNET”, “LOAD_BALANCER”, “DB_SYSTEM”, “EXADATA_VM_CLUSTER”, “AUTONOMOUS_DATA_WAREHOUSE”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
traffic_mode (str) – The value to assign to the traffic_mode property of this Vtap. Allowed values for this property are: “DEFAULT”, “PRIORITY”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
max_packet_size (int) – The value to assign to the max_packet_size property of this Vtap.
target_type (str) – The value to assign to the target_type property of this Vtap. Allowed values for this property are: “VNIC”, “NETWORK_LOAD_BALANCER”, “IP_ADDRESS”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
source_private_endpoint_ip (str) – The value to assign to the source_private_endpoint_ip property of this Vtap.
source_private_endpoint_subnet_id (str) – The value to assign to the source_private_endpoint_subnet_id property of this Vtap.

capture_filter_id¶

[Required] Gets the capture_filter_id of this Vtap. The capture filter’s Oracle ID (OCID).

Returns:	The capture_filter_id of this Vtap.
Return type:	str

compartment_id¶

[Required] Gets the compartment_id of this Vtap. The OCID of the compartment containing the Vtap resource.

Returns:	The compartment_id of this Vtap.
Return type:	str

defined_tags¶

Gets the defined_tags of this Vtap. Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

Example: {“Operations”: {“CostCenter”: “42”}}

Returns:	The defined_tags of this Vtap.
Return type:	dict(str, dict(str, object))

display_name¶

Gets the display_name of this Vtap. A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.

Returns:	The display_name of this Vtap.
Return type:	str

encapsulation_protocol¶

Gets the encapsulation_protocol of this Vtap. Defines an encapsulation header type for the VTAP’s mirrored traffic.

Allowed values for this property are: “VXLAN”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The encapsulation_protocol of this Vtap.
Return type:	str

freeform_tags¶

Gets the freeform_tags of this Vtap. Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.

Example: {“Department”: “Finance”}

Returns:	The freeform_tags of this Vtap.
Return type:	dict(str, str)

id¶

[Required] Gets the id of this Vtap. The VTAP’s Oracle ID (OCID).

Returns:	The id of this Vtap.
Return type:	str

is_vtap_enabled¶

Gets the is_vtap_enabled of this Vtap. Used to start or stop a Vtap resource.

TRUE directs the VTAP to start mirroring traffic.
FALSE (Default) directs the VTAP to stop mirroring traffic.

Returns:	The is_vtap_enabled of this Vtap.
Return type:	bool

lifecycle_state¶

[Required] Gets the lifecycle_state of this Vtap. The VTAP’s administrative lifecycle state.

Allowed values for this property are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The lifecycle_state of this Vtap.
Return type:	str

lifecycle_state_details¶

Gets the lifecycle_state_details of this Vtap. The VTAP’s current running state.

Allowed values for this property are: “RUNNING”, “STOPPED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The lifecycle_state_details of this Vtap.
Return type:	str

max_packet_size¶

Gets the max_packet_size of this Vtap. The maximum size of the packets to be included in the filter.

Returns:	The max_packet_size of this Vtap.
Return type:	int

source_id¶

[Required] Gets the source_id of this Vtap. The OCID of the source point where packets are captured.

Returns:	The source_id of this Vtap.
Return type:	str

source_private_endpoint_ip¶

Gets the source_private_endpoint_ip of this Vtap. The IP Address of the source private endpoint.

Returns:	The source_private_endpoint_ip of this Vtap.
Return type:	str

source_private_endpoint_subnet_id¶

Gets the source_private_endpoint_subnet_id of this Vtap. The OCID of the subnet that source private endpoint belongs to.

Returns:	The source_private_endpoint_subnet_id of this Vtap.
Return type:	str

source_type¶

Gets the source_type of this Vtap. The source type for the VTAP.

Allowed values for this property are: “VNIC”, “SUBNET”, “LOAD_BALANCER”, “DB_SYSTEM”, “EXADATA_VM_CLUSTER”, “AUTONOMOUS_DATA_WAREHOUSE”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The source_type of this Vtap.
Return type:	str

target_id¶

Gets the target_id of this Vtap. The OCID of the destination resource where mirrored packets are sent.

Returns:	The target_id of this Vtap.
Return type:	str

target_ip¶

Gets the target_ip of this Vtap. The IP address of the destination resource where mirrored packets are sent.

Returns:	The target_ip of this Vtap.
Return type:	str

target_type¶

Gets the target_type of this Vtap. The target type for the VTAP.

Allowed values for this property are: “VNIC”, “NETWORK_LOAD_BALANCER”, “IP_ADDRESS”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The target_type of this Vtap.
Return type:	str

time_created¶

Gets the time_created of this Vtap. The date and time the VTAP was created, in the format defined by RFC3339.

Example: 2020-08-25T21:10:29.600Z

Returns:	The time_created of this Vtap.
Return type:	datetime

traffic_mode¶

Gets the traffic_mode of this Vtap. Used to control the priority of traffic. It is an optional field. If it not passed, the value is DEFAULT

Allowed values for this property are: “DEFAULT”, “PRIORITY”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The traffic_mode of this Vtap.
Return type:	str

vcn_id¶

[Required] Gets the vcn_id of this Vtap. The OCID of the VCN containing the Vtap resource.

Returns:	The vcn_id of this Vtap.
Return type:	str

vxlan_network_identifier¶

Gets the vxlan_network_identifier of this Vtap. The virtual extensible LAN (VXLAN) network identifier (or VXLAN segment ID) that uniquely identifies the VXLAN.

Returns:	The vxlan_network_identifier of this Vtap.
Return type:	int