oci 2.17.0 → 2.18.0

data/lib/oci/dns/dns_client.rb

@@ -100,7 +100,9 @@ module OCI
 
 
     # Moves a resolver into a different compartment along with its protected default view and any endpoints.
-    # Zones in the default view are not moved. Requires a `PRIVATE` scope query parameter.
+    #
+    # Zones in the default view are not moved. VCN-dedicated resolvers are initially created in the same compartment
+    # as their corresponding VCN, but can then be moved to a different compartment.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [OCI::Dns::Models::ChangeResolverCompartmentDetails] change_resolver_compartment_details Details for moving a resolver, along with its protected default view and endpoints, into a
@@ -348,8 +350,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Moves a view into a different compartment. Protected views cannot have their compartment changed. Requires a
-    # `PRIVATE` scope query parameter.
+    # Moves a view into a different compartment.
+    #
+    # To change the compartment of a protected view, change the compartment of its corresponding resolver.
     #
     # @param [String] view_id The OCID of the target view.
     # @param [OCI::Dns::Models::ChangeViewCompartmentDetails] change_view_compartment_details Details for moving a view into a different compartment.
@@ -431,11 +434,14 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Moves a zone into a different compartment. Protected zones cannot have their compartment changed. For private
-    # zones, the scope query parameter is required with a value of `PRIVATE`. When the zone name is provided as a
-    # path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
+    # Moves a zone into a different compartment.
     #
-    # **Note:** All SteeringPolicyAttachment objects associated with this zone will also be moved into the provided compartment.
+    # Protected zones cannot have their compartment changed. When the zone name is provided as a path
+    # parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is
+    # required.
+    #
+    # **Note:** All SteeringPolicyAttachment objects associated with this zone will also be moved into
+    # the provided compartment.
     #
     # @param [String] zone_id The OCID of the target zone.
     # @param [OCI::Dns::Models::ChangeZoneCompartmentDetails] change_zone_compartment_details Details for moving a zone into a different compartment.
@@ -517,7 +523,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new resolver endpoint. Requires a `PRIVATE` scope query parameter.
+    # Creates a new resolver endpoint in the same compartment as the resolver.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [OCI::Dns::Models::CreateResolverEndpointDetails] create_resolver_endpoint_details Details for creating a new resolver endpoint.
@@ -810,7 +816,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new view in the specified compartment. Requires a `PRIVATE` scope query parameter.
+    # Creates a new view in the specified compartment.
     #
     # @param [OCI::Dns::Models::CreateViewDetails] create_view_details Details for creating a new view.
     # @param [Hash] opts the optional parameters
@@ -883,11 +889,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new zone in the specified compartment. For global zones, if the `Content-Type` header for the request
-    # is `text/dns`, the `compartmentId` query parameter is required. `text/dns` for the `Content-Type` header is
-    # not supported for private zones. Query parameter scope with a value of `PRIVATE` is required when creating a
-    # private zone. Private zones must have a zone type of `PRIMARY`. Creating a private zone at or under
-    # `oraclevcn.com` within the default protected view of a VCN-dedicated resolver is not permitted.
+    # Creates a new zone in the specified compartment.
+    #
+    # Private zones must have a zone type of `PRIMARY`. Creating a private zone at or under `oraclevcn.com`
+    # within the default protected view of a VCN-dedicated resolver is not permitted.
     #
     # @param [OCI::Dns::Models::CreateZoneBaseDetails] create_zone_details Details for creating a new zone.
     # @param [Hash] opts the optional parameters
@@ -897,7 +902,10 @@ module OCI
     #   to contact Oracle about a particular request, please provide
     #   the request ID.
     #
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
@@ -955,9 +963,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes all records at the specified zone and domain. For private zones, the scope query parameter is
-    # required with a value of `PRIVATE`. When the zone name is provided as a path parameter and `PRIVATE` is used
-    # for the scope query parameter then the viewId query parameter is required.
+    # Deletes all records at the specified zone and domain.
+    #
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter
+    # then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [String] domain The target fully-qualified domain name (FQDN) within the target zone.
@@ -983,7 +992,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type nil
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/delete_domain_records.rb.html) to see an example of how to use delete_domain_records API.
     def delete_domain_records(zone_name_or_id, domain, opts = {})
