oci 2.5.9 → 2.5.10

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

@@ -4,7 +4,9 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Instance Configuration
+  # An instance configuration is a template that defines the settings to use when creating Compute instances
+  # as part of an instance pool. For more information about instance pools and instance configurations, see
+  # [Managing Compute Instances](https://docs.cloud.oracle.com/Content/Compute/Concepts/instancemanagement.htm).
   #
   class Core::Models::InstanceConfiguration
     # **[Required]** The OCID of the compartment containing the instance configuration.

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

@@ -26,6 +26,13 @@ module OCI
     # @return [String]
     attr_accessor :hostname_label
 
+    # A list of the OCIDs of the network security groups (NSGs) to add the VNIC to. For more
+    # information about NSGs, see
+    # {NetworkSecurityGroup}.
+    #
+    # @return [Array<String>]
+    attr_accessor :nsg_ids
+
     # A private IP address of your choice to assign to the VNIC.
     # See the `privateIp` attribute of {CreateVnicDetails} for more information.
     #
@@ -51,6 +58,7 @@ module OCI
         'assign_public_ip': :'assignPublicIp',
         'display_name': :'displayName',
         'hostname_label': :'hostnameLabel',
+        'nsg_ids': :'nsgIds',
         'private_ip': :'privateIp',
         'skip_source_dest_check': :'skipSourceDestCheck',
         'subnet_id': :'subnetId'
@@ -65,6 +73,7 @@ module OCI
         'assign_public_ip': :'BOOLEAN',
         'display_name': :'String',
         'hostname_label': :'String',
+        'nsg_ids': :'Array<String>',
         'private_ip': :'String',
         'skip_source_dest_check': :'BOOLEAN',
         'subnet_id': :'String'
@@ -81,6 +90,7 @@ module OCI
     # @option attributes [BOOLEAN] :assign_public_ip The value to assign to the {#assign_public_ip} property
     # @option attributes [String] :display_name The value to assign to the {#display_name} property
     # @option attributes [String] :hostname_label The value to assign to the {#hostname_label} property
+    # @option attributes [Array<String>] :nsg_ids The value to assign to the {#nsg_ids} property
     # @option attributes [String] :private_ip The value to assign to the {#private_ip} property
     # @option attributes [BOOLEAN] :skip_source_dest_check The value to assign to the {#skip_source_dest_check} property
     # @option attributes [String] :subnet_id The value to assign to the {#subnet_id} property
@@ -108,6 +118,12 @@ module OCI
 
       self.hostname_label = attributes[:'hostname_label'] if attributes[:'hostname_label']
 
+      self.nsg_ids = attributes[:'nsgIds'] if attributes[:'nsgIds']
+
+      raise 'You cannot provide both :nsgIds and :nsg_ids' if attributes.key?(:'nsgIds') && attributes.key?(:'nsg_ids')
+
+      self.nsg_ids = attributes[:'nsg_ids'] if attributes[:'nsg_ids']
+
       self.private_ip = attributes[:'privateIp'] if attributes[:'privateIp']
 
       raise 'You cannot provide both :privateIp and :private_ip' if attributes.key?(:'privateIp') && attributes.key?(:'private_ip')
@@ -141,6 +157,7 @@ module OCI
         assign_public_ip == other.assign_public_ip &&
         display_name == other.display_name &&
         hostname_label == other.hostname_label &&
+        nsg_ids == other.nsg_ids &&
         private_ip == other.private_ip &&
         skip_source_dest_check == other.skip_source_dest_check &&
         subnet_id == other.subnet_id
@@ -159,7 +176,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, skip_source_dest_check, subnet_id].hash
+      [assign_public_ip, display_name, hostname_label, nsg_ids, private_ip, skip_source_dest_check, subnet_id].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

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

@@ -7,6 +7,10 @@ require_relative 'instance_configuration_instance_source_details'
 module OCI
   # InstanceConfigurationInstanceSourceViaImageDetails model.
   class Core::Models::InstanceConfigurationInstanceSourceViaImageDetails < Core::Models::InstanceConfigurationInstanceSourceDetails
+    # The size of the boot volume in GBs. The minimum value is 50 GB and the maximum value is 16384 GB (16TB).
+    # @return [Integer]
+    attr_accessor :boot_volume_size_in_gbs
+
     # The OCID of the image used to boot the instance.
     # @return [String]
     attr_accessor :image_id
