oci 2.14.0 → 2.15.0

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

@@ -8,7 +8,7 @@ require 'logger'
 module OCI
   # An asynchronous replica of a boot volume that can then be used to create
   # a new boot volume or recover a boot volume. For more information, see [Overview
-  # of Block Volume Replicas](https://docs.cloud.oracle.com/iaas/Content/Block/Concepts/bootvolumereplicas.htm)
+  # of Cross-Region Volume Replication](https://docs.cloud.oracle.com/iaas/Content/Block/Concepts/volumereplication.htm)
   # 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

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

@@ -0,0 +1,196 @@
+# Copyright (c) 2016, 2021, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+require 'date'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # CopyVolumeGroupBackupDetails model.
+  class Core::Models::CopyVolumeGroupBackupDetails
+    # **[Required]** The name of the destination region.
+    #
+    # Example: `us-ashburn-1`
+    #
+    # @return [String]
+    attr_accessor :destination_region
+
+    # A user-friendly name for the volume group backup. Does not have to be unique and it's changeable.
+    # Avoid entering confidential information.
+    #
+    # @return [String]
+    attr_accessor :display_name
+
+    # The OCID of the Key Management key in the destination region which will be the master encryption key
+    # for the copied volume group backup.
+    # If you do not specify this attribute the volume group backup will be encrypted with the Oracle-provided encryption
+    # key when it is copied to the destination region.
+    #
+    #
+    # For more information about the Key Management service and encryption keys, see
+    # [Overview of Key Management](https://docs.cloud.oracle.com/Content/KeyManagement/Concepts/keyoverview.htm) and
+    # [Using Keys](https://docs.cloud.oracle.com/Content/KeyManagement/Tasks/usingkeys.htm).
+    #
+    # @return [String]
+    attr_accessor :kms_key_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'destination_region': :'destinationRegion',
+        'display_name': :'displayName',
+        'kms_key_id': :'kmsKeyId'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'destination_region': :'String',
+        'display_name': :'String',
+        'kms_key_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] :destination_region The value to assign to the {#destination_region} property
+    # @option attributes [String] :display_name The value to assign to the {#display_name} property
+    # @option attributes [String] :kms_key_id The value to assign to the {#kms_key_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.destination_region = attributes[:'destinationRegion'] if attributes[:'destinationRegion']
+
+      raise 'You cannot provide both :destinationRegion and :destination_region' if attributes.key?(:'destinationRegion') && attributes.key?(:'destination_region')
+
+      self.destination_region = attributes[:'destination_region'] if attributes[:'destination_region']
+
+      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.kms_key_id = attributes[:'kmsKeyId'] if attributes[:'kmsKeyId']
+
+      raise 'You cannot provide both :kmsKeyId and :kms_key_id' if attributes.key?(:'kmsKeyId') && attributes.key?(:'kms_key_id')
+
+      self.kms_key_id = attributes[:'kms_key_id'] if attributes[:'kms_key_id']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable 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 &&
+        destination_region == other.destination_region &&
+        display_name == other.display_name &&
+        kms_key_id == other.kms_key_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
+      [destination_region, display_name, kms_key_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

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

@@ -7,7 +7,7 @@ require 'date'
 module OCI
   # CreateBootVolumeDetails model.
   class Core::Models::CreateBootVolumeDetails
-    # **[Required]** The availability domain of the boot volume.
+    # The availability domain of the volume. Omissible for cloning a volume. The new volume will be created in the availability domain of the source volume.
     #
     # Example: `Uocm:PHX-AD-1`
     #

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

@@ -7,6 +7,12 @@ require 'date'
 module OCI
   # CreateDhcpDetails model.
   class Core::Models::CreateDhcpDetails
+    DOMAIN_NAME_TYPE_ENUM = [
+      DOMAIN_NAME_TYPE_SUBNET_DOMAIN = 'SUBNET_DOMAIN'.freeze,
+      DOMAIN_NAME_TYPE_VCN_DOMAIN = 'VCN_DOMAIN'.freeze,
+      DOMAIN_NAME_TYPE_CUSTOM_DOMAIN = 'CUSTOM_DOMAIN'.freeze
+    ].freeze
+
     # **[Required]** The OCID of the compartment to contain the set of DHCP options.
     # @return [String]
     attr_accessor :compartment_id
@@ -41,6 +47,10 @@ module OCI
     # @return [String]
     attr_accessor :vcn_id
 
+    # The search domain name type of DHCP options
+    # @return [String]
+    attr_reader :domain_name_type
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -50,7 +60,8 @@ module OCI
         'display_name': :'displayName',
         'freeform_tags': :'freeformTags',
         'options': :'options',
-        'vcn_id': :'vcnId'
+        'vcn_id': :'vcnId',
+        'domain_name_type': :'domainNameType'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -64,7 +75,8 @@ module OCI
         'display_name': :'String',
         'freeform_tags': :'Hash<String, String>',
         'options': :'Array<OCI::Core::Models::DhcpOption>',
-        'vcn_id': :'String'
+        'vcn_id': :'String',
+        'domain_name_type': :'String'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -81,6 +93,7 @@ module OCI
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
     # @option attributes [Array<OCI::Core::Models::DhcpOption>] :options The value to assign to the {#options} property
     # @option attributes [String] :vcn_id The value to assign to the {#vcn_id} property
+    # @option attributes [String] :domain_name_type The value to assign to the {#domain_name_type} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 
@@ -118,10 +131,24 @@ module OCI
       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']
+
+      self.domain_name_type = attributes[:'domainNameType'] if attributes[:'domainNameType']
+
+      raise 'You cannot provide both :domainNameType and :domain_name_type' if attributes.key?(:'domainNameType') && attributes.key?(:'domain_name_type')
+
+      self.domain_name_type = attributes[:'domain_name_type'] if attributes[:'domain_name_type']
     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] domain_name_type Object to be assigned
