Skip to content

Commit ec7e9f8

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
committed
🦉 Updates from OwlBot post-processor
See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md
1 parent 2e36e37 commit ec7e9f8

File tree

225 files changed

+33619
-43622
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

225 files changed

+33619
-43622
lines changed

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

Lines changed: 587 additions & 13 deletions
Large diffs are not rendered by default.

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

Lines changed: 112 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -76,19 +76,118 @@
7676
* <p>Note: close() needs to be called on the LoggingClient object to clean up resources such as
7777
* threads. In the example above, try-with-resources is used, which automatically calls close().
7878
*
79-
* <p>The surface of this class includes several types of Java methods for each of the API's
80-
* methods:
81-
*
82-
* <ol>
83-
* <li>A "flattened" method. With this type of method, the fields of the request type have been
84-
* converted into function parameters. It may be the case that not all fields are available as
85-
* parameters, and not every API method will have a flattened method entry point.
86-
* <li>A "request object" method. This type of method only takes one parameter, a request object,
87-
* which must be constructed before the call. Not every API method will have a request object
88-
* method.
89-
* <li>A "callable" method. This type of method takes no parameters and returns an immutable API
90-
* callable object, which can be used to initiate calls to the service.
91-
* </ol>
79+
* <table>
80+
* <tr>
81+
* <th>Method</th>
82+
* <th>Description</th>
83+
* <th>Method Variants</th>
84+
* <tr>
85+
* <td>DeleteLog</td>
86+
* <td><p> Deletes all the log entries in a log for the _Default Log Bucket. The log reappears if it receives new entries. Log entries written shortly before the delete operation might not be deleted. Entries received after the delete operation with a timestamp before the operation will be deleted.</td>
87+
* <td>
88+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
89+
* <ul>
90+
* <li>deleteLog(DeleteLogRequest request)
91+
* </ul>
92+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
93+
* <ul>
94+
* <li>deleteLog(LogName logName)
95+
* <li>deleteLog(String logName)
96+
* </ul>
97+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
98+
* <ul>
99+
* <li>deleteLogCallable()
100+
* </ul>
101+
* </td>
102+
* </tr>
103+
* <tr>
104+
* <td>WriteLogEntries</td>
105+
* <td><p> Writes log entries to Logging. This API method is the only way to send log entries to Logging. This method is used, directly or indirectly, by the Logging agent (fluentd) and all logging libraries configured to use Logging. A single request may contain log entries for a maximum of 1000 different resources (projects, organizations, billing accounts or folders)</td>
106+
* <td>
107+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
108+
* <ul>
109+
* <li>writeLogEntries(WriteLogEntriesRequest request)
110+
* </ul>
111+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
112+
* <ul>
113+
* <li>writeLogEntries(LogName logName, MonitoredResource resource, Map<String, String> labels, List<LogEntry> entries)
114+
* <li>writeLogEntries(String logName, MonitoredResource resource, Map<String, String> labels, List<LogEntry> entries)
115+
* </ul>
116+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
117+
* <ul>
118+
* <li>writeLogEntriesCallable()
119+
* </ul>
120+
* </td>
121+
* </tr>
122+
* <tr>
123+
* <td>ListLogEntries</td>
124+
* <td><p> Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see [Exporting Logs](https://cloud.google.com/logging/docs/export).</td>
125+
* <td>
126+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
127+
* <ul>
128+
* <li>listLogEntries(ListLogEntriesRequest request)
129+
* </ul>
130+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
131+
* <ul>
132+
* <li>listLogEntries(List<String> resourceNames, String filter, String orderBy)
133+
* </ul>
134+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
135+
* <ul>
136+
* <li>listLogEntriesPagedCallable()
137+
* <li>listLogEntriesCallable()
138+
* </ul>
139+
* </td>
140+
* </tr>
141+
* <tr>
142+
* <td>ListMonitoredResourceDescriptors</td>
143+
* <td><p> Lists the descriptors for monitored resource types used by Logging.</td>
144+
* <td>
145+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
146+
* <ul>
147+
* <li>listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request)
148+
* </ul>
149+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
150+
* <ul>
151+
* <li>listMonitoredResourceDescriptorsPagedCallable()
152+
* <li>listMonitoredResourceDescriptorsCallable()
153+
* </ul>
154+
* </td>
155+
* </tr>
156+
* <tr>
157+
* <td>ListLogs</td>
158+
* <td><p> Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.</td>
159+
* <td>
160+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
161+
* <ul>
162+
* <li>listLogs(ListLogsRequest request)
163+
* </ul>
164+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
165+
* <ul>
166+
* <li>listLogs(BillingAccountName parent)
167+
* <li>listLogs(FolderName parent)
168+
* <li>listLogs(OrganizationName parent)
169+
* <li>listLogs(ProjectName parent)
170+
* <li>listLogs(String parent)
171+
* </ul>
172+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
173+
* <ul>
174+
* <li>listLogsPagedCallable()
175+
* <li>listLogsCallable()
176+
* </ul>
177+
* </td>
178+
* </tr>
179+
* <tr>
180+
* <td>TailLogEntries</td>
181+
* <td><p> Streaming read of log entries as they are ingested. Until the stream is terminated, it will continue reading logs.</td>
182+
* <td>
183+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
184+
* <ul>
185+
* <li>tailLogEntriesCallable()
186+
* </ul>
187+
* </td>
188+
* </tr>
189+
* </tr>
190+
* </table>
92191
*
93192
* <p>See the individual methods for example code.
94193
*

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

