feat: [google-cloud-privilegedaccessmanager] Introducing new Grant states for Withdrawal operation (#14168)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 789206965

Source-Link:
googleapis/googleapis@fb0d2d7

Source-Link:
googleapis/googleapis-gen@fc7a38c
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXByaXZpbGVnZWRhY2Nlc3NtYW5hZ2VyLy5Pd2xCb3QueWFtbCIsImgiOiJmYzdhMzhjM2I3ZmIwOGQzN2E2MTNmMjI5NTQzNDNkYzMwNDQzODMyIn0=

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-privilegedaccessmanager/google/cloud/privilegedaccessmanager_v1/types/privilegedaccessmanager.py

@@ -967,6 +967,11 @@ class State(proto.Enum):
             ENDED (11):
                 System took back access as the requested
                 duration was over. This is a terminal state.
+            WITHDRAWING (12):
+                Access is being withdrawn.
+            WITHDRAWN (13):
+                Grant was withdrawn by the grant owner. This
+                is a terminal state.
         """
         STATE_UNSPECIFIED = 0
         APPROVAL_AWAITED = 1
@@ -979,6 +984,8 @@ class State(proto.Enum):
         REVOKING = 9
         REVOKED = 10
         ENDED = 11
+        WITHDRAWING = 12
+        WITHDRAWN = 13
 
     class Timeline(proto.Message):
         r"""Timeline of a grant describing what happened to it and when.
@@ -1046,6 +1053,10 @@ class Event(proto.Message):
                     The policy bindings made by grant have been
                     modified outside of PAM.
 
+                    This field is a member of `oneof`_ ``event``.
+                withdrawn (google.cloud.privilegedaccessmanager_v1.types.Grant.Timeline.Event.Withdrawn):
+                    The grant was withdrawn.
+
                     This field is a member of `oneof`_ ``event``.
                 event_time (google.protobuf.timestamp_pb2.Timestamp):
                     Output only. The time (as recorded at server)
@@ -1131,6 +1142,9 @@ class Revoked(proto.Message):
                     number=2,
                 )
 
+            class Withdrawn(proto.Message):
+                r"""An event representing that the grant was withdrawn."""
+
             class Scheduled(proto.Message):
                 r"""An event representing that the grant has been scheduled to be
                 activated later.
@@ -1242,6 +1256,12 @@ class ExternallyModified(proto.Message):
                     message="Grant.Timeline.Event.ExternallyModified",
                 )
             )
+            withdrawn: "Grant.Timeline.Event.Withdrawn" = proto.Field(
+                proto.MESSAGE,
+                number=13,
+                oneof="event",
+                message="Grant.Timeline.Event.Withdrawn",
+            )
             event_time: timestamp_pb2.Timestamp = proto.Field(
                 proto.MESSAGE,
                 number=1,

packages/google-cloud-privilegedaccessmanager/tests/unit/gapic/privilegedaccessmanager_v1/test_privileged_access_manager.py

@@ -11372,6 +11372,7 @@ def test_create_grant_rest_call_success(request_type):
                     "expired": {},
                     "ended": {},
                     "externally_modified": {},
+                    "withdrawn": {},
                     "event_time": {},
                 }
             ]