Skip to content

Commit

Permalink
docs: Various updates
Browse files Browse the repository at this point in the history 
PiperOrigin-RevId: 624233552

Source-Link: googleapis/googleapis@1413b13

Source-Link: googleapis/googleapis-gen@fa02723
Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuTW9uaXRvcmluZy5WMy8uT3dsQm90LnlhbWwiLCJoIjoiZmEwMjcyM2NkYmNmMGRiNDRlYmRmZTQxODU4ZDBmZTQxMDA5NDVhZCJ9
  • Loading branch information
@gcf-owl-bot @jskeet
gcf-owl-bot[bot] authored and jskeet committed Apr 12, 2024
1 parent e99c510 commit dfa71a3
Show file tree
Hide file tree
Showing 14 changed files with 902 additions and 660 deletions.
7 changes: 4 additions & 3 deletions apis/Google.Cloud.Monitoring.V3/Google.Cloud.Monitoring.V3/Alert.g.cs
View file
Expand Up @@ -976,8 +976,8 @@ public enum Severity {
}

/// <summary>
/// A content string and a MIME type that describes the content string's
/// format.
/// Documentation that is included in the notifications and incidents
/// pertaining to this policy.
/// </summary>
[global::System.Diagnostics.DebuggerDisplayAttribute("{ToString(),nq}")]
public sealed partial class Documentation : pb::IMessage<Documentation>
Expand Down Expand Up @@ -2430,7 +2430,8 @@ public sealed partial class MetricThreshold : pb::IMessage<MetricThreshold>
private global::Google.Cloud.Monitoring.V3.AlertPolicy.Types.Condition.Types.EvaluationMissingData evaluationMissingData_ = global::Google.Cloud.Monitoring.V3.AlertPolicy.Types.Condition.Types.EvaluationMissingData.Unspecified;
/// <summary>
/// A condition control that determines how metric-threshold conditions
/// are evaluated when data stops arriving.
/// are evaluated when data stops arriving. To use this control, the value
/// of the `duration` field must be greater than or equal to 60 seconds.
/// </summary>
[global::System.Diagnostics.DebuggerNonUserCodeAttribute]
[global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
Expand Down
76 changes: 43 additions & 33 deletions apis/Google.Cloud.Monitoring.V3/Google.Cloud.Monitoring.V3/Common.g.cs
View file
Expand Up @@ -114,7 +114,7 @@ public enum ComparisonType {
}

/// <summary>
/// The tier of service for a Workspace. Please see the
/// The tier of service for a Metrics Scope. Please see the
/// [service tiers
/// documentation](https://cloud.google.com/monitoring/workspaces/tiers) for more
/// details.
Expand All @@ -127,18 +127,18 @@ public enum ServiceTier {
/// </summary>
[pbr::OriginalName("SERVICE_TIER_UNSPECIFIED")] Unspecified = 0,
/// <summary>
/// The Stackdriver Basic tier, a free tier of service that provides basic
/// The Cloud Monitoring Basic tier, a free tier of service that provides basic
/// features, a moderate allotment of logs, and access to built-in metrics.
/// A number of features are not available in this tier. For more details,
/// see [the service tiers
/// documentation](https://cloud.google.com/monitoring/workspaces/tiers).
/// </summary>
[pbr::OriginalName("SERVICE_TIER_BASIC")] Basic = 1,
/// <summary>
/// The Stackdriver Premium tier, a higher, more expensive tier of service
/// that provides access to all Stackdriver features, lets you use Stackdriver
/// with AWS accounts, and has a larger allotments for logs and metrics. For
/// more details, see [the service tiers
/// The Cloud Monitoring Premium tier, a higher, more expensive tier of service
/// that provides access to all Cloud Monitoring features, lets you use Cloud
/// Monitoring with AWS accounts, and has a larger allotments for logs and
/// metrics. For more details, see [the service tiers
/// documentation](https://cloud.google.com/monitoring/workspaces/tiers).
/// </summary>
[pbr::OriginalName("SERVICE_TIER_PREMIUM")] Premium = 2,
Expand Down Expand Up @@ -617,34 +617,44 @@ public enum ValueOneofCase {
}

/// <summary>
/// A closed time interval. It extends from the start time to the end time, and includes both: `[startTime, endTime]`. Valid time intervals depend on the [`MetricKind`](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors#MetricKind) of the metric value. The end time must not be earlier than the start time. When writing data points, the start time must not be more than 25 hours in the past and the end time must not be more than five minutes in the future.
/// Describes a time interval:
///
/// * For `GAUGE` metrics, the `startTime` value is technically optional; if
/// no value is specified, the start time defaults to the value of the
/// end time, and the interval represents a single point in time. If both
/// start and end times are specified, they must be identical. Such an
/// interval is valid only for `GAUGE` metrics, which are point-in-time
/// measurements. The end time of a new interval must be at least a
/// millisecond after the end time of the previous interval.
///
/// * For `DELTA` metrics, the start time and end time must specify a
/// non-zero interval, with subsequent points specifying contiguous and
/// non-overlapping intervals. For `DELTA` metrics, the start time of
/// the next interval must be at least a millisecond after the end time
/// of the previous interval.
///
/// * For `CUMULATIVE` metrics, the start time and end time must specify a
/// non-zero interval, with subsequent points specifying the same
/// start time and increasing end times, until an event resets the
/// cumulative value to zero and sets a new start time for the following
/// points. The new start time must be at least a millisecond after the
/// end time of the previous interval.
///
/// * The start time of a new interval must be at least a millisecond after the
/// end time of the previous interval because intervals are closed. If the
/// start time of a new interval is the same as the end time of the previous
/// interval, then data written at the new start time could overwrite data
/// written at the previous end time.
/// * Reads: A half-open time interval. It includes the end time but
/// excludes the start time: `(startTime, endTime]`. The start time
/// must be specified, must be earlier than the end time, and should be
/// no older than the data retention period for the metric.
/// * Writes: A closed time interval. It extends from the start time to the end
/// time,
/// and includes both: `[startTime, endTime]`. Valid time intervals
/// depend on the
/// [`MetricKind`](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors#MetricKind)
/// of the metric value. The end time must not be earlier than the start
/// time, and the end time must not be more than 25 hours in the past or more
/// than five minutes in the future.
/// * For `GAUGE` metrics, the `startTime` value is technically optional; if
/// no value is specified, the start time defaults to the value of the
/// end time, and the interval represents a single point in time. If both
/// start and end times are specified, they must be identical. Such an
/// interval is valid only for `GAUGE` metrics, which are point-in-time
/// measurements. The end time of a new interval must be at least a
/// millisecond after the end time of the previous interval.
/// * For `DELTA` metrics, the start time and end time must specify a
/// non-zero interval, with subsequent points specifying contiguous and
/// non-overlapping intervals. For `DELTA` metrics, the start time of
/// the next interval must be at least a millisecond after the end time
/// of the previous interval.
/// * For `CUMULATIVE` metrics, the start time and end time must specify a
/// non-zero interval, with subsequent points specifying the same
/// start time and increasing end times, until an event resets the
/// cumulative value to zero and sets a new start time for the following
/// points. The new start time must be at least a millisecond after the
/// end time of the previous interval.
/// * The start time of a new interval must be at least a millisecond after
/// the
/// end time of the previous interval because intervals are closed. If the
/// start time of a new interval is the same as the end time of the
/// previous interval, then data written at the new start time could
/// overwrite data written at the previous end time.
/// </summary>
[global::System.Diagnostics.DebuggerDisplayAttribute("{ToString(),nq}")]
public sealed partial class TimeInterval : pb::IMessage<TimeInterval>
Expand Down
19 changes: 11 additions & 8 deletions apis/Google.Cloud.Monitoring.V3/Google.Cloud.Monitoring.V3/GroupService.g.cs
View file
Expand Up @@ -168,8 +168,9 @@ public sealed partial class ListGroupsRequest : pb::IMessage<ListGroupsRequest>
public const int NameFieldNumber = 7;
private string name_ = "";
/// <summary>
/// Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name)
/// whose groups are to be listed. The format is:
/// Required. The
/// [project](https://cloud.google.com/monitoring/api/v3#project_name) whose
/// groups are to be listed. The format is:
///
/// projects/[PROJECT_ID_OR_NUMBER]
/// </summary>
Expand Down Expand Up @@ -1078,8 +1079,9 @@ public sealed partial class CreateGroupRequest : pb::IMessage<CreateGroupRequest
public const int NameFieldNumber = 4;
private string name_ = "";
/// <summary>
/// Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) in
/// which to create the group. The format is:
/// Required. The
/// [project](https://cloud.google.com/monitoring/api/v3#project_name) in which
/// to create the group. The format is:
///
/// projects/[PROJECT_ID_OR_NUMBER]
/// </summary>
Expand All @@ -1096,8 +1098,8 @@ public sealed partial class CreateGroupRequest : pb::IMessage<CreateGroupRequest
public const int GroupFieldNumber = 2;
private global::Google.Cloud.Monitoring.V3.Group group_;
/// <summary>
/// Required. A group definition. It is an error to define the `name` field because
/// the system assigns the name.
/// Required. A group definition. It is an error to define the `name` field
/// because the system assigns the name.
/// </summary>
[global::System.Diagnostics.DebuggerNonUserCodeAttribute]
[global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
Expand Down Expand Up @@ -1366,8 +1368,9 @@ public sealed partial class UpdateGroupRequest : pb::IMessage<UpdateGroupRequest
public const int GroupFieldNumber = 2;
private global::Google.Cloud.Monitoring.V3.Group group_;
/// <summary>
/// Required. The new definition of the group. All fields of the existing group,
/// excepting `name`, are replaced with the corresponding fields of this group.
/// Required. The new definition of the group. All fields of the existing
/// group, excepting `name`, are replaced with the corresponding fields of this
/// group.
/// </summary>
[global::System.Diagnostics.DebuggerNonUserCodeAttribute]
[global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
Expand Down

0 comments on commit dfa71a3

Please sign in to comment.