oci 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 488c00cdc5eeffc80b243c41eda2e48a3a636d13
-  data.tar.gz: dc295148c7edd143d92421cfbe7a4b11c95711e6
+  metadata.gz: deead642983dcb680e7023da308d6b99c2194f2c
+  data.tar.gz: 94480a7fb20b82892e19d2323a0ebb62d0166ef4
 SHA512:
-  metadata.gz: a012d576d2f27aebeef2e26ea37ec52038e51a550aa73b684a816e73c109b2b6686195ac4ebd7c996e6a891a9b4941a71b1ab5ae03a7fc16af758fd3bbf19869
-  data.tar.gz: 27faeab73bd7fa8359969ce79a54b830597ac310bbe590b294b556759d289ca51581e5d6cabeefc3445304e3657292e875dfa17862517af6df32d74fa4256253
+  metadata.gz: 7185a217ff85b513d623f6af44e182c7512ef3c6a471db0a542a32fb6ba22bc738da7013ffbc14004d5a4b2dcf40572a86464b473f2f1333f58ce8bd7f6253bb
+  data.tar.gz: a4f3524b1ac8ac683a005df58529087aee58893409d191403b93135eeb5f671957a14cfe733e02b7abb00b628f837e5dc84c1f4340468378964e64611780fd16

data/README.md

@@ -1,5 +1,5 @@
 # Oracle Cloud Infrastructure Ruby SDK
-**Version 2.0.0**
+**Version 2.0.1**
 
 This topic describes how to install, configure, and use the Oracle Cloud Infrastructure Ruby SDK.
 
@@ -11,6 +11,7 @@ The Ruby SDK supports the following services:
 * Identity and Access Management Service
 * Load Balancing Service
 * Object Storage Service
+* Database Service
 
 **Licensing:** This SDK and sample is dual licensed under the Universal Permissive License 1.0 and the Apache License.
 

data/lib/oci.rb

@@ -17,9 +17,17 @@ require 'oci/core/core'
 require 'oci/identity/identity'
 require 'oci/load_balancer/load_balancer'
 require 'oci/object_storage/object_storage'
+require 'oci/database/database'
 
 # Top level module for the Oracle Cloud Infrastructure SDK
 module OCI
+  @@sdk_name = ''
+  def self.sdk_name
+    @@sdk_name
+  end
+  def self.sdk_name=(value)
+    @@sdk_name = value
+  end
 end
 
 OracleBMC = OCI

data/lib/oci/api_client.rb

@@ -101,7 +101,7 @@ module OCI
 
     # Build the user agent string to be send with each request.
     def build_user_agent
-      agent = "#{build_user_info} (ruby #{RUBY_VERSION}; #{RUBY_PLATFORM})"
+      agent = "#{build_user_info}#{OCI.sdk_name} (ruby #{RUBY_VERSION}; #{RUBY_PLATFORM})"
 
       if config.additional_user_agent
         agent = "#{agent} #{config.additional_user_agent}"
@@ -133,6 +133,8 @@ module OCI
         request = Net::HTTP::Delete.new(uri)
       elsif http_method == :head
         request = Net::HTTP::Head.new(uri)
+      elsif http_method == :patch
+        request = Net::HTTP::Patch.new(uri)
       else
         fail "new http method (#{http_method}) needs to be supported!"
       end
@@ -183,7 +185,7 @@ module OCI
             # If the response is timeout already, does not make sense to parse the http body because partial
             # response may be returned, we should skip JSON parser and raise exception immediately
             if response.is_a? Net::HTTPRequestTimeOut
-              raise Errors::NetworkError, response.message
+              raise Errors::NetworkError.new(response.message, response.code.to_i)
             end
 
             # process headers for opc-meta- key
@@ -216,7 +218,7 @@ module OCI
                                                  response.header['opc-request-id'],
                                                  data[:message])
                 else
-                  raise Errors::NetworkError, response.message
+                  raise Errors::NetworkError.new(response.message, response.code.to_i)
                 end
               end
 
@@ -236,7 +238,8 @@ module OCI
       rescue Errors::NetworkError, Errors::ServiceError, JSON::ParserError
         raise
       rescue => ex
-        raise Errors::NetworkError, ex.message
+        puts(ex.inspect)
+        raise Errors::NetworkError.new(ex.message, 0)
       end
     end
 
@@ -321,7 +324,10 @@ module OCI
 
       return body if (return_type == 'String' && !json_mime?(content_type)) || return_type == 'Stream'
 
