oci 2.5.3 → 2.5.4

data/lib/oci/dns/models/steering_policy_weighted_answer_data.rb

@@ -6,9 +6,14 @@ require 'date'
 module OCI
   # SteeringPolicyWeightedAnswerData model.
   class Dns::Models::SteeringPolicyWeightedAnswerData # rubocop:disable Metrics/LineLength
+    # An expression that is used to select a set of answers that match a condition. For example, answers with matching pool properties.
+    #
     # @return [String]
     attr_accessor :answer_condition
 
+    # **[Required]** The weight assigned to the set of selected answers. Answers with a higher weight will be served
+    # more frequently. Answers can be given a value between `0` and `255`.
+    #
     # @return [Integer]
     attr_accessor :value
 

data/lib/oci/dns/models/steering_policy_weighted_rule.rb

@@ -7,13 +7,22 @@ require_relative 'steering_policy_rule'
 module OCI
   # SteeringPolicyWeightedRule model.
   class Dns::Models::SteeringPolicyWeightedRule < Dns::Models::SteeringPolicyRule # rubocop:disable Metrics/LineLength
+    # An array of `caseConditions`. A rule may optionally include a sequence of cases defining alternate
+    # configurations for how it should behave during processing for any given DNS query. When a rule has
+    # no sequence of `cases`, it is always evaluated with the same configuration during processing. When
+    # a rule has an empty sequence of `cases`, it is always ignored during processing. When a rule has a
+    # non-empty sequence of `cases`, its behavior during processing is configured by the first matching
+    # `case` in the sequence. When a rule has no matching cases the rule is ignored. A rule case with no
+    # `caseCondition` always matches. A rule case with a `caseCondition` matches only when that expression
+    # evaluates to true for the given query.
+    #
     # @return [Array<OCI::Dns::Models::SteeringPolicyWeightedRuleCase>]
     attr_accessor :cases
 
     # Defines a default set of answer conditions and values that are applied to an answer when
     # `cases` is not defined for the rule or a matching case does not have any matching
-    # `answerCondition`s in its `answerData`. `defaultAnswerData` is **not** applied if `cases` is
-    # defined and there are no matching cases.
+    # `answerCondition`s in its `answerData`. `defaultAnswerData` is not applied if `cases` is
+    # defined and there are no matching cases. In this scenario, the next rule will be processed.
     #
     # @return [Array<OCI::Dns::Models::SteeringPolicyWeightedAnswerData>]
     attr_accessor :default_answer_data

data/lib/oci/dns/models/steering_policy_weighted_rule_case.rb

@@ -6,9 +6,17 @@ require 'date'
 module OCI
   # SteeringPolicyWeightedRuleCase model.
   class Dns::Models::SteeringPolicyWeightedRuleCase # rubocop:disable Metrics/LineLength
+    # An expression that uses conditions at the time of a DNS query to indicate
+    # whether a case matches. Conditions may include the geographical location, IP
+    # subnet, or ASN the DNS query originated. **Example:** If you have an
+    # office that uses the subnet `192.0.2.0/24` you could use a `caseCondition`
+    # expression `query.client.subnet in ('192.0.2.0/24')` to define a case that
+    # matches queries from that office.
+    #
     # @return [String]
     attr_accessor :case_condition
 
+    # An array of `SteeringPolicyWeightedAnswerData` objects.
     # @return [Array<OCI::Dns::Models::SteeringPolicyWeightedAnswerData>]
     attr_accessor :answer_data
 

data/lib/oci/dns/models/update_steering_policy_attachment_details.rb

@@ -5,9 +5,13 @@ require 'date'
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
   # The body for updating a steering policy attachment.
+  #
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Dns::Models::UpdateSteeringPolicyAttachmentDetails # rubocop:disable Metrics/LineLength
     # A user-friendly name for the steering policy attachment.
-    # Does not have to be unique, and it's changeable.
+    # Does not have to be unique and can be changed.
     # Avoid entering confidential information.
     #
     # @return [String]

data/lib/oci/dns/models/update_steering_policy_details.rb

@@ -7,7 +7,8 @@ module OCI
   # The body for updating a steering policy. New rules and answers provided in the request will
   # replace the existing rules and answers in the policy.
   #
-  # *Warning:* Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
   #
   class Dns::Models::UpdateSteeringPolicyDetails # rubocop:disable Metrics/LineLength
     TEMPLATE_ENUM = [
@@ -19,80 +20,90 @@ module OCI
       TEMPLATE_CUSTOM = 'CUSTOM'.freeze
     ].freeze
 