@@ -1042,10 +1054,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified resolver endpoint. Note that attempting to delete a resolver endpoint in the
-    # DELETED lifecycle state will result in a `404` response to be consistent with other operations of the API.
-    # Resolver endpoints may not be deleted if they are referenced by a resolver rule. Requires a `PRIVATE` scope
-    # query parameter.
+    # Deletes the specified resolver endpoint.
+    #
+    # Note that attempting to delete a resolver endpoint in the DELETED lifecycle state will result in
+    # a `404` response to be consistent with other operations of the API. Resolver endpoints may not
+    # be deleted if they are referenced by a resolver rule.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [String] resolver_endpoint_name The name of the target resolver endpoint.
@@ -1126,8 +1139,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes all records in the specified RRSet. For private zones, the scope query parameter is required with a
-    # value of `PRIVATE`. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope
+    # Deletes all records in the specified RRSet.
+    #
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope
     # query parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
@@ -1152,7 +1166,10 @@ module OCI
     #   to contact Oracle about a particular request, please provide
     #   the request ID.
     #
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
@@ -1217,6 +1234,7 @@ module OCI
 
 
     # Deletes the specified steering policy.
+    #
     # A `204` response indicates that the delete has been successful.
     # Deletion will fail if the policy is attached to any zones. To detach a
     # policy from a zone, see `DeleteSteeringPolicyAttachment`.
@@ -1454,11 +1472,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified view. Note that attempting to delete a
-    # view in the DELETED lifecycleState will result in a `404` response to be
-    # consistent with other operations of the API. Views cannot be
+    # Deletes the specified view.
+    #
+    # Note that attempting to delete a view in the DELETED lifecycleState will result in a `404`
+    # response to be consistent with other operations of the API. Views cannot be
     # deleted if they are referenced by non-deleted zones or resolvers.
-    # Protected views cannot be deleted. Requires a `PRIVATE` scope query parameter.
+    # Protected views cannot be deleted.
     #
     # @param [String] view_id The OCID of the target view.
     # @param [Hash] opts the optional parameters
@@ -1536,10 +1555,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified zone and all its steering policy attachments. A `204` response indicates that the zone has
-    # been successfully deleted. Protected zones cannot be deleted. For private zones, the scope query parameter is
-    # required with a value of `PRIVATE`. When the zone name is provided as a path parameter and `PRIVATE` is used
-    # for the scope query parameter then the viewId query parameter is required.
+    # Deletes the specified zone and all its steering policy attachments.
+    #
+    # A `204` response indicates that the zone has been successfully deleted. Protected zones cannot be deleted.
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter
+    # then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [Hash] opts the optional parameters
@@ -1564,7 +1584,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type nil
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/delete_zone.rb.html) to see an example of how to use delete_zone API.
     def delete_zone(zone_name_or_id, opts = {})
@@ -1621,11 +1644,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a list of all records at the specified zone and domain. The results are sorted by `rtype` in
-    # alphabetical order by default. You can optionally filter and/or sort the results using the listed parameters.
-    # For private zones, the scope query parameter is required with a value of `PRIVATE`. When the zone name is
-    # provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query
-    # parameter is required.
+    # Gets a list of all records at the specified zone and domain.
+    #
+    # The results are sorted by `rtype` in alphabetical order by default. You can optionally filter and/or sort
+    # the results using the listed parameters. When the zone name is provided as a path parameter and `PRIVATE`
+    # is used for the scope query parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [String] domain The target fully-qualified domain name (FQDN) within the target zone.
@@ -1662,7 +1685,10 @@ module OCI
     #   Allowed values are: rtype, ttl
     # @option opts [String] :sort_order The order to sort the resources.
     #    (default to ASC)
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/get_domain_records.rb.html) to see an example of how to use get_domain_records API.
     def get_domain_records(zone_name_or_id, domain, opts = {})