@@ -16,6 +20,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'source_type': :'sourceType',
+        'boot_volume_size_in_gbs': :'bootVolumeSizeInGBs',
         'image_id': :'imageId'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -26,6 +31,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'source_type': :'String',
+        'boot_volume_size_in_gbs': :'Integer',
         'image_id': :'String'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -37,6 +43,7 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Integer] :boot_volume_size_in_gbs The value to assign to the {#boot_volume_size_in_gbs} property
     # @option attributes [String] :image_id The value to assign to the {#image_id} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
@@ -48,6 +55,12 @@ module OCI
       # convert string to symbol for hash key
       attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
 
+      self.boot_volume_size_in_gbs = attributes[:'bootVolumeSizeInGBs'] if attributes[:'bootVolumeSizeInGBs']
+
+      raise 'You cannot provide both :bootVolumeSizeInGBs and :boot_volume_size_in_gbs' if attributes.key?(:'bootVolumeSizeInGBs') && attributes.key?(:'boot_volume_size_in_gbs')
+
+      self.boot_volume_size_in_gbs = attributes[:'boot_volume_size_in_gbs'] if attributes[:'boot_volume_size_in_gbs']
+
       self.image_id = attributes[:'imageId'] if attributes[:'imageId']
 
       raise 'You cannot provide both :imageId and :image_id' if attributes.key?(:'imageId') && attributes.key?(:'image_id')
@@ -67,6 +80,7 @@ module OCI
 
       self.class == other.class &&
         source_type == other.source_type &&
+        boot_volume_size_in_gbs == other.boot_volume_size_in_gbs &&
         image_id == other.image_id
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
@@ -83,7 +97,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [source_type, image_id].hash
+      [source_type, boot_volume_size_in_gbs, image_id].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

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

@@ -4,7 +4,7 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Instance Configuration Summary
+  # Summary information for an instance configuration.
   #
   class Core::Models::InstanceConfigurationSummary
     # **[Required]** The OCID of the compartment containing the instance configuration.
@@ -12,12 +12,12 @@ module OCI
     # @return [String]
     attr_accessor :compartment_id
 
-    # A user-friendly name for the instance configuration
+    # A user-friendly name for the instance configuration.
     #
     # @return [String]
     attr_accessor :display_name
 
-    # **[Required]** The OCID of the instance configuration
+    # **[Required]** The OCID of the instance configuration.
     # @return [String]
     attr_accessor :id
 

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

@@ -5,7 +5,10 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Instance Pool
+  # An instance pool is a group of instances within the same region that are created based off of the same
+  # instance configuration. For more information about instance pools and instance configurations, see
+  # [Managing Compute Instances](https://docs.cloud.oracle.com/Content/Compute/Concepts/instancemanagement.htm).
+  #
   class Core::Models::InstancePool
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_PROVISIONING = 'PROVISIONING'.freeze,

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

@@ -5,7 +5,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Condensed InstancePool data when listing instance pools.
+  # Summary information for an instance pool.
   class Core::Models::InstancePoolSummary
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_PROVISIONING = 'PROVISIONING'.freeze,
@@ -19,11 +19,11 @@ module OCI
       LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The OCID of the instance pool
+    # **[Required]** The OCID of the instance pool.
     # @return [String]
     attr_accessor :id
 
-    # **[Required]** The OCID of the compartment containing the instance pool
+    # **[Required]** The OCID of the compartment containing the instance pool.
     # @return [String]
     attr_accessor :compartment_id
 

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

@@ -0,0 +1,324 @@
+# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+
+require 'date'
+require 'logger'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # A *network security group* (NSG) provides virtual firewall rules for a specific set of
+  # {Vnic} in a VCN. Compare NSGs with {SecurityList},
+  # which provide virtual firewall rules to all the VNICs in a *subnet*.
+  #
+  # A network security group consists of two items:
+  #
+  #   * The set of {Vnic} that all have the same security rule needs (for
+  #     example, a group of Compute instances all running the same application)
+  #   * A set of NSG {SecurityRule} that apply to the VNICs in the group
+  #
+  # After creating an NSG, you can add VNICs and security rules to it. For example, when you create
+  # an instance, you can specify one or more NSGs to add the instance to (see
+  # {#create_vnic_details create_vnic_details}). Or you can add an existing
+  # instance to an NSG with {#update_vnic update_vnic}.
+  #
+  # To add security rules to an NSG, see
+  # {#add_network_security_group_security_rules add_network_security_group_security_rules}.
+  #
+  # To list the VNICs in an NSG, see
+  # {#list_network_security_group_vnics list_network_security_group_vnics}.
+  #
+  # To list the security rules in an NSG, see
+  # {#list_network_security_group_security_rules list_network_security_group_security_rules}.
+  #
+  # For more information about network security groups, see
+  # [Network Security Groups](https://docs.cloud.oracle.com/iaas/Content/Network/Concepts/networksecuritygroups.htm).
+  #
+  # **Important:** Oracle Cloud Infrastructure Compute service images automatically include firewall rules (for example,
+  # Linux iptables, Windows firewall). If there are issues with some type of access to an instance,
+  # make sure all of the following are set correctly:
+  #
+  #   * Any security rules in any NSGs the instance's VNIC belongs to
+  #   * Any {SecurityList} associated with the instance's subnet
+  #   * The instance's OS firewall rules
+  #
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you
+  # supply string values using the API.
+  #
+  class Core::Models::NetworkSecurityGroup
+    LIFECYCLE_STATE_ENUM = [
+      LIFECYCLE_STATE_PROVISIONING = 'PROVISIONING'.freeze,
+      LIFECYCLE_STATE_AVAILABLE = 'AVAILABLE'.freeze,
+      LIFECYCLE_STATE_TERMINATING = 'TERMINATING'.freeze,
+      LIFECYCLE_STATE_TERMINATED = 'TERMINATED'.freeze,
+      LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the compartment the network security group is in.
+    #
+    # @return [String]
+    attr_accessor :compartment_id
+
+    # Defined tags for this resource. Each key is predefined and scoped to a
+    # namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
+    #
+    # Example: `{\"Operations\": {\"CostCenter\": \"42\"}}`
+    #
+    # @return [Hash<String, Hash<String, Object>>]
+    attr_accessor :defined_tags
+
+    # A user-friendly name. Does not have to be unique.
+    # Avoid entering confidential information.
+    #
+    # @return [String]
+    attr_accessor :display_name
+
+    # Free-form tags for this resource. Each tag is a simple key-value pair with no
+    # predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
+    #
+    # Example: `{\"Department\": \"Finance\"}`
+    #
+    # @return [Hash<String, String>]
+    attr_accessor :freeform_tags
+
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the network security group.
+    # @return [String]
+    attr_accessor :id
+
+    # **[Required]** The network security group's current state.
+    # @return [String]
+    attr_reader :lifecycle_state
+
+    # **[Required]** The date and time the network security group was created, in the format defined by RFC3339.
+    #
+    # Example: `2016-08-25T21:10:29.600Z`
+    #
+    # @return [DateTime]
+    attr_accessor :time_created
+
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the network security group's VCN.
+    # @return [String]
+    attr_accessor :vcn_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'compartment_id': :'compartmentId',
+        'defined_tags': :'definedTags',
+        'display_name': :'displayName',
+        'freeform_tags': :'freeformTags',
+        'id': :'id',
+        'lifecycle_state': :'lifecycleState',
+        'time_created': :'timeCreated',
+        'vcn_id': :'vcnId'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'compartment_id': :'String',
+        'defined_tags': :'Hash<String, Hash<String, Object>>',
+        'display_name': :'String',
+        'freeform_tags': :'Hash<String, String>',
+        'id': :'String',
+        'lifecycle_state': :'String',
+        'time_created': :'DateTime',
+        'vcn_id': :'String'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :compartment_id The value to assign to the {#compartment_id} property
+    # @option attributes [Hash<String, Hash<String, Object>>] :defined_tags The value to assign to the {#defined_tags} property
+    # @option attributes [String] :display_name The value to assign to the {#display_name} property
+    # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
+    # @option attributes [String] :id The value to assign to the {#id} property
+    # @option attributes [String] :lifecycle_state The value to assign to the {#lifecycle_state} property
+    # @option attributes [DateTime] :time_created The value to assign to the {#time_created} property
+    # @option attributes [String] :vcn_id The value to assign to the {#vcn_id} property
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
+
+      self.compartment_id = attributes[:'compartmentId'] if attributes[:'compartmentId']
+
+      raise 'You cannot provide both :compartmentId and :compartment_id' if attributes.key?(:'compartmentId') && attributes.key?(:'compartment_id')
+
+      self.compartment_id = attributes[:'compartment_id'] if attributes[:'compartment_id']
+
+      self.defined_tags = attributes[:'definedTags'] if attributes[:'definedTags']
+
+      raise 'You cannot provide both :definedTags and :defined_tags' if attributes.key?(:'definedTags') && attributes.key?(:'defined_tags')
+
+      self.defined_tags = attributes[:'defined_tags'] if attributes[:'defined_tags']
+
+      self.display_name = attributes[:'displayName'] if attributes[:'displayName']
+
+      raise 'You cannot provide both :displayName and :display_name' if attributes.key?(:'displayName') && attributes.key?(:'display_name')
+
+      self.display_name = attributes[:'display_name'] if attributes[:'display_name']
+
+      self.freeform_tags = attributes[:'freeformTags'] if attributes[:'freeformTags']
+
+      raise 'You cannot provide both :freeformTags and :freeform_tags' if attributes.key?(:'freeformTags') && attributes.key?(:'freeform_tags')
+
+      self.freeform_tags = attributes[:'freeform_tags'] if attributes[:'freeform_tags']
+
+      self.id = attributes[:'id'] if attributes[:'id']
+
+      self.lifecycle_state = attributes[:'lifecycleState'] if attributes[:'lifecycleState']
+
+      raise 'You cannot provide both :lifecycleState and :lifecycle_state' if attributes.key?(:'lifecycleState') && attributes.key?(:'lifecycle_state')
+
+      self.lifecycle_state = attributes[:'lifecycle_state'] if attributes[:'lifecycle_state']
+
+      self.time_created = attributes[:'timeCreated'] if attributes[:'timeCreated']
+
+      raise 'You cannot provide both :timeCreated and :time_created' if attributes.key?(:'timeCreated') && attributes.key?(:'time_created')
+
+      self.time_created = attributes[:'time_created'] if attributes[:'time_created']
+
+      self.vcn_id = attributes[:'vcnId'] if attributes[:'vcnId']
+
+      raise 'You cannot provide both :vcnId and :vcn_id' if attributes.key?(:'vcnId') && attributes.key?(:'vcn_id')
+
+      self.vcn_id = attributes[:'vcn_id'] if attributes[:'vcn_id']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] lifecycle_state Object to be assigned
+    def lifecycle_state=(lifecycle_state)
+      # rubocop:disable Style/ConditionalAssignment
+      if lifecycle_state && !LIFECYCLE_STATE_ENUM.include?(lifecycle_state)
+        OCI.logger.debug("Unknown value for 'lifecycle_state' [" + lifecycle_state + "]. Mapping to 'LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @lifecycle_state = LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE
+      else
+        @lifecycle_state = lifecycle_state
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other the other object to be compared
+    def ==(other)
+      return true if equal?(other)
+
+      self.class == other.class &&
+        compartment_id == other.compartment_id &&
+        defined_tags == other.defined_tags &&
+        display_name == other.display_name &&
+        freeform_tags == other.freeform_tags &&
+        id == other.id &&
+        lifecycle_state == other.lifecycle_state &&
+        time_created == other.time_created &&
+        vcn_id == other.vcn_id
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+    # @see the `==` method
+    # @param [Object] other the other object to be compared
+    def eql?(other)
+      self == other
+    end
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [compartment_id, defined_tags, display_name, freeform_tags, id, lifecycle_state, time_created, vcn_id].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            public_method("#{key}=").call(
+              attributes[self.class.attribute_map[key]]
+                .map { |v| OCI::Internal::Util.convert_to_type(Regexp.last_match(1), v) }
+            )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          public_method("#{key}=").call(
+            OCI::Internal::Util.convert_to_type(type, attributes[self.class.attribute_map[key]])
+          )
+        end
+        # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = public_method(attr).call
+        next if value.nil? && !instance_variable_defined?("@#{attr}")
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    private
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+  end
+end
+# rubocop:enable Lint/UnneededCopDisableDirective, Metrics/LineLength