Skip to content

Commit 458da78

Browse files
cloud-java-botcloud-java-bot
authored
chore: Update generation configuration at Wed Sep 25 02:24:25 UTC 2024 (#1681)
chore: Update generation configuration at Wed Sep 25 02:24:25 UTC 2024
1 parent 496a909 commit 458da78

File tree

9 files changed

+175
-46
lines changed

9 files changed

+175
-46
lines changed

‎README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,20 +52,20 @@ If you are using Maven without the BOM, add this to your dependencies:
5252
If you are using Gradle 5.x or later, add this to your dependencies:
5353

5454
```Groovy
55-
implementation platform('com.google.cloud:libraries-bom:26.44.0')
55+
implementation platform('com.google.cloud:libraries-bom:26.47.0')
5656
5757
implementation 'com.google.cloud:google-cloud-logging'
5858
```
5959
If you are using Gradle without BOM, add this to your dependencies:
6060

6161
```Groovy
62-
implementation 'com.google.cloud:google-cloud-logging:3.20.0'
62+
implementation 'com.google.cloud:google-cloud-logging:3.20.1'
6363
```
6464

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

6767
```Scala
68-
libraryDependencies += "com.google.cloud" % "google-cloud-logging" % "3.20.0"
68+
libraryDependencies += "com.google.cloud" % "google-cloud-logging" % "3.20.1"
6969
```
7070
<!-- {x-version-update-end} -->
7171

@@ -465,7 +465,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
465465
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-logging/java11.html
466466
[stability-image]: https://img.shields.io/badge/stability-stable-green
467467
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-logging.svg
468-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-logging/3.20.0
468+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-logging/3.20.1
469469
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
470470
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
471471
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

‎generation_config.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
gapic_generator_version: 2.44.0
2-
googleapis_commitish: 54d659d0ae74f39e92755948b821a1495b3cb3c8
3-
libraries_bom_version: 26.44.0
1+
gapic_generator_version: 2.46.0
2+
googleapis_commitish: 5c181aaf78bd1ae2e08c3a2971cd9e87b6e00986
3+
libraries_bom_version: 26.47.0
44
libraries:
55
- api_shortname: logging
66
name_pretty: Cloud Logging

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigSettings.java

Lines changed: 40 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,9 @@
101101
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
102102
* build() is called, the tree of builders is called to create the complete settings object.
103103
*
104-
* <p>For example, to set the total timeout of getBucket to 30 seconds:
104+
* <p>For example, to set the
105+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
106+
* of getBucket:
105107
*
106108
* <pre>{@code
107109
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -117,10 +119,46 @@
117119
* .getBucketSettings()
118120
* .getRetrySettings()
119121
* .toBuilder()
120-
* .setTotalTimeout(Duration.ofSeconds(30))
122+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
123+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
124+
* .setMaxAttempts(5)
125+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
126+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
127+
* .setRetryDelayMultiplier(1.3)
128+
* .setRpcTimeoutMultiplier(1.5)
129+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
121130
* .build());
122131
* ConfigSettings configSettings = configSettingsBuilder.build();
123132
* }</pre>
133+
*
134+
* Please refer to the [Client Side Retry
135+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
136+
* additional support in setting retries.
137+
*
138+
* <p>To configure the RetrySettings of a Long Running Operation method, create an
139+
* OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
140+
* configure the RetrySettings for createBucketAsync:
141+
*
142+
* <pre>{@code
143+
* // This snippet has been automatically generated and should be regarded as a code template only.
144+
* // It will require modifications to work:
145+
* // - It may require correct/in-range values for request initialization.
146+
* // - It may require specifying regional endpoints when creating the service client as shown in
147+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
148+
* ConfigSettings.Builder configSettingsBuilder = ConfigSettings.newBuilder();
149+
* TimedRetryAlgorithm timedRetryAlgorithm =
150+
* OperationalTimedPollAlgorithm.create(
151+
* RetrySettings.newBuilder()
152+
* .setInitialRetryDelayDuration(Duration.ofMillis(500))
153+
* .setRetryDelayMultiplier(1.5)
154+
* .setMaxRetryDelay(Duration.ofMillis(5000))
155+
* .setTotalTimeoutDuration(Duration.ofHours(24))
156+
* .build());
157+
* configSettingsBuilder
158+
* .createClusterOperationSettings()
159+
* .setPollingAlgorithm(timedRetryAlgorithm)
160+
* .build();
161+
* }</pre>
124162
*/
125163
@Generated("by gapic-generator-java")
126164
public class ConfigSettings extends ClientSettings<ConfigSettings> {

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/LoggingSettings.java

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,9 @@
6464
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
6565
* build() is called, the tree of builders is called to create the complete settings object.
6666
*
67-
* <p>For example, to set the total timeout of deleteLog to 30 seconds:
67+
* <p>For example, to set the
68+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
69+
* of deleteLog:
6870
*
6971
* <pre>{@code
7072
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -80,10 +82,21 @@
8082
* .deleteLogSettings()
8183
* .getRetrySettings()
8284
* .toBuilder()
83-
* .setTotalTimeout(Duration.ofSeconds(30))
85+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
86+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
87+
* .setMaxAttempts(5)
88+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
89+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
90+
* .setRetryDelayMultiplier(1.3)
91+
* .setRpcTimeoutMultiplier(1.5)
92+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
8493
* .build());
8594
* LoggingSettings loggingSettings = loggingSettingsBuilder.build();
8695
* }</pre>
96+
*
97+
* Please refer to the [Client Side Retry
98+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
99+
* additional support in setting retries.
87100
*/
88101
@Generated("by gapic-generator-java")
89102
public class LoggingSettings extends ClientSettings<LoggingSettings> {

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/MetricsSettings.java

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,9 @@
5656
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
5757
* build() is called, the tree of builders is called to create the complete settings object.
5858
*
59-
* <p>For example, to set the total timeout of getLogMetric to 30 seconds:
59+
* <p>For example, to set the
60+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
61+
* of getLogMetric:
6062
*
6163
* <pre>{@code
6264
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -72,10 +74,21 @@
7274
* .getLogMetricSettings()
7375
* .getRetrySettings()
7476
* .toBuilder()
75-
* .setTotalTimeout(Duration.ofSeconds(30))
77+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
78+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
79+
* .setMaxAttempts(5)
80+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
81+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
82+
* .setRetryDelayMultiplier(1.3)
83+
* .setRpcTimeoutMultiplier(1.5)
84+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
7685
* .build());
7786
* MetricsSettings metricsSettings = metricsSettingsBuilder.build();
7887
* }</pre>
88+
*
89+
* Please refer to the [Client Side Retry
90+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
91+
* additional support in setting retries.
7992
*/
8093
@Generated("by gapic-generator-java")
8194
public class MetricsSettings extends ClientSettings<MetricsSettings> {

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/stub/ConfigServiceV2StubSettings.java

Lines changed: 46 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,9 @@
120120
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
121121
* build() is called, the tree of builders is called to create the complete settings object.
122122
*
123-
* <p>For example, to set the total timeout of getBucket to 30 seconds:
123+
* <p>For example, to set the
124+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
125+
* of getBucket:
124126
*
125127
* <pre>{@code
126128
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -137,10 +139,47 @@
137139
* .getBucketSettings()
138140
* .getRetrySettings()
139141
* .toBuilder()
140-
* .setTotalTimeout(Duration.ofSeconds(30))
142+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
143+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
144+
* .setMaxAttempts(5)
145+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
146+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
147+
* .setRetryDelayMultiplier(1.3)
148+
* .setRpcTimeoutMultiplier(1.5)
149+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
141150
* .build());
142151
* ConfigServiceV2StubSettings configSettings = configSettingsBuilder.build();
143152
* }</pre>
153+
*
154+
* Please refer to the [Client Side Retry
155+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
156+
* additional support in setting retries.
157+
*
158+
* <p>To configure the RetrySettings of a Long Running Operation method, create an
159+
* OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
160+
* configure the RetrySettings for createBucketAsync:
161+
*
162+
* <pre>{@code
163+
* // This snippet has been automatically generated and should be regarded as a code template only.
164+
* // It will require modifications to work:
165+
* // - It may require correct/in-range values for request initialization.
166+
* // - It may require specifying regional endpoints when creating the service client as shown in
167+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
168+
* ConfigServiceV2StubSettings.Builder configSettingsBuilder =
169+
* ConfigServiceV2StubSettings.newBuilder();
170+
* TimedRetryAlgorithm timedRetryAlgorithm =
171+
* OperationalTimedPollAlgorithm.create(
172+
* RetrySettings.newBuilder()
173+
* .setInitialRetryDelayDuration(Duration.ofMillis(500))
174+
* .setRetryDelayMultiplier(1.5)
175+
* .setMaxRetryDelay(Duration.ofMillis(5000))
176+
* .setTotalTimeoutDuration(Duration.ofHours(24))
177+
* .build());
178+
* configSettingsBuilder
179+
* .createClusterOperationSettings()
180+
* .setPollingAlgorithm(timedRetryAlgorithm)
181+
* .build();
182+
* }</pre>
144183
*/
145184
@Generated("by gapic-generator-java")
146185
public class ConfigServiceV2StubSettings extends StubSettings<ConfigServiceV2StubSettings> {
@@ -234,9 +273,7 @@ public String extractNextToken(ListBucketsResponse payload) {
234273

235274
@Override
236275
public Iterable<LogBucket> extractResources(ListBucketsResponse payload) {
237-
return payload.getBucketsList() == null
238-
? ImmutableList.<LogBucket>of()
239-
: payload.getBucketsList();
276+
return payload.getBucketsList();
240277
}
241278
};
242279

@@ -270,9 +307,7 @@ public String extractNextToken(ListViewsResponse payload) {
270307

271308
@Override
272309
public Iterable<LogView> extractResources(ListViewsResponse payload) {
273-
return payload.getViewsList() == null
274-
? ImmutableList.<LogView>of()
275-
: payload.getViewsList();
310+
return payload.getViewsList();
276311
}
277312
};
278313

@@ -306,9 +341,7 @@ public String extractNextToken(ListSinksResponse payload) {
306341

307342
@Override
308343
public Iterable<LogSink> extractResources(ListSinksResponse payload) {
309-
return payload.getSinksList() == null
310-
? ImmutableList.<LogSink>of()
311-
: payload.getSinksList();
344+
return payload.getSinksList();
312345
}
313346
};
314347

@@ -342,9 +375,7 @@ public String extractNextToken(ListLinksResponse payload) {
342375

343376
@Override
344377
public Iterable<Link> extractResources(ListLinksResponse payload) {
345-
return payload.getLinksList() == null
346-
? ImmutableList.<Link>of()
347-
: payload.getLinksList();
378+
return payload.getLinksList();
348379
}
349380
};
350381

@@ -380,9 +411,7 @@ public String extractNextToken(ListExclusionsResponse payload) {
380411

381412
@Override
382413
public Iterable<LogExclusion> extractResources(ListExclusionsResponse payload) {
383-
return payload.getExclusionsList() == null
384-
? ImmutableList.<LogExclusion>of()
385-
: payload.getExclusionsList();
414+
return payload.getExclusionsList();
386415
}
387416
};
388417

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/stub/LoggingServiceV2StubSettings.java

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,9 @@
9090
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
9191
* build() is called, the tree of builders is called to create the complete settings object.
9292
*
93-
* <p>For example, to set the total timeout of deleteLog to 30 seconds:
93+
* <p>For example, to set the
94+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
95+
* of deleteLog:
9496
*
9597
* <pre>{@code
9698
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -107,10 +109,21 @@
107109
* .deleteLogSettings()
108110
* .getRetrySettings()
109111
* .toBuilder()
110-
* .setTotalTimeout(Duration.ofSeconds(30))
112+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
113+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
114+
* .setMaxAttempts(5)
115+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
116+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
117+
* .setRetryDelayMultiplier(1.3)
118+
* .setRpcTimeoutMultiplier(1.5)
119+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
111120
* .build());
112121
* LoggingServiceV2StubSettings loggingSettings = loggingSettingsBuilder.build();
113122
* }</pre>
123+
*
124+
* Please refer to the [Client Side Retry
125+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
126+
* additional support in setting retries.
114127
*/
115128
@Generated("by gapic-generator-java")
116129
public class LoggingServiceV2StubSettings extends StubSettings<LoggingServiceV2StubSettings> {
@@ -171,9 +184,7 @@ public String extractNextToken(ListLogEntriesResponse payload) {
171184

172185
@Override
173186
public Iterable<LogEntry> extractResources(ListLogEntriesResponse payload) {
174-
return payload.getEntriesList() == null
175-
? ImmutableList.<LogEntry>of()
176-
: payload.getEntriesList();
187+
return payload.getEntriesList();
177188
}
178189
};
179190

@@ -220,9 +231,7 @@ public String extractNextToken(ListMonitoredResourceDescriptorsResponse payload)
220231
@Override
221232
public Iterable<MonitoredResourceDescriptor> extractResources(
222233
ListMonitoredResourceDescriptorsResponse payload) {
223-
return payload.getResourceDescriptorsList() == null
224-
? ImmutableList.<MonitoredResourceDescriptor>of()
225-
: payload.getResourceDescriptorsList();
234+
return payload.getResourceDescriptorsList();
226235
}
227236
};
228237

@@ -256,9 +265,7 @@ public String extractNextToken(ListLogsResponse payload) {
256265

257266
@Override
258267
public Iterable<String> extractResources(ListLogsResponse payload) {
259-
return payload.getLogNamesList() == null
260-
? ImmutableList.<String>of()
261-
: payload.getLogNamesList();
268+
return payload.getLogNamesList();
262269
}
263270
};
264271

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/stub/MetricsServiceV2StubSettings.java

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,9 @@
7272
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
7373
* build() is called, the tree of builders is called to create the complete settings object.
7474
*
75-
* <p>For example, to set the total timeout of getLogMetric to 30 seconds:
75+
* <p>For example, to set the
76+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
77+
* of getLogMetric:
7678
*
7779
* <pre>{@code
7880
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -89,10 +91,21 @@
8991
* .getLogMetricSettings()
9092
* .getRetrySettings()
9193
* .toBuilder()
92-
* .setTotalTimeout(Duration.ofSeconds(30))
94+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
95+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
96+
* .setMaxAttempts(5)
97+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
98+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
99+
* .setRetryDelayMultiplier(1.3)
100+
* .setRpcTimeoutMultiplier(1.5)
101+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
93102
* .build());
94103
* MetricsServiceV2StubSettings metricsSettings = metricsSettingsBuilder.build();
95104
* }</pre>
105+
*
106+
* Please refer to the [Client Side Retry
107+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
108+
* additional support in setting retries.
96109
*/
97110
@Generated("by gapic-generator-java")
98111
public class MetricsServiceV2StubSettings extends StubSettings<MetricsServiceV2StubSettings> {
@@ -145,9 +158,7 @@ public String extractNextToken(ListLogMetricsResponse payload) {
145158

146159
@Override
147160
public Iterable<LogMetric> extractResources(ListLogMetricsResponse payload) {
148-
return payload.getMetricsList() == null
149-
? ImmutableList.<LogMetric>of()
150-
: payload.getMetricsList();
161+
return payload.getMetricsList();
151162
}
152163
};
153164

0 commit comments

Comments
 (0)