@@ -1736,9 +1762,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets information about a specific resolver. Note that attempting to get a
-    # resolver in the DELETED lifecycleState will result in a `404` response to be
-    # consistent with other operations of the API. Requires a `PRIVATE` scope query parameter.
+    # Gets information about a specific resolver.
+    #
+    # Note that attempting to get a resolver in the DELETED lifecycleState will result in a `404`
+    # response to be consistent with other operations of the API.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [Hash] opts the optional parameters
@@ -1815,9 +1842,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets information about a specific resolver endpoint. Note that attempting to get a resolver endpoint
-    # in the DELETED lifecycle state will result in a `404` response to be consistent with other operations of the
-    # API. Requires a `PRIVATE` scope query parameter.
+    # Gets information about a specific resolver endpoint.
+    #
+    # Note that attempting to get a resolver endpoint in the DELETED lifecycle state will result
+    # in a `404` response to be consistent with other operations of the API.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [String] resolver_endpoint_name The name of the target resolver endpoint.
@@ -1897,10 +1925,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a list of all records in the specified RRSet. The results are sorted by `recordHash` by default. For
-    # private zones, the scope query parameter is required with a value of `PRIVATE`. When the zone name is
-    # provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query
-    # parameter is required.
+    # Gets a list of all records in the specified RRSet.
+    #
+    # The results are sorted by `recordHash` by default. When the zone name is provided as a path parameter
+    # and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [String] domain The target fully-qualified domain name (FQDN) within the target zone.
@@ -1928,7 +1956,10 @@ module OCI
     #
     # @option opts [String] :zone_version The version of the zone for which data is requested.
     #
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
@@ -2227,9 +2258,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets information about a specific view. Note that attempting to get a
+    # Gets information about a specific view.
+    #
+    # Note that attempting to get a
     # view in the DELETED lifecycleState will result in a `404` response to be
-    # consistent with other operations of the API. Requires a `PRIVATE` scope query parameter.
+    # consistent with other operations of the API.
     #
     # @param [String] view_id The OCID of the target view.
     # @param [Hash] opts the optional parameters
@@ -2306,9 +2339,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets information about the specified zone, including its creation date, zone type, and serial. For private
-    # zones, the scope query parameter is required with a value of `PRIVATE`. When the zone name is provided as a
-    # path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
+    # Gets information about the specified zone, including its creation date, zone type, and serial.
+    #
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query
+    # parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [Hash] opts the optional parameters
@@ -2331,7 +2365,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::Zone Zone}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/get_zone.rb.html) to see an example of how to use get_zone API.
     def get_zone(zone_name_or_id, opts = {})
@@ -2514,11 +2551,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets all records in the specified zone. The results are sorted by `domain` in alphabetical order by default.
-    # For more information about records, see [Resource Record (RR) TYPEs](https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4).
-    # For private zones, the scope query parameter is required with a value of `PRIVATE`. When the zone name is
-    # provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query
-    # parameter is required.
+    # Gets all records in the specified zone.
+    #
+    # The results are sorted by `domain` in alphabetical order by default. For more information about records,
+    # see [Resource Record (RR) TYPEs](https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4).
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter
+    # then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [Hash] opts the optional parameters
@@ -2557,7 +2595,10 @@ module OCI
     #   Allowed values are: domain, rtype, ttl
     # @option opts [String] :sort_order The order to sort the resources.
     #    (default to ASC)
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
@@ -2637,7 +2678,7 @@ module OCI
     # Gets a list of all endpoints within a resolver. The collection can be filtered by name or lifecycle state.
     # It can be sorted on creation time or name both in ASC or DESC order. Note that when no lifecycleState
     # query parameter is provided, the collection does not include resolver endpoints in the DELETED
-    # lifecycle state to be consistent with other operations of the API. Requires a `PRIVATE` scope query parameter.
+    # lifecycle state to be consistent with other operations of the API.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [Hash] opts the optional parameters
@@ -2730,12 +2771,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a list of all resolvers within a compartment. The collection can
-    # be filtered by display name, id, or lifecycle state. It can be sorted
-    # on creation time or displayName both in ASC or DESC order. Note that
-    # when no lifecycleState query parameter is provided, the collection
-    # does not include resolvers in the DELETED lifecycleState to be consistent
-    # with other operations of the API. Requires a `PRIVATE` scope query parameter.
+    # Gets a list of all resolvers within a compartment.
+    #
+    # The collection can be filtered by display name, id, or lifecycle state. It can be sorted
+    # on creation time or displayName both in ASC or DESC order. Note that when no lifecycleState
+    # query parameter is provided, the collection does not include resolvers in the DELETED
+    # lifecycleState to be consistent with other operations of the API.
     #
     # @param [String] compartment_id The OCID of the compartment the resource belongs to.
     # @param [Hash] opts the optional parameters
