Releasing version 31.0.0

Releasing version 31.0.0

Apmconfig/ConfigClient.cs

@@ -63,7 +63,7 @@ public ConfigClient(IBasicAuthenticationDetailsProvider authenticationDetailsPro
         }
 
         /// <summary>
-        /// Creates a new Configuration item.
+        /// Creates a new configuration item.
         /// </summary>
         /// <param name="request">The request object containing the details to send. Required.</param>
         /// <param name="retryConfiguration">The retry configuration that will be used by to send this request. Optional.</param>
@@ -103,7 +103,7 @@ public async Task<CreateConfigResponse> CreateConfig(CreateConfigRequest request
         }
 
         /// <summary>
-        /// Deletes the specified configuration item
+        /// Deletes the configuration item identified by the OCID.
         /// </summary>
         /// <param name="request">The request object containing the details to send. Required.</param>
         /// <param name="retryConfiguration">The retry configuration that will be used by to send this request. Optional.</param>
@@ -143,7 +143,7 @@ public async Task<DeleteConfigResponse> DeleteConfig(DeleteConfigRequest request
         }
 
         /// <summary>
-        /// Get the configuration of the item identified by the OCID.
+        /// Gets the configuration item identified by the OCID.
         /// </summary>
         /// <param name="request">The request object containing the details to send. Required.</param>
         /// <param name="retryConfiguration">The retry configuration that will be used by to send this request. Optional.</param>
@@ -183,7 +183,7 @@ public async Task<GetConfigResponse> GetConfig(GetConfigRequest request, RetryCo
         }
 
         /// <summary>
-        /// Returns all configured items optionally filtered by configuration type
+        /// Returns all configuration items, which can optionally be filtered by configuration type.
         /// </summary>
         /// <param name="request">The request object containing the details to send. Required.</param>
         /// <param name="retryConfiguration">The retry configuration that will be used by to send this request. Optional.</param>
@@ -223,7 +223,7 @@ public async Task<ListConfigsResponse> ListConfigs(ListConfigsRequest request, R
         }
 
         /// <summary>
-        /// Updates the item.
+        /// Updates the details of the configuration item identified by the OCID.
         /// </summary>
         /// <param name="request">The request object containing the details to send. Required.</param>
         /// <param name="retryConfiguration">The retry configuration that will be used by to send this request. Optional.</param>

Apmconfig/models/Apdex.cs

