diff --git a/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py index cccc98960a30..71f869b7b6d3 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py @@ -262,7 +262,8 @@ def list_alert_policies( ... pass Args: - name (str): The project whose alert policies are to be listed. The format is + name (str): Required. The project whose alert policies are to be listed. The format + is projects/[PROJECT_ID] @@ -372,7 +373,7 @@ def get_alert_policy( >>> response = client.get_alert_policy(name) Args: - name (str): The alerting policy to retrieve. The format is + name (str): Required. The alerting policy to retrieve. The format is projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID] retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -450,17 +451,17 @@ def create_alert_policy( >>> response = client.create_alert_policy(name, alert_policy) Args: - name (str): The project in which to create the alerting policy. The format is - ``projects/[PROJECT_ID]``. + name (str): Required. The project in which to create the alerting policy. The format + is ``projects/[PROJECT_ID]``. Note that this field names the parent container in which the alerting policy will be written, not the name of the created policy. The alerting policy that is returned will have a name that contains a normalized representation of this name as a prefix but adds a suffix of the form ``/alertPolicies/[POLICY_ID]``, identifying the policy in the container. - alert_policy (Union[dict, ~google.cloud.monitoring_v3.types.AlertPolicy]): The requested alerting policy. You should omit the ``name`` field in - this policy. The name will be returned in the new policy, including a - new [ALERT\_POLICY\_ID] value. + alert_policy (Union[dict, ~google.cloud.monitoring_v3.types.AlertPolicy]): Required. The requested alerting policy. You should omit the ``name`` + field in this policy. The name will be returned in the new policy, + including a new [ALERT\_POLICY\_ID] value. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.AlertPolicy` @@ -537,7 +538,7 @@ def delete_alert_policy( >>> client.delete_alert_policy(name) Args: - name (str): The alerting policy to delete. The format is: + name (str): Required. The alerting policy to delete. The format is: projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID] diff --git a/monitoring/google/cloud/monitoring_v3/gapic/enums.py b/monitoring/google/cloud/monitoring_v3/gapic/enums.py index 017d94fd6a42..921226b79a83 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/enums.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/enums.py @@ -52,17 +52,17 @@ class CalendarPeriod(enum.IntEnum): class ComparisonType(enum.IntEnum): """ - Specifies an ordering relationship on two arguments, here called left and - right. + Specifies an ordering relationship on two arguments, called ``left`` and + ``right``. Attributes: COMPARISON_UNSPECIFIED (int): No ordering relationship is specified. - COMPARISON_GT (int): The left argument is greater than the right argument. - COMPARISON_GE (int): The left argument is greater than or equal to the right argument. - COMPARISON_LT (int): The left argument is less than the right argument. - COMPARISON_LE (int): The left argument is less than or equal to the right argument. - COMPARISON_EQ (int): The left argument is equal to the right argument. - COMPARISON_NE (int): The left argument is not equal to the right argument. + COMPARISON_GT (int): True if the left argument is greater than the right argument. + COMPARISON_GE (int): True if the left argument is greater than or equal to the right argument. + COMPARISON_LT (int): True if the left argument is less than the right argument. + COMPARISON_LE (int): True if the left argument is less than or equal to the right argument. + COMPARISON_EQ (int): True if the left argument is equal to the right argument. + COMPARISON_NE (int): True if the left argument is not equal to the right argument. """ COMPARISON_UNSPECIFIED = 0 @@ -202,110 +202,125 @@ class UptimeCheckRegion(enum.IntEnum): class Aggregation(object): class Aligner(enum.IntEnum): """ - The Aligner describes how to bring the data points in a single - time series into temporal alignment. + The ``Aligner`` specifies the operation that will be applied to the data + points in each alignment period in a time series. Except for + ``ALIGN_NONE``, which specifies that no operation be applied, each + alignment operation replaces the set of data values in each alignment + period with a single value: the result of applying the operation to the + data values. An aligned time series has a single data value at the end + of each ``alignment_period``. + + An alignment operation can change the data type of the values, too. For + example, if you apply a counting operation to boolean values, the data + ``value_type`` in the original time series is ``BOOLEAN``, but the + ``value_type`` in the aligned result is ``INT64``. Attributes: - ALIGN_NONE (int): No alignment. Raw data is returned. Not valid if cross-time - series reduction is requested. The value type of the result is - the same as the value type of the input. - ALIGN_DELTA (int): Align and convert to delta metric type. This alignment is valid for - cumulative metrics and delta metrics. Aligning an existing delta metric - to a delta metric requires that the alignment period be increased. The - value type of the result is the same as the value type of the input. - - One can think of this aligner as a rate but without time units; that is, - the output is conceptually (second\_point - first\_point). - ALIGN_RATE (int): Align and convert to a rate. This alignment is valid for cumulative - metrics and delta metrics with numeric values. The output is a gauge - metric with value type ``DOUBLE``. - - One can think of this aligner as conceptually providing the slope of the - line that passes through the value at the start and end of the window. - In other words, this is conceptually ((y1 - y0)/(t1 - t0)), and the - output unit is one that has a "/time" dimension. - - If, by rate, you are looking for percentage change, see the - ``ALIGN_PERCENT_CHANGE`` aligner option. - ALIGN_INTERPOLATE (int): Align by interpolating between adjacent points around the - period boundary. This alignment is valid for gauge - metrics with numeric values. The value type of the result is the same - as the value type of the input. - ALIGN_NEXT_OLDER (int): Align by shifting the oldest data point before the period - boundary to the boundary. This alignment is valid for gauge - metrics. The value type of the result is the same as the - value type of the input. - ALIGN_MIN (int): Align time series via aggregation. The resulting data point in - the alignment period is the minimum of all data points in the - period. This alignment is valid for gauge and delta metrics with numeric - values. The value type of the result is the same as the value - type of the input. - ALIGN_MAX (int): Align time series via aggregation. The resulting data point in - the alignment period is the maximum of all data points in the - period. This alignment is valid for gauge and delta metrics with numeric - values. The value type of the result is the same as the value - type of the input. - ALIGN_MEAN (int): Align time series via aggregation. The resulting data point in the - alignment period is the average or arithmetic mean of all data points in - the period. This alignment is valid for gauge and delta metrics with - numeric values. The value type of the output is ``DOUBLE``. - ALIGN_COUNT (int): Align time series via aggregation. The resulting data point in the - alignment period is the count of all data points in the period. This - alignment is valid for gauge and delta metrics with numeric or Boolean - values. The value type of the output is ``INT64``. - ALIGN_SUM (int): Align time series via aggregation. The resulting data point in - the alignment period is the sum of all data points in the - period. This alignment is valid for gauge and delta metrics with numeric - and distribution values. The value type of the output is the - same as the value type of the input. - ALIGN_STDDEV (int): Align time series via aggregation. The resulting data point in the - alignment period is the standard deviation of all data points in the - period. This alignment is valid for gauge and delta metrics with numeric - values. The value type of the output is ``DOUBLE``. - ALIGN_COUNT_TRUE (int): Align time series via aggregation. The resulting data point in the - alignment period is the count of True-valued data points in the period. - This alignment is valid for gauge metrics with Boolean values. The value - type of the output is ``INT64``. - ALIGN_COUNT_FALSE (int): Align time series via aggregation. The resulting data point in the - alignment period is the count of False-valued data points in the period. - This alignment is valid for gauge metrics with Boolean values. The value - type of the output is ``INT64``. - ALIGN_FRACTION_TRUE (int): Align time series via aggregation. The resulting data point in the - alignment period is the fraction of True-valued data points in the - period. This alignment is valid for gauge metrics with Boolean values. - The output value is in the range [0, 1] and has value type ``DOUBLE``. - ALIGN_PERCENTILE_99 (int): Align time series via aggregation. The resulting data point in the - alignment period is the 99th percentile of all data points in the - period. This alignment is valid for gauge and delta metrics with - distribution values. The output is a gauge metric with value type + ALIGN_NONE (int): No alignment. Raw data is returned. Not valid if cross-series reduction + is requested. The ``value_type`` of the result is the same as the + ``value_type`` of the input. + ALIGN_DELTA (int): Align and convert to ``DELTA``. The output is ``delta = y1 - y0``. + + This alignment is valid for ``CUMULATIVE`` and ``DELTA`` metrics. If the + selected alignment period results in periods with no data, then the + aligned value for such a period is created by interpolation. The + ``value_type`` of the aligned result is the same as the ``value_type`` + of the input. + ALIGN_RATE (int): Align and convert to a rate. The result is computed as + ``rate = (y1 - y0)/(t1 - t0)``, or "delta over time". Think of this + aligner as providing the slope of the line that passes through the value + at the start and at the end of the ``alignment_period``. + + This aligner is valid for ``CUMULATIVE`` and ``DELTA`` metrics with + numeric values. If the selected alignment period results in periods with + no data, then the aligned value for such a period is created by + interpolation. The output is a ``GAUGE`` metric with ``value_type`` ``DOUBLE``. - ALIGN_PERCENTILE_95 (int): Align time series via aggregation. The resulting data point in the - alignment period is the 95th percentile of all data points in the - period. This alignment is valid for gauge and delta metrics with - distribution values. The output is a gauge metric with value type - ``DOUBLE``. - ALIGN_PERCENTILE_50 (int): Align time series via aggregation. The resulting data point in the - alignment period is the 50th percentile of all data points in the - period. This alignment is valid for gauge and delta metrics with - distribution values. The output is a gauge metric with value type - ``DOUBLE``. - ALIGN_PERCENTILE_05 (int): Align time series via aggregation. The resulting data point in the - alignment period is the 5th percentile of all data points in the period. - This alignment is valid for gauge and delta metrics with distribution - values. The output is a gauge metric with value type ``DOUBLE``. - ALIGN_PERCENT_CHANGE (int): Align and convert to a percentage change. This alignment is valid for - gauge and delta metrics with numeric values. This alignment conceptually - computes the equivalent of "((current - previous)/previous)\*100" where - previous value is determined based on the alignmentPeriod. In the event - that previous is 0 the calculated value is infinity with the exception - that if both (current - previous) and previous are 0 the calculated - value is 0. A 10 minute moving mean is computed at each point of the - time window prior to the above calculation to smooth the metric and - prevent false positives from very short lived spikes. Only applicable - for data that is >= 0. Any values < 0 are treated as no data. While - delta metrics are accepted by this alignment special care should be - taken that the values for the metric will always be positive. The output - is a gauge metric with value type ``DOUBLE``. + + If, by "rate", you mean "percentage change", see the + ``ALIGN_PERCENT_CHANGE`` aligner instead. + ALIGN_INTERPOLATE (int): Align by interpolating between adjacent points around the alignment + period boundary. This aligner is valid for ``GAUGE`` metrics with + numeric values. The ``value_type`` of the aligned result is the same as + the ``value_type`` of the input. + ALIGN_NEXT_OLDER (int): Align by moving the most recent data point before the end of the + alignment period to the boundary at the end of the alignment period. + This aligner is valid for ``GAUGE`` metrics. The ``value_type`` of the + aligned result is the same as the ``value_type`` of the input. + ALIGN_MIN (int): Align the time series by returning the minimum value in each alignment + period. This aligner is valid for ``GAUGE`` and ``DELTA`` metrics with + numeric values. The ``value_type`` of the aligned result is the same as + the ``value_type`` of the input. + ALIGN_MAX (int): Align the time series by returning the maximum value in each alignment + period. This aligner is valid for ``GAUGE`` and ``DELTA`` metrics with + numeric values. The ``value_type`` of the aligned result is the same as + the ``value_type`` of the input. + ALIGN_MEAN (int): Align the time series by returning the mean value in each alignment + period. This aligner is valid for ``GAUGE`` and ``DELTA`` metrics with + numeric values. The ``value_type`` of the aligned result is ``DOUBLE``. + ALIGN_COUNT (int): Align the time series by returning the number of values in each + alignment period. This aligner is valid for ``GAUGE`` and ``DELTA`` + metrics with numeric or Boolean values. The ``value_type`` of the + aligned result is ``INT64``. + ALIGN_SUM (int): Align the time series by returning the sum of the values in each + alignment period. This aligner is valid for ``GAUGE`` and ``DELTA`` + metrics with numeric and distribution values. The ``value_type`` of the + aligned result is the same as the ``value_type`` of the input. + ALIGN_STDDEV (int): Align the time series by returning the standard deviation of the values + in each alignment period. This aligner is valid for ``GAUGE`` and + ``DELTA`` metrics with numeric values. The ``value_type`` of the output + is ``DOUBLE``. + ALIGN_COUNT_TRUE (int): Align the time series by returning the number of ``True`` values in each + alignment period. This aligner is valid for ``GAUGE`` metrics with + Boolean values. The ``value_type`` of the output is ``INT64``. + ALIGN_COUNT_FALSE (int): Align the time series by returning the number of ``False`` values in + each alignment period. This aligner is valid for ``GAUGE`` metrics with + Boolean values. The ``value_type`` of the output is ``INT64``. + ALIGN_FRACTION_TRUE (int): Align the time series by returning the ratio of the number of ``True`` + values to the total number of values in each alignment period. This + aligner is valid for ``GAUGE`` metrics with Boolean values. The output + value is in the range [0.0, 1.0] and has ``value_type`` ``DOUBLE``. + ALIGN_PERCENTILE_99 (int): Align the time series by using `percentile + aggregation `__. The resulting + data point in each alignment period is the 99th percentile of all data + points in the period. This aligner is valid for ``GAUGE`` and ``DELTA`` + metrics with distribution values. The output is a ``GAUGE`` metric with + ``value_type`` ``DOUBLE``. + ALIGN_PERCENTILE_95 (int): Align the time series by using `percentile + aggregation `__. The resulting + data point in each alignment period is the 95th percentile of all data + points in the period. This aligner is valid for ``GAUGE`` and ``DELTA`` + metrics with distribution values. The output is a ``GAUGE`` metric with + ``value_type`` ``DOUBLE``. + ALIGN_PERCENTILE_50 (int): Align the time series by using `percentile + aggregation `__. The resulting + data point in each alignment period is the 50th percentile of all data + points in the period. This aligner is valid for ``GAUGE`` and ``DELTA`` + metrics with distribution values. The output is a ``GAUGE`` metric with + ``value_type`` ``DOUBLE``. + ALIGN_PERCENTILE_05 (int): Align the time series by using `percentile + aggregation `__. The resulting + data point in each alignment period is the 5th percentile of all data + points in the period. This aligner is valid for ``GAUGE`` and ``DELTA`` + metrics with distribution values. The output is a ``GAUGE`` metric with + ``value_type`` ``DOUBLE``. + ALIGN_PERCENT_CHANGE (int): Align and convert to a percentage change. This aligner is valid for + ``GAUGE`` and ``DELTA`` metrics with numeric values. This alignment + returns ``((current - previous)/previous) * 100``, where the value of + ``previous`` is determined based on the ``alignment_period``. + + If the values of ``current`` and ``previous`` are both 0, then the + returned value is 0. If only ``previous`` is 0, the returned value is + infinity. + + A 10-minute moving mean is computed at each point of the alignment + period prior to the above calculation to smooth the metric and prevent + false positives from very short-lived spikes. The moving mean is only + applicable for data whose values are ``>= 0``. Any values ``< 0`` are + treated as a missing datapoint, and are ignored. While ``DELTA`` metrics + are accepted by this alignment, special care should be taken that the + values for the metric will always be positive. The output is a ``GAUGE`` + metric with ``value_type`` ``DOUBLE``. """ ALIGN_NONE = 0 @@ -330,62 +345,71 @@ class Aligner(enum.IntEnum): class Reducer(enum.IntEnum): """ - A Reducer describes how to aggregate data points from multiple - time series into a single time series. + A Reducer operation describes how to aggregate data points from multiple + time series into a single time series, where the value of each data point + in the resulting series is a function of all the already aligned values in + the input time series. Attributes: - REDUCE_NONE (int): No cross-time series reduction. The output of the aligner is + REDUCE_NONE (int): No cross-time series reduction. The output of the ``Aligner`` is returned. - REDUCE_MEAN (int): Reduce by computing the mean across time series for each alignment - period. This reducer is valid for delta and gauge metrics with numeric - or distribution values. The value type of the output is ``DOUBLE``. - REDUCE_MIN (int): Reduce by computing the minimum across time series for each - alignment period. This reducer is valid for delta and - gauge metrics with numeric values. The value type of the output - is the same as the value type of the input. - REDUCE_MAX (int): Reduce by computing the maximum across time series for each - alignment period. This reducer is valid for delta and - gauge metrics with numeric values. The value type of the output - is the same as the value type of the input. - REDUCE_SUM (int): Reduce by computing the sum across time series for each - alignment period. This reducer is valid for delta and - gauge metrics with numeric and distribution values. The value type of - the output is the same as the value type of the input. - REDUCE_STDDEV (int): Reduce by computing the standard deviation across time series for each - alignment period. This reducer is valid for delta and gauge metrics with - numeric or distribution values. The value type of the output is + REDUCE_MEAN (int): Reduce by computing the mean value across time series for each alignment + period. This reducer is valid for ``DELTA`` and ``GAUGE`` metrics with + numeric or distribution values. The ``value_type`` of the output is ``DOUBLE``. - REDUCE_COUNT (int): Reduce by computing the count of data points across time series for each - alignment period. This reducer is valid for delta and gauge metrics of - numeric, Boolean, distribution, and string value type. The value type of - the output is ``INT64``. - REDUCE_COUNT_TRUE (int): Reduce by computing the count of True-valued data points across time - series for each alignment period. This reducer is valid for delta and - gauge metrics of Boolean value type. The value type of the output is - ``INT64``. - REDUCE_COUNT_FALSE (int): Reduce by computing the count of False-valued data points across time - series for each alignment period. This reducer is valid for delta and - gauge metrics of Boolean value type. The value type of the output is - ``INT64``. - REDUCE_FRACTION_TRUE (int): Reduce by computing the fraction of True-valued data points across time - series for each alignment period. This reducer is valid for delta and - gauge metrics of Boolean value type. The output value is in the range - [0, 1] and has value type ``DOUBLE``. - REDUCE_PERCENTILE_99 (int): Reduce by computing 99th percentile of data points across time series - for each alignment period. This reducer is valid for gauge and delta - metrics of numeric and distribution type. The value of the output is - ``DOUBLE`` - REDUCE_PERCENTILE_95 (int): Reduce by computing 95th percentile of data points across time series - for each alignment period. This reducer is valid for gauge and delta - metrics of numeric and distribution type. The value of the output is - ``DOUBLE`` - REDUCE_PERCENTILE_50 (int): Reduce by computing 50th percentile of data points across time series - for each alignment period. This reducer is valid for gauge and delta - metrics of numeric and distribution type. The value of the output is - ``DOUBLE`` - REDUCE_PERCENTILE_05 (int): Reduce by computing 5th percentile of data points across time series for - each alignment period. This reducer is valid for gauge and delta metrics - of numeric and distribution type. The value of the output is ``DOUBLE`` + REDUCE_MIN (int): Reduce by computing the minimum value across time series for each + alignment period. This reducer is valid for ``DELTA`` and ``GAUGE`` + metrics with numeric values. The ``value_type`` of the output is the + same as the ``value_type`` of the input. + REDUCE_MAX (int): Reduce by computing the maximum value across time series for each + alignment period. This reducer is valid for ``DELTA`` and ``GAUGE`` + metrics with numeric values. The ``value_type`` of the output is the + same as the ``value_type`` of the input. + REDUCE_SUM (int): Reduce by computing the sum across time series for each alignment + period. This reducer is valid for ``DELTA`` and ``GAUGE`` metrics with + numeric and distribution values. The ``value_type`` of the output is the + same as the ``value_type`` of the input. + REDUCE_STDDEV (int): Reduce by computing the standard deviation across time series for each + alignment period. This reducer is valid for ``DELTA`` and ``GAUGE`` + metrics with numeric or distribution values. The ``value_type`` of the + output is ``DOUBLE``. + REDUCE_COUNT (int): Reduce by computing the number of data points across time series for + each alignment period. This reducer is valid for ``DELTA`` and ``GAUGE`` + metrics of numeric, Boolean, distribution, and string ``value_type``. + The ``value_type`` of the output is ``INT64``. + REDUCE_COUNT_TRUE (int): Reduce by computing the number of ``True``-valued data points across + time series for each alignment period. This reducer is valid for + ``DELTA`` and ``GAUGE`` metrics of Boolean ``value_type``. The + ``value_type`` of the output is ``INT64``. + REDUCE_COUNT_FALSE (int): Reduce by computing the number of ``False``-valued data points across + time series for each alignment period. This reducer is valid for + ``DELTA`` and ``GAUGE`` metrics of Boolean ``value_type``. The + ``value_type`` of the output is ``INT64``. + REDUCE_FRACTION_TRUE (int): Reduce by computing the ratio of the number of ``True``-valued data + points to the total number of data points for each alignment period. + This reducer is valid for ``DELTA`` and ``GAUGE`` metrics of Boolean + ``value_type``. The output value is in the range [0.0, 1.0] and has + ``value_type`` ``DOUBLE``. + REDUCE_PERCENTILE_99 (int): Reduce by computing the `99th + percentile `__ of data points + across time series for each alignment period. This reducer is valid for + ``GAUGE`` and ``DELTA`` metrics of numeric and distribution type. The + value of the output is ``DOUBLE``. + REDUCE_PERCENTILE_95 (int): Reduce by computing the `95th + percentile `__ of data points + across time series for each alignment period. This reducer is valid for + ``GAUGE`` and ``DELTA`` metrics of numeric and distribution type. The + value of the output is ``DOUBLE``. + REDUCE_PERCENTILE_50 (int): Reduce by computing the `50th + percentile `__ of data points + across time series for each alignment period. This reducer is valid for + ``GAUGE`` and ``DELTA`` metrics of numeric and distribution type. The + value of the output is ``DOUBLE``. + REDUCE_PERCENTILE_05 (int): Reduce by computing the `5th + percentile `__ of data points + across time series for each alignment period. This reducer is valid for + ``GAUGE`` and ``DELTA`` metrics of numeric and distribution type. The + value of the output is ``DOUBLE``. """ REDUCE_NONE = 0 diff --git a/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py index 346c71820c92..596a701fdda9 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py @@ -256,7 +256,7 @@ def list_groups( ... pass Args: - name (str): The project whose groups are to be listed. The format is + name (str): Required. The project whose groups are to be listed. The format is ``"projects/{project_id_or_number}"``. children_of_group (str): A group name: ``"projects/{project_id_or_number}/groups/{group_id}"``. Returns groups whose ``parentName`` field contains the group name. If no @@ -374,7 +374,7 @@ def get_group( >>> response = client.get_group(name) Args: - name (str): The group to retrieve. The format is + name (str): Required. The group to retrieve. The format is ``"projects/{project_id_or_number}/groups/{group_id}"``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -452,10 +452,10 @@ def create_group( >>> response = client.create_group(name, group) Args: - name (str): The project in which to create the group. The format is + name (str): Required. The project in which to create the group. The format is ``"projects/{project_id_or_number}"``. - group (Union[dict, ~google.cloud.monitoring_v3.types.Group]): A group definition. It is an error to define the ``name`` field because - the system assigns the name. + group (Union[dict, ~google.cloud.monitoring_v3.types.Group]): Required. A group definition. It is an error to define the ``name`` + field because the system assigns the name. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.Group` @@ -536,9 +536,9 @@ def update_group( >>> response = client.update_group(group) Args: - group (Union[dict, ~google.cloud.monitoring_v3.types.Group]): The new definition of the group. All fields of the existing group, - excepting ``name``, are replaced with the corresponding fields of this - group. + group (Union[dict, ~google.cloud.monitoring_v3.types.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. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.Group` @@ -617,7 +617,7 @@ def delete_group( >>> client.delete_group(name) Args: - name (str): The group to delete. The format is + name (str): Required. The group to delete. The format is ``"projects/{project_id_or_number}/groups/{group_id}"``. recursive (bool): If this field is true, then the request means to delete a group with all its descendants. Otherwise, the request means to delete a group only when @@ -705,7 +705,7 @@ def list_group_members( ... pass Args: - name (str): The group whose members are listed. The format is + name (str): Required. The group whose members are listed. The format is ``"projects/{project_id_or_number}/groups/{group_id}"``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- diff --git a/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py index 19ddd05c5c81..bbca574e9ac4 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py @@ -260,7 +260,7 @@ def list_monitored_resource_descriptors( ... pass Args: - name (str): The project on which to execute the request. The format is + name (str): Required. The project on which to execute the request. The format is ``"projects/{project_id_or_number}"``. filter_ (str): An optional `filter `__ @@ -367,7 +367,7 @@ def get_monitored_resource_descriptor( >>> response = client.get_monitored_resource_descriptor(name) Args: - name (str): The monitored resource descriptor to get. The format is + name (str): Required. The monitored resource descriptor to get. The format is ``"projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}"``. The ``{resource_type}`` is a predefined type, such as ``cloudsql_database``. @@ -460,7 +460,7 @@ def list_metric_descriptors( ... pass Args: - name (str): The project on which to execute the request. The format is + name (str): Required. The project on which to execute the request. The format is ``"projects/{project_id_or_number}"``. filter_ (str): If this field is empty, all custom and system-defined metric descriptors are returned. Otherwise, the @@ -564,7 +564,8 @@ def get_metric_descriptor( >>> response = client.get_metric_descriptor(name) Args: - name (str): The metric descriptor on which to execute the request. The format is + name (str): Required. The metric descriptor on which to execute the request. The + format is ``"projects/{project_id_or_number}/metricDescriptors/{metric_id}"``. An example value of ``{metric_id}`` is ``"compute.googleapis.com/instance/disk/read_bytes_count"``. @@ -644,9 +645,9 @@ def create_metric_descriptor( >>> response = client.create_metric_descriptor(name, metric_descriptor) Args: - name (str): The project on which to execute the request. The format is + name (str): Required. The project on which to execute the request. The format is ``"projects/{project_id_or_number}"``. - metric_descriptor (Union[dict, ~google.cloud.monitoring_v3.types.MetricDescriptor]): The new `custom + metric_descriptor (Union[dict, ~google.cloud.monitoring_v3.types.MetricDescriptor]): Required. The new `custom metric `__ descriptor. @@ -727,7 +728,8 @@ def delete_metric_descriptor( >>> client.delete_metric_descriptor(name) Args: - name (str): The metric descriptor on which to execute the request. The format is + name (str): Required. The metric descriptor on which to execute the request. The + format is ``"projects/{project_id_or_number}/metricDescriptors/{metric_id}"``. An example of ``{metric_id}`` is: ``"custom.googleapis.com/my_test_metric"``. @@ -827,9 +829,9 @@ def list_time_series( ... pass Args: - name (str): The project on which to execute the request. The format is + name (str): Required. The project on which to execute the request. The format is "projects/{project\_id\_or\_number}". - filter_ (str): A `monitoring + filter_ (str): Required. A `monitoring filter `__ that specifies which time series should be returned. The filter must specify a single metric type, and can additionally specify metric labels and @@ -839,13 +841,13 @@ def list_time_series( metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND metric.labels.instance_name = "my-instance-name" - interval (Union[dict, ~google.cloud.monitoring_v3.types.TimeInterval]): The time interval for which results should be returned. Only time series + interval (Union[dict, ~google.cloud.monitoring_v3.types.TimeInterval]): Required. The time interval for which results should be returned. Only time series that contain data points in the specified interval are included in the response. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.TimeInterval` - view (~google.cloud.monitoring_v3.types.TimeSeriesView): Specifies which information is returned about the time series. + view (~google.cloud.monitoring_v3.types.TimeSeriesView): Required. Specifies which information is returned about the time series. aggregation (Union[dict, ~google.cloud.monitoring_v3.types.Aggregation]): Specifies the alignment of data points in individual time series as well as how to combine the retrieved time series across specified labels. @@ -961,13 +963,13 @@ def create_time_series( >>> client.create_time_series(name, time_series) Args: - name (str): The project on which to execute the request. The format is + name (str): Required. The project on which to execute the request. The format is ``"projects/{project_id_or_number}"``. - time_series (list[Union[dict, ~google.cloud.monitoring_v3.types.TimeSeries]]): The new data to be added to a list of time series. Adds at most one data - point to each of several time series. The new data point must be more - recent than any other point in its time series. Each ``TimeSeries`` - value must fully specify a unique time series by supplying all label - values for the metric and the monitored resource. + time_series (list[Union[dict, ~google.cloud.monitoring_v3.types.TimeSeries]]): Required. The new data to be added to a list of time series. Adds at + most one data point to each of several time series. The new data point + must be more recent than any other point in its time series. Each + ``TimeSeries`` value must fully specify a unique time series by + supplying all label values for the metric and the monitored resource. The maximum number of ``TimeSeries`` objects per ``Create`` request is 200. diff --git a/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py index 0445837c01f7..2f55be6df5a7 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py @@ -266,8 +266,8 @@ def list_notification_channel_descriptors( ... pass Args: - name (str): The REST resource name of the parent from which to retrieve the - notification channel descriptors. The expected syntax is: + name (str): Required. The REST resource name of the parent from which to retrieve + the notification channel descriptors. The expected syntax is: :: @@ -373,7 +373,8 @@ def get_notification_channel_descriptor( >>> response = client.get_notification_channel_descriptor(name) Args: - name (str): The channel type for which to execute the request. The format is + name (str): Required. The channel type for which to execute the request. The format + is ``projects/[PROJECT_ID]/notificationChannelDescriptors/{channel_type}``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -467,7 +468,7 @@ def list_notification_channels( ... pass Args: - name (str): The project on which to execute the request. The format is + name (str): Required. The project on which to execute the request. The format is ``projects/[PROJECT_ID]``. That is, this names the container in which to look for the notification channels; it does not name a specific channel. To query a specific channel by REST resource name, use the @@ -581,7 +582,7 @@ def get_notification_channel( >>> response = client.get_notification_channel(name) Args: - name (str): The channel for which to execute the request. The format is + name (str): Required. The channel for which to execute the request. The format is ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -659,7 +660,7 @@ def create_notification_channel( >>> response = client.create_notification_channel(name, notification_channel) Args: - name (str): The project on which to execute the request. The format is: + name (str): Required. The project on which to execute the request. The format is: :: @@ -670,7 +671,7 @@ def create_notification_channel( channel's name will have a normalized version of this field as a prefix, but will add ``/notificationChannels/[CHANNEL_ID]`` to identify the channel. - notification_channel (Union[dict, ~google.cloud.monitoring_v3.types.NotificationChannel]): The definition of the ``NotificationChannel`` to create. + notification_channel (Union[dict, ~google.cloud.monitoring_v3.types.NotificationChannel]): Required. The definition of the ``NotificationChannel`` to create. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.NotificationChannel` @@ -752,10 +753,10 @@ def update_notification_channel( >>> response = client.update_notification_channel(notification_channel) Args: - notification_channel (Union[dict, ~google.cloud.monitoring_v3.types.NotificationChannel]): A description of the changes to be applied to the specified notification - channel. The description must provide a definition for fields to be - updated; the names of these fields should also be included in the - ``update_mask``. + notification_channel (Union[dict, ~google.cloud.monitoring_v3.types.NotificationChannel]): Required. A description of the changes to be applied to the specified + notification channel. The description must provide a definition for + fields to be updated; the names of these fields should also be included + in the ``update_mask``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.NotificationChannel` @@ -839,7 +840,7 @@ def delete_notification_channel( >>> client.delete_notification_channel(name) Args: - name (str): The channel for which to execute the request. The format is + name (str): Required. The channel for which to execute the request. The format is ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``. force (bool): If true, the notification channel will be deleted regardless of its use in alert policies (the policies will be updated to remove the @@ -918,7 +919,7 @@ def send_notification_channel_verification_code( >>> client.send_notification_channel_verification_code(name) Args: - name (str): The notification channel to which to send a verification code. + name (str): Required. The notification channel to which to send a verification code. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1014,7 +1015,7 @@ def get_notification_channel_verification_code( >>> response = client.get_notification_channel_verification_code(name) Args: - name (str): The notification channel for which a verification code is to be generated + name (str): Required. The notification channel for which a verification code is to be generated and retrieved. This must name a channel that is already verified; if the specified channel is not verified, the request will fail. expire_time (Union[dict, ~google.cloud.monitoring_v3.types.Timestamp]): The desired expiration time. If specified, the API will guarantee that @@ -1112,10 +1113,10 @@ def verify_notification_channel( >>> response = client.verify_notification_channel(name, code) Args: - name (str): The notification channel to verify. - code (str): The verification code that was delivered to the channel as a result of - invoking the ``SendNotificationChannelVerificationCode`` API method or - that was retrieved from a verified channel via + name (str): Required. The notification channel to verify. + code (str): Required. The verification code that was delivered to the channel as a + result of invoking the ``SendNotificationChannelVerificationCode`` API + method or that was retrieved from a verified channel via ``GetNotificationChannelVerificationCode``. For example, one might have "G-123456" or "TKNZGhhd2EyN3I1MnRnMjRv" (in general, one is only guaranteed that the code is valid UTF-8; one should not make any diff --git a/monitoring/google/cloud/monitoring_v3/gapic/service_monitoring_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/service_monitoring_service_client.py index 0daa8970cf59..35e84bb5a22d 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/service_monitoring_service_client.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/service_monitoring_service_client.py @@ -261,9 +261,9 @@ def create_service( >>> response = client.create_service(parent, service) Args: - parent (str): Resource name of the parent workspace. Of the form + parent (str): Required. Resource name of the parent workspace. Of the form ``projects/{project_id}``. - service (Union[dict, ~google.cloud.monitoring_v3.types.Service]): The ``Service`` to create. + service (Union[dict, ~google.cloud.monitoring_v3.types.Service]): Required. The ``Service`` to create. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.Service` @@ -342,7 +342,7 @@ def get_service( >>> response = client.get_service(name) Args: - name (str): Resource name of the ``Service``. Of the form + name (str): Required. Resource name of the ``Service``. Of the form ``projects/{project_id}/services/{service_id}``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -429,7 +429,7 @@ def list_services( ... pass Args: - parent (str): Resource name of the parent ``Workspace``. Of the form + parent (str): Required. Resource name of the parent ``Workspace``. Of the form ``projects/{project_id}``. filter_ (str): A filter specifying what ``Service``\ s to return. The filter currently supports the following fields: @@ -542,8 +542,8 @@ def update_service( >>> response = client.update_service(service) Args: - service (Union[dict, ~google.cloud.monitoring_v3.types.Service]): The ``Service`` to draw updates from. The given ``name`` specifies the - resource to update. + service (Union[dict, ~google.cloud.monitoring_v3.types.Service]): Required. The ``Service`` to draw updates from. The given ``name`` + specifies the resource to update. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.Service` @@ -624,8 +624,8 @@ def delete_service( >>> client.delete_service(name) Args: - name (str): Resource name of the ``Service`` to delete. Of the form - ``projects/{project_id}/service/{service_id}``. + name (str): Required. Resource name of the ``Service`` to delete. Of the form + ``projects/{project_id}/services/{service_id}``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -699,10 +699,10 @@ def create_service_level_objective( >>> response = client.create_service_level_objective(parent, service_level_objective) Args: - parent (str): Resource name of the parent ``Service``. Of the form + parent (str): Required. Resource name of the parent ``Service``. Of the form ``projects/{project_id}/services/{service_id}``. - service_level_objective (Union[dict, ~google.cloud.monitoring_v3.types.ServiceLevelObjective]): The ``ServiceLevelObjective`` to create. The provided ``name`` will be - respected if no ``ServiceLevelObjective`` exists with this name. + service_level_objective (Union[dict, ~google.cloud.monitoring_v3.types.ServiceLevelObjective]): Required. The ``ServiceLevelObjective`` to create. The provided ``name`` + will be respected if no ``ServiceLevelObjective`` exists with this name. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.ServiceLevelObjective` @@ -787,7 +787,8 @@ def get_service_level_objective( >>> response = client.get_service_level_objective(name) Args: - name (str): Resource name of the ``ServiceLevelObjective`` to get. Of the form + name (str): Required. Resource name of the ``ServiceLevelObjective`` to get. Of the + form ``projects/{project_id}/services/{service_id}/serviceLevelObjectives/{slo_name}``. view (~google.cloud.monitoring_v3.types.View): View of the ``ServiceLevelObjective`` to return. If ``DEFAULT``, return the ``ServiceLevelObjective`` as originally defined. If ``EXPLICIT`` and @@ -884,7 +885,7 @@ def list_service_level_objectives( ... pass Args: - parent (str): Resource name of the parent ``Service``. Of the form + parent (str): Required. Resource name of the parent ``Service``. Of the form ``projects/{project_id}/services/{service_id}``. filter_ (str): A filter specifying what ``ServiceLevelObjective``\ s to return. page_size (int): The maximum number of resources contained in the @@ -988,8 +989,8 @@ def update_service_level_objective( >>> response = client.update_service_level_objective(service_level_objective) Args: - service_level_objective (Union[dict, ~google.cloud.monitoring_v3.types.ServiceLevelObjective]): The ``ServiceLevelObjective`` to draw updates from. The given ``name`` - specifies the resource to update. + service_level_objective (Union[dict, ~google.cloud.monitoring_v3.types.ServiceLevelObjective]): Required. The ``ServiceLevelObjective`` to draw updates from. The given + ``name`` specifies the resource to update. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.ServiceLevelObjective` @@ -1074,7 +1075,8 @@ def delete_service_level_objective( >>> client.delete_service_level_objective(name) Args: - name (str): Resource name of the ``ServiceLevelObjective`` to delete. Of the form + name (str): Required. Resource name of the ``ServiceLevelObjective`` to delete. Of + the form ``projects/{project_id}/services/{service_id}/serviceLevelObjectives/{slo_name}``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will diff --git a/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py index 45f327bb11e1..a023518861e1 100644 --- a/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py +++ b/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py @@ -269,8 +269,8 @@ def list_uptime_check_configs( ... pass Args: - parent (str): The project whose Uptime check configurations are listed. The format is - ``projects/[PROJECT_ID]``. + parent (str): Required. The project whose Uptime check configurations are listed. The + format is ``projects/[PROJECT_ID]``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -363,7 +363,7 @@ def get_uptime_check_config( >>> response = client.get_uptime_check_config(name) Args: - name (str): The Uptime check configuration to retrieve. The format is + name (str): Required. The Uptime check configuration to retrieve. The format is ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -440,9 +440,9 @@ def create_uptime_check_config( >>> response = client.create_uptime_check_config(parent, uptime_check_config) Args: - parent (str): The project in which to create the Uptime check. The format is + parent (str): Required. The project in which to create the Uptime check. The format is ``projects/[PROJECT_ID]``. - uptime_check_config (Union[dict, ~google.cloud.monitoring_v3.types.UptimeCheckConfig]): The new Uptime check configuration. + uptime_check_config (Union[dict, ~google.cloud.monitoring_v3.types.UptimeCheckConfig]): Required. The new Uptime check configuration. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig` @@ -620,7 +620,7 @@ def delete_uptime_check_config( >>> client.delete_uptime_check_config(name) Args: - name (str): The Uptime check configuration to delete. The format is + name (str): Required. The Uptime check configuration to delete. The format is ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert.proto b/monitoring/google/cloud/monitoring_v3/proto/alert.proto index fc811a01c48d..d65e00dba407 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/alert.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/alert.proto @@ -17,6 +17,7 @@ syntax = "proto3"; package google.monitoring.v3; +import "google/api/resource.proto"; import "google/monitoring/v3/common.proto"; import "google/monitoring/v3/mutation_record.proto"; import "google/protobuf/duration.proto"; @@ -35,6 +36,14 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3"; // this state. For an overview of alert policies, see // [Introduction to Alerting](/monitoring/alerts/). message AlertPolicy { + option (google.api.resource) = { + type: "monitoring.googleapis.com/AlertPolicy" + pattern: "projects/{project}/alertPolicies/{alert_policy}" + pattern: "organizations/{organization}/alertPolicies/{alert_policy}" + pattern: "folders/{folder}/alertPolicies/{alert_policy}" + pattern: "*" + }; + // A content string and a MIME type that describes the content string's // format. message Documentation { @@ -54,6 +63,14 @@ message AlertPolicy { // should open an incident. If a condition evaluates to true, it signifies // that something is wrong. message Condition { + option (google.api.resource) = { + type: "monitoring.googleapis.com/AlertPolicyCondition" + pattern: "projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}" + pattern: "organizations/{organization}/alertPolicies/{alert_policy}/conditions/{condition}" + pattern: "folders/{folder}/alertPolicies/{alert_policy}/conditions/{condition}" + pattern: "*" + }; + // Specifies how many time series must fail a predicate to trigger a // condition. If not specified, then a `{count: 1}` trigger is used. message Trigger { @@ -300,10 +317,14 @@ message AlertPolicy { // OR according to the `combiner` field. If the combined conditions evaluate // to true, then an incident is created. A policy can have from one to six // conditions. + // If |condition_time_series_uery_language| is present, it must be the only + // |condition|. repeated Condition conditions = 12; // How to combine the results of multiple conditions to determine if an // incident should be opened. + // If condition_time_series_query_language is present, this must be + // COMBINE_UNSPECIFIED. ConditionCombinerType combiner = 6; // Whether or not the policy is enabled. On write, the default interpretation diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py index 203b7f523d70..ca853c44a9fc 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py @@ -15,6 +15,7 @@ _sym_db = _symbol_database.Default() +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2, ) @@ -34,9 +35,10 @@ "\n\030com.google.monitoring.v3B\nAlertProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n,google/cloud/monitoring_v3/proto/alert.proto\x12\x14google.monitoring.v3\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a\x36google/cloud/monitoring_v3/proto/mutation_record.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto"\x83\r\n\x0b\x41lertPolicy\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x46\n\rdocumentation\x18\r \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.Documentation\x12\x46\n\x0buser_labels\x18\x10 \x03(\x0b\x32\x31.google.monitoring.v3.AlertPolicy.UserLabelsEntry\x12?\n\nconditions\x18\x0c \x03(\x0b\x32+.google.monitoring.v3.AlertPolicy.Condition\x12I\n\x08\x63ombiner\x18\x06 \x01(\x0e\x32\x37.google.monitoring.v3.AlertPolicy.ConditionCombinerType\x12+\n\x07\x65nabled\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12$\n\x08validity\x18\x12 \x01(\x0b\x32\x12.google.rpc.Status\x12\x1d\n\x15notification_channels\x18\x0e \x03(\t\x12=\n\x0f\x63reation_record\x18\n \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12=\n\x0fmutation_record\x18\x0b \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x1a\x33\n\rDocumentation\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\x1a\xf8\x06\n\tCondition\x12\x0c\n\x04name\x18\x0c \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x06 \x01(\t\x12Z\n\x13\x63ondition_threshold\x18\x01 \x01(\x0b\x32;.google.monitoring.v3.AlertPolicy.Condition.MetricThresholdH\x00\x12U\n\x10\x63ondition_absent\x18\x02 \x01(\x0b\x32\x39.google.monitoring.v3.AlertPolicy.Condition.MetricAbsenceH\x00\x1a\x35\n\x07Trigger\x12\x0f\n\x05\x63ount\x18\x01 \x01(\x05H\x00\x12\x11\n\x07percent\x18\x02 \x01(\x01H\x00\x42\x06\n\x04type\x1a\x81\x03\n\x0fMetricThreshold\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x37\n\x0c\x61ggregations\x18\x08 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x1a\n\x12\x64\x65nominator_filter\x18\t \x01(\t\x12\x43\n\x18\x64\x65nominator_aggregations\x18\n \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x38\n\ncomparison\x18\x04 \x01(\x0e\x32$.google.monitoring.v3.ComparisonType\x12\x17\n\x0fthreshold_value\x18\x05 \x01(\x01\x12+\n\x08\x64uration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x07 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x1a\xcb\x01\n\rMetricAbsence\x12\x0e\n\x06\x66ilter\x18\x01 \x01(\t\x12\x37\n\x0c\x61ggregations\x18\x05 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.TriggerB\x0b\n\tcondition\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"a\n\x15\x43onditionCombinerType\x12\x17\n\x13\x43OMBINE_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x12\x06\n\x02OR\x10\x02\x12\x1e\n\x1a\x41ND_WITH_MATCHING_RESOURCE\x10\x03\x42\xa2\x01\n\x18\x63om.google.monitoring.v3B\nAlertProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n,google/cloud/monitoring_v3/proto/alert.proto\x12\x14google.monitoring.v3\x1a\x19google/api/resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a\x36google/cloud/monitoring_v3/proto/mutation_record.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto"\xe9\x10\n\x0b\x41lertPolicy\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x46\n\rdocumentation\x18\r \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.Documentation\x12\x46\n\x0buser_labels\x18\x10 \x03(\x0b\x32\x31.google.monitoring.v3.AlertPolicy.UserLabelsEntry\x12?\n\nconditions\x18\x0c \x03(\x0b\x32+.google.monitoring.v3.AlertPolicy.Condition\x12I\n\x08\x63ombiner\x18\x06 \x01(\x0e\x32\x37.google.monitoring.v3.AlertPolicy.ConditionCombinerType\x12+\n\x07\x65nabled\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12$\n\x08validity\x18\x12 \x01(\x0b\x32\x12.google.rpc.Status\x12\x1d\n\x15notification_channels\x18\x0e \x03(\t\x12=\n\x0f\x63reation_record\x18\n \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12=\n\x0fmutation_record\x18\x0b \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x1a\x33\n\rDocumentation\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\x1a\x92\t\n\tCondition\x12\x0c\n\x04name\x18\x0c \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x06 \x01(\t\x12Z\n\x13\x63ondition_threshold\x18\x01 \x01(\x0b\x32;.google.monitoring.v3.AlertPolicy.Condition.MetricThresholdH\x00\x12U\n\x10\x63ondition_absent\x18\x02 \x01(\x0b\x32\x39.google.monitoring.v3.AlertPolicy.Condition.MetricAbsenceH\x00\x1a\x35\n\x07Trigger\x12\x0f\n\x05\x63ount\x18\x01 \x01(\x05H\x00\x12\x11\n\x07percent\x18\x02 \x01(\x01H\x00\x42\x06\n\x04type\x1a\x81\x03\n\x0fMetricThreshold\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x37\n\x0c\x61ggregations\x18\x08 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x1a\n\x12\x64\x65nominator_filter\x18\t \x01(\t\x12\x43\n\x18\x64\x65nominator_aggregations\x18\n \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x38\n\ncomparison\x18\x04 \x01(\x0e\x32$.google.monitoring.v3.ComparisonType\x12\x17\n\x0fthreshold_value\x18\x05 \x01(\x01\x12+\n\x08\x64uration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x07 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x1a\xcb\x01\n\rMetricAbsence\x12\x0e\n\x06\x66ilter\x18\x01 \x01(\t\x12\x37\n\x0c\x61ggregations\x18\x05 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger:\x97\x02\xea\x41\x93\x02\n.monitoring.googleapis.com/AlertPolicyCondition\x12\x46projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}\x12Porganizations/{organization}/alertPolicies/{alert_policy}/conditions/{condition}\x12\x44\x66olders/{folder}/alertPolicies/{alert_policy}/conditions/{condition}\x12\x01*B\x0b\n\tcondition\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"a\n\x15\x43onditionCombinerType\x12\x17\n\x13\x43OMBINE_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x12\x06\n\x02OR\x10\x02\x12\x1e\n\x1a\x41ND_WITH_MATCHING_RESOURCE\x10\x03:\xc9\x01\xea\x41\xc5\x01\n%monitoring.googleapis.com/AlertPolicy\x12/projects/{project}/alertPolicies/{alert_policy}\x12\x39organizations/{organization}/alertPolicies/{alert_policy}\x12-folders/{folder}/alertPolicies/{alert_policy}\x12\x01*B\xa2\x01\n\x18\x63om.google.monitoring.v3B\nAlertProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_mutation__record__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, @@ -75,8 +77,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=1833, - serialized_end=1930, + serialized_start=2142, + serialized_end=2239, ) _sym_db.RegisterEnumDescriptor(_ALERTPOLICY_CONDITIONCOMBINERTYPE) @@ -133,8 +135,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=838, - serialized_end=889, + serialized_start=865, + serialized_end=916, ) _ALERTPOLICY_CONDITION_TRIGGER = _descriptor.Descriptor( @@ -197,8 +199,8 @@ fields=[], ) ], - serialized_start=1120, - serialized_end=1173, + serialized_start=1147, + serialized_end=1200, ) _ALERTPOLICY_CONDITION_METRICTHRESHOLD = _descriptor.Descriptor( @@ -361,8 +363,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1176, - serialized_end=1561, + serialized_start=1203, + serialized_end=1588, ) _ALERTPOLICY_CONDITION_METRICABSENCE = _descriptor.Descriptor( @@ -453,8 +455,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1564, - serialized_end=1767, + serialized_start=1591, + serialized_end=1794, ) _ALERTPOLICY_CONDITION = _descriptor.Descriptor( @@ -544,7 +546,9 @@ _ALERTPOLICY_CONDITION_METRICABSENCE, ], enum_types=[], - serialized_options=None, + serialized_options=_b( + "\352A\223\002\n.monitoring.googleapis.com/AlertPolicyCondition\022Fprojects/{project}/alertPolicies/{alert_policy}/conditions/{condition}\022Porganizations/{organization}/alertPolicies/{alert_policy}/conditions/{condition}\022Dfolders/{folder}/alertPolicies/{alert_policy}/conditions/{condition}\022\001*" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -557,8 +561,8 @@ fields=[], ) ], - serialized_start=892, - serialized_end=1780, + serialized_start=919, + serialized_end=2089, ) _ALERTPOLICY_USERLABELSENTRY = _descriptor.Descriptor( @@ -613,8 +617,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1782, - serialized_end=1831, + serialized_start=2091, + serialized_end=2140, ) _ALERTPOLICY = _descriptor.Descriptor( @@ -830,13 +834,15 @@ _ALERTPOLICY_USERLABELSENTRY, ], enum_types=[_ALERTPOLICY_CONDITIONCOMBINERTYPE], - serialized_options=None, + serialized_options=_b( + "\352A\305\001\n%monitoring.googleapis.com/AlertPolicy\022/projects/{project}/alertPolicies/{alert_policy}\0229organizations/{organization}/alertPolicies/{alert_policy}\022-folders/{folder}/alertPolicies/{alert_policy}\022\001*" + ), is_extendable=False, syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=263, - serialized_end=1930, + serialized_start=290, + serialized_end=2443, ) _ALERTPOLICY_DOCUMENTATION.containing_type = _ALERTPOLICY @@ -1224,10 +1230,14 @@ A list of conditions for the policy. The conditions are combined by AND or OR according to the ``combiner`` field. If the combined conditions evaluate to true, then an incident is - created. A policy can have from one to six conditions. + created. A policy can have from one to six conditions. If + \|condition\_time\_series\_uery\_language\| is present, it + must be the only \|condition\|. combiner: How to combine the results of multiple conditions to determine - if an incident should be opened. + if an incident should be opened. If + condition\_time\_series\_query\_language is present, this must + be COMBINE\_UNSPECIFIED. enabled: Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On @@ -1272,5 +1282,7 @@ DESCRIPTOR._options = None +_ALERTPOLICY_CONDITION._options = None _ALERTPOLICY_USERLABELSENTRY._options = None +_ALERTPOLICY._options = None # @@protoc_insertion_point(module_scope) diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto b/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto index de5a30f02938..a88c376f5a1c 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto @@ -18,10 +18,12 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/monitoring/v3/alert.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Cloud.Monitoring.V3"; option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring"; @@ -51,6 +53,7 @@ service AlertPolicyService { option (google.api.http) = { get: "/v3/{name=projects/*}/alertPolicies" }; + option (google.api.method_signature) = "name"; } // Gets a single alerting policy. @@ -58,6 +61,7 @@ service AlertPolicyService { option (google.api.http) = { get: "/v3/{name=projects/*/alertPolicies/*}" }; + option (google.api.method_signature) = "name"; } // Creates a new alerting policy. @@ -66,6 +70,7 @@ service AlertPolicyService { post: "/v3/{name=projects/*}/alertPolicies" body: "alert_policy" }; + option (google.api.method_signature) = "name,alert_policy"; } // Deletes an alerting policy. @@ -73,6 +78,7 @@ service AlertPolicyService { option (google.api.http) = { delete: "/v3/{name=projects/*/alertPolicies/*}" }; + option (google.api.method_signature) = "name"; } // Updates an alerting policy. You can either replace the entire policy with @@ -84,12 +90,13 @@ service AlertPolicyService { patch: "/v3/{alert_policy.name=projects/*/alertPolicies/*}" body: "alert_policy" }; + option (google.api.method_signature) = "update_mask,alert_policy"; } } // The protocol for the `CreateAlertPolicy` request. message CreateAlertPolicyRequest { - // The project in which to create the alerting policy. The format is + // Required. The project in which to create the alerting policy. The format is // `projects/[PROJECT_ID]`. // // Note that this field names the parent container in which the alerting @@ -97,25 +104,35 @@ message CreateAlertPolicyRequest { // policy that is returned will have a name that contains a normalized // representation of this name as a prefix but adds a suffix of the form // `/alertPolicies/[POLICY_ID]`, identifying the policy in the container. - string name = 3; - - // The requested alerting policy. You should omit the `name` field in this + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/AlertPolicy" + } + ]; + + // Required. The requested alerting policy. You should omit the `name` field in this // policy. The name will be returned in the new policy, including // a new [ALERT_POLICY_ID] value. - AlertPolicy alert_policy = 2; + AlertPolicy alert_policy = 2 [(google.api.field_behavior) = REQUIRED]; } // The protocol for the `GetAlertPolicy` request. message GetAlertPolicyRequest { - // The alerting policy to retrieve. The format is + // Required. The alerting policy to retrieve. The format is // // projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID] - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/AlertPolicy" + } + ]; } // The protocol for the `ListAlertPolicies` request. message ListAlertPoliciesRequest { - // The project whose alert policies are to be listed. The format is + // Required. The project whose alert policies are to be listed. The format is // // projects/[PROJECT_ID] // @@ -124,7 +141,12 @@ message ListAlertPoliciesRequest { // by name, use the // [GetAlertPolicy][google.monitoring.v3.AlertPolicyService.GetAlertPolicy] // operation, instead. - string name = 4; + string name = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/AlertPolicy" + } + ]; // If provided, this field specifies the criteria that must be met by // alert policies to be included in the response. @@ -190,15 +212,20 @@ message UpdateAlertPolicyRequest { // fields listed in `update_mask`. // If `update_mask` is not empty, any fields in this policy that are // not in `update_mask` are ignored. - AlertPolicy alert_policy = 3; + AlertPolicy alert_policy = 3 [(google.api.field_behavior) = REQUIRED]; } // The protocol for the `DeleteAlertPolicy` request. message DeleteAlertPolicyRequest { - // The alerting policy to delete. The format is: + // Required. The alerting policy to delete. The format is: // // projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID] // // For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy]. - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/AlertPolicy" + } + ]; } diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py index 5f9be50453dd..30bb5c4d3590 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py @@ -16,12 +16,14 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( alert_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2, ) from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 -from google.api import client_pb2 as google_dot_api_dot_client__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -32,14 +34,16 @@ "\n\030com.google.monitoring.v3B\021AlertServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n4google/cloud/monitoring_v3/proto/alert_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a,google/cloud/monitoring_v3/proto/alert.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/api/client.proto"a\n\x18\x43reateAlertPolicyRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x37\n\x0c\x61lert_policy\x18\x02 \x01(\x0b\x32!.google.monitoring.v3.AlertPolicy"%\n\x15GetAlertPolicyRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"q\n\x18ListAlertPoliciesRequest\x12\x0c\n\x04name\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"o\n\x19ListAlertPoliciesResponse\x12\x39\n\x0e\x61lert_policies\x18\x03 \x03(\x0b\x32!.google.monitoring.v3.AlertPolicy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x18UpdateAlertPolicyRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x37\n\x0c\x61lert_policy\x18\x03 \x01(\x0b\x32!.google.monitoring.v3.AlertPolicy"(\n\x18\x44\x65leteAlertPolicyRequest\x12\x0c\n\x04name\x18\x03 \x01(\t2\xda\x07\n\x12\x41lertPolicyService\x12\xa1\x01\n\x11ListAlertPolicies\x12..google.monitoring.v3.ListAlertPoliciesRequest\x1a/.google.monitoring.v3.ListAlertPoliciesResponse"+\x82\xd3\xe4\x93\x02%\x12#/v3/{name=projects/*}/alertPolicies\x12\x8f\x01\n\x0eGetAlertPolicy\x12+.google.monitoring.v3.GetAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"-\x82\xd3\xe4\x93\x02\'\x12%/v3/{name=projects/*/alertPolicies/*}\x12\xa1\x01\n\x11\x43reateAlertPolicy\x12..google.monitoring.v3.CreateAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"9\x82\xd3\xe4\x93\x02\x33"#/v3/{name=projects/*}/alertPolicies:\x0c\x61lert_policy\x12\x8a\x01\n\x11\x44\x65leteAlertPolicy\x12..google.monitoring.v3.DeleteAlertPolicyRequest\x1a\x16.google.protobuf.Empty"-\x82\xd3\xe4\x93\x02\'*%/v3/{name=projects/*/alertPolicies/*}\x12\xb0\x01\n\x11UpdateAlertPolicy\x12..google.monitoring.v3.UpdateAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"H\x82\xd3\xe4\x93\x02\x42\x32\x32/v3/{alert_policy.name=projects/*/alertPolicies/*}:\x0c\x61lert_policy\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11\x41lertServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n4google/cloud/monitoring_v3/proto/alert_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/monitoring_v3/proto/alert.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x95\x01\n\x18\x43reateAlertPolicyRequest\x12;\n\x04name\x18\x03 \x01(\tB-\xe0\x41\x02\xfa\x41\'\x12%monitoring.googleapis.com/AlertPolicy\x12<\n\x0c\x61lert_policy\x18\x02 \x01(\x0b\x32!.google.monitoring.v3.AlertPolicyB\x03\xe0\x41\x02"T\n\x15GetAlertPolicyRequest\x12;\n\x04name\x18\x03 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%monitoring.googleapis.com/AlertPolicy"\xa0\x01\n\x18ListAlertPoliciesRequest\x12;\n\x04name\x18\x04 \x01(\tB-\xe0\x41\x02\xfa\x41\'\x12%monitoring.googleapis.com/AlertPolicy\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"o\n\x19ListAlertPoliciesResponse\x12\x39\n\x0e\x61lert_policies\x18\x03 \x03(\x0b\x32!.google.monitoring.v3.AlertPolicy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x89\x01\n\x18UpdateAlertPolicyRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12<\n\x0c\x61lert_policy\x18\x03 \x01(\x0b\x32!.google.monitoring.v3.AlertPolicyB\x03\xe0\x41\x02"W\n\x18\x44\x65leteAlertPolicyRequest\x12;\n\x04name\x18\x03 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%monitoring.googleapis.com/AlertPolicy2\x9e\x08\n\x12\x41lertPolicyService\x12\xa8\x01\n\x11ListAlertPolicies\x12..google.monitoring.v3.ListAlertPoliciesRequest\x1a/.google.monitoring.v3.ListAlertPoliciesResponse"2\x82\xd3\xe4\x93\x02%\x12#/v3/{name=projects/*}/alertPolicies\xda\x41\x04name\x12\x96\x01\n\x0eGetAlertPolicy\x12+.google.monitoring.v3.GetAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"4\x82\xd3\xe4\x93\x02\'\x12%/v3/{name=projects/*/alertPolicies/*}\xda\x41\x04name\x12\xb5\x01\n\x11\x43reateAlertPolicy\x12..google.monitoring.v3.CreateAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"M\x82\xd3\xe4\x93\x02\x33"#/v3/{name=projects/*}/alertPolicies:\x0c\x61lert_policy\xda\x41\x11name,alert_policy\x12\x91\x01\n\x11\x44\x65leteAlertPolicy\x12..google.monitoring.v3.DeleteAlertPolicyRequest\x1a\x16.google.protobuf.Empty"4\x82\xd3\xe4\x93\x02\'*%/v3/{name=projects/*/alertPolicies/*}\xda\x41\x04name\x12\xcb\x01\n\x11UpdateAlertPolicy\x12..google.monitoring.v3.UpdateAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"c\x82\xd3\xe4\x93\x02\x42\x32\x32/v3/{alert_policy.name=projects/*/alertPolicies/*}:\x0c\x61lert_policy\xda\x41\x18update_mask,alert_policy\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11\x41lertServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, - google_dot_api_dot_client__pb2.DESCRIPTOR, ], ) @@ -66,7 +70,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A'\022%monitoring.googleapis.com/AlertPolicy" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -84,7 +90,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -96,8 +102,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=242, - serialized_end=339, + serialized_start=303, + serialized_end=452, ) @@ -123,7 +129,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A'\n%monitoring.googleapis.com/AlertPolicy" + ), file=DESCRIPTOR, ) ], @@ -135,8 +143,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=341, - serialized_end=378, + serialized_start=454, + serialized_end=538, ) @@ -162,7 +170,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A'\022%monitoring.googleapis.com/AlertPolicy" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -246,8 +256,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=380, - serialized_end=493, + serialized_start=541, + serialized_end=701, ) @@ -303,8 +313,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=495, - serialized_end=606, + serialized_start=703, + serialized_end=814, ) @@ -348,7 +358,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -360,8 +370,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=609, - serialized_end=741, + serialized_start=817, + serialized_end=954, ) @@ -387,7 +397,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A'\n%monitoring.googleapis.com/AlertPolicy" + ), file=DESCRIPTOR, ) ], @@ -399,8 +411,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=743, - serialized_end=783, + serialized_start=956, + serialized_end=1043, ) _CREATEALERTPOLICYREQUEST.fields_by_name[ @@ -442,18 +454,18 @@ Attributes: name: - The project in which to create the alerting policy. The format - is ``projects/[PROJECT_ID]``. Note that this field names the - parent container in which the alerting policy will be written, - not the name of the created policy. The alerting policy that - is returned will have a name that contains a normalized - representation of this name as a prefix but adds a suffix of - the form ``/alertPolicies/[POLICY_ID]``, identifying the - policy in the container. + Required. The project in which to create the alerting policy. + The format is ``projects/[PROJECT_ID]``. Note that this field + names the parent container in which the alerting policy will + be written, not the name of the created policy. The alerting + policy that is returned will have a name that contains a + normalized representation of this name as a prefix but adds a + suffix of the form ``/alertPolicies/[POLICY_ID]``, identifying + the policy in the container. alert_policy: - The requested alerting policy. You should omit the ``name`` - field in this policy. The name will be returned in the new - policy, including a new [ALERT\_POLICY\_ID] value. + Required. The requested alerting policy. You should omit the + ``name`` field in this policy. The name will be returned in + the new policy, including a new [ALERT\_POLICY\_ID] value. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateAlertPolicyRequest) ), @@ -471,7 +483,7 @@ Attributes: name: - The alerting policy to retrieve. The format is :: + Required. The alerting policy to retrieve. The format is :: projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID] """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetAlertPolicyRequest) @@ -490,12 +502,13 @@ Attributes: name: - The project whose alert policies are to be listed. The format - is :: projects/[PROJECT_ID] Note that this field names - the parent container in which the alerting policies to be - listed are stored. To retrieve a single alerting policy by - name, use the [GetAlertPolicy][google.monitoring.v3.AlertPolic - yService.GetAlertPolicy] operation, instead. + Required. The project whose alert policies are to be listed. + The format is :: projects/[PROJECT_ID] Note that this + field names the parent container in which the alerting + policies to be listed are stored. To retrieve a single + alerting policy by name, use the [GetAlertPolicy][google.monit + oring.v3.AlertPolicyService.GetAlertPolicy] operation, + instead. filter: If provided, this field specifies the criteria that must be met by alert policies to be included in the response. For @@ -596,7 +609,7 @@ Attributes: name: - The alerting policy to delete. The format is: :: + Required. The alerting policy to delete. The format is: :: projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID] For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy]. @@ -608,6 +621,12 @@ DESCRIPTOR._options = None +_CREATEALERTPOLICYREQUEST.fields_by_name["name"]._options = None +_CREATEALERTPOLICYREQUEST.fields_by_name["alert_policy"]._options = None +_GETALERTPOLICYREQUEST.fields_by_name["name"]._options = None +_LISTALERTPOLICIESREQUEST.fields_by_name["name"]._options = None +_UPDATEALERTPOLICYREQUEST.fields_by_name["alert_policy"]._options = None +_DELETEALERTPOLICYREQUEST.fields_by_name["name"]._options = None _ALERTPOLICYSERVICE = _descriptor.ServiceDescriptor( name="AlertPolicyService", @@ -617,8 +636,8 @@ serialized_options=_b( "\312A\031monitoring.googleapis.com\322A\211\001https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read" ), - serialized_start=786, - serialized_end=1772, + serialized_start=1046, + serialized_end=2100, methods=[ _descriptor.MethodDescriptor( name="ListAlertPolicies", @@ -628,7 +647,7 @@ input_type=_LISTALERTPOLICIESREQUEST, output_type=_LISTALERTPOLICIESRESPONSE, serialized_options=_b( - "\202\323\344\223\002%\022#/v3/{name=projects/*}/alertPolicies" + "\202\323\344\223\002%\022#/v3/{name=projects/*}/alertPolicies\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -639,7 +658,7 @@ input_type=_GETALERTPOLICYREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY, serialized_options=_b( - "\202\323\344\223\002'\022%/v3/{name=projects/*/alertPolicies/*}" + "\202\323\344\223\002'\022%/v3/{name=projects/*/alertPolicies/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -650,7 +669,7 @@ input_type=_CREATEALERTPOLICYREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY, serialized_options=_b( - '\202\323\344\223\0023"#/v3/{name=projects/*}/alertPolicies:\014alert_policy' + '\202\323\344\223\0023"#/v3/{name=projects/*}/alertPolicies:\014alert_policy\332A\021name,alert_policy' ), ), _descriptor.MethodDescriptor( @@ -661,7 +680,7 @@ input_type=_DELETEALERTPOLICYREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002'*%/v3/{name=projects/*/alertPolicies/*}" + "\202\323\344\223\002'*%/v3/{name=projects/*/alertPolicies/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -672,7 +691,7 @@ input_type=_UPDATEALERTPOLICYREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY, serialized_options=_b( - "\202\323\344\223\002B22/v3/{alert_policy.name=projects/*/alertPolicies/*}:\014alert_policy" + "\202\323\344\223\002B22/v3/{alert_policy.name=projects/*/alertPolicies/*}:\014alert_policy\332A\030update_mask,alert_policy" ), ), ], diff --git a/monitoring/google/cloud/monitoring_v3/proto/common.proto b/monitoring/google/cloud/monitoring_v3/proto/common.proto index 1e89b0dcdaff..a4093b1c3880 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/common.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/common.proto @@ -79,329 +79,372 @@ message TimeInterval { google.protobuf.Timestamp start_time = 1; } -// Describes how to combine multiple time series to provide different views of -// the data. Aggregation consists of an alignment step on individual time -// series (`alignment_period` and `per_series_aligner`) followed by an optional -// reduction step of the data across the aligned time series -// (`cross_series_reducer` and `group_by_fields`). For more details, see -// [Aggregation](/monitoring/api/learn_more#aggregation). +// Describes how to combine multiple time series to provide a different view of +// the data. Aggregation of time series is done in two steps. First, each time +// series in the set is _aligned_ to the same time interval boundaries, then the +// set of time series is optionally _reduced_ in number. +// +// Alignment consists of applying the `per_series_aligner` operation +// to each time series after its data has been divided into regular +// `alignment_period` time intervals. This process takes _all_ of the data +// points in an alignment period, applies a mathematical transformation such as +// averaging, minimum, maximum, delta, etc., and converts them into a single +// data point per period. +// +// Reduction is when the aligned and transformed time series can optionally be +// combined, reducing the number of time series through similar mathematical +// transformations. Reduction involves applying a `cross_series_reducer` to +// all the time series, optionally sorting the time series into subsets with +// `group_by_fields`, and applying the reducer to each subset. +// +// The raw time series data can contain a huge amount of information from +// multiple sources. Alignment and reduction transforms this mass of data into +// a more manageable and representative collection of data, for example "the +// 95% latency across the average of all tasks in a cluster". This +// representative data can be more easily graphed and comprehended, and the +// individual time series data is still available for later drilldown. For more +// details, see [Aggregating Time +// Series](/monitoring/api/v3/metrics#aggregating_time_series). message Aggregation { - // The Aligner describes how to bring the data points in a single - // time series into temporal alignment. + // The `Aligner` specifies the operation that will be applied to the data + // points in each alignment period in a time series. Except for + // `ALIGN_NONE`, which specifies that no operation be applied, each alignment + // operation replaces the set of data values in each alignment period with + // a single value: the result of applying the operation to the data values. + // An aligned time series has a single data value at the end of each + // `alignment_period`. + // + // An alignment operation can change the data type of the values, too. For + // example, if you apply a counting operation to boolean values, the data + // `value_type` in the original time series is `BOOLEAN`, but the `value_type` + // in the aligned result is `INT64`. enum Aligner { - // No alignment. Raw data is returned. Not valid if cross-time - // series reduction is requested. The value type of the result is - // the same as the value type of the input. + // No alignment. Raw data is returned. Not valid if cross-series reduction + // is requested. The `value_type` of the result is the same as the + // `value_type` of the input. ALIGN_NONE = 0; - // Align and convert to delta metric type. This alignment is valid - // for cumulative metrics and delta metrics. Aligning an existing - // delta metric to a delta metric requires that the alignment - // period be increased. The value type of the result is the same - // as the value type of the input. + // Align and convert to + // [DELTA][google.api.MetricDescriptor.MetricKind.DELTA]. + // The output is `delta = y1 - y0`. // - // One can think of this aligner as a rate but without time units; that - // is, the output is conceptually (second_point - first_point). + // This alignment is valid for + // [CUMULATIVE][google.api.MetricDescriptor.MetricKind.CUMULATIVE] and + // `DELTA` metrics. If the selected alignment period results in periods + // with no data, then the aligned value for such a period is created by + // interpolation. The `value_type` of the aligned result is the same as + // the `value_type` of the input. ALIGN_DELTA = 1; - // Align and convert to a rate. This alignment is valid for - // cumulative metrics and delta metrics with numeric values. The output is a - // gauge metric with value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align and convert to a rate. The result is computed as + // `rate = (y1 - y0)/(t1 - t0)`, or "delta over time". + // Think of this aligner as providing the slope of the line that passes + // through the value at the start and at the end of the `alignment_period`. // - // One can think of this aligner as conceptually providing the slope of - // the line that passes through the value at the start and end of the - // window. In other words, this is conceptually ((y1 - y0)/(t1 - t0)), - // and the output unit is one that has a "/time" dimension. + // This aligner is valid for `CUMULATIVE` + // and `DELTA` metrics with numeric values. If the selected alignment + // period results in periods with no data, then the aligned value for + // such a period is created by interpolation. The output is a `GAUGE` + // metric with `value_type` `DOUBLE`. // - // If, by rate, you are looking for percentage change, see the - // `ALIGN_PERCENT_CHANGE` aligner option. + // If, by "rate", you mean "percentage change", see the + // `ALIGN_PERCENT_CHANGE` aligner instead. ALIGN_RATE = 2; - // Align by interpolating between adjacent points around the - // period boundary. This alignment is valid for gauge - // metrics with numeric values. The value type of the result is the same - // as the value type of the input. + // Align by interpolating between adjacent points around the alignment + // period boundary. This aligner is valid for `GAUGE` metrics with + // numeric values. The `value_type` of the aligned result is the same as the + // `value_type` of the input. ALIGN_INTERPOLATE = 3; - // Align by shifting the oldest data point before the period - // boundary to the boundary. This alignment is valid for gauge - // metrics. The value type of the result is the same as the - // value type of the input. + // Align by moving the most recent data point before the end of the + // alignment period to the boundary at the end of the alignment + // period. This aligner is valid for `GAUGE` metrics. The `value_type` of + // the aligned result is the same as the `value_type` of the input. ALIGN_NEXT_OLDER = 4; - // Align time series via aggregation. The resulting data point in - // the alignment period is the minimum of all data points in the - // period. This alignment is valid for gauge and delta metrics with numeric - // values. The value type of the result is the same as the value - // type of the input. + // Align the time series by returning the minimum value in each alignment + // period. This aligner is valid for `GAUGE` and `DELTA` metrics with + // numeric values. The `value_type` of the aligned result is the same as + // the `value_type` of the input. ALIGN_MIN = 10; - // Align time series via aggregation. The resulting data point in - // the alignment period is the maximum of all data points in the - // period. This alignment is valid for gauge and delta metrics with numeric - // values. The value type of the result is the same as the value - // type of the input. + // Align the time series by returning the maximum value in each alignment + // period. This aligner is valid for `GAUGE` and `DELTA` metrics with + // numeric values. The `value_type` of the aligned result is the same as + // the `value_type` of the input. ALIGN_MAX = 11; - // Align time series via aggregation. The resulting data point in - // the alignment period is the average or arithmetic mean of all - // data points in the period. This alignment is valid for gauge and delta - // metrics with numeric values. The value type of the output is - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by returning the mean value in each alignment + // period. This aligner is valid for `GAUGE` and `DELTA` metrics with + // numeric values. The `value_type` of the aligned result is `DOUBLE`. ALIGN_MEAN = 12; - // Align time series via aggregation. The resulting data point in - // the alignment period is the count of all data points in the - // period. This alignment is valid for gauge and delta metrics with numeric - // or Boolean values. The value type of the output is - // [INT64][google.api.MetricDescriptor.ValueType.INT64]. + // Align the time series by returning the number of values in each alignment + // period. This aligner is valid for `GAUGE` and `DELTA` metrics with + // numeric or Boolean values. The `value_type` of the aligned result is + // `INT64`. ALIGN_COUNT = 13; - // Align time series via aggregation. The resulting data point in - // the alignment period is the sum of all data points in the - // period. This alignment is valid for gauge and delta metrics with numeric - // and distribution values. The value type of the output is the - // same as the value type of the input. + // Align the time series by returning the sum of the values in each + // alignment period. This aligner is valid for `GAUGE` and `DELTA` + // metrics with numeric and distribution values. The `value_type` of the + // aligned result is the same as the `value_type` of the input. ALIGN_SUM = 14; - // Align time series via aggregation. The resulting data point in - // the alignment period is the standard deviation of all data - // points in the period. This alignment is valid for gauge and delta metrics - // with numeric values. The value type of the output is - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by returning the standard deviation of the values + // in each alignment period. This aligner is valid for `GAUGE` and + // `DELTA` metrics with numeric values. The `value_type` of the output is + // `DOUBLE`. ALIGN_STDDEV = 15; - // Align time series via aggregation. The resulting data point in - // the alignment period is the count of True-valued data points in the - // period. This alignment is valid for gauge metrics with - // Boolean values. The value type of the output is - // [INT64][google.api.MetricDescriptor.ValueType.INT64]. + // Align the time series by returning the number of `True` values in + // each alignment period. This aligner is valid for `GAUGE` metrics with + // Boolean values. The `value_type` of the output is `INT64`. ALIGN_COUNT_TRUE = 16; - // Align time series via aggregation. The resulting data point in - // the alignment period is the count of False-valued data points in the - // period. This alignment is valid for gauge metrics with - // Boolean values. The value type of the output is - // [INT64][google.api.MetricDescriptor.ValueType.INT64]. + // Align the time series by returning the number of `False` values in + // each alignment period. This aligner is valid for `GAUGE` metrics with + // Boolean values. The `value_type` of the output is `INT64`. ALIGN_COUNT_FALSE = 24; - // Align time series via aggregation. The resulting data point in - // the alignment period is the fraction of True-valued data points in the - // period. This alignment is valid for gauge metrics with Boolean values. - // The output value is in the range [0, 1] and has value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by returning the ratio of the number of `True` + // values to the total number of values in each alignment period. This + // aligner is valid for `GAUGE` metrics with Boolean values. The output + // value is in the range [0.0, 1.0] and has `value_type` `DOUBLE`. ALIGN_FRACTION_TRUE = 17; - // Align time series via aggregation. The resulting data point in - // the alignment period is the 99th percentile of all data - // points in the period. This alignment is valid for gauge and delta metrics - // with distribution values. The output is a gauge metric with value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by using [percentile + // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting + // data point in each alignment period is the 99th percentile of all data + // points in the period. This aligner is valid for `GAUGE` and `DELTA` + // metrics with distribution values. The output is a `GAUGE` metric with + // `value_type` `DOUBLE`. ALIGN_PERCENTILE_99 = 18; - // Align time series via aggregation. The resulting data point in - // the alignment period is the 95th percentile of all data - // points in the period. This alignment is valid for gauge and delta metrics - // with distribution values. The output is a gauge metric with value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by using [percentile + // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting + // data point in each alignment period is the 95th percentile of all data + // points in the period. This aligner is valid for `GAUGE` and `DELTA` + // metrics with distribution values. The output is a `GAUGE` metric with + // `value_type` `DOUBLE`. ALIGN_PERCENTILE_95 = 19; - // Align time series via aggregation. The resulting data point in - // the alignment period is the 50th percentile of all data - // points in the period. This alignment is valid for gauge and delta metrics - // with distribution values. The output is a gauge metric with value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by using [percentile + // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting + // data point in each alignment period is the 50th percentile of all data + // points in the period. This aligner is valid for `GAUGE` and `DELTA` + // metrics with distribution values. The output is a `GAUGE` metric with + // `value_type` `DOUBLE`. ALIGN_PERCENTILE_50 = 20; - // Align time series via aggregation. The resulting data point in - // the alignment period is the 5th percentile of all data - // points in the period. This alignment is valid for gauge and delta metrics - // with distribution values. The output is a gauge metric with value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Align the time series by using [percentile + // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting + // data point in each alignment period is the 5th percentile of all data + // points in the period. This aligner is valid for `GAUGE` and `DELTA` + // metrics with distribution values. The output is a `GAUGE` metric with + // `value_type` `DOUBLE`. ALIGN_PERCENTILE_05 = 21; - // Align and convert to a percentage change. This alignment is valid for - // gauge and delta metrics with numeric values. This alignment conceptually - // computes the equivalent of "((current - previous)/previous)*100" - // where previous value is determined based on the alignmentPeriod. - // In the event that previous is 0 the calculated value is infinity with the - // exception that if both (current - previous) and previous are 0 the - // calculated value is 0. - // A 10 minute moving mean is computed at each point of the time window + // Align and convert to a percentage change. This aligner is valid for + // `GAUGE` and `DELTA` metrics with numeric values. This alignment returns + // `((current - previous)/previous) * 100`, where the value of `previous` is + // determined based on the `alignment_period`. + // + // If the values of `current` and `previous` are both 0, then the returned + // value is 0. If only `previous` is 0, the returned value is infinity. + // + // A 10-minute moving mean is computed at each point of the alignment period // prior to the above calculation to smooth the metric and prevent false - // positives from very short lived spikes. - // Only applicable for data that is >= 0. Any values < 0 are treated as - // no data. While delta metrics are accepted by this alignment special care - // should be taken that the values for the metric will always be positive. - // The output is a gauge metric with value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // positives from very short-lived spikes. The moving mean is only + // applicable for data whose values are `>= 0`. Any values `< 0` are + // treated as a missing datapoint, and are ignored. While `DELTA` + // metrics are accepted by this alignment, special care should be taken that + // the values for the metric will always be positive. The output is a + // `GAUGE` metric with `value_type` `DOUBLE`. ALIGN_PERCENT_CHANGE = 23; } - // A Reducer describes how to aggregate data points from multiple - // time series into a single time series. + // A Reducer operation describes how to aggregate data points from multiple + // time series into a single time series, where the value of each data point + // in the resulting series is a function of all the already aligned values in + // the input time series. enum Reducer { - // No cross-time series reduction. The output of the aligner is + // No cross-time series reduction. The output of the `Aligner` is // returned. REDUCE_NONE = 0; - // Reduce by computing the mean across time series for each - // alignment period. This reducer is valid for delta and - // gauge metrics with numeric or distribution values. The value type of the - // output is [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Reduce by computing the mean value across time series for each + // alignment period. This reducer is valid for + // [DELTA][google.api.MetricDescriptor.MetricKind.DELTA] and + // [GAUGE][google.api.MetricDescriptor.MetricKind.GAUGE] metrics with + // numeric or distribution values. The `value_type` of the output is + // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. REDUCE_MEAN = 1; - // Reduce by computing the minimum across time series for each - // alignment period. This reducer is valid for delta and - // gauge metrics with numeric values. The value type of the output - // is the same as the value type of the input. + // Reduce by computing the minimum value across time series for each + // alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics + // with numeric values. The `value_type` of the output is the same as the + // `value_type` of the input. REDUCE_MIN = 2; - // Reduce by computing the maximum across time series for each - // alignment period. This reducer is valid for delta and - // gauge metrics with numeric values. The value type of the output - // is the same as the value type of the input. + // Reduce by computing the maximum value across time series for each + // alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics + // with numeric values. The `value_type` of the output is the same as the + // `value_type` of the input. REDUCE_MAX = 3; // Reduce by computing the sum across time series for each - // alignment period. This reducer is valid for delta and - // gauge metrics with numeric and distribution values. The value type of - // the output is the same as the value type of the input. + // alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics + // with numeric and distribution values. The `value_type` of the output is + // the same as the `value_type` of the input. REDUCE_SUM = 4; // Reduce by computing the standard deviation across time series - // for each alignment period. This reducer is valid for delta - // and gauge metrics with numeric or distribution values. The value type of - // the output is [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // for each alignment period. This reducer is valid for `DELTA` and + // `GAUGE` metrics with numeric or distribution values. The `value_type` + // of the output is `DOUBLE`. REDUCE_STDDEV = 5; - // Reduce by computing the count of data points across time series - // for each alignment period. This reducer is valid for delta - // and gauge metrics of numeric, Boolean, distribution, and string value - // type. The value type of the output is - // [INT64][google.api.MetricDescriptor.ValueType.INT64]. + // Reduce by computing the number of data points across time series + // for each alignment period. This reducer is valid for `DELTA` and + // `GAUGE` metrics of numeric, Boolean, distribution, and string + // `value_type`. The `value_type` of the output is `INT64`. REDUCE_COUNT = 6; - // Reduce by computing the count of True-valued data points across time - // series for each alignment period. This reducer is valid for delta - // and gauge metrics of Boolean value type. The value type of - // the output is [INT64][google.api.MetricDescriptor.ValueType.INT64]. + // Reduce by computing the number of `True`-valued data points across time + // series for each alignment period. This reducer is valid for `DELTA` and + // `GAUGE` metrics of Boolean `value_type`. The `value_type` of the output + // is `INT64`. REDUCE_COUNT_TRUE = 7; - // Reduce by computing the count of False-valued data points across time - // series for each alignment period. This reducer is valid for delta - // and gauge metrics of Boolean value type. The value type of - // the output is [INT64][google.api.MetricDescriptor.ValueType.INT64]. + // Reduce by computing the number of `False`-valued data points across time + // series for each alignment period. This reducer is valid for `DELTA` and + // `GAUGE` metrics of Boolean `value_type`. The `value_type` of the output + // is `INT64`. REDUCE_COUNT_FALSE = 15; - // Reduce by computing the fraction of True-valued data points across time - // series for each alignment period. This reducer is valid for delta - // and gauge metrics of Boolean value type. The output value is in the - // range [0, 1] and has value type - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]. + // Reduce by computing the ratio of the number of `True`-valued data points + // to the total number of data points for each alignment period. This + // reducer is valid for `DELTA` and `GAUGE` metrics of Boolean `value_type`. + // The output value is in the range [0.0, 1.0] and has `value_type` + // `DOUBLE`. REDUCE_FRACTION_TRUE = 8; - // Reduce by computing 99th percentile of data points across time series - // for each alignment period. This reducer is valid for gauge and delta - // metrics of numeric and distribution type. The value of the output is - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE] + // Reduce by computing the [99th + // percentile](https://en.wikipedia.org/wiki/Percentile) of data points + // across time series for each alignment period. This reducer is valid for + // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value + // of the output is `DOUBLE`. REDUCE_PERCENTILE_99 = 9; - // Reduce by computing 95th percentile of data points across time series - // for each alignment period. This reducer is valid for gauge and delta - // metrics of numeric and distribution type. The value of the output is - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE] + // Reduce by computing the [95th + // percentile](https://en.wikipedia.org/wiki/Percentile) of data points + // across time series for each alignment period. This reducer is valid for + // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value + // of the output is `DOUBLE`. REDUCE_PERCENTILE_95 = 10; - // Reduce by computing 50th percentile of data points across time series - // for each alignment period. This reducer is valid for gauge and delta - // metrics of numeric and distribution type. The value of the output is - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE] + // Reduce by computing the [50th + // percentile](https://en.wikipedia.org/wiki/Percentile) of data points + // across time series for each alignment period. This reducer is valid for + // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value + // of the output is `DOUBLE`. REDUCE_PERCENTILE_50 = 11; - // Reduce by computing 5th percentile of data points across time series - // for each alignment period. This reducer is valid for gauge and delta - // metrics of numeric and distribution type. The value of the output is - // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE] + // Reduce by computing the [5th + // percentile](https://en.wikipedia.org/wiki/Percentile) of data points + // across time series for each alignment period. This reducer is valid for + // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value + // of the output is `DOUBLE`. REDUCE_PERCENTILE_05 = 12; } - // The alignment period for per-[time series][google.monitoring.v3.TimeSeries] - // alignment. If present, `alignmentPeriod` must be at least 60 - // seconds. After per-time series alignment, each time series will - // contain data points only on the period boundaries. If - // `perSeriesAligner` is not specified or equals `ALIGN_NONE`, then - // this field is ignored. If `perSeriesAligner` is specified and - // does not equal `ALIGN_NONE`, then this field must be defined; - // otherwise an error is returned. + // The `alignment_period` specifies a time interval, in seconds, that is used + // to divide the data in all the + // [time series][google.monitoring.v3.TimeSeries] into consistent blocks of + // time. This will be done before the per-series aligner can be applied to + // the data. + // + // The value must be at least 60 seconds. If a per-series aligner other than + // `ALIGN_NONE` is specified, this field is required or an error is returned. + // If no per-series aligner is specified, or the aligner `ALIGN_NONE` is + // specified, then this field is ignored. google.protobuf.Duration alignment_period = 1; - // The approach to be used to align individual time series. Not all - // alignment functions may be applied to all time series, depending - // on the metric type and value type of the original time - // series. Alignment may change the metric type or the value type of + // An `Aligner` describes how to bring the data points in a single + // time series into temporal alignment. Except for `ALIGN_NONE`, all + // alignments cause all the data points in an `alignment_period` to be + // mathematically grouped together, resulting in a single data point for + // each `alignment_period` with end timestamp at the end of the period. + // + // Not all alignment operations may be applied to all time series. The valid + // choices depend on the `metric_kind` and `value_type` of the original time + // series. Alignment can change the `metric_kind` or the `value_type` of // the time series. // // Time series data must be aligned in order to perform cross-time - // series reduction. If `crossSeriesReducer` is specified, then - // `perSeriesAligner` must be specified and not equal `ALIGN_NONE` - // and `alignmentPeriod` must be specified; otherwise, an error is + // series reduction. If `cross_series_reducer` is specified, then + // `per_series_aligner` must be specified and not equal to `ALIGN_NONE` + // and `alignment_period` must be specified; otherwise, an error is // returned. Aligner per_series_aligner = 2; - // The approach to be used to combine time series. Not all reducer - // functions may be applied to all time series, depending on the - // metric type and the value type of the original time - // series. Reduction may change the metric type of value type of the - // time series. + // The reduction operation to be used to combine time series into a single + // time series, where the value of each data point in the resulting series is + // a function of all the already aligned values in the input time series. // - // Time series data must be aligned in order to perform cross-time - // series reduction. If `crossSeriesReducer` is specified, then - // `perSeriesAligner` must be specified and not equal `ALIGN_NONE` - // and `alignmentPeriod` must be specified; otherwise, an error is - // returned. + // Not all reducer operations can be applied to all time series. The valid + // choices depend on the `metric_kind` and the `value_type` of the original + // time series. Reduction can yield a time series with a different + // `metric_kind` or `value_type` than the input time series. + // + // Time series data must first be aligned (see `per_series_aligner`) in order + // to perform cross-time series reduction. If `cross_series_reducer` is + // specified, then `per_series_aligner` must be specified, and must not be + // `ALIGN_NONE`. An `alignment_period` must also be specified; otherwise, an + // error is returned. Reducer cross_series_reducer = 4; - // The set of fields to preserve when `crossSeriesReducer` is - // specified. The `groupByFields` determine how the time series are + // The set of fields to preserve when `cross_series_reducer` is + // specified. The `group_by_fields` determine how the time series are // partitioned into subsets prior to applying the aggregation - // function. Each subset contains time series that have the same + // operation. Each subset contains time series that have the same // value for each of the grouping fields. Each individual time // series is a member of exactly one subset. The - // `crossSeriesReducer` is applied to each subset of time series. + // `cross_series_reducer` is applied to each subset of time series. // It is not possible to reduce across different resource types, so // this field implicitly contains `resource.type`. Fields not - // specified in `groupByFields` are aggregated away. If - // `groupByFields` is not specified and all the time series have + // specified in `group_by_fields` are aggregated away. If + // `group_by_fields` is not specified and all the time series have // the same resource type, then the time series are aggregated into - // a single output time series. If `crossSeriesReducer` is not + // a single output time series. If `cross_series_reducer` is not // defined, this field is ignored. repeated string group_by_fields = 5; } -// Specifies an ordering relationship on two arguments, here called left and -// right. +// Specifies an ordering relationship on two arguments, called `left` and +// `right`. enum ComparisonType { // No ordering relationship is specified. COMPARISON_UNSPECIFIED = 0; - // The left argument is greater than the right argument. + // True if the left argument is greater than the right argument. COMPARISON_GT = 1; - // The left argument is greater than or equal to the right argument. + // True if the left argument is greater than or equal to the right argument. COMPARISON_GE = 2; - // The left argument is less than the right argument. + // True if the left argument is less than the right argument. COMPARISON_LT = 3; - // The left argument is less than or equal to the right argument. + // True if the left argument is less than or equal to the right argument. COMPARISON_LE = 4; - // The left argument is equal to the right argument. + // True if the left argument is equal to the right argument. COMPARISON_EQ = 5; - // The left argument is not equal to the right argument. + // True if the left argument is not equal to the right argument. COMPARISON_NE = 6; } diff --git a/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py index 51585dc065da..12b03a9cab81 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py @@ -723,63 +723,95 @@ dict( DESCRIPTOR=_AGGREGATION, __module__="google.cloud.monitoring_v3.proto.common_pb2", - __doc__="""Describes how to combine multiple time series to provide - different views of the data. Aggregation consists of an alignment step - on individual time series (``alignment_period`` and - ``per_series_aligner``) followed by an optional reduction step of the - data across the aligned time series (``cross_series_reducer`` and - ``group_by_fields``). For more details, see - `Aggregation `__. + __doc__="""Describes how to combine multiple time series to provide a + different view of the data. Aggregation of time series is done in two + steps. First, each time series in the set is *aligned* to the same time + interval boundaries, then the set of time series is optionally *reduced* + in number. + + Alignment consists of applying the ``per_series_aligner`` operation to + each time series after its data has been divided into regular + ``alignment_period`` time intervals. This process takes *all* of the + data points in an alignment period, applies a mathematical + transformation such as averaging, minimum, maximum, delta, etc., and + converts them into a single data point per period. + + Reduction is when the aligned and transformed time series can optionally + be combined, reducing the number of time series through similar + mathematical transformations. Reduction involves applying a + ``cross_series_reducer`` to all the time series, optionally sorting the + time series into subsets with ``group_by_fields``, and applying the + reducer to each subset. + + The raw time series data can contain a huge amount of information from + multiple sources. Alignment and reduction transforms this mass of data + into a more manageable and representative collection of data, for + example "the 95% latency across the average of all tasks in a cluster". + This representative data can be more easily graphed and comprehended, + and the individual time series data is still available for later + drilldown. For more details, see `Aggregating Time + Series `__. Attributes: alignment_period: - The alignment period for per-[time - series][google.monitoring.v3.TimeSeries] alignment. If - present, ``alignmentPeriod`` must be at least 60 seconds. - After per-time series alignment, each time series will contain - data points only on the period boundaries. If - ``perSeriesAligner`` is not specified or equals - ``ALIGN_NONE``, then this field is ignored. If - ``perSeriesAligner`` is specified and does not equal - ``ALIGN_NONE``, then this field must be defined; otherwise an - error is returned. + The ``alignment_period`` specifies a time interval, in + seconds, that is used to divide the data in all the [time + series][google.monitoring.v3.TimeSeries] into consistent + blocks of time. This will be done before the per-series + aligner can be applied to the data. The value must be at + least 60 seconds. If a per-series aligner other than + ``ALIGN_NONE`` is specified, this field is required or an + error is returned. If no per-series aligner is specified, or + the aligner ``ALIGN_NONE`` is specified, then this field is + ignored. per_series_aligner: - The approach to be used to align individual time series. Not - all alignment functions may be applied to all time series, - depending on the metric type and value type of the original - time series. Alignment may change the metric type or the value - type of the time series. Time series data must be aligned in - order to perform cross-time series reduction. If - ``crossSeriesReducer`` is specified, then ``perSeriesAligner`` - must be specified and not equal ``ALIGN_NONE`` and - ``alignmentPeriod`` must be specified; otherwise, an error is - returned. + An ``Aligner`` describes how to bring the data points in a + single time series into temporal alignment. Except for + ``ALIGN_NONE``, all alignments cause all the data points in an + ``alignment_period`` to be mathematically grouped together, + resulting in a single data point for each ``alignment_period`` + with end timestamp at the end of the period. Not all + alignment operations may be applied to all time series. The + valid choices depend on the ``metric_kind`` and ``value_type`` + of the original time series. Alignment can change the + ``metric_kind`` or the ``value_type`` of the time series. + Time series data must be aligned in order to perform cross- + time series reduction. If ``cross_series_reducer`` is + specified, then ``per_series_aligner`` must be specified and + not equal to ``ALIGN_NONE`` and ``alignment_period`` must be + specified; otherwise, an error is returned. cross_series_reducer: - The approach to be used to combine time series. Not all - reducer functions may be applied to all time series, depending - on the metric type and the value type of the original time - series. Reduction may change the metric type of value type of - the time series. Time series data must be aligned in order to - perform cross-time series reduction. If ``crossSeriesReducer`` - is specified, then ``perSeriesAligner`` must be specified and - not equal ``ALIGN_NONE`` and ``alignmentPeriod`` must be + The reduction operation to be used to combine time series into + a single time series, where the value of each data point in + the resulting series is a function of all the already aligned + values in the input time series. Not all reducer operations + can be applied to all time series. The valid choices depend on + the ``metric_kind`` and the ``value_type`` of the original + time series. Reduction can yield a time series with a + different ``metric_kind`` or ``value_type`` than the input + time series. Time series data must first be aligned (see + ``per_series_aligner``) in order to perform cross-time series + reduction. If ``cross_series_reducer`` is specified, then + ``per_series_aligner`` must be specified, and must not be + ``ALIGN_NONE``. An ``alignment_period`` must also be specified; otherwise, an error is returned. group_by_fields: - The set of fields to preserve when ``crossSeriesReducer`` is - specified. The ``groupByFields`` determine how the time series - are partitioned into subsets prior to applying the aggregation - function. Each subset contains time series that have the same - value for each of the grouping fields. Each individual time - series is a member of exactly one subset. The - ``crossSeriesReducer`` is applied to each subset of time + The set of fields to preserve when ``cross_series_reducer`` is + specified. The ``group_by_fields`` determine how the time + series are partitioned into subsets prior to applying the + aggregation operation. Each subset contains time series that + have the same value for each of the grouping fields. Each + individual time series is a member of exactly one subset. The + ``cross_series_reducer`` is applied to each subset of time series. It is not possible to reduce across different resource types, so this field implicitly contains ``resource.type``. - Fields not specified in ``groupByFields`` are aggregated away. - If ``groupByFields`` is not specified and all the time series - have the same resource type, then the time series are + Fields not specified in ``group_by_fields`` are aggregated + away. If ``group_by_fields`` is not specified and all the time + series have the same resource type, then the time series are aggregated into a single output time series. If - ``crossSeriesReducer`` is not defined, this field is ignored. + ``cross_series_reducer`` is not defined, this field is + ignored. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.Aggregation) ), diff --git a/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py index c4df545c33af..16f894908c67 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py @@ -142,9 +142,9 @@ ), DESCRIPTOR=_DROPPEDLABELS, __module__="google.cloud.monitoring_v3.proto.dropped_labels_pb2", - __doc__="""A set of (label, value) pairs which were dropped during - aggregation, attached to google.api.Distribution.Exemplars in - google.api.Distribution values during aggregation. + __doc__="""A set of (label, value) pairs which were dropped during aggregation, + attached to google.api.Distribution.Exemplars in google.api.Distribution + values during aggregation. These values are used in combination with the label values that remain on the aggregated Distribution timeseries to construct the full label diff --git a/monitoring/google/cloud/monitoring_v3/proto/group.proto b/monitoring/google/cloud/monitoring_v3/proto/group.proto index 716b270e1160..c6428071f338 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/group.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/group.proto @@ -17,6 +17,8 @@ syntax = "proto3"; package google.monitoring.v3; +import "google/api/resource.proto"; + option csharp_namespace = "Google.Cloud.Monitoring.V3"; option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring"; option java_multiple_files = true; @@ -51,6 +53,14 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3"; // depending on what resources exist and what filters are associated with the // group and its ancestors. message Group { + option (google.api.resource) = { + type: "monitoring.googleapis.com/Group" + pattern: "projects/{project}/groups/{group}" + pattern: "organizations/{organization}/groups/{group}" + pattern: "folders/{folder}/groups/{group}" + pattern: "*" + }; + // Output only. The name of this group. The format is // `"projects/{project_id_or_number}/groups/{group_id}"`. // When creating a group, this field is ignored and a new name is created diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py index fc1e159fea4b..de4953b3c483 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py @@ -15,6 +15,9 @@ _sym_db = _symbol_database.Default() +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 + + DESCRIPTOR = _descriptor.FileDescriptor( name="google/cloud/monitoring_v3/proto/group.proto", package="google.monitoring.v3", @@ -23,8 +26,9 @@ "\n\030com.google.monitoring.v3B\nGroupProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n,google/cloud/monitoring_v3/proto/group.proto\x12\x14google.monitoring.v3"d\n\x05Group\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0bparent_name\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x12\n\nis_cluster\x18\x06 \x01(\x08\x42\xa2\x01\n\x18\x63om.google.monitoring.v3B\nGroupProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n,google/cloud/monitoring_v3/proto/group.proto\x12\x14google.monitoring.v3\x1a\x19google/api/resource.proto"\x80\x02\n\x05Group\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0bparent_name\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x12\n\nis_cluster\x18\x06 \x01(\x08:\x99\x01\xea\x41\x95\x01\n\x1fmonitoring.googleapis.com/Group\x12!projects/{project}/groups/{group}\x12+organizations/{organization}/groups/{group}\x12\x1f\x66olders/{folder}/groups/{group}\x12\x01*B\xa2\x01\n\x18\x63om.google.monitoring.v3B\nGroupProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), + dependencies=[google_dot_api_dot_resource__pb2.DESCRIPTOR], ) @@ -129,13 +133,15 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=None, + serialized_options=_b( + "\352A\225\001\n\037monitoring.googleapis.com/Group\022!projects/{project}/groups/{group}\022+organizations/{organization}/groups/{group}\022\037folders/{folder}/groups/{group}\022\001*" + ), is_extendable=False, syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=70, - serialized_end=170, + serialized_start=98, + serialized_end=354, ) DESCRIPTOR.message_types_by_name["Group"] = _GROUP @@ -206,4 +212,5 @@ DESCRIPTOR._options = None +_GROUP._options = None # @@protoc_insertion_point(module_scope) diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_service.proto b/monitoring/google/cloud/monitoring_v3/proto/group_service.proto index bf91a916018d..5647dcfbffbc 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/group_service.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/group_service.proto @@ -18,11 +18,13 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/api/monitored_resource.proto"; +import "google/api/resource.proto"; import "google/monitoring/v3/common.proto"; import "google/monitoring/v3/group.proto"; import "google/protobuf/empty.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Cloud.Monitoring.V3"; option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring"; @@ -55,6 +57,7 @@ service GroupService { option (google.api.http) = { get: "/v3/{name=projects/*}/groups" }; + option (google.api.method_signature) = "name"; } // Gets a single group. @@ -62,6 +65,7 @@ service GroupService { option (google.api.http) = { get: "/v3/{name=projects/*/groups/*}" }; + option (google.api.method_signature) = "name"; } // Creates a new group. @@ -70,6 +74,7 @@ service GroupService { post: "/v3/{name=projects/*}/groups" body: "group" }; + option (google.api.method_signature) = "name,group"; } // Updates an existing group. @@ -79,6 +84,7 @@ service GroupService { put: "/v3/{group.name=projects/*/groups/*}" body: "group" }; + option (google.api.method_signature) = "group"; } // Deletes an existing group. @@ -86,6 +92,7 @@ service GroupService { option (google.api.http) = { delete: "/v3/{name=projects/*/groups/*}" }; + option (google.api.method_signature) = "name"; } // Lists the monitored resources that are members of a group. @@ -93,14 +100,20 @@ service GroupService { option (google.api.http) = { get: "/v3/{name=projects/*/groups/*}/members" }; + option (google.api.method_signature) = "name"; } } // The `ListGroup` request. message ListGroupsRequest { - // The project whose groups are to be listed. The format is + // Required. The project whose groups are to be listed. The format is // `"projects/{project_id_or_number}"`. - string name = 7; + string name = 7 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/Group" + } + ]; // An optional filter consisting of a single group name. The filters limit // the groups returned based on their parent-child relationship with the @@ -109,20 +122,26 @@ message ListGroupsRequest { // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`. // Returns groups whose `parentName` field contains the group // name. If no groups have this parent, the results are empty. - string children_of_group = 2; + string children_of_group = 2 [(google.api.resource_reference) = { + type: "monitoring.googleapis.com/Group" + }]; // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`. // Returns groups that are ancestors of the specified group. // The groups are returned in order, starting with the immediate parent and // ending with the most distant ancestor. If the specified group has no // immediate parent, the results are empty. - string ancestors_of_group = 3; + string ancestors_of_group = 3 [(google.api.resource_reference) = { + type: "monitoring.googleapis.com/Group" + }]; // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`. // Returns the descendants of the specified group. This is a superset of // the results returned by the `childrenOfGroup` filter, and includes // children-of-children, and so forth. - string descendants_of_group = 4; + string descendants_of_group = 4 [(google.api.resource_reference) = { + type: "monitoring.googleapis.com/Group" + }]; } // A positive number that is the maximum number of results to return. @@ -147,20 +166,30 @@ message ListGroupsResponse { // The `GetGroup` request. message GetGroupRequest { - // The group to retrieve. The format is + // Required. The group to retrieve. The format is // `"projects/{project_id_or_number}/groups/{group_id}"`. - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Group" + } + ]; } // The `CreateGroup` request. message CreateGroupRequest { - // The project in which to create the group. The format is + // Required. The project in which to create the group. The format is // `"projects/{project_id_or_number}"`. - string name = 4; - - // A group definition. It is an error to define the `name` field because + string name = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/Group" + } + ]; + + // Required. A group definition. It is an error to define the `name` field because // the system assigns the name. - Group group = 2; + Group group = 2 [(google.api.field_behavior) = REQUIRED]; // If true, validate this request but do not create the group. bool validate_only = 3; @@ -168,9 +197,9 @@ message CreateGroupRequest { // The `UpdateGroup` request. message UpdateGroupRequest { - // The new definition of the group. All fields of the existing 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. - Group group = 2; + Group group = 2 [(google.api.field_behavior) = REQUIRED]; // If true, validate this request but do not update the existing group. bool validate_only = 3; @@ -179,9 +208,14 @@ message UpdateGroupRequest { // The `DeleteGroup` request. The default behavior is to be able to delete a // single group without any descendants. message DeleteGroupRequest { - // The group to delete. The format is + // Required. The group to delete. The format is // `"projects/{project_id_or_number}/groups/{group_id}"`. - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Group" + } + ]; // If this field is true, then the request means to delete a group with all // its descendants. Otherwise, the request means to delete a group only when @@ -191,9 +225,14 @@ message DeleteGroupRequest { // The `ListGroupMembers` request. message ListGroupMembersRequest { - // The group whose members are listed. The format is + // Required. The group whose members are listed. The format is // `"projects/{project_id_or_number}/groups/{group_id}"`. - string name = 7; + string name = 7 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Group" + } + ]; // A positive number that is the maximum number of results to return. int32 page_size = 3; diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py index c16eeb9ce42e..f93cc4c588ce 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py @@ -16,9 +16,12 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import ( monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2, ) +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2, ) @@ -26,7 +29,6 @@ group_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2, ) from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 -from google.api import client_pb2 as google_dot_api_dot_client__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -37,15 +39,17 @@ "\n\030com.google.monitoring.v3B\021GroupServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n4google/cloud/monitoring_v3/proto/group_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a#google/api/monitored_resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a,google/cloud/monitoring_v3/proto/group.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x17google/api/client.proto"\xad\x01\n\x11ListGroupsRequest\x12\x0c\n\x04name\x18\x07 \x01(\t\x12\x1b\n\x11\x63hildren_of_group\x18\x02 \x01(\tH\x00\x12\x1c\n\x12\x61ncestors_of_group\x18\x03 \x01(\tH\x00\x12\x1e\n\x14\x64\x65scendants_of_group\x18\x04 \x01(\tH\x00\x12\x11\n\tpage_size\x18\x05 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\tB\x08\n\x06\x66ilter"Y\n\x12ListGroupsResponse\x12*\n\x05group\x18\x01 \x03(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1f\n\x0fGetGroupRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"e\n\x12\x43reateGroupRequest\x12\x0c\n\x04name\x18\x04 \x01(\t\x12*\n\x05group\x18\x02 \x01(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x15\n\rvalidate_only\x18\x03 \x01(\x08"W\n\x12UpdateGroupRequest\x12*\n\x05group\x18\x02 \x01(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x15\n\rvalidate_only\x18\x03 \x01(\x08"5\n\x12\x44\x65leteGroupRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x11\n\trecursive\x18\x04 \x01(\x08"\x94\x01\n\x17ListGroupMembersRequest\x12\x0c\n\x04name\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x34\n\x08interval\x18\x06 \x01(\x0b\x32".google.monitoring.v3.TimeInterval"w\n\x18ListGroupMembersResponse\x12.\n\x07members\x18\x01 \x03(\x0b\x32\x1d.google.api.MonitoredResource\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05\x32\xe7\x07\n\x0cGroupService\x12\x85\x01\n\nListGroups\x12\'.google.monitoring.v3.ListGroupsRequest\x1a(.google.monitoring.v3.ListGroupsResponse"$\x82\xd3\xe4\x93\x02\x1e\x12\x1c/v3/{name=projects/*}/groups\x12v\n\x08GetGroup\x12%.google.monitoring.v3.GetGroupRequest\x1a\x1b.google.monitoring.v3.Group"&\x82\xd3\xe4\x93\x02 \x12\x1e/v3/{name=projects/*/groups/*}\x12\x81\x01\n\x0b\x43reateGroup\x12(.google.monitoring.v3.CreateGroupRequest\x1a\x1b.google.monitoring.v3.Group"+\x82\xd3\xe4\x93\x02%"\x1c/v3/{name=projects/*}/groups:\x05group\x12\x89\x01\n\x0bUpdateGroup\x12(.google.monitoring.v3.UpdateGroupRequest\x1a\x1b.google.monitoring.v3.Group"3\x82\xd3\xe4\x93\x02-\x1a$/v3/{group.name=projects/*/groups/*}:\x05group\x12w\n\x0b\x44\x65leteGroup\x12(.google.monitoring.v3.DeleteGroupRequest\x1a\x16.google.protobuf.Empty"&\x82\xd3\xe4\x93\x02 *\x1e/v3/{name=projects/*/groups/*}\x12\xa1\x01\n\x10ListGroupMembers\x12-.google.monitoring.v3.ListGroupMembersRequest\x1a..google.monitoring.v3.ListGroupMembersResponse".\x82\xd3\xe4\x93\x02(\x12&/v3/{name=projects/*/groups/*}/members\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11GroupServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n4google/cloud/monitoring_v3/proto/group_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a#google/api/monitored_resource.proto\x1a\x19google/api/resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a,google/cloud/monitoring_v3/proto/group.proto\x1a\x1bgoogle/protobuf/empty.proto"\xc8\x02\n\x11ListGroupsRequest\x12\x35\n\x04name\x18\x07 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1fmonitoring.googleapis.com/Group\x12\x41\n\x11\x63hildren_of_group\x18\x02 \x01(\tB$\xfa\x41!\n\x1fmonitoring.googleapis.com/GroupH\x00\x12\x42\n\x12\x61ncestors_of_group\x18\x03 \x01(\tB$\xfa\x41!\n\x1fmonitoring.googleapis.com/GroupH\x00\x12\x44\n\x14\x64\x65scendants_of_group\x18\x04 \x01(\tB$\xfa\x41!\n\x1fmonitoring.googleapis.com/GroupH\x00\x12\x11\n\tpage_size\x18\x05 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\tB\x08\n\x06\x66ilter"Y\n\x12ListGroupsResponse\x12*\n\x05group\x18\x01 \x03(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetGroupRequest\x12\x35\n\x04name\x18\x03 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fmonitoring.googleapis.com/Group"\x93\x01\n\x12\x43reateGroupRequest\x12\x35\n\x04name\x18\x04 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1fmonitoring.googleapis.com/Group\x12/\n\x05group\x18\x02 \x01(\x0b\x32\x1b.google.monitoring.v3.GroupB\x03\xe0\x41\x02\x12\x15\n\rvalidate_only\x18\x03 \x01(\x08"\\\n\x12UpdateGroupRequest\x12/\n\x05group\x18\x02 \x01(\x0b\x32\x1b.google.monitoring.v3.GroupB\x03\xe0\x41\x02\x12\x15\n\rvalidate_only\x18\x03 \x01(\x08"^\n\x12\x44\x65leteGroupRequest\x12\x35\n\x04name\x18\x03 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fmonitoring.googleapis.com/Group\x12\x11\n\trecursive\x18\x04 \x01(\x08"\xbd\x01\n\x17ListGroupMembersRequest\x12\x35\n\x04name\x18\x07 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fmonitoring.googleapis.com/Group\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x34\n\x08interval\x18\x06 \x01(\x0b\x32".google.monitoring.v3.TimeInterval"w\n\x18ListGroupMembersResponse\x12.\n\x07members\x18\x01 \x03(\x0b\x32\x1d.google.api.MonitoredResource\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05\x32\x98\x08\n\x0cGroupService\x12\x8c\x01\n\nListGroups\x12\'.google.monitoring.v3.ListGroupsRequest\x1a(.google.monitoring.v3.ListGroupsResponse"+\x82\xd3\xe4\x93\x02\x1e\x12\x1c/v3/{name=projects/*}/groups\xda\x41\x04name\x12}\n\x08GetGroup\x12%.google.monitoring.v3.GetGroupRequest\x1a\x1b.google.monitoring.v3.Group"-\x82\xd3\xe4\x93\x02 \x12\x1e/v3/{name=projects/*/groups/*}\xda\x41\x04name\x12\x8e\x01\n\x0b\x43reateGroup\x12(.google.monitoring.v3.CreateGroupRequest\x1a\x1b.google.monitoring.v3.Group"8\x82\xd3\xe4\x93\x02%"\x1c/v3/{name=projects/*}/groups:\x05group\xda\x41\nname,group\x12\x91\x01\n\x0bUpdateGroup\x12(.google.monitoring.v3.UpdateGroupRequest\x1a\x1b.google.monitoring.v3.Group";\x82\xd3\xe4\x93\x02-\x1a$/v3/{group.name=projects/*/groups/*}:\x05group\xda\x41\x05group\x12~\n\x0b\x44\x65leteGroup\x12(.google.monitoring.v3.DeleteGroupRequest\x1a\x16.google.protobuf.Empty"-\x82\xd3\xe4\x93\x02 *\x1e/v3/{name=projects/*/groups/*}\xda\x41\x04name\x12\xa8\x01\n\x10ListGroupMembers\x12-.google.monitoring.v3.ListGroupMembersRequest\x1a..google.monitoring.v3.ListGroupMembersResponse"5\x82\xd3\xe4\x93\x02(\x12&/v3/{name=projects/*/groups/*}/members\xda\x41\x04name\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11GroupServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, - google_dot_api_dot_client__pb2.DESCRIPTOR, ], ) @@ -72,7 +76,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037monitoring.googleapis.com/Group" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -90,7 +96,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\372A!\n\037monitoring.googleapis.com/Group"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -108,7 +114,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\372A!\n\037monitoring.googleapis.com/Group"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -126,7 +132,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\372A!\n\037monitoring.googleapis.com/Group"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -182,8 +188,8 @@ fields=[], ) ], - serialized_start=293, - serialized_end=466, + serialized_start=353, + serialized_end=681, ) @@ -239,8 +245,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=468, - serialized_end=557, + serialized_start=683, + serialized_end=772, ) @@ -266,7 +272,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037monitoring.googleapis.com/Group" + ), file=DESCRIPTOR, ) ], @@ -278,8 +286,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=559, - serialized_end=590, + serialized_start=774, + serialized_end=846, ) @@ -305,7 +313,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037monitoring.googleapis.com/Group" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -323,7 +333,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -353,8 +363,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=592, - serialized_end=693, + serialized_start=849, + serialized_end=996, ) @@ -380,7 +390,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -410,8 +420,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=695, - serialized_end=782, + serialized_start=998, + serialized_end=1090, ) @@ -437,7 +447,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037monitoring.googleapis.com/Group" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -467,8 +479,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=784, - serialized_end=837, + serialized_start=1092, + serialized_end=1186, ) @@ -494,7 +506,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037monitoring.googleapis.com/Group" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -578,8 +592,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=840, - serialized_end=988, + serialized_start=1189, + serialized_end=1378, ) @@ -653,8 +667,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=990, - serialized_end=1109, + serialized_start=1380, + serialized_end=1499, ) _LISTGROUPSREQUEST.oneofs_by_name["filter"].fields.append( @@ -713,8 +727,8 @@ Attributes: name: - The project whose groups are to be listed. The format is - ``"projects/{project_id_or_number}"``. + Required. The project whose groups are to be listed. The + format is ``"projects/{project_id_or_number}"``. filter: An optional filter consisting of a single group name. The filters limit the groups returned based on their parent-child @@ -787,7 +801,7 @@ Attributes: name: - The group to retrieve. The format is + Required. The group to retrieve. The format is ``"projects/{project_id_or_number}/groups/{group_id}"``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetGroupRequest) @@ -806,11 +820,11 @@ Attributes: name: - The project in which to create the group. The format is - ``"projects/{project_id_or_number}"``. + Required. The project in which to create the group. The format + is ``"projects/{project_id_or_number}"``. group: - 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. validate_only: If true, validate this request but do not create the group. """, @@ -830,9 +844,9 @@ Attributes: group: - 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. validate_only: If true, validate this request but do not update the existing group. @@ -854,7 +868,7 @@ Attributes: name: - The group to delete. The format is + Required. The group to delete. The format is ``"projects/{project_id_or_number}/groups/{group_id}"``. recursive: If this field is true, then the request means to delete a @@ -878,7 +892,7 @@ Attributes: name: - The group whose members are listed. The format is + Required. The group whose members are listed. The format is ``"projects/{project_id_or_number}/groups/{group_id}"``. page_size: A positive number that is the maximum number of results to @@ -935,6 +949,16 @@ DESCRIPTOR._options = None +_LISTGROUPSREQUEST.fields_by_name["name"]._options = None +_LISTGROUPSREQUEST.fields_by_name["children_of_group"]._options = None +_LISTGROUPSREQUEST.fields_by_name["ancestors_of_group"]._options = None +_LISTGROUPSREQUEST.fields_by_name["descendants_of_group"]._options = None +_GETGROUPREQUEST.fields_by_name["name"]._options = None +_CREATEGROUPREQUEST.fields_by_name["name"]._options = None +_CREATEGROUPREQUEST.fields_by_name["group"]._options = None +_UPDATEGROUPREQUEST.fields_by_name["group"]._options = None +_DELETEGROUPREQUEST.fields_by_name["name"]._options = None +_LISTGROUPMEMBERSREQUEST.fields_by_name["name"]._options = None _GROUPSERVICE = _descriptor.ServiceDescriptor( name="GroupService", @@ -944,8 +968,8 @@ serialized_options=_b( "\312A\031monitoring.googleapis.com\322A\211\001https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read" ), - serialized_start=1112, - serialized_end=2111, + serialized_start=1502, + serialized_end=2550, methods=[ _descriptor.MethodDescriptor( name="ListGroups", @@ -955,7 +979,7 @@ input_type=_LISTGROUPSREQUEST, output_type=_LISTGROUPSRESPONSE, serialized_options=_b( - "\202\323\344\223\002\036\022\034/v3/{name=projects/*}/groups" + "\202\323\344\223\002\036\022\034/v3/{name=projects/*}/groups\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -966,7 +990,7 @@ input_type=_GETGROUPREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP, serialized_options=_b( - "\202\323\344\223\002 \022\036/v3/{name=projects/*/groups/*}" + "\202\323\344\223\002 \022\036/v3/{name=projects/*/groups/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -977,7 +1001,7 @@ input_type=_CREATEGROUPREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP, serialized_options=_b( - '\202\323\344\223\002%"\034/v3/{name=projects/*}/groups:\005group' + '\202\323\344\223\002%"\034/v3/{name=projects/*}/groups:\005group\332A\nname,group' ), ), _descriptor.MethodDescriptor( @@ -988,7 +1012,7 @@ input_type=_UPDATEGROUPREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP, serialized_options=_b( - "\202\323\344\223\002-\032$/v3/{group.name=projects/*/groups/*}:\005group" + "\202\323\344\223\002-\032$/v3/{group.name=projects/*/groups/*}:\005group\332A\005group" ), ), _descriptor.MethodDescriptor( @@ -999,7 +1023,7 @@ input_type=_DELETEGROUPREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002 *\036/v3/{name=projects/*/groups/*}" + "\202\323\344\223\002 *\036/v3/{name=projects/*/groups/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1010,7 +1034,7 @@ input_type=_LISTGROUPMEMBERSREQUEST, output_type=_LISTGROUPMEMBERSRESPONSE, serialized_options=_b( - "\202\323\344\223\002(\022&/v3/{name=projects/*/groups/*}/members" + "\202\323\344\223\002(\022&/v3/{name=projects/*/groups/*}/members\332A\004name" ), ), ], diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto b/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto index 101dee40e973..d5d2c334365c 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto @@ -18,15 +18,17 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/api/metric.proto"; import "google/api/monitored_resource.proto"; +import "google/api/resource.proto"; import "google/monitoring/v3/alert.proto"; import "google/monitoring/v3/common.proto"; import "google/monitoring/v3/metric.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Cloud.Monitoring.V3"; option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring"; @@ -34,6 +36,22 @@ option java_multiple_files = true; option java_outer_classname = "MetricServiceProto"; option java_package = "com.google.monitoring.v3"; option php_namespace = "Google\\Cloud\\Monitoring\\V3"; +option (google.api.resource_definition) = { + type: "monitoring.googleapis.com/MetricDescriptor" + pattern: "projects/{project}/metricDescriptors/{metric_descriptor=**}" + pattern: "organizations/{organization}/metricDescriptors/{metric_descriptor=**}" + pattern: "folders/{folder}/metricDescriptors/{metric_descriptor=**}" + pattern: "*" + history: ORIGINALLY_SINGLE_PATTERN +}; +option (google.api.resource_definition) = { + type: "monitoring.googleapis.com/MonitoredResourceDescriptor" + pattern: "projects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}" + pattern: "organizations/{organization}/monitoredResourceDescriptors/{monitored_resource_descriptor}" + pattern: "folders/{folder}/monitoredResourceDescriptors/{monitored_resource_descriptor}" + pattern: "*" + history: ORIGINALLY_SINGLE_PATTERN +}; // Manages metric descriptors, monitored resource descriptors, and // time series data. @@ -50,13 +68,15 @@ service MetricService { option (google.api.http) = { get: "/v3/{name=projects/*}/monitoredResourceDescriptors" }; + option (google.api.method_signature) = "name"; } // Gets a single monitored resource descriptor. This method does not require a Stackdriver account. rpc GetMonitoredResourceDescriptor(GetMonitoredResourceDescriptorRequest) returns (google.api.MonitoredResourceDescriptor) { option (google.api.http) = { - get: "/v3/{name=projects/*/monitoredResourceDescriptors/*}" + get: "/v3/{name=projects/*/monitoredResourceDescriptors/**}" }; + option (google.api.method_signature) = "name"; } // Lists metric descriptors that match a filter. This method does not require a Stackdriver account. @@ -64,6 +84,7 @@ service MetricService { option (google.api.http) = { get: "/v3/{name=projects/*}/metricDescriptors" }; + option (google.api.method_signature) = "name"; } // Gets a single metric descriptor. This method does not require a Stackdriver account. @@ -71,6 +92,7 @@ service MetricService { option (google.api.http) = { get: "/v3/{name=projects/*/metricDescriptors/**}" }; + option (google.api.method_signature) = "name"; } // Creates a new metric descriptor. @@ -81,6 +103,7 @@ service MetricService { post: "/v3/{name=projects/*}/metricDescriptors" body: "metric_descriptor" }; + option (google.api.method_signature) = "name,metric_descriptor"; } // Deletes a metric descriptor. Only user-created @@ -89,6 +112,7 @@ service MetricService { option (google.api.http) = { delete: "/v3/{name=projects/*/metricDescriptors/**}" }; + option (google.api.method_signature) = "name"; } // Lists time series that match a filter. This method does not require a Stackdriver account. @@ -96,6 +120,7 @@ service MetricService { option (google.api.http) = { get: "/v3/{name=projects/*}/timeSeries" }; + option (google.api.method_signature) = "name,filter,interval,view"; } // Creates or adds data to one or more time series. @@ -107,14 +132,20 @@ service MetricService { post: "/v3/{name=projects/*}/timeSeries" body: "*" }; + option (google.api.method_signature) = "name,time_series"; } } // The `ListMonitoredResourceDescriptors` request. message ListMonitoredResourceDescriptorsRequest { - // The project on which to execute the request. The format is + // Required. The project on which to execute the request. The format is // `"projects/{project_id_or_number}"`. - string name = 5; + string name = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/MonitoredResourceDescriptor" + } + ]; // An optional [filter](/monitoring/api/v3/filters) describing // the descriptors to be returned. The filter can reference @@ -148,18 +179,28 @@ message ListMonitoredResourceDescriptorsResponse { // The `GetMonitoredResourceDescriptor` request. message GetMonitoredResourceDescriptorRequest { - // The monitored resource descriptor to get. The format is + // Required. The monitored resource descriptor to get. The format is // `"projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}"`. // The `{resource_type}` is a predefined type, such as // `cloudsql_database`. - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/MonitoredResourceDescriptor" + } + ]; } // The `ListMetricDescriptors` request. message ListMetricDescriptorsRequest { - // The project on which to execute the request. The format is + // Required. The project on which to execute the request. The format is // `"projects/{project_id_or_number}"`. - string name = 5; + string name = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/MetricDescriptor" + } + ]; // If this field is empty, all custom and // system-defined metric descriptors are returned. @@ -194,31 +235,46 @@ message ListMetricDescriptorsResponse { // The `GetMetricDescriptor` request. message GetMetricDescriptorRequest { - // The metric descriptor on which to execute the request. The format is + // Required. The metric descriptor on which to execute the request. The format is // `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`. // An example value of `{metric_id}` is // `"compute.googleapis.com/instance/disk/read_bytes_count"`. - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/MetricDescriptor" + } + ]; } // The `CreateMetricDescriptor` request. message CreateMetricDescriptorRequest { - // The project on which to execute the request. The format is + // Required. The project on which to execute the request. The format is // `"projects/{project_id_or_number}"`. - string name = 3; - - // The new [custom metric](/monitoring/custom-metrics) + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/MetricDescriptor" + } + ]; + + // Required. The new [custom metric](/monitoring/custom-metrics) // descriptor. - google.api.MetricDescriptor metric_descriptor = 2; + google.api.MetricDescriptor metric_descriptor = 2 [(google.api.field_behavior) = REQUIRED]; } // The `DeleteMetricDescriptor` request. message DeleteMetricDescriptorRequest { - // The metric descriptor on which to execute the request. The format is + // Required. The metric descriptor on which to execute the request. The format is // `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`. // An example of `{metric_id}` is: // `"custom.googleapis.com/my_test_metric"`. - string name = 3; + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/MetricDescriptor" + } + ]; } // The `ListTimeSeries` request. @@ -234,23 +290,28 @@ message ListTimeSeriesRequest { HEADERS = 1; } - // The project on which to execute the request. The format is + // Required. The project on which to execute the request. The format is // "projects/{project_id_or_number}". - string name = 10; - - // A [monitoring filter](/monitoring/api/v3/filters) that specifies which time + string name = 10 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/TimeSeries" + } + ]; + + // Required. A [monitoring filter](/monitoring/api/v3/filters) that specifies which time // series should be returned. The filter must specify a single metric type, // and can additionally specify metric labels and other information. For // example: // // metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND // metric.labels.instance_name = "my-instance-name" - string filter = 2; + string filter = 2 [(google.api.field_behavior) = REQUIRED]; - // The time interval for which results should be returned. Only time series + // Required. The time interval for which results should be returned. Only time series // that contain data points in the specified interval are included // in the response. - TimeInterval interval = 4; + TimeInterval interval = 4 [(google.api.field_behavior) = REQUIRED]; // Specifies the alignment of data points in individual time series as // well as how to combine the retrieved time series across specified labels. @@ -263,8 +324,8 @@ message ListTimeSeriesRequest { // currently returned in reverse time order (most recent to oldest). string order_by = 6; - // Specifies which information is returned about the time series. - TimeSeriesView view = 7; + // Required. Specifies which information is returned about the time series. + TimeSeriesView view = 7 [(google.api.field_behavior) = REQUIRED]; // A positive number that is the maximum number of results to return. If // `page_size` is empty or more than 100,000 results, the effective @@ -296,18 +357,23 @@ message ListTimeSeriesResponse { // The `CreateTimeSeries` request. message CreateTimeSeriesRequest { - // The project on which to execute the request. The format is + // Required. The project on which to execute the request. The format is // `"projects/{project_id_or_number}"`. - string name = 3; - - // The new data to be added to a list of time series. + string name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/TimeSeries" + } + ]; + + // Required. The new data to be added to a list of time series. // Adds at most one data point to each of several time series. The new data // point must be more recent than any other point in its time series. Each // `TimeSeries` value must fully specify a unique time series by supplying // all label values for the metric and the monitored resource. // // The maximum number of `TimeSeries` objects per `Create` request is 200. - repeated TimeSeries time_series = 2; + repeated TimeSeries time_series = 2 [(google.api.field_behavior) = REQUIRED]; } // DEPRECATED. Used to hold per-time-series error status. diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py index 35069366b6d1..2838582a8fd3 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py @@ -16,10 +16,13 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import metric_pb2 as google_dot_api_dot_metric__pb2 from google.api import ( monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2, ) +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( alert_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2, ) @@ -32,7 +35,6 @@ from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2 -from google.api import client_pb2 as google_dot_api_dot_client__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -40,22 +42,24 @@ package="google.monitoring.v3", syntax="proto3", serialized_options=_b( - "\n\030com.google.monitoring.v3B\022MetricServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" + "\n\030com.google.monitoring.v3B\022MetricServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3\352A\360\001\n*monitoring.googleapis.com/MetricDescriptor\022;projects/{project}/metricDescriptors/{metric_descriptor=**}\022Eorganizations/{organization}/metricDescriptors/{metric_descriptor=**}\0229folders/{folder}/metricDescriptors/{metric_descriptor=**}\022\001* \001\352A\267\002\n5monitoring.googleapis.com/MonitoredResourceDescriptor\022Oprojects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}\022Yorganizations/{organization}/monitoredResourceDescriptors/{monitored_resource_descriptor}\022Mfolders/{folder}/monitoredResourceDescriptors/{monitored_resource_descriptor}\022\001* \001" ), serialized_pb=_b( - '\n5google/cloud/monitoring_v3/proto/metric_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/metric.proto\x1a#google/api/monitored_resource.proto\x1a,google/cloud/monitoring_v3/proto/alert.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a-google/cloud/monitoring_v3/proto/metric.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x17google/rpc/status.proto\x1a\x17google/api/client.proto"n\n\'ListMonitoredResourceDescriptorsRequest\x12\x0c\n\x04name\x18\x05 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x8a\x01\n(ListMonitoredResourceDescriptorsResponse\x12\x45\n\x14resource_descriptors\x18\x01 \x03(\x0b\x32\'.google.api.MonitoredResourceDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"5\n%GetMonitoredResourceDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"c\n\x1cListMetricDescriptorsRequest\x12\x0c\n\x04name\x18\x05 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"r\n\x1dListMetricDescriptorsResponse\x12\x38\n\x12metric_descriptors\x18\x01 \x03(\x0b\x32\x1c.google.api.MetricDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"*\n\x1aGetMetricDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"f\n\x1d\x43reateMetricDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x37\n\x11metric_descriptor\x18\x02 \x01(\x0b\x32\x1c.google.api.MetricDescriptor"-\n\x1d\x44\x65leteMetricDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"\xcf\x02\n\x15ListTimeSeriesRequest\x12\x0c\n\x04name\x18\n \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x34\n\x08interval\x18\x04 \x01(\x0b\x32".google.monitoring.v3.TimeInterval\x12\x36\n\x0b\x61ggregation\x18\x05 \x01(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12H\n\x04view\x18\x07 \x01(\x0e\x32:.google.monitoring.v3.ListTimeSeriesRequest.TimeSeriesView\x12\x11\n\tpage_size\x18\x08 \x01(\x05\x12\x12\n\npage_token\x18\t \x01(\t"\'\n\x0eTimeSeriesView\x12\x08\n\x04\x46ULL\x10\x00\x12\x0b\n\x07HEADERS\x10\x01"\x96\x01\n\x16ListTimeSeriesResponse\x12\x35\n\x0btime_series\x18\x01 \x03(\x0b\x32 .google.monitoring.v3.TimeSeries\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12,\n\x10\x65xecution_errors\x18\x03 \x03(\x0b\x32\x12.google.rpc.Status"^\n\x17\x43reateTimeSeriesRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x35\n\x0btime_series\x18\x02 \x03(\x0b\x32 .google.monitoring.v3.TimeSeries"z\n\x15\x43reateTimeSeriesError\x12\x39\n\x0btime_series\x18\x01 \x01(\x0b\x32 .google.monitoring.v3.TimeSeriesB\x02\x18\x01\x12&\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.StatusB\x02\x18\x01"\xd8\x01\n\x17\x43reateTimeSeriesSummary\x12\x19\n\x11total_point_count\x18\x01 \x01(\x05\x12\x1b\n\x13success_point_count\x18\x02 \x01(\x05\x12\x43\n\x06\x65rrors\x18\x03 \x03(\x0b\x32\x33.google.monitoring.v3.CreateTimeSeriesSummary.Error\x1a@\n\x05\x45rror\x12"\n\x06status\x18\x01 \x01(\x0b\x32\x12.google.rpc.Status\x12\x13\n\x0bpoint_count\x18\x02 \x01(\x05\x32\xd2\x0c\n\rMetricService\x12\xdd\x01\n ListMonitoredResourceDescriptors\x12=.google.monitoring.v3.ListMonitoredResourceDescriptorsRequest\x1a>.google.monitoring.v3.ListMonitoredResourceDescriptorsResponse":\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{name=projects/*}/monitoredResourceDescriptors\x12\xc4\x01\n\x1eGetMonitoredResourceDescriptor\x12;.google.monitoring.v3.GetMonitoredResourceDescriptorRequest\x1a\'.google.api.MonitoredResourceDescriptor"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v3/{name=projects/*/monitoredResourceDescriptors/*}\x12\xb1\x01\n\x15ListMetricDescriptors\x12\x32.google.monitoring.v3.ListMetricDescriptorsRequest\x1a\x33.google.monitoring.v3.ListMetricDescriptorsResponse"/\x82\xd3\xe4\x93\x02)\x12\'/v3/{name=projects/*}/metricDescriptors\x12\x99\x01\n\x13GetMetricDescriptor\x12\x30.google.monitoring.v3.GetMetricDescriptorRequest\x1a\x1c.google.api.MetricDescriptor"2\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*/metricDescriptors/**}\x12\xaf\x01\n\x16\x43reateMetricDescriptor\x12\x33.google.monitoring.v3.CreateMetricDescriptorRequest\x1a\x1c.google.api.MetricDescriptor"B\x82\xd3\xe4\x93\x02<"\'/v3/{name=projects/*}/metricDescriptors:\x11metric_descriptor\x12\x99\x01\n\x16\x44\x65leteMetricDescriptor\x12\x33.google.monitoring.v3.DeleteMetricDescriptorRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,**/v3/{name=projects/*/metricDescriptors/**}\x12\x95\x01\n\x0eListTimeSeries\x12+.google.monitoring.v3.ListTimeSeriesRequest\x1a,.google.monitoring.v3.ListTimeSeriesResponse"(\x82\xd3\xe4\x93\x02"\x12 /v3/{name=projects/*}/timeSeries\x12\x86\x01\n\x10\x43reateTimeSeries\x12-.google.monitoring.v3.CreateTimeSeriesRequest\x1a\x16.google.protobuf.Empty"+\x82\xd3\xe4\x93\x02%" /v3/{name=projects/*}/timeSeries:\x01*\x1a\xda\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\xba\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read,https://www.googleapis.com/auth/monitoring.writeB\xaa\x01\n\x18\x63om.google.monitoring.v3B\x12MetricServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n5google/cloud/monitoring_v3/proto/metric_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x17google/api/metric.proto\x1a#google/api/monitored_resource.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/monitoring_v3/proto/alert.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a-google/cloud/monitoring_v3/proto/metric.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x17google/rpc/status.proto"\xad\x01\n\'ListMonitoredResourceDescriptorsRequest\x12K\n\x04name\x18\x05 \x01(\tB=\xe0\x41\x02\xfa\x41\x37\x12\x35monitoring.googleapis.com/MonitoredResourceDescriptor\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x8a\x01\n(ListMonitoredResourceDescriptorsResponse\x12\x45\n\x14resource_descriptors\x18\x01 \x03(\x0b\x32\'.google.api.MonitoredResourceDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"t\n%GetMonitoredResourceDescriptorRequest\x12K\n\x04name\x18\x03 \x01(\tB=\xe0\x41\x02\xfa\x41\x37\n5monitoring.googleapis.com/MonitoredResourceDescriptor"\x97\x01\n\x1cListMetricDescriptorsRequest\x12@\n\x04name\x18\x05 \x01(\tB2\xe0\x41\x02\xfa\x41,\x12*monitoring.googleapis.com/MetricDescriptor\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"r\n\x1dListMetricDescriptorsResponse\x12\x38\n\x12metric_descriptors\x18\x01 \x03(\x0b\x32\x1c.google.api.MetricDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"^\n\x1aGetMetricDescriptorRequest\x12@\n\x04name\x18\x03 \x01(\tB2\xe0\x41\x02\xfa\x41,\n*monitoring.googleapis.com/MetricDescriptor"\x9f\x01\n\x1d\x43reateMetricDescriptorRequest\x12@\n\x04name\x18\x03 \x01(\tB2\xe0\x41\x02\xfa\x41,\x12*monitoring.googleapis.com/MetricDescriptor\x12<\n\x11metric_descriptor\x18\x02 \x01(\x0b\x32\x1c.google.api.MetricDescriptorB\x03\xe0\x41\x02"a\n\x1d\x44\x65leteMetricDescriptorRequest\x12@\n\x04name\x18\x03 \x01(\tB2\xe0\x41\x02\xfa\x41,\n*monitoring.googleapis.com/MetricDescriptor"\x8c\x03\n\x15ListTimeSeriesRequest\x12:\n\x04name\x18\n \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$monitoring.googleapis.com/TimeSeries\x12\x13\n\x06\x66ilter\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x39\n\x08interval\x18\x04 \x01(\x0b\x32".google.monitoring.v3.TimeIntervalB\x03\xe0\x41\x02\x12\x36\n\x0b\x61ggregation\x18\x05 \x01(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12M\n\x04view\x18\x07 \x01(\x0e\x32:.google.monitoring.v3.ListTimeSeriesRequest.TimeSeriesViewB\x03\xe0\x41\x02\x12\x11\n\tpage_size\x18\x08 \x01(\x05\x12\x12\n\npage_token\x18\t \x01(\t"\'\n\x0eTimeSeriesView\x12\x08\n\x04\x46ULL\x10\x00\x12\x0b\n\x07HEADERS\x10\x01"\x96\x01\n\x16ListTimeSeriesResponse\x12\x35\n\x0btime_series\x18\x01 \x03(\x0b\x32 .google.monitoring.v3.TimeSeries\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12,\n\x10\x65xecution_errors\x18\x03 \x03(\x0b\x32\x12.google.rpc.Status"\x91\x01\n\x17\x43reateTimeSeriesRequest\x12:\n\x04name\x18\x03 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$monitoring.googleapis.com/TimeSeries\x12:\n\x0btime_series\x18\x02 \x03(\x0b\x32 .google.monitoring.v3.TimeSeriesB\x03\xe0\x41\x02"z\n\x15\x43reateTimeSeriesError\x12\x39\n\x0btime_series\x18\x01 \x01(\x0b\x32 .google.monitoring.v3.TimeSeriesB\x02\x18\x01\x12&\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.StatusB\x02\x18\x01"\xd8\x01\n\x17\x43reateTimeSeriesSummary\x12\x19\n\x11total_point_count\x18\x01 \x01(\x05\x12\x1b\n\x13success_point_count\x18\x02 \x01(\x05\x12\x43\n\x06\x65rrors\x18\x03 \x03(\x0b\x32\x33.google.monitoring.v3.CreateTimeSeriesSummary.Error\x1a@\n\x05\x45rror\x12"\n\x06status\x18\x01 \x01(\x0b\x32\x12.google.rpc.Status\x12\x13\n\x0bpoint_count\x18\x02 \x01(\x05\x32\xbe\r\n\rMetricService\x12\xe4\x01\n ListMonitoredResourceDescriptors\x12=.google.monitoring.v3.ListMonitoredResourceDescriptorsRequest\x1a>.google.monitoring.v3.ListMonitoredResourceDescriptorsResponse"A\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{name=projects/*}/monitoredResourceDescriptors\xda\x41\x04name\x12\xcc\x01\n\x1eGetMonitoredResourceDescriptor\x12;.google.monitoring.v3.GetMonitoredResourceDescriptorRequest\x1a\'.google.api.MonitoredResourceDescriptor"D\x82\xd3\xe4\x93\x02\x37\x12\x35/v3/{name=projects/*/monitoredResourceDescriptors/**}\xda\x41\x04name\x12\xb8\x01\n\x15ListMetricDescriptors\x12\x32.google.monitoring.v3.ListMetricDescriptorsRequest\x1a\x33.google.monitoring.v3.ListMetricDescriptorsResponse"6\x82\xd3\xe4\x93\x02)\x12\'/v3/{name=projects/*}/metricDescriptors\xda\x41\x04name\x12\xa0\x01\n\x13GetMetricDescriptor\x12\x30.google.monitoring.v3.GetMetricDescriptorRequest\x1a\x1c.google.api.MetricDescriptor"9\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*/metricDescriptors/**}\xda\x41\x04name\x12\xc8\x01\n\x16\x43reateMetricDescriptor\x12\x33.google.monitoring.v3.CreateMetricDescriptorRequest\x1a\x1c.google.api.MetricDescriptor"[\x82\xd3\xe4\x93\x02<"\'/v3/{name=projects/*}/metricDescriptors:\x11metric_descriptor\xda\x41\x16name,metric_descriptor\x12\xa0\x01\n\x16\x44\x65leteMetricDescriptor\x12\x33.google.monitoring.v3.DeleteMetricDescriptorRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02,**/v3/{name=projects/*/metricDescriptors/**}\xda\x41\x04name\x12\xb1\x01\n\x0eListTimeSeries\x12+.google.monitoring.v3.ListTimeSeriesRequest\x1a,.google.monitoring.v3.ListTimeSeriesResponse"D\x82\xd3\xe4\x93\x02"\x12 /v3/{name=projects/*}/timeSeries\xda\x41\x19name,filter,interval,view\x12\x99\x01\n\x10\x43reateTimeSeries\x12-.google.monitoring.v3.CreateTimeSeriesRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02%" /v3/{name=projects/*}/timeSeries:\x01*\xda\x41\x10name,time_series\x1a\xda\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\xba\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read,https://www.googleapis.com/auth/monitoring.writeB\xd9\x05\n\x18\x63om.google.monitoring.v3B\x12MetricServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3\xea\x41\xf0\x01\n*monitoring.googleapis.com/MetricDescriptor\x12;projects/{project}/metricDescriptors/{metric_descriptor=**}\x12\x45organizations/{organization}/metricDescriptors/{metric_descriptor=**}\x12\x39\x66olders/{folder}/metricDescriptors/{metric_descriptor=**}\x12\x01* \x01\xea\x41\xb7\x02\n5monitoring.googleapis.com/MonitoredResourceDescriptor\x12Oprojects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}\x12Yorganizations/{organization}/monitoredResourceDescriptors/{monitored_resource_descriptor}\x12Mfolders/{folder}/monitoredResourceDescriptors/{monitored_resource_descriptor}\x12\x01* \x01\x62\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_metric__pb2.DESCRIPTOR, google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_rpc_dot_status__pb2.DESCRIPTOR, - google_dot_api_dot_client__pb2.DESCRIPTOR, ], ) @@ -75,8 +79,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=1439, - serialized_end=1478, + serialized_start=1902, + serialized_end=1941, ) _sym_db.RegisterEnumDescriptor(_LISTTIMESERIESREQUEST_TIMESERIESVIEW) @@ -103,7 +107,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A7\0225monitoring.googleapis.com/MonitoredResourceDescriptor" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -169,8 +175,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=422, - serialized_end=532, + serialized_start=483, + serialized_end=656, ) @@ -226,8 +232,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=535, - serialized_end=673, + serialized_start=659, + serialized_end=797, ) @@ -253,7 +259,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A7\n5monitoring.googleapis.com/MonitoredResourceDescriptor" + ), file=DESCRIPTOR, ) ], @@ -265,8 +273,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=675, - serialized_end=728, + serialized_start=799, + serialized_end=915, ) @@ -292,7 +300,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A,\022*monitoring.googleapis.com/MetricDescriptor" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -358,8 +368,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=730, - serialized_end=829, + serialized_start=918, + serialized_end=1069, ) @@ -415,8 +425,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=831, - serialized_end=945, + serialized_start=1071, + serialized_end=1185, ) @@ -442,7 +452,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A,\n*monitoring.googleapis.com/MetricDescriptor" + ), file=DESCRIPTOR, ) ], @@ -454,8 +466,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=947, - serialized_end=989, + serialized_start=1187, + serialized_end=1281, ) @@ -481,7 +493,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A,\022*monitoring.googleapis.com/MetricDescriptor" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -499,7 +513,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -511,8 +525,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=991, - serialized_end=1093, + serialized_start=1284, + serialized_end=1443, ) @@ -538,7 +552,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A,\n*monitoring.googleapis.com/MetricDescriptor" + ), file=DESCRIPTOR, ) ], @@ -550,8 +566,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1095, - serialized_end=1140, + serialized_start=1445, + serialized_end=1542, ) @@ -577,7 +593,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A&\022$monitoring.googleapis.com/TimeSeries" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -595,7 +613,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -613,7 +631,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -667,7 +685,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -715,8 +733,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1143, - serialized_end=1478, + serialized_start=1545, + serialized_end=1941, ) @@ -790,8 +808,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1481, - serialized_end=1631, + serialized_start=1944, + serialized_end=2094, ) @@ -817,7 +835,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A&\022$monitoring.googleapis.com/TimeSeries" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -835,7 +855,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -847,8 +867,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1633, - serialized_end=1727, + serialized_start=2097, + serialized_end=2242, ) @@ -904,8 +924,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1729, - serialized_end=1851, + serialized_start=2244, + serialized_end=2366, ) @@ -961,8 +981,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=2006, - serialized_end=2070, + serialized_start=2521, + serialized_end=2585, ) _CREATETIMESERIESSUMMARY = _descriptor.Descriptor( @@ -1035,8 +1055,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1854, - serialized_end=2070, + serialized_start=2369, + serialized_end=2585, ) _LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE.fields_by_name[ @@ -1134,8 +1154,8 @@ Attributes: name: - The project on which to execute the request. The format is - ``"projects/{project_id_or_number}"``. + Required. The project on which to execute the request. The + format is ``"projects/{project_id_or_number}"``. filter: An optional `filter `__ describing the descriptors to be returned. The filter can reference the @@ -1194,10 +1214,10 @@ Attributes: name: - The monitored resource descriptor to get. The format is ``"pro - jects/{project_id_or_number}/monitoredResourceDescriptors/{res - ource_type}"``. The ``{resource_type}`` is a predefined type, - such as ``cloudsql_database``. + Required. The monitored resource descriptor to get. The format + is ``"projects/{project_id_or_number}/monitoredResourceDescrip + tors/{resource_type}"``. The ``{resource_type}`` is a + predefined type, such as ``cloudsql_database``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetMonitoredResourceDescriptorRequest) ), @@ -1215,8 +1235,8 @@ Attributes: name: - The project on which to execute the request. The format is - ``"projects/{project_id_or_number}"``. + Required. The project on which to execute the request. The + format is ``"projects/{project_id_or_number}"``. filter: If this field is empty, all custom and system-defined metric descriptors are returned. Otherwise, the `filter @@ -1274,9 +1294,10 @@ Attributes: name: - The metric descriptor on which to execute the request. The - format is ``"projects/{project_id_or_number}/metricDescriptors - /{metric_id}"``. An example value of ``{metric_id}`` is + Required. The metric descriptor on which to execute the + request. The format is ``"projects/{project_id_or_number}/metr + icDescriptors/{metric_id}"``. An example value of + ``{metric_id}`` is ``"compute.googleapis.com/instance/disk/read_bytes_count"``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetMetricDescriptorRequest) @@ -1295,11 +1316,11 @@ Attributes: name: - The project on which to execute the request. The format is - ``"projects/{project_id_or_number}"``. + Required. The project on which to execute the request. The + format is ``"projects/{project_id_or_number}"``. metric_descriptor: - The new `custom metric `__ - descriptor. + Required. The new `custom metric `__ descriptor. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateMetricDescriptorRequest) ), @@ -1317,10 +1338,10 @@ Attributes: name: - The metric descriptor on which to execute the request. The - format is ``"projects/{project_id_or_number}/metricDescriptors - /{metric_id}"``. An example of ``{metric_id}`` is: - ``"custom.googleapis.com/my_test_metric"``. + Required. The metric descriptor on which to execute the + request. The format is ``"projects/{project_id_or_number}/metr + icDescriptors/{metric_id}"``. An example of ``{metric_id}`` + is: ``"custom.googleapis.com/my_test_metric"``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteMetricDescriptorRequest) ), @@ -1338,19 +1359,19 @@ Attributes: name: - The project on which to execute the request. The format is - "projects/{project\_id\_or\_number}". + Required. The project on which to execute the request. The + format is "projects/{project\_id\_or\_number}". filter: - A `monitoring filter `__ that - specifies which time series should be returned. The filter - must specify a single metric type, and can additionally + Required. A `monitoring filter `__ + that specifies which time series should be returned. The + filter must specify a single metric type, and can additionally specify metric labels and other information. For example: :: metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND metric.labels.instance_name = "my-instance-name" interval: - The time interval for which results should be returned. Only - time series that contain data points in the specified interval - are included in the response. + Required. The time interval for which results should be + returned. Only time series that contain data points in the + specified interval are included in the response. aggregation: Specifies the alignment of data points in individual time series as well as how to combine the retrieved time series @@ -1361,7 +1382,8 @@ series are currently returned in reverse time order (most recent to oldest). view: - Specifies which information is returned about the time series. + Required. Specifies which information is returned about the + time series. page_size: A positive number that is the maximum number of results to return. If ``page_size`` is empty or more than 100,000 @@ -1418,14 +1440,14 @@ Attributes: name: - The project on which to execute the request. The format is - ``"projects/{project_id_or_number}"``. + Required. The project on which to execute the request. The + format is ``"projects/{project_id_or_number}"``. time_series: - The new data to be added to a list of time series. Adds at - most one data point to each of several time series. The new - data point must be more recent than any other point in its - time series. Each ``TimeSeries`` value must fully specify a - unique time series by supplying all label values for the + Required. The new data to be added to a list of time series. + Adds at most one data point to each of several time series. + The new data point must be more recent than any other point in + its time series. Each ``TimeSeries`` value must fully specify + a unique time series by supplying all label values for the metric and the monitored resource. The maximum number of ``TimeSeries`` objects per ``Create`` request is 200. """, @@ -1502,6 +1524,19 @@ DESCRIPTOR._options = None +_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST.fields_by_name["name"]._options = None +_GETMONITOREDRESOURCEDESCRIPTORREQUEST.fields_by_name["name"]._options = None +_LISTMETRICDESCRIPTORSREQUEST.fields_by_name["name"]._options = None +_GETMETRICDESCRIPTORREQUEST.fields_by_name["name"]._options = None +_CREATEMETRICDESCRIPTORREQUEST.fields_by_name["name"]._options = None +_CREATEMETRICDESCRIPTORREQUEST.fields_by_name["metric_descriptor"]._options = None +_DELETEMETRICDESCRIPTORREQUEST.fields_by_name["name"]._options = None +_LISTTIMESERIESREQUEST.fields_by_name["name"]._options = None +_LISTTIMESERIESREQUEST.fields_by_name["filter"]._options = None +_LISTTIMESERIESREQUEST.fields_by_name["interval"]._options = None +_LISTTIMESERIESREQUEST.fields_by_name["view"]._options = None +_CREATETIMESERIESREQUEST.fields_by_name["name"]._options = None +_CREATETIMESERIESREQUEST.fields_by_name["time_series"]._options = None _CREATETIMESERIESERROR.fields_by_name["time_series"]._options = None _CREATETIMESERIESERROR.fields_by_name["status"]._options = None @@ -1513,8 +1548,8 @@ serialized_options=_b( "\312A\031monitoring.googleapis.com\322A\272\001https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read,https://www.googleapis.com/auth/monitoring.write" ), - serialized_start=2073, - serialized_end=3691, + serialized_start=2588, + serialized_end=4314, methods=[ _descriptor.MethodDescriptor( name="ListMonitoredResourceDescriptors", @@ -1524,7 +1559,7 @@ input_type=_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST, output_type=_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE, serialized_options=_b( - "\202\323\344\223\0024\0222/v3/{name=projects/*}/monitoredResourceDescriptors" + "\202\323\344\223\0024\0222/v3/{name=projects/*}/monitoredResourceDescriptors\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1535,7 +1570,7 @@ input_type=_GETMONITOREDRESOURCEDESCRIPTORREQUEST, output_type=google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCEDESCRIPTOR, serialized_options=_b( - "\202\323\344\223\0026\0224/v3/{name=projects/*/monitoredResourceDescriptors/*}" + "\202\323\344\223\0027\0225/v3/{name=projects/*/monitoredResourceDescriptors/**}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1546,7 +1581,7 @@ input_type=_LISTMETRICDESCRIPTORSREQUEST, output_type=_LISTMETRICDESCRIPTORSRESPONSE, serialized_options=_b( - "\202\323\344\223\002)\022'/v3/{name=projects/*}/metricDescriptors" + "\202\323\344\223\002)\022'/v3/{name=projects/*}/metricDescriptors\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1557,7 +1592,7 @@ input_type=_GETMETRICDESCRIPTORREQUEST, output_type=google_dot_api_dot_metric__pb2._METRICDESCRIPTOR, serialized_options=_b( - "\202\323\344\223\002,\022*/v3/{name=projects/*/metricDescriptors/**}" + "\202\323\344\223\002,\022*/v3/{name=projects/*/metricDescriptors/**}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1568,7 +1603,7 @@ input_type=_CREATEMETRICDESCRIPTORREQUEST, output_type=google_dot_api_dot_metric__pb2._METRICDESCRIPTOR, serialized_options=_b( - "\202\323\344\223\002<\"'/v3/{name=projects/*}/metricDescriptors:\021metric_descriptor" + "\202\323\344\223\002<\"'/v3/{name=projects/*}/metricDescriptors:\021metric_descriptor\332A\026name,metric_descriptor" ), ), _descriptor.MethodDescriptor( @@ -1579,7 +1614,7 @@ input_type=_DELETEMETRICDESCRIPTORREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002,**/v3/{name=projects/*/metricDescriptors/**}" + "\202\323\344\223\002,**/v3/{name=projects/*/metricDescriptors/**}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1590,7 +1625,7 @@ input_type=_LISTTIMESERIESREQUEST, output_type=_LISTTIMESERIESRESPONSE, serialized_options=_b( - '\202\323\344\223\002"\022 /v3/{name=projects/*}/timeSeries' + '\202\323\344\223\002"\022 /v3/{name=projects/*}/timeSeries\332A\031name,filter,interval,view' ), ), _descriptor.MethodDescriptor( @@ -1601,7 +1636,7 @@ input_type=_CREATETIMESERIESREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - '\202\323\344\223\002%" /v3/{name=projects/*}/timeSeries:\001*' + '\202\323\344\223\002%" /v3/{name=projects/*}/timeSeries:\001*\332A\020name,time_series' ), ), ], diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification.proto b/monitoring/google/cloud/monitoring_v3/proto/notification.proto index 939ca2677187..fb3ef4625d6b 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/notification.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/notification.proto @@ -19,6 +19,7 @@ package google.monitoring.v3; import "google/api/label.proto"; import "google/api/launch_stage.proto"; +import "google/api/resource.proto"; import "google/monitoring/v3/common.proto"; import "google/protobuf/wrappers.proto"; @@ -33,6 +34,14 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3"; // the properties of the channel and the set of labels or fields that // must be specified to configure channels of a given type. message NotificationChannelDescriptor { + option (google.api.resource) = { + type: "monitoring.googleapis.com/NotificationChannelDescriptor" + pattern: "projects/{project}/notificationChannelDescriptors/{channel_descriptor}" + pattern: "organizations/{organization}/notificationChannelDescriptors/{channel_descriptor}" + pattern: "folders/{folder}/notificationChannelDescriptors/{channel_descriptor}" + pattern: "*" + }; + // The full REST resource name for this descriptor. The syntax is: // // projects/[PROJECT_ID]/notificationChannelDescriptors/[TYPE] @@ -61,6 +70,9 @@ message NotificationChannelDescriptor { // The tiers that support this notification channel; the project service tier // must be one of the supported_tiers. repeated ServiceTier supported_tiers = 5 [deprecated = true]; + + // The product launch stage for channels of this type. + google.api.LaunchStage launch_stage = 7; } // A `NotificationChannel` is a medium through which an alert is @@ -69,6 +81,14 @@ message NotificationChannelDescriptor { // containing sensitive information like authentication tokens or // contact info are only partially populated on retrieval. message NotificationChannel { + option (google.api.resource) = { + type: "monitoring.googleapis.com/NotificationChannel" + pattern: "projects/{project}/notificationChannels/{notification_channel}" + pattern: "organizations/{organization}/notificationChannels/{notification_channel}" + pattern: "folders/{folder}/notificationChannels/{notification_channel}" + pattern: "*" + }; + // Indicates whether the channel has been verified or not. It is illegal // to specify this field in a // [`CreateNotificationChannel`][google.monitoring.v3.NotificationChannelService.CreateNotificationChannel] diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py index df10c8293d9e..1809978c23de 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py @@ -17,6 +17,7 @@ from google.api import label_pb2 as google_dot_api_dot_label__pb2 from google.api import launch_stage_pb2 as google_dot_api_dot_launch__stage__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2, ) @@ -31,11 +32,12 @@ "\n\030com.google.monitoring.v3B\021NotificationProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n3google/cloud/monitoring_v3/proto/notification.proto\x12\x14google.monitoring.v3\x1a\x16google/api/label.proto\x1a\x1dgoogle/api/launch_stage.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a\x1egoogle/protobuf/wrappers.proto"\xd3\x01\n\x1dNotificationChannelDescriptor\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12+\n\x06labels\x18\x04 \x03(\x0b\x32\x1b.google.api.LabelDescriptor\x12>\n\x0fsupported_tiers\x18\x05 \x03(\x0e\x32!.google.monitoring.v3.ServiceTierB\x02\x18\x01"\xb6\x04\n\x13NotificationChannel\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x45\n\x06labels\x18\x05 \x03(\x0b\x32\x35.google.monitoring.v3.NotificationChannel.LabelsEntry\x12N\n\x0buser_labels\x18\x08 \x03(\x0b\x32\x39.google.monitoring.v3.NotificationChannel.UserLabelsEntry\x12Y\n\x13verification_status\x18\t \x01(\x0e\x32<.google.monitoring.v3.NotificationChannel.VerificationStatus\x12+\n\x07\x65nabled\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"W\n\x12VerificationStatus\x12#\n\x1fVERIFICATION_STATUS_UNSPECIFIED\x10\x00\x12\x0e\n\nUNVERIFIED\x10\x01\x12\x0c\n\x08VERIFIED\x10\x02\x42\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11NotificationProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n3google/cloud/monitoring_v3/proto/notification.proto\x12\x14google.monitoring.v3\x1a\x16google/api/label.proto\x1a\x1dgoogle/api/launch_stage.proto\x1a\x19google/api/resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a\x1egoogle/protobuf/wrappers.proto"\xa5\x04\n\x1dNotificationChannelDescriptor\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12+\n\x06labels\x18\x04 \x03(\x0b\x32\x1b.google.api.LabelDescriptor\x12>\n\x0fsupported_tiers\x18\x05 \x03(\x0e\x32!.google.monitoring.v3.ServiceTierB\x02\x18\x01\x12-\n\x0claunch_stage\x18\x07 \x01(\x0e\x32\x17.google.api.LaunchStage:\xa0\x02\xea\x41\x9c\x02\n7monitoring.googleapis.com/NotificationChannelDescriptor\x12\x46projects/{project}/notificationChannelDescriptors/{channel_descriptor}\x12Porganizations/{organization}/notificationChannelDescriptors/{channel_descriptor}\x12\x44\x66olders/{folder}/notificationChannelDescriptors/{channel_descriptor}\x12\x01*"\xb7\x06\n\x13NotificationChannel\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x45\n\x06labels\x18\x05 \x03(\x0b\x32\x35.google.monitoring.v3.NotificationChannel.LabelsEntry\x12N\n\x0buser_labels\x18\x08 \x03(\x0b\x32\x39.google.monitoring.v3.NotificationChannel.UserLabelsEntry\x12Y\n\x13verification_status\x18\t \x01(\x0e\x32<.google.monitoring.v3.NotificationChannel.VerificationStatus\x12+\n\x07\x65nabled\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"W\n\x12VerificationStatus\x12#\n\x1fVERIFICATION_STATUS_UNSPECIFIED\x10\x00\x12\x0e\n\nUNVERIFIED\x10\x01\x12\x0c\n\x08VERIFIED\x10\x02:\xfe\x01\xea\x41\xfa\x01\n-monitoring.googleapis.com/NotificationChannel\x12>projects/{project}/notificationChannels/{notification_channel}\x12Horganizations/{organization}/notificationChannels/{notification_channel}\x12google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_label__pb2.DESCRIPTOR, google_dot_api_dot_launch__stage__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR, google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR, ], @@ -64,8 +66,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=905, - serialized_end=992, + serialized_start=1270, + serialized_end=1357, ) _sym_db.RegisterEnumDescriptor(_NOTIFICATIONCHANNEL_VERIFICATIONSTATUS) @@ -185,17 +187,37 @@ serialized_options=_b("\030\001"), file=DESCRIPTOR, ), + _descriptor.FieldDescriptor( + name="launch_stage", + full_name="google.monitoring.v3.NotificationChannelDescriptor.launch_stage", + index=6, + number=7, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=None, + serialized_options=_b( + "\352A\234\002\n7monitoring.googleapis.com/NotificationChannelDescriptor\022Fprojects/{project}/notificationChannelDescriptors/{channel_descriptor}\022Porganizations/{organization}/notificationChannelDescriptors/{channel_descriptor}\022Dfolders/{folder}/notificationChannelDescriptors/{channel_descriptor}\022\001*" + ), is_extendable=False, syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=212, - serialized_end=423, + serialized_start=239, + serialized_end=788, ) @@ -251,8 +273,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=807, - serialized_end=852, + serialized_start=1172, + serialized_end=1217, ) _NOTIFICATIONCHANNEL_USERLABELSENTRY = _descriptor.Descriptor( @@ -307,8 +329,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=854, - serialized_end=903, + serialized_start=1219, + serialized_end=1268, ) _NOTIFICATIONCHANNEL = _descriptor.Descriptor( @@ -469,13 +491,15 @@ _NOTIFICATIONCHANNEL_USERLABELSENTRY, ], enum_types=[_NOTIFICATIONCHANNEL_VERIFICATIONSTATUS], - serialized_options=None, + serialized_options=_b( + "\352A\372\001\n-monitoring.googleapis.com/NotificationChannel\022>projects/{project}/notificationChannels/{notification_channel}\022Horganizations/{organization}/notificationChannels/{notification_channel}\022google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n;google/cloud/monitoring_v3/proto/notification_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x33google/cloud/monitoring_v3/proto/notification.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/api/client.proto"`\n)ListNotificationChannelDescriptorsRequest\x12\x0c\n\x04name\x18\x04 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x97\x01\n*ListNotificationChannelDescriptorsResponse\x12P\n\x13\x63hannel_descriptors\x18\x01 \x03(\x0b\x32\x33.google.monitoring.v3.NotificationChannelDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"7\n\'GetNotificationChannelDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"y\n CreateNotificationChannelRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12G\n\x14notification_channel\x18\x02 \x01(\x0b\x32).google.monitoring.v3.NotificationChannel"x\n\x1fListNotificationChannelsRequest\x12\x0c\n\x04name\x18\x05 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x06 \x01(\t\x12\x10\n\x08order_by\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x85\x01\n ListNotificationChannelsResponse\x12H\n\x15notification_channels\x18\x03 \x03(\x0b\x32).google.monitoring.v3.NotificationChannel\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"-\n\x1dGetNotificationChannelRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"\x9c\x01\n UpdateNotificationChannelRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12G\n\x14notification_channel\x18\x03 \x01(\x0b\x32).google.monitoring.v3.NotificationChannel"?\n DeleteNotificationChannelRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\r\n\x05\x66orce\x18\x05 \x01(\x08">\n.SendNotificationChannelVerificationCodeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"n\n-GetNotificationChannelVerificationCodeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"o\n.GetNotificationChannelVerificationCodeResponse\x12\x0c\n\x04\x63ode\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp">\n VerifyNotificationChannelRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x63ode\x18\x02 \x01(\t2\xe7\x11\n\x1aNotificationChannelService\x12\xe5\x01\n"ListNotificationChannelDescriptors\x12?.google.monitoring.v3.ListNotificationChannelDescriptorsRequest\x1a@.google.monitoring.v3.ListNotificationChannelDescriptorsResponse"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v3/{name=projects/*}/notificationChannelDescriptors\x12\xd6\x01\n GetNotificationChannelDescriptor\x12=.google.monitoring.v3.GetNotificationChannelDescriptorRequest\x1a\x33.google.monitoring.v3.NotificationChannelDescriptor">\x82\xd3\xe4\x93\x02\x38\x12\x36/v3/{name=projects/*/notificationChannelDescriptors/*}\x12\xbd\x01\n\x18ListNotificationChannels\x12\x35.google.monitoring.v3.ListNotificationChannelsRequest\x1a\x36.google.monitoring.v3.ListNotificationChannelsResponse"2\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*}/notificationChannels\x12\xae\x01\n\x16GetNotificationChannel\x12\x33.google.monitoring.v3.GetNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"4\x82\xd3\xe4\x93\x02.\x12,/v3/{name=projects/*/notificationChannels/*}\x12\xc8\x01\n\x19\x43reateNotificationChannel\x12\x36.google.monitoring.v3.CreateNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"H\x82\xd3\xe4\x93\x02\x42"*/v3/{name=projects/*}/notificationChannels:\x14notification_channel\x12\xdf\x01\n\x19UpdateNotificationChannel\x12\x36.google.monitoring.v3.UpdateNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"_\x82\xd3\xe4\x93\x02Y2A/v3/{notification_channel.name=projects/*/notificationChannels/*}:\x14notification_channel\x12\xa1\x01\n\x19\x44\x65leteNotificationChannel\x12\x36.google.monitoring.v3.DeleteNotificationChannelRequest\x1a\x16.google.protobuf.Empty"4\x82\xd3\xe4\x93\x02.*,/v3/{name=projects/*/notificationChannels/*}\x12\xd5\x01\n\'SendNotificationChannelVerificationCode\x12\x44.google.monitoring.v3.SendNotificationChannelVerificationCodeRequest\x1a\x16.google.protobuf.Empty"L\x82\xd3\xe4\x93\x02\x46"A/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode:\x01*\x12\x80\x02\n&GetNotificationChannelVerificationCode\x12\x43.google.monitoring.v3.GetNotificationChannelVerificationCodeRequest\x1a\x44.google.monitoring.v3.GetNotificationChannelVerificationCodeResponse"K\x82\xd3\xe4\x93\x02\x45"@/v3/{name=projects/*/notificationChannels/*}:getVerificationCode:\x01*\x12\xbe\x01\n\x19VerifyNotificationChannel\x12\x36.google.monitoring.v3.VerifyNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel">\x82\xd3\xe4\x93\x02\x38"3/v3/{name=projects/*/notificationChannels/*}:verify:\x01*\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xb0\x01\n\x18\x63om.google.monitoring.v3B\x18NotificationServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n;google/cloud/monitoring_v3/proto/notification_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x33google/cloud/monitoring_v3/proto/notification.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xa1\x01\n)ListNotificationChannelDescriptorsRequest\x12M\n\x04name\x18\x04 \x01(\tB?\xe0\x41\x02\xfa\x41\x39\x12\x37monitoring.googleapis.com/NotificationChannelDescriptor\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x97\x01\n*ListNotificationChannelDescriptorsResponse\x12P\n\x13\x63hannel_descriptors\x18\x01 \x03(\x0b\x32\x33.google.monitoring.v3.NotificationChannelDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"x\n\'GetNotificationChannelDescriptorRequest\x12M\n\x04name\x18\x03 \x01(\tB?\xe0\x41\x02\xfa\x41\x39\n7monitoring.googleapis.com/NotificationChannelDescriptor"\xb5\x01\n CreateNotificationChannelRequest\x12\x43\n\x04name\x18\x03 \x01(\tB5\xe0\x41\x02\xfa\x41/\x12-monitoring.googleapis.com/NotificationChannel\x12L\n\x14notification_channel\x18\x02 \x01(\x0b\x32).google.monitoring.v3.NotificationChannelB\x03\xe0\x41\x02"\xaf\x01\n\x1fListNotificationChannelsRequest\x12\x43\n\x04name\x18\x05 \x01(\tB5\xe0\x41\x02\xfa\x41/\x12-monitoring.googleapis.com/NotificationChannel\x12\x0e\n\x06\x66ilter\x18\x06 \x01(\t\x12\x10\n\x08order_by\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x85\x01\n ListNotificationChannelsResponse\x12H\n\x15notification_channels\x18\x03 \x03(\x0b\x32).google.monitoring.v3.NotificationChannel\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"d\n\x1dGetNotificationChannelRequest\x12\x43\n\x04name\x18\x03 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-monitoring.googleapis.com/NotificationChannel"\xa1\x01\n UpdateNotificationChannelRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12L\n\x14notification_channel\x18\x03 \x01(\x0b\x32).google.monitoring.v3.NotificationChannelB\x03\xe0\x41\x02"v\n DeleteNotificationChannelRequest\x12\x43\n\x04name\x18\x03 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-monitoring.googleapis.com/NotificationChannel\x12\r\n\x05\x66orce\x18\x05 \x01(\x08"u\n.SendNotificationChannelVerificationCodeRequest\x12\x43\n\x04name\x18\x01 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-monitoring.googleapis.com/NotificationChannel"\xa5\x01\n-GetNotificationChannelVerificationCodeRequest\x12\x43\n\x04name\x18\x01 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-monitoring.googleapis.com/NotificationChannel\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"o\n.GetNotificationChannelVerificationCodeResponse\x12\x0c\n\x04\x63ode\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"z\n VerifyNotificationChannelRequest\x12\x43\n\x04name\x18\x01 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-monitoring.googleapis.com/NotificationChannel\x12\x11\n\x04\x63ode\x18\x02 \x01(\tB\x03\xe0\x41\x02\x32\xea\x12\n\x1aNotificationChannelService\x12\xec\x01\n"ListNotificationChannelDescriptors\x12?.google.monitoring.v3.ListNotificationChannelDescriptorsRequest\x1a@.google.monitoring.v3.ListNotificationChannelDescriptorsResponse"C\x82\xd3\xe4\x93\x02\x36\x12\x34/v3/{name=projects/*}/notificationChannelDescriptors\xda\x41\x04name\x12\xdd\x01\n GetNotificationChannelDescriptor\x12=.google.monitoring.v3.GetNotificationChannelDescriptorRequest\x1a\x33.google.monitoring.v3.NotificationChannelDescriptor"E\x82\xd3\xe4\x93\x02\x38\x12\x36/v3/{name=projects/*/notificationChannelDescriptors/*}\xda\x41\x04name\x12\xc4\x01\n\x18ListNotificationChannels\x12\x35.google.monitoring.v3.ListNotificationChannelsRequest\x1a\x36.google.monitoring.v3.ListNotificationChannelsResponse"9\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*}/notificationChannels\xda\x41\x04name\x12\xb5\x01\n\x16GetNotificationChannel\x12\x33.google.monitoring.v3.GetNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel";\x82\xd3\xe4\x93\x02.\x12,/v3/{name=projects/*/notificationChannels/*}\xda\x41\x04name\x12\xe4\x01\n\x19\x43reateNotificationChannel\x12\x36.google.monitoring.v3.CreateNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"d\x82\xd3\xe4\x93\x02\x42"*/v3/{name=projects/*}/notificationChannels:\x14notification_channel\xda\x41\x19name,notification_channel\x12\x83\x02\n\x19UpdateNotificationChannel\x12\x36.google.monitoring.v3.UpdateNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"\x82\x01\x82\xd3\xe4\x93\x02Y2A/v3/{notification_channel.name=projects/*/notificationChannels/*}:\x14notification_channel\xda\x41 update_mask,notification_channel\x12\xae\x01\n\x19\x44\x65leteNotificationChannel\x12\x36.google.monitoring.v3.DeleteNotificationChannelRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02.*,/v3/{name=projects/*/notificationChannels/*}\xda\x41\nname,force\x12\xdc\x01\n\'SendNotificationChannelVerificationCode\x12\x44.google.monitoring.v3.SendNotificationChannelVerificationCodeRequest\x1a\x16.google.protobuf.Empty"S\x82\xd3\xe4\x93\x02\x46"A/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode:\x01*\xda\x41\x04name\x12\x87\x02\n&GetNotificationChannelVerificationCode\x12\x43.google.monitoring.v3.GetNotificationChannelVerificationCodeRequest\x1a\x44.google.monitoring.v3.GetNotificationChannelVerificationCodeResponse"R\x82\xd3\xe4\x93\x02\x45"@/v3/{name=projects/*/notificationChannels/*}:getVerificationCode:\x01*\xda\x41\x04name\x12\xca\x01\n\x19VerifyNotificationChannel\x12\x36.google.monitoring.v3.VerifyNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"J\x82\xd3\xe4\x93\x02\x38"3/v3/{name=projects/*/notificationChannels/*}:verify:\x01*\xda\x41\tname,code\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xb0\x01\n\x18\x63om.google.monitoring.v3B\x18NotificationServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_api_dot_client__pb2.DESCRIPTOR, ], ) @@ -70,7 +74,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A9\0227monitoring.googleapis.com/NotificationChannelDescriptor" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -118,8 +124,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=319, - serialized_end=415, + serialized_start=380, + serialized_end=541, ) @@ -175,8 +181,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=418, - serialized_end=569, + serialized_start=544, + serialized_end=695, ) @@ -202,7 +208,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A9\n7monitoring.googleapis.com/NotificationChannelDescriptor" + ), file=DESCRIPTOR, ) ], @@ -214,8 +222,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=571, - serialized_end=626, + serialized_start=697, + serialized_end=817, ) @@ -241,7 +249,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\022-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -259,7 +269,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -271,8 +281,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=628, - serialized_end=749, + serialized_start=820, + serialized_end=1001, ) @@ -298,7 +308,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\022-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -382,8 +394,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=751, - serialized_end=871, + serialized_start=1004, + serialized_end=1179, ) @@ -439,8 +451,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=874, - serialized_end=1007, + serialized_start=1182, + serialized_end=1315, ) @@ -466,7 +478,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\n-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ) ], @@ -478,8 +492,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1009, - serialized_end=1054, + serialized_start=1317, + serialized_end=1417, ) @@ -523,7 +537,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -535,8 +549,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1057, - serialized_end=1213, + serialized_start=1420, + serialized_end=1581, ) @@ -562,7 +576,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\n-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -592,8 +608,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1215, - serialized_end=1278, + serialized_start=1583, + serialized_end=1701, ) @@ -619,7 +635,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\n-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ) ], @@ -631,8 +649,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1280, - serialized_end=1342, + serialized_start=1703, + serialized_end=1820, ) @@ -658,7 +676,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\n-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -688,8 +708,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1344, - serialized_end=1454, + serialized_start=1823, + serialized_end=1988, ) @@ -745,8 +765,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1456, - serialized_end=1567, + serialized_start=1990, + serialized_end=2101, ) @@ -772,7 +792,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A/\n-monitoring.googleapis.com/NotificationChannel" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -790,7 +812,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -802,8 +824,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1569, - serialized_end=1631, + serialized_start=2103, + serialized_end=2225, ) _LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE.fields_by_name[ @@ -887,13 +909,14 @@ Attributes: name: - The REST resource name of the parent from which to retrieve - the notification channel descriptors. The expected syntax is: - :: projects/[PROJECT_ID] Note that this names the parent - container in which to look for the descriptors; to retrieve a - single descriptor by name, use the [GetNotificationChannelDesc - riptor][google.monitoring.v3.NotificationChannelService.GetNot - ificationChannelDescriptor] operation, instead. + Required. The REST resource name of the parent from which to + retrieve the notification channel descriptors. The expected + syntax is: :: projects/[PROJECT_ID] Note that this + names the parent container in which to look for the + descriptors; to retrieve a single descriptor by name, use the + [GetNotificationChannelDescriptor][google.monitoring.v3.Notifi + cationChannelService.GetNotificationChannelDescriptor] + operation, instead. page_size: The maximum number of results to return in a single response. If not set to a positive number, a reasonable value will be @@ -943,9 +966,9 @@ Attributes: name: - The channel type for which to execute the request. The format - is ``projects/[PROJECT_ID]/notificationChannelDescriptors/{cha - nnel_type}``. + Required. The channel type for which to execute the request. + The format is ``projects/[PROJECT_ID]/notificationChannelDescr + iptors/{channel_type}``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetNotificationChannelDescriptorRequest) ), @@ -963,15 +986,16 @@ Attributes: name: - The project on which to execute the request. The format is: - :: projects/[PROJECT_ID] Note that this names the - container into which the channel will be written. This does - not name the newly created channel. The resulting channel's - name will have a normalized version of this field as a prefix, - but will add ``/notificationChannels/[CHANNEL_ID]`` to - identify the channel. + Required. The project on which to execute the request. The + format is: :: projects/[PROJECT_ID] Note that this + names the container into which the channel will be written. + This does not name the newly created channel. The resulting + channel's name will have a normalized version of this field as + a prefix, but will add ``/notificationChannels/[CHANNEL_ID]`` + to identify the channel. notification_channel: - The definition of the ``NotificationChannel`` to create. + Required. The definition of the ``NotificationChannel`` to + create. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateNotificationChannelRequest) ), @@ -989,13 +1013,13 @@ Attributes: name: - The project on which to execute the request. The format is - ``projects/[PROJECT_ID]``. That is, this names the container - in which to look for the notification channels; it does not - name a specific channel. To query a specific channel by REST - resource name, use the [``GetNotificationChannel``][google.mon - itoring.v3.NotificationChannelService.GetNotificationChannel] - operation. + Required. The project on which to execute the request. The + format is ``projects/[PROJECT_ID]``. That is, this names the + container in which to look for the notification channels; it + does not name a specific channel. To query a specific channel + by REST resource name, use the [``GetNotificationChannel``][go + ogle.monitoring.v3.NotificationChannelService.GetNotificationC + hannel] operation. filter: If provided, this field specifies the criteria that must be met by notification channels to be included in the response. @@ -1055,7 +1079,8 @@ Attributes: name: - The channel for which to execute the request. The format is + Required. The channel for which to execute the request. The + format is ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetNotificationChannelRequest) @@ -1076,8 +1101,8 @@ update_mask: The fields to update. notification_channel: - A description of the changes to be applied to the specified - notification channel. The description must provide a + Required. A description of the changes to be applied to the + specified notification channel. The description must provide a definition for fields to be updated; the names of these fields should also be included in the ``update_mask``. """, @@ -1097,7 +1122,8 @@ Attributes: name: - The channel for which to execute the request. The format is + Required. The channel for which to execute the request. The + format is ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``. force: If true, the notification channel will be deleted regardless @@ -1122,7 +1148,8 @@ Attributes: name: - The notification channel to which to send a verification code. + Required. The notification channel to which to send a + verification code. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.SendNotificationChannelVerificationCodeRequest) ), @@ -1140,10 +1167,10 @@ Attributes: name: - The notification channel for which a verification code is to - be generated and retrieved. This must name a channel that is - already verified; if the specified channel is not verified, - the request will fail. + Required. The notification channel for which a verification + code is to be generated and retrieved. This must name a + channel that is already verified; if the specified channel is + not verified, the request will fail. expire_time: The desired expiration time. If specified, the API will guarantee that the returned code will not be valid after the @@ -1200,10 +1227,10 @@ Attributes: name: - The notification channel to verify. + Required. The notification channel to verify. code: - The verification code that was delivered to the channel as a - result of invoking the + Required. The verification code that was delivered to the + channel as a result of invoking the ``SendNotificationChannelVerificationCode`` API method or that was retrieved from a verified channel via ``GetNotificationChannelVerificationCode``. For example, one @@ -1219,6 +1246,18 @@ DESCRIPTOR._options = None +_LISTNOTIFICATIONCHANNELDESCRIPTORSREQUEST.fields_by_name["name"]._options = None +_GETNOTIFICATIONCHANNELDESCRIPTORREQUEST.fields_by_name["name"]._options = None +_CREATENOTIFICATIONCHANNELREQUEST.fields_by_name["name"]._options = None +_CREATENOTIFICATIONCHANNELREQUEST.fields_by_name["notification_channel"]._options = None +_LISTNOTIFICATIONCHANNELSREQUEST.fields_by_name["name"]._options = None +_GETNOTIFICATIONCHANNELREQUEST.fields_by_name["name"]._options = None +_UPDATENOTIFICATIONCHANNELREQUEST.fields_by_name["notification_channel"]._options = None +_DELETENOTIFICATIONCHANNELREQUEST.fields_by_name["name"]._options = None +_SENDNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST.fields_by_name["name"]._options = None +_GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST.fields_by_name["name"]._options = None +_VERIFYNOTIFICATIONCHANNELREQUEST.fields_by_name["name"]._options = None +_VERIFYNOTIFICATIONCHANNELREQUEST.fields_by_name["code"]._options = None _NOTIFICATIONCHANNELSERVICE = _descriptor.ServiceDescriptor( name="NotificationChannelService", @@ -1228,8 +1267,8 @@ serialized_options=_b( "\312A\031monitoring.googleapis.com\322A\211\001https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read" ), - serialized_start=1634, - serialized_end=3913, + serialized_start=2228, + serialized_end=4638, methods=[ _descriptor.MethodDescriptor( name="ListNotificationChannelDescriptors", @@ -1239,7 +1278,7 @@ input_type=_LISTNOTIFICATIONCHANNELDESCRIPTORSREQUEST, output_type=_LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE, serialized_options=_b( - "\202\323\344\223\0026\0224/v3/{name=projects/*}/notificationChannelDescriptors" + "\202\323\344\223\0026\0224/v3/{name=projects/*}/notificationChannelDescriptors\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1250,7 +1289,7 @@ input_type=_GETNOTIFICATIONCHANNELDESCRIPTORREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNELDESCRIPTOR, serialized_options=_b( - "\202\323\344\223\0028\0226/v3/{name=projects/*/notificationChannelDescriptors/*}" + "\202\323\344\223\0028\0226/v3/{name=projects/*/notificationChannelDescriptors/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1261,7 +1300,7 @@ input_type=_LISTNOTIFICATIONCHANNELSREQUEST, output_type=_LISTNOTIFICATIONCHANNELSRESPONSE, serialized_options=_b( - "\202\323\344\223\002,\022*/v3/{name=projects/*}/notificationChannels" + "\202\323\344\223\002,\022*/v3/{name=projects/*}/notificationChannels\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1272,7 +1311,7 @@ input_type=_GETNOTIFICATIONCHANNELREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL, serialized_options=_b( - "\202\323\344\223\002.\022,/v3/{name=projects/*/notificationChannels/*}" + "\202\323\344\223\002.\022,/v3/{name=projects/*/notificationChannels/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1283,7 +1322,7 @@ input_type=_CREATENOTIFICATIONCHANNELREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL, serialized_options=_b( - '\202\323\344\223\002B"*/v3/{name=projects/*}/notificationChannels:\024notification_channel' + '\202\323\344\223\002B"*/v3/{name=projects/*}/notificationChannels:\024notification_channel\332A\031name,notification_channel' ), ), _descriptor.MethodDescriptor( @@ -1294,7 +1333,7 @@ input_type=_UPDATENOTIFICATIONCHANNELREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL, serialized_options=_b( - "\202\323\344\223\002Y2A/v3/{notification_channel.name=projects/*/notificationChannels/*}:\024notification_channel" + "\202\323\344\223\002Y2A/v3/{notification_channel.name=projects/*/notificationChannels/*}:\024notification_channel\332A update_mask,notification_channel" ), ), _descriptor.MethodDescriptor( @@ -1305,7 +1344,7 @@ input_type=_DELETENOTIFICATIONCHANNELREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002.*,/v3/{name=projects/*/notificationChannels/*}" + "\202\323\344\223\002.*,/v3/{name=projects/*/notificationChannels/*}\332A\nname,force" ), ), _descriptor.MethodDescriptor( @@ -1316,7 +1355,7 @@ input_type=_SENDNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - '\202\323\344\223\002F"A/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode:\001*' + '\202\323\344\223\002F"A/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1327,7 +1366,7 @@ input_type=_GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST, output_type=_GETNOTIFICATIONCHANNELVERIFICATIONCODERESPONSE, serialized_options=_b( - '\202\323\344\223\002E"@/v3/{name=projects/*/notificationChannels/*}:getVerificationCode:\001*' + '\202\323\344\223\002E"@/v3/{name=projects/*/notificationChannels/*}:getVerificationCode:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1338,7 +1377,7 @@ input_type=_VERIFYNOTIFICATIONCHANNELREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL, serialized_options=_b( - '\202\323\344\223\0028"3/v3/{name=projects/*/notificationChannels/*}:verify:\001*' + '\202\323\344\223\0028"3/v3/{name=projects/*/notificationChannels/*}:verify:\001*\332A\tname,code' ), ), ], diff --git a/monitoring/google/cloud/monitoring_v3/proto/service.proto b/monitoring/google/cloud/monitoring_v3/proto/service.proto index b0daa551e80b..82a953bde7a8 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/service.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/service.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/monitored_resource.proto"; +import "google/api/resource.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; import "google/type/calendar_period.proto"; @@ -35,6 +36,14 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3"; // Stackdriver Monitoring, a `Service` acts as the root resource under which // operational aspects of the service are accessible. message Service { + option (google.api.resource) = { + type: "monitoring.googleapis.com/Service" + pattern: "projects/{project}/services/{service}" + pattern: "organizations/{organization}/services/{service}" + pattern: "folders/{folder}/services/{service}" + pattern: "*" + }; + // Custom view of service telemetry. Currently a place-holder pending final // design. message Custom { @@ -118,6 +127,15 @@ message Service { // "99% of requests in each rolling week have latency below 200 milliseconds" or // "99.5% of requests in each calendar month return successfully." message ServiceLevelObjective { + option (google.api.resource) = { + type: "monitoring.googleapis.com/ServiceLevelObjective" + pattern: "projects/{project}/services/{service}/serviceLevelObjectives/{service_level_objective}" + pattern: "organizations/{organization}/services/{service}/serviceLevelObjectives/{service_level_objective}" + pattern: "folders/{folder}/services/{service}/serviceLevelObjectives/{service_level_objective}" + pattern: "*" + history: ORIGINALLY_SINGLE_PATTERN + }; + // `ServiceLevelObjective.View` determines what form of // `ServiceLevelObjective` is returned from `GetServiceLevelObjective`, // `ListServiceLevelObjectives`, and `ListServiceLevelObjectiveVersions` RPCs. diff --git a/monitoring/google/cloud/monitoring_v3/proto/service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/service_pb2.py index b5a6ffcfccc8..21371713bfe5 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/service_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/service_pb2.py @@ -18,6 +18,7 @@ from google.api import ( monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2, ) +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.type import calendar_period_pb2 as google_dot_type_dot_calendar__period__pb2 @@ -31,10 +32,11 @@ "\n\030com.google.monitoring.v3B\026ServiceMonitoringProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n.google/cloud/monitoring_v3/proto/service.proto\x12\x14google.monitoring.v3\x1a#google/api/monitored_resource.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a!google/type/calendar_period.proto"\xd6\x04\n\x07Service\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x36\n\x06\x63ustom\x18\x06 \x01(\x0b\x32$.google.monitoring.v3.Service.CustomH\x00\x12=\n\napp_engine\x18\x07 \x01(\x0b\x32\'.google.monitoring.v3.Service.AppEngineH\x00\x12G\n\x0f\x63loud_endpoints\x18\x08 \x01(\x0b\x32,.google.monitoring.v3.Service.CloudEndpointsH\x00\x12\x43\n\rcluster_istio\x18\t \x01(\x0b\x32*.google.monitoring.v3.Service.ClusterIstioH\x00\x12:\n\ttelemetry\x18\r \x01(\x0b\x32\'.google.monitoring.v3.Service.Telemetry\x1a\x08\n\x06\x43ustom\x1a\x1e\n\tAppEngine\x12\x11\n\tmodule_id\x18\x01 \x01(\t\x1a!\n\x0e\x43loudEndpoints\x12\x0f\n\x07service\x18\x01 \x01(\t\x1ag\n\x0c\x43lusterIstio\x12\x10\n\x08location\x18\x01 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x19\n\x11service_namespace\x18\x03 \x01(\t\x12\x14\n\x0cservice_name\x18\x04 \x01(\t\x1a"\n\tTelemetry\x12\x15\n\rresource_name\x18\x01 \x01(\tB\x0c\n\nidentifier"\xc4\x02\n\x15ServiceLevelObjective\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x0b \x01(\t\x12L\n\x17service_level_indicator\x18\x03 \x01(\x0b\x32+.google.monitoring.v3.ServiceLevelIndicator\x12\x0c\n\x04goal\x18\x04 \x01(\x01\x12\x33\n\x0erolling_period\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x36\n\x0f\x63\x61lendar_period\x18\x06 \x01(\x0e\x32\x1b.google.type.CalendarPeriodH\x00"4\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\x08\n\x04\x46ULL\x10\x02\x12\x0c\n\x08\x45XPLICIT\x10\x01\x42\x08\n\x06period"\xd4\x01\n\x15ServiceLevelIndicator\x12\x33\n\tbasic_sli\x18\x04 \x01(\x0b\x32\x1e.google.monitoring.v3.BasicSliH\x00\x12>\n\rrequest_based\x18\x01 \x01(\x0b\x32%.google.monitoring.v3.RequestBasedSliH\x00\x12>\n\rwindows_based\x18\x02 \x01(\x0b\x32%.google.monitoring.v3.WindowsBasedSliH\x00\x42\x06\n\x04type"\xb6\x02\n\x08\x42\x61sicSli\x12\x0e\n\x06method\x18\x07 \x03(\t\x12\x10\n\x08location\x18\x08 \x03(\t\x12\x0f\n\x07version\x18\t \x03(\t\x12K\n\x0c\x61vailability\x18\x02 \x01(\x0b\x32\x33.google.monitoring.v3.BasicSli.AvailabilityCriteriaH\x00\x12\x41\n\x07latency\x18\x03 \x01(\x0b\x32..google.monitoring.v3.BasicSli.LatencyCriteriaH\x00\x1a\x16\n\x14\x41vailabilityCriteria\x1a?\n\x0fLatencyCriteria\x12,\n\tthreshold\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x0e\n\x0csli_criteria"!\n\x05Range\x12\x0b\n\x03min\x18\x01 \x01(\x01\x12\x0b\n\x03max\x18\x02 \x01(\x01"\xa1\x01\n\x0fRequestBasedSli\x12\x41\n\x10good_total_ratio\x18\x01 \x01(\x0b\x32%.google.monitoring.v3.TimeSeriesRatioH\x00\x12\x41\n\x10\x64istribution_cut\x18\x03 \x01(\x0b\x32%.google.monitoring.v3.DistributionCutH\x00\x42\x08\n\x06method"h\n\x0fTimeSeriesRatio\x12\x1b\n\x13good_service_filter\x18\x04 \x01(\t\x12\x1a\n\x12\x62\x61\x64_service_filter\x18\x05 \x01(\t\x12\x1c\n\x14total_service_filter\x18\x06 \x01(\t"Z\n\x0f\x44istributionCut\x12\x1b\n\x13\x64istribution_filter\x18\x04 \x01(\t\x12*\n\x05range\x18\x05 \x01(\x0b\x32\x1b.google.monitoring.v3.Range"\x83\x05\n\x0fWindowsBasedSli\x12 \n\x16good_bad_metric_filter\x18\x05 \x01(\tH\x00\x12`\n\x1agood_total_ratio_threshold\x18\x02 \x01(\x0b\x32:.google.monitoring.v3.WindowsBasedSli.PerformanceThresholdH\x00\x12Q\n\x14metric_mean_in_range\x18\x06 \x01(\x0b\x32\x31.google.monitoring.v3.WindowsBasedSli.MetricRangeH\x00\x12P\n\x13metric_sum_in_range\x18\x07 \x01(\x0b\x32\x31.google.monitoring.v3.WindowsBasedSli.MetricRangeH\x00\x12\x30\n\rwindow_period\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x1a\xb0\x01\n\x14PerformanceThreshold\x12<\n\x0bperformance\x18\x01 \x01(\x0b\x32%.google.monitoring.v3.RequestBasedSliH\x00\x12?\n\x15\x62\x61sic_sli_performance\x18\x03 \x01(\x0b\x32\x1e.google.monitoring.v3.BasicSliH\x00\x12\x11\n\tthreshold\x18\x02 \x01(\x01\x42\x06\n\x04type\x1aN\n\x0bMetricRange\x12\x13\n\x0btime_series\x18\x01 \x01(\t\x12*\n\x05range\x18\x04 \x01(\x0b\x32\x1b.google.monitoring.v3.RangeB\x12\n\x10window_criterionB\xae\x01\n\x18\x63om.google.monitoring.v3B\x16ServiceMonitoringProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n.google/cloud/monitoring_v3/proto/service.proto\x12\x14google.monitoring.v3\x1a#google/api/monitored_resource.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a!google/type/calendar_period.proto"\x80\x06\n\x07Service\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x36\n\x06\x63ustom\x18\x06 \x01(\x0b\x32$.google.monitoring.v3.Service.CustomH\x00\x12=\n\napp_engine\x18\x07 \x01(\x0b\x32\'.google.monitoring.v3.Service.AppEngineH\x00\x12G\n\x0f\x63loud_endpoints\x18\x08 \x01(\x0b\x32,.google.monitoring.v3.Service.CloudEndpointsH\x00\x12\x43\n\rcluster_istio\x18\t \x01(\x0b\x32*.google.monitoring.v3.Service.ClusterIstioH\x00\x12:\n\ttelemetry\x18\r \x01(\x0b\x32\'.google.monitoring.v3.Service.Telemetry\x1a\x08\n\x06\x43ustom\x1a\x1e\n\tAppEngine\x12\x11\n\tmodule_id\x18\x01 \x01(\t\x1a!\n\x0e\x43loudEndpoints\x12\x0f\n\x07service\x18\x01 \x01(\t\x1ag\n\x0c\x43lusterIstio\x12\x10\n\x08location\x18\x01 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x19\n\x11service_namespace\x18\x03 \x01(\t\x12\x14\n\x0cservice_name\x18\x04 \x01(\t\x1a"\n\tTelemetry\x12\x15\n\rresource_name\x18\x01 \x01(\t:\xa7\x01\xea\x41\xa3\x01\n!monitoring.googleapis.com/Service\x12%projects/{project}/services/{service}\x12/organizations/{organization}/services/{service}\x12#folders/{folder}/services/{service}\x12\x01*B\x0c\n\nidentifier"\x91\x05\n\x15ServiceLevelObjective\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x0b \x01(\t\x12L\n\x17service_level_indicator\x18\x03 \x01(\x0b\x32+.google.monitoring.v3.ServiceLevelIndicator\x12\x0c\n\x04goal\x18\x04 \x01(\x01\x12\x33\n\x0erolling_period\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x36\n\x0f\x63\x61lendar_period\x18\x06 \x01(\x0e\x32\x1b.google.type.CalendarPeriodH\x00"4\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\x08\n\x04\x46ULL\x10\x02\x12\x0c\n\x08\x45XPLICIT\x10\x01:\xca\x02\xea\x41\xc6\x02\n/monitoring.googleapis.com/ServiceLevelObjective\x12Vprojects/{project}/services/{service}/serviceLevelObjectives/{service_level_objective}\x12`organizations/{organization}/services/{service}/serviceLevelObjectives/{service_level_objective}\x12Tfolders/{folder}/services/{service}/serviceLevelObjectives/{service_level_objective}\x12\x01* \x01\x42\x08\n\x06period"\xd4\x01\n\x15ServiceLevelIndicator\x12\x33\n\tbasic_sli\x18\x04 \x01(\x0b\x32\x1e.google.monitoring.v3.BasicSliH\x00\x12>\n\rrequest_based\x18\x01 \x01(\x0b\x32%.google.monitoring.v3.RequestBasedSliH\x00\x12>\n\rwindows_based\x18\x02 \x01(\x0b\x32%.google.monitoring.v3.WindowsBasedSliH\x00\x42\x06\n\x04type"\xb6\x02\n\x08\x42\x61sicSli\x12\x0e\n\x06method\x18\x07 \x03(\t\x12\x10\n\x08location\x18\x08 \x03(\t\x12\x0f\n\x07version\x18\t \x03(\t\x12K\n\x0c\x61vailability\x18\x02 \x01(\x0b\x32\x33.google.monitoring.v3.BasicSli.AvailabilityCriteriaH\x00\x12\x41\n\x07latency\x18\x03 \x01(\x0b\x32..google.monitoring.v3.BasicSli.LatencyCriteriaH\x00\x1a\x16\n\x14\x41vailabilityCriteria\x1a?\n\x0fLatencyCriteria\x12,\n\tthreshold\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x0e\n\x0csli_criteria"!\n\x05Range\x12\x0b\n\x03min\x18\x01 \x01(\x01\x12\x0b\n\x03max\x18\x02 \x01(\x01"\xa1\x01\n\x0fRequestBasedSli\x12\x41\n\x10good_total_ratio\x18\x01 \x01(\x0b\x32%.google.monitoring.v3.TimeSeriesRatioH\x00\x12\x41\n\x10\x64istribution_cut\x18\x03 \x01(\x0b\x32%.google.monitoring.v3.DistributionCutH\x00\x42\x08\n\x06method"h\n\x0fTimeSeriesRatio\x12\x1b\n\x13good_service_filter\x18\x04 \x01(\t\x12\x1a\n\x12\x62\x61\x64_service_filter\x18\x05 \x01(\t\x12\x1c\n\x14total_service_filter\x18\x06 \x01(\t"Z\n\x0f\x44istributionCut\x12\x1b\n\x13\x64istribution_filter\x18\x04 \x01(\t\x12*\n\x05range\x18\x05 \x01(\x0b\x32\x1b.google.monitoring.v3.Range"\x83\x05\n\x0fWindowsBasedSli\x12 \n\x16good_bad_metric_filter\x18\x05 \x01(\tH\x00\x12`\n\x1agood_total_ratio_threshold\x18\x02 \x01(\x0b\x32:.google.monitoring.v3.WindowsBasedSli.PerformanceThresholdH\x00\x12Q\n\x14metric_mean_in_range\x18\x06 \x01(\x0b\x32\x31.google.monitoring.v3.WindowsBasedSli.MetricRangeH\x00\x12P\n\x13metric_sum_in_range\x18\x07 \x01(\x0b\x32\x31.google.monitoring.v3.WindowsBasedSli.MetricRangeH\x00\x12\x30\n\rwindow_period\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x1a\xb0\x01\n\x14PerformanceThreshold\x12<\n\x0bperformance\x18\x01 \x01(\x0b\x32%.google.monitoring.v3.RequestBasedSliH\x00\x12?\n\x15\x62\x61sic_sli_performance\x18\x03 \x01(\x0b\x32\x1e.google.monitoring.v3.BasicSliH\x00\x12\x11\n\tthreshold\x18\x02 \x01(\x01\x42\x06\n\x04type\x1aN\n\x0bMetricRange\x12\x13\n\x0btime_series\x18\x01 \x01(\t\x12*\n\x05range\x18\x04 \x01(\x0b\x32\x1b.google.monitoring.v3.RangeB\x12\n\x10window_criterionB\xae\x01\n\x18\x63om.google.monitoring.v3B\x16ServiceMonitoringProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, google_dot_type_dot_calendar__period__pb2.DESCRIPTOR, @@ -64,8 +66,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=1073, - serialized_end=1125, + serialized_start=1270, + serialized_end=1322, ) _sym_db.RegisterEnumDescriptor(_SERVICELEVELOBJECTIVE_VIEW) @@ -85,8 +87,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=578, - serialized_end=586, + serialized_start=605, + serialized_end=613, ) _SERVICE_APPENGINE = _descriptor.Descriptor( @@ -123,8 +125,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=588, - serialized_end=618, + serialized_start=615, + serialized_end=645, ) _SERVICE_CLOUDENDPOINTS = _descriptor.Descriptor( @@ -161,8 +163,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=620, - serialized_end=653, + serialized_start=647, + serialized_end=680, ) _SERVICE_CLUSTERISTIO = _descriptor.Descriptor( @@ -253,8 +255,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=655, - serialized_end=758, + serialized_start=682, + serialized_end=785, ) _SERVICE_TELEMETRY = _descriptor.Descriptor( @@ -291,8 +293,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=760, - serialized_end=794, + serialized_start=787, + serialized_end=821, ) _SERVICE = _descriptor.Descriptor( @@ -438,7 +440,9 @@ _SERVICE_TELEMETRY, ], enum_types=[], - serialized_options=None, + serialized_options=_b( + "\352A\243\001\n!monitoring.googleapis.com/Service\022%projects/{project}/services/{service}\022/organizations/{organization}/services/{service}\022#folders/{folder}/services/{service}\022\001*" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -451,8 +455,8 @@ fields=[], ) ], - serialized_start=210, - serialized_end=808, + serialized_start=237, + serialized_end=1005, ) @@ -575,7 +579,9 @@ extensions=[], nested_types=[], enum_types=[_SERVICELEVELOBJECTIVE_VIEW], - serialized_options=None, + serialized_options=_b( + "\352A\306\002\n/monitoring.googleapis.com/ServiceLevelObjective\022Vprojects/{project}/services/{service}/serviceLevelObjectives/{service_level_objective}\022`organizations/{organization}/services/{service}/serviceLevelObjectives/{service_level_objective}\022Tfolders/{folder}/services/{service}/serviceLevelObjectives/{service_level_objective}\022\001* \001" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -588,8 +594,8 @@ fields=[], ) ], - serialized_start=811, - serialized_end=1135, + serialized_start=1008, + serialized_end=1665, ) @@ -671,8 +677,8 @@ fields=[], ) ], - serialized_start=1138, - serialized_end=1350, + serialized_start=1668, + serialized_end=1880, ) @@ -691,8 +697,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1560, - serialized_end=1582, + serialized_start=2090, + serialized_end=2112, ) _BASICSLI_LATENCYCRITERIA = _descriptor.Descriptor( @@ -729,8 +735,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1584, - serialized_end=1647, + serialized_start=2114, + serialized_end=2177, ) _BASICSLI = _descriptor.Descriptor( @@ -847,8 +853,8 @@ fields=[], ) ], - serialized_start=1353, - serialized_end=1663, + serialized_start=1883, + serialized_end=2193, ) @@ -904,8 +910,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1665, - serialized_end=1698, + serialized_start=2195, + serialized_end=2228, ) @@ -969,8 +975,8 @@ fields=[], ) ], - serialized_start=1701, - serialized_end=1862, + serialized_start=2231, + serialized_end=2392, ) @@ -1044,8 +1050,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1864, - serialized_end=1968, + serialized_start=2394, + serialized_end=2498, ) @@ -1101,8 +1107,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1970, - serialized_end=2060, + serialized_start=2500, + serialized_end=2590, ) @@ -1184,8 +1190,8 @@ fields=[], ) ], - serialized_start=2430, - serialized_end=2606, + serialized_start=2960, + serialized_end=3136, ) _WINDOWSBASEDSLI_METRICRANGE = _descriptor.Descriptor( @@ -1240,8 +1246,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=2608, - serialized_end=2686, + serialized_start=3138, + serialized_end=3216, ) _WINDOWSBASEDSLI = _descriptor.Descriptor( @@ -1358,8 +1364,8 @@ fields=[], ) ], - serialized_start=2063, - serialized_end=2706, + serialized_start=2593, + serialized_end=3236, ) _SERVICE_CUSTOM.containing_type = _SERVICE @@ -2069,4 +2075,6 @@ DESCRIPTOR._options = None +_SERVICE._options = None +_SERVICELEVELOBJECTIVE._options = None # @@protoc_insertion_point(module_scope) diff --git a/monitoring/google/cloud/monitoring_v3/proto/service_service.proto b/monitoring/google/cloud/monitoring_v3/proto/service_service.proto index e0a35833e5b8..5b9c096a0640 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/service_service.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/service_service.proto @@ -18,11 +18,13 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/api/monitored_resource.proto"; +import "google/api/resource.proto"; import "google/monitoring/v3/service.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Cloud.Monitoring.V3"; option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring"; @@ -48,6 +50,7 @@ service ServiceMonitoringService { post: "/v3/{parent=*/*}/services" body: "service" }; + option (google.api.method_signature) = "parent,service"; } // Get the named `Service`. @@ -55,6 +58,7 @@ service ServiceMonitoringService { option (google.api.http) = { get: "/v3/{name=*/*/services/*}" }; + option (google.api.method_signature) = "name"; } // List `Service`s for this workspace. @@ -62,6 +66,7 @@ service ServiceMonitoringService { option (google.api.http) = { get: "/v3/{parent=*/*}/services" }; + option (google.api.method_signature) = "parent"; } // Update this `Service`. @@ -70,6 +75,7 @@ service ServiceMonitoringService { patch: "/v3/{service.name=*/*/services/*}" body: "service" }; + option (google.api.method_signature) = "service"; } // Soft delete this `Service`. @@ -77,6 +83,7 @@ service ServiceMonitoringService { option (google.api.http) = { delete: "/v3/{name=*/*/services/*}" }; + option (google.api.method_signature) = "name"; } // Create a `ServiceLevelObjective` for the given `Service`. @@ -85,6 +92,7 @@ service ServiceMonitoringService { post: "/v3/{parent=*/*/services/*}/serviceLevelObjectives" body: "service_level_objective" }; + option (google.api.method_signature) = "parent,service_level_objective"; } // Get a `ServiceLevelObjective` by name. @@ -92,6 +100,7 @@ service ServiceMonitoringService { option (google.api.http) = { get: "/v3/{name=*/*/services/*/serviceLevelObjectives/*}" }; + option (google.api.method_signature) = "name"; } // List the `ServiceLevelObjective`s for the given `Service`. @@ -99,6 +108,7 @@ service ServiceMonitoringService { option (google.api.http) = { get: "/v3/{parent=*/*/services/*}/serviceLevelObjectives" }; + option (google.api.method_signature) = "parent"; } // Update the given `ServiceLevelObjective`. @@ -107,6 +117,7 @@ service ServiceMonitoringService { patch: "/v3/{service_level_objective.name=*/*/services/*/serviceLevelObjectives/*}" body: "service_level_objective" }; + option (google.api.method_signature) = "service_level_objective"; } // Delete the given `ServiceLevelObjective`. @@ -114,35 +125,51 @@ service ServiceMonitoringService { option (google.api.http) = { delete: "/v3/{name=*/*/services/*/serviceLevelObjectives/*}" }; + option (google.api.method_signature) = "name"; } } // The `CreateService` request. message CreateServiceRequest { - // Resource name of the parent workspace. + // Required. Resource name of the parent workspace. // Of the form `projects/{project_id}`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/Service" + } + ]; // Optional. The Service id to use for this Service. If omitted, an id will be // generated instead. Must match the pattern [a-z0-9\-]+ string service_id = 3; - // The `Service` to create. - Service service = 2; + // Required. The `Service` to create. + Service service = 2 [(google.api.field_behavior) = REQUIRED]; } // The `GetService` request. message GetServiceRequest { - // Resource name of the `Service`. + // Required. Resource name of the `Service`. // Of the form `projects/{project_id}/services/{service_id}`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Service" + } + ]; } // The `ListServices` request. message ListServicesRequest { - // Resource name of the parent `Workspace`. + // Required. Resource name of the parent `Workspace`. // Of the form `projects/{project_id}`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/Service" + } + ]; // A filter specifying what `Service`s to return. The filter currently // supports the following fields: @@ -184,9 +211,9 @@ message ListServicesResponse { // The `UpdateService` request. message UpdateServiceRequest { - // The `Service` to draw updates from. + // Required. The `Service` to draw updates from. // The given `name` specifies the resource to update. - Service service = 1; + Service service = 1 [(google.api.field_behavior) = REQUIRED]; // A set of field paths defining which fields to use for the update. google.protobuf.FieldMask update_mask = 2; @@ -194,34 +221,49 @@ message UpdateServiceRequest { // The `DeleteService` request. message DeleteServiceRequest { - // Resource name of the `Service` to delete. - // Of the form `projects/{project_id}/service/{service_id}`. - string name = 1; + // Required. Resource name of the `Service` to delete. + // Of the form `projects/{project_id}/services/{service_id}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Service" + } + ]; } // The `CreateServiceLevelObjective` request. message CreateServiceLevelObjectiveRequest { - // Resource name of the parent `Service`. + // Required. Resource name of the parent `Service`. // Of the form `projects/{project_id}/services/{service_id}`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Service" + } + ]; // Optional. The ServiceLevelObjective id to use for this // ServiceLevelObjective. If omitted, an id will be generated instead. Must // match the pattern [a-z0-9\-]+ string service_level_objective_id = 3; - // The `ServiceLevelObjective` to create. + // Required. The `ServiceLevelObjective` to create. // The provided `name` will be respected if no `ServiceLevelObjective` exists // with this name. - ServiceLevelObjective service_level_objective = 2; + ServiceLevelObjective service_level_objective = 2 [(google.api.field_behavior) = REQUIRED]; } // The `GetServiceLevelObjective` request. message GetServiceLevelObjectiveRequest { - // Resource name of the `ServiceLevelObjective` to get. + // Required. Resource name of the `ServiceLevelObjective` to get. // Of the form // `projects/{project_id}/services/{service_id}/serviceLevelObjectives/{slo_name}`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/ServiceLevelObjective" + } + ]; // View of the `ServiceLevelObjective` to return. If `DEFAULT`, return the // `ServiceLevelObjective` as originally defined. If `EXPLICIT` and the @@ -232,9 +274,14 @@ message GetServiceLevelObjectiveRequest { // The `ListServiceLevelObjectives` request. message ListServiceLevelObjectivesRequest { - // Resource name of the parent `Service`. + // Required. Resource name of the parent `Service`. // Of the form `projects/{project_id}/services/{service_id}`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/Service" + } + ]; // A filter specifying what `ServiceLevelObjective`s to return. string filter = 2; @@ -268,9 +315,9 @@ message ListServiceLevelObjectivesResponse { // The `UpdateServiceLevelObjective` request. message UpdateServiceLevelObjectiveRequest { - // The `ServiceLevelObjective` to draw updates from. + // Required. The `ServiceLevelObjective` to draw updates from. // The given `name` specifies the resource to update. - ServiceLevelObjective service_level_objective = 1; + ServiceLevelObjective service_level_objective = 1 [(google.api.field_behavior) = REQUIRED]; // A set of field paths defining which fields to use for the update. google.protobuf.FieldMask update_mask = 2; @@ -278,8 +325,13 @@ message UpdateServiceLevelObjectiveRequest { // The `DeleteServiceLevelObjective` request. message DeleteServiceLevelObjectiveRequest { - // Resource name of the `ServiceLevelObjective` to delete. + // Required. Resource name of the `ServiceLevelObjective` to delete. // Of the form // `projects/{project_id}/services/{service_id}/serviceLevelObjectives/{slo_name}`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/ServiceLevelObjective" + } + ]; } diff --git a/monitoring/google/cloud/monitoring_v3/proto/service_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/service_service_pb2.py index 4cc7aaa4aaca..2b8d989c66ad 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/service_service_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/service_service_pb2.py @@ -16,15 +16,17 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import ( monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2, ) +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( service_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2, ) from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 -from google.api import client_pb2 as google_dot_api_dot_client__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -35,15 +37,17 @@ "\n\030com.google.monitoring.v3B\035ServiceMonitoringServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n6google/cloud/monitoring_v3/proto/service_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a#google/api/monitored_resource.proto\x1a.google/cloud/monitoring_v3/proto/service.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/api/client.proto"j\n\x14\x43reateServiceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\nservice_id\x18\x03 \x01(\t\x12.\n\x07service\x18\x02 \x01(\x0b\x32\x1d.google.monitoring.v3.Service"!\n\x11GetServiceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x13ListServicesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x14ListServicesResponse\x12/\n\x08services\x18\x01 \x03(\x0b\x32\x1d.google.monitoring.v3.Service\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"w\n\x14UpdateServiceRequest\x12.\n\x07service\x18\x01 \x01(\x0b\x32\x1d.google.monitoring.v3.Service\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteServiceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xa6\x01\n"CreateServiceLevelObjectiveRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12"\n\x1aservice_level_objective_id\x18\x03 \x01(\t\x12L\n\x17service_level_objective\x18\x02 \x01(\x0b\x32+.google.monitoring.v3.ServiceLevelObjective"o\n\x1fGetServiceLevelObjectiveRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12>\n\x04view\x18\x02 \x01(\x0e\x32\x30.google.monitoring.v3.ServiceLevelObjective.View"\xaa\x01\n!ListServiceLevelObjectivesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12>\n\x04view\x18\x05 \x01(\x0e\x32\x30.google.monitoring.v3.ServiceLevelObjective.View"\x8c\x01\n"ListServiceLevelObjectivesResponse\x12M\n\x18service_level_objectives\x18\x01 \x03(\x0b\x32+.google.monitoring.v3.ServiceLevelObjective\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa3\x01\n"UpdateServiceLevelObjectiveRequest\x12L\n\x17service_level_objective\x18\x01 \x01(\x0b\x32+.google.monitoring.v3.ServiceLevelObjective\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"2\n"DeleteServiceLevelObjectiveRequest\x12\x0c\n\x04name\x18\x01 \x01(\t2\xe5\x0e\n\x18ServiceMonitoringService\x12\x86\x01\n\rCreateService\x12*.google.monitoring.v3.CreateServiceRequest\x1a\x1d.google.monitoring.v3.Service"*\x82\xd3\xe4\x93\x02$"\x19/v3/{parent=*/*}/services:\x07service\x12w\n\nGetService\x12\'.google.monitoring.v3.GetServiceRequest\x1a\x1d.google.monitoring.v3.Service"!\x82\xd3\xe4\x93\x02\x1b\x12\x19/v3/{name=*/*/services/*}\x12\x88\x01\n\x0cListServices\x12).google.monitoring.v3.ListServicesRequest\x1a*.google.monitoring.v3.ListServicesResponse"!\x82\xd3\xe4\x93\x02\x1b\x12\x19/v3/{parent=*/*}/services\x12\x8e\x01\n\rUpdateService\x12*.google.monitoring.v3.UpdateServiceRequest\x1a\x1d.google.monitoring.v3.Service"2\x82\xd3\xe4\x93\x02,2!/v3/{service.name=*/*/services/*}:\x07service\x12v\n\rDeleteService\x12*.google.monitoring.v3.DeleteServiceRequest\x1a\x16.google.protobuf.Empty"!\x82\xd3\xe4\x93\x02\x1b*\x19/v3/{name=*/*/services/*}\x12\xd9\x01\n\x1b\x43reateServiceLevelObjective\x12\x38.google.monitoring.v3.CreateServiceLevelObjectiveRequest\x1a+.google.monitoring.v3.ServiceLevelObjective"S\x82\xd3\xe4\x93\x02M"2/v3/{parent=*/*/services/*}/serviceLevelObjectives:\x17service_level_objective\x12\xba\x01\n\x18GetServiceLevelObjective\x12\x35.google.monitoring.v3.GetServiceLevelObjectiveRequest\x1a+.google.monitoring.v3.ServiceLevelObjective":\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{name=*/*/services/*/serviceLevelObjectives/*}\x12\xcb\x01\n\x1aListServiceLevelObjectives\x12\x37.google.monitoring.v3.ListServiceLevelObjectivesRequest\x1a\x38.google.monitoring.v3.ListServiceLevelObjectivesResponse":\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{parent=*/*/services/*}/serviceLevelObjectives\x12\xf1\x01\n\x1bUpdateServiceLevelObjective\x12\x38.google.monitoring.v3.UpdateServiceLevelObjectiveRequest\x1a+.google.monitoring.v3.ServiceLevelObjective"k\x82\xd3\xe4\x93\x02\x65\x32J/v3/{service_level_objective.name=*/*/services/*/serviceLevelObjectives/*}:\x17service_level_objective\x12\xab\x01\n\x1b\x44\x65leteServiceLevelObjective\x12\x38.google.monitoring.v3.DeleteServiceLevelObjectiveRequest\x1a\x16.google.protobuf.Empty":\x82\xd3\xe4\x93\x02\x34*2/v3/{name=*/*/services/*/serviceLevelObjectives/*}\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xb5\x01\n\x18\x63om.google.monitoring.v3B\x1dServiceMonitoringServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n6google/cloud/monitoring_v3/proto/service_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a#google/api/monitored_resource.proto\x1a\x19google/api/resource.proto\x1a.google/cloud/monitoring_v3/proto/service.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x9a\x01\n\x14\x43reateServiceRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!monitoring.googleapis.com/Service\x12\x12\n\nservice_id\x18\x03 \x01(\t\x12\x33\n\x07service\x18\x02 \x01(\x0b\x32\x1d.google.monitoring.v3.ServiceB\x03\xe0\x41\x02"L\n\x11GetServiceRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!monitoring.googleapis.com/Service"\x87\x01\n\x13ListServicesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!monitoring.googleapis.com/Service\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x14ListServicesResponse\x12/\n\x08services\x18\x01 \x03(\x0b\x32\x1d.google.monitoring.v3.Service\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"|\n\x14UpdateServiceRequest\x12\x33\n\x07service\x18\x01 \x01(\x0b\x32\x1d.google.monitoring.v3.ServiceB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"O\n\x14\x44\x65leteServiceRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!monitoring.googleapis.com/Service"\xd6\x01\n"CreateServiceLevelObjectiveRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!monitoring.googleapis.com/Service\x12"\n\x1aservice_level_objective_id\x18\x03 \x01(\t\x12Q\n\x17service_level_objective\x18\x02 \x01(\x0b\x32+.google.monitoring.v3.ServiceLevelObjectiveB\x03\xe0\x41\x02"\xa8\x01\n\x1fGetServiceLevelObjectiveRequest\x12\x45\n\x04name\x18\x01 \x01(\tB7\xe0\x41\x02\xfa\x41\x31\n/monitoring.googleapis.com/ServiceLevelObjective\x12>\n\x04view\x18\x02 \x01(\x0e\x32\x30.google.monitoring.v3.ServiceLevelObjective.View"\xd5\x01\n!ListServiceLevelObjectivesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!monitoring.googleapis.com/Service\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12>\n\x04view\x18\x05 \x01(\x0e\x32\x30.google.monitoring.v3.ServiceLevelObjective.View"\x8c\x01\n"ListServiceLevelObjectivesResponse\x12M\n\x18service_level_objectives\x18\x01 \x03(\x0b\x32+.google.monitoring.v3.ServiceLevelObjective\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa8\x01\n"UpdateServiceLevelObjectiveRequest\x12Q\n\x17service_level_objective\x18\x01 \x01(\x0b\x32+.google.monitoring.v3.ServiceLevelObjectiveB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"k\n"DeleteServiceLevelObjectiveRequest\x12\x45\n\x04name\x18\x01 \x01(\tB7\xe0\x41\x02\xfa\x41\x31\n/monitoring.googleapis.com/ServiceLevelObjective2\xea\x0f\n\x18ServiceMonitoringService\x12\x97\x01\n\rCreateService\x12*.google.monitoring.v3.CreateServiceRequest\x1a\x1d.google.monitoring.v3.Service";\x82\xd3\xe4\x93\x02$"\x19/v3/{parent=*/*}/services:\x07service\xda\x41\x0eparent,service\x12~\n\nGetService\x12\'.google.monitoring.v3.GetServiceRequest\x1a\x1d.google.monitoring.v3.Service"(\x82\xd3\xe4\x93\x02\x1b\x12\x19/v3/{name=*/*/services/*}\xda\x41\x04name\x12\x91\x01\n\x0cListServices\x12).google.monitoring.v3.ListServicesRequest\x1a*.google.monitoring.v3.ListServicesResponse"*\x82\xd3\xe4\x93\x02\x1b\x12\x19/v3/{parent=*/*}/services\xda\x41\x06parent\x12\x98\x01\n\rUpdateService\x12*.google.monitoring.v3.UpdateServiceRequest\x1a\x1d.google.monitoring.v3.Service"<\x82\xd3\xe4\x93\x02,2!/v3/{service.name=*/*/services/*}:\x07service\xda\x41\x07service\x12}\n\rDeleteService\x12*.google.monitoring.v3.DeleteServiceRequest\x1a\x16.google.protobuf.Empty"(\x82\xd3\xe4\x93\x02\x1b*\x19/v3/{name=*/*/services/*}\xda\x41\x04name\x12\xfa\x01\n\x1b\x43reateServiceLevelObjective\x12\x38.google.monitoring.v3.CreateServiceLevelObjectiveRequest\x1a+.google.monitoring.v3.ServiceLevelObjective"t\x82\xd3\xe4\x93\x02M"2/v3/{parent=*/*/services/*}/serviceLevelObjectives:\x17service_level_objective\xda\x41\x1eparent,service_level_objective\x12\xc1\x01\n\x18GetServiceLevelObjective\x12\x35.google.monitoring.v3.GetServiceLevelObjectiveRequest\x1a+.google.monitoring.v3.ServiceLevelObjective"A\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{name=*/*/services/*/serviceLevelObjectives/*}\xda\x41\x04name\x12\xd4\x01\n\x1aListServiceLevelObjectives\x12\x37.google.monitoring.v3.ListServiceLevelObjectivesRequest\x1a\x38.google.monitoring.v3.ListServiceLevelObjectivesResponse"C\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{parent=*/*/services/*}/serviceLevelObjectives\xda\x41\x06parent\x12\x8c\x02\n\x1bUpdateServiceLevelObjective\x12\x38.google.monitoring.v3.UpdateServiceLevelObjectiveRequest\x1a+.google.monitoring.v3.ServiceLevelObjective"\x85\x01\x82\xd3\xe4\x93\x02\x65\x32J/v3/{service_level_objective.name=*/*/services/*/serviceLevelObjectives/*}:\x17service_level_objective\xda\x41\x17service_level_objective\x12\xb2\x01\n\x1b\x44\x65leteServiceLevelObjective\x12\x38.google.monitoring.v3.DeleteServiceLevelObjectiveRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02\x34*2/v3/{name=*/*/services/*/serviceLevelObjectives/*}\xda\x41\x04name\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xb5\x01\n\x18\x63om.google.monitoring.v3B\x1dServiceMonitoringServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, - google_dot_api_dot_client__pb2.DESCRIPTOR, ], ) @@ -70,7 +74,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!monitoring.googleapis.com/Service" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -106,7 +112,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -118,8 +124,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=283, - serialized_end=389, + serialized_start=344, + serialized_end=498, ) @@ -145,7 +151,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\n!monitoring.googleapis.com/Service" + ), file=DESCRIPTOR, ) ], @@ -157,8 +165,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=391, - serialized_end=424, + serialized_start=500, + serialized_end=576, ) @@ -184,7 +192,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!monitoring.googleapis.com/Service" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -250,8 +260,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=426, - serialized_end=518, + serialized_start=579, + serialized_end=714, ) @@ -307,8 +317,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=520, - serialized_end=616, + serialized_start=716, + serialized_end=812, ) @@ -334,7 +344,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -364,8 +374,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=618, - serialized_end=737, + serialized_start=814, + serialized_end=938, ) @@ -391,7 +401,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\n!monitoring.googleapis.com/Service" + ), file=DESCRIPTOR, ) ], @@ -403,8 +415,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=739, - serialized_end=775, + serialized_start=940, + serialized_end=1019, ) @@ -430,7 +442,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\n!monitoring.googleapis.com/Service" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -466,7 +480,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -478,8 +492,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=778, - serialized_end=944, + serialized_start=1022, + serialized_end=1236, ) @@ -505,7 +519,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A1\n/monitoring.googleapis.com/ServiceLevelObjective" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -535,8 +551,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=946, - serialized_end=1057, + serialized_start=1239, + serialized_end=1407, ) @@ -562,7 +578,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\n!monitoring.googleapis.com/Service" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -646,8 +664,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1060, - serialized_end=1230, + serialized_start=1410, + serialized_end=1623, ) @@ -703,8 +721,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1233, - serialized_end=1373, + serialized_start=1626, + serialized_end=1766, ) @@ -730,7 +748,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -760,8 +778,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1376, - serialized_end=1539, + serialized_start=1769, + serialized_end=1937, ) @@ -787,7 +805,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A1\n/monitoring.googleapis.com/ServiceLevelObjective" + ), file=DESCRIPTOR, ) ], @@ -799,8 +819,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1541, - serialized_end=1591, + serialized_start=1939, + serialized_end=2046, ) _CREATESERVICEREQUEST.fields_by_name[ @@ -880,14 +900,14 @@ Attributes: parent: - Resource name of the parent workspace. Of the form + Required. Resource name of the parent workspace. Of the form ``projects/{project_id}``. service_id: Optional. The Service id to use for this Service. If omitted, an id will be generated instead. Must match the pattern [a-z0-9-]+ service: - The ``Service`` to create. + Required. The ``Service`` to create. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateServiceRequest) ), @@ -905,7 +925,7 @@ Attributes: name: - Resource name of the ``Service``. Of the form + Required. Resource name of the ``Service``. Of the form ``projects/{project_id}/services/{service_id}``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetServiceRequest) @@ -924,8 +944,8 @@ Attributes: parent: - Resource name of the parent ``Workspace``. Of the form - ``projects/{project_id}``. + Required. Resource name of the parent ``Workspace``. Of the + form ``projects/{project_id}``. filter: A filter specifying what ``Service``\ s to return. The filter currently supports the following fields: :: - @@ -987,8 +1007,8 @@ Attributes: service: - The ``Service`` to draw updates from. The given ``name`` - specifies the resource to update. + Required. The ``Service`` to draw updates from. The given + ``name`` specifies the resource to update. update_mask: A set of field paths defining which fields to use for the update. @@ -1009,8 +1029,8 @@ Attributes: name: - Resource name of the ``Service`` to delete. Of the form - ``projects/{project_id}/service/{service_id}``. + Required. Resource name of the ``Service`` to delete. Of the + form ``projects/{project_id}/services/{service_id}``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteServiceRequest) ), @@ -1028,16 +1048,16 @@ Attributes: parent: - Resource name of the parent ``Service``. Of the form + Required. Resource name of the parent ``Service``. Of the form ``projects/{project_id}/services/{service_id}``. service_level_objective_id: Optional. The ServiceLevelObjective id to use for this ServiceLevelObjective. If omitted, an id will be generated instead. Must match the pattern [a-z0-9-]+ service_level_objective: - The ``ServiceLevelObjective`` to create. The provided ``name`` - will be respected if no ``ServiceLevelObjective`` exists with - this name. + Required. The ``ServiceLevelObjective`` to create. The + provided ``name`` will be respected if no + ``ServiceLevelObjective`` exists with this name. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateServiceLevelObjectiveRequest) ), @@ -1055,9 +1075,9 @@ Attributes: name: - Resource name of the ``ServiceLevelObjective`` to get. Of the - form ``projects/{project_id}/services/{service_id}/serviceLeve - lObjectives/{slo_name}``. + Required. Resource name of the ``ServiceLevelObjective`` to + get. Of the form ``projects/{project_id}/services/{service_id} + /serviceLevelObjectives/{slo_name}``. view: View of the ``ServiceLevelObjective`` to return. If ``DEFAULT``, return the ``ServiceLevelObjective`` as @@ -1082,7 +1102,7 @@ Attributes: parent: - Resource name of the parent ``Service``. Of the form + Required. Resource name of the parent ``Service``. Of the form ``projects/{project_id}/services/{service_id}``. filter: A filter specifying what ``ServiceLevelObjective``\ s to @@ -1143,8 +1163,8 @@ Attributes: service_level_objective: - The ``ServiceLevelObjective`` to draw updates from. The given - ``name`` specifies the resource to update. + Required. The ``ServiceLevelObjective`` to draw updates from. + The given ``name`` specifies the resource to update. update_mask: A set of field paths defining which fields to use for the update. @@ -1165,9 +1185,9 @@ Attributes: name: - Resource name of the ``ServiceLevelObjective`` to delete. Of - the form ``projects/{project_id}/services/{service_id}/service - LevelObjectives/{slo_name}``. + Required. Resource name of the ``ServiceLevelObjective`` to + delete. Of the form ``projects/{project_id}/services/{service_ + id}/serviceLevelObjectives/{slo_name}``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteServiceLevelObjectiveRequest) ), @@ -1176,6 +1196,22 @@ DESCRIPTOR._options = None +_CREATESERVICEREQUEST.fields_by_name["parent"]._options = None +_CREATESERVICEREQUEST.fields_by_name["service"]._options = None +_GETSERVICEREQUEST.fields_by_name["name"]._options = None +_LISTSERVICESREQUEST.fields_by_name["parent"]._options = None +_UPDATESERVICEREQUEST.fields_by_name["service"]._options = None +_DELETESERVICEREQUEST.fields_by_name["name"]._options = None +_CREATESERVICELEVELOBJECTIVEREQUEST.fields_by_name["parent"]._options = None +_CREATESERVICELEVELOBJECTIVEREQUEST.fields_by_name[ + "service_level_objective" +]._options = None +_GETSERVICELEVELOBJECTIVEREQUEST.fields_by_name["name"]._options = None +_LISTSERVICELEVELOBJECTIVESREQUEST.fields_by_name["parent"]._options = None +_UPDATESERVICELEVELOBJECTIVEREQUEST.fields_by_name[ + "service_level_objective" +]._options = None +_DELETESERVICELEVELOBJECTIVEREQUEST.fields_by_name["name"]._options = None _SERVICEMONITORINGSERVICE = _descriptor.ServiceDescriptor( name="ServiceMonitoringService", @@ -1185,8 +1221,8 @@ serialized_options=_b( "\312A\031monitoring.googleapis.com\322A\211\001https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read" ), - serialized_start=1594, - serialized_end=3487, + serialized_start=2049, + serialized_end=4075, methods=[ _descriptor.MethodDescriptor( name="CreateService", @@ -1196,7 +1232,7 @@ input_type=_CREATESERVICEREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2._SERVICE, serialized_options=_b( - '\202\323\344\223\002$"\031/v3/{parent=*/*}/services:\007service' + '\202\323\344\223\002$"\031/v3/{parent=*/*}/services:\007service\332A\016parent,service' ), ), _descriptor.MethodDescriptor( @@ -1207,7 +1243,7 @@ input_type=_GETSERVICEREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2._SERVICE, serialized_options=_b( - "\202\323\344\223\002\033\022\031/v3/{name=*/*/services/*}" + "\202\323\344\223\002\033\022\031/v3/{name=*/*/services/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1218,7 +1254,7 @@ input_type=_LISTSERVICESREQUEST, output_type=_LISTSERVICESRESPONSE, serialized_options=_b( - "\202\323\344\223\002\033\022\031/v3/{parent=*/*}/services" + "\202\323\344\223\002\033\022\031/v3/{parent=*/*}/services\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -1229,7 +1265,7 @@ input_type=_UPDATESERVICEREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2._SERVICE, serialized_options=_b( - "\202\323\344\223\002,2!/v3/{service.name=*/*/services/*}:\007service" + "\202\323\344\223\002,2!/v3/{service.name=*/*/services/*}:\007service\332A\007service" ), ), _descriptor.MethodDescriptor( @@ -1240,7 +1276,7 @@ input_type=_DELETESERVICEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002\033*\031/v3/{name=*/*/services/*}" + "\202\323\344\223\002\033*\031/v3/{name=*/*/services/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1251,7 +1287,7 @@ input_type=_CREATESERVICELEVELOBJECTIVEREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2._SERVICELEVELOBJECTIVE, serialized_options=_b( - '\202\323\344\223\002M"2/v3/{parent=*/*/services/*}/serviceLevelObjectives:\027service_level_objective' + '\202\323\344\223\002M"2/v3/{parent=*/*/services/*}/serviceLevelObjectives:\027service_level_objective\332A\036parent,service_level_objective' ), ), _descriptor.MethodDescriptor( @@ -1262,7 +1298,7 @@ input_type=_GETSERVICELEVELOBJECTIVEREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2._SERVICELEVELOBJECTIVE, serialized_options=_b( - "\202\323\344\223\0024\0222/v3/{name=*/*/services/*/serviceLevelObjectives/*}" + "\202\323\344\223\0024\0222/v3/{name=*/*/services/*/serviceLevelObjectives/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1273,7 +1309,7 @@ input_type=_LISTSERVICELEVELOBJECTIVESREQUEST, output_type=_LISTSERVICELEVELOBJECTIVESRESPONSE, serialized_options=_b( - "\202\323\344\223\0024\0222/v3/{parent=*/*/services/*}/serviceLevelObjectives" + "\202\323\344\223\0024\0222/v3/{parent=*/*/services/*}/serviceLevelObjectives\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -1284,7 +1320,7 @@ input_type=_UPDATESERVICELEVELOBJECTIVEREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_service__pb2._SERVICELEVELOBJECTIVE, serialized_options=_b( - "\202\323\344\223\002e2J/v3/{service_level_objective.name=*/*/services/*/serviceLevelObjectives/*}:\027service_level_objective" + "\202\323\344\223\002e2J/v3/{service_level_objective.name=*/*/services/*/serviceLevelObjectives/*}:\027service_level_objective\332A\027service_level_objective" ), ), _descriptor.MethodDescriptor( @@ -1295,7 +1331,7 @@ input_type=_DELETESERVICELEVELOBJECTIVEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\0024*2/v3/{name=*/*/services/*/serviceLevelObjectives/*}" + "\202\323\344\223\0024*2/v3/{name=*/*/services/*/serviceLevelObjectives/*}\332A\004name" ), ), ], diff --git a/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py index d0a53f5f4a59..def1631af48b 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py @@ -75,8 +75,9 @@ dict( DESCRIPTOR=_SPANCONTEXT, __module__="google.cloud.monitoring_v3.proto.span_context_pb2", - __doc__="""The context of a span, attached to google.api.Distribution.Exemplars in - google.api.Distribution values during aggregation. + __doc__="""The context of a span, attached to + google.api.Distribution.Exemplars in google.api.Distribution values + during aggregation. It contains the name of a span with format: projects/[PROJECT\_ID]/traces/[TRACE\_ID]/spans/[SPAN\_ID] diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime.proto b/monitoring/google/cloud/monitoring_v3/proto/uptime.proto index 780a2578dff3..7cb4947d5074 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/uptime.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/uptime.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/monitored_resource.proto"; +import "google/api/resource.proto"; import "google/protobuf/duration.proto"; option csharp_namespace = "Google.Cloud.Monitoring.V3"; @@ -27,6 +28,27 @@ option java_outer_classname = "UptimeProto"; option java_package = "com.google.monitoring.v3"; option php_namespace = "Google\\Cloud\\Monitoring\\V3"; +// The regions from which an Uptime check can be run. +enum UptimeCheckRegion { + // Default value if no region is specified. Will result in Uptime checks + // running from all regions. + REGION_UNSPECIFIED = 0; + + // Allows checks to run from locations within the United States of America. + USA = 1; + + // Allows checks to run from locations within the continent of Europe. + EUROPE = 2; + + // Allows checks to run from locations within the continent of South + // America. + SOUTH_AMERICA = 3; + + // Allows checks to run from locations within the Asia Pacific area (ex: + // Singapore). + ASIA_PACIFIC = 4; +} + // An internal checker allows Uptime checks to run on private/internal GCP // resources. message InternalChecker { @@ -86,6 +108,14 @@ message InternalChecker { // This message configures which resources and services to monitor for // availability. message UptimeCheckConfig { + option (google.api.resource) = { + type: "monitoring.googleapis.com/UptimeCheckConfig" + pattern: "projects/{project}/uptimeCheckConfigs/{uptime_check_config}" + pattern: "organizations/{organization}/uptimeCheckConfigs/{uptime_check_config}" + pattern: "folders/{folder}/uptimeCheckConfigs/{uptime_check_config}" + pattern: "*" + }; + // The resource submessage for group checks. It can be used instead of a // monitored resource, when multiple resources are being monitored. message ResourceGroup { @@ -283,25 +313,21 @@ message UptimeCheckConfig { repeated InternalChecker internal_checkers = 14 [deprecated = true]; } -// The regions from which an Uptime check can be run. -enum UptimeCheckRegion { - // Default value if no region is specified. Will result in Uptime checks - // running from all regions. - REGION_UNSPECIFIED = 0; - - // Allows checks to run from locations within the United States of America. - USA = 1; - - // Allows checks to run from locations within the continent of Europe. - EUROPE = 2; +// The supported resource types that can be used as values of +// `group_resource.resource_type`. +// `INSTANCE` includes `gce_instance` and `aws_ec2_instance` resource types. +// The resource types `gae_app` and `uptime_url` are not valid here because +// group checks on App Engine modules and URLs are not allowed. +enum GroupResourceType { + // Default value (not valid). + RESOURCE_TYPE_UNSPECIFIED = 0; - // Allows checks to run from locations within the continent of South - // America. - SOUTH_AMERICA = 3; + // A group of instances from Google Cloud Platform (GCP) or + // Amazon Web Services (AWS). + INSTANCE = 1; - // Allows checks to run from locations within the Asia Pacific area (ex: - // Singapore). - ASIA_PACIFIC = 4; + // A group of Amazon ELB load balancers. + AWS_ELB_LOAD_BALANCER = 2; } // Contains the region, location, and list of IP @@ -322,20 +348,3 @@ message UptimeCheckIp { // interpreting this field in either IPv4 or IPv6 format. string ip_address = 3; } - -// The supported resource types that can be used as values of -// `group_resource.resource_type`. -// `INSTANCE` includes `gce_instance` and `aws_ec2_instance` resource types. -// The resource types `gae_app` and `uptime_url` are not valid here because -// group checks on App Engine modules and URLs are not allowed. -enum GroupResourceType { - // Default value (not valid). - RESOURCE_TYPE_UNSPECIFIED = 0; - - // A group of instances from Google Cloud Platform (GCP) or - // Amazon Web Services (AWS). - INSTANCE = 1; - - // A group of Amazon ELB load balancers. - AWS_ELB_LOAD_BALANCER = 2; -} diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py index 2708316daf18..c2dfccf9ff8c 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py @@ -19,6 +19,7 @@ from google.api import ( monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2, ) +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 @@ -30,10 +31,11 @@ "\n\030com.google.monitoring.v3B\013UptimeProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n-google/cloud/monitoring_v3/proto/uptime.proto\x12\x14google.monitoring.v3\x1a#google/api/monitored_resource.proto\x1a\x1egoogle/protobuf/duration.proto"\xe6\x01\n\x0fInternalChecker\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x0f\n\x07network\x18\x03 \x01(\t\x12\x10\n\x08gcp_zone\x18\x04 \x01(\t\x12\x17\n\x0fpeer_project_id\x18\x06 \x01(\t\x12:\n\x05state\x18\x07 \x01(\x0e\x32+.google.monitoring.v3.InternalChecker.State"3\n\x05State\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02:\x02\x18\x01"\xd7\x0b\n\x11UptimeCheckConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12;\n\x12monitored_resource\x18\x03 \x01(\x0b\x32\x1d.google.api.MonitoredResourceH\x00\x12O\n\x0eresource_group\x18\x04 \x01(\x0b\x32\x35.google.monitoring.v3.UptimeCheckConfig.ResourceGroupH\x00\x12G\n\nhttp_check\x18\x05 \x01(\x0b\x32\x31.google.monitoring.v3.UptimeCheckConfig.HttpCheckH\x01\x12\x45\n\ttcp_check\x18\x06 \x01(\x0b\x32\x30.google.monitoring.v3.UptimeCheckConfig.TcpCheckH\x01\x12)\n\x06period\x18\x07 \x01(\x0b\x32\x19.google.protobuf.Duration\x12*\n\x07timeout\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12P\n\x10\x63ontent_matchers\x18\t \x03(\x0b\x32\x36.google.monitoring.v3.UptimeCheckConfig.ContentMatcher\x12\x41\n\x10selected_regions\x18\n \x03(\x0e\x32\'.google.monitoring.v3.UptimeCheckRegion\x12\x17\n\x0bis_internal\x18\x0f \x01(\x08\x42\x02\x18\x01\x12\x44\n\x11internal_checkers\x18\x0e \x03(\x0b\x32%.google.monitoring.v3.InternalCheckerB\x02\x18\x01\x1a\x61\n\rResourceGroup\x12\x10\n\x08group_id\x18\x01 \x01(\t\x12>\n\rresource_type\x18\x02 \x01(\x0e\x32\'.google.monitoring.v3.GroupResourceType\x1a\xfa\x02\n\tHttpCheck\x12\x0f\n\x07use_ssl\x18\x01 \x01(\x08\x12\x0c\n\x04path\x18\x02 \x01(\t\x12\x0c\n\x04port\x18\x03 \x01(\x05\x12X\n\tauth_info\x18\x04 \x01(\x0b\x32\x45.google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication\x12\x14\n\x0cmask_headers\x18\x05 \x01(\x08\x12O\n\x07headers\x18\x06 \x03(\x0b\x32>.google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry\x12\x14\n\x0cvalidate_ssl\x18\x07 \x01(\x08\x1a\x39\n\x13\x42\x61sicAuthentication\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x18\n\x08TcpCheck\x12\x0c\n\x04port\x18\x01 \x01(\x05\x1a\x98\x02\n\x0e\x43ontentMatcher\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\\\n\x07matcher\x18\x02 \x01(\x0e\x32K.google.monitoring.v3.UptimeCheckConfig.ContentMatcher.ContentMatcherOption"\x96\x01\n\x14\x43ontentMatcherOption\x12&\n"CONTENT_MATCHER_OPTION_UNSPECIFIED\x10\x00\x12\x13\n\x0f\x43ONTAINS_STRING\x10\x01\x12\x17\n\x13NOT_CONTAINS_STRING\x10\x02\x12\x11\n\rMATCHES_REGEX\x10\x03\x12\x15\n\x11NOT_MATCHES_REGEX\x10\x04\x42\n\n\x08resourceB\x14\n\x12\x63heck_request_type"n\n\rUptimeCheckIp\x12\x37\n\x06region\x18\x01 \x01(\x0e\x32\'.google.monitoring.v3.UptimeCheckRegion\x12\x10\n\x08location\x18\x02 \x01(\t\x12\x12\n\nip_address\x18\x03 \x01(\t*e\n\x11UptimeCheckRegion\x12\x16\n\x12REGION_UNSPECIFIED\x10\x00\x12\x07\n\x03USA\x10\x01\x12\n\n\x06\x45UROPE\x10\x02\x12\x11\n\rSOUTH_AMERICA\x10\x03\x12\x10\n\x0c\x41SIA_PACIFIC\x10\x04*[\n\x11GroupResourceType\x12\x1d\n\x19RESOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08INSTANCE\x10\x01\x12\x19\n\x15\x41WS_ELB_LOAD_BALANCER\x10\x02\x42\xa3\x01\n\x18\x63om.google.monitoring.v3B\x0bUptimeProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n-google/cloud/monitoring_v3/proto/uptime.proto\x12\x14google.monitoring.v3\x1a#google/api/monitored_resource.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/protobuf/duration.proto"\xe6\x01\n\x0fInternalChecker\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x0f\n\x07network\x18\x03 \x01(\t\x12\x10\n\x08gcp_zone\x18\x04 \x01(\t\x12\x17\n\x0fpeer_project_id\x18\x06 \x01(\t\x12:\n\x05state\x18\x07 \x01(\x0e\x32+.google.monitoring.v3.InternalChecker.State"3\n\x05State\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02:\x02\x18\x01"\xcd\r\n\x11UptimeCheckConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12;\n\x12monitored_resource\x18\x03 \x01(\x0b\x32\x1d.google.api.MonitoredResourceH\x00\x12O\n\x0eresource_group\x18\x04 \x01(\x0b\x32\x35.google.monitoring.v3.UptimeCheckConfig.ResourceGroupH\x00\x12G\n\nhttp_check\x18\x05 \x01(\x0b\x32\x31.google.monitoring.v3.UptimeCheckConfig.HttpCheckH\x01\x12\x45\n\ttcp_check\x18\x06 \x01(\x0b\x32\x30.google.monitoring.v3.UptimeCheckConfig.TcpCheckH\x01\x12)\n\x06period\x18\x07 \x01(\x0b\x32\x19.google.protobuf.Duration\x12*\n\x07timeout\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12P\n\x10\x63ontent_matchers\x18\t \x03(\x0b\x32\x36.google.monitoring.v3.UptimeCheckConfig.ContentMatcher\x12\x41\n\x10selected_regions\x18\n \x03(\x0e\x32\'.google.monitoring.v3.UptimeCheckRegion\x12\x17\n\x0bis_internal\x18\x0f \x01(\x08\x42\x02\x18\x01\x12\x44\n\x11internal_checkers\x18\x0e \x03(\x0b\x32%.google.monitoring.v3.InternalCheckerB\x02\x18\x01\x1a\x61\n\rResourceGroup\x12\x10\n\x08group_id\x18\x01 \x01(\t\x12>\n\rresource_type\x18\x02 \x01(\x0e\x32\'.google.monitoring.v3.GroupResourceType\x1a\xfa\x02\n\tHttpCheck\x12\x0f\n\x07use_ssl\x18\x01 \x01(\x08\x12\x0c\n\x04path\x18\x02 \x01(\t\x12\x0c\n\x04port\x18\x03 \x01(\x05\x12X\n\tauth_info\x18\x04 \x01(\x0b\x32\x45.google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication\x12\x14\n\x0cmask_headers\x18\x05 \x01(\x08\x12O\n\x07headers\x18\x06 \x03(\x0b\x32>.google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry\x12\x14\n\x0cvalidate_ssl\x18\x07 \x01(\x08\x1a\x39\n\x13\x42\x61sicAuthentication\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x18\n\x08TcpCheck\x12\x0c\n\x04port\x18\x01 \x01(\x05\x1a\x98\x02\n\x0e\x43ontentMatcher\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\\\n\x07matcher\x18\x02 \x01(\x0e\x32K.google.monitoring.v3.UptimeCheckConfig.ContentMatcher.ContentMatcherOption"\x96\x01\n\x14\x43ontentMatcherOption\x12&\n"CONTENT_MATCHER_OPTION_UNSPECIFIED\x10\x00\x12\x13\n\x0f\x43ONTAINS_STRING\x10\x01\x12\x17\n\x13NOT_CONTAINS_STRING\x10\x02\x12\x11\n\rMATCHES_REGEX\x10\x03\x12\x15\n\x11NOT_MATCHES_REGEX\x10\x04:\xf3\x01\xea\x41\xef\x01\n+monitoring.googleapis.com/UptimeCheckConfig\x12;projects/{project}/uptimeCheckConfigs/{uptime_check_config}\x12\x45organizations/{organization}/uptimeCheckConfigs/{uptime_check_config}\x12\x39\x66olders/{folder}/uptimeCheckConfigs/{uptime_check_config}\x12\x01*B\n\n\x08resourceB\x14\n\x12\x63heck_request_type"n\n\rUptimeCheckIp\x12\x37\n\x06region\x18\x01 \x01(\x0e\x32\'.google.monitoring.v3.UptimeCheckRegion\x12\x10\n\x08location\x18\x02 \x01(\t\x12\x12\n\nip_address\x18\x03 \x01(\t*e\n\x11UptimeCheckRegion\x12\x16\n\x12REGION_UNSPECIFIED\x10\x00\x12\x07\n\x03USA\x10\x01\x12\n\n\x06\x45UROPE\x10\x02\x12\x11\n\rSOUTH_AMERICA\x10\x03\x12\x10\n\x0c\x41SIA_PACIFIC\x10\x04*[\n\x11GroupResourceType\x12\x1d\n\x19RESOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08INSTANCE\x10\x01\x12\x19\n\x15\x41WS_ELB_LOAD_BALANCER\x10\x02\x42\xa3\x01\n\x18\x63om.google.monitoring.v3B\x0bUptimeProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, ], ) @@ -66,8 +68,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=1983, - serialized_end=2084, + serialized_start=2256, + serialized_end=2357, ) _sym_db.RegisterEnumDescriptor(_UPTIMECHECKREGION) @@ -98,8 +100,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=2086, - serialized_end=2177, + serialized_start=2359, + serialized_end=2450, ) _sym_db.RegisterEnumDescriptor(_GROUPRESOURCETYPE) @@ -132,8 +134,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=316, - serialized_end=367, + serialized_start=343, + serialized_end=394, ) _sym_db.RegisterEnumDescriptor(_INTERNALCHECKER_STATE) @@ -177,8 +179,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=1685, - serialized_end=1835, + serialized_start=1712, + serialized_end=1862, ) _sym_db.RegisterEnumDescriptor(_UPTIMECHECKCONFIG_CONTENTMATCHER_CONTENTMATCHEROPTION) @@ -307,8 +309,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=141, - serialized_end=371, + serialized_start=168, + serialized_end=398, ) @@ -364,8 +366,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1048, - serialized_end=1145, + serialized_start=1075, + serialized_end=1172, ) _UPTIMECHECKCONFIG_HTTPCHECK_BASICAUTHENTICATION = _descriptor.Descriptor( @@ -420,8 +422,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1421, - serialized_end=1478, + serialized_start=1448, + serialized_end=1505, ) _UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY = _descriptor.Descriptor( @@ -476,8 +478,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1480, - serialized_end=1526, + serialized_start=1507, + serialized_end=1553, ) _UPTIMECHECKCONFIG_HTTPCHECK = _descriptor.Descriptor( @@ -625,8 +627,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1148, - serialized_end=1526, + serialized_start=1175, + serialized_end=1553, ) _UPTIMECHECKCONFIG_TCPCHECK = _descriptor.Descriptor( @@ -663,8 +665,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1528, - serialized_end=1552, + serialized_start=1555, + serialized_end=1579, ) _UPTIMECHECKCONFIG_CONTENTMATCHER = _descriptor.Descriptor( @@ -719,8 +721,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1555, - serialized_end=1835, + serialized_start=1582, + serialized_end=1862, ) _UPTIMECHECKCONFIG = _descriptor.Descriptor( @@ -955,7 +957,9 @@ _UPTIMECHECKCONFIG_CONTENTMATCHER, ], enum_types=[], - serialized_options=None, + serialized_options=_b( + "\352A\357\001\n+monitoring.googleapis.com/UptimeCheckConfig\022;projects/{project}/uptimeCheckConfigs/{uptime_check_config}\022Eorganizations/{organization}/uptimeCheckConfigs/{uptime_check_config}\0229folders/{folder}/uptimeCheckConfigs/{uptime_check_config}\022\001*" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -975,8 +979,8 @@ fields=[], ), ], - serialized_start=374, - serialized_end=1869, + serialized_start=401, + serialized_end=2142, ) @@ -1050,8 +1054,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1871, - serialized_end=1981, + serialized_start=2144, + serialized_end=2254, ) _INTERNALCHECKER.fields_by_name["state"].enum_type = _INTERNALCHECKER_STATE @@ -1447,4 +1451,5 @@ _UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY._options = None _UPTIMECHECKCONFIG.fields_by_name["is_internal"]._options = None _UPTIMECHECKCONFIG.fields_by_name["internal_checkers"]._options = None +_UPTIMECHECKCONFIG._options = None # @@protoc_insertion_point(module_scope) diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto b/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto index 203db1864112..9c7bf796144a 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto +++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto @@ -18,11 +18,13 @@ syntax = "proto3"; package google.monitoring.v3; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/monitoring/v3/uptime.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Cloud.Monitoring.V3"; option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring"; @@ -52,6 +54,7 @@ service UptimeCheckService { option (google.api.http) = { get: "/v3/{parent=projects/*}/uptimeCheckConfigs" }; + option (google.api.method_signature) = "parent"; } // Gets a single Uptime check configuration. @@ -59,6 +62,7 @@ service UptimeCheckService { option (google.api.http) = { get: "/v3/{name=projects/*/uptimeCheckConfigs/*}" }; + option (google.api.method_signature) = "name"; } // Creates a new Uptime check configuration. @@ -67,6 +71,7 @@ service UptimeCheckService { post: "/v3/{parent=projects/*}/uptimeCheckConfigs" body: "uptime_check_config" }; + option (google.api.method_signature) = "parent,uptime_check_config"; } // Updates an Uptime check configuration. You can either replace the entire @@ -78,6 +83,7 @@ service UptimeCheckService { patch: "/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}" body: "uptime_check_config" }; + option (google.api.method_signature) = "uptime_check_config"; } // Deletes an Uptime check configuration. Note that this method will fail @@ -87,6 +93,7 @@ service UptimeCheckService { option (google.api.http) = { delete: "/v3/{name=projects/*/uptimeCheckConfigs/*}" }; + option (google.api.method_signature) = "name"; } // Returns the list of IP addresses that checkers run from @@ -99,9 +106,14 @@ service UptimeCheckService { // The protocol for the `ListUptimeCheckConfigs` request. message ListUptimeCheckConfigsRequest { - // The project whose Uptime check configurations are listed. The format + // Required. The project whose Uptime check configurations are listed. The format // is `projects/[PROJECT_ID]`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/UptimeCheckConfig" + } + ]; // The maximum number of results to return in a single response. The server // may further constrain the maximum number of results returned in a single @@ -134,19 +146,29 @@ message ListUptimeCheckConfigsResponse { // The protocol for the `GetUptimeCheckConfig` request. message GetUptimeCheckConfigRequest { - // The Uptime check configuration to retrieve. The format + // Required. The Uptime check configuration to retrieve. The format // is `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/UptimeCheckConfig" + } + ]; } // The protocol for the `CreateUptimeCheckConfig` request. message CreateUptimeCheckConfigRequest { - // The project in which to create the Uptime check. The format + // Required. The project in which to create the Uptime check. The format // is `projects/[PROJECT_ID]`. - string parent = 1; - - // The new Uptime check configuration. - UptimeCheckConfig uptime_check_config = 2; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "monitoring.googleapis.com/UptimeCheckConfig" + } + ]; + + // Required. The new Uptime check configuration. + UptimeCheckConfig uptime_check_config = 2 [(google.api.field_behavior) = REQUIRED]; } // The protocol for the `UpdateUptimeCheckConfig` request. @@ -168,14 +190,19 @@ message UpdateUptimeCheckConfigRequest { // The following fields can be updated: `display_name`, // `http_check`, `tcp_check`, `timeout`, `content_matchers`, and // `selected_regions`. - UptimeCheckConfig uptime_check_config = 3; + UptimeCheckConfig uptime_check_config = 3 [(google.api.field_behavior) = REQUIRED]; } // The protocol for the `DeleteUptimeCheckConfig` request. message DeleteUptimeCheckConfigRequest { - // The Uptime check configuration to delete. The format + // Required. The Uptime check configuration to delete. The format // is `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "monitoring.googleapis.com/UptimeCheckConfig" + } + ]; } // The protocol for the `ListUptimeCheckIps` request. diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py index 1cdf48be0bab..a550ca1c72e6 100644 --- a/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py +++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py @@ -16,13 +16,15 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.monitoring_v3.proto import ( uptime_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2, ) from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 -from google.api import client_pb2 as google_dot_api_dot_client__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -33,15 +35,17 @@ "\n\030com.google.monitoring.v3B\022UptimeServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3" ), serialized_pb=_b( - '\n5google/cloud/monitoring_v3/proto/uptime_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/monitoring_v3/proto/uptime.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/api/client.proto"V\n\x1dListUptimeCheckConfigsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x94\x01\n\x1eListUptimeCheckConfigsResponse\x12\x45\n\x14uptime_check_configs\x18\x01 \x03(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"+\n\x1bGetUptimeCheckConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"v\n\x1e\x43reateUptimeCheckConfigRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x44\n\x13uptime_check_config\x18\x02 \x01(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig"\x97\x01\n\x1eUpdateUptimeCheckConfigRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x44\n\x13uptime_check_config\x18\x03 \x01(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig".\n\x1e\x44\x65leteUptimeCheckConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"B\n\x19ListUptimeCheckIpsRequest\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"t\n\x1aListUptimeCheckIpsResponse\x12=\n\x10uptime_check_ips\x18\x01 \x03(\x0b\x32#.google.monitoring.v3.UptimeCheckIp\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xf3\t\n\x12UptimeCheckService\x12\xb7\x01\n\x16ListUptimeCheckConfigs\x12\x33.google.monitoring.v3.ListUptimeCheckConfigsRequest\x1a\x34.google.monitoring.v3.ListUptimeCheckConfigsResponse"2\x82\xd3\xe4\x93\x02,\x12*/v3/{parent=projects/*}/uptimeCheckConfigs\x12\xa6\x01\n\x14GetUptimeCheckConfig\x12\x31.google.monitoring.v3.GetUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"2\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*/uptimeCheckConfigs/*}\x12\xc1\x01\n\x17\x43reateUptimeCheckConfig\x12\x34.google.monitoring.v3.CreateUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"G\x82\xd3\xe4\x93\x02\x41"*/v3/{parent=projects/*}/uptimeCheckConfigs:\x13uptime_check_config\x12\xd5\x01\n\x17UpdateUptimeCheckConfig\x12\x34.google.monitoring.v3.UpdateUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"[\x82\xd3\xe4\x93\x02U2>/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}:\x13uptime_check_config\x12\x9b\x01\n\x17\x44\x65leteUptimeCheckConfig\x12\x34.google.monitoring.v3.DeleteUptimeCheckConfigRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,**/v3/{name=projects/*/uptimeCheckConfigs/*}\x12\x93\x01\n\x12ListUptimeCheckIps\x12/.google.monitoring.v3.ListUptimeCheckIpsRequest\x1a\x30.google.monitoring.v3.ListUptimeCheckIpsResponse"\x1a\x82\xd3\xe4\x93\x02\x14\x12\x12/v3/uptimeCheckIps\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xaa\x01\n\x18\x63om.google.monitoring.v3B\x12UptimeServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' + '\n5google/cloud/monitoring_v3/proto/uptime_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a-google/cloud/monitoring_v3/proto/uptime.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x8b\x01\n\x1dListUptimeCheckConfigsRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\x12+monitoring.googleapis.com/UptimeCheckConfig\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x94\x01\n\x1eListUptimeCheckConfigsResponse\x12\x45\n\x14uptime_check_configs\x18\x01 \x03(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"`\n\x1bGetUptimeCheckConfigRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+monitoring.googleapis.com/UptimeCheckConfig"\xb0\x01\n\x1e\x43reateUptimeCheckConfigRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\x12+monitoring.googleapis.com/UptimeCheckConfig\x12I\n\x13uptime_check_config\x18\x02 \x01(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfigB\x03\xe0\x41\x02"\x9c\x01\n\x1eUpdateUptimeCheckConfigRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12I\n\x13uptime_check_config\x18\x03 \x01(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfigB\x03\xe0\x41\x02"c\n\x1e\x44\x65leteUptimeCheckConfigRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+monitoring.googleapis.com/UptimeCheckConfig"B\n\x19ListUptimeCheckIpsRequest\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"t\n\x1aListUptimeCheckIpsResponse\x12=\n\x10uptime_check_ips\x18\x01 \x03(\x0b\x32#.google.monitoring.v3.UptimeCheckIp\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xbd\n\n\x12UptimeCheckService\x12\xc0\x01\n\x16ListUptimeCheckConfigs\x12\x33.google.monitoring.v3.ListUptimeCheckConfigsRequest\x1a\x34.google.monitoring.v3.ListUptimeCheckConfigsResponse";\x82\xd3\xe4\x93\x02,\x12*/v3/{parent=projects/*}/uptimeCheckConfigs\xda\x41\x06parent\x12\xad\x01\n\x14GetUptimeCheckConfig\x12\x31.google.monitoring.v3.GetUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"9\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*/uptimeCheckConfigs/*}\xda\x41\x04name\x12\xde\x01\n\x17\x43reateUptimeCheckConfig\x12\x34.google.monitoring.v3.CreateUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"d\x82\xd3\xe4\x93\x02\x41"*/v3/{parent=projects/*}/uptimeCheckConfigs:\x13uptime_check_config\xda\x41\x1aparent,uptime_check_config\x12\xeb\x01\n\x17UpdateUptimeCheckConfig\x12\x34.google.monitoring.v3.UpdateUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"q\x82\xd3\xe4\x93\x02U2>/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}:\x13uptime_check_config\xda\x41\x13uptime_check_config\x12\xa2\x01\n\x17\x44\x65leteUptimeCheckConfig\x12\x34.google.monitoring.v3.DeleteUptimeCheckConfigRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02,**/v3/{name=projects/*/uptimeCheckConfigs/*}\xda\x41\x04name\x12\x93\x01\n\x12ListUptimeCheckIps\x12/.google.monitoring.v3.ListUptimeCheckIpsRequest\x1a\x30.google.monitoring.v3.ListUptimeCheckIpsResponse"\x1a\x82\xd3\xe4\x93\x02\x14\x12\x12/v3/uptimeCheckIps\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xaa\x01\n\x18\x63om.google.monitoring.v3B\x12UptimeServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, - google_dot_api_dot_client__pb2.DESCRIPTOR, ], ) @@ -68,7 +72,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A-\022+monitoring.googleapis.com/UptimeCheckConfig" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -116,8 +122,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=276, - serialized_end=362, + serialized_start=337, + serialized_end=476, ) @@ -191,8 +197,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=365, - serialized_end=513, + serialized_start=479, + serialized_end=627, ) @@ -218,7 +224,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A-\n+monitoring.googleapis.com/UptimeCheckConfig" + ), file=DESCRIPTOR, ) ], @@ -230,8 +238,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=515, - serialized_end=558, + serialized_start=629, + serialized_end=725, ) @@ -257,7 +265,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A-\022+monitoring.googleapis.com/UptimeCheckConfig" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -275,7 +285,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -287,8 +297,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=560, - serialized_end=678, + serialized_start=728, + serialized_end=904, ) @@ -332,7 +342,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -344,8 +354,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=681, - serialized_end=832, + serialized_start=907, + serialized_end=1063, ) @@ -371,7 +381,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A-\n+monitoring.googleapis.com/UptimeCheckConfig" + ), file=DESCRIPTOR, ) ], @@ -383,8 +395,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=834, - serialized_end=880, + serialized_start=1065, + serialized_end=1164, ) @@ -440,8 +452,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=882, - serialized_end=948, + serialized_start=1166, + serialized_end=1232, ) @@ -497,8 +509,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=950, - serialized_end=1066, + serialized_start=1234, + serialized_end=1350, ) _LISTUPTIMECHECKCONFIGSRESPONSE.fields_by_name[ @@ -561,8 +573,8 @@ Attributes: parent: - The project whose Uptime check configurations are listed. The - format is ``projects/[PROJECT_ID]``. + Required. The project whose Uptime check configurations are + listed. The format is ``projects/[PROJECT_ID]``. page_size: The maximum number of results to return in a single response. The server may further constrain the maximum number of results @@ -618,8 +630,9 @@ Attributes: name: - The Uptime check configuration to retrieve. The format is ``pr - ojects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``. + Required. The Uptime check configuration to retrieve. The + format is ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_C + HECK_ID]``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetUptimeCheckConfigRequest) ), @@ -637,10 +650,10 @@ Attributes: parent: - The project in which to create the Uptime check. The format is - ``projects/[PROJECT_ID]``. + Required. The project in which to create the Uptime check. The + format is ``projects/[PROJECT_ID]``. uptime_check_config: - The new Uptime check configuration. + Required. The new Uptime check configuration. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateUptimeCheckConfigRequest) ), @@ -691,8 +704,9 @@ Attributes: name: - The Uptime check configuration to delete. The format is ``proj - ects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``. + Required. The Uptime check configuration to delete. The format + is ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID + ]``. """, # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteUptimeCheckConfigRequest) ), @@ -755,6 +769,12 @@ DESCRIPTOR._options = None +_LISTUPTIMECHECKCONFIGSREQUEST.fields_by_name["parent"]._options = None +_GETUPTIMECHECKCONFIGREQUEST.fields_by_name["name"]._options = None +_CREATEUPTIMECHECKCONFIGREQUEST.fields_by_name["parent"]._options = None +_CREATEUPTIMECHECKCONFIGREQUEST.fields_by_name["uptime_check_config"]._options = None +_UPDATEUPTIMECHECKCONFIGREQUEST.fields_by_name["uptime_check_config"]._options = None +_DELETEUPTIMECHECKCONFIGREQUEST.fields_by_name["name"]._options = None _UPTIMECHECKSERVICE = _descriptor.ServiceDescriptor( name="UptimeCheckService", @@ -764,8 +784,8 @@ serialized_options=_b( "\312A\031monitoring.googleapis.com\322A\211\001https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.read" ), - serialized_start=1069, - serialized_end=2336, + serialized_start=1353, + serialized_end=2694, methods=[ _descriptor.MethodDescriptor( name="ListUptimeCheckConfigs", @@ -775,7 +795,7 @@ input_type=_LISTUPTIMECHECKCONFIGSREQUEST, output_type=_LISTUPTIMECHECKCONFIGSRESPONSE, serialized_options=_b( - "\202\323\344\223\002,\022*/v3/{parent=projects/*}/uptimeCheckConfigs" + "\202\323\344\223\002,\022*/v3/{parent=projects/*}/uptimeCheckConfigs\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -786,7 +806,7 @@ input_type=_GETUPTIMECHECKCONFIGREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG, serialized_options=_b( - "\202\323\344\223\002,\022*/v3/{name=projects/*/uptimeCheckConfigs/*}" + "\202\323\344\223\002,\022*/v3/{name=projects/*/uptimeCheckConfigs/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -797,7 +817,7 @@ input_type=_CREATEUPTIMECHECKCONFIGREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG, serialized_options=_b( - '\202\323\344\223\002A"*/v3/{parent=projects/*}/uptimeCheckConfigs:\023uptime_check_config' + '\202\323\344\223\002A"*/v3/{parent=projects/*}/uptimeCheckConfigs:\023uptime_check_config\332A\032parent,uptime_check_config' ), ), _descriptor.MethodDescriptor( @@ -808,7 +828,7 @@ input_type=_UPDATEUPTIMECHECKCONFIGREQUEST, output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG, serialized_options=_b( - "\202\323\344\223\002U2>/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}:\023uptime_check_config" + "\202\323\344\223\002U2>/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}:\023uptime_check_config\332A\023uptime_check_config" ), ), _descriptor.MethodDescriptor( @@ -819,7 +839,7 @@ input_type=_DELETEUPTIMECHECKCONFIGREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002,**/v3/{name=projects/*/uptimeCheckConfigs/*}" + "\202\323\344\223\002,**/v3/{name=projects/*/uptimeCheckConfigs/*}\332A\004name" ), ), _descriptor.MethodDescriptor( diff --git a/monitoring/synth.metadata b/monitoring/synth.metadata index ec10c73d196e..891230276f21 100644 --- a/monitoring/synth.metadata +++ b/monitoring/synth.metadata @@ -1,5 +1,5 @@ { - "updateTime": "2020-01-30T13:30:17.483332Z", + "updateTime": "2020-01-31T13:29:07.735673Z", "sources": [ { "generator": { @@ -12,9 +12,9 @@ "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "c1246a29e22b0f98e800a536b5b0da2d933a55f2", - "internalRef": "292310790", - "log": "c1246a29e22b0f98e800a536b5b0da2d933a55f2\nUpdating v1 protos with the latest inline documentation (in comments) and config options. Also adding a per-service .yaml file.\n\nPiperOrigin-RevId: 292310790\n\n" + "sha": "7ac66d9be8a7d7de4f13566d8663978c9ee9dcd7", + "internalRef": "292450564", + "log": "7ac66d9be8a7d7de4f13566d8663978c9ee9dcd7\nAdd Dataproc Autoscaling API to V1.\n\nPiperOrigin-RevId: 292450564\n\n5d932b2c1be3a6ef487d094e3cf5c0673d0241dd\n- Improve documentation\n- Add a client_id field to StreamingPullRequest\n\nPiperOrigin-RevId: 292434036\n\neaff9fa8edec3e914995ce832b087039c5417ea7\nmonitoring: v3 publish annotations and client retry config\n\nPiperOrigin-RevId: 292425288\n\n70958bab8c5353870d31a23fb2c40305b050d3fe\nBigQuery Storage Read API v1 clients.\n\nPiperOrigin-RevId: 292407644\n\n7a15e7fe78ff4b6d5c9606a3264559e5bde341d1\nUpdate backend proto for Google Cloud Endpoints\n\nPiperOrigin-RevId: 292391607\n\n3ca2c014e24eb5111c8e7248b1e1eb833977c83d\nbazel: Add --flaky_test_attempts=3 argument to prevent CI failures caused by flaky tests\n\nPiperOrigin-RevId: 292382559\n\n9933347c1f677e81e19a844c2ef95bfceaf694fe\nbazel:Integrate latest protoc-java-resource-names-plugin changes (fix for PyYAML dependency in bazel rules)\n\nPiperOrigin-RevId: 292376626\n\nb835ab9d2f62c88561392aa26074c0b849fb0bd3\nasset: v1p2beta1 add client config annotations\n\n* remove unintentionally exposed RPCs\n* remove messages relevant to removed RPCs\n\nPiperOrigin-RevId: 292369593\n\n" } }, { @@ -36,334 +36,5 @@ "config": "google/monitoring/artman_monitoring.yaml" } } - ], - "newFiles": [ - { - "path": ".coveragerc" - }, - { - "path": ".flake8" - }, - { - "path": ".repo-metadata.json" - }, - { - "path": "CHANGELOG.md" - }, - { - "path": "LICENSE" - }, - { - "path": "MANIFEST.in" - }, - { - "path": "README.rst" - }, - { - "path": "docs/README.rst" - }, - { - "path": "docs/_static/custom.css" - }, - { - "path": "docs/_templates/layout.html" - }, - { - "path": "docs/changelog.md" - }, - { - "path": "docs/conf.py" - }, - { - "path": "docs/gapic/v3/api.rst" - }, - { - "path": "docs/gapic/v3/types.rst" - }, - { - "path": "docs/index.rst" - }, - { - "path": "docs/query.rst" - }, - { - "path": "google/__init__.py" - }, - { - "path": "google/cloud/__init__.py" - }, - { - "path": "google/cloud/monitoring.py" - }, - { - "path": "google/cloud/monitoring_v3/__init__.py" - }, - { - "path": "google/cloud/monitoring_v3/_dataframe.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/__init__.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/alert_policy_service_client.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/alert_policy_service_client_config.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/enums.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/group_service_client.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/group_service_client_config.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/metric_service_client.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/metric_service_client_config.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/notification_channel_service_client.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/notification_channel_service_client_config.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/service_monitoring_service_client.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/service_monitoring_service_client_config.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/__init__.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/alert_policy_service_grpc_transport.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/group_service_grpc_transport.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/metric_service_grpc_transport.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/notification_channel_service_grpc_transport.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/service_monitoring_service_grpc_transport.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/transports/uptime_check_service_grpc_transport.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/uptime_check_service_client.py" - }, - { - "path": "google/cloud/monitoring_v3/gapic/uptime_check_service_client_config.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/__init__.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/alert.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/alert_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/alert_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/alert_service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/alert_service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/alert_service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/common.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/common_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/common_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/dropped_labels.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/dropped_labels_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/dropped_labels_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/group.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/group_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/group_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/group_service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/group_service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/group_service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/metric.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/metric_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/metric_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/metric_service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/metric_service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/metric_service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/mutation_record.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/mutation_record_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/mutation_record_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/notification.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/notification_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/notification_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/notification_service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/notification_service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/notification_service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/service_service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/service_service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/service_service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/span_context.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/span_context_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/span_context_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/uptime.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/uptime_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/uptime_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/uptime_service.proto" - }, - { - "path": "google/cloud/monitoring_v3/proto/uptime_service_pb2.py" - }, - { - "path": "google/cloud/monitoring_v3/proto/uptime_service_pb2_grpc.py" - }, - { - "path": "google/cloud/monitoring_v3/query.py" - }, - { - "path": "google/cloud/monitoring_v3/types.py" - }, - { - "path": "noxfile.py" - }, - { - "path": "setup.cfg" - }, - { - "path": "setup.py" - }, - { - "path": "synth.metadata" - }, - { - "path": "synth.py" - }, - { - "path": "tests/__init__.py" - }, - { - "path": "tests/system/gapic/v3/test_system_metric_service_v3.py" - }, - { - "path": "tests/system/test_vpcsc_v3.py" - }, - { - "path": "tests/unit/gapic/v3/test_alert_policy_service_client_v3.py" - }, - { - "path": "tests/unit/gapic/v3/test_group_service_client_v3.py" - }, - { - "path": "tests/unit/gapic/v3/test_metric_service_client_v3.py" - }, - { - "path": "tests/unit/gapic/v3/test_notification_channel_service_client_v3.py" - }, - { - "path": "tests/unit/gapic/v3/test_service_monitoring_service_client_v3.py" - }, - { - "path": "tests/unit/gapic/v3/test_uptime_check_service_client_v3.py" - }, - { - "path": "tests/unit/test__dataframe.py" - }, - { - "path": "tests/unit/test_query.py" - } ] } \ No newline at end of file