@@ -3159,12 +3200,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a list of all views within a compartment. The collection can
-    # be filtered by display name, id, or lifecycle state. It can be sorted
-    # on creation time or displayName both in ASC or DESC order. Note that
-    # when no lifecycleState query parameter is provided, the collection
-    # does not include views in the DELETED lifecycleState to be consistent
-    # with other operations of the API. Requires a `PRIVATE` scope query parameter.
+    # Gets a list of all views within a compartment.
+    #
+    # The collection can be filtered by display name, id, or lifecycle state. It can be sorted
+    # on creation time or displayName both in ASC or DESC order. Note that when no lifecycleState
+    # query parameter is provided, the collection does not include views in the DELETED
+    # lifecycleState to be consistent with other operations of the API.
     #
     # @param [String] compartment_id The OCID of the compartment the resource belongs to.
     # @param [Hash] opts the optional parameters
@@ -3329,8 +3370,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a list of all zones in the specified compartment. The collection can be filtered by name, time created,
-    # scope, associated view, and zone type. Filtering by view is only supported for private zones.
+    # Gets a list of all zones in the specified compartment.
+    #
+    # The collection can be filtered by name, time created, scope, associated view, and zone type.
+    # Filtering by view is only supported for private zones.
     #
     # @param [String] compartment_id The OCID of the compartment the resource belongs to.
     # @param [Hash] opts the optional parameters
@@ -3452,11 +3495,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates records in the specified zone at a domain. You can update one record or all records for the specified
-    # zone depending on the changes provided in the request body. You can also add or remove records using this
-    # function. For private zones, the scope query parameter is required with a value of `PRIVATE`. When the zone
-    # name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId
-    # query parameter is required.
+    # Updates records in the specified zone at a domain.
+    #
+    # You can update one record or all records for the specified zone depending on the changes provided in the
+    # request body. You can also add or remove records using this function. When the zone name is provided as
+    # a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is
+    # required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [String] domain The target fully-qualified domain name (FQDN) within the target zone.
@@ -3483,7 +3527,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/patch_domain_records.rb.html) to see an example of how to use patch_domain_records API.
     def patch_domain_records(zone_name_or_id, domain, patch_domain_records_details, opts = {})
@@ -3544,8 +3591,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates records in the specified RRSet. For private zones, the scope query parameter is required with a value
-    # of `PRIVATE`. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query
+    # Updates records in the specified RRSet.
+    #
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query
     # parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
@@ -3574,7 +3622,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/patch_rr_set.rb.html) to see an example of how to use patch_rr_set API.
     def patch_rr_set(zone_name_or_id, domain, rtype, patch_rr_set_details, opts = {})
@@ -3637,11 +3688,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates a collection of records in the specified zone. You can update one record or all records for the
-    # specified zone depending on the changes provided in the request body. You can also add or remove records
-    # using this function. For private zones, the scope query parameter is required with a value of `PRIVATE`. When
-    # the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the
-    # viewId query parameter is required.
+    # Updates a collection of records in the specified zone.
+    #
+    # You can update one record or all records for the specified zone depending on the changes provided in the
+    # request body. You can also add or remove records using this function. When the zone name is provided as
+    # a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is
+    # required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [OCI::Dns::Models::PatchZoneRecordsDetails] patch_zone_records_details The operations describing how to modify the collection of records.
@@ -3668,7 +3720,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/patch_zone_records.rb.html) to see an example of how to use patch_zone_records API.
     def patch_zone_records(zone_name_or_id, patch_zone_records_details, opts = {})
@@ -3727,12 +3782,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Replaces records in the specified zone at a domain with the records specified in the request body. If a
-    # specified record does not exist, it will be created. If the record exists, then it will be updated to
+    # Replaces records in the specified zone at a domain with the records specified in the request body.
+    #
+    # If a specified record does not exist, it will be created. If the record exists, then it will be updated to
     # represent the record in the body of the request. If a record in the zone does not exist in the request body,
-    # the record will be removed from the zone. For private zones, the scope query parameter is required with a
-    # value of `PRIVATE`. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope
-    # query parameter then the viewId query parameter is required.
+    # the record will be removed from the zone. When the zone name is provided as a path parameter and `PRIVATE`
+    # is used for the scope query parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [String] domain The target fully-qualified domain name (FQDN) within the target zone.
@@ -3759,7 +3814,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/update_domain_records.rb.html) to see an example of how to use update_domain_records API.
     def update_domain_records(zone_name_or_id, domain, update_domain_records_details, opts = {})
