Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/google/cloud/errorreporting_v1beta1/types/error_group_service.py: 91%

1# -*- coding: utf-8 -*- 

2# Copyright 2025 Google LLC 

3# 

4# Licensed under the Apache License, Version 2.0 (the "License"); 

5# you may not use this file except in compliance with the License. 

6# You may obtain a copy of the License at 

7# 

8# http://www.apache.org/licenses/LICENSE-2.0 

9# 

10# Unless required by applicable law or agreed to in writing, software 

11# distributed under the License is distributed on an "AS IS" BASIS, 

12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 

13# See the License for the specific language governing permissions and 

14# limitations under the License. 

15# 

16from __future__ import annotations 

17 

18from typing import MutableMapping, MutableSequence 

19 

20import proto # type: ignore 

21 

22from google.cloud.errorreporting_v1beta1.types import common 

23 

24 

25__protobuf__ = proto.module( 

26 package="google.devtools.clouderrorreporting.v1beta1", 

27 manifest={ 

28 "GetGroupRequest", 

29 "UpdateGroupRequest", 

30 }, 

31) 

32 

33 

34class GetGroupRequest(proto.Message): 

35 r"""A request to return an individual group. 

36 

37 Attributes: 

38 group_name (str): 

39 Required. The group resource name. Written as either 

40 ``projects/{projectID}/groups/{group_id}`` or 

41 ``projects/{projectID}/locations/{location}/groups/{group_id}``. 

42 Call [groupStats.list] 

43 [google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats] 

44 to return a list of groups belonging to this project. 

45 

46 Examples: ``projects/my-project-123/groups/my-group``, 

47 ``projects/my-project-123/locations/global/groups/my-group`` 

48 

49 In the group resource name, the ``group_id`` is a unique 

50 identifier for a particular error group. The identifier is 

51 derived from key parts of the error-log content and is 

52 treated as Service Data. For information about how Service 

53 Data is handled, see `Google Cloud Privacy 

54 Notice <https://cloud.google.com/terms/cloud-privacy-notice>`__. 

55 

56 For a list of supported locations, see `Supported 

57 Regions <https://cloud.google.com/logging/docs/region-support>`__. 

58 ``global`` is the default when unspecified. 

59 """ 

60 

61 group_name: str = proto.Field( 

62 proto.STRING, 

63 number=1, 

64 ) 

65 

66 

67class UpdateGroupRequest(proto.Message): 

68 r"""A request to replace the existing data for the given group. 

69 

70 Attributes: 

71 group (google.cloud.errorreporting_v1beta1.types.ErrorGroup): 

72 Required. The group which replaces the 

73 resource on the server. 

74 """ 

75 

76 group: common.ErrorGroup = proto.Field( 

77 proto.MESSAGE, 

78 number=1, 

79 message=common.ErrorGroup, 

80 ) 

81 

82 

83__all__ = tuple(sorted(__protobuf__.manifest))