docs: Minor formatting (#74)

* chore: Update gapic-generator-python to v1.11.3 PiperOrigin-RevId: 546899192 Source-Link: googleapis/googleapis@e6b1691 Source-Link: googleapis/googleapis-gen@0b3917c Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGIzOTE3YzQyMWNiZGE3ZmNiNjcwOTJlMTZjMzNmM2VhNDZmNGJjNyJ9 * 🦉 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.11.4 PiperOrigin-RevId: 547897126 Source-Link: googleapis/googleapis@c09c75e Source-Link: googleapis/googleapis-gen@45e0ec4 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDVlMGVjNDM0MzUxN2NkMGFhNjZiNWNhNjQyMzJhMTgwMmMyZjk0NSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * docs: Minor formatting PiperOrigin-RevId: 553099602 Source-Link: googleapis/googleapis@79b304f Source-Link: googleapis/googleapis-gen@16ad04e Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTZhZDA0ZTEyNTZkNmIzYjVlMTBmYjRjMmQ0YzRiZGFhNTFhMjJmYyJ9 * 🦉 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> Co-authored-by: Anthonios Partheniou <partheniou@google.com>
googleapis · Aug 3, 2023 · 2071a3c · 2071a3c
1 parent c8c89e3
commit 2071a3c
Show file tree

Hide file tree

Showing 4 changed files with 96 additions and 59 deletions.
diff --git a/google/cloud/gke_backup_v1/services/backup_for_gke/async_client.py b/google/cloud/gke_backup_v1/services/backup_for_gke/async_client.py
@@ -317,13 +317,15 @@ async def sample_create_backup_plan():
                 Required. The client-provided short
                 name for the BackupPlan resource. This
                 name must:
+
                 - be between 1 and 63 characters long
-                (inclusive) - consist of only lower-case
-                ASCII letters, numbers, and dashes -
-                start with a lower-case letter
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
                 - end with a lower-case letter or number
                 - be unique within the set of
-                BackupPlans in this location
+                  BackupPlans in this location
 
                 This corresponds to the ``backup_plan_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -957,11 +959,14 @@ async def sample_create_backup():
                 The client-provided short name for
                 the Backup resource. This name must:
 
-                 - be between 1 and 63 characters long (inclusive)
-                 - consist of only lower-case ASCII letters, numbers, and dashes
-                 - start with a lower-case letter
-                 - end with a lower-case letter or number
-                 - be unique within the set of Backups in this BackupPlan
+                - be between 1 and 63 characters long
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
+                - end with a lower-case letter or number
+                - be unique within the set of Backups in
+                  this BackupPlan
 
                 This corresponds to the ``backup_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1852,11 +1857,14 @@ async def sample_create_restore_plan():
                 name for the RestorePlan resource. This
                 name must:
 
-                 - be between 1 and 63 characters long (inclusive)
-                 - consist of only lower-case ASCII letters, numbers, and dashes
-                 - start with a lower-case letter
-                 - end with a lower-case letter or number
-                 - be unique within the set of RestorePlans in this location
+                - be between 1 and 63 characters long
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
+                - end with a lower-case letter or number
+                - be unique within the set of
+                  RestorePlans in this location
 
                 This corresponds to the ``restore_plan_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2503,11 +2511,14 @@ async def sample_create_restore():
                 name for the Restore resource. This name
                 must:
 
-                 - be between 1 and 63 characters long (inclusive)
-                 - consist of only lower-case ASCII letters, numbers, and dashes
-                 - start with a lower-case letter
-                 - end with a lower-case letter or number
-                 - be unique within the set of Restores in this RestorePlan.
+                - be between 1 and 63 characters long
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
+                - end with a lower-case letter or number
+                - be unique within the set of Restores
+                  in this RestorePlan.
 
                 This corresponds to the ``restore_id`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/gke_backup_v1/services/backup_for_gke/client.py b/google/cloud/gke_backup_v1/services/backup_for_gke/client.py
@@ -702,13 +702,15 @@ def sample_create_backup_plan():
                 Required. The client-provided short
                 name for the BackupPlan resource. This
                 name must:
+
                 - be between 1 and 63 characters long
-                (inclusive) - consist of only lower-case
-                ASCII letters, numbers, and dashes -
-                start with a lower-case letter
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
                 - end with a lower-case letter or number
                 - be unique within the set of
-                BackupPlans in this location
+                  BackupPlans in this location
 
                 This corresponds to the ``backup_plan_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1324,11 +1326,14 @@ def sample_create_backup():
                 The client-provided short name for
                 the Backup resource. This name must:
 
-                 - be between 1 and 63 characters long (inclusive)
-                 - consist of only lower-case ASCII letters, numbers, and dashes
-                 - start with a lower-case letter
-                 - end with a lower-case letter or number
-                 - be unique within the set of Backups in this BackupPlan
+                - be between 1 and 63 characters long
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
+                - end with a lower-case letter or number
+                - be unique within the set of Backups in
+                  this BackupPlan
 
                 This corresponds to the ``backup_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2183,11 +2188,14 @@ def sample_create_restore_plan():
                 name for the RestorePlan resource. This
                 name must:
 
-                 - be between 1 and 63 characters long (inclusive)
-                 - consist of only lower-case ASCII letters, numbers, and dashes
-                 - start with a lower-case letter
-                 - end with a lower-case letter or number
-                 - be unique within the set of RestorePlans in this location
+                - be between 1 and 63 characters long
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
+                - end with a lower-case letter or number
+                - be unique within the set of
+                  RestorePlans in this location
 
                 This corresponds to the ``restore_plan_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2816,11 +2824,14 @@ def sample_create_restore():
                 name for the Restore resource. This name
                 must:
 
-                 - be between 1 and 63 characters long (inclusive)
-                 - consist of only lower-case ASCII letters, numbers, and dashes
-                 - start with a lower-case letter
-                 - end with a lower-case letter or number
-                 - be unique within the set of Restores in this RestorePlan.
+                - be between 1 and 63 characters long
+                  (inclusive)
+                - consist of only lower-case ASCII
+                  letters, numbers, and dashes
+                - start with a lower-case letter
+                - end with a lower-case letter or number
+                - be unique within the set of Restores
+                  in this RestorePlan.
 
                 This corresponds to the ``restore_id`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/gke_backup_v1/types/gkebackup.py b/google/cloud/gke_backup_v1/types/gkebackup.py
@@ -141,11 +141,14 @@ class CreateBackupPlanRequest(proto.Message):
             Required. The client-provided short name for
             the BackupPlan resource. This name must:
 
-            - be between 1 and 63 characters long (inclusive)
-            - consist of only lower-case ASCII letters, numbers, and dashes
+            - be between 1 and 63 characters long
+              (inclusive)
+            - consist of only lower-case ASCII letters,
+              numbers, and dashes
             - start with a lower-case letter
             - end with a lower-case letter or number
-            - be unique within the set of BackupPlans in this location
+            - be unique within the set of BackupPlans in
+              this location
     """
 
     parent: str = proto.Field(
@@ -335,11 +338,14 @@ class CreateBackupRequest(proto.Message):
             The client-provided short name for the Backup
             resource. This name must:
 
-            - be between 1 and 63 characters long (inclusive)
-            - consist of only lower-case ASCII letters, numbers, and dashes
+            - be between 1 and 63 characters long
+              (inclusive)
+            - consist of only lower-case ASCII letters,
+              numbers, and dashes
             - start with a lower-case letter
             - end with a lower-case letter or number
-            - be unique within the set of Backups in this BackupPlan
+            - be unique within the set of Backups in this
+              BackupPlan
     """
 
     parent: str = proto.Field(
@@ -629,11 +635,14 @@ class CreateRestorePlanRequest(proto.Message):
             Required. The client-provided short name for
             the RestorePlan resource. This name must:
 
-            - be between 1 and 63 characters long (inclusive)
-            - consist of only lower-case ASCII letters, numbers, and dashes
+            - be between 1 and 63 characters long
+              (inclusive)
+            - consist of only lower-case ASCII letters,
+              numbers, and dashes
             - start with a lower-case letter
             - end with a lower-case letter or number
-            - be unique within the set of RestorePlans in this location
+            - be unique within the set of RestorePlans in
+              this location
     """
 
     parent: str = proto.Field(
@@ -831,11 +840,14 @@ class CreateRestoreRequest(proto.Message):
             Required. The client-provided short name for
             the Restore resource. This name must:
 
-            - be between 1 and 63 characters long (inclusive)
-            - consist of only lower-case ASCII letters, numbers, and dashes
+            - be between 1 and 63 characters long
+              (inclusive)
+            - consist of only lower-case ASCII letters,
+              numbers, and dashes
             - start with a lower-case letter
             - end with a lower-case letter or number
-            - be unique within the set of Restores in this RestorePlan.
+            - be unique within the set of Restores in this
+              RestorePlan.
     """
 
     parent: str = proto.Field(

diff --git a/google/cloud/gke_backup_v1/types/restore.py b/google/cloud/gke_backup_v1/types/restore.py
@@ -415,7 +415,8 @@ class ClusterResourceRestoreScope(proto.Message):
         Some group kinds are not reasonable choices for a restore, and
         will cause an error if selected here. Any scope selection that
         would restore "all valid" resources automatically excludes these
-        group kinds. - gkebackup.gke.io/BackupJob
+        group kinds.
+        - gkebackup.gke.io/BackupJob
         - gkebackup.gke.io/RestoreJob
         - metrics.k8s.io/NodeMetrics
         - migration.k8s.io/StorageState
@@ -596,14 +597,16 @@ class Op(proto.Enum):
                 ADD (4):
                     The "add" operation performs one of the
                     following functions, depending upon what the
-                    target location references: 1. If the target
-                    location specifies an array index, a new value
-                    is inserted into the array at the specified
-                    index. 2. If the target location specifies an
-                    object member that does not already exist, a new
-                    member is added to the object. 3. If the target
-                    location specifies an object member that does
-                    exist, that member's value is replaced.
+                    target location references:
+
+                    1. If the target location specifies an array
+                    index, a new value is inserted into the array at
+                    the specified index. 2. If the target location
+                    specifies an object member that does not already
+                    exist, a new member is added to the object. 3.
+                    If the target location specifies an object
+                    member that does exist, that member's value is
+                    replaced.
                 TEST (5):
                     The "test" operation tests that a value at
                     the target location is equal to a specified