docs(regen): regenerate with proto annotations (#54)

Co-authored-by: Jeff Ching <[email protected]>

Author: yoshi-automation

google-cloud-monitoring/src/main/java/com/google/cloud/monitoring/v3/AlertPolicyServiceClient.java

@@ -184,7 +184,7 @@ public AlertPolicyServiceStub getStub() {
    * }
    * </code></pre>
    *
-   * @param name The project whose alert policies are to be listed. The format is
+   * @param name Required. The project whose alert policies are to be listed. The format is
    *     <p>projects/[PROJECT_ID]
    *     <p>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
@@ -215,7 +215,7 @@ public final ListAlertPoliciesPagedResponse listAlertPolicies(ProjectName name)
    * }
    * </code></pre>
    *
-   * @param name The project whose alert policies are to be listed. The format is
+   * @param name Required. The project whose alert policies are to be listed. The format is
    *     <p>projects/[PROJECT_ID]
    *     <p>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
@@ -323,7 +323,7 @@ public final ListAlertPoliciesPagedResponse listAlertPolicies(ListAlertPoliciesR
    * }
    * </code></pre>
    *
-   * @param name The alerting policy to retrieve. The format is
+   * @param name Required. The alerting policy to retrieve. The format is
    *     <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -346,7 +346,7 @@ public final AlertPolicy getAlertPolicy(AlertPolicyName name) {
    * }
    * </code></pre>
    *
-   * @param name The alerting policy to retrieve. The format is
+   * @param name Required. The alerting policy to retrieve. The format is
    *     <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -414,14 +414,14 @@ public final UnaryCallable<GetAlertPolicyRequest, AlertPolicy> getAlertPolicyCal
    * }
    * </code></pre>
    *
-   * @param name The project in which to create the alerting policy. The format is
+   * @param name Required. The project in which to create the alerting policy. The format is
    *     `projects/[PROJECT_ID]`.
    *     <p>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.
-   * @param 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]
+   * @param 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.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -448,14 +448,14 @@ public final AlertPolicy createAlertPolicy(ProjectName name, AlertPolicy alertPo
    * }
    * </code></pre>
    *
-   * @param name The project in which to create the alerting policy. The format is
+   * @param name Required. The project in which to create the alerting policy. The format is
    *     `projects/[PROJECT_ID]`.
    *     <p>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.
-   * @param 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]
+   * @param 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.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -527,7 +527,7 @@ public final UnaryCallable<CreateAlertPolicyRequest, AlertPolicy> createAlertPol
    * }
    * </code></pre>
    *
-   * @param name The alerting policy to delete. The format is:
+   * @param name Required. The alerting policy to delete. The format is:
    *     <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
    *     <p>For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy].
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -553,7 +553,7 @@ public final void deleteAlertPolicy(AlertPolicyName name) {
    * }
    * </code></pre>
    *
-   * @param name The alerting policy to delete. The format is:
+   * @param name Required. The alerting policy to delete. The format is:
    *     <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
    *     <p>For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy].
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails

google-cloud-monitoring/src/main/java/com/google/cloud/monitoring/v3/GroupServiceClient.java

@@ -187,7 +187,7 @@ public GroupServiceStub getStub() {
    * }
    * </code></pre>
    *
-   * @param name The project whose groups are to be listed. The format is
+   * @param name Required. The project whose groups are to be listed. The format is
    *     `"projects/{project_id_or_number}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -212,7 +212,7 @@ public final ListGroupsPagedResponse listGroups(ProjectName name) {
    * }
    * </code></pre>
    *
-   * @param name The project whose groups are to be listed. The format is
+   * @param name Required. The project whose groups are to be listed. The format is
    *     `"projects/{project_id_or_number}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -314,7 +314,7 @@ public final UnaryCallable<ListGroupsRequest, ListGroupsResponse> listGroupsCall
    * }
    * </code></pre>
    *
-   * @param name The group to retrieve. The format is
+   * @param name Required. The group to retrieve. The format is
    *     `"projects/{project_id_or_number}/groups/{group_id}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -337,7 +337,7 @@ public final Group getGroup(GroupName name) {
    * }
    * </code></pre>
    *
-   * @param name The group to retrieve. The format is
+   * @param name Required. The group to retrieve. The format is
    *     `"projects/{project_id_or_number}/groups/{group_id}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -405,10 +405,10 @@ public final UnaryCallable<GetGroupRequest, Group> getGroupCallable() {
    * }
    * </code></pre>
    *
-   * @param name The project in which to create the group. The format is
+   * @param name Required. The project in which to create the group. The format is
    *     `"projects/{project_id_or_number}"`.
-   * @param group A group definition. It is an error to define the `name` field because the system
-   *     assigns the name.
+   * @param group Required. A group definition. It is an error to define the `name` field because
+   *     the system assigns the name.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Group createGroup(ProjectName name, Group group) {
@@ -434,10 +434,10 @@ public final Group createGroup(ProjectName name, Group group) {
    * }
    * </code></pre>
    *
-   * @param name The project in which to create the group. The format is
+   * @param name Required. The project in which to create the group. The format is
    *     `"projects/{project_id_or_number}"`.
-   * @param group A group definition. It is an error to define the `name` field because the system
-   *     assigns the name.
+   * @param group Required. A group definition. It is an error to define the `name` field because
+   *     the system assigns the name.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Group createGroup(String name, Group group) {
@@ -508,8 +508,8 @@ public final UnaryCallable<CreateGroupRequest, Group> createGroupCallable() {
    * }
    * </code></pre>
    *
-   * @param group The new definition of the group. All fields of the existing group, excepting
-   *     `name`, are replaced with the corresponding fields of this group.
+   * @param 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.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Group updateGroup(Group group) {
@@ -575,7 +575,7 @@ public final UnaryCallable<UpdateGroupRequest, Group> updateGroupCallable() {
    * }
    * </code></pre>
    *
-   * @param name The group to delete. The format is
+   * @param name Required. The group to delete. The format is
    *     `"projects/{project_id_or_number}/groups/{group_id}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -598,7 +598,7 @@ public final void deleteGroup(GroupName name) {
    * }
    * </code></pre>
    *
-   * @param name The group to delete. The format is
+   * @param name Required. The group to delete. The format is
    *     `"projects/{project_id_or_number}/groups/{group_id}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -667,7 +667,7 @@ public final UnaryCallable<DeleteGroupRequest, Empty> deleteGroupCallable() {
    * }
    * </code></pre>
    *
-   * @param name The group whose members are listed. The format is
+   * @param name Required. The group whose members are listed. The format is
    *     `"projects/{project_id_or_number}/groups/{group_id}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -692,7 +692,7 @@ public final ListGroupMembersPagedResponse listGroupMembers(GroupName name) {
    * }
    * </code></pre>
    *
-   * @param name The group whose members are listed. The format is
+   * @param name Required. The group whose members are listed. The format is
    *     `"projects/{project_id_or_number}/groups/{group_id}"`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */