oraclebmc 1.2.3 → 1.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e456ae6fcaa69c070702fcf9120f68144b24791e
-  data.tar.gz: f42e37de94bbd59a7fea811850780ff567497667
+  metadata.gz: 5bd11f80b9f4e3cb8ce6662372947bf5895d4464
+  data.tar.gz: eeb109ab1a7b2e906006ca4b67b5bd23a3692cb5
 SHA512:
-  metadata.gz: bba74a8561736d7899d5530bb3a733fc65bf744d7157b31a548460f0de9df7be3db6dd18fd686f619dea5fb2600cd1c534eef05425620354108742b7f2a2b749
-  data.tar.gz: 10439dd07d981ed705fa1649ec029e3dfba0ab21d87c0fcbe9c9c36938531ab93aaa3d8d837dcd8ed2efb9d26920c74353fca5882973186a0fff53d2854f4736
+  metadata.gz: 00a295dff9af838da5d9bb32637f0d03db24a703857a9b219b0cccf3a3c9860a18a2ece0248cada050952fdb83f04a0d1dd572ba3649cf25d67deed4c5c46033
+  data.tar.gz: 139db5873752268c68d42e5468d7c01c7163d89389c0343791fe2db2f7189e1b945a7c98c3e28ea2b23edf6e1b277c68c952c5a6f5f1f4be48830ae28e8b0824

data/README.md

@@ -1,5 +1,5 @@
 # Oracle Bare Metal Cloud Services Ruby SDK
-**Version 1.2.3**
+**Version 1.2.4**
 
 This topic describes how to install, configure, and use the Oracle Bare Metal Cloud Services Ruby SDK.
 
@@ -77,7 +77,7 @@ You can also [download the SDK](https://docs.us-phoenix-1.oraclecloud.com/tools/
  Install the gem with the following command:
  
 
- `gem install oraclebmc-1.2.3.gem`
+ `gem install oraclebmc-1.2.4.gem`
 
 
 The SDK depends on `libcurl`, which may need to be installed or upgraded on some operating systems to be compatible with Oracle Bare Metal Cloud Services. 

data/lib/oraclebmc/core/blockstorage_client.rb

@@ -56,7 +56,8 @@ module OracleBMC
     end
 
 
-    # Creates a new volume in the specified compartment. The size of a volume can be either 256 GB or 2 TB.
+    # 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](https://docs.us-phoenix-1.oraclecloud.com/Content/Block/Concepts/overview.htm).
     # 
@@ -68,7 +69,7 @@ module OracleBMC
     # 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.
+    # description. It does not have to be unique, and you can change it. Avoid entering confidential information.
     # 
     # @param [CreateVolumeDetails] create_volume_details Request to create a new volume.
     # @param [Hash] opts the optional parameters
@@ -160,7 +161,7 @@ module OracleBMC
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type nil
     def delete_volume(volume_id, opts = {})
@@ -195,7 +196,7 @@ module OracleBMC
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type nil
     def delete_volume_backup(volume_backup_id, opts = {})
@@ -292,11 +293,11 @@ module OracleBMC
     # @param [String] compartment_id The OCID of the compartment.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :volume_id The OCID of the volume.
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::VolumeBackup>
     def list_volume_backups(compartment_id, opts = {})
@@ -338,11 +339,11 @@ module OracleBMC
     #   
     #   Example: `Uocm:PHX-AD-1`
     #   
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::Volume>
     def list_volumes(compartment_id, opts = {})
@@ -377,12 +378,14 @@ module OracleBMC
     end
 
     # Updates the specified volume's display name.
+    # Avoid entering confidential information.
+    # 
     # @param [String] volume_id The OCID of the volume.
-    # @param [UpdateVolumeDetails] update_volume_details Update volume&#39;s display name.
+    # @param [UpdateVolumeDetails] update_volume_details Update volume's display name. Avoid entering confidential information.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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&#39;s current etag value.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type OracleBMC::Core::Models::Volume
     def update_volume(volume_id, update_volume_details, opts = {})
@@ -415,12 +418,14 @@ module OracleBMC
     end
 
     # Updates the display name for the specified volume backup.
+    # Avoid entering confidential information.
+    # 
     # @param [String] volume_backup_id The OCID of the volume backup.
     # @param [UpdateVolumeBackupDetails] update_volume_backup_details Update volume backup fields
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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&#39;s current etag value.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type OracleBMC::Core::Models::VolumeBackup
     def update_volume_backup(volume_backup_id, update_volume_backup_details, opts = {})

data/lib/oraclebmc/core/compute_client.rb

@@ -56,6 +56,47 @@ module OracleBMC
     end
 
 
+    # Creates a secondary VNIC and attaches it to the specified instance.
+    # For more information about secondary VNICs, see
+    # [Managing Virtual Network Interface Cards (VNICs)](https://docs.us-phoenix-1.oraclecloud.com/Content/Network/Tasks/managingVNICs.htm).
+    # 
+    # @param [AttachVnicDetails] attach_vnic_details Attach VNIC details.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token 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).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Core::Models::VnicAttachment
+    def attach_vnic(attach_vnic_details, opts = {})
+      logger.debug "Calling operation ComputeClient#attach_vnic." if logger
+
+      fail "Missing the required parameter 'attach_vnic_details' when calling attach_vnic." if attach_vnic_details.nil?
+
+      path = "/vnicAttachments/"
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(attach_vnic_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Core::Models::VnicAttachment')
+    end
+
     # Attaches the specified storage volume to the specified instance.
     # 
     # @param [AttachVolumeDetails] attach_volume_details Attach volume request
@@ -150,14 +191,29 @@ module OracleBMC
         :return_type => 'OracleBMC::Core::Models::ConsoleHistory')
     end
 
-    # Creates a boot disk image for the specified instance. For more information about images, see
-    # [Managing Custom Images](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/managingcustomimages.htm).
+    # 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](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/managingcustomimages.htm).
     # 
-    # 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.
+    # When importing an exported image from the Object Storage Service, you specify the source information
+    # in {#image_source_details image_source_details}.
+    # 
+    # When importing an image based on the namespace, bucket name, and object name,
+    # use {#image_source_via_object_storage_tuple_details 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 image_source_via_object_storage_uri_details}.
+    # See [Object Storage URLs](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and [pre-authenticated requests](https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/managingaccess.htm#pre-auth)
+    # for constructing URLs for image import/export.
+    # 
+    # For more information about importing exported images, see
+    # [Image Import/Export](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm).
     # 
     # 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 update_image}.
+    # Avoid entering confidential information.
     # 
     # @param [CreateImageDetails] create_image_details Image creation details
     # @param [Hash] opts the optional parameters
@@ -201,7 +257,7 @@ module OracleBMC
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type nil
     def delete_console_history(instance_console_history_id, opts = {})
@@ -236,7 +292,7 @@ module OracleBMC
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type nil
     def delete_image(image_id, opts = {})
@@ -266,6 +322,45 @@ module OracleBMC
         :body => post_body)
     end
 
+    # 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.
+    # 
+    # @param [String] vnic_attachment_id The OCID of the VNIC attachment.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match 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.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def detach_vnic(vnic_attachment_id, opts = {})
+      logger.debug "Calling operation ComputeClient#detach_vnic." if logger
+
+      fail "Missing the required parameter 'vnic_attachment_id' when calling detach_vnic." if vnic_attachment_id.nil?
+
+      path = "/vnicAttachments/{vnicAttachmentId}".sub('{vnicAttachmentId}', vnic_attachment_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
     # 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
@@ -275,7 +370,7 @@ module OracleBMC
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type nil
     def detach_volume(volume_attachment_id, opts = {})
@@ -305,6 +400,61 @@ module OracleBMC
         :body => post_body)
     end
 
+    # 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](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm).
+    # 
+    # 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](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/commonpolicies.htm#Let4).
+    # 
+    # See [Object Storage URLs](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and [pre-authenticated requests](https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/managingaccess.htm#pre-auth)
+    # for constructing URLs for image import/export.
+    # 
+    # @param [String] image_id The OCID of the image.
+    # @param [ExportImageDetails] export_image_details Details for the image export.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token 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).
+    #   
+    # @option opts [String] :if_match 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.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Core::Models::Image
+    def export_image(image_id, export_image_details, opts = {})
+      logger.debug "Calling operation ComputeClient#export_image." if logger
+
+      fail "Missing the required parameter 'image_id' when calling export_image." if image_id.nil?
+      fail "Missing the required parameter 'export_image_details' when calling export_image." if export_image_details.nil?
+
+      path = "/images/{imageId}/actions/export".sub('{imageId}', image_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(export_image_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Core::Models::Image')
+    end
+
     # Shows the metadata for the specified console history.
     # See {#capture_console_history capture_console_history}
     # for details about using the console history operations.
@@ -439,6 +589,38 @@ module OracleBMC
         :return_type => 'OracleBMC::Core::Models::Instance')
     end
 
+    # Gets the information for the specified VNIC attachment.
+    # 
+    # @param [String] vnic_attachment_id The OCID of the VNIC attachment.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type OracleBMC::Core::Models::VnicAttachment
+    def get_vnic_attachment(vnic_attachment_id, opts = {})
+      logger.debug "Calling operation ComputeClient#get_vnic_attachment." if logger
+
+      fail "Missing the required parameter 'vnic_attachment_id' when calling get_vnic_attachment." if vnic_attachment_id.nil?
+
+      path = "/vnicAttachments/{vnicAttachmentId}".sub('{vnicAttachmentId}', vnic_attachment_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Core::Models::VnicAttachment')
+    end
+
     # Gets information about the specified volume attachment.
     # @param [String] volume_attachment_id The OCID of the volume attachment.
     # @param [Hash] opts the optional parameters
@@ -531,7 +713,7 @@ module OracleBMC
     #   
     # @option opts [String] :if_match 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.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type OracleBMC::Core::Models::Instance
     def instance_action(instance_id, action, opts = {})
@@ -586,13 +768,18 @@ module OracleBMC
     # 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). The VNIC has a private IP address from
-    # the subnet's CIDR, and optionally a public IP address.         
-    # To get the addresses, use the {#list_vnic_attachments list_vnic_attachments}
+    # 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 list_vnic_attachments}
     # operation to get the VNIC ID for the instance, and then call
     # {#get_vnic get_vnic} with the VNIC ID.
     # 
+    # You can later add secondary VNICs to an instance. For more information, see
+    # [Managing Virtual Network Interface Cards (VNICs)](https://docs.us-phoenix-1.oraclecloud.com/Content/Network/Tasks/managingVNICs.htm).
+    # 
     # @param [LaunchInstanceDetails] launch_instance_details Instance details
     # @param [Hash] opts the optional parameters
     # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
@@ -638,11 +825,11 @@ module OracleBMC
     #   
     #   Example: `Uocm:PHX-AD-1`
     #   
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @option opts [String] :instance_id The OCID of the instance.
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::ConsoleHistory>
@@ -684,23 +871,24 @@ module OracleBMC
     # 
     # @param [String] compartment_id The OCID of the compartment.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :display_name A user-friendly name. Does not have to be unique, and it&#39;s changeable.
+    # @option opts [String] :display_name A user-friendly name. Does not have to be unique, and it's changeable.
+    #   Avoid entering confidential information.
     #   
     #   Example: `My new resource`
     #   
-    # @option opts [String] :operating_system The image&#39;s operating system.
+    # @option opts [String] :operating_system The image's operating system.
     #   
     #   Example: `Oracle Linux`
     #   
-    # @option opts [String] :operating_system_version The image&#39;s operating system version.
+    # @option opts [String] :operating_system_version The image's operating system version.
     #   
     #   Example: `7.2`
     #   
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::Image>
     def list_images(compartment_id, opts = {})
@@ -746,15 +934,16 @@ module OracleBMC
     #   
     #   Example: `Uocm:PHX-AD-1`
     #   
-    # @option opts [String] :display_name A user-friendly name. Does not have to be unique, and it&#39;s changeable.
+    # @option opts [String] :display_name A user-friendly name. Does not have to be unique, and it's changeable.
+    #   Avoid entering confidential information.
     #   
     #   Example: `My new resource`
     #   
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::Instance>
     def list_instances(compartment_id, opts = {})
@@ -798,11 +987,11 @@ module OracleBMC
     #   
     #   Example: `Uocm:PHX-AD-1`
     #   
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @option opts [String] :image_id The OCID of an image.
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::Shape>
@@ -838,8 +1027,9 @@ module OracleBMC
         :return_type => 'Array<OracleBMC::Core::Models::Shape>')
     end
 
-    # Lists the VNIC attachments for the specified compartment. The list can be filtered by
-    # instance and by VNIC.
+    # 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.
     # 
     # @param [String] compartment_id The OCID of the compartment.
     # @param [Hash] opts the optional parameters
@@ -848,11 +1038,11 @@ module OracleBMC
     #   Example: `Uocm:PHX-AD-1`
     #   
     # @option opts [String] :instance_id The OCID of the instance.
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @option opts [String] :vnic_id The OCID of the VNIC.
     # @return [Response] A Response object with data of type Array<OracleBMC::Core::Models::VnicAttachment>
@@ -900,11 +1090,11 @@ module OracleBMC
     #   
     #   Example: `Uocm:PHX-AD-1`
     #   
-    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
     #   Example: `500`
     #   
-    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @option opts [String] :instance_id The OCID of the instance.
     # @option opts [String] :volume_id The OCID of the volume.
@@ -952,7 +1142,7 @@ module OracleBMC
     # @param [Hash] opts the optional parameters
     # @option opts [String] :if_match 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&#39;s current etag value.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type nil
     def terminate_instance(instance_id, opts = {})
@@ -982,9 +1172,9 @@ module OracleBMC
         :body => post_body)
     end
 
