Skip to content

Commit

Permalink
docs: [container] minor grammar improvements (#9140)
Browse files Browse the repository at this point in the history 
* chore: Reformatting

PiperOrigin-RevId: 511116336

Source-Link: googleapis/googleapis@af2f5da

Source-Link: googleapis/googleapis-gen@9c6068e
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjljNjA2OGU4ODIxZjA3MTk4ZWQ2ZjA2ZTI5NGY5ZDI3YjE2MGU2NDUifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* docs: minor grammar improvements

PiperOrigin-RevId: 511850615

Source-Link: googleapis/googleapis@6f90843

Source-Link: googleapis/googleapis-gen@26bf8b2
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjI2YmY4YjJhZjYyNzZjYTM0Y2E2YzUzZWI0NDEwZjFlMjRhOGY2ZmEifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* docs: minor grammar improvements

PiperOrigin-RevId: 512664562

Source-Link: googleapis/googleapis@2328fdb

Source-Link: googleapis/googleapis-gen@9363531
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjkzNjM1MzE1ZWI3ZmIwZDk5YTViNjA0ZDE4MTA2YjhmNDcyNzU0YjIifQ==

* 🦉 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>
  • Loading branch information
@gcf-owl-bot
gcf-owl-bot[bot] and gcf-owl-bot[bot] committed Feb 28, 2023
1 parent d6c639e commit c4f8231
Show file tree
Hide file tree
Showing 14 changed files with 307 additions and 307 deletions.
6 changes: 3 additions & 3 deletions java-container/README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,20 +20,20 @@ If you are using Maven, add this to your pom.xml file:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-container</artifactId>
<version>2.12.0</version>
<version>2.14.0</version>
</dependency>
```

If you are using Gradle without BOM, add this to your dependencies:

```Groovy
implementation 'com.google.cloud:google-cloud-container:2.12.0'
implementation 'com.google.cloud:google-cloud-container:2.14.0'
```

If you are using SBT, add this to your dependencies:

```Scala
libraryDependencies += "com.google.cloud" % "google-cloud-container" % "2.12.0"
libraryDependencies += "com.google.cloud" % "google-cloud-container" % "2.14.0"
```
<!--- {x-version-update-end} -->

Expand Down
110 changes: 55 additions & 55 deletions ...loud-container/src/main/java/com/google/cloud/container/v1beta1/ClusterManagerClient.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1981,6 +1981,61 @@ public final UnaryCallable<GetServerConfigRequest, ServerConfig> getServerConfig
return stub.getServerConfigCallable();
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets the public component of the cluster signing keys in JSON Web Key format. This API is not
* yet intended for general use, and is not available for all clusters.
*
* <p>Sample code:
*
* <pre>{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (ClusterManagerClient clusterManagerClient = ClusterManagerClient.create()) {
* GetJSONWebKeysRequest request =
* GetJSONWebKeysRequest.newBuilder().setParent("parent-995424086").build();
* GetJSONWebKeysResponse response = clusterManagerClient.getJSONWebKeys(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final GetJSONWebKeysResponse getJSONWebKeys(GetJSONWebKeysRequest request) {
return getJSONWebKeysCallable().call(request);
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets the public component of the cluster signing keys in JSON Web Key format. This API is not
* yet intended for general use, and is not available for all clusters.
*
* <p>Sample code:
*
* <pre>{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (ClusterManagerClient clusterManagerClient = ClusterManagerClient.create()) {
* GetJSONWebKeysRequest request =
* GetJSONWebKeysRequest.newBuilder().setParent("parent-995424086").build();
* ApiFuture<GetJSONWebKeysResponse> future =
* clusterManagerClient.getJSONWebKeysCallable().futureCall(request);
* // Do something.
* GetJSONWebKeysResponse response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<GetJSONWebKeysRequest, GetJSONWebKeysResponse>
getJSONWebKeysCallable() {
return stub.getJSONWebKeysCallable();
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists the node pools for a cluster.
Expand Down Expand Up @@ -2085,61 +2140,6 @@ public final UnaryCallable<ListNodePoolsRequest, ListNodePoolsResponse> listNode
return stub.listNodePoolsCallable();
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets the public component of the cluster signing keys in JSON Web Key format. This API is not
* yet intended for general use, and is not available for all clusters.
*
* <p>Sample code:
*
* <pre>{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (ClusterManagerClient clusterManagerClient = ClusterManagerClient.create()) {
* GetJSONWebKeysRequest request =
* GetJSONWebKeysRequest.newBuilder().setParent("parent-995424086").build();
* GetJSONWebKeysResponse response = clusterManagerClient.getJSONWebKeys(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final GetJSONWebKeysResponse getJSONWebKeys(GetJSONWebKeysRequest request) {
return getJSONWebKeysCallable().call(request);
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets the public component of the cluster signing keys in JSON Web Key format. This API is not
* yet intended for general use, and is not available for all clusters.
*
* <p>Sample code:
*
* <pre>{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (ClusterManagerClient clusterManagerClient = ClusterManagerClient.create()) {
* GetJSONWebKeysRequest request =
* GetJSONWebKeysRequest.newBuilder().setParent("parent-995424086").build();
* ApiFuture<GetJSONWebKeysResponse> future =
* clusterManagerClient.getJSONWebKeysCallable().futureCall(request);
* // Do something.
* GetJSONWebKeysResponse response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<GetJSONWebKeysRequest, GetJSONWebKeysResponse>
getJSONWebKeysCallable() {
return stub.getJSONWebKeysCallable();
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Retrieves the requested node pool.
Expand Down
22 changes: 11 additions & 11 deletions ...ud-container/src/main/java/com/google/cloud/container/v1beta1/ClusterManagerSettings.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -211,16 +211,16 @@ public UnaryCallSettings<GetServerConfigRequest, ServerConfig> getServerConfigSe
return ((ClusterManagerStubSettings) getStubSettings()).getServerConfigSettings();
}

/** Returns the object with the settings used for calls to listNodePools. */
public UnaryCallSettings<ListNodePoolsRequest, ListNodePoolsResponse> listNodePoolsSettings() {
return ((ClusterManagerStubSettings) getStubSettings()).listNodePoolsSettings();
}

/** Returns the object with the settings used for calls to getJSONWebKeys. */
public UnaryCallSettings<GetJSONWebKeysRequest, GetJSONWebKeysResponse> getJSONWebKeysSettings() {
return ((ClusterManagerStubSettings) getStubSettings()).getJSONWebKeysSettings();
}

/** Returns the object with the settings used for calls to listNodePools. */
public UnaryCallSettings<ListNodePoolsRequest, ListNodePoolsResponse> listNodePoolsSettings() {
return ((ClusterManagerStubSettings) getStubSettings()).listNodePoolsSettings();
}

/** Returns the object with the settings used for calls to getNodePool. */
public UnaryCallSettings<GetNodePoolRequest, NodePool> getNodePoolSettings() {
return ((ClusterManagerStubSettings) getStubSettings()).getNodePoolSettings();
Expand Down Expand Up @@ -496,18 +496,18 @@ public UnaryCallSettings.Builder<CancelOperationRequest, Empty> cancelOperationS
return getStubSettingsBuilder().getServerConfigSettings();
}

/** Returns the builder for the settings used for calls to listNodePools. */
public UnaryCallSettings.Builder<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings() {
return getStubSettingsBuilder().listNodePoolsSettings();
}

/** Returns the builder for the settings used for calls to getJSONWebKeys. */
public UnaryCallSettings.Builder<GetJSONWebKeysRequest, GetJSONWebKeysResponse>
getJSONWebKeysSettings() {
return getStubSettingsBuilder().getJSONWebKeysSettings();
}

/** Returns the builder for the settings used for calls to listNodePools. */
public UnaryCallSettings.Builder<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings() {
return getStubSettingsBuilder().listNodePoolsSettings();
}

/** Returns the builder for the settings used for calls to getNodePool. */
public UnaryCallSettings.Builder<GetNodePoolRequest, NodePool> getNodePoolSettings() {
return getStubSettingsBuilder().getNodePoolSettings();
Expand Down
8 changes: 4 additions & 4 deletions ...d-container/src/main/java/com/google/cloud/container/v1beta1/stub/ClusterManagerStub.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -147,14 +147,14 @@ public UnaryCallable<GetServerConfigRequest, ServerConfig> getServerConfigCallab
throw new UnsupportedOperationException("Not implemented: getServerConfigCallable()");
}

public UnaryCallable<ListNodePoolsRequest, ListNodePoolsResponse> listNodePoolsCallable() {
throw new UnsupportedOperationException("Not implemented: listNodePoolsCallable()");
}

public UnaryCallable<GetJSONWebKeysRequest, GetJSONWebKeysResponse> getJSONWebKeysCallable() {
throw new UnsupportedOperationException("Not implemented: getJSONWebKeysCallable()");
}

public UnaryCallable<ListNodePoolsRequest, ListNodePoolsResponse> listNodePoolsCallable() {
throw new UnsupportedOperationException("Not implemented: listNodePoolsCallable()");
}

public UnaryCallable<GetNodePoolRequest, NodePool> getNodePoolCallable() {
throw new UnsupportedOperationException("Not implemented: getNodePoolCallable()");
}
Expand Down
50 changes: 25 additions & 25 deletions ...ner/src/main/java/com/google/cloud/container/v1beta1/stub/ClusterManagerStubSettings.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -159,10 +159,10 @@ public class ClusterManagerStubSettings extends StubSettings<ClusterManagerStubS
private final UnaryCallSettings<GetOperationRequest, Operation> getOperationSettings;
private final UnaryCallSettings<CancelOperationRequest, Empty> cancelOperationSettings;
private final UnaryCallSettings<GetServerConfigRequest, ServerConfig> getServerConfigSettings;
private final UnaryCallSettings<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings;
private final UnaryCallSettings<GetJSONWebKeysRequest, GetJSONWebKeysResponse>
getJSONWebKeysSettings;
private final UnaryCallSettings<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings;
private final UnaryCallSettings<GetNodePoolRequest, NodePool> getNodePoolSettings;
private final UnaryCallSettings<CreateNodePoolRequest, Operation> createNodePoolSettings;
private final UnaryCallSettings<DeleteNodePoolRequest, Operation> deleteNodePoolSettings;
Expand Down Expand Up @@ -344,16 +344,16 @@ public UnaryCallSettings<GetServerConfigRequest, ServerConfig> getServerConfigSe
return getServerConfigSettings;
}

/** Returns the object with the settings used for calls to listNodePools. */
public UnaryCallSettings<ListNodePoolsRequest, ListNodePoolsResponse> listNodePoolsSettings() {
return listNodePoolsSettings;
}

/** Returns the object with the settings used for calls to getJSONWebKeys. */
public UnaryCallSettings<GetJSONWebKeysRequest, GetJSONWebKeysResponse> getJSONWebKeysSettings() {
return getJSONWebKeysSettings;
}

/** Returns the object with the settings used for calls to listNodePools. */
public UnaryCallSettings<ListNodePoolsRequest, ListNodePoolsResponse> listNodePoolsSettings() {
return listNodePoolsSettings;
}

/** Returns the object with the settings used for calls to getNodePool. */
public UnaryCallSettings<GetNodePoolRequest, NodePool> getNodePoolSettings() {
return getNodePoolSettings;
Expand Down Expand Up @@ -528,8 +528,8 @@ protected ClusterManagerStubSettings(Builder settingsBuilder) throws IOException
getOperationSettings = settingsBuilder.getOperationSettings().build();
cancelOperationSettings = settingsBuilder.cancelOperationSettings().build();
getServerConfigSettings = settingsBuilder.getServerConfigSettings().build();
listNodePoolsSettings = settingsBuilder.listNodePoolsSettings().build();
getJSONWebKeysSettings = settingsBuilder.getJSONWebKeysSettings().build();
listNodePoolsSettings = settingsBuilder.listNodePoolsSettings().build();
getNodePoolSettings = settingsBuilder.getNodePoolSettings().build();
createNodePoolSettings = settingsBuilder.createNodePoolSettings().build();
deleteNodePoolSettings = settingsBuilder.deleteNodePoolSettings().build();
Expand Down Expand Up @@ -575,10 +575,10 @@ public static class Builder extends StubSettings.Builder<ClusterManagerStubSetti
private final UnaryCallSettings.Builder<CancelOperationRequest, Empty> cancelOperationSettings;
private final UnaryCallSettings.Builder<GetServerConfigRequest, ServerConfig>
getServerConfigSettings;
private final UnaryCallSettings.Builder<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings;
private final UnaryCallSettings.Builder<GetJSONWebKeysRequest, GetJSONWebKeysResponse>
getJSONWebKeysSettings;
private final UnaryCallSettings.Builder<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings;
private final UnaryCallSettings.Builder<GetNodePoolRequest, NodePool> getNodePoolSettings;
private final UnaryCallSettings.Builder<CreateNodePoolRequest, Operation>
createNodePoolSettings;
Expand Down Expand Up @@ -679,8 +679,8 @@ protected Builder(ClientContext clientContext) {
getOperationSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
cancelOperationSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
getServerConfigSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
listNodePoolsSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
getJSONWebKeysSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
listNodePoolsSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
getNodePoolSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
createNodePoolSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
deleteNodePoolSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
Expand Down Expand Up @@ -717,8 +717,8 @@ protected Builder(ClientContext clientContext) {
getOperationSettings,
cancelOperationSettings,
getServerConfigSettings,
listNodePoolsSettings,
getJSONWebKeysSettings,
listNodePoolsSettings,
getNodePoolSettings,
createNodePoolSettings,
deleteNodePoolSettings,
Expand Down Expand Up @@ -757,8 +757,8 @@ protected Builder(ClusterManagerStubSettings settings) {
getOperationSettings = settings.getOperationSettings.toBuilder();
cancelOperationSettings = settings.cancelOperationSettings.toBuilder();
getServerConfigSettings = settings.getServerConfigSettings.toBuilder();
listNodePoolsSettings = settings.listNodePoolsSettings.toBuilder();
getJSONWebKeysSettings = settings.getJSONWebKeysSettings.toBuilder();
listNodePoolsSettings = settings.listNodePoolsSettings.toBuilder();
getNodePoolSettings = settings.getNodePoolSettings.toBuilder();
createNodePoolSettings = settings.createNodePoolSettings.toBuilder();
deleteNodePoolSettings = settings.deleteNodePoolSettings.toBuilder();
Expand Down Expand Up @@ -794,8 +794,8 @@ protected Builder(ClusterManagerStubSettings settings) {
getOperationSettings,
cancelOperationSettings,
getServerConfigSettings,
listNodePoolsSettings,
getJSONWebKeysSettings,
listNodePoolsSettings,
getNodePoolSettings,
createNodePoolSettings,
deleteNodePoolSettings,
Expand Down Expand Up @@ -912,16 +912,16 @@ private static Builder initDefaults(Builder builder) {
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
.setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params"));

builder
.listNodePoolsSettings()
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
.setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params"));

builder
.getJSONWebKeysSettings()
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_codes"))
.setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_params"));

builder
.listNodePoolsSettings()
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
.setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params"));

builder
.getNodePoolSettings()
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
Expand Down Expand Up @@ -1111,18 +1111,18 @@ public UnaryCallSettings.Builder<CancelOperationRequest, Empty> cancelOperationS
return getServerConfigSettings;
}

/** Returns the builder for the settings used for calls to listNodePools. */
public UnaryCallSettings.Builder<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings() {
return listNodePoolsSettings;
}

/** Returns the builder for the settings used for calls to getJSONWebKeys. */
public UnaryCallSettings.Builder<GetJSONWebKeysRequest, GetJSONWebKeysResponse>
getJSONWebKeysSettings() {
return getJSONWebKeysSettings;
}

/** Returns the builder for the settings used for calls to listNodePools. */
public UnaryCallSettings.Builder<ListNodePoolsRequest, ListNodePoolsResponse>
listNodePoolsSettings() {
return listNodePoolsSettings;
}

/** Returns the builder for the settings used for calls to getNodePool. */
public UnaryCallSettings.Builder<GetNodePoolRequest, NodePool> getNodePoolSettings() {
return getNodePoolSettings;
Expand Down

0 comments on commit c4f8231

Please sign in to comment.