@@ -3820,7 +3878,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the specified resolver with your new information. Requires a `PRIVATE` scope query parameter.
+    # Updates the specified resolver with your new information.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [OCI::Dns::Models::UpdateResolverDetails] update_resolver_details New data for the resolver.
@@ -3901,7 +3959,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the specified resolver endpoint with your new information. Requires a `PRIVATE` scope query parameter.
+    # Updates the specified resolver endpoint with your new information.
     #
     # @param [String] resolver_id The OCID of the target resolver.
     # @param [String] resolver_endpoint_name The name of the target resolver endpoint.
@@ -3985,8 +4043,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Replaces records in the specified RRSet. For private zones, the scope query parameter is required with a
-    # value of `PRIVATE`. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope
+    # Replaces records in the specified RRSet.
+    #
+    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope
     # query parameter then the viewId query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
@@ -4015,7 +4074,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/update_rr_set.rb.html) to see an example of how to use update_rr_set API.
     def update_rr_set(zone_name_or_id, domain, rtype, update_rr_set_details, opts = {})
@@ -4321,7 +4383,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the specified view with your new information. Requires a `PRIVATE` scope query parameter.
+    # Updates the specified view with your new information.
     #
     # @param [String] view_id The OCID of the target view.
     # @param [OCI::Dns::Models::UpdateViewDetails] update_view_details New data for the view.
@@ -4402,11 +4464,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the zone with the specified information. Global secondary zones may have their external masters updated.
-    # For more information about secondary zone, see [Manage DNS Service Zone](https://docs.cloud.oracle.com/iaas/Content/DNS/Tasks/managingdnszones.htm).
-    # For private zones, the scope query parameter is required with a value of `PRIVATE`. When the zone name is
-    # provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query
-    # parameter is required.
+    # Updates the zone with the specified information.
+    #
+    # Global secondary zones may have their external masters updated. For more information about secondary
+    # zones, see [Manage DNS Service Zone](https://docs.cloud.oracle.com/iaas/Content/DNS/Tasks/managingdnszones.htm). When the zone name
+    # is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId
+    # query parameter is required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [OCI::Dns::Models::UpdateZoneDetails] update_zone_details New data for the zone.
@@ -4432,7 +4495,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::Zone Zone}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/update_zone.rb.html) to see an example of how to use update_zone API.
     def update_zone(zone_name_or_id, update_zone_details, opts = {})
@@ -4491,12 +4557,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Replaces records in the specified zone with the records specified in the request body. If a specified record
-    # does not exist, it will be created. If the record exists, then it will be updated to represent the record in
-    # the body of the request. If a record in the zone does not exist in the request body, the record will be
-    # removed from the zone. For private zones, the scope query parameter is required with a value of `PRIVATE`.
-    # When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then
-    # the viewId query parameter is required.
+    # Replaces records in the specified zone with the records specified in the request body.
+    #
+    # If a specified record does not exist, it will be created. If the record exists, then it will be updated
+    # to represent the record in the body of the request. If a record in the zone does not exist in the
+    # request body, the record will be removed from the zone. When the zone name is provided as a path
+    # parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is
+    # required.
     #
     # @param [String] zone_name_or_id The name or OCID of the target zone.
     # @param [OCI::Dns::Models::UpdateZoneRecordsDetails] update_zone_records_details A full list of records for the zone.
@@ -4522,7 +4589,10 @@ module OCI
     # @option opts [String] :scope Specifies to operate only on resources that have a matching DNS scope.
     #
     # @option opts [String] :view_id The OCID of the view the resource is associated with.
-    # @option opts [String] :compartment_id The OCID of the compartment the resource belongs to.
+    # @option opts [String] :compartment_id The OCID of the compartment the zone belongs to.
+    #
+    #   This parameter is deprecated and should be omitted.
+    #
     # @return [Response] A Response object with data of type {OCI::Dns::Models::RecordCollection RecordCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/dns/update_zone_records.rb.html) to see an example of how to use update_zone_records API.
     def update_zone_records(zone_name_or_id, update_zone_records_details, opts = {})