-      fail "content-type is not supported: #{content_type}" unless json_mime?(content_type)
+      # There are some cases, the error is not returned by services but by like gateway, for example in bug
+      # https://jira.aka.lgl.grungy.us/browse/DEX-564, gateway timeouts and 504 is returned and content is generated
+      # by gateway, so there is no guarantee that the content-type will be application/json.
+      raise Errors::NetworkError.new(response.message, response.code.to_i) unless json_mime?(content_type)
 
       begin
         data = JSON.parse("[#{body}]", :symbolize_names => true)[0]

data/lib/oci/config.rb

@@ -3,10 +3,11 @@
 require 'uri'
 
 module OCI
-  # This class contains accessors for configuration attributes needed when using the
-  # SDK
+  # Error which will be thrown which configuration fails validation
   class InvalidConfigError < RuntimeError; end
 
+  # This class contains accessors for configuration attributes needed when using the
+  # SDK
   class Config
     # Patterns to use validate value for  different attribute
     PATTERNS = { 'tenancy' => /^([0-9a-zA-Z\-_]+[.:])([0-9a-zA-Z\-_]*[.:]){3,}([0-9a-zA-Z\-_]+)$/,

data/lib/oci/config_file_loader.rb

@@ -82,12 +82,12 @@ module OCI
         value = File.expand_path(value) if key == 'key_file'
 
         # key_content is not allowed in configuration file
-        if key != 'key_content'
-          if config.respond_to?("#{key}=") && config.respond_to?(key)
-            config.instance_variable_set('@' + key, value)
-          end
-          # TODO log the key been ignored by Ruby SDK
+        next if key == 'key_content'
+
+        if config.respond_to?("#{key}=") && config.respond_to?(key)
+          config.instance_variable_set('@' + key, value)
         end
+        # TODO: log the key been ignored by Ruby SDK
       end
     end
 

data/lib/oci/core/blockstorage_client.rb

@@ -59,7 +59,7 @@ module OCI
 
 
     # 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).
+    # 50 GB (51200 MB) to 16 TB (16777216 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).
     # 

data/lib/oci/core/compute_client.rb

@@ -254,7 +254,14 @@ module OCI
         :return_type => 'OCI::Core::Models::Image')
     end
 
-    # Create a console connection for an instance.
+    # Creates a new serial console connection to the specified instance.
+    # Once the serial console connection has been created and is available,
+    # you connect to the serial console using an SSH client.
+    # 
+    # The default number of enabled serial console connections per tenancy is 10.
+    # 
+    # For more information about serial console access, see [Accessing the Serial Console](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/References/serialconsole.htm).
+    # 
     # @param [CreateInstanceConsoleConnectionDetails] create_instance_console_connection_details Request object for creating an InstanceConsoleConnection
     # @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
@@ -362,7 +369,7 @@ module OCI
         :body => post_body)
     end
 
-    # Delete the console connection for an instance
+    # Deletes the specified serial console connection.
     # @param [String] instance_console_connection_id The OCID of the intance console connection
     # @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`
@@ -402,6 +409,12 @@ module OCI
     # When you terminate an instance, all attached VNICs (primary
     # and secondary) are automatically detached and deleted.
     # 
+    # **Important:** If the VNIC has a
+    # {PrivateIp} that is the
+    # [target of a route rule](https://docs.us-phoenix-1.oraclecloud.com/Content/Network/Tasks/managingroutetables.htm#privateip),
+    # deleting the VNIC causes that route rule to blackhole and the traffic
+    # will be dropped.
+    # 
     # @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`
@@ -664,7 +677,7 @@ module OCI
         :return_type => 'OCI::Core::Models::Instance')
     end
 
-    # Get the details of an instance console connection
+    # Gets the specified serial console connection's information.
     # @param [String] instance_console_connection_id The OCID of the intance console connection
     # @param [Hash] opts the optional parameters
     # @return [Response] A Response object with data of type OCI::Core::Models::InstanceConsoleConnection
@@ -1030,7 +1043,10 @@ module OCI
         :return_type => 'Array<OCI::Core::Models::Image>')
     end
 
-    # Lists the console connections for the specified compartment or instance that have not been deleted.
+    # Lists the serial console connections for the specified compartment or instance.
+    # 
+    # For more information about serial console access, see [Accessing the Serial Console](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/References/serialconsole.htm).
+    # 
     # @param [String] compartment_id The OCID of the compartment.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :instance_id The OCID of the instance.
@@ -1320,6 +1336,44 @@ module OCI
         :body => post_body)
     end
 