-    # Updates the display name of the image.
+    # Updates the display name of the image. Avoid entering confidential information.
     # @param [String] image_id The OCID of the image.
-    # @param [UpdateImageDetails] update_image_details Updates the image display name field.
+    # @param [UpdateImageDetails] update_image_details Updates the image display name field. Avoid entering confidential information.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :opc_retry_token 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
@@ -994,7 +1184,7 @@ module OracleBMC
     #   
     # @option opts [String] :if_match 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&#39;s current etag value.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type OracleBMC::Core::Models::Image
     def update_image(image_id, update_image_details, opts = {})
@@ -1027,8 +1217,8 @@ module OracleBMC
         :return_type => 'OracleBMC::Core::Models::Image')
     end
 
-    # Updates the display name of the specified instance. The OCID of the instance
-    # remains the same.
+    # Updates the display name of the specified instance. Avoid entering confidential information.
+    # The OCID of the instance remains the same.
     # 
     # @param [String] instance_id The OCID of the instance.
     # @param [UpdateInstanceDetails] update_instance_details Update instance fields
@@ -1041,7 +1231,7 @@ module OracleBMC
     #   
     # @option opts [String] :if_match 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&#39;s current etag value.
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #   
     # @return [Response] A Response object with data of type OracleBMC::Core::Models::Instance
     def update_instance(instance_id, update_instance_details, opts = {})