Lines changed: 103 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -64,19 +64,109 @@
6464
* <p>Note: close() needs to be called on the MetricsClient object to clean up resources such as
6565
* threads. In the example above, try-with-resources is used, which automatically calls close().
6666
*
67-
* <p>The surface of this class includes several types of Java methods for each of the API's
68-
* methods:
69-
*
70-
* <ol>
71-
* <li>A "flattened" method. With this type of method, the fields of the request type have been
72-
* converted into function parameters. It may be the case that not all fields are available as
73-
* parameters, and not every API method will have a flattened method entry point.
74-
* <li>A "request object" method. This type of method only takes one parameter, a request object,
75-
* which must be constructed before the call. Not every API method will have a request object
76-
* method.
77-
* <li>A "callable" method. This type of method takes no parameters and returns an immutable API
78-
* callable object, which can be used to initiate calls to the service.
79-
* </ol>
67+
* <table>
68+
* <tr>
69+
* <th>Method</th>
70+
* <th>Description</th>
71+
* <th>Method Variants</th>
72+
* <tr>
73+
* <td>ListLogMetrics</td>
74+
* <td><p> Lists logs-based metrics.</td>
75+
* <td>
76+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
77+
* <ul>
78+
* <li>listLogMetrics(ListLogMetricsRequest request)
79+
* </ul>
80+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
81+
* <ul>
82+
* <li>listLogMetrics(ProjectName parent)
83+
* <li>listLogMetrics(String parent)
84+
* </ul>
85+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
86+
* <ul>
87+
* <li>listLogMetricsPagedCallable()
88+
* <li>listLogMetricsCallable()
89+
* </ul>
90+
* </td>
91+
* </tr>
92+
* <tr>
93+
* <td>GetLogMetric</td>
94+
* <td><p> Gets a logs-based metric.</td>
95+
* <td>
96+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
97+
* <ul>
98+
* <li>getLogMetric(GetLogMetricRequest request)
99+
* </ul>
100+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
101+
* <ul>
102+
* <li>getLogMetric(LogMetricName metricName)
103+
* <li>getLogMetric(String metricName)
104+
* </ul>
105+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
106+
* <ul>
107+
* <li>getLogMetricCallable()
108+
* </ul>
109+
* </td>
110+
* </tr>
111+
* <tr>
112+
* <td>CreateLogMetric</td>
113+
* <td><p> Creates a logs-based metric.</td>
114+
* <td>
115+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
116+
* <ul>
117+
* <li>createLogMetric(CreateLogMetricRequest request)
118+
* </ul>
119+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
120+
* <ul>
121+
* <li>createLogMetric(ProjectName parent, LogMetric metric)
122+
* <li>createLogMetric(String parent, LogMetric metric)
123+
* </ul>
124+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
125+
* <ul>
126+
* <li>createLogMetricCallable()
127+
* </ul>
128+
* </td>
129+
* </tr>
130+
* <tr>
131+
* <td>UpdateLogMetric</td>
132+
* <td><p> Creates or updates a logs-based metric.</td>
133+
* <td>
134+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
135+
* <ul>
136+
* <li>updateLogMetric(UpdateLogMetricRequest request)
137+
* </ul>
138+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
139+
* <ul>
140+
* <li>updateLogMetric(LogMetricName metricName, LogMetric metric)
141+
* <li>updateLogMetric(String metricName, LogMetric metric)
142+
* </ul>
143+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
144+
* <ul>
145+
* <li>updateLogMetricCallable()
146+
* </ul>
147+
* </td>
148+
* </tr>
149+
* <tr>
150+
* <td>DeleteLogMetric</td>
151+
* <td><p> Deletes a logs-based metric.</td>
152+
* <td>
153+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
154+
* <ul>
155+
* <li>deleteLogMetric(DeleteLogMetricRequest request)
156+
* </ul>
157+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
158+
* <ul>
159+
* <li>deleteLogMetric(LogMetricName metricName)
160+
* <li>deleteLogMetric(String metricName)
161+
* </ul>
162+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
163+
* <ul>
164+
* <li>deleteLogMetricCallable()
165+
* </ul>
166+
* </td>
167+
* </tr>
168+
* </tr>
169+
* </table>
80170
*
81171
* <p>See the individual methods for example code.
82172
*

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -679,6 +679,12 @@ public ConfigServiceV2Stub createStub() throws IOException {
679679
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
680680
}
681681

682+
/** Returns the default service name. */
683+
@Override
684+
public String getServiceName() {
685+
return "logging";
686+
}
687+
682688
/** Returns a builder for the default ExecutorProvider for this service. */
683689
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
684690
return InstantiatingExecutorProvider.newBuilder();

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -438,6 +438,12 @@ public LoggingServiceV2Stub createStub() throws IOException {
438438
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
439439
}
440440

441+
/** Returns the default service name. */
442+
@Override
443+
public String getServiceName() {
444+
return "logging";
445+
}
446+
441447
/** Returns a builder for the default ExecutorProvider for this service. */
442448
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
443449
return InstantiatingExecutorProvider.newBuilder();

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,12 @@ public MetricsServiceV2Stub createStub() throws IOException {
206206
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
207207
}
208208

209+
/** Returns the default service name. */
210+
@Override
211+
public String getServiceName() {
212+
return "logging";
213+
}
214+
209215
/** Returns a builder for the default ExecutorProvider for this service. */
210216
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
211217
return InstantiatingExecutorProvider.newBuilder();

0 commit comments

Comments
 (0)