+    # Updates the specified console history metadata.
+    # @param [String] instance_console_history_id The OCID of the console history.
+    # @param [UpdateConsoleHistoryDetails] update_console_history_details Update instance 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's current etag value.
+    #   
+    # @return [Response] A Response object with data of type OCI::Core::Models::ConsoleHistory
+    def update_console_history(instance_console_history_id, update_console_history_details, opts = {})
+      logger.debug "Calling operation ComputeClient#update_console_history." if logger
+
+      fail "Missing the required parameter 'instance_console_history_id' when calling update_console_history." if instance_console_history_id.nil?
+      fail "Missing the required parameter 'update_console_history_details' when calling update_console_history." if update_console_history_details.nil?
+
+      path = "/instanceConsoleHistories/{instanceConsoleHistoryId}".sub('{instanceConsoleHistoryId}', instance_console_history_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 = @api_client.object_to_http_body(update_console_history_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OCI::Core::Models::ConsoleHistory')
+    end
+
     # 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. Avoid entering confidential information.

data/lib/oci/core/core.rb

@@ -77,6 +77,7 @@ require 'oci/core/models/tcp_options'
 require 'oci/core/models/tunnel_config'
 require 'oci/core/models/tunnel_status'
 require 'oci/core/models/udp_options'
+require 'oci/core/models/update_console_history_details'
 require 'oci/core/models/update_cpe_details'
 require 'oci/core/models/update_cross_connect_details'
 require 'oci/core/models/update_cross_connect_group_details'

data/lib/oci/core/models/capture_console_history_details.rb

@@ -4,6 +4,11 @@ require 'date'
 
 module OCI
   class Core::Models::CaptureConsoleHistoryDetails
+    # A user-friendly name. Does not have to be unique, and it's changeable.
+    # 
+    # @return [String]
+    attr_accessor :display_name
+
     # The OCID of the instance to get the console history from.
     # @return [String]
     attr_accessor :instance_id
@@ -17,6 +22,10 @@ module OCI
       # convert string to symbol for hash key
       attributes = attributes.each_with_object({}){|(k,v), h| h[k.to_sym] = v}
 
+      if attributes[:'displayName']
+        self.display_name = attributes[:'displayName']
+      end
+
       if attributes[:'instanceId']
         self.instance_id = attributes[:'instanceId']
       end
@@ -28,6 +37,7 @@ module OCI
     def ==(other_object)
       return true if self.equal?(other_object)
       self.class == other_object.class &&
+          display_name == other_object.display_name &&
           instance_id == other_object.instance_id
     end
 
@@ -40,7 +50,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [instance_id].hash
+      [display_name, instance_id].hash
     end
 
     # Builds the object from hash
@@ -106,6 +116,7 @@ module OCI
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       { 
+        :'display_name' => :'displayName',
         :'instance_id' => :'instanceId'
       }
     end
@@ -113,6 +124,7 @@ module OCI
     # Attribute type mapping.
     def self.swagger_types
       { 
+        :'display_name' => :'String',
         :'instance_id' => :'String'
       }
     end

data/lib/oci/core/models/create_instance_console_connection_details.rb

@@ -4,11 +4,11 @@ require 'date'
 
 module OCI
   class Core::Models::CreateInstanceConsoleConnectionDetails
-    # The host instance OCID
+    # The OCID of the instance to create the serial console connection to.
     # @return [String]
     attr_accessor :instance_id
 
-    # An ssh public key that will be used to authenticate the console connection.
+    # The SSH public key used to authenticate the serial console connection.
     # @return [String]
     attr_accessor :public_key
 

data/lib/oci/core/models/create_vnic_details.rb

@@ -66,6 +66,16 @@ module OCI
     # @return [String]
     attr_accessor :private_ip
 
+    # Whether the source/destination check is disabled on the VNIC.
+    # Defaults to `false`, which means the check is performed. For information
+    # about why you would skip the source/destination check, see
+    # [Using a Private IP as a Route Target](https://docs.us-phoenix-1.oraclecloud.com/Content/Network/Tasks/managingroutetables.htm#privateip).
+    # 
+    # Example: `true`
+    # 
+    # @return [BOOLEAN]
+    attr_accessor :skip_source_dest_check
+
     # 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 launch_instance_details}.
@@ -99,6 +109,10 @@ module OCI
         self.private_ip = attributes[:'privateIp']
       end
 
+      if attributes[:'skipSourceDestCheck']
+        self.skip_source_dest_check = attributes[:'skipSourceDestCheck']
+      end
+
       if attributes[:'subnetId']
         self.subnet_id = attributes[:'subnetId']
       end
@@ -114,6 +128,7 @@ module OCI
           display_name == other_object.display_name &&
           hostname_label == other_object.hostname_label &&
           private_ip == other_object.private_ip &&
+          skip_source_dest_check == other_object.skip_source_dest_check &&
           subnet_id == other_object.subnet_id
     end
 
@@ -126,7 +141,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [assign_public_ip, display_name, hostname_label, private_ip, subnet_id].hash
+      [assign_public_ip, display_name, hostname_label, private_ip, skip_source_dest_check, subnet_id].hash
     end
 
     # Builds the object from hash
@@ -196,6 +211,7 @@ module OCI
         :'display_name' => :'displayName',
         :'hostname_label' => :'hostnameLabel',
         :'private_ip' => :'privateIp',
+        :'skip_source_dest_check' => :'skipSourceDestCheck',
         :'subnet_id' => :'subnetId'
       }
     end
@@ -207,6 +223,7 @@ module OCI
         :'display_name' => :'String',
         :'hostname_label' => :'String',
         :'private_ip' => :'String',
+        :'skip_source_dest_check' => :'BOOLEAN',
         :'subnet_id' => :'String'
       }
     end

