oci 2.14.0 → 2.15.0

data/lib/oci/container_engine/models/cluster_migrate_to_native_vcn_status.rb

@@ -0,0 +1,187 @@
+# 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'
+require 'logger'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # Information regarding a cluster's move to Native VCN.
+  class ContainerEngine::Models::ClusterMigrateToNativeVcnStatus
+    STATE_ENUM = [
+      STATE_NOT_STARTED = 'NOT_STARTED'.freeze,
+      STATE_REQUESTED = 'REQUESTED'.freeze,
+      STATE_IN_PROGRESS = 'IN_PROGRESS'.freeze,
+      STATE_PENDING_DECOMMISSION = 'PENDING_DECOMMISSION'.freeze,
+      STATE_COMPLETED = 'COMPLETED'.freeze,
+      STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    # The date and time the non-native VCN is due to be decommissioned.
+    # @return [DateTime]
+    attr_accessor :time_decommission_scheduled
+
+    # **[Required]** The current migration status of the cluster.
+    # @return [String]
+    attr_reader :state
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'time_decommission_scheduled': :'timeDecommissionScheduled',
+        'state': :'state'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'time_decommission_scheduled': :'DateTime',
+        'state': :'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 [DateTime] :time_decommission_scheduled The value to assign to the {#time_decommission_scheduled} property
+    # @option attributes [String] :state The value to assign to the {#state} 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.time_decommission_scheduled = attributes[:'timeDecommissionScheduled'] if attributes[:'timeDecommissionScheduled']
+
+      raise 'You cannot provide both :timeDecommissionScheduled and :time_decommission_scheduled' if attributes.key?(:'timeDecommissionScheduled') && attributes.key?(:'time_decommission_scheduled')
+
+      self.time_decommission_scheduled = attributes[:'time_decommission_scheduled'] if attributes[:'time_decommission_scheduled']
+
+      self.state = attributes[:'state'] if attributes[:'state']
+    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] state Object to be assigned
+    def state=(state)
+      # rubocop:disable Style/ConditionalAssignment
+      if state && !STATE_ENUM.include?(state)
+        OCI.logger.debug("Unknown value for 'state' [" + state + "]. Mapping to 'STATE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @state = STATE_UNKNOWN_ENUM_VALUE
+      else
+        @state = 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 &&
+        time_decommission_scheduled == other.time_decommission_scheduled &&
+        state == other.state
+    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
+      [time_decommission_scheduled, state].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/container_engine/models/create_node_pool_node_config_details.rb

@@ -12,6 +12,11 @@ module OCI
     # @return [Integer]
     attr_accessor :size
 
+    # The OCIDs of the Network Security Group(s) to associate nodes for this node pool with. For more information about NSGs, see {NetworkSecurityGroup}.
+    #
+    # @return [Array<String>]
+    attr_accessor :nsg_ids
+
     # **[Required]** The placement configurations for the node pool. Provide one placement
     # configuration for each availability domain in which you intend to launch a node.
     #
@@ -27,6 +32,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'size': :'size',
+        'nsg_ids': :'nsgIds',
         'placement_configs': :'placementConfigs'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -37,6 +43,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'size': :'Integer',
+        'nsg_ids': :'Array<String>',
         'placement_configs': :'Array<OCI::ContainerEngine::Models::NodePoolPlacementConfigDetails>'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -49,6 +56,7 @@ module OCI
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
     # @option attributes [Integer] :size The value to assign to the {#size} property
+    # @option attributes [Array<String>] :nsg_ids The value to assign to the {#nsg_ids} property
     # @option attributes [Array<OCI::ContainerEngine::Models::NodePoolPlacementConfigDetails>] :placement_configs The value to assign to the {#placement_configs} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
@@ -58,6 +66,12 @@ module OCI
 
       self.size = attributes[:'size'] if attributes[:'size']
 
+      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.placement_configs = attributes[:'placementConfigs'] if attributes[:'placementConfigs']
 
       raise 'You cannot provide both :placementConfigs and :placement_configs' if attributes.key?(:'placementConfigs') && attributes.key?(:'placement_configs')
@@ -77,6 +91,7 @@ module OCI
 
       self.class == other.class &&
         size == other.size &&
+        nsg_ids == other.nsg_ids &&
         placement_configs == other.placement_configs
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
@@ -93,7 +108,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [size, placement_configs].hash
+      [size, nsg_ids, placement_configs].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/container_engine/models/node_pool_node_config_details.rb

@@ -12,6 +12,11 @@ module OCI
     # @return [Integer]
     attr_accessor :size
 
+    # The OCIDs of the Network Security Group(s) to associate nodes for this node pool with. For more information about NSGs, see {NetworkSecurityGroup}.
+    #
+    # @return [Array<String>]
+    attr_accessor :nsg_ids
+
     # The placement configurations for the node pool. Provide one placement
     # configuration for each availability domain in which you intend to launch a node.
     #
@@ -27,6 +32,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'size': :'size',
+        'nsg_ids': :'nsgIds',
         'placement_configs': :'placementConfigs'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -37,6 +43,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'size': :'Integer',
+        'nsg_ids': :'Array<String>',
         'placement_configs': :'Array<OCI::ContainerEngine::Models::NodePoolPlacementConfigDetails>'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -49,6 +56,7 @@ module OCI
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
     # @option attributes [Integer] :size The value to assign to the {#size} property
+    # @option attributes [Array<String>] :nsg_ids The value to assign to the {#nsg_ids} property
     # @option attributes [Array<OCI::ContainerEngine::Models::NodePoolPlacementConfigDetails>] :placement_configs The value to assign to the {#placement_configs} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
@@ -58,6 +66,12 @@ module OCI
 
       self.size = attributes[:'size'] if attributes[:'size']
 
+      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.placement_configs = attributes[:'placementConfigs'] if attributes[:'placementConfigs']
 
       raise 'You cannot provide both :placementConfigs and :placement_configs' if attributes.key?(:'placementConfigs') && attributes.key?(:'placement_configs')
@@ -77,6 +91,7 @@ module OCI
 
       self.class == other.class &&
         size == other.size &&
+        nsg_ids == other.nsg_ids &&
         placement_configs == other.placement_configs
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
@@ -93,7 +108,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [size, placement_configs].hash
+      [size, nsg_ids, placement_configs].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/container_engine/models/update_node_pool_node_config_details.rb

@@ -12,6 +12,11 @@ module OCI
     # @return [Integer]
     attr_accessor :size
 
+    # The OCIDs of the Network Security Group(s) to associate nodes for this node pool with. For more information about NSGs, see {NetworkSecurityGroup}.
+    #
+    # @return [Array<String>]
+    attr_accessor :nsg_ids
+
     # The placement configurations for the node pool. Provide one placement
     # configuration for each availability domain in which you intend to launch a node.
     #
@@ -27,6 +32,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'size': :'size',
+        'nsg_ids': :'nsgIds',
         'placement_configs': :'placementConfigs'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -37,6 +43,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'size': :'Integer',
+        'nsg_ids': :'Array<String>',
         'placement_configs': :'Array<OCI::ContainerEngine::Models::NodePoolPlacementConfigDetails>'
         # rubocop:enable Style/SymbolLiteral
       }
@@ -49,6 +56,7 @@ module OCI
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
     # @option attributes [Integer] :size The value to assign to the {#size} property
+    # @option attributes [Array<String>] :nsg_ids The value to assign to the {#nsg_ids} property
     # @option attributes [Array<OCI::ContainerEngine::Models::NodePoolPlacementConfigDetails>] :placement_configs The value to assign to the {#placement_configs} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
@@ -58,6 +66,12 @@ module OCI
 
       self.size = attributes[:'size'] if attributes[:'size']
 
+      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.placement_configs = attributes[:'placementConfigs'] if attributes[:'placementConfigs']
 
       raise 'You cannot provide both :placementConfigs and :placement_configs' if attributes.key?(:'placementConfigs') && attributes.key?(:'placement_configs')
@@ -77,6 +91,7 @@ module OCI
 
       self.class == other.class &&
         size == other.size &&
+        nsg_ids == other.nsg_ids &&
         placement_configs == other.placement_configs
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
@@ -93,7 +108,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [size, placement_configs].hash
+      [size, nsg_ids, placement_configs].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/container_engine/models/work_request.rb

@@ -15,6 +15,7 @@ module OCI
       OPERATION_TYPE_NODEPOOL_CREATE = 'NODEPOOL_CREATE'.freeze,
       OPERATION_TYPE_NODEPOOL_UPDATE = 'NODEPOOL_UPDATE'.freeze,
       OPERATION_TYPE_NODEPOOL_DELETE = 'NODEPOOL_DELETE'.freeze,
+      OPERATION_TYPE_NODEPOOL_RECONCILE = 'NODEPOOL_RECONCILE'.freeze,
       OPERATION_TYPE_WORKREQUEST_CANCEL = 'WORKREQUEST_CANCEL'.freeze,
       OPERATION_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze

data/lib/oci/container_engine/models/work_request_operation_type.rb

@@ -10,6 +10,7 @@ module OCI
       WORK_REQUEST_OPERATION_TYPE_NODEPOOL_CREATE = 'NODEPOOL_CREATE'.freeze,
       WORK_REQUEST_OPERATION_TYPE_NODEPOOL_UPDATE = 'NODEPOOL_UPDATE'.freeze,
       WORK_REQUEST_OPERATION_TYPE_NODEPOOL_DELETE = 'NODEPOOL_DELETE'.freeze,
+      WORK_REQUEST_OPERATION_TYPE_NODEPOOL_RECONCILE = 'NODEPOOL_RECONCILE'.freeze,
       WORK_REQUEST_OPERATION_TYPE_WORKREQUEST_CANCEL = 'WORKREQUEST_CANCEL'.freeze
     ].freeze
   end

data/lib/oci/container_engine/models/work_request_summary.rb

@@ -15,6 +15,7 @@ module OCI
       OPERATION_TYPE_NODEPOOL_CREATE = 'NODEPOOL_CREATE'.freeze,
       OPERATION_TYPE_NODEPOOL_UPDATE = 'NODEPOOL_UPDATE'.freeze,
       OPERATION_TYPE_NODEPOOL_DELETE = 'NODEPOOL_DELETE'.freeze,
+      OPERATION_TYPE_NODEPOOL_RECONCILE = 'NODEPOOL_RECONCILE'.freeze,
       OPERATION_TYPE_WORKREQUEST_CANCEL = 'WORKREQUEST_CANCEL'.freeze,
       OPERATION_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze

data/lib/oci/core/blockstorage_client.rb

@@ -599,6 +599,75 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Creates a volume group backup copy in specified region. For general information about volume group backups,
+    # see [Overview of Block Volume Service Backups](https://docs.cloud.oracle.com/Content/Block/Concepts/blockvolumebackups.htm)
+    #
+    # @param [String] volume_group_backup_id The Oracle Cloud ID (OCID) that uniquely identifies the volume group backup.
+    #
+    # @param [OCI::Core::Models::CopyVolumeGroupBackupDetails] copy_volume_group_backup_details Request to create a cross-region copy of given volume group backup.
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @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 (for example, 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] :opc_request_id Unique identifier for the request.
+    #   If you need to contact Oracle about a particular request, please provide the request ID.
+    #
+    # @return [Response] A Response object with data of type {OCI::Core::Models::VolumeGroupBackup VolumeGroupBackup}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/core/copy_volume_group_backup.rb.html) to see an example of how to use copy_volume_group_backup API.
+    def copy_volume_group_backup(volume_group_backup_id, copy_volume_group_backup_details, opts = {})
+      logger.debug 'Calling operation BlockstorageClient#copy_volume_group_backup.' if logger
+
+      raise "Missing the required parameter 'volume_group_backup_id' when calling copy_volume_group_backup." if volume_group_backup_id.nil?
+      raise "Missing the required parameter 'copy_volume_group_backup_details' when calling copy_volume_group_backup." if copy_volume_group_backup_details.nil?
+      raise "Parameter value for 'volume_group_backup_id' must not be blank" if OCI::Internal::Util.blank_string?(volume_group_backup_id)
+
+      path = '/volumeGroupBackups/{volumeGroupBackupId}/actions/copy'.sub('{volumeGroupBackupId}', volume_group_backup_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # 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[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(copy_volume_group_backup_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'BlockstorageClient#copy_volume_group_backup') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::Core::Models::VolumeGroupBackup'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Creates a new boot volume in the specified compartment from an existing boot volume or a boot volume backup.
     # For general information about boot volumes, see [Boot Volumes](https://docs.cloud.oracle.com/iaas/Content/Block/Concepts/bootvolumes.htm).
     # You may optionally specify a *display name* for the volume, which is simply a friendly name or
@@ -990,7 +1059,7 @@ module OCI
 
     # Creates a new volume group in the specified compartment.
     # A volume group is a collection of volumes and may be created from a list of volumes, cloning an existing
-    # volume group, or by restoring a volume group backup. A volume group can contain up to 64 volumes.
+    # volume group, or by restoring a volume group backup.
     # You may optionally specify a *display name* for the volume group, which is simply a friendly name or
     # description. It does not have to be unique, and you can change it. Avoid entering confidential information.
     #