+    def domain_name_type=(domain_name_type)
+      raise "Invalid value for 'domain_name_type': this must be one of the values in DOMAIN_NAME_TYPE_ENUM." if domain_name_type && !DOMAIN_NAME_TYPE_ENUM.include?(domain_name_type)
+
+      @domain_name_type = domain_name_type
+    end
+
     # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
 
@@ -136,7 +163,8 @@ module OCI
         display_name == other.display_name &&
         freeform_tags == other.freeform_tags &&
         options == other.options &&
-        vcn_id == other.vcn_id
+        vcn_id == other.vcn_id &&
+        domain_name_type == other.domain_name_type
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
@@ -152,7 +180,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [compartment_id, defined_tags, display_name, freeform_tags, options, vcn_id].hash
+      [compartment_id, defined_tags, display_name, freeform_tags, options, vcn_id, domain_name_type].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

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

@@ -7,7 +7,15 @@ require 'date'
 module OCI
   # CreateVlanDetails model.
   class Core::Models::CreateVlanDetails
-    # **[Required]** The availability domain of the VLAN.
+    # Controls whether the VLAN is regional or specific to an availability domain.
+    # A regional VLAN has the flexibility to implement failover across availability domains.
+    # Previously, all VLANs were AD-specific.
+    #
+    # To create a regional VLAN, omit this attribute. Resources created subsequently in this
+    # VLAN (such as a Compute instance) can be created in any availability domain in the region.
+    #
+    # To create an AD-specific VLAN, use this attribute to specify the availability domain.
+    # Resources created in this VLAN must be in that availability domain.
     #
     # Example: `Uocm:PHX-AD-1`
     #
@@ -17,8 +25,8 @@ module OCI
     # **[Required]** The range of IPv4 addresses that will be used for layer 3 communication with
     # hosts outside the VLAN. The CIDR must maintain the following rules -
     #
-    # a. The CIDR block is valid and correctly formatted.
-    # b. The new range is within one of the parent VCN ranges.
+    # 1. The CIDR block is valid and correctly formatted.
+    # 2. The new range is within one of the parent VCN ranges.
     #
     # Example: `192.0.2.0/24`
     #

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

