API Reference

Core Services

Clients

Block Storage

class oci.core.blockstorage_client.BlockstorageClient(config)
create_volume(create_volume_details, **kwargs)

CreateVolume Creates a new volume in the specified compartment. Volumes can be created in sizes ranging from 50 GB (51200 MB) to 2 TB (2097152 MB), in 1 GB (1024 MB) increments. By default, volumes are 1 TB (1048576 MB). For general information about block volumes, see Overview of Block Volume Service.

A volume and instance can be in separate compartments but must be in the same Availability Domain. For information about access control and compartments, see Overview of the IAM Service. For information about Availability Domains, see Regions and Availability Domains. To get a list of Availability Domains, use the ListAvailabilityDomains operation in the Identity and Access Management Service API.

You may optionally specify a display name for the volume, which is simply a friendly name or description. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_volume_details (CreateVolumeDetails) -- (required) Request to create a new volume.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Volume

Return type:

Response

create_volume_backup(create_volume_backup_details, **kwargs)

CreateVolumeBackup Creates a new backup of the specified volume. For general information about volume backups, see Overview of Block Volume Service Backups

When the request is received, the backup object is in a REQUEST_RECEIVED state. When the data is imaged, it goes into a CREATING state. After the backup is fully uploaded to the cloud, it goes into an AVAILABLE state.

Parameters:
  • create_volume_backup_details (CreateVolumeBackupDetails) -- (required) Request to create a new backup of given volume.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type VolumeBackup

Return type:

Response

delete_volume(volume_id, **kwargs)

DeleteVolume Deletes the specified volume. The volume cannot have an active connection to an instance. To disconnect the volume from a connected instance, see Disconnecting From a Volume. Warning: All data on the volume will be permanently lost when the volume is deleted.

Parameters:
  • volume_id (str) -- (required) The OCID of the volume.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_volume_backup(volume_backup_id, **kwargs)

DeleteVolumeBackup Deletes a volume backup.

Parameters:
  • volume_backup_id (str) -- (required) The OCID of the volume backup.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

get_volume(volume_id, **kwargs)

GetVolume Gets information for the specified volume.

Parameters:volume_id (str) -- (required) The OCID of the volume.
Returns:A Response object with data of type Volume
Return type:Response
get_volume_backup(volume_backup_id, **kwargs)

GetVolumeBackup Gets information for the specified volume backup.

Parameters:volume_backup_id (str) -- (required) The OCID of the volume backup.
Returns:A Response object with data of type VolumeBackup
Return type:Response
list_volume_backups(compartment_id, **kwargs)

ListVolumeBackups Lists the volume backups in the specified compartment. You can filter the results by volume.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • volume_id (str) -- (optional) The OCID of the volume.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of VolumeBackup

Return type:

Response

list_volumes(compartment_id, **kwargs)

ListVolumes Lists the volumes in the specified compartment and Availability Domain.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • availability_domain (str) --

    (optional) The name of the Availability Domain.

    Example: Uocm:PHX-AD-1

  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Volume

Return type:

Response

update_volume(volume_id, update_volume_details, **kwargs)

UpdateVolume Updates the specified volume's display name. Avoid entering confidential information.

Parameters:
  • volume_id (str) -- (required) The OCID of the volume.
  • update_volume_details (UpdateVolumeDetails) -- (required) Update volume's display name. Avoid entering confidential information.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Volume

Return type:

Response

update_volume_backup(volume_backup_id, update_volume_backup_details, **kwargs)

UpdateVolumeBackup Updates the display name for the specified volume backup. Avoid entering confidential information.

Parameters:
  • volume_backup_id (str) -- (required) The OCID of the volume backup.
  • update_volume_backup_details (UpdateVolumeBackupDetails) -- (required) Update volume backup fields
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type VolumeBackup

Return type:

Response

Compute

class oci.core.compute_client.ComputeClient(config)
attach_vnic(attach_vnic_details, **kwargs)

AttachVnic Creates a secondary VNIC and attaches it to the specified instance. For more information about secondary VNICs, see Virtual Network Interface Cards (VNICs).

Parameters:
  • attach_vnic_details (AttachVnicDetails) -- (required) Attach VNIC details.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type VnicAttachment

Return type:

Response

attach_volume(attach_volume_details, **kwargs)

AttachVolume Attaches the specified storage volume to the specified instance.

Parameters:
  • attach_volume_details (AttachVolumeDetails) -- (required) Attach volume request
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type VolumeAttachment

Return type:

Response

capture_console_history(capture_console_history_details, **kwargs)

CaptureConsoleHistory Captures the most recent serial console data (up to a megabyte) for the specified instance.

The CaptureConsoleHistory operation works with the other console history operations as described below.

1. Use CaptureConsoleHistory to request the capture of up to a megabyte of the most recent console history. This call returns a ConsoleHistory object. The object will have a state of REQUESTED. 2. Wait for the capture operation to succeed by polling GetConsoleHistory with the identifier of the console history metadata. The state of the ConsoleHistory object will go from REQUESTED to GETTING-HISTORY and then SUCCEEDED (or FAILED). 3. Use GetConsoleHistoryContent to get the actual console history data (not the metadata). 4. Optionally, use DeleteConsoleHistory to delete the console history metadata and the console history data.

Parameters:
  • capture_console_history_details (CaptureConsoleHistoryDetails) -- (required) Console history details
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type ConsoleHistory

Return type:

Response

create_image(create_image_details, **kwargs)

CreateImage Creates a boot disk image for the specified instance or imports an exported image from the Oracle Bare Metal Cloud Object Storage Service.

When creating a new image, you must provide the OCID of the instance you want to use as the basis for the image, and the OCID of the compartment containing that instance. For more information about images, see Managing Custom Images.

When importing an exported image from the Object Storage Service, you specify the source information in image_source_details().

When importing an image based on the namespace, bucket name, and object name, use image_source_via_object_storage_tuple_details().

When importing an image based on the Object Storage Service URL, use image_source_via_object_storage_uri_details(). See Object Storage URLs and pre-authenticated requests for constructing URLs for image import/export.

For more information about importing exported images, see Image Import/Export.

You may optionally specify a display name for the image, which is simply a friendly name or description. It does not have to be unique, and you can change it. See update_image(). Avoid entering confidential information.

Parameters:
  • create_image_details (CreateImageDetails) -- (required) Image creation details
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Image

Return type:

Response

create_instance_console_connection(create_instance_console_connection_details, **kwargs)

CreateInstanceConsoleConnection Create a console connection for an instance.

Parameters:
  • create_instance_console_connection_details (CreateInstanceConsoleConnectionDetails) -- (required) Request object for creating an InstanceConsoleConnection
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type InstanceConsoleConnection

Return type:

Response

delete_console_history(instance_console_history_id, **kwargs)

DeleteConsoleHistory Deletes the specified console history metadata and the console history data.

Parameters:
  • instance_console_history_id (str) -- (required) The OCID of the console history.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_image(image_id, **kwargs)

DeleteImage Deletes an image.

Parameters:
  • image_id (str) -- (required) The OCID of the image.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_instance_console_connection(instance_console_connection_id, **kwargs)

DeleteInstanceConsoleConnection Delete the console connection for an instance

Parameters:
  • instance_console_connection_id (str) -- (required) The OCID of the intance console connection
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

detach_vnic(vnic_attachment_id, **kwargs)

DetachVnic Detaches and deletes the specified secondary VNIC. This operation cannot be used on the instance's primary VNIC. When you terminate an instance, all attached VNICs (primary and secondary) are automatically detached and deleted.

Parameters:
  • vnic_attachment_id (str) -- (required) The OCID of the VNIC attachment.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

detach_volume(volume_attachment_id, **kwargs)

DetachVolume Detaches a storage volume from an instance. You must specify the OCID of the volume attachment.

This is an asynchronous operation. The attachment's lifecycleState will change to DETACHING temporarily until the attachment is completely removed.

Parameters:
  • volume_attachment_id (str) -- (required) The OCID of the volume attachment.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

export_image(image_id, export_image_details, **kwargs)

ExportImage Exports the specified image to the Oracle Bare Metal Cloud Object Storage Service. You can use the Object Storage Service URL, or the namespace, bucket name, and object name when specifying the location to export to.

For more information about exporting images, see Image Import/Export.

To perform an image export, you need write access to the Object Storage Service bucket for the image, see Let Users Write Objects to Object Storage Buckets.

See Object Storage URLs and pre-authenticated requests for constructing URLs for image import/export.

Parameters:
  • image_id (str) -- (required) The OCID of the image.
  • export_image_details (ExportImageDetails) -- (required) Details for the image export.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Image

Return type:

Response

get_console_history(instance_console_history_id, **kwargs)

GetConsoleHistory Shows the metadata for the specified console history. See capture_console_history() for details about using the console history operations.

Parameters:instance_console_history_id (str) -- (required) The OCID of the console history.
Returns:A Response object with data of type ConsoleHistory
Return type:Response
get_console_history_content(instance_console_history_id, **kwargs)

GetConsoleHistoryContent Gets the actual console history data (not the metadata). See capture_console_history() for details about using the console history operations.

Parameters:
  • instance_console_history_id (str) -- (required) The OCID of the console history.
  • offset (int) -- (optional) Offset of the snapshot data to retrieve.
  • length (int) -- (optional) Length of the snapshot data to retrieve.
Returns:

A Response object with data of type bytes

Return type:

Response

get_image(image_id, **kwargs)

GetImage Gets the specified image.

Parameters:image_id (str) -- (required) The OCID of the image.
Returns:A Response object with data of type Image
Return type:Response
get_instance(instance_id, **kwargs)

GetInstance Gets information about the specified instance.

Parameters:instance_id (str) -- (required) The OCID of the instance.
Returns:A Response object with data of type Instance
Return type:Response
get_instance_console_connection(instance_console_connection_id, **kwargs)

GetInstanceConsoleConnection Get the details of an instance console connection

Parameters:instance_console_connection_id (str) -- (required) The OCID of the intance console connection
Returns:A Response object with data of type InstanceConsoleConnection
Return type:Response
get_vnic_attachment(vnic_attachment_id, **kwargs)

GetVnicAttachment Gets the information for the specified VNIC attachment.

Parameters:vnic_attachment_id (str) -- (required) The OCID of the VNIC attachment.
Returns:A Response object with data of type VnicAttachment
Return type:Response
get_volume_attachment(volume_attachment_id, **kwargs)

GetVolumeAttachment Gets information about the specified volume attachment.

Parameters:volume_attachment_id (str) -- (required) The OCID of the volume attachment.
Returns:A Response object with data of type VolumeAttachment
Return type:Response
get_windows_instance_initial_credentials(instance_id, **kwargs)

GetWindowsInstanceInitialCredentials Gets the generated credentials for the instance. Only works for Windows instances. The returned credentials are only valid for the initial login.

Parameters:instance_id (str) -- (required) The OCID of the instance.
Returns:A Response object with data of type InstanceCredentials
Return type:Response
instance_action(instance_id, action, **kwargs)

InstanceAction Performs one of the power actions (start, stop, softreset, or reset) on the specified instance.

start - power on

stop - power off

softreset - ACPI shutdown and power on

reset - power off and power on

Note that the stop state has no effect on the resources you consume. Billing continues for instances that you stop, and related resources continue to apply against any relevant quotas. You must terminate an instance (terminate_instance()) to remove its resources from billing and quotas.

Parameters:
  • instance_id (str) -- (required) The OCID of the instance.
  • action (str) -- (required) The action to perform on the instance.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Instance

Return type:

Response

launch_instance(launch_instance_details, **kwargs)

LaunchInstance Creates a new instance in the specified compartment and the specified Availability Domain. For general information about instances, see Overview of the Compute Service.

For information about access control and compartments, see Overview of the IAM Service.

For information about Availability Domains, see Regions and Availability Domains. To get a list of Availability Domains, use the ListAvailabilityDomains operation in the Identity and Access Management Service API.

All Oracle Bare Metal Cloud Services resources, including instances, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the resource in the Console.

When you launch an instance, it is automatically attached to a virtual network interface card (VNIC), called the primary VNIC. The VNIC has a private IP address from the subnet's CIDR. You can either assign a private IP address of your choice or let Oracle automatically assign one. You can choose whether the instance has a public IP address. To retrieve the addresses, use the list_vnic_attachments() operation to get the VNIC ID for the instance, and then call get_vnic() with the VNIC ID.

You can later add secondary VNICs to an instance. For more information, see Virtual Network Interface Cards (VNICs).

Parameters:
  • launch_instance_details (LaunchInstanceDetails) -- (required) Instance details
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Instance

Return type:

Response

list_console_histories(compartment_id, **kwargs)

ListConsoleHistories Lists the console history metadata for the specified compartment or instance.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • availability_domain (str) --

    (optional) The name of the Availability Domain.

    Example: Uocm:PHX-AD-1

  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • instance_id (str) -- (optional) The OCID of the instance.
Returns:

A Response object with data of type list of ConsoleHistory

Return type:

Response

list_images(compartment_id, **kwargs)

ListImages Lists the available images in the specified compartment. For more information about images, see Managing Custom Images.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • display_name (str) --

    (optional) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

    Example: My new resource

  • operating_system (str) --

    (optional) The image's operating system.

    Example: Oracle Linux

  • operating_system_version (str) --

    (optional) The image's operating system version.

    Example: 7.2

  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Image

Return type:

Response

list_instance_console_connections(compartment_id, **kwargs)

ListInstanceConsoleConnections Lists the console connections for the specified compartment or instance that have not been deleted.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • instance_id (str) -- (optional) The OCID of the instance.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of InstanceConsoleConnection

Return type:

Response

list_instances(compartment_id, **kwargs)

ListInstances Lists the instances in the specified compartment and the specified Availability Domain. You can filter the results by specifying an instance name (the list will include all the identically-named instances in the compartment).

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • availability_domain (str) --

    (optional) The name of the Availability Domain.

    Example: Uocm:PHX-AD-1

  • display_name (str) --

    (optional) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

    Example: My new resource

  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Instance

Return type:

Response

list_shapes(compartment_id, **kwargs)

ListShapes Lists the shapes that can be used to launch an instance within the specified compartment. You can filter the list by compatibility with a specific image.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • availability_domain (str) --

    (optional) The name of the Availability Domain.

    Example: Uocm:PHX-AD-1

  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • image_id (str) -- (optional) The OCID of an image.
Returns:

A Response object with data of type list of Shape

Return type:

Response

list_vnic_attachments(compartment_id, **kwargs)

ListVnicAttachments Lists the VNIC attachments in the specified compartment. A VNIC attachment resides in the same compartment as the attached instance. The list can be filtered by instance, VNIC, or Availability Domain.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • availability_domain (str) --

    (optional) The name of the Availability Domain.

    Example: Uocm:PHX-AD-1

  • instance_id (str) -- (optional) The OCID of the instance.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • vnic_id (str) -- (optional) The OCID of the VNIC.
Returns:

A Response object with data of type list of VnicAttachment

Return type:

Response

list_volume_attachments(compartment_id, **kwargs)

ListVolumeAttachments Lists the volume attachments in the specified compartment. You can filter the list by specifying an instance OCID, volume OCID, or both.

Currently, the only supported volume attachment type is IScsiVolumeAttachment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • availability_domain (str) --

    (optional) The name of the Availability Domain.

    Example: Uocm:PHX-AD-1

  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • instance_id (str) -- (optional) The OCID of the instance.
  • volume_id (str) -- (optional) The OCID of the volume.
Returns:

A Response object with data of type list of VolumeAttachment

Return type:

Response

terminate_instance(instance_id, **kwargs)

TerminateInstance Terminates the specified instance. Any attached VNICs and volumes are automatically detached when the instance terminates.

This is an asynchronous operation. The instance's lifecycleState will change to TERMINATING temporarily until the instance is completely removed.

Parameters:
  • instance_id (str) -- (required) The OCID of the instance.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

update_image(image_id, update_image_details, **kwargs)

UpdateImage Updates the display name of the image. Avoid entering confidential information.

Parameters:
  • image_id (str) -- (required) The OCID of the image.
  • update_image_details (UpdateImageDetails) -- (required) Updates the image display name field. Avoid entering confidential information.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Image

Return type:

Response

update_instance(instance_id, update_instance_details, **kwargs)

UpdateInstance Updates the display name of the specified instance. Avoid entering confidential information. The OCID of the instance remains the same.

Parameters:
  • instance_id (str) -- (required) The OCID of the instance.
  • update_instance_details (UpdateInstanceDetails) -- (required) Update instance fields
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Instance

Return type:

Response

Virtual Network

class oci.core.virtual_network_client.VirtualNetworkClient(config)
create_cpe(create_cpe_details, **kwargs)

CreateCpe Creates a new virtual Customer-Premises Equipment (CPE) object in the specified compartment. For more information, see IPSec VPNs.

For the purposes of access control, you must provide the OCID of the compartment where you want the CPE to reside. Notice that the CPE doesn't have to be in the same compartment as the IPSec connection or other Networking Service components. If you're not sure which compartment to use, put the CPE in the same compartment as the DRG. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You must provide the public IP address of your on-premises router. See Configuring Your On-Premises Router for an IPSec VPN.

You may optionally specify a display name for the CPE, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_cpe_details (CreateCpeDetails) -- (required) Details for creating a CPE.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Cpe

Return type:

Response

create_cross_connect(create_cross_connect_details, **kwargs)

CreateCrossConnect Creates a new cross-connect. Oracle recommends you create each cross-connect in a CrossConnectGroup so you can use link aggregation with the connection.

After creating the CrossConnect object, you need to go the FastConnect location and request to have the physical cable installed. For more information, see FastConnect Overview.

For the purposes of access control, you must provide the OCID of the compartment where you want the cross-connect to reside. If you're not sure which compartment to use, put the cross-connect in the same compartment with your VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the cross-connect. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_cross_connect_details (CreateCrossConnectDetails) -- (required) Details to create a CrossConnect
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type CrossConnect

Return type:

Response

create_cross_connect_group(create_cross_connect_group_details, **kwargs)

CreateCrossConnectGroup Creates a new cross-connect group to use with Oracle Bare Metal Cloud Services FastConnect. For more information, see FastConnect Overview.

For the purposes of access control, you must provide the OCID of the compartment where you want the cross-connect group to reside. If you're not sure which compartment to use, put the cross-connect group in the same compartment with your VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the cross-connect group. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_cross_connect_group_details (CreateCrossConnectGroupDetails) -- (required) Details to create a CrossConnectGroup
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type CrossConnectGroup

Return type:

Response

create_dhcp_options(create_dhcp_details, **kwargs)

CreateDhcpOptions Creates a new set of DHCP options for the specified VCN. For more information, see DhcpOptions.

For the purposes of access control, you must provide the OCID of the compartment where you want the set of DHCP options to reside. Notice that the set of options doesn't have to be in the same compartment as the VCN, subnets, or other Networking Service components. If you're not sure which compartment to use, put the set of DHCP options in the same compartment as the VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the set of DHCP options, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_dhcp_details (CreateDhcpDetails) -- (required) Request object for creating a new set of DHCP options.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type DhcpOptions

Return type:

Response

create_drg(create_drg_details, **kwargs)

CreateDrg Creates a new Dynamic Routing Gateway (DRG) in the specified compartment. For more information, see Dynamic Routing Gateways (DRGs).

For the purposes of access control, you must provide the OCID of the compartment where you want the DRG to reside. Notice that the DRG doesn't have to be in the same compartment as the VCN, the DRG attachment, or other Networking Service components. If you're not sure which compartment to use, put the DRG in the same compartment as the VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the DRG, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_drg_details (CreateDrgDetails) -- (required) Details for creating a DRG.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Drg

Return type:

Response

create_drg_attachment(create_drg_attachment_details, **kwargs)

CreateDrgAttachment Attaches the specified DRG to the specified VCN. A VCN can be attached to only one DRG at a time, and vice versa. The response includes a DrgAttachment object with its own OCID. For more information about DRGs, see Dynamic Routing Gateways (DRGs).

You may optionally specify a display name for the attachment, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

For the purposes of access control, the DRG attachment is automatically placed into the same compartment as the VCN. For more information about compartments and access control, see Overview of the IAM Service.

Parameters:
  • create_drg_attachment_details (CreateDrgAttachmentDetails) -- (required) Details for creating a DrgAttachment.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type DrgAttachment

Return type:

Response

create_internet_gateway(create_internet_gateway_details, **kwargs)

CreateInternetGateway Creates a new Internet Gateway for the specified VCN. For more information, see Connectivity to the Internet.

For the purposes of access control, you must provide the OCID of the compartment where you want the Internet Gateway to reside. Notice that the Internet Gateway doesn't have to be in the same compartment as the VCN or other Networking Service components. If you're not sure which compartment to use, put the Internet Gateway in the same compartment with the VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the Internet Gateway, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

For traffic to flow between a subnet and an Internet Gateway, you must create a route rule accordingly in the subnet's route table (for example, 0.0.0.0/0 > Internet Gateway). See update_route_table().

You must specify whether the Internet Gateway is enabled when you create it. If it's disabled, that means no traffic will flow to/from the internet even if there's a route rule that enables that traffic. You can later use update_internet_gateway() to easily disable/enable the gateway without changing the route rule.

Parameters:
  • create_internet_gateway_details (CreateInternetGatewayDetails) -- (required) Details for creating a new Internet Gateway.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type InternetGateway

Return type:

Response

create_ip_sec_connection(create_ip_sec_connection_details, **kwargs)

CreateIPSecConnection Creates a new IPSec connection between the specified DRG and CPE. For more information, see IPSec VPNs.

In the request, you must include at least one static route to the CPE object (you're allowed a maximum of 10). For example: 10.0.8.0/16.

For the purposes of access control, you must provide the OCID of the compartment where you want the IPSec connection to reside. Notice that the IPSec connection doesn't have to be in the same compartment as the DRG, CPE, or other Networking Service components. If you're not sure which compartment to use, put the IPSec connection in the same compartment as the DRG. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the IPSec connection, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

After creating the IPSec connection, you need to configure your on-premises router with tunnel-specific information returned by get_ip_sec_connection_device_config(). For each tunnel, that operation gives you the IP address of Oracle's VPN headend and the shared secret (that is, the pre-shared key). For more information, see Configuring Your On-Premises Router for an IPSec VPN.

To get the status of the tunnels (whether they're up or down), use get_ip_sec_connection_device_status().

Parameters:
  • create_ip_sec_connection_details (CreateIPSecConnectionDetails) -- (required) Details for creating an IPSecConnection.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type IPSecConnection

Return type:

Response

create_private_ip(create_private_ip_details, **kwargs)

CreatePrivateIp Creates a secondary private IP for the specified VNIC. For more information about secondary private IPs, see IP Addresses.

Parameters:
  • create_private_ip_details (CreatePrivateIpDetails) -- (required) Create private IP details.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type PrivateIp

Return type:

Response

create_route_table(create_route_table_details, **kwargs)

CreateRouteTable Creates a new route table for the specified VCN. In the request you must also include at least one route rule for the new route table. For information on the number of rules you can have in a route table, see Service Limits. For general information about route tables in your VCN, see Route Tables.

For the purposes of access control, you must provide the OCID of the compartment where you want the route table to reside. Notice that the route table doesn't have to be in the same compartment as the VCN, subnets, or other Networking Service components. If you're not sure which compartment to use, put the route table in the same compartment as the VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the route table, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_route_table_details (CreateRouteTableDetails) -- (required) Details for creating a new route table.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type RouteTable

Return type:

Response

create_security_list(create_security_list_details, **kwargs)

CreateSecurityList Creates a new security list for the specified VCN. For more information about security lists, see Security Lists. For information on the number of rules you can have in a security list, see Service Limits.

For the purposes of access control, you must provide the OCID of the compartment where you want the security list to reside. Notice that the security list doesn't have to be in the same compartment as the VCN, subnets, or other Networking Service components. If you're not sure which compartment to use, put the security list in the same compartment as the VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the security list, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

Parameters:
  • create_security_list_details (CreateSecurityListDetails) -- (required) Details regarding the security list to create.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type SecurityList

Return type:

Response

create_subnet(create_subnet_details, **kwargs)

CreateSubnet Creates a new subnet in the specified VCN. You can't change the size of the subnet after creation, so it's important to think about the size of subnets you need before creating them. For more information, see VCNs and Subnets. For information on the number of subnets you can have in a VCN, see Service Limits.

For the purposes of access control, you must provide the OCID of the compartment where you want the subnet to reside. Notice that the subnet doesn't have to be in the same compartment as the VCN, route tables, or other Networking Service components. If you're not sure which compartment to use, put the subnet in the same compartment as the VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally associate a route table with the subnet. If you don't, the subnet will use the VCN's default route table. For more information about route tables, see Route Tables.

You may optionally associate a security list with the subnet. If you don't, the subnet will use the VCN's default security list. For more information about security lists, see Security Lists.

You may optionally associate a set of DHCP options with the subnet. If you don't, the subnet will use the VCN's default set. For more information about DHCP options, see DHCP Options.

You may optionally specify a display name for the subnet, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

You can also add a DNS label for the subnet, which is required if you want the Internet and VCN Resolver to resolve hostnames for instances in the subnet. For more information, see DNS in Your Virtual Cloud Network.

Parameters:
  • create_subnet_details (CreateSubnetDetails) -- (required) Details for creating a subnet.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Subnet

Return type:

Response

create_vcn(create_vcn_details, **kwargs)

CreateVcn Creates a new Virtual Cloud Network (VCN). For more information, see VCNs and Subnets.

For the VCN you must specify a single, contiguous IPv4 CIDR block. Oracle recommends using one of the private IP address ranges specified in RFC 1918 (10.0.0.0/8, 172.16/12, and 192.168/16). Example: 172.16.0.0/16. The CIDR block can range from /16 to /30, and it must not overlap with your on-premises network. You can't change the size of the VCN after creation.

For the purposes of access control, you must provide the OCID of the compartment where you want the VCN to reside. Consult an Oracle Bare Metal Cloud Services administrator in your organization if you're not sure which compartment to use. Notice that the VCN doesn't have to be in the same compartment as the subnets or other Networking Service components. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the VCN, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.

You can also add a DNS label for the VCN, which is required if you want the instances to use the Interent and VCN Resolver option for DNS in the VCN. For more information, see DNS in Your Virtual Cloud Network.

The VCN automatically comes with a default route table, default security list, and default set of DHCP options. The OCID for each is returned in the response. You can't delete these default objects, but you can change their contents (that is, change the route rules, security list rules, and so on).

The VCN and subnets you create are not accessible until you attach an Internet Gateway or set up an IPSec VPN or FastConnect. For more information, see Overview of the Networking Service.

Parameters:
  • create_vcn_details (CreateVcnDetails) -- (required) Details for creating a new VCN.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Vcn

Return type:

Response

create_virtual_circuit(create_virtual_circuit_details, **kwargs)

CreateVirtualCircuit Creates a new virtual circuit to use with Oracle Bare Metal Cloud Services FastConnect. For more information, see FastConnect Overview.

For the purposes of access control, you must provide the OCID of the compartment where you want the virtual circuit to reside. If you're not sure which compartment to use, put the virtual circuit in the same compartment with the DRG it's using. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

You may optionally specify a display name for the virtual circuit. It does not have to be unique, and you can change it. Avoid entering confidential information.

Important: When creating a virtual circuit, you specify a DRG for the traffic to flow through. Make sure you attach the DRG to your VCN and confirm the VCN's routing sends traffic to the DRG. Otherwise traffic will not flow. For more information, see Route Tables.

Parameters:
  • create_virtual_circuit_details (CreateVirtualCircuitDetails) -- (required) Details to create a VirtualCircuit.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type VirtualCircuit

Return type:

Response

delete_cpe(cpe_id, **kwargs)

DeleteCpe Deletes the specified CPE object. The CPE must not be connected to a DRG. This is an asynchronous operation. The CPE's lifecycleState will change to TERMINATING temporarily until the CPE is completely removed.

Parameters:
  • cpe_id (str) -- (required) The OCID of the CPE.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_cross_connect(cross_connect_id, **kwargs)

DeleteCrossConnect Deletes the specified cross-connect. It must not be mapped to a VirtualCircuit.

Parameters:
  • cross_connect_id (str) -- (required) The OCID of the cross-connect.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_cross_connect_group(cross_connect_group_id, **kwargs)

DeleteCrossConnectGroup Deletes the specified cross-connect group. It must not contain any cross-connects, and it cannot be mapped to a VirtualCircuit.

Parameters:
  • cross_connect_group_id (str) -- (required) The OCID of the cross-connect group.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_dhcp_options(dhcp_id, **kwargs)

DeleteDhcpOptions Deletes the specified set of DHCP options, but only if it's not associated with a subnet. You can't delete a VCN's default set of DHCP options.

This is an asynchronous operation. The state of the set of options will switch to TERMINATING temporarily until the set is completely removed.

Parameters:
  • dhcp_id (str) -- (required) The OCID for the set of DHCP options.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_drg(drg_id, **kwargs)

DeleteDrg Deletes the specified DRG. The DRG must not be attached to a VCN or be connected to your on-premise network. Also, there must not be a route table that lists the DRG as a target. This is an asynchronous operation. The DRG's lifecycleState will change to TERMINATING temporarily until the DRG is completely removed.

Parameters:
  • drg_id (str) -- (required) The OCID of the DRG.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_drg_attachment(drg_attachment_id, **kwargs)

DeleteDrgAttachment Detaches a DRG from a VCN by deleting the corresponding DrgAttachment. This is an asynchronous operation. The attachment's lifecycleState will change to DETACHING temporarily until the attachment is completely removed.

Parameters:
  • drg_attachment_id (str) -- (required) The OCID of the DRG attachment.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_internet_gateway(ig_id, **kwargs)

DeleteInternetGateway Deletes the specified Internet Gateway. The Internet Gateway does not have to be disabled, but there must not be a route table that lists it as a target.

This is an asynchronous operation. The gateway's lifecycleState will change to TERMINATING temporarily until the gateway is completely removed.

Parameters:
  • ig_id (str) -- (required) The OCID of the Internet Gateway.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_ip_sec_connection(ipsc_id, **kwargs)

DeleteIPSecConnection Deletes the specified IPSec connection. If your goal is to disable the IPSec VPN between your VCN and on-premises network, it's easiest to simply detach the DRG but keep all the IPSec VPN components intact. If you were to delete all the components and then later need to create an IPSec VPN again, you would need to configure your on-premises router again with the new information returned from create_ip_sec_connection().

This is an asynchronous operation. The connection's lifecycleState will change to TERMINATING temporarily until the connection is completely removed.

Parameters:
  • ipsc_id (str) -- (required) The OCID of the IPSec connection.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_private_ip(private_ip_id, **kwargs)

DeletePrivateIp Unassigns and deletes the specified private IP. You must specify the object's OCID. The private IP address is returned to the subnet's pool of available addresses.

This operation cannot be used with primary private IPs, which are automatically unassigned and deleted when the VNIC is terminated.

Parameters:
  • private_ip_id (str) -- (required) The private IP's OCID.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_route_table(rt_id, **kwargs)

DeleteRouteTable Deletes the specified route table, but only if it's not associated with a subnet. You can't delete a VCN's default route table.

This is an asynchronous operation. The route table's lifecycleState will change to TERMINATING temporarily until the route table is completely removed.

Parameters:
  • rt_id (str) -- (required) The OCID of the route table.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_security_list(security_list_id, **kwargs)

DeleteSecurityList Deletes the specified security list, but only if it's not associated with a subnet. You can't delete a VCN's default security list.

This is an asynchronous operation. The security list's lifecycleState will change to TERMINATING temporarily until the security list is completely removed.

Parameters:
  • security_list_id (str) -- (required) The OCID of the security list.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_subnet(subnet_id, **kwargs)

DeleteSubnet Deletes the specified subnet, but only if there are no instances in the subnet. This is an asynchronous operation. The subnet's lifecycleState will change to TERMINATING temporarily. If there are any instances in the subnet, the state will instead change back to AVAILABLE.

Parameters:
  • subnet_id (str) -- (required) The OCID of the subnet.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_vcn(vcn_id, **kwargs)

DeleteVcn Deletes the specified VCN. The VCN must be empty and have no attached gateways. This is an asynchronous operation. The VCN's lifecycleState will change to TERMINATING temporarily until the VCN is completely removed.

Parameters:
  • vcn_id (str) -- (required) The OCID of the VCN.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_virtual_circuit(virtual_circuit_id, **kwargs)

DeleteVirtualCircuit Deletes the specified virtual circuit.

Important: If you're using FastConnect via a provider, make sure to also terminate the connection with the provider, or else the provider may continue to bill you.

Parameters:
  • virtual_circuit_id (str) -- (required) The OCID of the virtual circuit.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

get_cpe(cpe_id, **kwargs)

GetCpe Gets the specified CPE's information.

Parameters:cpe_id (str) -- (required) The OCID of the CPE.
Returns:A Response object with data of type Cpe
Return type:Response
get_cross_connect(cross_connect_id, **kwargs)

GetCrossConnect Gets the specified cross-connect's information.

Parameters:cross_connect_id (str) -- (required) The OCID of the cross-connect.
Returns:A Response object with data of type CrossConnect
Return type:Response
get_cross_connect_group(cross_connect_group_id, **kwargs)

GetCrossConnectGroups Gets the specified cross-connect group's information.

Parameters:cross_connect_group_id (str) -- (required) The OCID of the cross-connect group.
Returns:A Response object with data of type CrossConnectGroup
Return type:Response
get_cross_connect_letter_of_authority(cross_connect_id, **kwargs)

GetCrossConnectLetterOfAuthority Gets the Letter of Authority for the specified cross-connect.

Parameters:cross_connect_id (str) -- (required) The OCID of the cross-connect.
Returns:A Response object with data of type LetterOfAuthority
Return type:Response
get_cross_connect_status(cross_connect_id, **kwargs)

GetCrossConnectStatus Gets the status of the specified cross-connect.

Parameters:cross_connect_id (str) -- (required) The OCID of the cross-connect.
Returns:A Response object with data of type CrossConnectStatus
Return type:Response
get_dhcp_options(dhcp_id, **kwargs)

GetDhcpOptions Gets the specified set of DHCP options.

Parameters:dhcp_id (str) -- (required) The OCID for the set of DHCP options.
Returns:A Response object with data of type DhcpOptions
Return type:Response
get_drg(drg_id, **kwargs)

GetDrg Gets the specified DRG's information.

Parameters:drg_id (str) -- (required) The OCID of the DRG.
Returns:A Response object with data of type Drg
Return type:Response
get_drg_attachment(drg_attachment_id, **kwargs)

GetDrgAttachment Gets the information for the specified DrgAttachment.

Parameters:drg_attachment_id (str) -- (required) The OCID of the DRG attachment.
Returns:A Response object with data of type DrgAttachment
Return type:Response
get_internet_gateway(ig_id, **kwargs)

GetInternetGateway Gets the specified Internet Gateway's information.

Parameters:ig_id (str) -- (required) The OCID of the Internet Gateway.
Returns:A Response object with data of type InternetGateway
Return type:Response
get_ip_sec_connection(ipsc_id, **kwargs)

GetIPSecConnection Gets the specified IPSec connection's basic information, including the static routes for the on-premises router. If you want the status of the connection (whether it's up or down), use get_ip_sec_connection_device_status().

Parameters:ipsc_id (str) -- (required) The OCID of the IPSec connection.
Returns:A Response object with data of type IPSecConnection
Return type:Response
get_ip_sec_connection_device_config(ipsc_id, **kwargs)

GetIPSecConnectionDeviceConfig Gets the configuration information for the specified IPSec connection. For each tunnel, the response includes the IP address of Oracle's VPN headend and the shared secret.

Parameters:ipsc_id (str) -- (required) The OCID of the IPSec connection.
Returns:A Response object with data of type IPSecConnectionDeviceConfig
Return type:Response
get_ip_sec_connection_device_status(ipsc_id, **kwargs)

GetIPSecConnectionDeviceStatus Gets the status of the specified IPSec connection (whether it's up or down).

Parameters:ipsc_id (str) -- (required) The OCID of the IPSec connection.
Returns:A Response object with data of type IPSecConnectionDeviceStatus
Return type:Response
get_private_ip(private_ip_id, **kwargs)

GetPrivateIp Gets the specified private IP. You must specify the object's OCID. Alternatively, you can get the object by using list_private_ips() with the private IP address (for example, 10.0.3.3) and subnet OCID.

Parameters:private_ip_id (str) -- (required) The private IP's OCID.
Returns:A Response object with data of type PrivateIp
Return type:Response
get_route_table(rt_id, **kwargs)

GetRouteTable Gets the specified route table's information.

Parameters:rt_id (str) -- (required) The OCID of the route table.
Returns:A Response object with data of type RouteTable
Return type:Response
get_security_list(security_list_id, **kwargs)

GetSecurityList Gets the specified security list's information.

Parameters:security_list_id (str) -- (required) The OCID of the security list.
Returns:A Response object with data of type SecurityList
Return type:Response
get_subnet(subnet_id, **kwargs)

GetSubnet Gets the specified subnet's information.

Parameters:subnet_id (str) -- (required) The OCID of the subnet.
Returns:A Response object with data of type Subnet
Return type:Response
get_vcn(vcn_id, **kwargs)

GetVcn Gets the specified VCN's information.

Parameters:vcn_id (str) -- (required) The OCID of the VCN.
Returns:A Response object with data of type Vcn
Return type:Response
get_virtual_circuit(virtual_circuit_id, **kwargs)

GetVirtualCircuit Gets the specified virtual circuit's information.

Parameters:virtual_circuit_id (str) -- (required) The OCID of the virtual circuit.
Returns:A Response object with data of type VirtualCircuit
Return type:Response
get_vnic(vnic_id, **kwargs)

GetVnic Gets the information for the specified virtual network interface card (VNIC). You can get the VNIC OCID from the list_vnic_attachments() operation.

Parameters:vnic_id (str) -- (required) The OCID of the VNIC.
Returns:A Response object with data of type Vnic
Return type:Response
list_cpes(compartment_id, **kwargs)

ListCpes Lists the Customer-Premises Equipment objects (CPEs) in the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Cpe

Return type:

Response

list_cross_connect_groups(compartment_id, **kwargs)

ListCrossConnectGroups Lists the cross-connect groups in the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of CrossConnectGroup

Return type:

Response

list_cross_connect_locations(compartment_id, **kwargs)

ListCrossConnectLocations Lists the available FastConnect locations for cross-connect installation. You need this information so you can specify your desired location when you create a cross-connect.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of CrossConnectLocation

Return type:

Response

list_cross_connects(compartment_id, **kwargs)

ListCrossConnects Lists the cross-connects in the specified compartment. You can filter the list by specifying the OCID of a cross-connect group.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • cross_connect_group_id (str) -- (optional) The OCID of the cross-connect group.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of CrossConnect

Return type:

Response

list_crossconnect_port_speed_shapes(compartment_id, **kwargs)

ListCrossConnectPortSpeedShapes Lists the available port speeds for cross-connects. You need this information so you can specify your desired port speed (that is, shape) when you create a cross-connect.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of CrossConnectPortSpeedShape

Return type:

Response

list_dhcp_options(compartment_id, vcn_id, **kwargs)

ListDhcpOptions Lists the sets of DHCP options in the specified VCN and specified compartment. The response includes the default set of options that automatically comes with each VCN, plus any other sets you've created.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • vcn_id (str) -- (required) The OCID of the VCN.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of DhcpOptions

Return type:

Response

list_drg_attachments(compartment_id, **kwargs)

ListDrgAttachments Lists the DrgAttachment objects for the specified compartment. You can filter the results by VCN or DRG.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • vcn_id (str) -- (optional) The OCID of the VCN.
  • drg_id (str) -- (optional) The OCID of the DRG.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of DrgAttachment

Return type:

Response

list_drgs(compartment_id, **kwargs)

ListDrgs Lists the DRGs in the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Drg

Return type:

Response

list_fast_connect_provider_services(compartment_id, **kwargs)

ListFastConnectProviderServices Lists the service offerings from supported providers. You need this information so you can specify your desired provider and service offering when you create a virtual circuit.

For the compartment ID, provide the OCID of your tenancy (the root compartment).

For more information, see FastConnect Overview.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of FastConnectProviderService

Return type:

Response

list_internet_gateways(compartment_id, vcn_id, **kwargs)

ListInternetGateways Lists the Internet Gateways in the specified VCN and the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • vcn_id (str) -- (required) The OCID of the VCN.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of InternetGateway

Return type:

Response

list_ip_sec_connections(compartment_id, **kwargs)

ListIPSecConnections Lists the IPSec connections for the specified compartment. You can filter the results by DRG or CPE.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • drg_id (str) -- (optional) The OCID of the DRG.
  • cpe_id (str) -- (optional) The OCID of the CPE.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of IPSecConnection

Return type:

Response

list_private_ips(**kwargs)

ListPrivateIps Lists the PrivateIp objects based on one of these filters:

  • Subnet OCID.
  • VNIC OCID.
  • Both private IP address and subnet OCID: This lets

you get a privateIP object based on its private IP address (for example, 10.0.3.3) and not its OCID. For comparison, get_private_ip() requires the OCID.

If you're listing all the private IPs associated with a given subnet or VNIC, the response includes both primary and secondary private IPs.

Parameters:
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • ip_address (str) --

    (optional) The private IP address of the privateIp object.

    Example: 10.0.3.3

  • subnet_id (str) -- (optional) The OCID of the subnet.
  • vnic_id (str) -- (optional) The OCID of the VNIC.
Returns:

A Response object with data of type list of PrivateIp

Return type:

Response

list_route_tables(compartment_id, vcn_id, **kwargs)

ListRouteTables Lists the route tables in the specified VCN and specified compartment. The response includes the default route table that automatically comes with each VCN, plus any route tables you've created.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • vcn_id (str) -- (required) The OCID of the VCN.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of RouteTable

Return type:

Response

list_security_lists(compartment_id, vcn_id, **kwargs)

ListSecurityLists Lists the security lists in the specified VCN and compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • vcn_id (str) -- (required) The OCID of the VCN.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of SecurityList

Return type:

Response

list_subnets(compartment_id, vcn_id, **kwargs)

ListSubnets Lists the subnets in the specified VCN and the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • vcn_id (str) -- (required) The OCID of the VCN.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Subnet

Return type:

Response

list_vcns(compartment_id, **kwargs)

ListVcns Lists the Virtual Cloud Networks (VCNs) in the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of Vcn

Return type:

Response

list_virtual_circuit_bandwidth_shapes(compartment_id, **kwargs)

ListVirtualCircuitBandwidthShapes Lists the available bandwidth levels for virtual circuits. You need this information so you can specify your desired bandwidth level (that is, shape) when you create a virtual circuit.

For the compartment ID, provide the OCID of your tenancy (the root compartment).

For more information about virtual circuits, see FastConnect Overview.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of VirtualCircuitBandwidthShape

Return type:

Response

list_virtual_circuits(compartment_id, **kwargs)

ListVirtualCircuits Lists the virtual circuits in the specified compartment.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
Returns:

A Response object with data of type list of VirtualCircuit

Return type:

Response

update_cpe(cpe_id, update_cpe_details, **kwargs)

UpdateCpe Updates the specified CPE's display name. Avoid entering confidential information.

Parameters:
  • cpe_id (str) -- (required) The OCID of the CPE.
  • update_cpe_details (UpdateCpeDetails) -- (required) Details object for updating a CPE.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Cpe

Return type:

Response

update_cross_connect(cross_connect_id, update_cross_connect_details, **kwargs)

UpdateCrossConnect Updates the specified cross-connect.

Parameters:
  • cross_connect_id (str) -- (required) The OCID of the cross-connect.
  • update_cross_connect_details (UpdateCrossConnectDetails) -- (required) Update CrossConnect fields.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type CrossConnect

Return type:

Response

update_cross_connect_group(cross_connect_group_id, update_cross_connect_group_details, **kwargs)

UpdateCrossConnectGroup Updates the specified cross-connect group's display name. Avoid entering confidential information.

Parameters:
  • cross_connect_group_id (str) -- (required) The OCID of the cross-connect group.
  • update_cross_connect_group_details (UpdateCrossConnectGroupDetails) -- (required) Update CrossConnectGroup fields
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type CrossConnectGroup

Return type:

Response

update_dhcp_options(dhcp_id, update_dhcp_details, **kwargs)

UpdateDhcpOptions Updates the specified set of DHCP options. You can update the display name or the options themselves. Avoid entering confidential information.

Note that the options object you provide replaces the entire existing set of options.

Parameters:
  • dhcp_id (str) -- (required) The OCID for the set of DHCP options.
  • update_dhcp_details (UpdateDhcpDetails) -- (required) Request object for updating a set of DHCP options.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type DhcpOptions

Return type:

Response

update_drg(drg_id, update_drg_details, **kwargs)

UpdateDrg Updates the specified DRG's display name. Avoid entering confidential information.

Parameters:
  • drg_id (str) -- (required) The OCID of the DRG.
  • update_drg_details (UpdateDrgDetails) -- (required) Details object for updating a DRG.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Drg

Return type:

Response

update_drg_attachment(drg_attachment_id, update_drg_attachment_details, **kwargs)

UpdateDrgAttachment Updates the display name for the specified DrgAttachment. Avoid entering confidential information.

Parameters:
  • drg_attachment_id (str) -- (required) The OCID of the DRG attachment.
  • update_drg_attachment_details (UpdateDrgAttachmentDetails) -- (required) Details object for updating a DrgAttachment.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type DrgAttachment

Return type:

Response

update_internet_gateway(ig_id, update_internet_gateway_details, **kwargs)

UpdateInternetGateway Updates the specified Internet Gateway. You can disable/enable it, or change its display name. Avoid entering confidential information.

If the gateway is disabled, that means no traffic will flow to/from the internet even if there's a route rule that enables that traffic.

Parameters:
  • ig_id (str) -- (required) The OCID of the Internet Gateway.
  • update_internet_gateway_details (UpdateInternetGatewayDetails) -- (required) Details for updating the Internet Gateway.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type InternetGateway

Return type:

Response

update_ip_sec_connection(ipsc_id, update_ip_sec_connection_details, **kwargs)

UpdateIPSecConnection Updates the display name for the specified IPSec connection. Avoid entering confidential information.

Parameters:
  • ipsc_id (str) -- (required) The OCID of the IPSec connection.
  • update_ip_sec_connection_details (UpdateIPSecConnectionDetails) -- (required) Details object for updating a IPSec connection.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type IPSecConnection

Return type:

Response

update_private_ip(private_ip_id, update_private_ip_details, **kwargs)

UpdatePrivateIp Updates the specified private IP. You must specify the object's OCID. Use this operation if you want to:

  • Move a secondary private IP to a different VNIC in the same subnet.
  • Change the display name for a secondary private IP.
  • Change the hostname for a secondary private IP.

This operation cannot be used with primary private IPs. To update the hostname for the primary IP on a VNIC, use update_vnic().

Parameters:
  • private_ip_id (str) -- (required) The private IP's OCID.
  • update_private_ip_details (UpdatePrivateIpDetails) -- (required) Private IP details.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type PrivateIp

Return type:

Response

update_route_table(rt_id, update_route_table_details, **kwargs)

UpdateRouteTable Updates the specified route table's display name or route rules. Avoid entering confidential information.

Note that the routeRules object you provide replaces the entire existing set of rules.

Parameters:
  • rt_id (str) -- (required) The OCID of the route table.
  • update_route_table_details (UpdateRouteTableDetails) -- (required) Details object for updating a route table.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type RouteTable

Return type:

Response

update_security_list(security_list_id, update_security_list_details, **kwargs)

UpdateSecurityList Updates the specified security list's display name or rules. Avoid entering confidential information.

Note that the egressSecurityRules or ingressSecurityRules objects you provide replace the entire existing objects.

Parameters:
  • security_list_id (str) -- (required) The OCID of the security list.
  • update_security_list_details (UpdateSecurityListDetails) -- (required) Updated details for the security list.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type SecurityList

Return type:

Response

update_subnet(subnet_id, update_subnet_details, **kwargs)

UpdateSubnet Updates the specified subnet's display name. Avoid entering confidential information.

Parameters:
  • subnet_id (str) -- (required) The OCID of the subnet.
  • update_subnet_details (UpdateSubnetDetails) -- (required) Details object for updating a subnet.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Subnet

Return type:

Response

update_vcn(vcn_id, update_vcn_details, **kwargs)

UpdateVcn Updates the specified VCN's display name. Avoid entering confidential information.

Parameters:
  • vcn_id (str) -- (required) The OCID of the VCN.
  • update_vcn_details (UpdateVcnDetails) -- (required) Details object for updating a VCN.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Vcn

Return type:

Response

update_virtual_circuit(virtual_circuit_id, update_virtual_circuit_details, **kwargs)

UpdateVirtualCircuit Updates the specified virtual circuit. This can be called by either the customer who owns the virtual circuit, or the provider (when provisioning or de-provisioning the virtual circuit from their end). The documentation for update_virtual_circuit_details() indicates who can update each property of the virtual circuit.

Important: If the virtual circuit is working and in the PROVISIONED state, updating any of the network-related properties (such as the DRG being used, the BGP ASN, and so on) will cause the virtual circuit's state to switch to PROVISIONING and the related BGP session to go down. After Oracle re-provisions the virtual circuit, its state will return to PROVISIONED. Make sure you confirm that the associated BGP session is back up. For more information about the various states and how to test connectivity, see FastConnect Overview.

Parameters:
  • virtual_circuit_id (str) -- (required) The OCID of the virtual circuit.
  • update_virtual_circuit_details (UpdateVirtualCircuitDetails) -- (required) Update VirtualCircuit fields.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type VirtualCircuit

Return type:

Response

update_vnic(vnic_id, update_vnic_details, **kwargs)

UpdateVnic Updates the specified VNIC.

Parameters:
  • vnic_id (str) -- (required) The OCID of the VNIC.
  • update_vnic_details (UpdateVnicDetails) -- (required) Details object for updating a VNIC.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Vnic

Return type:

Response

Models

class oci.core.models.AttachIScsiVolumeDetails
use_chap

Gets the use_chap of this AttachIScsiVolumeDetails. Whether to use CHAP authentication for the volume attachment. Defaults to false.

Returns:The use_chap of this AttachIScsiVolumeDetails.
Return type:bool
class oci.core.models.AttachVnicDetails
create_vnic_details

Gets the create_vnic_details of this AttachVnicDetails. Details for creating a new VNIC.

Returns:The create_vnic_details of this AttachVnicDetails.
Return type:CreateVnicDetails
display_name

Gets the display_name of this AttachVnicDetails. A user-friendly name for the attachment. Does not have to be unique, and it cannot be changed.

Returns:The display_name of this AttachVnicDetails.
Return type:str
instance_id

Gets the instance_id of this AttachVnicDetails. The OCID of the instance.

Returns:The instance_id of this AttachVnicDetails.
Return type:str
class oci.core.models.AttachVolumeDetails
display_name

Gets the display_name of this AttachVolumeDetails. A user-friendly name. Does not have to be unique, and it cannot be changed. Avoid entering confidential information.

Returns:The display_name of this AttachVolumeDetails.
Return type:str
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

instance_id

Gets the instance_id of this AttachVolumeDetails. The OCID of the instance.

Returns:The instance_id of this AttachVolumeDetails.
Return type:str
type

Gets the type of this AttachVolumeDetails. The type of volume. The only supported value is "iscsi".

Returns:The type of this AttachVolumeDetails.
Return type:str
volume_id

Gets the volume_id of this AttachVolumeDetails. The OCID of the volume.

Returns:The volume_id of this AttachVolumeDetails.
Return type:str
class oci.core.models.CaptureConsoleHistoryDetails
instance_id

Gets the instance_id of this CaptureConsoleHistoryDetails. The OCID of the instance to get the console history from.

Returns:The instance_id of this CaptureConsoleHistoryDetails.
Return type:str
class oci.core.models.ConsoleHistory
availability_domain

Gets the availability_domain of this ConsoleHistory. The Availability Domain of an instance.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this ConsoleHistory.
Return type:str
compartment_id

Gets the compartment_id of this ConsoleHistory. The OCID of the compartment.

Returns:The compartment_id of this ConsoleHistory.
Return type:str
display_name

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

Example: My console history metadata

Returns:The display_name of this ConsoleHistory.
Return type:str
id

Gets the id of this ConsoleHistory. The OCID of the console history metadata object.

Returns:The id of this ConsoleHistory.
Return type:str
instance_id

Gets the instance_id of this ConsoleHistory. The OCID of the instance this console history was fetched from.

Returns:The instance_id of this ConsoleHistory.
Return type:str
lifecycle_state

Gets the lifecycle_state of this ConsoleHistory. The current state of the console history.

Allowed values for this property are: "REQUESTED", "GETTING-HISTORY", "SUCCEEDED", "FAILED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this ConsoleHistory.
Return type:str
time_created

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

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

Returns:The time_created of this ConsoleHistory.
Return type:datetime
class oci.core.models.Cpe
compartment_id

Gets the compartment_id of this Cpe. The OCID of the compartment containing the CPE.

Returns:The compartment_id of this Cpe.
Return type:str
display_name

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

Returns:The display_name of this Cpe.
Return type:str
id

Gets the id of this Cpe. The CPE's Oracle ID (OCID).

Returns:The id of this Cpe.
Return type:str
ip_address

Gets the ip_address of this Cpe. The public IP address of the on-premises router.

Returns:The ip_address of this Cpe.
Return type:str
time_created

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

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

Returns:The time_created of this Cpe.
Return type:datetime
class oci.core.models.CreateCpeDetails
compartment_id

Gets the compartment_id of this CreateCpeDetails. The OCID of the compartment to contain the CPE.

Returns:The compartment_id of this CreateCpeDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateCpeDetails.
Return type:str
ip_address

Gets the ip_address of this CreateCpeDetails. The public IP address of the on-premises router.

Example: 143.19.23.16

Returns:The ip_address of this CreateCpeDetails.
Return type:str
class oci.core.models.CreateCrossConnectDetails
compartment_id

Gets the compartment_id of this CreateCrossConnectDetails. The OCID of the compartment to contain the cross-connect.

Returns:The compartment_id of this CreateCrossConnectDetails.
Return type:str
cross_connect_group_id

Gets the cross_connect_group_id of this CreateCrossConnectDetails. The OCID of the cross-connect group to put this cross-connect in.

Returns:The cross_connect_group_id of this CreateCrossConnectDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateCrossConnectDetails.
Return type:str
far_cross_connect_or_cross_connect_group_id

Gets the far_cross_connect_or_cross_connect_group_id of this CreateCrossConnectDetails. If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.

Returns:The far_cross_connect_or_cross_connect_group_id of this CreateCrossConnectDetails.
Return type:str
location_name

Gets the location_name of this CreateCrossConnectDetails. The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see list_cross_connect_locations().

Example: CyrusOne, Chandler, AZ

Returns:The location_name of this CreateCrossConnectDetails.
Return type:str
near_cross_connect_or_cross_connect_group_id

Gets the near_cross_connect_or_cross_connect_group_id of this CreateCrossConnectDetails. If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.

Returns:The near_cross_connect_or_cross_connect_group_id of this CreateCrossConnectDetails.
Return type:str
port_speed_shape_name

Gets the port_speed_shape_name of this CreateCrossConnectDetails. The port speed for this cross-connect. To get a list of the available port speeds, see list_crossconnect_port_speed_shapes().

Example: 10 Gbps

Returns:The port_speed_shape_name of this CreateCrossConnectDetails.
Return type:str
class oci.core.models.CreateCrossConnectGroupDetails
compartment_id

Gets the compartment_id of this CreateCrossConnectGroupDetails. The OCID of the compartment to contain the cross-connect group.

Returns:The compartment_id of this CreateCrossConnectGroupDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateCrossConnectGroupDetails.
Return type:str
class oci.core.models.CreateDhcpDetails
compartment_id

Gets the compartment_id of this CreateDhcpDetails. The OCID of the compartment to contain the set of DHCP options.

Returns:The compartment_id of this CreateDhcpDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateDhcpDetails.
Return type:str
options

Gets the options of this CreateDhcpDetails. A set of DHCP options.

Returns:The options of this CreateDhcpDetails.
Return type:list[DhcpOption]
vcn_id

Gets the vcn_id of this CreateDhcpDetails. The OCID of the VCN the set of DHCP options belongs to.

Returns:The vcn_id of this CreateDhcpDetails.
Return type:str
class oci.core.models.CreateDrgAttachmentDetails
display_name

Gets the display_name of this CreateDrgAttachmentDetails. A user-friendly name. Does not have to be unique. Avoid entering confidential information.

Returns:The display_name of this CreateDrgAttachmentDetails.
Return type:str
drg_id

Gets the drg_id of this CreateDrgAttachmentDetails. The OCID of the DRG.

Returns:The drg_id of this CreateDrgAttachmentDetails.
Return type:str
vcn_id

Gets the vcn_id of this CreateDrgAttachmentDetails. The OCID of the VCN.

Returns:The vcn_id of this CreateDrgAttachmentDetails.
Return type:str
class oci.core.models.CreateDrgDetails
compartment_id

Gets the compartment_id of this CreateDrgDetails. The OCID of the compartment to contain the DRG.

Returns:The compartment_id of this CreateDrgDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateDrgDetails.
Return type:str
class oci.core.models.CreateIPSecConnectionDetails
compartment_id

Gets the compartment_id of this CreateIPSecConnectionDetails. The OCID of the compartment to contain the IPSec connection.

Returns:The compartment_id of this CreateIPSecConnectionDetails.
Return type:str
cpe_id

Gets the cpe_id of this CreateIPSecConnectionDetails. The OCID of the CPE.

Returns:The cpe_id of this CreateIPSecConnectionDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateIPSecConnectionDetails.
Return type:str
drg_id

Gets the drg_id of this CreateIPSecConnectionDetails. The OCID of the DRG.

Returns:The drg_id of this CreateIPSecConnectionDetails.
Return type:str
static_routes

Gets the static_routes of this CreateIPSecConnectionDetails. Static routes to the CPE. At least one route must be included. The CIDR must not be a multicast address or class E address.

Example: 10.0.1.0/24

Returns:The static_routes of this CreateIPSecConnectionDetails.
Return type:list[str]
class oci.core.models.CreateImageDetails
compartment_id

Gets the compartment_id of this CreateImageDetails. The OCID of the compartment containing the instance you want to use as the basis for the image.

Returns:The compartment_id of this CreateImageDetails.
Return type:str
display_name

Gets the display_name of this CreateImageDetails. A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.

You cannot use an Oracle-provided image name as a custom image name.

Example: My Oracle Linux image

Returns:The display_name of this CreateImageDetails.
Return type:str
image_source_details

Gets the image_source_details of this CreateImageDetails. Details for creating an image through import

Returns:The image_source_details of this CreateImageDetails.
Return type:ImageSourceDetails
instance_id

Gets the instance_id of this CreateImageDetails. The OCID of the instance you want to use as the basis for the image.

Returns:The instance_id of this CreateImageDetails.
Return type:str
class oci.core.models.CreateInstanceConsoleConnectionDetails
instance_id

Gets the instance_id of this CreateInstanceConsoleConnectionDetails. The host instance OCID

Returns:The instance_id of this CreateInstanceConsoleConnectionDetails.
Return type:str
public_key

Gets the public_key of this CreateInstanceConsoleConnectionDetails. An ssh public key that will be used to authenticate the console connection.

Returns:The public_key of this CreateInstanceConsoleConnectionDetails.
Return type:str
class oci.core.models.CreateInternetGatewayDetails
compartment_id

Gets the compartment_id of this CreateInternetGatewayDetails. The OCID of the compartment to contain the Internet Gateway.

Returns:The compartment_id of this CreateInternetGatewayDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateInternetGatewayDetails.
Return type:str
is_enabled

Gets the is_enabled of this CreateInternetGatewayDetails. Whether the gateway is enabled upon creation.

Returns:The is_enabled of this CreateInternetGatewayDetails.
Return type:bool
vcn_id

Gets the vcn_id of this CreateInternetGatewayDetails. The OCID of the VCN the Internet Gateway is attached to.

Returns:The vcn_id of this CreateInternetGatewayDetails.
Return type:str
class oci.core.models.CreatePrivateIpDetails
display_name

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

Returns:The display_name of this CreatePrivateIpDetails.
Return type:str
hostname_label

Gets the hostname_label of this CreatePrivateIpDetails. The hostname for the private IP. Used for DNS. The value is the hostname portion of the private IP's fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123.

For more information, see DNS in Your Virtual Cloud Network.

Example: bminstance-1

Returns:The hostname_label of this CreatePrivateIpDetails.
Return type:str
ip_address

Gets the ip_address of this CreatePrivateIpDetails. A private IP address of your choice. Must be an available IP address within the subnet's CIDR. If you don't specify a value, Oracle automatically assigns a private IP address from the subnet.

Example: 10.0.3.3

Returns:The ip_address of this CreatePrivateIpDetails.
Return type:str
vnic_id

Gets the vnic_id of this CreatePrivateIpDetails. The OCID of the VNIC to assign the private IP to. The VNIC and private IP must be in the same subnet.

Returns:The vnic_id of this CreatePrivateIpDetails.
Return type:str
class oci.core.models.CreateRouteTableDetails
compartment_id

Gets the compartment_id of this CreateRouteTableDetails. The OCID of the compartment to contain the route table.

Returns:The compartment_id of this CreateRouteTableDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateRouteTableDetails.
Return type:str
route_rules

Gets the route_rules of this CreateRouteTableDetails. The collection of rules used for routing destination IPs to network devices.

Returns:The route_rules of this CreateRouteTableDetails.
Return type:list[RouteRule]
vcn_id

Gets the vcn_id of this CreateRouteTableDetails. The OCID of the VCN the route table belongs to.

Returns:The vcn_id of this CreateRouteTableDetails.
Return type:str
class oci.core.models.CreateSecurityListDetails
compartment_id

Gets the compartment_id of this CreateSecurityListDetails. The OCID of the compartment to contain the security list.

Returns:The compartment_id of this CreateSecurityListDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateSecurityListDetails.
Return type:str
egress_security_rules

Gets the egress_security_rules of this CreateSecurityListDetails. Rules for allowing egress IP packets.

Returns:The egress_security_rules of this CreateSecurityListDetails.
Return type:list[EgressSecurityRule]
ingress_security_rules

Gets the ingress_security_rules of this CreateSecurityListDetails. Rules for allowing ingress IP packets.

Returns:The ingress_security_rules of this CreateSecurityListDetails.
Return type:list[IngressSecurityRule]
vcn_id

Gets the vcn_id of this CreateSecurityListDetails. The OCID of the VCN the security list belongs to.

Returns:The vcn_id of this CreateSecurityListDetails.
Return type:str
class oci.core.models.CreateSubnetDetails
availability_domain

Gets the availability_domain of this CreateSubnetDetails. The Availability Domain to contain the subnet.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this CreateSubnetDetails.
Return type:str
cidr_block

Gets the cidr_block of this CreateSubnetDetails. The CIDR IP address range of the subnet.

Example: 172.16.1.0/24

Returns:The cidr_block of this CreateSubnetDetails.
Return type:str
compartment_id

Gets the compartment_id of this CreateSubnetDetails. The OCID of the compartment to contain the subnet.

Returns:The compartment_id of this CreateSubnetDetails.
Return type:str
dhcp_options_id

Gets the dhcp_options_id of this CreateSubnetDetails. The OCID of the set of DHCP options the subnet will use. If you don't provide a value, the subnet will use the VCN's default set of DHCP options.

Returns:The dhcp_options_id of this CreateSubnetDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateSubnetDetails.
Return type:str
dns_label

Gets the dns_label of this CreateSubnetDetails. A DNS label for the subnet, used in conjunction with the VNIC's hostname and VCN's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example, bminstance-1.subnet123.vcn1.oraclevcn.com). Must be an alphanumeric string that begins with a letter and is unique within the VCN. The value cannot be changed.

This value must be set if you want to use the Internet and VCN Resolver to resolve the hostnames of instances in the subnet. It can only be set if the VCN itself was created with a DNS label.

For more information, see DNS in Your Virtual Cloud Network.

Example: subnet123

Returns:The dns_label of this CreateSubnetDetails.
Return type:str
prohibit_public_ip_on_vnic

Gets the prohibit_public_ip_on_vnic of this CreateSubnetDetails. Whether VNICs within this subnet can have public IP addresses. Defaults to false, which means VNICs created in this subnet will automatically be assigned public IP addresses unless specified otherwise during instance launch or VNIC creation (with the assignPublicIp flag in CreateVnicDetails). If prohibitPublicIpOnVnic is set to true, VNICs created in this subnet cannot have public IP addresses (that is, it's a private subnet).

Example: true

Returns:The prohibit_public_ip_on_vnic of this CreateSubnetDetails.
Return type:bool
route_table_id

Gets the route_table_id of this CreateSubnetDetails. The OCID of the route table the subnet will use. If you don't provide a value, the subnet will use the VCN's default route table.

Returns:The route_table_id of this CreateSubnetDetails.
Return type:str
security_list_ids

Gets the security_list_ids of this CreateSubnetDetails. OCIDs for the security lists to associate with the subnet. If you don't provide a value, the VCN's default security list will be associated with the subnet. Remember that security lists are associated at the subnet level, but the rules are applied to the individual VNICs in the subnet.

Returns:The security_list_ids of this CreateSubnetDetails.
Return type:list[str]
vcn_id

Gets the vcn_id of this CreateSubnetDetails. The OCID of the VCN to contain the subnet.

Returns:The vcn_id of this CreateSubnetDetails.
Return type:str
class oci.core.models.CreateVcnDetails
cidr_block

Gets the cidr_block of this CreateVcnDetails. The CIDR IP address block of the VCN.

Example: 172.16.0.0/16

Returns:The cidr_block of this CreateVcnDetails.
Return type:str
compartment_id

Gets the compartment_id of this CreateVcnDetails. The OCID of the compartment to contain the VCN.

Returns:The compartment_id of this CreateVcnDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateVcnDetails.
Return type:str
dns_label

Gets the dns_label of this CreateVcnDetails. A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example, bminstance-1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed.

You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.

For more information, see DNS in Your Virtual Cloud Network.

Example: vcn1

Returns:The dns_label of this CreateVcnDetails.
Return type:str
class oci.core.models.CreateVirtualCircuitDetails
bandwidth_shape_name

Gets the bandwidth_shape_name of this CreateVirtualCircuitDetails. The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see list_virtual_circuit_bandwidth_shapes().

Example: 10 Gbps

Returns:The bandwidth_shape_name of this CreateVirtualCircuitDetails.
Return type:str
compartment_id

Gets the compartment_id of this CreateVirtualCircuitDetails. The OCID of the compartment to contain the virtual circuit.

Returns:The compartment_id of this CreateVirtualCircuitDetails.
Return type:str
cross_connect_mappings

Gets the cross_connect_mappings of this CreateVirtualCircuitDetails. Create a CrossConnectMapping for each cross-connect or cross-connect group this virtual circuit will run on.

Returns:The cross_connect_mappings of this CreateVirtualCircuitDetails.
Return type:list[CrossConnectMapping]
customer_bgp_asn

Gets the customer_bgp_asn of this CreateVirtualCircuitDetails. Your BGP ASN (either public or private). Provide this value only if there's a BGP session that goes from your edge router to Oracle. Otherwise, leave this empty or null.

Returns:The customer_bgp_asn of this CreateVirtualCircuitDetails.
Return type:int
display_name

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

Returns:The display_name of this CreateVirtualCircuitDetails.
Return type:str
gateway_id

Gets the gateway_id of this CreateVirtualCircuitDetails. The OCID of the Drg that this virtual circuit uses.

Returns:The gateway_id of this CreateVirtualCircuitDetails.
Return type:str
provider_name

Gets the provider_name of this CreateVirtualCircuitDetails. The name of the provider (if you're connecting via a provider). To get a list of the provider names, see list_fast_connect_provider_services().

Returns:The provider_name of this CreateVirtualCircuitDetails.
Return type:str
provider_service_name

Gets the provider_service_name of this CreateVirtualCircuitDetails. The name of the service offered by the provider (if you're connecting via a provider). To get a list of the available service offerings, see list_fast_connect_provider_services().

Returns:The provider_service_name of this CreateVirtualCircuitDetails.
Return type:str
region

Gets the region of this CreateVirtualCircuitDetails. The Oracle Bare Metal Cloud Services region where this virtual circuit is located.

Example: phx

Returns:The region of this CreateVirtualCircuitDetails.
Return type:str
type

Gets the type of this CreateVirtualCircuitDetails. The type of IP addresses used in this virtual circuit. PRIVATE means RFC 1918 addresses (10.0.0.0/8, 172.16/12, and 192.168/16). Only PRIVATE is supported.

Allowed values for this property are: "PUBLIC", "PRIVATE"

Returns:The type of this CreateVirtualCircuitDetails.
Return type:str
class oci.core.models.CreateVnicDetails
assign_public_ip

Gets the assign_public_ip of this CreateVnicDetails. Whether the VNIC should be assigned a public IP address. Defaults to whether the subnet is public or private. If not set and the VNIC is being created in a private subnet (that is, where prohibitPublicIpOnVnic = true in the Subnet), then no public IP address is assigned. If not set and the subnet is public (prohibitPublicIpOnVnic = false), then a public IP address is assigned. If set to true and prohibitPublicIpOnVnic = true, an error is returned.

Note: This public IP address is associated with the primary private IP on the VNIC. Secondary private IPs cannot have public IP addresses associated with them. For more information, see IP Addresses.

Example: false

Returns:The assign_public_ip of this CreateVnicDetails.
Return type:bool
display_name

Gets the display_name of this CreateVnicDetails. A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.

Returns:The display_name of this CreateVnicDetails.
Return type:str
hostname_label

Gets the hostname_label of this CreateVnicDetails. The hostname for the VNIC's primary private IP. Used for DNS. The value is the hostname portion of the primary private IP's fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123. The value appears in the Vnic object and also the PrivateIp object returned by list_private_ips() and get_private_ip().

For more information, see DNS in Your Virtual Cloud Network.

When launching an instance, use this hostnameLabel instead of the deprecated hostnameLabel in launch_instance_details(). If you provide both, the values must match.

Example: bminstance-1

Returns:The hostname_label of this CreateVnicDetails.
Return type:str
private_ip

Gets the private_ip of this CreateVnicDetails. A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR. If you don't specify a value, Oracle automatically assigns a private IP address from the subnet. This is the VNIC's primary private IP address. The value appears in the Vnic object and also the PrivateIp object returned by list_private_ips() and get_private_ip().

Example: 10.0.3.3

Returns:The private_ip of this CreateVnicDetails.
Return type:str
subnet_id

Gets the subnet_id of this CreateVnicDetails. The OCID of the subnet to create the VNIC in. When launching an instance, use this subnetId instead of the deprecated subnetId in launch_instance_details(). At least one of them is required; if you provide both, the values must match.

Returns:The subnet_id of this CreateVnicDetails.
Return type:str
class oci.core.models.CreateVolumeBackupDetails
display_name

Gets the display_name of this CreateVolumeBackupDetails. A user-friendly name for the volume backup. Does not have to be unique and it's changeable. Avoid entering confidential information.

Returns:The display_name of this CreateVolumeBackupDetails.
Return type:str
volume_id

Gets the volume_id of this CreateVolumeBackupDetails. The OCID of the volume that needs to be backed up.

Returns:The volume_id of this CreateVolumeBackupDetails.
Return type:str
class oci.core.models.CreateVolumeDetails
availability_domain

Gets the availability_domain of this CreateVolumeDetails. The Availability Domain of the volume.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this CreateVolumeDetails.
Return type:str
compartment_id

Gets the compartment_id of this CreateVolumeDetails. The OCID of the compartment that contains the volume.

Returns:The compartment_id of this CreateVolumeDetails.
Return type:str
display_name

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

Returns:The display_name of this CreateVolumeDetails.
Return type:str
size_in_mbs

Gets the size_in_mbs of this CreateVolumeDetails. The size of the volume in MBs. The value must be a multiple of 1024.

Returns:The size_in_mbs of this CreateVolumeDetails.
Return type:int
volume_backup_id

Gets the volume_backup_id of this CreateVolumeDetails. The OCID of the volume backup from which the data should be restored on the newly created volume.

Returns:The volume_backup_id of this CreateVolumeDetails.
Return type:str
class oci.core.models.CrossConnect
compartment_id

Gets the compartment_id of this CrossConnect. The OCID of the compartment containing the cross-connect group.

Returns:The compartment_id of this CrossConnect.
Return type:str
cross_connect_group_id

Gets the cross_connect_group_id of this CrossConnect. The OCID of the cross-connect group this cross-connect belongs to (if any).

Returns:The cross_connect_group_id of this CrossConnect.
Return type:str
display_name

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

Returns:The display_name of this CrossConnect.
Return type:str
id

Gets the id of this CrossConnect. The cross-connect's Oracle ID (OCID).

Returns:The id of this CrossConnect.
Return type:str
lifecycle_state

Gets the lifecycle_state of this CrossConnect. The cross-connect's current state.

Allowed values for this property are: "PENDING_CUSTOMER", "PROVISIONING", "PROVISIONED", "INACTIVE", "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 CrossConnect.
Return type:str
location_name

Gets the location_name of this CrossConnect. The name of the FastConnect location where this cross-connect is installed.

Returns:The location_name of this CrossConnect.
Return type:str
port_name

Gets the port_name of this CrossConnect. A string identifying the meet-me room port for this cross-connect.

Returns:The port_name of this CrossConnect.
Return type:str
port_speed_shape_name

Gets the port_speed_shape_name of this CrossConnect. The port speed for this cross-connect.

Example: 10 Gbps

Returns:The port_speed_shape_name of this CrossConnect.
Return type:str
time_created

Gets the time_created of this CrossConnect. The date and time the cross-connect was created, in the format defined by RFC3339.

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

Returns:The time_created of this CrossConnect.
Return type:datetime
class oci.core.models.CrossConnectGroup
compartment_id

Gets the compartment_id of this CrossConnectGroup. The OCID of the compartment containing the cross-connect group.

Returns:The compartment_id of this CrossConnectGroup.
Return type:str
display_name

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

Returns:The display_name of this CrossConnectGroup.
Return type:str
id

Gets the id of this CrossConnectGroup. The cross-connect group's Oracle ID (OCID).

Returns:The id of this CrossConnectGroup.
Return type:str
lifecycle_state

Gets the lifecycle_state of this CrossConnectGroup. The cross-connect group's current state.

Allowed values for this property are: "PROVISIONING", "PROVISIONED", "INACTIVE", "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 CrossConnectGroup.
Return type:str
time_created

Gets the time_created of this CrossConnectGroup. The date and time the cross-connect group was created, in the format defined by RFC3339.

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

Returns:The time_created of this CrossConnectGroup.
Return type:datetime
class oci.core.models.CrossConnectLocation
description

Gets the description of this CrossConnectLocation. A description of the location.

Returns:The description of this CrossConnectLocation.
Return type:str
name

Gets the name of this CrossConnectLocation. The name of the location.

Example: CyrusOne, Chandler, AZ

Returns:The name of this CrossConnectLocation.
Return type:str
class oci.core.models.CrossConnectMapping
bgp_md5_auth_key

Gets the bgp_md5_auth_key of this CrossConnectMapping. The key for BGP MD5 authentication. Only applicable if your system requires MD5 authentication. If empty or not set (null), that means you don't use BGP MD5 authentication.

Returns:The bgp_md5_auth_key of this CrossConnectMapping.
Return type:str
cross_connect_or_cross_connect_group_id

Gets the cross_connect_or_cross_connect_group_id of this CrossConnectMapping. The OCID of the cross-connect or cross-connect group for this mapping. Specified by the owner of the cross-connect or cross-connect group (the customer if the customer is colocated with Oracle, or the provider if the customer is connecting via provider).

Returns:The cross_connect_or_cross_connect_group_id of this CrossConnectMapping.
Return type:str
customer_bgp_peering_ip

Gets the customer_bgp_peering_ip of this CrossConnectMapping. The BGP IP address for the router on the other end of the BGP session from Oracle. Specified by the owner of that router. If the session goes from Oracle to a customer, this is the BGP IP address of the customer's edge router. If the session goes from Oracle to a provider, this is the BGP IP address of the provider's edge router. Must use a /30 or /31 subnet mask.

Example: 10.0.0.18/31

Returns:The customer_bgp_peering_ip of this CrossConnectMapping.
Return type:str
oracle_bgp_peering_ip

Gets the oracle_bgp_peering_ip of this CrossConnectMapping. The IP address for Oracle's end of the BGP session. Must use a /30 or /31 subnet mask. If the session goes from Oracle to a customer's edge router, the customer specifies this information. If the session goes from Oracle to a provider's edge router, the provider specifies this.

Example: 10.0.0.19/31

Returns:The oracle_bgp_peering_ip of this CrossConnectMapping.
Return type:str
vlan

Gets the vlan of this CrossConnectMapping. The number of the specific VLAN (on the cross-connect or cross-connect group) that is assigned to this virtual circuit. Specified by the owner of the cross-connect or cross-connect group (the customer if the customer is colocated with Oracle, or the provider if the customer is connecting via provider).

Example: 200

Returns:The vlan of this CrossConnectMapping.
Return type:int
class oci.core.models.CrossConnectPortSpeedShape
name

Gets the name of this CrossConnectPortSpeedShape. The name of the port speed shape.

Example: 10 Gbps

Returns:The name of this CrossConnectPortSpeedShape.
Return type:str
port_speed_in_gbps

Gets the port_speed_in_gbps of this CrossConnectPortSpeedShape. The port speed in Gbps.

Example: 10

Returns:The port_speed_in_gbps of this CrossConnectPortSpeedShape.
Return type:int
class oci.core.models.CrossConnectStatus
cross_connect_id

Gets the cross_connect_id of this CrossConnectStatus. The OCID of the cross-connect.

Returns:The cross_connect_id of this CrossConnectStatus.
Return type:str
interface_state

Gets the interface_state of this CrossConnectStatus. Whether Oracle's side of the interface is up or down.

Allowed values for this property are: "UP", "DOWN", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The interface_state of this CrossConnectStatus.
Return type:str
light_level_ind_bm

Gets the light_level_ind_bm of this CrossConnectStatus. The light level of the cross-connect (in dBm).

Example: 14.0

Returns:The light_level_ind_bm of this CrossConnectStatus.
Return type:float
light_level_indicator

Gets the light_level_indicator of this CrossConnectStatus. Status indicator corresponding to the light level.

  • NO_LIGHT: No measurable light
  • LOW_WARN: There's measurable light but it's too low
  • HIGH_WARN: Light level is too high
  • BAD: There's measurable light but the signal-to-noise ratio is bad
  • GOOD: Good light level

Allowed values for this property are: "NO_LIGHT", "LOW_WARN", "HIGH_WARN", "BAD", "GOOD", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The light_level_indicator of this CrossConnectStatus.
Return type:str
class oci.core.models.DhcpDnsOption
custom_dns_servers

Gets the custom_dns_servers of this DhcpDnsOption. If you set serverType to CustomDnsServer, specify the IP address of at least one DNS server of your choice (three maximum).

Returns:The custom_dns_servers of this DhcpDnsOption.
Return type:list[str]
server_type

Gets the server_type of this DhcpDnsOption. - VcnLocal: Reserved for future use.

  • VcnLocalPlusInternet: Also referred to as "Internet and VCN Resolver".

Instances can resolve internet hostnames (no Internet Gateway is required), and can resolve hostnames of instances in the VCN. This is the default value in the default set of DHCP options in the VCN. For the Internet and VCN Resolver to work across the VCN, there must also be a DNS label set for the VCN, a DNS label set for each subnet, and a hostname for each instance. The Internet and VCN Resolver also enables reverse DNS lookup, which lets you determine the hostname corresponding to the private IP address. For more information, see DNS in Your Virtual Cloud Network.

  • CustomDnsServer: Instances use a DNS server of your choice (three maximum).

Allowed values for this property are: "VcnLocal", "VcnLocalPlusInternet", "CustomDnsServer", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The server_type of this DhcpDnsOption.
Return type:str
class oci.core.models.DhcpOption
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

type

Gets the type of this DhcpOption. The specific DHCP option. Either DomainNameServer (for DhcpDnsOption) or SearchDomain (for DhcpSearchDomainOption).

Returns:The type of this DhcpOption.
Return type:str
class oci.core.models.DhcpOptions
compartment_id

Gets the compartment_id of this DhcpOptions. The OCID of the compartment containing the set of DHCP options.

Returns:The compartment_id of this DhcpOptions.
Return type:str
display_name

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

Returns:The display_name of this DhcpOptions.
Return type:str
id

Gets the id of this DhcpOptions. Oracle ID (OCID) for the set of DHCP options.

Returns:The id of this DhcpOptions.
Return type:str
lifecycle_state

Gets the lifecycle_state of this DhcpOptions. The current state of the set of DHCP options.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 DhcpOptions.
Return type:str
options

Gets the options of this DhcpOptions. The collection of individual DHCP options.

Returns:The options of this DhcpOptions.
Return type:list[DhcpOption]
time_created

Gets the time_created of this DhcpOptions. Date and time the set of DHCP options was created, in the format defined by RFC3339.

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

Returns:The time_created of this DhcpOptions.
Return type:datetime
vcn_id

Gets the vcn_id of this DhcpOptions. The OCID of the VCN the set of DHCP options belongs to.

Returns:The vcn_id of this DhcpOptions.
Return type:str
class oci.core.models.DhcpSearchDomainOption
search_domain_names

Gets the search_domain_names of this DhcpSearchDomainOption. A single search domain name according to RFC 952 and RFC 1123. During a DNS query, the OS will append this search domain name to the value being queried.

If you set DhcpDnsOption to VcnLocalPlusInternet, and you assign a DNS label to the VCN during creation, the search domain name in the VCN's default set of DHCP options is automatically set to the VCN domain (for example, vcn1.oraclevcn.com).

If you don't want to use a search domain name, omit this option from the set of DHCP options. Do not include this option with an empty list of search domain names, or with an empty string as the value for any search domain name.

Returns:The search_domain_names of this DhcpSearchDomainOption.
Return type:list[str]
class oci.core.models.Drg
compartment_id

Gets the compartment_id of this Drg. The OCID of the compartment containing the DRG.

Returns:The compartment_id of this Drg.
Return type:str
display_name

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

Returns:The display_name of this Drg.
Return type:str
id

Gets the id of this Drg. The DRG's Oracle ID (OCID).

Returns:The id of this Drg.
Return type:str
lifecycle_state

Gets the lifecycle_state of this Drg. The DRG's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 Drg.
Return type:str
time_created

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

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

Returns:The time_created of this Drg.
Return type:datetime
class oci.core.models.DrgAttachment
compartment_id

Gets the compartment_id of this DrgAttachment. The OCID of the compartment containing the DRG attachment.

Returns:The compartment_id of this DrgAttachment.
Return type:str
display_name

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

Returns:The display_name of this DrgAttachment.
Return type:str
drg_id

Gets the drg_id of this DrgAttachment. The OCID of the DRG.

Returns:The drg_id of this DrgAttachment.
Return type:str
id

Gets the id of this DrgAttachment. The DRG attachment's Oracle ID (OCID).

Returns:The id of this DrgAttachment.
Return type:str
lifecycle_state

Gets the lifecycle_state of this DrgAttachment. The DRG attachment's current state.

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'.

Returns:The lifecycle_state of this DrgAttachment.
Return type:str
time_created

Gets the time_created of this DrgAttachment. The date and time the DRG attachment was created, in the format defined by RFC3339.

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

Returns:The time_created of this DrgAttachment.
Return type:datetime
vcn_id

Gets the vcn_id of this DrgAttachment. The OCID of the VCN.

Returns:The vcn_id of this DrgAttachment.
Return type:str
class oci.core.models.EgressSecurityRule
destination

Gets the destination of this EgressSecurityRule. The destination CIDR block for the egress rule. This is the range of IP addresses that a packet originating from the instance can go to.

Returns:The destination of this EgressSecurityRule.
Return type:str
icmp_options

Gets the icmp_options of this EgressSecurityRule. Optional and valid only for ICMP. Use to specify a particular ICMP type and code as defined in ICMP Parameters. If you specify ICMP as the protocol but omit this object, then all ICMP types and codes are allowed. If you do provide this object, the type is required and the code is optional. To enable MTU negotiation for ingress internet traffic, make sure to allow type 3 ("Destination Unreachable") code 4 ("Fragmentation Needed and Don't Fragment was Set"). If you need to specify multiple codes for a single type, create a separate security list rule for each.

Returns:The icmp_options of this EgressSecurityRule.
Return type:IcmpOptions
is_stateless

Gets the is_stateless of this EgressSecurityRule. A stateless rule allows traffic in one direction. Remember to add a corresponding stateless rule in the other direction if you need to support bidirectional traffic. For example, if egress traffic allows TCP destination port 80, there should be an ingress rule to allow TCP source port 80. Defaults to false, which means the rule is stateful and a corresponding rule is not necessary for bidirectional traffic.

Returns:The is_stateless of this EgressSecurityRule.
Return type:bool
protocol

Gets the protocol of this EgressSecurityRule. The transport protocol. Specify either all or an IPv4 protocol number as defined in Protocol Numbers. Options are supported only for ICMP ("1"), TCP ("6"), and UDP ("17").

Returns:The protocol of this EgressSecurityRule.
Return type:str
tcp_options

Gets the tcp_options of this EgressSecurityRule. Optional and valid only for TCP. Use to specify particular destination ports for TCP rules. If you specify TCP as the protocol but omit this object, then all destination ports are allowed.

Returns:The tcp_options of this EgressSecurityRule.
Return type:TcpOptions
udp_options

Gets the udp_options of this EgressSecurityRule. Optional and valid only for UDP. Use to specify particular destination ports for UDP rules. If you specify UDP as the protocol but omit this object, then all destination ports are allowed.

Returns:The udp_options of this EgressSecurityRule.
Return type:UdpOptions
class oci.core.models.ExportImageDetails
destination_type

Gets the destination_type of this ExportImageDetails. The destination type. Use objectStorageTuple when specifying the namespace, bucket name, and object name. Use objectStorageUri when specifying the Object Storage Service URL.

Returns:The destination_type of this ExportImageDetails.
Return type:str
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

class oci.core.models.ExportImageViaObjectStorageTupleDetails
bucket_name

Gets the bucket_name of this ExportImageViaObjectStorageTupleDetails. The Object Storage Service bucket to export the image to.

Returns:The bucket_name of this ExportImageViaObjectStorageTupleDetails.
Return type:str
namespace_name

Gets the namespace_name of this ExportImageViaObjectStorageTupleDetails. The Object Storage Service namespace to export the image to.

Returns:The namespace_name of this ExportImageViaObjectStorageTupleDetails.
Return type:str
object_name

Gets the object_name of this ExportImageViaObjectStorageTupleDetails. The Object Storage Service object name for the exported image.

Returns:The object_name of this ExportImageViaObjectStorageTupleDetails.
Return type:str
class oci.core.models.ExportImageViaObjectStorageUriDetails
destination_uri

Gets the destination_uri of this ExportImageViaObjectStorageUriDetails. The Object Storage Service URL to export the image to. See Object Storage URLs and pre-authenticated requests for constructing URLs for image import/export.

Returns:The destination_uri of this ExportImageViaObjectStorageUriDetails.
Return type:str
class oci.core.models.FastConnectProviderService
description

Gets the description of this FastConnectProviderService. A description of the service offered by the provider.

Returns:The description of this FastConnectProviderService.
Return type:str
provider_name

Gets the provider_name of this FastConnectProviderService. The name of the provider.

Returns:The provider_name of this FastConnectProviderService.
Return type:str
provider_service_name

Gets the provider_service_name of this FastConnectProviderService. The name of the service offered by the provider.

Returns:The provider_service_name of this FastConnectProviderService.
Return type:str
class oci.core.models.IPSecConnection
compartment_id

Gets the compartment_id of this IPSecConnection. The OCID of the compartment containing the IPSec connection.

Returns:The compartment_id of this IPSecConnection.
Return type:str
cpe_id

Gets the cpe_id of this IPSecConnection. The OCID of the CPE.

Returns:The cpe_id of this IPSecConnection.
Return type:str
display_name

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

Returns:The display_name of this IPSecConnection.
Return type:str
drg_id

Gets the drg_id of this IPSecConnection. The OCID of the DRG.

Returns:The drg_id of this IPSecConnection.
Return type:str
id

Gets the id of this IPSecConnection. The IPSec connection's Oracle ID (OCID).

Returns:The id of this IPSecConnection.
Return type:str
lifecycle_state

Gets the lifecycle_state of this IPSecConnection. The IPSec connection's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 IPSecConnection.
Return type:str
static_routes

Gets the static_routes of this IPSecConnection. Static routes to the CPE. At least one route must be included. The CIDR must not be a multicast address or class E address.

Example: 10.0.1.0/24

Returns:The static_routes of this IPSecConnection.
Return type:list[str]
time_created

Gets the time_created of this IPSecConnection. The date and time the IPSec connection was created, in the format defined by RFC3339.

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

Returns:The time_created of this IPSecConnection.
Return type:datetime
class oci.core.models.IPSecConnectionDeviceConfig
compartment_id

Gets the compartment_id of this IPSecConnectionDeviceConfig. The OCID of the compartment containing the IPSec connection.

Returns:The compartment_id of this IPSecConnectionDeviceConfig.
Return type:str
id

Gets the id of this IPSecConnectionDeviceConfig. The IPSec connection's Oracle ID (OCID).

Returns:The id of this IPSecConnectionDeviceConfig.
Return type:str
time_created

Gets the time_created of this IPSecConnectionDeviceConfig. The date and time the IPSec connection was created.

Returns:The time_created of this IPSecConnectionDeviceConfig.
Return type:datetime
tunnels

Gets the tunnels of this IPSecConnectionDeviceConfig. Two TunnelConfig objects.

Returns:The tunnels of this IPSecConnectionDeviceConfig.
Return type:list[TunnelConfig]
class oci.core.models.IPSecConnectionDeviceStatus
compartment_id

Gets the compartment_id of this IPSecConnectionDeviceStatus. The OCID of the compartment containing the IPSec connection.

Returns:The compartment_id of this IPSecConnectionDeviceStatus.
Return type:str
id

Gets the id of this IPSecConnectionDeviceStatus. The IPSec connection's Oracle ID (OCID).

Returns:The id of this IPSecConnectionDeviceStatus.
Return type:str
time_created

Gets the time_created of this IPSecConnectionDeviceStatus. The date and time the IPSec connection was created, in the format defined by RFC3339.

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

Returns:The time_created of this IPSecConnectionDeviceStatus.
Return type:datetime
tunnels

Gets the tunnels of this IPSecConnectionDeviceStatus. Two TunnelStatus objects.

Returns:The tunnels of this IPSecConnectionDeviceStatus.
Return type:list[TunnelStatus]
class oci.core.models.IScsiVolumeAttachment
chap_secret

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".)

Example: d6866c0d-298b-48ba-95af-309b4faux45e

Returns:The chap_secret of this IScsiVolumeAttachment.
Return type:str
chap_username

Gets the chap_username of this IScsiVolumeAttachment. The volume's system-generated Challenge-Handshake-Authentication-Protocol (CHAP) user name.

Example: ocid1.volume.oc1.phx.abyhqljrgvttnlx73nmrwfaux7kcvzfs3s66izvxf2h4lgvyndsdsnoiwr5q

Returns:The chap_username of this IScsiVolumeAttachment.
Return type:str
ipv4

Gets the ipv4 of this IScsiVolumeAttachment. The volume's iSCSI IP address.

Example: 169.254.0.2

Returns:The ipv4 of this IScsiVolumeAttachment.
Return type:str
iqn

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:456b0391-17b8-4122-bbf1-f85fc0bb97d9

Returns:The iqn of this IScsiVolumeAttachment.
Return type:str
port

Gets the port of this IScsiVolumeAttachment. The volume's iSCSI port.

Example: 3260

Returns:The port of this IScsiVolumeAttachment.
Return type:int
class oci.core.models.IcmpOptions
code

Gets the code of this IcmpOptions. The ICMP code (optional).

Returns:The code of this IcmpOptions.
Return type:int
type

Gets the type of this IcmpOptions. The ICMP type.

Returns:The type of this IcmpOptions.
Return type:int
class oci.core.models.Image
base_image_id

Gets the base_image_id of this Image. The OCID of the image originally used to launch the instance.

Returns:The base_image_id of this Image.
Return type:str
compartment_id

Gets the compartment_id of this Image. The OCID of the compartment containing the instance you want to use as the basis for the image.

Returns:The compartment_id of this Image.
Return type:str
create_image_allowed

Gets the create_image_allowed of this Image. Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance.

Example: true

Returns:The create_image_allowed of this Image.
Return type:bool
display_name

Gets the display_name of this Image. A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information. You cannot use an Oracle-provided image name as a custom image name.

Example: My custom Oracle Linux image

Returns:The display_name of this Image.
Return type:str
id

Gets the id of this Image. The OCID of the image.

Returns:The id of this Image.
Return type:str
lifecycle_state

Gets the lifecycle_state of this Image. Allowed values for this property are: "PROVISIONING", "IMPORTING", "AVAILABLE", "EXPORTING", "DISABLED", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this Image.
Return type:str
operating_system

Gets the operating_system of this Image. The image's operating system.

Example: Oracle Linux

Returns:The operating_system of this Image.
Return type:str
operating_system_version

Gets the operating_system_version of this Image. The image's operating system version.

Example: 7.2

Returns:The operating_system_version of this Image.
Return type:str
time_created

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

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

Returns:The time_created of this Image.
Return type:datetime
class oci.core.models.ImageSourceDetails
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

source_type

Gets the source_type of this ImageSourceDetails. The source type for the image. Use objectStorageTuple when specifying the namespace, bucket name, and object name. Use objectStorageUri when specifying the Object Storage Service URL.

Returns:The source_type of this ImageSourceDetails.
Return type:str
class oci.core.models.ImageSourceViaObjectStorageTupleDetails
bucket_name

Gets the bucket_name of this ImageSourceViaObjectStorageTupleDetails. The Object Storage Service bucket for the image.

Returns:The bucket_name of this ImageSourceViaObjectStorageTupleDetails.
Return type:str
namespace_name

Gets the namespace_name of this ImageSourceViaObjectStorageTupleDetails. The Object Storage Service namespace for the image.

Returns:The namespace_name of this ImageSourceViaObjectStorageTupleDetails.
Return type:str
object_name

Gets the object_name of this ImageSourceViaObjectStorageTupleDetails. The Object Storage Service name for the image.

Returns:The object_name of this ImageSourceViaObjectStorageTupleDetails.
Return type:str
class oci.core.models.ImageSourceViaObjectStorageUriDetails
source_uri

Gets the source_uri of this ImageSourceViaObjectStorageUriDetails. The Object Storage Service URL for the image.

Returns:The source_uri of this ImageSourceViaObjectStorageUriDetails.
Return type:str
class oci.core.models.IngressSecurityRule
icmp_options

Gets the icmp_options of this IngressSecurityRule. Optional and valid only for ICMP. Use to specify a particular ICMP type and code as defined in ICMP Parameters. If you specify ICMP as the protocol but omit this object, then all ICMP types and codes are allowed. If you do provide this object, the type is required and the code is optional. To enable MTU negotiation for ingress internet traffic, make sure to allow type 3 ("Destination Unreachable") code 4 ("Fragmentation Needed and Don't Fragment was Set"). If you need to specify multiple codes for a single type, create a separate security list rule for each.

Returns:The icmp_options of this IngressSecurityRule.
Return type:IcmpOptions
is_stateless

Gets the is_stateless of this IngressSecurityRule. A stateless rule allows traffic in one direction. Remember to add a corresponding stateless rule in the other direction if you need to support bidirectional traffic. For example, if ingress traffic allows TCP destination port 80, there should be an egress rule to allow TCP source port 80. Defaults to false, which means the rule is stateful and a corresponding rule is not necessary for bidirectional traffic.

Returns:The is_stateless of this IngressSecurityRule.
Return type:bool
protocol

Gets the protocol of this IngressSecurityRule. The transport protocol. Specify either all or an IPv4 protocol number as defined in Protocol Numbers. Options are supported only for ICMP ("1"), TCP ("6"), and UDP ("17").

Returns:The protocol of this IngressSecurityRule.
Return type:str
source

Gets the source of this IngressSecurityRule. The source CIDR block for the ingress rule. This is the range of IP addresses that a packet coming into the instance can come from.

Returns:The source of this IngressSecurityRule.
Return type:str
tcp_options

Gets the tcp_options of this IngressSecurityRule. Optional and valid only for TCP. Use to specify particular destination ports for TCP rules. If you specify TCP as the protocol but omit this object, then all destination ports are allowed.

Returns:The tcp_options of this IngressSecurityRule.
Return type:TcpOptions
udp_options

Gets the udp_options of this IngressSecurityRule. Optional and valid only for UDP. Use to specify particular destination ports for UDP rules. If you specify UDP as the protocol but omit this object, then all destination ports are allowed.

Returns:The udp_options of this IngressSecurityRule.
Return type:UdpOptions
class oci.core.models.Instance
availability_domain

Gets the availability_domain of this Instance. The Availability Domain the instance is running in.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this Instance.
Return type:str
compartment_id

Gets the compartment_id of this Instance. The OCID of the compartment that contains the instance.

Returns:The compartment_id of this Instance.
Return type:str
display_name

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

Example: My bare metal instance

Returns:The display_name of this Instance.
Return type:str
extended_metadata

Gets the extended_metadata of this Instance. Additional metadata key/value pairs that you provide. They serve a similar purpose and functionality from fields in the 'metadata' object.

They are distinguished from 'metadata' fields in that these can be nested JSON objects (whereas 'metadata' fields are string/string maps only).

If you don't need nested metadata values, it is strongly advised to avoid using this object and use the Metadata object instead.

Returns:The extended_metadata of this Instance.
Return type:dict(str, object)
id

Gets the id of this Instance. The OCID of the instance.

Returns:The id of this Instance.
Return type:str
image_id

Gets the image_id of this Instance. The image used to boot the instance. You can enumerate all available images by calling list_images().

Returns:The image_id of this Instance.
Return type:str
ipxe_script

Gets the ipxe_script of this Instance. When an Oracle Bare Metal Cloud Services or virtual machine instance boots, the iPXE firmware that runs on the instance is configured to run an iPXE script to continue the boot process.

If you want more control over the boot process, you can provide your own custom iPXE script that will run when the instance boots; however, you should be aware that the same iPXE script will run every time an instance boots; not only after the initial LaunchInstance call.

The default iPXE script connects to the instance's local boot volume over iSCSI and performs a network boot. If you use a custom iPXE script and want to network-boot from the instance's local boot volume over iSCSI the same way as the default iPXE script, you should use the following iSCSI IP address: 169.254.0.2, and boot volume IQN: iqn.2015-02.oracle.boot.

For more information about the Bring Your Own Image feature of Oracle Bare Metal Cloud Services, see Bring Your Own Image.

For more information about iPXE, see http://ipxe.org.

Returns:The ipxe_script of this Instance.
Return type:str
lifecycle_state

Gets the lifecycle_state of this Instance. The current state of the instance.

Allowed values for this property are: "PROVISIONING", "RUNNING", "STARTING", "STOPPING", "STOPPED", "CREATING_IMAGE", "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 Instance.
Return type:str
metadata

Gets the metadata of this Instance. Custom metadata that you provide.

Returns:The metadata of this Instance.
Return type:dict(str, str)
region

Gets the region of this Instance. The region that contains the Availability Domain the instance is running in.

Example: phx

Returns:The region of this Instance.
Return type:str
shape

Gets the shape of this Instance. The shape of the instance. The shape determines the number of CPUs and the amount of memory allocated to the instance. You can enumerate all available shapes by calling list_shapes().

Returns:The shape of this Instance.
Return type:str
time_created

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

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

Returns:The time_created of this Instance.
Return type:datetime
class oci.core.models.InstanceConsoleConnection
compartment_id

Gets the compartment_id of this InstanceConsoleConnection. The OCID of the compartment to contain the ConsoleConnection

Returns:The compartment_id of this InstanceConsoleConnection.
Return type:str
connection_string

Gets the connection_string of this InstanceConsoleConnection. The ssh connection string to the instance console

Returns:The connection_string of this InstanceConsoleConnection.
Return type:str
fingerprint

Gets the fingerprint of this InstanceConsoleConnection. The fingerprint of the ssh publicKey.

Returns:The fingerprint of this InstanceConsoleConnection.
Return type:str
id

Gets the id of this InstanceConsoleConnection. The OCID of the instance console connection

Returns:The id of this InstanceConsoleConnection.
Return type:str
instance_id

Gets the instance_id of this InstanceConsoleConnection. The host instance OCID

Returns:The instance_id of this InstanceConsoleConnection.
Return type:str
lifecycle_state

Gets the lifecycle_state of this InstanceConsoleConnection. The current state of the instance console connection.

Allowed values for this property are: "ACTIVE", "CREATING", "DELETED", "DELETING", "FAILED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this InstanceConsoleConnection.
Return type:str
class oci.core.models.InstanceCredentials
password

Gets the password of this InstanceCredentials. The password for the username.

Returns:The password of this InstanceCredentials.
Return type:str
username

Gets the username of this InstanceCredentials. The username.

Returns:The username of this InstanceCredentials.
Return type:str
class oci.core.models.InternetGateway
compartment_id

Gets the compartment_id of this InternetGateway. The OCID of the compartment containing the Internet Gateway.

Returns:The compartment_id of this InternetGateway.
Return type:str
display_name

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

Returns:The display_name of this InternetGateway.
Return type:str
id

Gets the id of this InternetGateway. The Internet Gateway's Oracle ID (OCID).

Returns:The id of this InternetGateway.
Return type:str
is_enabled

Gets the is_enabled of this InternetGateway. Whether the gateway is enabled. When the gateway is disabled, traffic is not routed to/from the Internet, regardless of route rules.

Returns:The is_enabled of this InternetGateway.
Return type:bool
lifecycle_state

Gets the lifecycle_state of this InternetGateway. The Internet Gateway's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 InternetGateway.
Return type:str
time_created

Gets the time_created of this InternetGateway. The date and time the Internet Gateway was created, in the format defined by RFC3339.

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

Returns:The time_created of this InternetGateway.
Return type:datetime
vcn_id

Gets the vcn_id of this InternetGateway. The OCID of the VCN the Internet Gateway belongs to.

Returns:The vcn_id of this InternetGateway.
Return type:str
class oci.core.models.LaunchInstanceDetails
availability_domain

Gets the availability_domain of this LaunchInstanceDetails. The Availability Domain of the instance.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this LaunchInstanceDetails.
Return type:str
compartment_id

Gets the compartment_id of this LaunchInstanceDetails. The OCID of the compartment.

Returns:The compartment_id of this LaunchInstanceDetails.
Return type:str
create_vnic_details

Gets the create_vnic_details of this LaunchInstanceDetails. Details for the primary VNIC, which is automatically created and attached when the instance is launched.

Returns:The create_vnic_details of this LaunchInstanceDetails.
Return type:CreateVnicDetails
display_name

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

Example: My bare metal instance

Returns:The display_name of this LaunchInstanceDetails.
Return type:str
extended_metadata

Gets the extended_metadata of this LaunchInstanceDetails. Additional metadata key/value pairs that you provide. They serve a similar purpose and functionality from fields in the 'metadata' object.

They are distinguished from 'metadata' fields in that these can be nested JSON objects (whereas 'metadata' fields are string/string maps only).

If you don't need nested metadata values, it is strongly advised to avoid using this object and use the Metadata object instead.

Returns:The extended_metadata of this LaunchInstanceDetails.
Return type:dict(str, object)
hostname_label

Gets the hostname_label of this LaunchInstanceDetails. Deprecated. Instead use hostnameLabel in CreateVnicDetails. If you provide both, the values must match.

Returns:The hostname_label of this LaunchInstanceDetails.
Return type:str
image_id

Gets the image_id of this LaunchInstanceDetails. The OCID of the image used to boot the instance.

Returns:The image_id of this LaunchInstanceDetails.
Return type:str
ipxe_script

Gets the ipxe_script of this LaunchInstanceDetails. This is an advanced option.

When an Oracle Bare Metal Cloud Services or virtual machine instance boots, the iPXE firmware that runs on the instance is configured to run an iPXE script to continue the boot process.

If you want more control over the boot process, you can provide your own custom iPXE script that will run when the instance boots; however, you should be aware that the same iPXE script will run every time an instance boots; not only after the initial LaunchInstance call.

The default iPXE script connects to the instance's local boot volume over iSCSI and performs a network boot. If you use a custom iPXE script and want to network-boot from the instance's local boot volume over iSCSI the same way as the default iPXE script, you should use the following iSCSI IP address: 169.254.0.2, and boot volume IQN: iqn.2015-02.oracle.boot.

For more information about the Bring Your Own Image feature of Oracle Bare Metal Cloud Services, see Bring Your Own Image.

For more information about iPXE, see http://ipxe.org.

Returns:The ipxe_script of this LaunchInstanceDetails.
Return type:str
metadata

Gets the metadata of this LaunchInstanceDetails. Custom metadata key/value pairs that you provide, such as the SSH public key required to connect to the instance.

A metadata service runs on every launched instance. The service is an HTTP endpoint listening on 169.254.169.254. You can use the service to:

  • Provide information to Cloud-Init to be used for various system initialization tasks.
  • Get information about the instance, including the custom metadata that you provide when you launch the instance.

Providing Cloud-Init Metadata

You can use the following metadata key names to provide information to Cloud-Init:

"ssh_authorized_keys" - Provide one or more public SSH keys to be included in the ~/.ssh/authorized_keys file for the default user on the instance. Use a newline character to separate multiple keys. The SSH keys must be in the format necessary for the authorized_keys file, as shown in the example below.

"user_data" - Provide your own base64-encoded data to be used by Cloud-Init to run custom scripts or provide custom Cloud-Init configuration. For information about how to take advantage of user data, see the Cloud-Init Documentation.

Note: Cloud-Init does not pull this data from the http://169.254.169.254/opc/v1/instance/metadata/ path. When the instance launches and either of these keys are provided, the key values are formatted as OpenStack metadata and copied to the following locations, which are recognized by Cloud-Init:

http://169.254.169.254/openstack/latest/meta_data.json - This JSON blob contains, among other things, the SSH keys that you provided for

"ssh_authorized_keys".

http://169.254.169.254/openstack/latest/user_data - Contains the base64-decoded data that you provided for "user_data".

Metadata Example

"metadata"
: {
"quake_bot_level" : "Severe", "ssh_authorized_keys" : "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCZ06fccNTQfq+xubFlJ5ZR3kt+uzspdH9tXL+lAejSM1NXM+CFZev7MIxfEjas06y80ZBZ7DUTQO0GxJPeD8NCOb1VorF8M4xuLwrmzRtkoZzU16umt4y1W0Q4ifdp3IiiU0U8/WxczSXcUVZOLqkz5dc6oMHdMVpkimietWzGZ4LBBsH/LjEVY7E0V+a0sNchlVDIZcm7ErReBLcdTGDq0uLBiuChyl6RUkX1PNhusquTGwK7zc8OBXkRuubn5UKXhI3Ul9Nyk4XESkVWIGNKmw8mSpoJSjR8P9ZjRmcZVo8S+x4KVPMZKQEor== ryan.smith@company.com ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAzJSAtwEPoB3Jmr58IXrDGzLuDYkWAYg8AsLYlo6JZvKpjY1xednIcfEVQJm4T2DhVmdWhRrwQ8DmayVZvBkLt+zs2LdoAJEVimKwXcJFD/7wtH8Lnk17HiglbbbNXsemjDY0hea4JUE5CfvkIdZBITuMrfqSmA4n3VNoorXYdvtTMoGG8fxMub46RPtuxtqi9bG9Zqenordkg5FJt2mVNfQRqf83CWojcOkklUWq4CjyxaeLf5i9gv1fRoBo4QhiA8I6NCSppO8GnoV/6Ox6TNoh9BiifqGKC9VGYuC89RvUajRBTZSK2TK4DPfaT+2R+slPsFrwiT/oPEhhEK1S5Q== rsa-key-20160227", "user_data" : "SWYgeW91IGNhbiBzZWUgdGhpcywgdGhlbiBpdCB3b3JrZWQgbWF5YmUuCg=="

}

Getting Metadata on the Instance

To get information about your instance, connect to the instance using SSH and issue any of the following GET requests:

You'll get back a response that includes all the instance information; only the metadata information; or the metadata information for the specified key name, respectively.

Returns:The metadata of this LaunchInstanceDetails.
Return type:dict(str, str)
shape

Gets the shape of this LaunchInstanceDetails. The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling list_shapes().

Returns:The shape of this LaunchInstanceDetails.
Return type:str
subnet_id

Gets the subnet_id of this LaunchInstanceDetails. Deprecated. Instead use subnetId in CreateVnicDetails. At least one of them is required; if you provide both, the values must match.

Returns:The subnet_id of this LaunchInstanceDetails.
Return type:str
class oci.core.models.LetterOfAuthority
circuit_type

Gets the circuit_type of this LetterOfAuthority. The type of cross-connect fiber, termination, and optical specification.

Allowed values for this property are: "Single_mode_LC", "Single_mode_SC", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The circuit_type of this LetterOfAuthority.
Return type:str
cross_connect_id

Gets the cross_connect_id of this LetterOfAuthority. The OCID of the cross-connect.

Returns:The cross_connect_id of this LetterOfAuthority.
Return type:str
facility_location

Gets the facility_location of this LetterOfAuthority. The address of the FastConnect location.

Returns:The facility_location of this LetterOfAuthority.
Return type:str
port_name

Gets the port_name of this LetterOfAuthority. The meet-me room port for this cross-connect.

Returns:The port_name of this LetterOfAuthority.
Return type:str
time_expires

Gets the time_expires of this LetterOfAuthority. The date and time when the Letter of Authority expires, in the format defined by RFC3339.

Returns:The time_expires of this LetterOfAuthority.
Return type:datetime
time_issued

Gets the time_issued of this LetterOfAuthority. The date and time the Letter of Authority was created, in the format defined by RFC3339.

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

Returns:The time_issued of this LetterOfAuthority.
Return type:datetime
class oci.core.models.PortRange
max

Gets the max of this PortRange. The maximum port number. Must not be lower than the minimum port number. To specify a single port number, set both the min and max to the same value.

Returns:The max of this PortRange.
Return type:int
min

Gets the min of this PortRange. The minimum port number. Must not be greater than the maximum port number.

Returns:The min of this PortRange.
Return type:int
class oci.core.models.PrivateIp
availability_domain

Gets the availability_domain of this PrivateIp. The private IP's Availability Domain.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this PrivateIp.
Return type:str
compartment_id

Gets the compartment_id of this PrivateIp. The OCID of the compartment containing the private IP.

Returns:The compartment_id of this PrivateIp.
Return type:str
display_name

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

Returns:The display_name of this PrivateIp.
Return type:str
hostname_label

Gets the hostname_label of this PrivateIp. The hostname for the private IP. Used for DNS. The value is the hostname portion of the private IP's fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123.

For more information, see DNS in Your Virtual Cloud Network.

Example: bminstance-1

Returns:The hostname_label of this PrivateIp.
Return type:str
id

Gets the id of this PrivateIp. The private IP's Oracle ID (OCID).

Returns:The id of this PrivateIp.
Return type:str
ip_address

Gets the ip_address of this PrivateIp. The private IP address of the privateIp object. The address is within the CIDR of the VNIC's subnet.

Example: 10.0.3.3

Returns:The ip_address of this PrivateIp.
Return type:str
is_primary

Gets the is_primary of this PrivateIp. Whether this private IP is the primary one on the VNIC. Primary private IPs are unassigned and deleted automatically when the VNIC is terminated.

Example: true

Returns:The is_primary of this PrivateIp.
Return type:bool
subnet_id

Gets the subnet_id of this PrivateIp. The OCID of the subnet the VNIC is in.

Returns:The subnet_id of this PrivateIp.
Return type:str
time_created

Gets the time_created of this PrivateIp. The date and time the private IP was created, in the format defined by RFC3339.

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

Returns:The time_created of this PrivateIp.
Return type:datetime
vnic_id

Gets the vnic_id of this PrivateIp. The OCID of the VNIC the private IP is assigned to. The VNIC and private IP must be in the same subnet.

Returns:The vnic_id of this PrivateIp.
Return type:str
class oci.core.models.RouteRule
cidr_block

Gets the cidr_block of this RouteRule. A destination IP address range in CIDR notation. Matching packets will be routed to the indicated network entity (the target).

Example: 0.0.0.0/0

Returns:The cidr_block of this RouteRule.
Return type:str
network_entity_id

Gets the network_entity_id of this RouteRule. The OCID for the route rule's target.

Returns:The network_entity_id of this RouteRule.
Return type:str
class oci.core.models.RouteTable
compartment_id

Gets the compartment_id of this RouteTable. The OCID of the compartment containing the route table.

Returns:The compartment_id of this RouteTable.
Return type:str
display_name

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

Returns:The display_name of this RouteTable.
Return type:str
id

Gets the id of this RouteTable. The route table's Oracle ID (OCID).

Returns:The id of this RouteTable.
Return type:str
lifecycle_state

Gets the lifecycle_state of this RouteTable. The route table's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 RouteTable.
Return type:str
route_rules

Gets the route_rules of this RouteTable. The collection of rules for routing destination IPs to network devices.

Returns:The route_rules of this RouteTable.
Return type:list[RouteRule]
time_created

Gets the time_created of this RouteTable. The date and time the route table was created, in the format defined by RFC3339.

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

Returns:The time_created of this RouteTable.
Return type:datetime
vcn_id

Gets the vcn_id of this RouteTable. The OCID of the VCN the route table list belongs to.

Returns:The vcn_id of this RouteTable.
Return type:str
class oci.core.models.SecurityList
compartment_id

Gets the compartment_id of this SecurityList. The OCID of the compartment containing the security list.

Returns:The compartment_id of this SecurityList.
Return type:str
display_name

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

Returns:The display_name of this SecurityList.
Return type:str
egress_security_rules

Gets the egress_security_rules of this SecurityList. Rules for allowing egress IP packets.

Returns:The egress_security_rules of this SecurityList.
Return type:list[EgressSecurityRule]
id

Gets the id of this SecurityList. The security list's Oracle Cloud ID (OCID).

Returns:The id of this SecurityList.
Return type:str
ingress_security_rules

Gets the ingress_security_rules of this SecurityList. Rules for allowing ingress IP packets.

Returns:The ingress_security_rules of this SecurityList.
Return type:list[IngressSecurityRule]
lifecycle_state

Gets the lifecycle_state of this SecurityList. The security list's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 SecurityList.
Return type:str
time_created

Gets the time_created of this SecurityList. The date and time the security list was created, in the format defined by RFC3339.

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

Returns:The time_created of this SecurityList.
Return type:datetime
vcn_id

Gets the vcn_id of this SecurityList. The OCID of the VCN the security list belongs to.

Returns:The vcn_id of this SecurityList.
Return type:str
class oci.core.models.Shape
shape

Gets the shape of this Shape. The name of the shape. You can enumerate all available shapes by calling list_shapes().

Returns:The shape of this Shape.
Return type:str
class oci.core.models.Subnet
availability_domain

Gets the availability_domain of this Subnet. The subnet's Availability Domain.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this Subnet.
Return type:str
cidr_block

Gets the cidr_block of this Subnet. The subnet's CIDR block.

Example: 172.16.1.0/24

Returns:The cidr_block of this Subnet.
Return type:str
compartment_id

Gets the compartment_id of this Subnet. The OCID of the compartment containing the subnet.

Returns:The compartment_id of this Subnet.
Return type:str
dhcp_options_id

Gets the dhcp_options_id of this Subnet. The OCID of the set of DHCP options associated with the subnet.

Returns:The dhcp_options_id of this Subnet.
Return type:str
display_name

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

Returns:The display_name of this Subnet.
Return type:str
dns_label

Gets the dns_label of this Subnet. A DNS label for the subnet, used in conjunction with the VNIC's hostname and VCN's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example, bminstance-1.subnet123.vcn1.oraclevcn.com). Must be an alphanumeric string that begins with a letter and is unique within the VCN. The value cannot be changed.

The absence of this parameter means the Internet and VCN Resolver will not resolve hostnames of instances in this subnet.

For more information, see DNS in Your Virtual Cloud Network.

Example: subnet123

Returns:The dns_label of this Subnet.
Return type:str
id

Gets the id of this Subnet. The subnet's Oracle ID (OCID).

Returns:The id of this Subnet.
Return type:str
lifecycle_state

Gets the lifecycle_state of this Subnet. The subnet's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 Subnet.
Return type:str
prohibit_public_ip_on_vnic

Gets the prohibit_public_ip_on_vnic of this Subnet. Whether VNICs within this subnet can have public IP addresses. Defaults to false, which means VNICs created in this subnet will automatically be assigned public IP addresses unless specified otherwise during instance launch or VNIC creation (with the assignPublicIp flag in CreateVnicDetails). If prohibitPublicIpOnVnic is set to true, VNICs created in this subnet cannot have public IP addresses (that is, it's a private subnet).

Example: true

Returns:The prohibit_public_ip_on_vnic of this Subnet.
Return type:bool
route_table_id

Gets the route_table_id of this Subnet. The OCID of the route table the subnet is using.

Returns:The route_table_id of this Subnet.
Return type:str
security_list_ids

Gets the security_list_ids of this Subnet. OCIDs for the security lists to use for VNICs in this subnet.

Returns:The security_list_ids of this Subnet.
Return type:list[str]
subnet_domain_name

Gets the subnet_domain_name of this Subnet. The subnet's domain name, which consists of the subnet's DNS label, the VCN's DNS label, and the oraclevcn.com domain.

For more information, see DNS in Your Virtual Cloud Network.

Example: subnet123.vcn1.oraclevcn.com

Returns:The subnet_domain_name of this Subnet.
Return type:str
time_created

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

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

Returns:The time_created of this Subnet.
Return type:datetime
vcn_id

Gets the vcn_id of this Subnet. The OCID of the VCN the subnet is in.

Returns:The vcn_id of this Subnet.
Return type:str
virtual_router_ip

Gets the virtual_router_ip of this Subnet. The IP address of the virtual router.

Example: 10.0.14.1

Returns:The virtual_router_ip of this Subnet.
Return type:str
virtual_router_mac

Gets the virtual_router_mac of this Subnet. The MAC address of the virtual router.

Example: 00:00:17:B6:4D:DD

Returns:The virtual_router_mac of this Subnet.
Return type:str
class oci.core.models.TcpOptions
destination_port_range

Gets the destination_port_range of this TcpOptions. An inclusive range of allowed destination ports. Use the same number for the min and max to indicate a single port. Defaults to all ports if not specified.

Returns:The destination_port_range of this TcpOptions.
Return type:PortRange
source_port_range

Gets the source_port_range of this TcpOptions. An inclusive range of allowed source ports. Use the same number for the min and max to indicate a single port. Defaults to all ports if not specified.

Returns:The source_port_range of this TcpOptions.
Return type:PortRange
class oci.core.models.TunnelConfig
ip_address

Gets the ip_address of this TunnelConfig. The IP address of Oracle's VPN headend.

Example: 129.146.17.50

Returns:The ip_address of this TunnelConfig.
Return type:str
shared_secret

Gets the shared_secret of this TunnelConfig. The shared secret of the IPSec tunnel.

Example: vFG2IF6TWq4UToUiLSRDoJEUs6j1c.p8G.dVQxiMfMO0yXMLi.lZTbYIWhGu4V8o

Returns:The shared_secret of this TunnelConfig.
Return type:str
time_created

Gets the time_created of this TunnelConfig. The date and time the IPSec connection was created, in the format defined by RFC3339.

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

Returns:The time_created of this TunnelConfig.
Return type:datetime
class oci.core.models.TunnelStatus
ip_address

Gets the ip_address of this TunnelStatus. The IP address of Oracle's VPN headend.

Example: 129.146.17.50

Returns:The ip_address of this TunnelStatus.
Return type:str
lifecycle_state

Gets the lifecycle_state of this TunnelStatus. The tunnel's current state.

Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this TunnelStatus.
Return type:str
time_created

Gets the time_created of this TunnelStatus. The date and time the IPSec connection was created, in the format defined by RFC3339.

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

Returns:The time_created of this TunnelStatus.
Return type:datetime
time_state_modified

Gets the time_state_modified of this TunnelStatus. When the state of the tunnel last changed, in the format defined by RFC3339.

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

Returns:The time_state_modified of this TunnelStatus.
Return type:datetime
class oci.core.models.UdpOptions
destination_port_range

Gets the destination_port_range of this UdpOptions. An inclusive range of allowed destination ports. Use the same number for the min and max to indicate a single port. Defaults to all ports if not specified.

Returns:The destination_port_range of this UdpOptions.
Return type:PortRange
source_port_range

Gets the source_port_range of this UdpOptions. An inclusive range of allowed source ports. Use the same number for the min and max to indicate a single port. Defaults to all ports if not specified.

Returns:The source_port_range of this UdpOptions.
Return type:PortRange
class oci.core.models.UpdateCpeDetails
display_name

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

Returns:The display_name of this UpdateCpeDetails.
Return type:str
class oci.core.models.UpdateCrossConnectDetails
display_name

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

Returns:The display_name of this UpdateCrossConnectDetails.
Return type:str
is_active

Gets the is_active of this UpdateCrossConnectDetails. Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.

Example: true

Returns:The is_active of this UpdateCrossConnectDetails.
Return type:bool
class oci.core.models.UpdateCrossConnectGroupDetails
display_name

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

Returns:The display_name of this UpdateCrossConnectGroupDetails.
Return type:str
class oci.core.models.UpdateDhcpDetails
display_name

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

Returns:The display_name of this UpdateDhcpDetails.
Return type:str
options

Gets the options of this UpdateDhcpDetails.

Returns:The options of this UpdateDhcpDetails.
Return type:list[DhcpOption]
class oci.core.models.UpdateDrgAttachmentDetails
display_name

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

Returns:The display_name of this UpdateDrgAttachmentDetails.
Return type:str
class oci.core.models.UpdateDrgDetails
display_name

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

Returns:The display_name of this UpdateDrgDetails.
Return type:str
class oci.core.models.UpdateIPSecConnectionDetails
display_name

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

Returns:The display_name of this UpdateIPSecConnectionDetails.
Return type:str
class oci.core.models.UpdateImageDetails
display_name

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

Example: My custom Oracle Linux image

Returns:The display_name of this UpdateImageDetails.
Return type:str
class oci.core.models.UpdateInstanceDetails
display_name

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

Example: My bare metal instance

Returns:The display_name of this UpdateInstanceDetails.
Return type:str
class oci.core.models.UpdateInternetGatewayDetails
display_name

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

Returns:The display_name of this UpdateInternetGatewayDetails.
Return type:str
is_enabled

Gets the is_enabled of this UpdateInternetGatewayDetails. Whether the gateway is enabled.

Returns:The is_enabled of this UpdateInternetGatewayDetails.
Return type:bool
class oci.core.models.UpdatePrivateIpDetails
display_name

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

Returns:The display_name of this UpdatePrivateIpDetails.
Return type:str
hostname_label

Gets the hostname_label of this UpdatePrivateIpDetails. The hostname for the private IP. Used for DNS. The value is the hostname portion of the private IP's fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123.

For more information, see DNS in Your Virtual Cloud Network.

Example: bminstance-1

Returns:The hostname_label of this UpdatePrivateIpDetails.
Return type:str
vnic_id

Gets the vnic_id of this UpdatePrivateIpDetails. The OCID of the VNIC to reassign the private IP to. The VNIC must be in the same subnet as the current VNIC.

Returns:The vnic_id of this UpdatePrivateIpDetails.
Return type:str
class oci.core.models.UpdateRouteTableDetails
display_name

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

Returns:The display_name of this UpdateRouteTableDetails.
Return type:str
route_rules

Gets the route_rules of this UpdateRouteTableDetails. The collection of rules used for routing destination IPs to network devices.

Returns:The route_rules of this UpdateRouteTableDetails.
Return type:list[RouteRule]
class oci.core.models.UpdateSecurityListDetails
display_name

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

Returns:The display_name of this UpdateSecurityListDetails.
Return type:str
egress_security_rules

Gets the egress_security_rules of this UpdateSecurityListDetails. Rules for allowing egress IP packets.

Returns:The egress_security_rules of this UpdateSecurityListDetails.
Return type:list[EgressSecurityRule]
ingress_security_rules

Gets the ingress_security_rules of this UpdateSecurityListDetails. Rules for allowing ingress IP packets.

Returns:The ingress_security_rules of this UpdateSecurityListDetails.
Return type:list[IngressSecurityRule]
class oci.core.models.UpdateSubnetDetails
display_name

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

Returns:The display_name of this UpdateSubnetDetails.
Return type:str
class oci.core.models.UpdateVcnDetails
display_name

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

Returns:The display_name of this UpdateVcnDetails.
Return type:str
class oci.core.models.UpdateVirtualCircuitDetails
bandwidth_shape_name

Gets the bandwidth_shape_name of this UpdateVirtualCircuitDetails. The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see list_virtual_circuit_bandwidth_shapes().

To be updated only by the customer who owns the virtual circuit.

Returns:The bandwidth_shape_name of this UpdateVirtualCircuitDetails.
Return type:str
cross_connect_mappings

Gets the cross_connect_mappings of this UpdateVirtualCircuitDetails. An array of mappings, each containing properties for a cross-connect or cross-connect group associated with this virtual circuit.

The customer and provider can update different properties in the mapping depending on the situation. See the description of the CrossConnectMapping.

Returns:The cross_connect_mappings of this UpdateVirtualCircuitDetails.
Return type:list[CrossConnectMapping]
customer_bgp_asn

Gets the customer_bgp_asn of this UpdateVirtualCircuitDetails. The BGP ASN of the network at the other end of the BGP session from Oracle.

If the BGP session is from the customer's edge router to Oracle, the required value is the customer's ASN, and it can be updated only by the customer.

If the BGP session is from the provider's edge router to Oracle, the required value is the provider's ASN, and it can be updated only by the provider.

Returns:The customer_bgp_asn of this UpdateVirtualCircuitDetails.
Return type:int
display_name

Gets the display_name of this UpdateVirtualCircuitDetails. A user-friendly name. Does not have to be unique. Avoid entering confidential information.

To be updated only by the customer who owns the virtual circuit.

Returns:The display_name of this UpdateVirtualCircuitDetails.
Return type:str
gateway_id

Gets the gateway_id of this UpdateVirtualCircuitDetails. The OCID of the Drg that this virtual circuit uses.

To be updated only by the customer who owns the virtual circuit.

Returns:The gateway_id of this UpdateVirtualCircuitDetails.
Return type:str
provider_state

Gets the provider_state of this UpdateVirtualCircuitDetails. The provider's state in relation to this virtual circuit. Relevant only if the customer is using FastConnect via a provider. ACTIVE means the provider has provisioned the virtual circuit from their end. INACTIVE means the provider has not yet provisioned the virtual circuit, or has de-provisioned it.

To be updated only by the provider.

Allowed values for this property are: "ACTIVE", "INACTIVE"

Returns:The provider_state of this UpdateVirtualCircuitDetails.
Return type:str
reference_comment

Gets the reference_comment of this UpdateVirtualCircuitDetails. Provider-supplied reference information about this virtual circuit. Relevant only if the customer is using FastConnect via a provider.

To be updated only by the provider.

Returns:The reference_comment of this UpdateVirtualCircuitDetails.
Return type:str
class oci.core.models.UpdateVnicDetails
display_name

Gets the display_name of this UpdateVnicDetails. A user-friendly name. Does not have to be unique, and it's changeable.

Returns:The display_name of this UpdateVnicDetails.
Return type:str
hostname_label

Gets the hostname_label of this UpdateVnicDetails. The hostname for the VNIC's primary private IP. Used for DNS. The value is the hostname portion of the primary private IP's fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123. The value appears in the Vnic object and also the PrivateIp object returned by list_private_ips() and get_private_ip().

For more information, see DNS in Your Virtual Cloud Network.

Returns:The hostname_label of this UpdateVnicDetails.
Return type:str
class oci.core.models.UpdateVolumeBackupDetails
display_name

Gets the display_name of this UpdateVolumeBackupDetails. A friendly user-specified name for the volume backup. Avoid entering confidential information.

Returns:The display_name of this UpdateVolumeBackupDetails.
Return type:str
class oci.core.models.UpdateVolumeDetails
display_name

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

Returns:The display_name of this UpdateVolumeDetails.
Return type:str
class oci.core.models.Vcn
cidr_block

Gets the cidr_block of this Vcn. The CIDR IP address block of the VCN.

Example: 172.16.0.0/16

Returns:The cidr_block of this Vcn.
Return type:str
compartment_id

Gets the compartment_id of this Vcn. The OCID of the compartment containing the VCN.

Returns:The compartment_id of this Vcn.
Return type:str
default_dhcp_options_id

Gets the default_dhcp_options_id of this Vcn. The OCID for the VCN's default set of DHCP options.

Returns:The default_dhcp_options_id of this Vcn.
Return type:str
default_route_table_id

Gets the default_route_table_id of this Vcn. The OCID for the VCN's default route table.

Returns:The default_route_table_id of this Vcn.
Return type:str
default_security_list_id

Gets the default_security_list_id of this Vcn. The OCID for the VCN's default security list.

Returns:The default_security_list_id of this Vcn.
Return type:str
display_name

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

Returns:The display_name of this Vcn.
Return type:str
dns_label

Gets the dns_label of this Vcn. A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example, bminstance-1.subnet123.vcn1.oraclevcn.com). Must be an alphanumeric string that begins with a letter. The value cannot be changed.

The absence of this parameter means the Internet and VCN Resolver will not work for this VCN.

For more information, see DNS in Your Virtual Cloud Network.

Example: vcn1

Returns:The dns_label of this Vcn.
Return type:str
id

Gets the id of this Vcn. The VCN's Oracle ID (OCID).

Returns:The id of this Vcn.
Return type:str
lifecycle_state

Gets the lifecycle_state of this Vcn. The VCN's current state.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 Vcn.
Return type:str
time_created

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

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

Returns:The time_created of this Vcn.
Return type:datetime
vcn_domain_name

Gets the vcn_domain_name of this Vcn. The VCN's domain name, which consists of the VCN's DNS label, and the oraclevcn.com domain.

For more information, see DNS in Your Virtual Cloud Network.

Example: vcn1.oraclevcn.com

Returns:The vcn_domain_name of this Vcn.
Return type:str
class oci.core.models.VirtualCircuit
bandwidth_shape_name

Gets the bandwidth_shape_name of this VirtualCircuit. The provisioned data rate of the connection.

Returns:The bandwidth_shape_name of this VirtualCircuit.
Return type:str
bgp_session_state

Gets the bgp_session_state of this VirtualCircuit. The state of the BGP session associated with the virtual circuit.

Allowed values for this property are: "UP", "DOWN", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The bgp_session_state of this VirtualCircuit.
Return type:str
compartment_id

Gets the compartment_id of this VirtualCircuit. The OCID of the compartment containing the virtual circuit.

Returns:The compartment_id of this VirtualCircuit.
Return type:str
cross_connect_mappings

Gets the cross_connect_mappings of this VirtualCircuit. An array of mappings, each containing properties for a cross-connect or cross-connect group that is associated with this virtual circuit.

Returns:The cross_connect_mappings of this VirtualCircuit.
Return type:list[CrossConnectMapping]
customer_bgp_asn

Gets the customer_bgp_asn of this VirtualCircuit. The BGP ASN of the network at the other end of the BGP session from Oracle. If the session is between the customer's edge router and Oracle, the value is the customer's ASN. If the BGP session is between the provider's edge router and Oracle, the value is the provider's ASN.

Returns:The customer_bgp_asn of this VirtualCircuit.
Return type:int
display_name

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

Returns:The display_name of this VirtualCircuit.
Return type:str
gateway_id

Gets the gateway_id of this VirtualCircuit. The OCID of the customer's Drg that this virtual circuit uses.

Returns:The gateway_id of this VirtualCircuit.
Return type:str
id

Gets the id of this VirtualCircuit. The virtual circuit's Oracle ID (OCID).

Returns:The id of this VirtualCircuit.
Return type:str
lifecycle_state

Gets the lifecycle_state of this VirtualCircuit. The virtual circuit's current state. For information about the different states, see FastConnect Overview.

Allowed values for this property are: "PENDING_PROVIDER", "VERIFYING", "PROVISIONING", "PROVISIONED", "FAILED", "INACTIVE", "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 VirtualCircuit.
Return type:str
oracle_bgp_asn

Gets the oracle_bgp_asn of this VirtualCircuit. The Oracle BGP ASN.

Returns:The oracle_bgp_asn of this VirtualCircuit.
Return type:int
provider_name

Gets the provider_name of this VirtualCircuit. The name of the provider (if the customer is connecting via a provider).

Returns:The provider_name of this VirtualCircuit.
Return type:str
provider_service_name

Gets the provider_service_name of this VirtualCircuit. The name of the service offered by the provider (if the customer is connecting via a provider).

Returns:The provider_service_name of this VirtualCircuit.
Return type:str
provider_state

Gets the provider_state of this VirtualCircuit. The provider's state in relation to this virtual circuit (if the customer is connecting via a provider). ACTIVE means the provider has provisioned the virtual circuit from their end. INACTIVE means the provider has not yet provisioned the virtual circuit, or has de-provisioned it.

Allowed values for this property are: "ACTIVE", "INACTIVE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The provider_state of this VirtualCircuit.
Return type:str
reference_comment

Gets the reference_comment of this VirtualCircuit. Provider-supplied reference information about this virtual circuit (if the customer is connecting via a provider).

Returns:The reference_comment of this VirtualCircuit.
Return type:str
region

Gets the region of this VirtualCircuit. The Oracle Bare Metal Cloud Services region where this virtual circuit is located.

Returns:The region of this VirtualCircuit.
Return type:str
time_created

Gets the time_created of this VirtualCircuit. The date and time the virtual circuit was created, in the format defined by RFC3339.

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

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

Gets the type of this VirtualCircuit. The type of IP addresses used in this virtual circuit. PRIVATE means RFC 1918 addresses (10.0.0.0/8, 172.16/12, and 192.168/16). Only PRIVATE is supported.

Allowed values for this property are: "PUBLIC", "PRIVATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The type of this VirtualCircuit.
Return type:str
class oci.core.models.VirtualCircuitBandwidthShape
bandwidth_in_mbps

Gets the bandwidth_in_mbps of this VirtualCircuitBandwidthShape. The bandwidth in Mbps.

Example: 10000

Returns:The bandwidth_in_mbps of this VirtualCircuitBandwidthShape.
Return type:int
name

Gets the name of this VirtualCircuitBandwidthShape. The name of the bandwidth shape.

Example: 10 Gbps

Returns:The name of this VirtualCircuitBandwidthShape.
Return type:str
class oci.core.models.Vnic
availability_domain

Gets the availability_domain of this Vnic. The VNIC's Availability Domain.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this Vnic.
Return type:str
compartment_id

Gets the compartment_id of this Vnic. The OCID of the compartment containing the VNIC.

Returns:The compartment_id of this Vnic.
Return type:str
display_name

Gets the display_name of this Vnic. A user-friendly name. Does not have to be unique. Avoid entering confidential information.

Returns:The display_name of this Vnic.
Return type:str
hostname_label

Gets the hostname_label of this Vnic. The hostname for the VNIC's primary private IP. Used for DNS. The value is the hostname portion of the primary private IP's fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123.

For more information, see DNS in Your Virtual Cloud Network.

Example: bminstance-1

Returns:The hostname_label of this Vnic.
Return type:str
id

Gets the id of this Vnic. The OCID of the VNIC.

Returns:The id of this Vnic.
Return type:str
is_primary

Gets the is_primary of this Vnic. Whether the VNIC is the primary VNIC (the VNIC that is automatically created and attached during instance launch).

Returns:The is_primary of this Vnic.
Return type:bool
lifecycle_state

Gets the lifecycle_state of this Vnic. The current state of the VNIC.

Allowed values for this property are: "PROVISIONING", "AVAILABLE", "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 Vnic.
Return type:str
mac_address

Gets the mac_address of this Vnic. The MAC address of the VNIC.

Example: 00:00:17:B6:4D:DD

Returns:The mac_address of this Vnic.
Return type:str
private_ip

Gets the private_ip of this Vnic. The private IP address of the primary privateIp object on the VNIC. The address is within the CIDR of the VNIC's subnet.

Example: 10.0.3.3

Returns:The private_ip of this Vnic.
Return type:str
public_ip

Gets the public_ip of this Vnic. The public IP address of the VNIC, if one is assigned.

Returns:The public_ip of this Vnic.
Return type:str
subnet_id

Gets the subnet_id of this Vnic. The OCID of the subnet the VNIC is in.

Returns:The subnet_id of this Vnic.
Return type:str
time_created

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

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

Returns:The time_created of this Vnic.
Return type:datetime
class oci.core.models.VnicAttachment
availability_domain

Gets the availability_domain of this VnicAttachment. The Availability Domain of the instance.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this VnicAttachment.
Return type:str
compartment_id

Gets the compartment_id of this VnicAttachment. The OCID of the compartment the VNIC attachment is in, which is the same compartment the instance is in.

Returns:The compartment_id of this VnicAttachment.
Return type:str
display_name

Gets the display_name of this VnicAttachment. A user-friendly name. Does not have to be unique. Avoid entering confidential information.

Returns:The display_name of this VnicAttachment.
Return type:str
id

Gets the id of this VnicAttachment. The OCID of the VNIC attachment.

Returns:The id of this VnicAttachment.
Return type:str
instance_id

Gets the instance_id of this VnicAttachment. The OCID of the instance.

Returns:The instance_id of this VnicAttachment.
Return type:str
lifecycle_state

Gets the lifecycle_state of this VnicAttachment. The current state of the VNIC attachment.

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'.

Returns:The lifecycle_state of this VnicAttachment.
Return type:str
subnet_id

Gets the subnet_id of this VnicAttachment. The OCID of the VNIC's subnet.

Returns:The subnet_id of this VnicAttachment.
Return type:str
time_created

Gets the time_created of this VnicAttachment. The date and time the VNIC attachment was created, in the format defined by RFC3339.

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

Returns:The time_created of this VnicAttachment.
Return type:datetime
vlan_tag

Gets the vlan_tag of this VnicAttachment. The Oracle-assigned VLAN tag of the attached VNIC. Available after the attachment process is complete.

Example: 0

Returns:The vlan_tag of this VnicAttachment.
Return type:int
vnic_id

Gets the vnic_id of this VnicAttachment. The OCID of the VNIC. Available after the attachment process is complete.

Returns:The vnic_id of this VnicAttachment.
Return type:str
class oci.core.models.Volume
availability_domain

Gets the availability_domain of this Volume. The Availability Domain of the volume.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this Volume.
Return type:str
compartment_id

Gets the compartment_id of this Volume. The OCID of the compartment that contains the volume.

Returns:The compartment_id of this Volume.
Return type:str
display_name

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

Returns:The display_name of this Volume.
Return type:str
id

Gets the id of this Volume. The volume's Oracle ID (OCID).

Returns:The id of this Volume.
Return type:str
lifecycle_state

Gets the lifecycle_state of this Volume. The current state of a volume.

Allowed values for this property are: "PROVISIONING", "RESTORING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAULTY", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this Volume.
Return type:str
size_in_mbs

Gets the size_in_mbs of this Volume. The size of the volume in MBs. The value must be a multiple of 1024.

Returns:The size_in_mbs of this Volume.
Return type:int
time_created

Gets the time_created of this Volume. The date and time the volume was created. Format defined by RFC3339.

Returns:The time_created of this Volume.
Return type:datetime
class oci.core.models.VolumeAttachment
attachment_type

Gets the attachment_type of this VolumeAttachment. The type of volume attachment.

Returns:The attachment_type of this VolumeAttachment.
Return type:str
availability_domain

Gets the availability_domain of this VolumeAttachment. The Availability Domain of an instance.

Example: Uocm:PHX-AD-1

Returns:The availability_domain of this VolumeAttachment.
Return type:str
compartment_id

Gets the compartment_id of this VolumeAttachment. The OCID of the compartment.

Returns:The compartment_id of this VolumeAttachment.
Return type:str
display_name

Gets the display_name of this VolumeAttachment. A user-friendly name. Does not have to be unique, and it cannot be changed. Avoid entering confidential information.

Example: My volume attachment

Returns:The display_name of this VolumeAttachment.
Return type:str
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

id

Gets the id of this VolumeAttachment. The OCID of the volume attachment.

Returns:The id of this VolumeAttachment.
Return type:str
instance_id

Gets the instance_id of this VolumeAttachment. The OCID of the instance the volume is attached to.

Returns:The instance_id of this VolumeAttachment.
Return type:str
lifecycle_state

Gets the lifecycle_state of this VolumeAttachment. The current state of the volume attachment.

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'.

Returns:The lifecycle_state of this VolumeAttachment.
Return type:str
time_created

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

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

Returns:The time_created of this VolumeAttachment.
Return type:datetime
volume_id

Gets the volume_id of this VolumeAttachment. The OCID of the volume.

Returns:The volume_id of this VolumeAttachment.
Return type:str
class oci.core.models.VolumeBackup
compartment_id

Gets the compartment_id of this VolumeBackup. The OCID of the compartment that contains the volume backup.

Returns:The compartment_id of this VolumeBackup.
Return type:str
display_name

Gets the display_name of this VolumeBackup. A user-friendly name for the volume backup. Does not have to be unique and it's changeable. Avoid entering confidential information.

Returns:The display_name of this VolumeBackup.
Return type:str
id

Gets the id of this VolumeBackup. The OCID of the volume backup.

Returns:The id of this VolumeBackup.
Return type:str
lifecycle_state

Gets the lifecycle_state of this VolumeBackup. The current state of a volume backup.

Allowed values for this property are: "CREATING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAULTY", "REQUEST_RECEIVED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this VolumeBackup.
Return type:str
size_in_mbs

Gets the size_in_mbs of this VolumeBackup. The size of the volume, in MBs. The value must be a multiple of 1024.

Returns:The size_in_mbs of this VolumeBackup.
Return type:int
time_created

Gets the time_created of this VolumeBackup. The date and time the volume backup was created. This is the time the actual point-in-time image of the volume data was taken. Format defined by RFC3339.

Returns:The time_created of this VolumeBackup.
Return type:datetime
time_request_received

Gets the time_request_received of this VolumeBackup. The date and time the request to create the volume backup was received. Format defined by RFC3339.

Returns:The time_request_received of this VolumeBackup.
Return type:datetime
unique_size_in_mbs

Gets the unique_size_in_mbs of this VolumeBackup. The size used by the backup, in MBs. It is typically smaller than sizeInMBs, depending on the space consumed on the volume and whether the backup is full or incremental.

Returns:The unique_size_in_mbs of this VolumeBackup.
Return type:int
volume_id

Gets the volume_id of this VolumeBackup. The OCID of the volume.

Returns:The volume_id of this VolumeBackup.
Return type:str

Identity

Client

class oci.identity.identity_client.IdentityClient(config)
add_user_to_group(add_user_to_group_details, **kwargs)

AddUserToGroup Adds the specified user to the specified group and returns a UserGroupMembership object with its own OCID.

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

Parameters:
  • add_user_to_group_details (AddUserToGroupDetails) -- (required) Request object for adding a user to a group.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type UserGroupMembership

Return type:

Response

create_compartment(create_compartment_details, **kwargs)

CreateCompartment Creates a new compartment in your tenancy.

Important: Compartments cannot be renamed or deleted.

You must specify your tenancy's OCID as the compartment ID in the request object. Remember that the tenancy is simply the root compartment. For information about OCIDs, see Resource Identifiers.

You must also specify a name for the compartment, which must be unique across all compartments in your tenancy and cannot be changed. You can use this name or the OCID when writing policies that apply to the compartment. For more information about policies, see How Policies Work.

You must also specify a description for the compartment (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_compartment().

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

Parameters:
  • create_compartment_details (CreateCompartmentDetails) -- (required) Request object for creating a new compartment.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Compartment

Return type:

Response

create_customer_secret_key(create_customer_secret_key_details, user_id, **kwargs)

CreateCustomerSecretKey Creates a new secret key for the specified user. Secret keys are used for authentication with the Object Storage Service's Amazon S3 compatible API. For information, see Managing User Credentials.

You must specify a description for the secret key (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_customer_secret_key().

Every user has permission to create a secret key for their own user ID. An administrator in your organization does not need to write a policy to give users this ability. To compare, administrators who have permission to the tenancy can use this operation to create a secret key for any user, including themselves.

Parameters:
  • create_customer_secret_key_details (CreateCustomerSecretKeyDetails) -- (required) Request object for creating a new secret key.
  • user_id (str) -- (required) The OCID of the user.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type CustomerSecretKey

Return type:

Response

create_group(create_group_details, **kwargs)

CreateGroup Creates a new group in your tenancy.

You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies) reside within the tenancy itself, unlike cloud resources such as compute instances, which typically reside within compartments inside the tenancy. For information about OCIDs, see Resource Identifiers.

You must also specify a name for the group, which must be unique across all groups in your tenancy and cannot be changed. You can use this name or the OCID when writing policies that apply to the group. For more information about policies, see How Policies Work.

You must also specify a description for the group (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_group().

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

After creating the group, you need to put users in it and write policies for it. See add_user_to_group() and create_policy().

Parameters:
  • create_group_details (CreateGroupDetails) -- (required) Request object for creating a new group.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Group

Return type:

Response

create_identity_provider(create_identity_provider_details, **kwargs)

CreateIdentityProvider Creates a new identity provider in your tenancy. For more information, see Identity Providers and Federation.

You must specify your tenancy's OCID as the compartment ID in the request object. Remember that the tenancy is simply the root compartment. For information about OCIDs, see Resource Identifiers.

You must also specify a name for the IdentityProvider, which must be unique across all IdentityProvider objects in your tenancy and cannot be changed.

You must also specify a description for the IdentityProvider (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_identity_provider().

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

Parameters:
  • create_identity_provider_details (CreateIdentityProviderDetails) -- (required) Request object for creating a new SAML2 identity provider.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type IdentityProvider

Return type:

Response

create_idp_group_mapping(create_idp_group_mapping_details, identity_provider_id, **kwargs)

CreateIdpGroupMapping Creates a single mapping between an IdP group and an IAM Service Group.

Parameters:
  • create_idp_group_mapping_details (CreateIdpGroupMappingDetails) -- (required) Add a mapping from an SAML2.0 identity provider group to a BMC group.
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type IdpGroupMapping

Return type:

Response

create_or_reset_ui_password(user_id, **kwargs)

CreateOrResetUIPassword Creates a new Console one-time password for the specified user. For more information about user credentials, see User Credentials.

Use this operation after creating a new user, or if a user forgets their password. The new one-time password is returned to you in the response, and you must securely deliver it to the user. They'll be prompted to change this password the next time they sign in to the Console. If they don't change it within 7 days, the password will expire and you'll need to create a new one-time password for the user.

Note: The user's Console login is the unique name you specified when you created the user (see create_user()).

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type UIPassword

Return type:

Response

create_policy(create_policy_details, **kwargs)

CreatePolicy Creates a new policy in the specified compartment (either the tenancy or another of your compartments). If you're new to policies, see Getting Started with Policies.

You must specify a name for the policy, which must be unique across all policies in your tenancy and cannot be changed.

You must also specify a description for the policy (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_policy().

You must specify one or more policy statements in the statements array. For information about writing policies, see How Policies Work and Common Policies.

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

New policies take effect typically within 10 seconds.

Parameters:
  • create_policy_details (CreatePolicyDetails) -- (required) Request object for creating a new policy.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type Policy

Return type:

Response

create_region_subscription(create_region_subscription_details, tenancy_id, **kwargs)

CreateRegionSubscription Creates a subscription to a region for a tenancy.

Parameters:
  • create_region_subscription_details (CreateRegionSubscriptionDetails) -- (required) Request object for activate a new region.
  • tenancy_id (str) -- (required) The OCID of the tenancy.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type RegionSubscription

Return type:

Response

create_swift_password(create_swift_password_details, user_id, **kwargs)

CreateSwiftPassword Creates a new Swift password for the specified user. For information about what Swift passwords are for, see Managing User Credentials.

You must specify a description for the Swift password (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_swift_password().

Every user has permission to create a Swift password for their own user ID. An administrator in your organization does not need to write a policy to give users this ability. To compare, administrators who have permission to the tenancy can use this operation to create a Swift password for any user, including themselves.

Parameters:
  • create_swift_password_details (CreateSwiftPasswordDetails) -- (required) Request object for creating a new swift password.
  • user_id (str) -- (required) The OCID of the user.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type SwiftPassword

Return type:

Response

create_user(create_user_details, **kwargs)

CreateUser Creates a new user in your tenancy. For conceptual information about users, your tenancy, and other IAM Service components, see Overview of the IAM Service.

You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies) reside within the tenancy itself, unlike cloud resources such as compute instances, which typically reside within compartments inside the tenancy. For information about OCIDs, see Resource Identifiers.

You must also specify a name for the user, which must be unique across all users in your tenancy and cannot be changed. Allowed characters: No spaces. Only letters, numerals, hyphens, periods, underscores, +, and @. If you specify a name that's already in use, you'll get a 409 error. This name will be the user's login to the Console. You might want to pick a name that your company's own identity system (e.g., Active Directory, LDAP, etc.) already uses. If you delete a user and then create a new user with the same name, they'll be considered different users because they have different OCIDs.

You must also specify a description for the user (although it can be an empty string). It does not have to be unique, and you can change it anytime with update_user(). You can use the field to provide the user's full name, a description, a nickname, or other information to generally identify the user.

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

A new user has no permissions until you place the user in one or more groups (see add_user_to_group()). If the user needs to access the Console, you need to provide the user a password (see create_or_reset_ui_password()). If the user needs to access the Oracle Bare Metal Cloud Services REST API, you need to upload a public API signing key for that user (see Required Keys and OCIDs and also upload_api_key()).

Important: Make sure to inform the new user which compartment(s) they have access to.

Parameters:
  • create_user_details (CreateUserDetails) -- (required) Request object for creating a new user.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type User

Return type:

Response

delete_api_key(user_id, fingerprint, **kwargs)

DeleteApiKey Deletes the specified API signing key for the specified user.

Every user has permission to use this operation to delete a key for their own user ID. An administrator in your organization does not need to write a policy to give users this ability. To compare, administrators who have permission to the tenancy can use this operation to delete a key for any user, including themselves.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • fingerprint (str) -- (required) The key's fingerprint.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_customer_secret_key(user_id, customer_secret_key_id, **kwargs)

DeleteCustomerSecretKey Deletes the specified secret key for the specified user.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • customer_secret_key_id (str) -- (required) The OCID of the secret key.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_group(group_id, **kwargs)

DeleteGroup Deletes the specified group. The group must be empty.

Parameters:
  • group_id (str) -- (required) The OCID of the group.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_identity_provider(identity_provider_id, **kwargs)

DeleteIdentityProvider Deletes the specified identity provider. The identity provider must not have any group mappings (see IdpGroupMapping).

Parameters:
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_idp_group_mapping(identity_provider_id, mapping_id, **kwargs)

DeleteIdpGroupMapping Deletes the specified group mapping.

Parameters:
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • mapping_id (str) -- (required) The OCID of the group mapping.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_policy(policy_id, **kwargs)

DeletePolicy Deletes the specified policy. The deletion takes effect typically within 10 seconds.

Parameters:
  • policy_id (str) -- (required) The OCID of the policy.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_swift_password(user_id, swift_password_id, **kwargs)

DeleteSwiftPassword Deletes the specified Swift password for the specified user.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • swift_password_id (str) -- (required) The OCID of the Swift password.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

delete_user(user_id, **kwargs)

DeleteUser Deletes the specified user. The user must not be in any groups.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

get_compartment(compartment_id, **kwargs)

GetCompartment Gets the specified compartment's information.

This operation does not return a list of all the resources inside the compartment. There is no single API operation that does that. Compartments can contain multiple types of resources (instances, block storage volumes, etc.). To find out what's in a compartment, you must call the "List" operation for each resource type and specify the compartment's OCID as a query parameter in the request. For example, call the list_instances() operation in the Cloud Compute Service or the list_volumes() operation in Cloud Block Storage.

Parameters:compartment_id (str) -- (required) The OCID of the compartment.
Returns:A Response object with data of type Compartment
Return type:Response
get_group(group_id, **kwargs)

GetGroup Gets the specified group's information.

This operation does not return a list of all the users in the group. To do that, use list_user_group_memberships() and provide the group's OCID as a query parameter in the request.

Parameters:group_id (str) -- (required) The OCID of the group.
Returns:A Response object with data of type Group
Return type:Response
get_identity_provider(identity_provider_id, **kwargs)

GetIdentityProvider Gets the specified identity provider's information.

Parameters:identity_provider_id (str) -- (required) The OCID of the identity provider.
Returns:A Response object with data of type IdentityProvider
Return type:Response
get_idp_group_mapping(identity_provider_id, mapping_id, **kwargs)

GetIdpGroupMapping Gets the specified group mapping.

Parameters:
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • mapping_id (str) -- (required) The OCID of the group mapping.
Returns:

A Response object with data of type IdpGroupMapping

Return type:

Response

get_policy(policy_id, **kwargs)

GetPolicy Gets the specified policy's information.

Parameters:policy_id (str) -- (required) The OCID of the policy.
Returns:A Response object with data of type Policy
Return type:Response
get_tenancy(tenancy_id, **kwargs)

GetTenancy Get the specified tenancy's information.

Parameters:tenancy_id (str) -- (required) The OCID of the tenancy.
Returns:A Response object with data of type Tenancy
Return type:Response
get_user(user_id, **kwargs)

GetUser Gets the specified user's information.

Parameters:user_id (str) -- (required) The OCID of the user.
Returns:A Response object with data of type User
Return type:Response
get_user_group_membership(user_group_membership_id, **kwargs)

GetUserGroupMembership Gets the specified UserGroupMembership's information.

Parameters:user_group_membership_id (str) -- (required) The OCID of the userGroupMembership.
Returns:A Response object with data of type UserGroupMembership
Return type:Response
list_api_keys(user_id, **kwargs)

ListApiKeys Lists the API signing keys for the specified user. A user can have a maximum of three keys.

Every user has permission to use this API call for their own user ID. An administrator in your organization does not need to write a policy to give users this ability.

Parameters:user_id (str) -- (required) The OCID of the user.
Returns:A Response object with data of type list of ApiKey
Return type:Response
list_availability_domains(compartment_id, **kwargs)

ListAvailabilityDomains Lists the Availability Domains in your tenancy. Specify the OCID of either the tenancy or another of your compartments as the value for the compartment ID (remember that the tenancy is simply the root compartment). See Where to Get the Tenancy's OCID and User's OCID.

Parameters:compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
Returns:A Response object with data of type list of AvailabilityDomain
Return type:Response
list_compartments(compartment_id, **kwargs)

ListCompartments Lists the compartments in your tenancy. You must specify your tenancy's OCID as the value for the compartment ID (remember that the tenancy is simply the root compartment). See Where to Get the Tenancy's OCID and User's OCID.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of Compartment

Return type:

Response

list_customer_secret_keys(user_id, **kwargs)

ListCustomerSecretKeys Lists the secret keys for the specified user. The returned object contains the secret key's OCID, but not the secret key itself. The actual secret key is returned only upon creation.

Parameters:user_id (str) -- (required) The OCID of the user.
Returns:A Response object with data of type list of CustomerSecretKeySummary
Return type:Response
list_groups(compartment_id, **kwargs)

ListGroups Lists the groups in your tenancy. You must specify your tenancy's OCID as the value for the compartment ID (remember that the tenancy is simply the root compartment). See Where to Get the Tenancy's OCID and User's OCID.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of Group

Return type:

Response

list_identity_providers(protocol, compartment_id, **kwargs)

ListIdentityProviders Lists all the identity providers in your tenancy. You must specify the identity provider type (e.g., SAML2 for identity providers using the SAML2.0 protocol). You must specify your tenancy's OCID as the value for the compartment ID (remember that the tenancy is simply the root compartment). See Where to Get the Tenancy's OCID and User's OCID.

Parameters:
  • protocol (str) -- (required) The protocol used for federation.
  • compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of IdentityProvider

Return type:

Response

list_idp_group_mappings(identity_provider_id, **kwargs)

ListIdpGroupMappings Lists the group mappings for the specified identity provider.

Parameters:
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of IdpGroupMapping

Return type:

Response

list_policies(compartment_id, **kwargs)

ListPolicies Lists the policies in the specified compartment (either the tenancy or another of your compartments). See Where to Get the Tenancy's OCID and User's OCID.

To determine which policies apply to a particular group or compartment, you must view the individual statements inside all your policies. There isn't a way to automatically obtain that information via the API.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of Policy

Return type:

Response

list_region_subscriptions(tenancy_id, **kwargs)

ListRegionSubscriptions Lists the region subscriptions for the specified tenancy.

Parameters:tenancy_id (str) -- (required) The OCID of the tenancy.
Returns:A Response object with data of type list of RegionSubscription
Return type:Response
list_regions(**kwargs)

ListRegions Lists all the regions offered by Oracle Bare Metal Cloud Services.

Returns:A Response object with data of type list of Region
Return type:Response
list_swift_passwords(user_id, **kwargs)

ListSwiftPasswords Lists the Swift passwords for the specified user. The returned object contains the password's OCID, but not the password itself. The actual password is returned only upon creation.

Parameters:user_id (str) -- (required) The OCID of the user.
Returns:A Response object with data of type list of SwiftPassword
Return type:Response
list_user_group_memberships(compartment_id, **kwargs)

ListUserGroupMemberships Lists the UserGroupMembership objects in your tenancy. You must specify your tenancy's OCID as the value for the compartment ID (see Where to Get the Tenancy's OCID and User's OCID). You must also then filter the list in one of these ways:

  • You can limit the results to just the memberships for a given user by specifying a userId.
  • Similarly, you can limit the results to just the memberships for a given group by specifying a groupId.
  • You can set both the userId and groupId to determine if the specified user is in the specified group.

If the answer is no, the response is an empty list.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
  • user_id (str) -- (optional) The OCID of the user.
  • group_id (str) -- (optional) The OCID of the group.
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of UserGroupMembership

Return type:

Response

list_users(compartment_id, **kwargs)

ListUsers Lists the users in your tenancy. You must specify your tenancy's OCID as the value for the compartment ID (remember that the tenancy is simply the root compartment). See Where to Get the Tenancy's OCID and User's OCID.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment (remember that the tenancy is simply the root compartment).
  • page (str) -- (optional) The value of the opc-next-page response header from the previous "List" call.
  • limit (int) -- (optional) The maximum number of items to return in a paginated "List" call.
Returns:

A Response object with data of type list of User

Return type:

Response

remove_user_from_group(user_group_membership_id, **kwargs)

RemoveUserFromGroup Removes a user from a group by deleting the corresponding UserGroupMembership.

Parameters:
  • user_group_membership_id (str) -- (required) The OCID of the userGroupMembership.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type None

Return type:

Response

update_compartment(compartment_id, update_compartment_details, **kwargs)

UpdateCompartment Updates the specified compartment's description.

Parameters:
  • compartment_id (str) -- (required) The OCID of the compartment.
  • update_compartment_details (UpdateCompartmentDetails) -- (required) Request object for updating a compartment.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Compartment

Return type:

Response

update_customer_secret_key(user_id, customer_secret_key_id, update_customer_secret_key_details, **kwargs)

UpdateCustomerSecretKey Updates the specified secret key's description.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • customer_secret_key_id (str) -- (required) The OCID of the secret key.
  • update_customer_secret_key_details (UpdateCustomerSecretKeyDetails) -- (required) Request object for updating a secret key.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type CustomerSecretKeySummary

Return type:

Response

update_group(group_id, update_group_details, **kwargs)

UpdateGroup Updates the specified group.

Parameters:
  • group_id (str) -- (required) The OCID of the group.
  • update_group_details (UpdateGroupDetails) -- (required) Request object for updating a group.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Group

Return type:

Response

update_identity_provider(identity_provider_id, update_identity_provider_details, **kwargs)

UpdateIdentityProvider Updates the specified identity provider.

Parameters:
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • update_identity_provider_details (UpdateIdentityProviderDetails) -- (required) Request object for updating a identity provider.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type IdentityProvider

Return type:

Response

update_idp_group_mapping(identity_provider_id, mapping_id, update_idp_group_mapping_details, **kwargs)

UpdateIdpGroupMapping Updates the specified group mapping.

Parameters:
  • identity_provider_id (str) -- (required) The OCID of the identity provider.
  • mapping_id (str) -- (required) The OCID of the group mapping.
  • update_idp_group_mapping_details (UpdateIdpGroupMappingDetails) -- (required) Request object for updating an identity provider group mapping
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type IdpGroupMapping

Return type:

Response

update_policy(policy_id, update_policy_details, **kwargs)

UpdatePolicy Updates the specified policy. You can update the description or the policy statements themselves.

Policy changes take effect typically within 10 seconds.

Parameters:
  • policy_id (str) -- (required) The OCID of the policy.
  • update_policy_details (UpdatePolicyDetails) -- (required) Request object for updating a policy.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type Policy

Return type:

Response

update_swift_password(user_id, swift_password_id, update_swift_password_details, **kwargs)

UpdateSwiftPassword Updates the specified Swift password's description.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • swift_password_id (str) -- (required) The OCID of the Swift password.
  • update_swift_password_details (UpdateSwiftPasswordDetails) -- (required) Request object for updating a Swift password.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type SwiftPassword

Return type:

Response

update_user(user_id, update_user_details, **kwargs)

UpdateUser Updates the description of the specified user.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • update_user_details (UpdateUserDetails) -- (required) Request object for updating a user.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type User

Return type:

Response

update_user_state(user_id, update_state_details, **kwargs)

UpdateUserState Updates the state of the specified user.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • update_state_details (UpdateStateDetails) -- (required) Request object for updating a user state.
  • if_match (str) -- (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
Returns:

A Response object with data of type User

Return type:

Response

upload_api_key(user_id, create_api_key_details, **kwargs)

UploadApiKey Uploads an API signing key for the specified user.

Every user has permission to use this operation to upload a key for their own user ID. An administrator in your organization does not need to write a policy to give users this ability. To compare, administrators who have permission to the tenancy can use this operation to upload a key for any user, including themselves.

Important: Even though you have permission to upload an API key, you might not yet have permission to do much else. If you try calling an operation unrelated to your own credential management (e.g., ListUsers, LaunchInstance) and receive an "unauthorized" error, check with an administrator to confirm which IAM Service group(s) you're in and what access you have. Also confirm you're working in the correct compartment.

After you send your request, the new object's lifecycleState will temporarily be CREATING. Before using the object, first make sure its lifecycleState has changed to ACTIVE.

Parameters:
  • user_id (str) -- (required) The OCID of the user.
  • create_api_key_details (CreateApiKeyDetails) -- (required) Request object for uploading an API key for a user.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type ApiKey

Return type:

Response

Models

class oci.identity.models.AddUserToGroupDetails
group_id

Gets the group_id of this AddUserToGroupDetails. The OCID of the group.

Returns:The group_id of this AddUserToGroupDetails.
Return type:str
user_id

Gets the user_id of this AddUserToGroupDetails. The OCID of the user.

Returns:The user_id of this AddUserToGroupDetails.
Return type:str
class oci.identity.models.ApiKey
fingerprint

Gets the fingerprint of this ApiKey. The key's fingerprint (e.g., 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef).

Returns:The fingerprint of this ApiKey.
Return type:str
inactive_status

Gets the inactive_status of this ApiKey. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this ApiKey.
Return type:int
key_id

Gets the key_id of this ApiKey. An Oracle-assigned identifier for the key, in this format: TENANCY_OCID/USER_OCID/KEY_FINGERPRINT.

Returns:The key_id of this ApiKey.
Return type:str
key_value

Gets the key_value of this ApiKey. The key's value.

Returns:The key_value of this ApiKey.
Return type:str
lifecycle_state

Gets the lifecycle_state of this ApiKey. The API key's current state. After creating an ApiKey object, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this ApiKey.
Return type:str
time_created

Gets the time_created of this ApiKey. Date and time the ApiKey object was created, in the format defined by RFC3339.

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

Returns:The time_created of this ApiKey.
Return type:datetime
user_id

Gets the user_id of this ApiKey. The OCID of the user the key belongs to.

Returns:The user_id of this ApiKey.
Return type:str
class oci.identity.models.AvailabilityDomain
compartment_id

Gets the compartment_id of this AvailabilityDomain. The OCID of the tenancy.

Returns:The compartment_id of this AvailabilityDomain.
Return type:str
name

Gets the name of this AvailabilityDomain. The name of the Availability Domain.

Returns:The name of this AvailabilityDomain.
Return type:str
class oci.identity.models.Compartment
compartment_id

Gets the compartment_id of this Compartment. The OCID of the tenancy containing the compartment.

Returns:The compartment_id of this Compartment.
Return type:str
description

Gets the description of this Compartment. The description you assign to the compartment. Does not have to be unique, and it's changeable.

Returns:The description of this Compartment.
Return type:str
id

Gets the id of this Compartment. The OCID of the compartment.

Returns:The id of this Compartment.
Return type:str
inactive_status

Gets the inactive_status of this Compartment. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this Compartment.
Return type:int
lifecycle_state

Gets the lifecycle_state of this Compartment. The compartment's current state. After creating a compartment, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this Compartment.
Return type:str
name

Gets the name of this Compartment. The name you assign to the compartment during creation. The name must be unique across all compartments in the tenancy and cannot be changed.

Returns:The name of this Compartment.
Return type:str
time_created

Gets the time_created of this Compartment. Date and time the compartment was created, in the format defined by RFC3339.

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

Returns:The time_created of this Compartment.
Return type:datetime
class oci.identity.models.CreateApiKeyDetails
key

Gets the key of this CreateApiKeyDetails. The public key. Must be an RSA key in PEM format.

Returns:The key of this CreateApiKeyDetails.
Return type:str
class oci.identity.models.CreateCompartmentDetails
compartment_id

Gets the compartment_id of this CreateCompartmentDetails. The OCID of the tenancy containing the compartment.

Returns:The compartment_id of this CreateCompartmentDetails.
Return type:str
description

Gets the description of this CreateCompartmentDetails. The description you assign to the compartment during creation. Does not have to be unique, and it's changeable.

Returns:The description of this CreateCompartmentDetails.
Return type:str
name

Gets the name of this CreateCompartmentDetails. The name you assign to the compartment during creation. The name must be unique across all compartments in the tenancy.

Returns:The name of this CreateCompartmentDetails.
Return type:str
class oci.identity.models.CreateCustomerSecretKeyDetails
display_name

Gets the display_name of this CreateCustomerSecretKeyDetails. The name you assign to the secret key during creation. Does not have to be unique, and it's changeable.

Returns:The display_name of this CreateCustomerSecretKeyDetails.
Return type:str
class oci.identity.models.CreateGroupDetails
compartment_id

Gets the compartment_id of this CreateGroupDetails. The OCID of the tenancy containing the group.

Returns:The compartment_id of this CreateGroupDetails.
Return type:str
description

Gets the description of this CreateGroupDetails. The description you assign to the group during creation. Does not have to be unique, and it's changeable.

Returns:The description of this CreateGroupDetails.
Return type:str
name

Gets the name of this CreateGroupDetails. The name you assign to the group during creation. The name must be unique across all groups in the tenancy and cannot be changed.

Returns:The name of this CreateGroupDetails.
Return type:str
class oci.identity.models.CreateIdentityProviderDetails
compartment_id

Gets the compartment_id of this CreateIdentityProviderDetails. The OCID of your tenancy.

Returns:The compartment_id of this CreateIdentityProviderDetails.
Return type:str
description

Gets the description of this CreateIdentityProviderDetails. The description you assign to the IdentityProvider during creation. Does not have to be unique, and it's changeable.

Returns:The description of this CreateIdentityProviderDetails.
Return type:str
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

name

Gets the name of this CreateIdentityProviderDetails. The name you assign to the IdentityProvider during creation. The name must be unique across all IdentityProvider objects in the tenancy and cannot be changed.

Returns:The name of this CreateIdentityProviderDetails.
Return type:str
product_type

Gets the product_type of this CreateIdentityProviderDetails. The identity provider service or product. Supported identity providers are Oracle Identity Cloud Service (IDCS) and Microsoft Active Directory Federation Services (ADFS).

Example: IDCS

Allowed values for this property are: "IDCS", "ADFS"

Returns:The product_type of this CreateIdentityProviderDetails.
Return type:str
protocol

Gets the protocol of this CreateIdentityProviderDetails. The protocol used for federation.

Example: SAML2

Allowed values for this property are: "SAML2"

Returns:The protocol of this CreateIdentityProviderDetails.
Return type:str
class oci.identity.models.CreateIdpGroupMappingDetails
group_id

Gets the group_id of this CreateIdpGroupMappingDetails. The OCID of the IAM Service Group you want to map to the IdP group.

Returns:The group_id of this CreateIdpGroupMappingDetails.
Return type:str
idp_group_name

Gets the idp_group_name of this CreateIdpGroupMappingDetails. The name of the IdP group you want to map.

Returns:The idp_group_name of this CreateIdpGroupMappingDetails.
Return type:str
class oci.identity.models.CreatePolicyDetails
compartment_id

Gets the compartment_id of this CreatePolicyDetails. The OCID of the compartment containing the policy (either the tenancy or another compartment).

Returns:The compartment_id of this CreatePolicyDetails.
Return type:str
description

Gets the description of this CreatePolicyDetails. The description you assign to the policy during creation. Does not have to be unique, and it's changeable.

Returns:The description of this CreatePolicyDetails.
Return type:str
name

Gets the name of this CreatePolicyDetails. The name you assign to the policy during creation. The name must be unique across all policies in the tenancy and cannot be changed.

Returns:The name of this CreatePolicyDetails.
Return type:str
statements

Gets the statements of this CreatePolicyDetails. An array of policy statements written in the policy language. See How Policies Work and Common Policies.

Returns:The statements of this CreatePolicyDetails.
Return type:list[str]
version_date

Gets the version_date of this CreatePolicyDetails. The version of the policy. If null or set to an empty string, when a request comes in for authorization, the policy will be evaluated according to the current behavior of the services at that moment. If set to a particular date (YYYY-MM-DD), the policy will be evaluated according to the behavior of the services on that date.

Returns:The version_date of this CreatePolicyDetails.
Return type:datetime
class oci.identity.models.CreateRegionSubscriptionDetails
region_key

Gets the region_key of this CreateRegionSubscriptionDetails. The regions's key.

Allowed values are: - PHX - IAD - FRA

Example: PHX

Returns:The region_key of this CreateRegionSubscriptionDetails.
Return type:str
class oci.identity.models.CreateSaml2IdentityProviderDetails
metadata

Gets the metadata of this CreateSaml2IdentityProviderDetails. The XML that contains the information required for federating.

Returns:The metadata of this CreateSaml2IdentityProviderDetails.
Return type:str
metadata_url

Gets the metadata_url of this CreateSaml2IdentityProviderDetails. The URL for retrieving the identity provider's metadata, which contains information required for federating.

Returns:The metadata_url of this CreateSaml2IdentityProviderDetails.
Return type:str
class oci.identity.models.CreateSwiftPasswordDetails
description

Gets the description of this CreateSwiftPasswordDetails. The description you assign to the Swift password during creation. Does not have to be unique, and it's changeable.

Returns:The description of this CreateSwiftPasswordDetails.
Return type:str
class oci.identity.models.CreateUserDetails
compartment_id

Gets the compartment_id of this CreateUserDetails. The OCID of the tenancy containing the user.

Returns:The compartment_id of this CreateUserDetails.
Return type:str
description

Gets the description of this CreateUserDetails. The description you assign to the user during creation. Does not have to be unique, and it's changeable.

Returns:The description of this CreateUserDetails.
Return type:str
name

Gets the name of this CreateUserDetails. The name you assign to the user during creation. This is the user's login for the Console. The name must be unique across all users in the tenancy and cannot be changed.

Returns:The name of this CreateUserDetails.
Return type:str
class oci.identity.models.CustomerSecretKey
display_name

Gets the display_name of this CustomerSecretKey. The display name you assign to the secret key. Does not have to be unique, and it's changeable.

Returns:The display_name of this CustomerSecretKey.
Return type:str
id

Gets the id of this CustomerSecretKey. The OCID of the secret key.

Returns:The id of this CustomerSecretKey.
Return type:str
inactive_status

Gets the inactive_status of this CustomerSecretKey. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this CustomerSecretKey.
Return type:int
key

Gets the key of this CustomerSecretKey. The secret key.

Returns:The key of this CustomerSecretKey.
Return type:str
lifecycle_state

Gets the lifecycle_state of this CustomerSecretKey. The secret key's current state. After creating a secret key, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this CustomerSecretKey.
Return type:str
time_created

Gets the time_created of this CustomerSecretKey. Date and time the CustomerSecretKey object was created, in the format defined by RFC3339.

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

Returns:The time_created of this CustomerSecretKey.
Return type:datetime
time_expires

Gets the time_expires of this CustomerSecretKey. Date and time when this password will expire, in the format defined by RFC3339. Null if it never expires.

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

Returns:The time_expires of this CustomerSecretKey.
Return type:datetime
user_id

Gets the user_id of this CustomerSecretKey. The OCID of the user the password belongs to.

Returns:The user_id of this CustomerSecretKey.
Return type:str
class oci.identity.models.CustomerSecretKeySummary
display_name

Gets the display_name of this CustomerSecretKeySummary. The displayName you assign to the secret key. Does not have to be unique, and it's changeable.

Returns:The display_name of this CustomerSecretKeySummary.
Return type:str
id

Gets the id of this CustomerSecretKeySummary. The OCID of the secret key.

Returns:The id of this CustomerSecretKeySummary.
Return type:str
inactive_status

Gets the inactive_status of this CustomerSecretKeySummary. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this CustomerSecretKeySummary.
Return type:int
lifecycle_state

Gets the lifecycle_state of this CustomerSecretKeySummary. The secret key's current state. After creating a secret key, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this CustomerSecretKeySummary.
Return type:str
time_created

Gets the time_created of this CustomerSecretKeySummary. Date and time the CustomerSecretKey object was created, in the format defined by RFC3339.

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

Returns:The time_created of this CustomerSecretKeySummary.
Return type:datetime
time_expires

Gets the time_expires of this CustomerSecretKeySummary. Date and time when this password will expire, in the format defined by RFC3339. Null if it never expires.

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

Returns:The time_expires of this CustomerSecretKeySummary.
Return type:datetime
user_id

Gets the user_id of this CustomerSecretKeySummary. The OCID of the user the password belongs to.

Returns:The user_id of this CustomerSecretKeySummary.
Return type:str
class oci.identity.models.Group
compartment_id

Gets the compartment_id of this Group. The OCID of the tenancy containing the group.

Returns:The compartment_id of this Group.
Return type:str
description

Gets the description of this Group. The description you assign to the group. Does not have to be unique, and it's changeable.

Returns:The description of this Group.
Return type:str
id

Gets the id of this Group. The OCID of the group.

Returns:The id of this Group.
Return type:str
inactive_status

Gets the inactive_status of this Group. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this Group.
Return type:int
lifecycle_state

Gets the lifecycle_state of this Group. The group's current state. After creating a group, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this Group.
Return type:str
name

Gets the name of this Group. The name you assign to the group during creation. The name must be unique across all groups in the tenancy and cannot be changed.

Returns:The name of this Group.
Return type:str
time_created

Gets the time_created of this Group. Date and time the group was created, in the format defined by RFC3339.

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

Returns:The time_created of this Group.
Return type:datetime
class oci.identity.models.IdentityProvider
compartment_id

Gets the compartment_id of this IdentityProvider. The OCID of the tenancy containing the IdentityProvider.

Returns:The compartment_id of this IdentityProvider.
Return type:str
description

Gets the description of this IdentityProvider. The description you assign to the IdentityProvider during creation. Does not have to be unique, and it's changeable.

Returns:The description of this IdentityProvider.
Return type:str
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

id

Gets the id of this IdentityProvider. The OCID of the IdentityProvider.

Returns:The id of this IdentityProvider.
Return type:str
inactive_status

Gets the inactive_status of this IdentityProvider. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this IdentityProvider.
Return type:int
lifecycle_state

Gets the lifecycle_state of this IdentityProvider. The current state. After creating an IdentityProvider, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this IdentityProvider.
Return type:str
name

Gets the name of this IdentityProvider. The name you assign to the IdentityProvider during creation. The name must be unique across all IdentityProvider objects in the tenancy and cannot be changed. This is the name federated users see when choosing which identity provider to use when signing in to the Oracle Bare Metal Cloud Services Console.

Returns:The name of this IdentityProvider.
Return type:str
product_type

Gets the product_type of this IdentityProvider. The identity provider service or product. Supported identity providers are Oracle Identity Cloud Service (IDCS) and Microsoft Active Directory Federation Services (ADFS).

Allowed values are: - ADFS - IDCS

Example: IDCS

Returns:The product_type of this IdentityProvider.
Return type:str
protocol

Gets the protocol of this IdentityProvider. The protocol used for federation. Allowed value: SAML2.

Example: SAML2

Returns:The protocol of this IdentityProvider.
Return type:str
time_created

Gets the time_created of this IdentityProvider. Date and time the IdentityProvider was created, in the format defined by RFC3339.

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

Returns:The time_created of this IdentityProvider.
Return type:datetime
class oci.identity.models.IdpGroupMapping
compartment_id

Gets the compartment_id of this IdpGroupMapping. The OCID of the tenancy containing the IdentityProvider.

Returns:The compartment_id of this IdpGroupMapping.
Return type:str
group_id

Gets the group_id of this IdpGroupMapping. The OCID of the IAM Service group that is mapped to the IdP group.

Returns:The group_id of this IdpGroupMapping.
Return type:str
id

Gets the id of this IdpGroupMapping. The OCID of the IdpGroupMapping.

Returns:The id of this IdpGroupMapping.
Return type:str
idp_group_name

Gets the idp_group_name of this IdpGroupMapping. The name of the IdP group that is mapped to the IAM Service group.

Returns:The idp_group_name of this IdpGroupMapping.
Return type:str
idp_id

Gets the idp_id of this IdpGroupMapping. The OCID of the IdentityProvider this mapping belongs to.

Returns:The idp_id of this IdpGroupMapping.
Return type:str
inactive_status

Gets the inactive_status of this IdpGroupMapping. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this IdpGroupMapping.
Return type:int
lifecycle_state

Gets the lifecycle_state of this IdpGroupMapping. The mapping's current state. After creating a mapping object, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this IdpGroupMapping.
Return type:str
time_created

Gets the time_created of this IdpGroupMapping. Date and time the mapping was created, in the format defined by RFC3339.

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

Returns:The time_created of this IdpGroupMapping.
Return type:datetime
class oci.identity.models.Policy
compartment_id

Gets the compartment_id of this Policy. The OCID of the compartment containing the policy (either the tenancy or another compartment).

Returns:The compartment_id of this Policy.
Return type:str
description

Gets the description of this Policy. The description you assign to the policy. Does not have to be unique, and it's changeable.

Returns:The description of this Policy.
Return type:str
id

Gets the id of this Policy. The OCID of the policy.

Returns:The id of this Policy.
Return type:str
inactive_status

Gets the inactive_status of this Policy. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this Policy.
Return type:int
lifecycle_state

Gets the lifecycle_state of this Policy. The policy's current state. After creating a policy, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this Policy.
Return type:str
name

Gets the name of this Policy. The name you assign to the policy during creation. The name must be unique across all policies in the tenancy and cannot be changed.

Returns:The name of this Policy.
Return type:str
statements

Gets the statements of this Policy. An array of one or more policy statements written in the policy language.

Returns:The statements of this Policy.
Return type:list[str]
time_created

Gets the time_created of this Policy. Date and time the policy was created, in the format defined by RFC3339.

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

Returns:The time_created of this Policy.
Return type:datetime
version_date

Gets the version_date of this Policy. The version of the policy. If null or set to an empty string, when a request comes in for authorization, the policy will be evaluated according to the current behavior of the services at that moment. If set to a particular date (YYYY-MM-DD), the policy will be evaluated according to the behavior of the services on that date.

Returns:The version_date of this Policy.
Return type:datetime
class oci.identity.models.Region
key

Gets the key of this Region. The key of the region.

Allowed values are: - PHX - IAD - 'FRA'

Returns:The key of this Region.
Return type:str
name

Gets the name of this Region. The name of the region.

Allowed values are: - us-phoenix-1 - us-ashburn-1 - 'de-frankfurt-1'

Returns:The name of this Region.
Return type:str
class oci.identity.models.RegionSubscription
is_home_region

Gets the is_home_region of this RegionSubscription. Indicates if the region is the home region or not.

Returns:The is_home_region of this RegionSubscription.
Return type:bool
region_key

Gets the region_key of this RegionSubscription. The region's key.

Allowed values are: - PHX - IAD - 'FRA'

Returns:The region_key of this RegionSubscription.
Return type:str
region_name

Gets the region_name of this RegionSubscription. The region's name.

Allowed values are: - us-phoenix-1 - us-ashburn-1 - 'de-frankfurt-1'

Returns:The region_name of this RegionSubscription.
Return type:str
status

Gets the status of this RegionSubscription. The region subscription status.

Allowed values for this property are: "READY", "IN_PROGRESS", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The status of this RegionSubscription.
Return type:str
class oci.identity.models.Saml2IdentityProvider
metadata_url

Gets the metadata_url of this Saml2IdentityProvider. The URL for retrieving the identity provider's metadata, which contains information required for federating.

Returns:The metadata_url of this Saml2IdentityProvider.
Return type:str
redirect_url

Gets the redirect_url of this Saml2IdentityProvider. The URL to redirect federated users to for authentication with the identity provider.

Returns:The redirect_url of this Saml2IdentityProvider.
Return type:str
signing_certificate

Gets the signing_certificate of this Saml2IdentityProvider. The identity provider's signing certificate used by the IAM Service to validate the SAML2 token.

Returns:The signing_certificate of this Saml2IdentityProvider.
Return type:str
class oci.identity.models.SwiftPassword
description

Gets the description of this SwiftPassword. The description you assign to the Swift password. Does not have to be unique, and it's changeable.

Returns:The description of this SwiftPassword.
Return type:str
expires_on

Gets the expires_on of this SwiftPassword. Date and time when this password will expire, in the format defined by RFC3339. Null if it never expires.

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

Returns:The expires_on of this SwiftPassword.
Return type:datetime
id

Gets the id of this SwiftPassword. The OCID of the Swift password.

Returns:The id of this SwiftPassword.
Return type:str
inactive_status

Gets the inactive_status of this SwiftPassword. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this SwiftPassword.
Return type:int
lifecycle_state

Gets the lifecycle_state of this SwiftPassword. The password's current state. After creating a password, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this SwiftPassword.
Return type:str
password

Gets the password of this SwiftPassword. The Swift password. The value is available only in the response for CreateSwiftPassword, and not for ListSwiftPasswords or UpdateSwiftPassword.

Returns:The password of this SwiftPassword.
Return type:str
time_created

Gets the time_created of this SwiftPassword. Date and time the SwiftPassword object was created, in the format defined by RFC3339.

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

Returns:The time_created of this SwiftPassword.
Return type:datetime
user_id

Gets the user_id of this SwiftPassword. The OCID of the user the password belongs to.

Returns:The user_id of this SwiftPassword.
Return type:str
class oci.identity.models.Tenancy
description

Gets the description of this Tenancy. The description of the tenancy.

Returns:The description of this Tenancy.
Return type:str
home_region_key

Gets the home_region_key of this Tenancy. The region key for the tenancy's home region.

Allowed values are: - IAD - PHX - FRA

Returns:The home_region_key of this Tenancy.
Return type:str
id

Gets the id of this Tenancy. The OCID of the tenancy.

Returns:The id of this Tenancy.
Return type:str
name

Gets the name of this Tenancy. The name of the tenancy.

Returns:The name of this Tenancy.
Return type:str
class oci.identity.models.UIPassword
inactive_status

Gets the inactive_status of this UIPassword. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this UIPassword.
Return type:int
lifecycle_state

Gets the lifecycle_state of this UIPassword. The password's current state. After creating a password, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this UIPassword.
Return type:str
password

Gets the password of this UIPassword. The user's password for the Console.

Returns:The password of this UIPassword.
Return type:str
time_created

Gets the time_created of this UIPassword. Date and time the password was created, in the format defined by RFC3339.

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

Returns:The time_created of this UIPassword.
Return type:datetime
user_id

Gets the user_id of this UIPassword. The OCID of the user.

Returns:The user_id of this UIPassword.
Return type:str
class oci.identity.models.UpdateCompartmentDetails
description

Gets the description of this UpdateCompartmentDetails. The description you assign to the compartment. Does not have to be unique, and it's changeable.

Returns:The description of this UpdateCompartmentDetails.
Return type:str
name

Gets the name of this UpdateCompartmentDetails. The new name you assign to the compartment. The name must be unique across all compartments in the tenancy.

Returns:The name of this UpdateCompartmentDetails.
Return type:str
class oci.identity.models.UpdateCustomerSecretKeyDetails
display_name

Gets the display_name of this UpdateCustomerSecretKeyDetails. The description you assign to the secret key. Does not have to be unique, and it's changeable.

Returns:The display_name of this UpdateCustomerSecretKeyDetails.
Return type:str
class oci.identity.models.UpdateGroupDetails
description

Gets the description of this UpdateGroupDetails. The description you assign to the group. Does not have to be unique, and it's changeable.

Returns:The description of this UpdateGroupDetails.
Return type:str
class oci.identity.models.UpdateIdentityProviderDetails
description

Gets the description of this UpdateIdentityProviderDetails. The description you assign to the IdentityProvider. Does not have to be unique, and it's changeable.

Returns:The description of this UpdateIdentityProviderDetails.
Return type:str
static get_subtype(object_dictionary)

Given the hash representation of a subtype of this class, use the info in the hash to return the class of the subtype.

protocol

Gets the protocol of this UpdateIdentityProviderDetails. The protocol used for federation.

Example: SAML2

Allowed values for this property are: "SAML2"

Returns:The protocol of this UpdateIdentityProviderDetails.
Return type:str
class oci.identity.models.UpdateIdpGroupMappingDetails
group_id

Gets the group_id of this UpdateIdpGroupMappingDetails. The OCID of the group.

Returns:The group_id of this UpdateIdpGroupMappingDetails.
Return type:str
idp_group_name

Gets the idp_group_name of this UpdateIdpGroupMappingDetails. The idp group name.

Returns:The idp_group_name of this UpdateIdpGroupMappingDetails.
Return type:str
class oci.identity.models.UpdatePolicyDetails
description

Gets the description of this UpdatePolicyDetails. The description you assign to the policy. Does not have to be unique, and it's changeable.

Returns:The description of this UpdatePolicyDetails.
Return type:str
statements

Gets the statements of this UpdatePolicyDetails. An array of policy statements written in the policy language. See How Policies Work and Common Policies.

Returns:The statements of this UpdatePolicyDetails.
Return type:list[str]
version_date

Gets the version_date of this UpdatePolicyDetails. The version of the policy. If null or set to an empty string, when a request comes in for authorization, the policy will be evaluated according to the current behavior of the services at that moment. If set to a particular date (YYYY-MM-DD), the policy will be evaluated according to the behavior of the services on that date.

Returns:The version_date of this UpdatePolicyDetails.
Return type:datetime
class oci.identity.models.UpdateSaml2IdentityProviderDetails
metadata

Gets the metadata of this UpdateSaml2IdentityProviderDetails. The XML that contains the information required for federating.

Returns:The metadata of this UpdateSaml2IdentityProviderDetails.
Return type:str
metadata_url

Gets the metadata_url of this UpdateSaml2IdentityProviderDetails. The URL for retrieving the identity provider's metadata, which contains information required for federating.

Returns:The metadata_url of this UpdateSaml2IdentityProviderDetails.
Return type:str
class oci.identity.models.UpdateStateDetails
blocked

Gets the blocked of this UpdateStateDetails. Update state to blocked or unblocked. Only "false" is supported (for changing the state to unblocked).

Returns:The blocked of this UpdateStateDetails.
Return type:bool
class oci.identity.models.UpdateSwiftPasswordDetails
description

Gets the description of this UpdateSwiftPasswordDetails. The description you assign to the Swift password. Does not have to be unique, and it's changeable.

Returns:The description of this UpdateSwiftPasswordDetails.
Return type:str
class oci.identity.models.UpdateUserDetails
description

Gets the description of this UpdateUserDetails. The description you assign to the user. Does not have to be unique, and it's changeable.

Returns:The description of this UpdateUserDetails.
Return type:str
class oci.identity.models.User
compartment_id

Gets the compartment_id of this User. The OCID of the tenancy containing the user.

Returns:The compartment_id of this User.
Return type:str
description

Gets the description of this User. The description you assign to the user. Does not have to be unique, and it's changeable.

Returns:The description of this User.
Return type:str
id

Gets the id of this User. The OCID of the user.

Returns:The id of this User.
Return type:str
inactive_status

Gets the inactive_status of this User. Returned only if the user's lifecycleState is INACTIVE. A 16-bit value showing the reason why the user is inactive:

  • bit 0: SUSPENDED (reserved for future use)
  • bit 1: DISABLED (reserved for future use)
  • bit 2: BLOCKED (the user has exceeded the maximum number of failed login attempts for the Console)
Returns:The inactive_status of this User.
Return type:int
lifecycle_state

Gets the lifecycle_state of this User. The user's current state. After creating a user, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this User.
Return type:str
name

Gets the name of this User. The name you assign to the user during creation. This is the user's login for the Console. The name must be unique across all users in the tenancy and cannot be changed.

Returns:The name of this User.
Return type:str
time_created

Gets the time_created of this User. Date and time the user was created, in the format defined by RFC3339.

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

Returns:The time_created of this User.
Return type:datetime
class oci.identity.models.UserGroupMembership
compartment_id

Gets the compartment_id of this UserGroupMembership. The OCID of the tenancy containing the user, group, and membership object.

Returns:The compartment_id of this UserGroupMembership.
Return type:str
group_id

Gets the group_id of this UserGroupMembership. The OCID of the group.

Returns:The group_id of this UserGroupMembership.
Return type:str
id

Gets the id of this UserGroupMembership. The OCID of the membership.

Returns:The id of this UserGroupMembership.
Return type:str
inactive_status

Gets the inactive_status of this UserGroupMembership. The detailed status of INACTIVE lifecycleState.

Returns:The inactive_status of this UserGroupMembership.
Return type:int
lifecycle_state

Gets the lifecycle_state of this UserGroupMembership. The membership's current state. After creating a membership object, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.

Returns:The lifecycle_state of this UserGroupMembership.
Return type:str
time_created

Gets the time_created of this UserGroupMembership. Date and time the membership was created, in the format defined by RFC3339.

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

Returns:The time_created of this UserGroupMembership.
Return type:datetime
user_id

Gets the user_id of this UserGroupMembership. The OCID of the user.

Returns:The user_id of this UserGroupMembership.
Return type:str

Load Balancer

Client

class oci.load_balancer.load_balancer_client.LoadBalancerClient(config)
create_backend(create_backend_details, load_balancer_id, backend_set_name, **kwargs)

CreateBackend Adds a backend server to a backend set.

Parameters:
  • create_backend_details (CreateBackendDetails) -- (required) The details to add a backend server to a backend set.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and servers.

  • backend_set_name (str) --

    (required) The name of the backend set to add the backend server to.

    Example: My_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type None

Return type:

Response

create_backend_set(create_backend_set_details, load_balancer_id, **kwargs)

CreateBackendSet Adds a backend set to a load balancer.

Parameters:
  • create_backend_set_details (CreateBackendSetDetails) -- (required) The details for adding a backend set.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer on which to add a backend set.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type None

Return type:

Response

create_certificate(create_certificate_details, load_balancer_id, **kwargs)

CreateCertificate Creates an asynchronous request to add an SSL certificate.

Parameters:
  • create_certificate_details (CreateCertificateDetails) -- (required) The details of the certificate to add.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer on which to add the certificate.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type None

Return type:

Response

create_listener(create_listener_details, load_balancer_id, **kwargs)

CreateListener Adds a listener to a load balancer.

Parameters:
  • create_listener_details (CreateListenerDetails) -- (required) Details to add a listener.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer on which to add a listener.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type None

Return type:

Response

create_load_balancer(create_load_balancer_details, **kwargs)

CreateLoadBalancer Creates a new load balancer in the specified compartment. For general information about load balancers, see Overview of the Load Balancing Service.

For the purposes of access control, you must provide the OCID of the compartment where you want the load balancer to reside. Notice that the load balancer doesn't have to be in the same compartment as the VCN or backend set. If you're not sure which compartment to use, put the load balancer in the same compartment as the VCN. For information about access control and compartments, see Overview of the IAM Service.

You must specify a display name for the load balancer. It does not have to be unique, and you can change it.

For information about Availability Domains, see Regions and Availability Domains. To get a list of Availability Domains, use the ListAvailabilityDomains operation in the Identity and Access Management Service API.

All Oracle Bare Metal Cloud Services resources, including load balancers, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the resource in the Console. Fore more information, see Resource Identifiers.

After you send your request, the new object's state will temporarily be PROVISIONING. Before using the object, first make sure its state has changed to RUNNING.

When you create a load balancer, the system assigns an IP address. To get the IP address, use the get_load_balancer() operation.

Parameters:
  • create_load_balancer_details (CreateLoadBalancerDetails) -- (required) The configuration details for creating a load balancer.
  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Returns:

A Response object with data of type None

Return type:

Response

delete_backend(load_balancer_id, backend_set_name, backend_name, **kwargs)

DeleteBackend Removes a backend server from a given load balancer and backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and server.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend server.

    Example: My_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to remove.

    Example: 1.1.1.7:42

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type None

Return type:

Response

delete_backend_set(load_balancer_id, backend_set_name, **kwargs)

DeleteBackendSet Deletes the specified backend set. Note that deleting a backend set removes its backend servers from the load balancer.

Before you can delete a backend set, you must remove it from any active listeners.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set.

  • backend_set_name (str) --

    (required) The name of the backend set to delete.

    Example: My_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type None

Return type:

Response

delete_certificate(load_balancer_id, certificate_name, **kwargs)

DeleteCertificate Deletes an SSL certificate from a load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the certificate to be deleted.

  • certificate_name (str) --

    (required) The name of the certificate to delete.

    Example: My_certificate_bundle

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type None

Return type:

Response

delete_listener(load_balancer_id, listener_name, **kwargs)

DeleteListener Deletes a listener from a load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the listener to delete.

  • listener_name (str) --

    (required) The name of the listener to delete.

    Example: My listener

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type None

Return type:

Response

delete_load_balancer(load_balancer_id, **kwargs)

DeleteLoadBalancer Stops a load balancer and removes it from service.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to delete.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type None

Return type:

Response

get_backend(load_balancer_id, backend_set_name, backend_name, **kwargs)

GetBackend Gets the specified backend server's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and server.

  • backend_set_name (str) --

    (required) The name of the backend set that includes the backend server.

    Example: My_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to retrieve.

    Example: 1.1.1.7:42

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type Backend

Return type:

Response

get_backend_health(load_balancer_id, backend_set_name, backend_name, **kwargs)

BackendHealth Gets the current health status of the specified backend server.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend server health status to be retrieved.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend server to retrieve the health status for.

    Example: My_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to retrieve the health status for.

    Example: 1.1.1.7:42

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type BackendHealth

Return type:

Response

get_backend_set(load_balancer_id, backend_set_name, **kwargs)

GetBackendSet Gets the specified backend set's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • backend_set_name (str) --

    (required) The name of the backend set to retrieve.

    Example: My_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type BackendSet

Return type:

Response

get_backend_set_health(load_balancer_id, backend_set_name, **kwargs)

BackendSetHealth Gets the health status for the specified backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set health status to be retrieved.

  • backend_set_name (str) --

    (required) The name of the backend set to retrieve the health status for.

    Example: My_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type BackendSetHealth

Return type:

Response

get_health_checker(load_balancer_id, backend_set_name, **kwargs)

GetHealthChecker Gets the health check policy information for a given load balancer and backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the health check policy to be retrieved.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the health check policy to be retrieved.

    Example: My_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type HealthChecker

Return type:

Response

get_load_balancer(load_balancer_id, **kwargs)

GetLoadBalancer Gets the specified load balancer's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type LoadBalancer

Return type:

Response

get_load_balancer_health(load_balancer_id, **kwargs)

LoadBalancerHealth Gets the health status for the specified load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to return health status for.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type LoadBalancerHealth

Return type:

Response

get_work_request(work_request_id, **kwargs)

GetWorkRequest Gets the details of a work request.

Parameters:
  • work_request_id (str) --

    (required) The OCID of the work request to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type WorkRequest

Return type:

Response

list_backend_sets(load_balancer_id, **kwargs)

ListBackendSets Lists all backend sets associated with a given load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend sets to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type list of BackendSet

Return type:

Response

list_backends(load_balancer_id, backend_set_name, **kwargs)

ListBackends Lists the backend servers for a given load balancer and backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and servers.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend servers.

    Example: My_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type list of Backend

Return type:

Response

list_certificates(load_balancer_id, **kwargs)

ListCertificates Lists all SSL certificates associated with a given load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the certificates to be listed.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Returns:

A Response object with data of type list of Certificate

Return type:

Response

list_load_balancer_healths(compartment_id, **kwargs)

ListLoadBalancerHealths Lists the summary health statuses for all load balancers in the specified compartment.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancers to return health status information for.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) --

    (optional) The value of the opc-next-page response header from the previous "List" call.

    Example: 3

Returns:

A Response object with data of type list of LoadBalancerHealthSummary

Return type:

Response

list_load_balancers(compartment_id, **kwargs)

ListLoadBalancers Lists all load balancers in the specified compartment.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancers to list.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) --

    (optional) The value of the opc-next-page response header from the previous "List" call.

    Example: 3

  • detail (str) --

    (optional) The level of detail to return for each result. Can be full or simple.

    Example: full

Returns:

A Response object with data of type list of LoadBalancer

Return type:

Response

list_policies(compartment_id, **kwargs)

ListPolicies Lists the available load balancer policies.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancer policies to list.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) The maximum number of items to return in a paginated "List" call.

    Example: 500

  • page (str) --

    (optional) The value of the opc-next-page response header from the previous "List" call.

    Example: 3

Returns:

A