data/lib/oci/core/models/create_volume_details.rb

@@ -21,7 +21,13 @@ module OCI
     # @return [String]
     attr_accessor :display_name
 
+    # The size of the volume in GBs.
+    # @return [Integer]
+    attr_accessor :size_in_gbs
+
     # The size of the volume in MBs. The value must be a multiple of 1024.
+    # This field is deprecated. Please use sizeInGBs.
+    # 
     # @return [Integer]
     attr_accessor :size_in_mbs
 
@@ -51,6 +57,10 @@ module OCI
         self.display_name = attributes[:'displayName']
       end
 
+      if attributes[:'sizeInGBs']
+        self.size_in_gbs = attributes[:'sizeInGBs']
+      end
+
       if attributes[:'sizeInMBs']
         self.size_in_mbs = attributes[:'sizeInMBs']
       end
@@ -69,6 +79,7 @@ module OCI
           availability_domain == other_object.availability_domain &&
           compartment_id == other_object.compartment_id &&
           display_name == other_object.display_name &&
+          size_in_gbs == other_object.size_in_gbs &&
           size_in_mbs == other_object.size_in_mbs &&
           volume_backup_id == other_object.volume_backup_id
     end
@@ -82,7 +93,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [availability_domain, compartment_id, display_name, size_in_mbs, volume_backup_id].hash
+      [availability_domain, compartment_id, display_name, size_in_gbs, size_in_mbs, volume_backup_id].hash
     end
 
     # Builds the object from hash
@@ -151,6 +162,7 @@ module OCI
         :'availability_domain' => :'availabilityDomain',
         :'compartment_id' => :'compartmentId',
         :'display_name' => :'displayName',
+        :'size_in_gbs' => :'sizeInGBs',
         :'size_in_mbs' => :'sizeInMBs',
         :'volume_backup_id' => :'volumeBackupId'
       }
@@ -162,6 +174,7 @@ module OCI
         :'availability_domain' => :'String',
         :'compartment_id' => :'String',
         :'display_name' => :'String',
+        :'size_in_gbs' => :'Integer',
         :'size_in_mbs' => :'Integer',
         :'volume_backup_id' => :'String'
       }

data/lib/oci/core/models/instance_console_connection.rb

@@ -12,27 +12,27 @@ module OCI
                 LIFECYCLE_STATE_FAILED = 'FAILED',
                 LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE']
 
-    # The OCID of the compartment to contain the ConsoleConnection
+    # The OCID of the compartment to contain the serial console connection.
     # @return [String]
     attr_accessor :compartment_id
 
-    # The ssh connection string to the instance console
+    # The SSH connection string for the serial console connection.
     # @return [String]
     attr_accessor :connection_string
 
-    # The fingerprint of the ssh publicKey.
+    # The SSH public key fingerprint for the serial console connection.
     # @return [String]
     attr_accessor :fingerprint
 
-    # The OCID of the instance console connection
+    # The OCID of the serial console connection.
     # @return [String]
     attr_accessor :id
 
-    # The host instance OCID
+    # The OCID of the instance the serial console connection connects to.
     # @return [String]
     attr_accessor :instance_id
 
-    # The current state of the instance console connection.
+    # The current state of the serial console connection.
     # @return [String]
     attr_accessor :lifecycle_state