@@ -17,20 +17,20 @@ namespace Oci.ApmconfigService.Models
 {
     /// <summary>
     /// An Apdex configuration rule.
-    /// The Apdex Score is computed based on how the response time of a span compares to two predefined threshold values.
-    /// The first threshold defines the maximum response time that can still be considered satisfactory for the end user.
-    /// The second one defines the maximum response time that can be considered tolerable. All times larger than that will
+    /// The Apdex score is computed based on how the response time of a span compares to two predefined threshold values.
+    /// The first threshold defines the maximum response time that is considered satisfactory for the end user.
+    /// The second one defines the maximum response time that is considered tolerable. All times larger than that will
     /// be considered frustrating for the end user.
     /// An Apdex configuration rule works by selecting a subset of spans based on a filter expression and applying the
     /// two threshold comparisons to compute a score for each of the selected spans.
-    /// The rule has a property \"isApplyToErrorSpans\" that controls whether or not to compute the Apdex for spans that have
-    /// have been marked as errors. If this property is set to true, then error spans will have their Apdex score computed
-    /// the same as non-error ones. If set to false, then computation for error spans will be skipped, and the score will
-    /// be set to \"frustrating\" regardless of the configured thresholds. The default is \"false\".
-    /// The property \"isEnabled\" controls whether an Apdex score is computed for the spans. Can be used to disable Apdex
-    /// scores for certain spans. The default is \"true\".
-    /// The property \"priority\" is used to define the importance of the rule when it's part of a rule set.
-    /// Lower values indicate a higher priority. Rules with higher priorities will be evaluated first in the rule set. The
+    /// The rule has an \"isApplyToErrorSpans\" property that controls whether or not to compute the Apdex for spans that
+    /// have been marked as errors. If this property is set to \"true\", then the Apdex score for error spans is computed in
+    /// the same way as for non-error ones. If set to \"false\", then computation for error spans is skipped, and the score
+    /// is set to \"frustrating\" regardless of the configured thresholds. The default is \"false\".
+    /// The \"isEnabled\" property controls whether or not an Apdex score is computed and can be used to disable Apdex
+    /// score for certain spans. The default is \"true\".
+    /// The \"priority\" property specifies the importance of the rule within a rule set.
+    /// Lower values indicate a higher priority. Rules with higher priorities are evaluated first in the rule set. The
     /// priority of the rules must be unique within a rule set.
     /// 
     /// </summary>
@@ -62,40 +62,40 @@ public class Apdex
         public System.Nullable<int> Priority { get; set; }
 
         /// <value>
-        /// Specifies if the Apdex rule will be computed for spans matching the rule. Can be used to make sure certain
-        /// spans don't get an Apdex score. The default is \"true\".
+        /// Specifies whether the Apdex score should be computed for spans matching the rule. This can be used to disable
+        /// Apdex score for spans that do not need or require it. The default is \"true\".
         /// 
         /// </value>
         [JsonProperty(PropertyName = "isEnabled")]
         public System.Nullable<bool> IsEnabled { get; set; }
 
         /// <value>
-        /// The maximum response time in milliseconds that will be considered satisfactory for the end user.
+        /// The maximum response time in milliseconds that is considered \"satisfactory\" for the end user.
         /// 
         /// </value>
         [JsonProperty(PropertyName = "satisfiedResponseTime")]
         public System.Nullable<int> SatisfiedResponseTime { get; set; }
 
         /// <value>
-        /// The maximum response time in milliseconds that will be considered tolerable for the end user. Response
-        /// times beyond this threshold will be considered frustrating.
+        /// The maximum response time in milliseconds that is considered \"tolerable\" for the end user. A response
+        /// time beyond this threshold is considered \"frustrating\".
         /// This value cannot be lower than \"satisfiedResponseTime\".
         /// 
         /// </value>
         [JsonProperty(PropertyName = "toleratingResponseTime")]
         public System.Nullable<int> ToleratingResponseTime { get; set; }
 
         /// <value>
-        /// If true, the rule will compute the actual Apdex score for spans that have been marked as errors. If false,
-        /// the rule will always set the Apdex for error spans to frustrating, regardless of the configured thresholds.
-        /// Default is false.
+        /// Specifies whether an Apdex score should be computed for error spans. Setting it to \"true\" means that the Apdex
+        /// score is computed in the usual way. Setting it to \"false\" skips the Apdex computation and sets the Apdex
+        /// score to \"frustrating\" regardless of the configured thresholds. The default is \"false\".
         /// 
         /// </value>
         [JsonProperty(PropertyName = "isApplyToErrorSpans")]
         public System.Nullable<bool> IsApplyToErrorSpans { get; set; }
 
         /// <value>
-        /// A user-friendly name that provides a short description this rule.
+        /// A user-friendly name that provides a short description of this rule.
         /// </value>
         [JsonProperty(PropertyName = "displayName")]
         public string DisplayName { get; set; }

Apmconfig/models/ApdexRules.cs

@@ -17,14 +17,14 @@ namespace Oci.ApmconfigService.Models
 {
     /// <summary>
     /// The set of Apdex rules to be used in Apdex computation. In the current version, only one rule set can exist in the
-    /// configuration. This may change in the future.
+    /// configuration.
     /// 
     /// </summary>
     public class ApdexRules : Config
     {
 
         /// <value>
-        /// The name by which this rule set can be displayed to the user.
+        /// The name by which the rule set is displayed to the end user.
         /// </value>
         [JsonProperty(PropertyName = "displayName")]
         public string DisplayName { get; set; }

Apmconfig/models/ApdexRulesSummary.cs

@@ -16,7 +16,7 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// The set of Apdex rules to be used in Apdex computation.
+    /// The set of Apdex rules used in Apdex computation.
     /// 
     /// </summary>
     public class ApdexRulesSummary : ConfigSummary
@@ -26,7 +26,7 @@ public class ApdexRulesSummary : ConfigSummary
         public System.Collections.Generic.List<Apdex> Rules { get; set; }
 
         /// <value>
-        /// The name by which this rule set can be displayed to the user.
+        /// The name by which the rule set is displayed to the end user.
         /// </value>
         [JsonProperty(PropertyName = "displayName")]
         public string DisplayName { get; set; }

Apmconfig/models/Config.cs

@@ -16,7 +16,7 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// A configuration item. This item has a number of mutually exclusive properties that can be used to set specific
+    /// A configuration item, which has a number of mutually exclusive properties that can be used to set specific
     /// portions of the configuration.
     /// 
     /// </summary>
@@ -25,7 +25,7 @@ public class Config
     {
 
         /// <value>
-        /// The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the configuration item. An OCID will be generated
+        /// The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the configuration item. An OCID is generated
         /// when the item is created.
         /// 
         /// </value>

Apmconfig/models/ConfigCollection.cs

@@ -16,7 +16,7 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// A collection of configuration entities
+    /// A collection of configuration items.
     /// </summary>
     public class ConfigCollection 
     {

Apmconfig/models/ConfigSummary.cs

@@ -16,15 +16,15 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// The request body used to update the Configuration entity. It must specify the data to update the item with.
+    /// A description of a configuration item. It specifes all the properties that define the configuration item.
     /// 
     /// </summary>
     [JsonConverter(typeof(ConfigSummaryModelConverter))]
     public class ConfigSummary 
     {
 
         /// <value>
-        /// The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the configuration item. An OCID will be generated
+        /// The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the configuration item. An OCID is generated
         /// when the item is created.
         /// 
         /// </value>

Apmconfig/models/CreateApdexRulesDetails.cs

@@ -17,8 +17,7 @@ namespace Oci.ApmconfigService.Models
 {
     /// <summary>
     /// The set of Apdex rules to be used in Apdex computation. In the current version, only one rule set may exist per
-    /// configuration, and attempting to create a rule set if it already exists will result in an error. This may change
-    /// in future releases.
+    /// configuration, and attempting to create a rule set if it already exists results in an error.
     /// 
     /// </summary>
     public class CreateApdexRulesDetails : CreateConfigDetails
@@ -32,7 +31,7 @@ public class CreateApdexRulesDetails : CreateConfigDetails
         public System.Collections.Generic.List<Apdex> Rules { get; set; }
 
         /// <value>
-        /// The name by which this rule set can be displayed to the user.
+        /// The name by which this rule set is displayed to the end user.
         /// </value>
         /// <remarks>
         /// Required

Apmconfig/models/CreateConfigDetails.cs

@@ -16,8 +16,8 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// The request body used to create new Configuration entities. It must specify the configuration type of the item to
-    /// create, as well as the actual data to populate the item with.
+    /// The request body used to create new configuration items. It must specify the configuration type of the item,
+    /// as well as the actual data to populate the item with.
     /// 
     /// </summary>
     [JsonConverter(typeof(CreateConfigDetailsModelConverter))]

Apmconfig/models/CreateMetricGroupDetails.cs

@@ -16,14 +16,15 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// A Metric Group.
+    /// A metric group defines a set of metrics to collect from a span. It uses a span filter to specify which spans to
+    /// process. The set is then published to a namespace, which is a product level subdivision of metrics.
     /// 
     /// </summary>
     public class CreateMetricGroupDetails : CreateConfigDetails
     {
 
         /// <value>
-        /// The name of this metric group
+        /// The name of the metric group.
         /// </value>
         /// <remarks>
         /// Required
@@ -34,7 +35,7 @@ public class CreateMetricGroupDetails : CreateConfigDetails
 
         /// <value>
         /// The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of a Span Filter. The filterId is mandatory for the creation
-        /// of MetricGroups. A filterId will be generated when a Span Filter is created.
+        /// of MetricGroups. A filterId is generated when a Span Filter is created.
         /// 
         /// </value>
         /// <remarks>
@@ -45,17 +46,22 @@ public class CreateMetricGroupDetails : CreateConfigDetails
         public string FilterId { get; set; }
 
         /// <value>
-        /// The namespace to write the metrics to
+        /// The namespace to which the metrics are published. It must be one of several predefined namespaces.
+        /// 
         /// </value>
         [JsonProperty(PropertyName = "namespace")]
         public string Namespace { get; set; }
 
         /// <value>
-        /// A list of dimensions for this metric
+        /// A list of dimensions for the metric. This variable should not be used.
         /// </value>
         [JsonProperty(PropertyName = "dimensions")]
         public System.Collections.Generic.List<Dimension> Dimensions { get; set; }
 
+        /// <value>
+        /// The list of metrics in this group.
+        /// 
+        /// </value>
         /// <remarks>
         /// Required
         /// </remarks>

Apmconfig/models/CreateSpanFilterDetails.cs

@@ -16,13 +16,13 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// A span filter is a named setting that specifies filter criteria to match a subset of the spans.
+    /// A named setting that specifies the filter criteria to match a subset of the spans.
     /// </summary>
     public class CreateSpanFilterDetails : CreateConfigDetails
     {
 
         /// <value>
-        /// The name by which this filter can be displayed in the UI.
+        /// The name by which the span filter can be displayed in the UI.
         /// </value>
         /// <remarks>
         /// Required

Apmconfig/models/Dimension.cs

@@ -16,14 +16,14 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// A dimension is a label that can be used to describe or group metrics.
+    /// A dimension is a label that is used to describe or group metrics.
     /// 
     /// </summary>
     public class Dimension 
     {
 
         /// <value>
-        /// The dimension name
+        /// The name of the dimension.
         /// </value>
         /// <remarks>
         /// Required
@@ -33,7 +33,7 @@ public class Dimension
         public string Name { get; set; }
 
         /// <value>
-        /// The source to populate the dimension. Must be NULL at the moment.
+        /// The source to populate the dimension. This must not be specified.
         /// 
         /// </value>
         [JsonProperty(PropertyName = "valueSource")]

Apmconfig/models/Metric.cs

@@ -16,14 +16,14 @@
 namespace Oci.ApmconfigService.Models
 {
     /// <summary>
-    /// A metric. This a quantitative measurement of an entity.
+    /// A metric is a quantitative measurement of an entity.
     /// 
     /// </summary>
     public class Metric 
     {
 
         /// <value>
-        /// The name of the metric
+        /// The name of the metric. This must be a known metric name.
         /// </value>
         /// <remarks>
         /// Required
@@ -33,19 +33,19 @@ public class Metric
         public string Name { get; set; }
 
         /// <value>
-        /// Must be NULL at the moment, and \"name\" must be a known metric.
+        /// This must not be set.
         /// </value>
         [JsonProperty(PropertyName = "valueSource")]
         public string ValueSource { get; set; }
 
         /// <value>
-        /// The unit of the metric
+        /// The unit of the metric.
         /// </value>
         [JsonProperty(PropertyName = "unit")]
         public string Unit { get; set; }
 
         /// <value>
-        /// A description of the metric
+        /// A description of the metric.
         /// </value>
         [JsonProperty(PropertyName = "description")]
         public string Description { get; set; }