oci 2.3.1 → 2.3.2

data/lib/oci/file_storage/models/create_export_details.rb

@@ -6,6 +6,32 @@ require 'date'
 module OCI
   # CreateExportDetails model.
   class FileStorage::Models::CreateExportDetails # rubocop:disable Metrics/LineLength
+    # Export options for the new export. If left unspecified,
+    # defaults to:
+    #
+    #        [
+    #          {
+    #             \"source\" : \"0.0.0.0/0\",
+    #             \"requirePrivilegedSourcePort\" : false,
+    #             \"access\" : \"READ_WRITE\",
+    #             \"identitySquash\" : \"NONE\"
+    #           }
+    #        ]
+    #
+    #   **Note:** Mount targets do not have Internet-routable IP
+    #   addresses.  Therefore they will not be reachable from the
+    #   Internet, even if an associated `ClientOptions` item has
+    #   a source of `0.0.0.0/0`.
+    #
+    #   **If set to the empty array then the export will not be
+    #   visible to any clients.**
+    #
+    #   The export's `exportOptions` can be changed after creation
+    #   using the `UpdateExport` operation.
+    #
+    # @return [Array<OCI::FileStorage::Models::ClientOptions>]
+    attr_accessor :export_options
+
     # **[Required]** The OCID of this export's export set.
     # @return [String]
     attr_accessor :export_set_id