@@ -7,7 +7,7 @@ require 'date'
 module OCI
   # CreateVolumeDetails model.
   class Core::Models::CreateVolumeDetails
-    # **[Required]** The availability domain of the volume.
+    # The availability domain of the volume. Omissible for cloning a volume. The new volume will be created in the availability domain of the source volume.
     #
     # Example: `Uocm:PHX-AD-1`
     #

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

@@ -31,6 +31,13 @@ module OCI
       LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
+    DOMAIN_NAME_TYPE_ENUM = [
+      DOMAIN_NAME_TYPE_SUBNET_DOMAIN = 'SUBNET_DOMAIN'.freeze,
+      DOMAIN_NAME_TYPE_VCN_DOMAIN = 'VCN_DOMAIN'.freeze,
+      DOMAIN_NAME_TYPE_CUSTOM_DOMAIN = 'CUSTOM_DOMAIN'.freeze,
+      DOMAIN_NAME_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
     # **[Required]** The OCID of the compartment containing the set of DHCP options.
     # @return [String]
     attr_accessor :compartment_id
@@ -80,6 +87,10 @@ module OCI
     # @return [String]
     attr_accessor :vcn_id
 
+    # The search domain name type of DHCP options
+    # @return [String]
+    attr_reader :domain_name_type
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -92,7 +103,8 @@ module OCI
         'lifecycle_state': :'lifecycleState',
         'options': :'options',
         'time_created': :'timeCreated',
-        'vcn_id': :'vcnId'
+        'vcn_id': :'vcnId',
+        'domain_name_type': :'domainNameType'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -109,7 +121,8 @@ module OCI
         'lifecycle_state': :'String',
         'options': :'Array<OCI::Core::Models::DhcpOption>',
         'time_created': :'DateTime',
-        'vcn_id': :'String'
+        'vcn_id': :'String',
+        'domain_name_type': :'String'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -129,6 +142,7 @@ module OCI
     # @option attributes [Array<OCI::Core::Models::DhcpOption>] :options The value to assign to the {#options} 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
+    # @option attributes [String] :domain_name_type The value to assign to the {#domain_name_type} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 
@@ -180,6 +194,12 @@ module OCI
       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']
+
+      self.domain_name_type = attributes[:'domainNameType'] if attributes[:'domainNameType']
+
+      raise 'You cannot provide both :domainNameType and :domain_name_type' if attributes.key?(:'domainNameType') && attributes.key?(:'domain_name_type')
+
+      self.domain_name_type = attributes[:'domain_name_type'] if attributes[:'domain_name_type']
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
     # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
@@ -197,6 +217,19 @@ module OCI
       # rubocop:enable Style/ConditionalAssignment
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] domain_name_type Object to be assigned
+    def domain_name_type=(domain_name_type)
+      # rubocop:disable Style/ConditionalAssignment
+      if domain_name_type && !DOMAIN_NAME_TYPE_ENUM.include?(domain_name_type)
+        OCI.logger.debug("Unknown value for 'domain_name_type' [" + domain_name_type + "]. Mapping to 'DOMAIN_NAME_TYPE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @domain_name_type = DOMAIN_NAME_TYPE_UNKNOWN_ENUM_VALUE
+      else
+        @domain_name_type = domain_name_type
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
     # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
 
@@ -214,7 +247,8 @@ module OCI
         lifecycle_state == other.lifecycle_state &&
         options == other.options &&
         time_created == other.time_created &&
-        vcn_id == other.vcn_id
+        vcn_id == other.vcn_id &&
+        domain_name_type == other.domain_name_type
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
@@ -230,7 +264,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [compartment_id, defined_tags, display_name, freeform_tags, id, lifecycle_state, options, time_created, vcn_id].hash
+      [compartment_id, defined_tags, display_name, freeform_tags, id, lifecycle_state, options, time_created, vcn_id, domain_name_type].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines