Skip to content

Commit 1fef616

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
chore: Update gapic-generator-python to v1.18.3 (#517)
* docs: Updates documentation with regional resource names for multiple requests docs: Removes references as a "global-only" service PiperOrigin-RevId: 652832022 Source-Link: googleapis/googleapis@72b7238 Source-Link: googleapis/googleapis-gen@fa6a37c Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmE2YTM3YzEwMDQwYmU4MDBhOWJmZTMyODZmMjY3ODU1MzVjMzczNyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * chore: Update gapic-generator-python to v1.18.3 PiperOrigin-RevId: 655567917 Source-Link: googleapis/googleapis@43aa65e Source-Link: googleapis/googleapis-gen@0e38378 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGUzODM3ODc1MzA3NGMwZjY2ZmY2MzM0OGQ2ODY0OTI5ZTEwNGQ1YyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * chore: Update gapic-generator-python to v1.18.3 PiperOrigin-RevId: 656040068 Source-Link: googleapis/googleapis@3f4e29a Source-Link: googleapis/googleapis-gen@b8feb21 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjhmZWIyMTA5ZGRlN2IwOTM4YzIyYzk5M2QwMDIyNTFhYzY3MTRkYyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 8d33168 commit 1fef616

File tree

14 files changed

+373
-118
lines changed

14 files changed

+373
-118
lines changed

‎google/cloud/errorreporting_v1beta1/services/error_group_service/async_client.py

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -305,12 +305,26 @@ async def sample_get_group():
305305
The request object. A request to return an individual
306306
group.
307307
group_name (:class:`str`):
308-
Required. The group resource name. Written as
309-
``projects/{projectID}/groups/{group_name}``. Call
310-
```groupStats.list`` <https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list>`__
308+
Required. The group resource name. Written as either
309+
``projects/{projectID}/groups/{group_id}`` or
310+
``projects/{projectID}/locations/{location}/groups/{group_id}``.
311+
Call [groupStats.list]
312+
[google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats]
311313
to return a list of groups belonging to this project.
312314
313-
Example: ``projects/my-project-123/groups/my-group``
315+
Examples: ``projects/my-project-123/groups/my-group``,
316+
``projects/my-project-123/locations/global/groups/my-group``
317+
318+
In the group resource name, the ``group_id`` is a unique
319+
identifier for a particular error group. The identifier
320+
is derived from key parts of the error-log content and
321+
is treated as Service Data. For information about how
322+
Service Data is handled, see `Google Cloud Privacy
323+
Notice <https://cloud.google.com/terms/cloud-privacy-notice>`__.
324+
325+
For a list of supported locations, see `Supported
326+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
327+
``global`` is the default when unspecified.
314328
315329
This corresponds to the ``group_name`` field
316330
on the ``request`` instance; if ``request`` is provided, this

‎google/cloud/errorreporting_v1beta1/services/error_group_service/client.py

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -718,12 +718,26 @@ def sample_get_group():
718718
The request object. A request to return an individual
719719
group.
720720
group_name (str):
721-
Required. The group resource name. Written as
722-
``projects/{projectID}/groups/{group_name}``. Call
723-
```groupStats.list`` <https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list>`__
721+
Required. The group resource name. Written as either
722+
``projects/{projectID}/groups/{group_id}`` or
723+
``projects/{projectID}/locations/{location}/groups/{group_id}``.
724+
Call [groupStats.list]
725+
[google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats]
724726
to return a list of groups belonging to this project.
725727
726-
Example: ``projects/my-project-123/groups/my-group``
728+
Examples: ``projects/my-project-123/groups/my-group``,
729+
``projects/my-project-123/locations/global/groups/my-group``
730+
731+
In the group resource name, the ``group_id`` is a unique
732+
identifier for a particular error group. The identifier
733+
is derived from key parts of the error-log content and
734+
is treated as Service Data. For information about how
735+
Service Data is handled, see `Google Cloud Privacy
736+
Notice <https://cloud.google.com/terms/cloud-privacy-notice>`__.
737+
738+
For a list of supported locations, see `Supported
739+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
740+
``global`` is the default when unspecified.
727741
728742
This corresponds to the ``group_name`` field
729743
on the ``request`` instance; if ``request`` is provided, this

‎google/cloud/errorreporting_v1beta1/services/error_group_service/transports/rest.py

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -277,6 +277,10 @@ def __call__(
277277
"method": "get",
278278
"uri": "/v1beta1/{group_name=projects/*/groups/*}",
279279
},
280+
{
281+
"method": "get",
282+
"uri": "/v1beta1/{group_name=projects/*/locations/*/groups/*}",
283+
},
280284
]
281285
request, metadata = self._interceptor.pre_get_group(request, metadata)
282286
pb_request = error_group_service.GetGroupRequest.pb(request)
@@ -366,6 +370,11 @@ def __call__(
366370
"uri": "/v1beta1/{group.name=projects/*/groups/*}",
367371
"body": "group",
368372
},
373+
{
374+
"method": "put",
375+
"uri": "/v1beta1/{group.name=projects/*/locations/*/groups/*}",
376+
"body": "group",
377+
},
369378
]
370379
request, metadata = self._interceptor.pre_update_group(request, metadata)
371380
pb_request = error_group_service.UpdateGroupRequest.pb(request)

‎google/cloud/errorreporting_v1beta1/services/error_stats_service/async_client.py

Lines changed: 53 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -315,23 +315,41 @@ async def sample_list_group_stats():
315315
project. Written as ``projects/{projectID}`` or
316316
``projects/{projectNumber}``, where ``{projectID}`` and
317317
``{projectNumber}`` can be found in the `Google Cloud
318-
Console <https://support.google.com/cloud/answer/6158840>`__.
318+
console <https://support.google.com/cloud/answer/6158840>`__.
319+
It may also include a location, such as
320+
``projects/{projectID}/locations/{location}`` where
321+
``{location}`` is a cloud region.
319322
320323
Examples: ``projects/my-project-123``,
321-
``projects/5551234``.
324+
``projects/5551234``,
325+
``projects/my-project-123/locations/us-central1``,
326+
``projects/5551234/locations/us-central1``.
327+
328+
For a list of supported locations, see `Supported
329+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
330+
``global`` is the default when unspecified. Use ``-`` as
331+
a wildcard to request group stats from all regions.
322332
323333
This corresponds to the ``project_name`` field
324334
on the ``request`` instance; if ``request`` is provided, this
325335
should not be set.
326336
time_range (:class:`google.cloud.errorreporting_v1beta1.types.QueryTimeRange`):
327337
Optional. List data for the given time range. If not
328338
set, a default time range is used. The field
329-
time_range_begin in the response will specify the
330-
beginning of this time range. Only ErrorGroupStats with
331-
a non-zero count in the given time range are returned,
332-
unless the request contains an explicit group_id list.
333-
If a group_id list is given, also ErrorGroupStats with
334-
zero occurrences are returned.
339+
[time_range_begin]
340+
[google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin]
341+
in the response will specify the beginning of this time
342+
range. Only [ErrorGroupStats]
343+
[google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats]
344+
with a non-zero count in the given time range are
345+
returned, unless the request contains an explicit
346+
[group_id]
347+
[google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
348+
list. If a [group_id]
349+
[google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
350+
list is given, also [ErrorGroupStats]
351+
[google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats]
352+
with zero occurrences are returned.
335353
336354
This corresponds to the ``time_range`` field
337355
on the ``request`` instance; if ``request`` is provided, this
@@ -456,18 +474,30 @@ async def sample_list_events():
456474
return.
457475
project_name (:class:`str`):
458476
Required. The resource name of the Google Cloud Platform
459-
project. Written as ``projects/{projectID}``, where
477+
project. Written as ``projects/{projectID}`` or
478+
``projects/{projectID}/locations/{location}``, where
460479
``{projectID}`` is the `Google Cloud Platform project
461-
ID <https://support.google.com/cloud/answer/6158840>`__.
480+
ID <https://support.google.com/cloud/answer/6158840>`__
481+
and ``{location}`` is a Cloud region.
482+
483+
Examples: ``projects/my-project-123``,
484+
``projects/my-project-123/locations/global``.
462485
463-
Example: ``projects/my-project-123``.
486+
For a list of supported locations, see `Supported
487+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
488+
``global`` is the default when unspecified.
464489
465490
This corresponds to the ``project_name`` field
466491
on the ``request`` instance; if ``request`` is provided, this
467492
should not be set.
468493
group_id (:class:`str`):
469-
Required. The group for which events
470-
shall be returned.
494+
Required. The group for which events shall be returned.
495+
The ``group_id`` is a unique identifier for a particular
496+
error group. The identifier is derived from key parts of
497+
the error-log content and is treated as Service Data.
498+
For information about how Service Data is handled, see
499+
`Google Cloud Privacy
500+
Notice <https://cloud.google.com/terms/cloud-privacy-notice>`__.
471501
472502
This corresponds to the ``group_id`` field
473503
on the ``request`` instance; if ``request`` is provided, this
@@ -588,11 +618,18 @@ async def sample_delete_events():
588618
The request object. Deletes all events in the project.
589619
project_name (:class:`str`):
590620
Required. The resource name of the Google Cloud Platform
591-
project. Written as ``projects/{projectID}``, where
621+
project. Written as ``projects/{projectID}`` or
622+
``projects/{projectID}/locations/{location}``, where
592623
``{projectID}`` is the `Google Cloud Platform project
593-
ID <https://support.google.com/cloud/answer/6158840>`__.
624+
ID <https://support.google.com/cloud/answer/6158840>`__
625+
and ``{location}`` is a Cloud region.
626+
627+
Examples: ``projects/my-project-123``,
628+
``projects/my-project-123/locations/global``.
594629
595-
Example: ``projects/my-project-123``.
630+
For a list of supported locations, see `Supported
631+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
632+
``global`` is the default when unspecified.
596633
597634
This corresponds to the ``project_name`` field
598635
on the ``request`` instance; if ``request`` is provided, this

‎google/cloud/errorreporting_v1beta1/services/error_stats_service/client.py

Lines changed: 53 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -728,23 +728,41 @@ def sample_list_group_stats():
728728
project. Written as ``projects/{projectID}`` or
729729
``projects/{projectNumber}``, where ``{projectID}`` and
730730
``{projectNumber}`` can be found in the `Google Cloud
731-
Console <https://support.google.com/cloud/answer/6158840>`__.
731+
console <https://support.google.com/cloud/answer/6158840>`__.
732+
It may also include a location, such as
733+
``projects/{projectID}/locations/{location}`` where
734+
``{location}`` is a cloud region.
732735
733736
Examples: ``projects/my-project-123``,
734-
``projects/5551234``.
737+
``projects/5551234``,
738+
``projects/my-project-123/locations/us-central1``,
739+
``projects/5551234/locations/us-central1``.
740+
741+
For a list of supported locations, see `Supported
742+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
743+
``global`` is the default when unspecified. Use ``-`` as
744+
a wildcard to request group stats from all regions.
735745
736746
This corresponds to the ``project_name`` field
737747
on the ``request`` instance; if ``request`` is provided, this
738748
should not be set.
739749
time_range (google.cloud.errorreporting_v1beta1.types.QueryTimeRange):
740750
Optional. List data for the given time range. If not
741751
set, a default time range is used. The field
742-
time_range_begin in the response will specify the
743-
beginning of this time range. Only ErrorGroupStats with
744-
a non-zero count in the given time range are returned,
745-
unless the request contains an explicit group_id list.
746-
If a group_id list is given, also ErrorGroupStats with
747-
zero occurrences are returned.
752+
[time_range_begin]
753+
[google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin]
754+
in the response will specify the beginning of this time
755+
range. Only [ErrorGroupStats]
756+
[google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats]
757+
with a non-zero count in the given time range are
758+
returned, unless the request contains an explicit
759+
[group_id]
760+
[google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
761+
list. If a [group_id]
762+
[google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
763+
list is given, also [ErrorGroupStats]
764+
[google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats]
765+
with zero occurrences are returned.
748766
749767
This corresponds to the ``time_range`` field
750768
on the ``request`` instance; if ``request`` is provided, this
@@ -866,18 +884,30 @@ def sample_list_events():
866884
return.
867885
project_name (str):
868886
Required. The resource name of the Google Cloud Platform
869-
project. Written as ``projects/{projectID}``, where
887+
project. Written as ``projects/{projectID}`` or
888+
``projects/{projectID}/locations/{location}``, where
870889
``{projectID}`` is the `Google Cloud Platform project
871-
ID <https://support.google.com/cloud/answer/6158840>`__.
890+
ID <https://support.google.com/cloud/answer/6158840>`__
891+
and ``{location}`` is a Cloud region.
892+
893+
Examples: ``projects/my-project-123``,
894+
``projects/my-project-123/locations/global``.
872895
873-
Example: ``projects/my-project-123``.
896+
For a list of supported locations, see `Supported
897+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
898+
``global`` is the default when unspecified.
874899
875900
This corresponds to the ``project_name`` field
876901
on the ``request`` instance; if ``request`` is provided, this
877902
should not be set.
878903
group_id (str):
879-
Required. The group for which events
880-
shall be returned.
904+
Required. The group for which events shall be returned.
905+
The ``group_id`` is a unique identifier for a particular
906+
error group. The identifier is derived from key parts of
907+
the error-log content and is treated as Service Data.
908+
For information about how Service Data is handled, see
909+
`Google Cloud Privacy
910+
Notice <https://cloud.google.com/terms/cloud-privacy-notice>`__.
881911
882912
This corresponds to the ``group_id`` field
883913
on the ``request`` instance; if ``request`` is provided, this
@@ -995,11 +1025,18 @@ def sample_delete_events():
9951025
The request object. Deletes all events in the project.
9961026
project_name (str):
9971027
Required. The resource name of the Google Cloud Platform
998-
project. Written as ``projects/{projectID}``, where
1028+
project. Written as ``projects/{projectID}`` or
1029+
``projects/{projectID}/locations/{location}``, where
9991030
``{projectID}`` is the `Google Cloud Platform project
1000-
ID <https://support.google.com/cloud/answer/6158840>`__.
1031+
ID <https://support.google.com/cloud/answer/6158840>`__
1032+
and ``{location}`` is a Cloud region.
1033+
1034+
Examples: ``projects/my-project-123``,
1035+
``projects/my-project-123/locations/global``.
10011036
1002-
Example: ``projects/my-project-123``.
1037+
For a list of supported locations, see `Supported
1038+
Regions <https://cloud.google.com/logging/docs/region-support>`__.
1039+
``global`` is the default when unspecified.
10031040
10041041
This corresponds to the ``project_name`` field
10051042
on the ``request`` instance; if ``request`` is provided, this

‎google/cloud/errorreporting_v1beta1/services/error_stats_service/transports/rest.py

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -311,6 +311,10 @@ def __call__(
311311
"method": "delete",
312312
"uri": "/v1beta1/{project_name=projects/*}/events",
313313
},
314+
{
315+
"method": "delete",
316+
"uri": "/v1beta1/{project_name=projects/*/locations/*}/events",
317+
},
314318
]
315319
request, metadata = self._interceptor.pre_delete_events(request, metadata)
316320
pb_request = error_stats_service.DeleteEventsRequest.pb(request)
@@ -401,6 +405,10 @@ def __call__(
401405
"method": "get",
402406
"uri": "/v1beta1/{project_name=projects/*}/events",
403407
},
408+
{
409+
"method": "get",
410+
"uri": "/v1beta1/{project_name=projects/*/locations/*}/events",
411+
},
404412
]
405413
request, metadata = self._interceptor.pre_list_events(request, metadata)
406414
pb_request = error_stats_service.ListEventsRequest.pb(request)
@@ -488,6 +496,10 @@ def __call__(
488496
"method": "get",
489497
"uri": "/v1beta1/{project_name=projects/*}/groupStats",
490498
},
499+
{
500+
"method": "get",
501+
"uri": "/v1beta1/{project_name=projects/*/locations/*}/groupStats",
502+
},
491503
]
492504
request, metadata = self._interceptor.pre_list_group_stats(
493505
request, metadata

‎google/cloud/errorreporting_v1beta1/services/report_errors_service/async_client.py

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -280,10 +280,19 @@ async def report_error_event(
280280
281281
``POST https://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456``
282282
283-
**Note:** `Error Reporting </error-reporting>`__ is a global
284-
service built on Cloud Logging and doesn't analyze logs stored
285-
in regional log buckets or logs routed to other Google Cloud
286-
projects.
283+
**Note:** [Error Reporting]
284+
(https://cloud.google.com/error-reporting) is a service built on
285+
Cloud Logging and can analyze log entries when all of the
286+
following are true:
287+
288+
- Customer-managed encryption keys (CMEK) are disabled on the
289+
log bucket.
290+
- The log bucket satisfies one of the following:
291+
292+
- The log bucket is stored in the same project where the
293+
logs originated.
294+
- The logs were routed to a project, and then that project
295+
stored those logs in a log bucket that it owns.
287296
288297
.. code-block:: python
289298

0 commit comments

Comments
 (0)