oci 2.0.6 → 2.0.7

data/lib/oci/dns/util.rb

@@ -0,0 +1,2 @@
+# Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
+

data/lib/oci/errors.rb

@@ -73,5 +73,25 @@ module OCI
         @work_request = work_request
       end
     end
+
+    # Raised when there is an error performing a multipart upload (either a new upload or resuming
+    # an existing upload).
+    class MultipartUploadError < StandardError
+      # An array containing the underlying errors which caused the failure
+      # @return [Array]
+      attr_reader :errors
+
+      # The ID of multipart upload against which the error occurred, if known. This may be useful for
+      # resuming uploads which failed because of intermittent issues (e.g. network connectivity or
+      # HTTP 5xx errors received from the service)
+      # @return [String]
+      attr_reader :upload_id
+
+      def initialize(message, errors = [], upload_id = nil)
+        super(message)
+        @errors = errors
+        @upload_id = upload_id
+      end
+    end
   end
 end

data/lib/oci/identity/identity_client.rb

@@ -2056,6 +2056,7 @@ module OCI
     # - Similarly, you can limit the results to just the memberships for a given group by specifying a `groupId`.
     # - You can set both the `userId` and `groupId` to determine if the specified user is in the specified group.
     # If the answer is no, the response is an empty list.
+    # - Although`userId` and `groupId` are not indvidually required, you must set one of them.
     # 
     # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
     #   

data/lib/oci/identity/models/create_dynamic_group_details.rb

@@ -3,7 +3,7 @@
 require 'date'
 
 module OCI
-  # Properties for creating a dynamic group
+  # Properties for creating a dynamic group.
   class Identity::Models::CreateDynamicGroupDetails
     # **[Required]** The OCID of the tenancy containing the group.
     # @return [String]
@@ -15,7 +15,9 @@ module OCI
     # @return [String]
     attr_accessor :name
 
-    # **[Required]** The matching rule to dynamically match an instance certificate to this dynamic group
+    # **[Required]** The matching rule to dynamically match an instance certificate to this dynamic group.
+    # For rule syntax, see [Managing Dynamic Groups](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Tasks/managingdynamicgroups.htm).
+    # 
     # @return [String]
     attr_accessor :matching_rule
 

data/lib/oci/identity/models/dynamic_group.rb

@@ -3,14 +3,15 @@
 require 'date'
 
 module OCI
-  # An dynamic group defines a matching rule. Every bare metal/vm instance is deployed with an instance certificate.
-  # The certificate contains metadata about the instance. It contains the instance OCID and the compartment OCID, along
+  # A dynamic group defines a matching rule. Every bare metal or virtual machine instance is deployed with an instance certificate.
+  # The certificate contains metadata about the instance. This includes the instance OCID and the compartment OCID, along
   # with a few other optional properties. When an API call is made using this instance certificate as the authenticator,
-  # the certificate may be matched to one or multiple dynamic groups. Depending on policies written against these
-  # dynamic groups, the instance will get access to that API.
+  # the certificate can be matched to one or multiple dynamic groups. The instance can then get access to the API
+  # based on the permissions granted in policies written for the dynamic groups.
   #
-  # This works like regular user/group memebership. But in that case the membership is a static relationship, whereas
-  # in dynamic group, the membership of an instance certificate to dynamic groups are determined during runtime.
+  # This works like regular user/group membership. But in that case, the membership is a static relationship, whereas
+  # in a dynamic group, the membership of an instance certificate to a dynamic group is determined during runtime.
+  # For more information, see [Managing Dynamic Groups](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Tasks/managingdynamicgroups.htm).
   #
   class Identity::Models::DynamicGroup
 
@@ -40,6 +41,8 @@ module OCI
     attr_accessor :description
 
     # **[Required]** A rule string that defines which instance certificates will be matched.
+    # For syntax, see [Managing Dynamic Groups](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Tasks/managingdynamicgroups.htm).
+    # 
     # @return [String]
     attr_accessor :matching_rule
 

data/lib/oci/identity/models/update_dynamic_group_details.rb

@@ -3,13 +3,15 @@
 require 'date'
 
 module OCI
-  # Properties for updating a dynamic group
+  # Properties for updating a dynamic group.
   class Identity::Models::UpdateDynamicGroupDetails
     # The description you assign to the dynamic group. Does not have to be unique, and it's changeable.
     # @return [String]
     attr_accessor :description
 
-    # The matching rule to dynamically match an instance certificate to this dynamic group
+    # The matching rule to dynamically match an instance certificate to this dynamic group.
+    # For rule syntax, see [Managing Dynamic Groups](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Tasks/managingdynamicgroups.htm).
+    # 
     # @return [String]
     attr_accessor :matching_rule
 

data/lib/oci/load_balancer/load_balancer.rb

@@ -22,6 +22,7 @@ require 'oci/load_balancer/models/create_backend_set_details'
 require 'oci/load_balancer/models/create_certificate_details'
 require 'oci/load_balancer/models/create_listener_details'
 require 'oci/load_balancer/models/create_load_balancer_details'
+require 'oci/load_balancer/models/create_path_route_set_details'
 require 'oci/load_balancer/models/health_check_result'
 require 'oci/load_balancer/models/health_checker'
 require 'oci/load_balancer/models/health_checker_details'
@@ -34,6 +35,10 @@ require 'oci/load_balancer/models/load_balancer_health_summary'
 require 'oci/load_balancer/models/load_balancer_policy'
 require 'oci/load_balancer/models/load_balancer_protocol'
 require 'oci/load_balancer/models/load_balancer_shape'
+require 'oci/load_balancer/models/path_match_type'
+require 'oci/load_balancer/models/path_route'
+require 'oci/load_balancer/models/path_route_set'
+require 'oci/load_balancer/models/path_route_set_details'
 require 'oci/load_balancer/models/ssl_configuration'
 require 'oci/load_balancer/models/ssl_configuration_details'
 require 'oci/load_balancer/models/session_persistence_configuration_details'
@@ -42,6 +47,7 @@ require 'oci/load_balancer/models/update_backend_set_details'
 require 'oci/load_balancer/models/update_health_checker_details'
 require 'oci/load_balancer/models/update_listener_details'
 require 'oci/load_balancer/models/update_load_balancer_details'
+require 'oci/load_balancer/models/update_path_route_set_details'
 require 'oci/load_balancer/models/work_request'
 require 'oci/load_balancer/models/work_request_error'
 

data/lib/oci/load_balancer/load_balancer_client.rb

@@ -317,6 +317,51 @@ module OCI
         :body => post_body)
     end
 
+    # Adds a path route set to a load balancer. For more information, see
+    # [Managing Request Routing](https://docs.us-phoenix-1.oraclecloud.com/Content/Balance/Tasks/managingrequest.htm).
+    # 
+    # @param [CreatePathRouteSetDetails] create_path_route_set_details The details of the path route set to add.
+    # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the load balancer to add the path route set to.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #    (default to )
+    # @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 (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type nil
+    def create_path_route_set(create_path_route_set_details, load_balancer_id, opts = {})
+      logger.debug "Calling operation LoadBalancerClient#create_path_route_set." if logger
+
+      fail "Missing the required parameter 'create_path_route_set_details' when calling create_path_route_set." if create_path_route_set_details.nil?
+      fail "Missing the required parameter 'load_balancer_id' when calling create_path_route_set." if load_balancer_id.nil?
+
+      path = "/loadBalancers/{loadBalancerId}/pathRouteSets".sub('{loadBalancerId}', load_balancer_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:'opc_request_id'] if opts[:'opc_request_id']
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_path_route_set_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
     # Removes a backend server from a given load balancer and backend set.
     # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the load balancer associated with the backend set and server.
     # @param [String] backend_set_name The name of the backend set associated with the backend server.
@@ -515,6 +560,49 @@ module OCI
         :body => post_body)
     end
 
+    # Deletes a path route set from the specified load balancer.
+    # 
+    # To delete a path route rule from a path route set, use the
+    # {#update_path_route_set update_path_route_set} operation.
+    # 
+    # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the load balancer associated with the path route set to delete.
+    # @param [String] path_route_set_name The name of the path route set to delete.
+    #   
+    #   Example: `path-route-set-001`
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #    (default to )
+    # @return [Response] A Response object with data of type nil
+    def delete_path_route_set(load_balancer_id, path_route_set_name, opts = {})
+      logger.debug "Calling operation LoadBalancerClient#delete_path_route_set." if logger
+
+      fail "Missing the required parameter 'load_balancer_id' when calling delete_path_route_set." if load_balancer_id.nil?
+      fail "Missing the required parameter 'path_route_set_name' when calling delete_path_route_set." if path_route_set_name.nil?
+
+      path = "/loadBalancers/{loadBalancerId}/pathRouteSets/{pathRouteSetName}".sub('{loadBalancerId}', load_balancer_id.to_s).sub('{pathRouteSetName}', path_route_set_name.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:'opc_request_id'] if opts[:'opc_request_id']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
     # Gets the specified backend server's configuration information.
     # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the load balancer associated with the backend set and server.
     # @param [String] backend_set_name The name of the backend set that includes the backend server.
@@ -795,6 +883,46 @@ module OCI
         :return_type => 'OCI::LoadBalancer::Models::LoadBalancerHealth')
     end
 
+    # Gets the specified path route set's configuration information.
+    # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the specified load balancer.
+    # @param [String] path_route_set_name The name of the path route set to retrieve.
+    #   
+    #   Example: `path-route-set-001`
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #    (default to )
+    # @return [Response] A Response object with data of type OCI::LoadBalancer::Models::PathRouteSet
+    def get_path_route_set(load_balancer_id, path_route_set_name, opts = {})
+      logger.debug "Calling operation LoadBalancerClient#get_path_route_set." if logger
+
+      fail "Missing the required parameter 'load_balancer_id' when calling get_path_route_set." if load_balancer_id.nil?
+      fail "Missing the required parameter 'path_route_set_name' when calling get_path_route_set." if path_route_set_name.nil?
+
+      path = "/loadBalancers/{loadBalancerId}/pathRouteSets/{pathRouteSetName}".sub('{loadBalancerId}', load_balancer_id.to_s).sub('{pathRouteSetName}', path_route_set_name.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:'opc_request_id'] if opts[:'opc_request_id']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OCI::LoadBalancer::Models::PathRouteSet')
+    end
+
     # Gets the details of a work request.
     # @param [String] work_request_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the work request to retrieve.
     # @param [Hash] opts the optional parameters
@@ -1064,6 +1192,43 @@ module OCI
         :return_type => 'Array<OCI::LoadBalancer::Models::LoadBalancer>')
     end
 
+    # Lists all path route sets associated with the specified load balancer.
+    # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the load balancer associated with the path route sets
+    #   to retrieve.
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #    (default to )
+    # @return [Response] A Response object with data of type Array<OCI::LoadBalancer::Models::PathRouteSet>
+    def list_path_route_sets(load_balancer_id, opts = {})
+      logger.debug "Calling operation LoadBalancerClient#list_path_route_sets." if logger
+
+      fail "Missing the required parameter 'load_balancer_id' when calling list_path_route_sets." if load_balancer_id.nil?
+
+      path = "/loadBalancers/{loadBalancerId}/pathRouteSets".sub('{loadBalancerId}', load_balancer_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:'opc_request_id'] if opts[:'opc_request_id']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OCI::LoadBalancer::Models::PathRouteSet>')
+    end
+
     # Lists the available load balancer policies.
     # @param [String] compartment_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment containing the load balancer policies to list.
     # @param [Hash] opts the optional parameters
@@ -1486,5 +1651,59 @@ module OCI
         :query_params => query_params,
         :body => post_body)
     end
+
+    # Overwrites an existing path route set on the specified load balancer. Use this operation to add, delete, or alter
+    # path route rules in a path route set.
+    # 
+    # To add a new path route rule to a path route set, the `pathRoutes` in the
+    # {#update_path_route_set_details update_path_route_set_details} object must include
+    # both the new path route rule to add and the existing path route rules to retain.
+    # 
+    # @param [UpdatePathRouteSetDetails] update_path_route_set_details The configuration details to update a path route set.
+    # @param [String] load_balancer_id The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the load balancer associated with the path route set to update.
+    # @param [String] path_route_set_name The name of the path route set to update.
+    #   
+    #   Example: `path-route-set-001`
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #    (default to )
+    # @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 (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type nil
+    def update_path_route_set(update_path_route_set_details, load_balancer_id, path_route_set_name, opts = {})
+      logger.debug "Calling operation LoadBalancerClient#update_path_route_set." if logger
+
+      fail "Missing the required parameter 'update_path_route_set_details' when calling update_path_route_set." if update_path_route_set_details.nil?
+      fail "Missing the required parameter 'load_balancer_id' when calling update_path_route_set." if load_balancer_id.nil?
+      fail "Missing the required parameter 'path_route_set_name' when calling update_path_route_set." if path_route_set_name.nil?
+
+      path = "/loadBalancers/{loadBalancerId}/pathRouteSets/{pathRouteSetName}".sub('{loadBalancerId}', load_balancer_id.to_s).sub('{pathRouteSetName}', path_route_set_name.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:'opc_request_id'] if opts[:'opc_request_id']
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(update_path_route_set_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
   end
 end

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

@@ -26,6 +26,14 @@ module OCI
     # @return [String]
     attr_accessor :name
 
+    # The name of the set of path-based routing rules, {PathRouteSet},
+    # applied to this listener's traffic.
+    # 
+    # Example: `path-route-set-001`
+    # 
+    # @return [String]
+    attr_accessor :path_route_set_name
+
     # **[Required]** The communication port for the listener.
     # 
     # Example: `80`
@@ -51,6 +59,7 @@ module OCI
     # @option attributes [OCI::LoadBalancer::Models::ConnectionConfiguration] :connectionConfiguration The value to assign to the {#connection_configuration} property
     # @option attributes [String] :defaultBackendSetName The value to assign to the {#default_backend_set_name} property
     # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [String] :pathRouteSetName The value to assign to the {#path_route_set_name} property
     # @option attributes [Integer] :port The value to assign to the {#port} property
     # @option attributes [String] :protocol The value to assign to the {#protocol} property
     # @option attributes [OCI::LoadBalancer::Models::SSLConfigurationDetails] :sslConfiguration The value to assign to the {#ssl_configuration} property
@@ -72,6 +81,10 @@ module OCI
         self.name = attributes[:'name']
       end
 
+      if attributes[:'pathRouteSetName']
+        self.path_route_set_name = attributes[:'pathRouteSetName']
+      end
+
       if attributes[:'port']
         self.port = attributes[:'port']
       end
@@ -94,6 +107,7 @@ module OCI
           connection_configuration == other_object.connection_configuration &&
           default_backend_set_name == other_object.default_backend_set_name &&
           name == other_object.name &&
+          path_route_set_name == other_object.path_route_set_name &&
           port == other_object.port &&
           protocol == other_object.protocol &&
           ssl_configuration == other_object.ssl_configuration
@@ -108,7 +122,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [connection_configuration, default_backend_set_name, name, port, protocol, ssl_configuration].hash
+      [connection_configuration, default_backend_set_name, name, path_route_set_name, port, protocol, ssl_configuration].hash
     end
 
     # Builds the object from hash
@@ -177,6 +191,7 @@ module OCI
         :'connection_configuration' => :'connectionConfiguration',
         :'default_backend_set_name' => :'defaultBackendSetName',
         :'name' => :'name',
+        :'path_route_set_name' => :'pathRouteSetName',
         :'port' => :'port',
         :'protocol' => :'protocol',
         :'ssl_configuration' => :'sslConfiguration'
@@ -189,6 +204,7 @@ module OCI
         :'connection_configuration' => :'OCI::LoadBalancer::Models::ConnectionConfiguration',
         :'default_backend_set_name' => :'String',
         :'name' => :'String',
+        :'path_route_set_name' => :'String',
         :'port' => :'Integer',
         :'protocol' => :'String',
         :'ssl_configuration' => :'OCI::LoadBalancer::Models::SSLConfigurationDetails'