@@ -27,6 +53,7 @@ module OCI
     def self.attribute_map
       {
         # rubocop:disable Style/SymbolLiteral
+        'export_options': :'exportOptions',
         'export_set_id': :'exportSetId',
         'file_system_id': :'fileSystemId',
         'path': :'path'
@@ -38,6 +65,7 @@ module OCI
     def self.swagger_types
       {
         # rubocop:disable Style/SymbolLiteral
+        'export_options': :'Array<OCI::FileStorage::Models::ClientOptions>',
         'export_set_id': :'String',
         'file_system_id': :'String',
         'path': :'String'
@@ -51,6 +79,7 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::FileStorage::Models::ClientOptions>] :export_options The value to assign to the {#export_options} property
     # @option attributes [String] :export_set_id The value to assign to the {#export_set_id} property
     # @option attributes [String] :file_system_id The value to assign to the {#file_system_id} property
     # @option attributes [String] :path The value to assign to the {#path} property
@@ -60,6 +89,12 @@ module OCI
       # convert string to symbol for hash key
       attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
 
+      self.export_options = attributes[:'exportOptions'] if attributes[:'exportOptions']
+
+      raise 'You cannot provide both :exportOptions and :export_options' if attributes.key?(:'exportOptions') && attributes.key?(:'export_options')
+
+      self.export_options = attributes[:'export_options'] if attributes[:'export_options']
+
       self.export_set_id = attributes[:'exportSetId'] if attributes[:'exportSetId']
 
       raise 'You cannot provide both :exportSetId and :export_set_id' if attributes.key?(:'exportSetId') && attributes.key?(:'export_set_id')
@@ -85,6 +120,7 @@ module OCI
     def ==(other)
       return true if equal?(other)
       self.class == other.class &&
+        export_options == other.export_options &&
         export_set_id == other.export_set_id &&
         file_system_id == other.file_system_id &&
         path == other.path
@@ -103,7 +139,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [export_set_id, file_system_id, path].hash
+      [export_options, export_set_id, file_system_id, path].hash
     end
     # rubocop:enable Metrics/AbcSize, Metrics/LineLength, Layout/EmptyLines
 

data/lib/oci/file_storage/models/create_snapshot_details.rb

@@ -6,7 +6,7 @@ require 'date'
 module OCI
   # CreateSnapshotDetails model.
   class FileStorage::Models::CreateSnapshotDetails # rubocop:disable Metrics/LineLength
-    # **[Required]** The OCID of this export's file system.
+    # **[Required]** The OCID of the file system to take a snapshot of.
     # @return [String]
     attr_accessor :file_system_id
 

data/lib/oci/file_storage/models/export.rb

@@ -36,6 +36,9 @@ module OCI
   # No two non-'DELETED' export resources in the same export set can
   # reference the same file system.
   #
+  # Use `exportOptions` to control access to an export. For more information, see
+  # [Export Options](https://docs.us-phoenix-1.oraclecloud.com/Content/File/Tasks/exportoptions.htm).
+  #
   class FileStorage::Models::Export # rubocop:disable Metrics/LineLength
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
@@ -45,6 +48,35 @@ module OCI
       LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
+    # **[Required]** Policies that apply to NFS requests made through this
+    # export. `exportOptions` contains a sequential list of
+    # `ClientOptions`. Each `ClientOptions` item defines the
+    # export options that are applied to a specified
+    # set of clients.
+    #
+    # For each NFS request, the first `ClientOptions` option
+    # in the list whose `source` attribute matches the source
+    # IP address of the request is applied.
+    #
+    # If a client source IP address does not match the `source`
+    # property of any `ClientOptions` in the list, then the
+    # export will be invisible to that client. This export will
+    # not be returned by `MOUNTPROC_EXPORT` calls made by the client
+    # and any attempt to mount or access the file system through
+    # this export will result in an error.
+    #
+    # **Exports without defined `ClientOptions` are invisible to all clients.**
+    #
+    # If one export is invisible to a particular client, associated file
+    # systems may still be accessible through other exports on the same
+    # or different mount targets.
+    # To completely deny client access to a file system, be sure that the client
+    # source IP address is not included in any export for any mount target
+    # associated with the file system.
+    #
+    # @return [Array<OCI::FileStorage::Models::ClientOptions>]
+    attr_accessor :export_options
+
     # **[Required]** The OCID of this export's export set.
     # @return [String]
     attr_accessor :export_set_id
@@ -82,6 +114,7 @@ module OCI
     def self.attribute_map
       {
         # rubocop:disable Style/SymbolLiteral
+        'export_options': :'exportOptions',
         'export_set_id': :'exportSetId',
         'file_system_id': :'fileSystemId',
         'id': :'id',
@@ -96,6 +129,7 @@ module OCI
     def self.swagger_types
       {
         # rubocop:disable Style/SymbolLiteral
+        'export_options': :'Array<OCI::FileStorage::Models::ClientOptions>',
         'export_set_id': :'String',
         'file_system_id': :'String',
         'id': :'String',
@@ -112,6 +146,7 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::FileStorage::Models::ClientOptions>] :export_options The value to assign to the {#export_options} property
     # @option attributes [String] :export_set_id The value to assign to the {#export_set_id} property
     # @option attributes [String] :file_system_id The value to assign to the {#file_system_id} property
     # @option attributes [String] :id The value to assign to the {#id} property
@@ -124,6 +159,12 @@ module OCI
       # convert string to symbol for hash key
       attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
 
+      self.export_options = attributes[:'exportOptions'] if attributes[:'exportOptions']
+
+      raise 'You cannot provide both :exportOptions and :export_options' if attributes.key?(:'exportOptions') && attributes.key?(:'export_options')
+
+      self.export_options = attributes[:'export_options'] if attributes[:'export_options']
+
       self.export_set_id = attributes[:'exportSetId'] if attributes[:'exportSetId']
 
       raise 'You cannot provide both :exportSetId and :export_set_id' if attributes.key?(:'exportSetId') && attributes.key?(:'export_set_id')
@@ -178,6 +219,7 @@ module OCI
     def ==(other)
       return true if equal?(other)
       self.class == other.class &&
+        export_options == other.export_options &&
         export_set_id == other.export_set_id &&
         file_system_id == other.file_system_id &&
         id == other.id &&
@@ -199,7 +241,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [export_set_id, file_system_id, id, lifecycle_state, path, time_created].hash
+      [export_options, export_set_id, file_system_id, id, lifecycle_state, path, time_created].hash
     end
     # rubocop:enable Metrics/AbcSize, Metrics/LineLength, Layout/EmptyLines
 

data/lib/oci/file_storage/models/export_set.rb

@@ -58,7 +58,7 @@ module OCI
     # @return [Integer]
     attr_accessor :max_fs_stat_bytes
 
-    # Controls the maximum `ffiles`, `ffiles`, and `afiles`
+    # Controls the maximum `tfiles`, `ffiles`, and `afiles`
     # values reported by `NFS FSSTAT` calls through any associated
     # mount targets. This is an advanced feature. For most
     # applications, use the default value. The

data/lib/oci/file_storage/models/update_export_details.rb

@@ -0,0 +1,155 @@
+# Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
+
+require 'date'
+
+# rubocop:disable Lint/UnneededCopDisableDirective
+module OCI
+  # UpdateExportDetails model.
+  class FileStorage::Models::UpdateExportDetails # rubocop:disable Metrics/LineLength
+    # New export options for the export.
+    #
+    # **Setting to the empty array will make the export invisible to all clients.**
+    #
+    # Leaving unset will leave the `exportOptions` unchanged.
+    #
+    # @return [Array<OCI::FileStorage::Models::ClientOptions>]
+    attr_accessor :export_options
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'export_options': :'exportOptions'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'export_options': :'Array<OCI::FileStorage::Models::ClientOptions>'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/LineLength, Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::FileStorage::Models::ClientOptions>] :export_options The value to assign to the {#export_options} 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.export_options = attributes[:'exportOptions'] if attributes[:'exportOptions']
+
+      raise 'You cannot provide both :exportOptions and :export_options' if attributes.key?(:'exportOptions') && attributes.key?(:'export_options')
+
+      self.export_options = attributes[:'export_options'] if attributes[:'export_options']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/LineLength, Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # 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 &&
+        export_options == other.export_options
+    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, Metrics/LineLength, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [export_options].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/LineLength, 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

data/lib/oci/load_balancer/models/create_load_balancer_details.rb

@@ -16,6 +16,14 @@ module OCI
     # @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.us-phoenix-1.oraclecloud.com/Content/General/Concepts/resourcetags.htm).
+    #
+    # Example: `{\"Operations\": {\"CostCenter\": \"42\"}}`
+    #
+    # @return [Hash<String, Hash<String, Object>>]
+    attr_accessor :defined_tags
+
     # **[Required]** A user-friendly name. It does not have to be unique, and it is changeable.
     # Avoid entering confidential information.
     #
@@ -24,6 +32,14 @@ module OCI
     # @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.us-phoenix-1.oraclecloud.com/Content/General/Concepts/resourcetags.htm).
+    #
+    # Example: `{\"Department\": \"Finance\"}`
+    #
+    # @return [Hash<String, String>]
+    attr_accessor :freeform_tags
+
     # @return [Hash<String, OCI::LoadBalancer::Models::HostnameDetails>]
     attr_accessor :hostnames
 
@@ -72,7 +88,9 @@ module OCI
         'backend_sets': :'backendSets',
         'certificates': :'certificates',
         'compartment_id': :'compartmentId',
+        'defined_tags': :'definedTags',
         'display_name': :'displayName',
+        'freeform_tags': :'freeformTags',
         'hostnames': :'hostnames',
         'is_private': :'isPrivate',
         'listeners': :'listeners',
@@ -90,7 +108,9 @@ module OCI
         'backend_sets': :'Hash<String, OCI::LoadBalancer::Models::BackendSetDetails>',
         'certificates': :'Hash<String, OCI::LoadBalancer::Models::CertificateDetails>',
         'compartment_id': :'String',
+        'defined_tags': :'Hash<String, Hash<String, Object>>',
         'display_name': :'String',
+        'freeform_tags': :'Hash<String, String>',
         'hostnames': :'Hash<String, OCI::LoadBalancer::Models::HostnameDetails>',
         'is_private': :'BOOLEAN',
         'listeners': :'Hash<String, OCI::LoadBalancer::Models::ListenerDetails>',
@@ -110,7 +130,9 @@ module OCI
     # @option attributes [Hash<String, OCI::LoadBalancer::Models::BackendSetDetails>] :backend_sets The value to assign to the {#backend_sets} property
     # @option attributes [Hash<String, OCI::LoadBalancer::Models::CertificateDetails>] :certificates The value to assign to the {#certificates} property
     # @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 [Hash<String, OCI::LoadBalancer::Models::HostnameDetails>] :hostnames The value to assign to the {#hostnames} property
     # @option attributes [BOOLEAN] :is_private The value to assign to the {#is_private} property
     # @option attributes [Hash<String, OCI::LoadBalancer::Models::ListenerDetails>] :listeners The value to assign to the {#listeners} property
@@ -137,12 +159,24 @@ module OCI
 
       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.hostnames = attributes[:'hostnames'] if attributes[:'hostnames']
 
       self.is_private = attributes[:'isPrivate'] unless attributes[:'isPrivate'].nil?
@@ -187,7 +221,9 @@ module OCI
         backend_sets == other.backend_sets &&
         certificates == other.certificates &&
         compartment_id == other.compartment_id &&
+        defined_tags == other.defined_tags &&
         display_name == other.display_name &&
+        freeform_tags == other.freeform_tags &&
         hostnames == other.hostnames &&
         is_private == other.is_private &&
         listeners == other.listeners &&
@@ -209,7 +245,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [backend_sets, certificates, compartment_id, display_name, hostnames, is_private, listeners, path_route_sets, shape_name, subnet_ids].hash
+      [backend_sets, certificates, compartment_id, defined_tags, display_name, freeform_tags, hostnames, is_private, listeners, path_route_sets, shape_name, subnet_ids].hash
     end
     # rubocop:enable Metrics/AbcSize, Metrics/LineLength, Layout/EmptyLines