-    # A user-friendly name for the steering policy.
-    # Does not have to be unique, and it's changeable.
+    # A user-friendly name for the steering policy. Does not have to be unique and can be changed.
     # Avoid entering confidential information.
     #
     # @return [String]
     attr_accessor :display_name
 
-    # The Time To Live for responses from the steering policy, in seconds.
+    # The Time To Live (TTL) for responses from the steering policy, in seconds.
     # If not specified during creation, a value of 30 seconds will be used.
     #
     # @return [Integer]
     attr_accessor :ttl
 
     # The OCID of the health check monitor providing health data about the answers of the
-    # steering policy.
-    # A steering policy answer with `rdata` matching a monitored endpoint will use the health
-    # data of that endpoint.
-    # A steering policy answer with `rdata` not matching any monitored endpoint will be assumed
-    # healthy.
+    # steering policy. A steering policy answer with `rdata` matching a monitored endpoint
+    # will use the health data of that endpoint. A steering policy answer with `rdata` not
+    # matching any monitored endpoint will be assumed healthy.
+    #
+    #
+    # **Note:** To use the Health Check monitoring feature in a steering policy, a monitor
+    # must be created using the Health Checks service first. For more information on how to
+    # create a monitor, please see [Managing Health Checks](https://docs.cloud.oracle.com/iaas/Content/HealthChecks/Tasks/managinghealthchecks.htm).
     #
     # @return [String]
     attr_accessor :health_check_monitor_id
 
-    # The common pattern (or lack thereof) to which the steering policy adheres. This
-    # value restricts the possible configurations of rules, but thereby supports
-    # specifically tailored interfaces. Values other than \"CUSTOM\" require the rules to
-    # begin with an unconditional FILTER that keeps answers contingent upon
-    # `answer.isDisabled != true`, followed
-    # _if and only if the policy references a health check monitor_ by an unconditional
-    # HEALTH rule, and require the last rule to be an unconditional LIMIT.
-    # What must precede the LIMIT rule is determined by the template value:
-    # - FAILOVER requires exactly an unconditional PRIORITY rule that ranks answers by pool.
-    #   Each answer pool must have a unique priority value assigned to it. Answer data must
-    #   be defined in the `defaultAnswerData` property for the rule and the `cases` property
-    #   must not be defined.
-    # - LOAD_BALANCE requires exactly an unconditional WEIGHTED rule that shuffles answers
-    #   by name. Answer data must be defined in the `defaultAnswerData` property for the
-    #   rule and the `cases` property must not be defined.
-    # - ROUTE_BY_GEO requires exactly one PRIORITY rule that ranks answers by pool using the
-    #   geographical location of the client as a condition. Within that rule you may only
-    #   use `query.client.geoKey` in the `caseCondition` expressions for defining the cases.
-    #   For each case in the PRIORITY rule each answer pool must have a unique priority
-    #   value assigned to it. Answer data can only be defined within cases and
-    #   `defaultAnswerData` cannot be used in the PRIORITY rule.
-    # - ROUTE_BY_ASN requires exactly one PRIORITY rule that ranks answers by pool using the
-    #   ASN of the client as a condition. Within that rule you may only use
-    #   `query.client.asn` in the `caseCondition` expressions for defining the cases.
-    #   For each case in the PRIORITY rule each answer pool must have a unique priority
-    #   value assigned to it. Answer data can only be defined within cases and
-    #   `defaultAnswerData` cannot be used in the PRIORITY rule.
-    # - ROUTE_BY_IP requires exactly one PRIORITY rule that ranks answers by pool using the
-    #   IP subnet of the client as a condition. Within that rule you may only use
-    #   `query.client.address` in the `caseCondition` expressions for defining the cases.
-    #   For each case in the PRIORITY rule each answer pool must have a unique priority
-    #   value assigned to it. Answer data can only be defined within cases and
-    #   `defaultAnswerData` cannot be used in the PRIORITY rule.
-    # - CUSTOM allows an arbitrary configuration of rules.
-    #
-    # For an existing steering policy, the template value may be changed to any of the
-    # supported options but the resulting policy must conform to the requirements for the
-    # new template type or else a Bad Request error will be returned.
+    # A set of predefined rules based on the desired purpose of the steering policy. Each
+    # template utilizes Traffic Management's rules in a different order to produce the desired
+    # results when answering DNS queries.
+    #
+    #
+    # **Example:** The `FAILOVER` template determines answers by filtering the policy's answers
+    # using the `FILTER` rule first, then the following rules in succession: `HEALTH`, `PRIORITY`,
+    # and `LIMIT`. This gives the domain dynamic failover capability.
+    #
+    #
+    # It is **strongly recommended** to use a template other than `CUSTOM` when creating
+    # a steering policy.
+    #
+    #
+    # All templates require the rule order to begin with an unconditional `FILTER` rule that keeps
+    # answers contingent upon `answer.isDisabled != true`, except for `CUSTOM`. A defined
+    # `HEALTH` rule must follow the `FILTER` rule if the policy references a `healthCheckMonitorId`.
+    # The last rule of a template must must be a `LIMIT` rule. For more information about templates
+    # and code examples, see [Traffic Management API Guide](https://docs.cloud.oracle.com/iaas/Content/TrafficManagement/Concepts/trafficmanagementapi.htm).
+    #
+    # **Template Types**
+    #
+    # * `FAILOVER` - Uses health check information on your endpoints to determine which DNS answers
+    # to serve. If an endpoint fails a health check, the answer for that endpoint will be removed
+    # from the list of available answers until the endpoint is detected as healthy.
+    #
+    #
+    # * `LOAD_BALANCE` - Distributes web traffic to specified endpoints based on defined weights.
+    #
+    #
+    # * `ROUTE_BY_GEO` - Answers DNS queries based on the query's geographic location. For a list of geographic
+    # locations to route by, see [Traffic Management Geographic Locations](https://docs.cloud.oracle.com/iaas/Content/TrafficManagement/Reference/trafficmanagementgeo.htm).
+    #
+    #
+    # * `ROUTE_BY_ASN` - Answers DNS queries based on the query's originating ASN.
+    #
+    #
+    # * `ROUTE_BY_IP` - Answers DNS queries based on the query's IP address.
+    #
+    #
+    # * `CUSTOM` - Allows a customized configuration of rules.
     #
     # @return [String]
     attr_reader :template
 
