Skip to content
This repository has been archived by the owner on Oct 2, 2023. It is now read-only.

docs(regen): updated proto documentation #74

Merged
merged 1 commit into from Feb 18, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
Expand Up @@ -184,8 +184,8 @@ public AlertPolicyServiceStub getStub() {
* }
* </code></pre>
*
* @param name Required. The project whose alert policies are to be listed. The format is
* <p>projects/[PROJECT_ID]
* @param name Required. The project whose alert policies are to be listed. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* <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
* [GetAlertPolicy][google.monitoring.v3.AlertPolicyService.GetAlertPolicy] operation,
Expand Down Expand Up @@ -215,8 +215,8 @@ public final ListAlertPoliciesPagedResponse listAlertPolicies(ProjectName name)
* }
* </code></pre>
*
* @param name Required. The project whose alert policies are to be listed. The format is
* <p>projects/[PROJECT_ID]
* @param name Required. The project whose alert policies are to be listed. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* <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
* [GetAlertPolicy][google.monitoring.v3.AlertPolicyService.GetAlertPolicy] operation,
Expand Down Expand Up @@ -323,8 +323,8 @@ public final ListAlertPoliciesPagedResponse listAlertPolicies(ListAlertPoliciesR
* }
* </code></pre>
*
* @param name Required. The alerting policy to retrieve. The format is
* <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
* @param name Required. The alerting policy to retrieve. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final AlertPolicy getAlertPolicy(AlertPolicyName name) {
Expand All @@ -346,8 +346,8 @@ public final AlertPolicy getAlertPolicy(AlertPolicyName name) {
* }
* </code></pre>
*
* @param name Required. The alerting policy to retrieve. The format is
* <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
* @param name Required. The alerting policy to retrieve. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final AlertPolicy getAlertPolicy(String name) {
Expand Down Expand Up @@ -414,15 +414,15 @@ public final UnaryCallable<GetAlertPolicyRequest, AlertPolicy> getAlertPolicyCal
* }
* </code></pre>
*
* @param name Required. The project in which to create the alerting policy. The format is
* `projects/[PROJECT_ID]`.
* @param name Required. The project in which to create the alerting policy. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* <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.
* of the form `/alertPolicies/[ALERT_POLICY_ID]`, identifying the policy in the container.
* @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.
* 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
*/
public final AlertPolicy createAlertPolicy(ProjectName name, AlertPolicy alertPolicy) {
Expand All @@ -448,15 +448,15 @@ public final AlertPolicy createAlertPolicy(ProjectName name, AlertPolicy alertPo
* }
* </code></pre>
*
* @param name Required. The project in which to create the alerting policy. The format is
* `projects/[PROJECT_ID]`.
* @param name Required. The project in which to create the alerting policy. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* <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.
* of the form `/alertPolicies/[ALERT_POLICY_ID]`, identifying the policy in the container.
* @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.
* 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
*/
public final AlertPolicy createAlertPolicy(String name, AlertPolicy alertPolicy) {
Expand Down Expand Up @@ -528,7 +528,7 @@ public final UnaryCallable<CreateAlertPolicyRequest, AlertPolicy> createAlertPol
* </code></pre>
*
* @param name Required. The alerting policy to delete. The format is:
* <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
* <p>projects/[PROJECT_ID_OR_NUMBER]/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
*/
Expand All @@ -554,7 +554,7 @@ public final void deleteAlertPolicy(AlertPolicyName name) {
* </code></pre>
*
* @param name Required. The alerting policy to delete. The format is:
* <p>projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
* <p>projects/[PROJECT_ID_OR_NUMBER]/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
*/
Expand Down
Expand Up @@ -187,8 +187,8 @@ public GroupServiceStub getStub() {
* }
* </code></pre>
*
* @param name Required. The project whose groups are to be listed. The format is
* `"projects/{project_id_or_number}"`.
* @param name Required. The project whose groups are to be listed. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListGroupsPagedResponse listGroups(ProjectName name) {
Expand All @@ -212,8 +212,8 @@ public final ListGroupsPagedResponse listGroups(ProjectName name) {
* }
* </code></pre>
*
* @param name Required. The project whose groups are to be listed. The format is
* `"projects/{project_id_or_number}"`.
* @param name Required. The project whose groups are to be listed. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListGroupsPagedResponse listGroups(String name) {
Expand Down Expand Up @@ -314,8 +314,8 @@ public final UnaryCallable<ListGroupsRequest, ListGroupsResponse> listGroupsCall
* }
* </code></pre>
*
* @param name Required. The group to retrieve. The format is
* `"projects/{project_id_or_number}/groups/{group_id}"`.
* @param name Required. The group to retrieve. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Group getGroup(GroupName name) {
Expand All @@ -337,8 +337,8 @@ public final Group getGroup(GroupName name) {
* }
* </code></pre>
*
* @param name Required. The group to retrieve. The format is
* `"projects/{project_id_or_number}/groups/{group_id}"`.
* @param name Required. The group to retrieve. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Group getGroup(String name) {
Expand Down Expand Up @@ -405,8 +405,8 @@ public final UnaryCallable<GetGroupRequest, Group> getGroupCallable() {
* }
* </code></pre>
*
* @param name Required. The project in which to create the group. The format is
* `"projects/{project_id_or_number}"`.
* @param name Required. The project in which to create the group. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* @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
Expand Down Expand Up @@ -434,8 +434,8 @@ public final Group createGroup(ProjectName name, Group group) {
* }
* </code></pre>
*
* @param name Required. The project in which to create the group. The format is
* `"projects/{project_id_or_number}"`.
* @param name Required. The project in which to create the group. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]
* @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
Expand Down Expand Up @@ -575,8 +575,8 @@ public final UnaryCallable<UpdateGroupRequest, Group> updateGroupCallable() {
* }
* </code></pre>
*
* @param name Required. The group to delete. The format is
* `"projects/{project_id_or_number}/groups/{group_id}"`.
* @param name Required. The group to delete. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void deleteGroup(GroupName name) {
Expand All @@ -598,8 +598,8 @@ public final void deleteGroup(GroupName name) {
* }
* </code></pre>
*
* @param name Required. The group to delete. The format is
* `"projects/{project_id_or_number}/groups/{group_id}"`.
* @param name Required. The group to delete. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void deleteGroup(String name) {
Expand Down Expand Up @@ -667,8 +667,8 @@ public final UnaryCallable<DeleteGroupRequest, Empty> deleteGroupCallable() {
* }
* </code></pre>
*
* @param name Required. The group whose members are listed. The format is
* `"projects/{project_id_or_number}/groups/{group_id}"`.
* @param name Required. The group whose members are listed. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListGroupMembersPagedResponse listGroupMembers(GroupName name) {
Expand All @@ -692,8 +692,8 @@ public final ListGroupMembersPagedResponse listGroupMembers(GroupName name) {
* }
* </code></pre>
*
* @param name Required. The group whose members are listed. The format is
* `"projects/{project_id_or_number}/groups/{group_id}"`.
* @param name Required. The group whose members are listed. The format is:
* <p>projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListGroupMembersPagedResponse listGroupMembers(String name) {
Expand Down