-    # Simple key-value pair that is applied without any predefined name, type, or scope.
+    # 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: `{\"bar-key\": \"value\"}`
+    #
+    #
+    # **Example:** `{\"Department\": \"Finance\"}`
     #
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
-    # Usage of predefined tag keys. These predefined keys are scoped to a namespace.
-    # Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+    # 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
@@ -102,9 +113,10 @@ module OCI
     # @return [Array<OCI::Dns::Models::SteeringPolicyAnswer>]
     attr_accessor :answers
 
-    # The pipeline of rules that will be processed in sequence to reduce the pool of answers
+    # The series of rules that will be processed in sequence to reduce the pool of answers
     # to a response for any given request.
     #
+    #
     # The first rule receives a shuffled list of all answers, and every other rule receives
     # the list of answers emitted by the one preceding it. The last rule populates the
     # response.

data/lib/oci/dns/models/update_zone_details.rb

@@ -6,18 +6,23 @@ require 'date'
 module OCI
   # The body for updating a zone.
   #
-  # *Warning:* Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
   #
   class Dns::Models::UpdateZoneDetails # rubocop:disable Metrics/LineLength
-    # Simple key-value pair that is applied without any predefined name, type, or scope.
+    # 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: `{\"bar-key\": \"value\"}`
+    #
+    #
+    # **Example:** `{\"Department\": \"Finance\"}`
     #
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
-    # Usage of predefined tag keys. These predefined keys are scoped to a namespace.
-    # Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+    # 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

data/lib/oci/dns/models/zone.rb

@@ -7,7 +7,7 @@ require 'logger'
 module OCI
   # A DNS zone.
   #
-  # *Warning:* Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
   #
   class Dns::Models::Zone # rubocop:disable Metrics/LineLength
     ZONE_TYPE_ENUM = [
@@ -38,15 +38,20 @@ module OCI
     # @return [String]
     attr_accessor :compartment_id
 
-    # Simple key-value pair that is applied without any predefined name, type, or scope.
+    # 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: `{\"bar-key\": \"value\"}`
+    #
+    #
+    # **Example:** `{\"Department\": \"Finance\"}`
     #
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
-    # Usage of predefined tag keys. These predefined keys are scoped to a namespace.
-    # Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+    # 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

data/lib/oci/dns/models/zone_summary.rb

@@ -7,7 +7,7 @@ require 'logger'
 module OCI
   # A DNS zone.
   #
-  # *Warning:* Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
   #
   class Dns::Models::ZoneSummary # rubocop:disable Metrics/LineLength
     ZONE_TYPE_ENUM = [
@@ -38,15 +38,20 @@ module OCI
     # @return [String]
     attr_accessor :compartment_id
 
-    # Simple key-value pair that is applied without any predefined name, type, or scope.
+    # 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: `{\"bar-key\": \"value\"}`
+    #
+    #
+    # **Example:** `{\"Department\": \"Finance\"}`
     #
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
-    # Usage of predefined tag keys. These predefined keys are scoped to a namespace.
-    # Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+    # 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

data/lib/oci/object_storage/models/bucket.rb

@@ -9,8 +9,8 @@ module OCI
   # The compartment has policies that indicate what actions a user can perform on a bucket and all the objects in the bucket. For more
   # information, see [Managing Buckets](https://docs.cloud.oracle.com/Content/Object/Tasks/managingbuckets.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
+  # To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized,
+  # talk to an administrator. If you are 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).
   #
   class ObjectStorage::Models::Bucket # rubocop:disable Metrics/LineLength
@@ -27,7 +27,7 @@ module OCI
       STORAGE_TIER_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The namespace in which the bucket lives.
+    # **[Required]** The Object Storage namespace in which the bucket lives.
     # @return [String]
     attr_accessor :namespace
 
@@ -53,7 +53,7 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_created
 
-    # **[Required]** The entity tag for the bucket.
+    # **[Required]** The entity tag (ETag) for the bucket.
     # @return [String]
     attr_accessor :etag
 
@@ -66,10 +66,10 @@ module OCI
     # @return [String]
     attr_reader :public_access_type
 
-    # The type of storage tier of this bucket.
-    # A bucket is set to 'Standard' tier by default, which means the bucket will be put in the standard storage tier.
-    # When 'Archive' tier type is set explicitly, the bucket is put in the archive storage tier. The 'storageTier'
-    # property is immutable after bucket is created.
+    # The storage tier type assigned to the bucket. A bucket is set to 'Standard' tier by default, which means
+    # objects uploaded or copied to the bucket will be in the standard storage tier. When the 'Archive' tier type
+    # is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage.
+    # The 'storageTier' property is immutable after bucket is created.
     #
     # @return [String]
     attr_reader :storage_tier
@@ -88,11 +88,12 @@ module OCI
     # @return [Hash<String, Hash<String, Object>>]
     attr_accessor :defined_tags
 
-    # The OCID of a KMS key id used to call KMS to generate data key, decrypt the encrypted data key
+    # The OCID of a KMS key id used to call KMS to generate data key or decrypt the encrypted data key.
+    #
     # @return [String]
     attr_accessor :kms_key_id
 
-    # The entity tag for the live object lifecycle policy on the bucket.
+    # The entity tag (ETag) for the live object lifecycle policy on the bucket.
     # @return [String]
     attr_accessor :object_lifecycle_policy_etag
 
@@ -102,7 +103,7 @@ module OCI
     # @return [Integer]
     attr_accessor :approximate_count
 
-    # The approximate total size of all objects in the bucket. Size statistics are reported periodically. You will
+    # The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will
     # see a lag between what is displayed and the actual size of the bucket.
     #
     # @return [Integer]

data/lib/oci/object_storage/models/bucket_summary.rb

@@ -4,12 +4,12 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # 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
+  # To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized,
+  # talk to an administrator. If you are 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).
   #
   class ObjectStorage::Models::BucketSummary # rubocop:disable Metrics/LineLength
-    # **[Required]** The namespace in which the bucket lives.
+    # **[Required]** The Object Storage namespace in which the bucket lives.
     # @return [String]
     attr_accessor :namespace
 
@@ -31,7 +31,7 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_created
 
-    # **[Required]** The entity tag for the bucket.
+    # **[Required]** The entity tag (ETag) for the bucket.
     # @return [String]
     attr_accessor :etag
 

data/lib/oci/object_storage/models/commit_multipart_upload_details.rb

@@ -4,12 +4,12 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # 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
+  # To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized,
+  # talk to an administrator. If you are 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).
   #
   class ObjectStorage::Models::CommitMultipartUploadDetails # rubocop:disable Metrics/LineLength
-    # **[Required]** The part numbers and ETags for the parts to be committed.
+    # **[Required]** The part numbers and entity tags (ETags) for the parts to be committed.
     # @return [Array<OCI::ObjectStorage::Models::CommitMultipartUploadPartDetails>]
     attr_accessor :parts_to_commit
 

data/lib/oci/object_storage/models/commit_multipart_upload_part_details.rb

@@ -4,8 +4,8 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # 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
+  # To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized,
+  # talk to an administrator. If you are 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).
   #
   class ObjectStorage::Models::CommitMultipartUploadPartDetails # rubocop:disable Metrics/LineLength
@@ -13,7 +13,7 @@ module OCI
     # @return [Integer]
     attr_accessor :part_num
 
-    # **[Required]** The ETag returned when this part was uploaded.
+    # **[Required]** The entity tag (ETag) returned when this part was uploaded.
     # @return [String]
     attr_accessor :etag