feat: Log Analytics features of the Cloud Logging API (#1335)

* feat: Log Analytics features of the Cloud Logging API feat: Add ConfigServiceV2.CreateBucketAsync method for creating Log Buckets asynchronously feat: Add ConfigServiceV2.UpdateBucketAsync method for creating Log Buckets asynchronously feat: Add ConfigServiceV2.CreateLink method for creating linked datasets for Log Analytics Buckets feat: Add ConfigServiceV2.DeleteLink method for deleting linked datasets feat: Add ConfigServiceV2.ListLinks method for listing linked datasets feat: Add ConfigServiceV2.GetLink methods for describing linked datasets feat: Add LogBucket.analytics_enabled field that specifies whether Log Bucket's Analytics features are enabled feat: Add LogBucket.index_configs field that contains a list of Log Bucket's indexed fields and related configuration data docs: Documentation for the Log Analytics features of the Cloud Logging API PiperOrigin-RevId: 529851525 Source-Link: googleapis/googleapis@1c7ee99 Source-Link: googleapis/googleapis-gen@4a2a3a0 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGEyYTNhMDViOTE4MDQzMzNhMWIzOWI2MzVkOGZlMjI0M2Q0YjRmZCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * chore: Ignore clirr errors for 7012 Ignore clirr difference '7012: Method Added to Interface' for methods createBucketAsync, updateBucketAsync, createLink, deleteLink, getLink and listLinks added to com.google.logging.v2.ConfigServiceV2Grpc$AsyncService interface. --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: minherz <[email protected]>
googleapis · May 6, 2023 · 7d43b80 · 7d43b80
1 parent f6accf8
commit 7d43b80
Show file tree

Hide file tree

Showing 89 changed files with 22,227 additions and 2,718 deletions.
diff --git a/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigClient.java b/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigClient.java
diff --git a/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigSettings.java b/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigSettings.java
@@ -18,6 18,7 @@
 
 import static com.google.cloud.logging.v2.ConfigClient.ListBucketsPagedResponse;
 import static com.google.cloud.logging.v2.ConfigClient.ListExclusionsPagedResponse;
 import static com.google.cloud.logging.v2.ConfigClient.ListLinksPagedResponse;
 import static com.google.cloud.logging.v2.ConfigClient.ListSinksPagedResponse;
 import static com.google.cloud.logging.v2.ConfigClient.ListViewsPagedResponse;
 
@@ -34,28 35,36 @@
 import com.google.api.gax.rpc.TransportChannelProvider;
 import com.google.api.gax.rpc.UnaryCallSettings;
 import com.google.cloud.logging.v2.stub.ConfigServiceV2StubSettings;
 import com.google.logging.v2.BucketMetadata;
 import com.google.logging.v2.CmekSettings;
 import com.google.logging.v2.CopyLogEntriesMetadata;
 import com.google.logging.v2.CopyLogEntriesRequest;
 import com.google.logging.v2.CopyLogEntriesResponse;
 import com.google.logging.v2.CreateBucketRequest;
 import com.google.logging.v2.CreateExclusionRequest;
 import com.google.logging.v2.CreateLinkRequest;
 import com.google.logging.v2.CreateSinkRequest;
 import com.google.logging.v2.CreateViewRequest;
 import com.google.logging.v2.DeleteBucketRequest;
 import com.google.logging.v2.DeleteExclusionRequest;
 import com.google.logging.v2.DeleteLinkRequest;
 import com.google.logging.v2.DeleteSinkRequest;
 import com.google.logging.v2.DeleteViewRequest;
 import com.google.logging.v2.GetBucketRequest;
 import com.google.logging.v2.GetCmekSettingsRequest;
 import com.google.logging.v2.GetExclusionRequest;
 import com.google.logging.v2.GetLinkRequest;
 import com.google.logging.v2.GetSettingsRequest;
 import com.google.logging.v2.GetSinkRequest;
 import com.google.logging.v2.GetViewRequest;
 import com.google.logging.v2.Link;
 import com.google.logging.v2.LinkMetadata;
 import com.google.logging.v2.ListBucketsRequest;
 import com.google.logging.v2.ListBucketsResponse;
 import com.google.logging.v2.ListExclusionsRequest;
 import com.google.logging.v2.ListExclusionsResponse;
 import com.google.logging.v2.ListLinksRequest;
 import com.google.logging.v2.ListLinksResponse;
 import com.google.logging.v2.ListSinksRequest;
 import com.google.logging.v2.ListSinksResponse;
 import com.google.logging.v2.ListViewsRequest;
@@ -128,6 137,28 @@ public UnaryCallSettings<GetBucketRequest, LogBucket> getBucketSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).getBucketSettings();
  }
 
  /** Returns the object with the settings used for calls to createBucketAsync. */
  public UnaryCallSettings<CreateBucketRequest, Operation> createBucketAsyncSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).createBucketAsyncSettings();
  }
 
  /** Returns the object with the settings used for calls to createBucketAsync. */
  public OperationCallSettings<CreateBucketRequest, LogBucket, BucketMetadata>
  createBucketAsyncOperationSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).createBucketAsyncOperationSettings();
  }
 
  /** Returns the object with the settings used for calls to updateBucketAsync. */
  public UnaryCallSettings<UpdateBucketRequest, Operation> updateBucketAsyncSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).updateBucketAsyncSettings();
  }
 
  /** Returns the object with the settings used for calls to updateBucketAsync. */
  public OperationCallSettings<UpdateBucketRequest, LogBucket, BucketMetadata>
  updateBucketAsyncOperationSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).updateBucketAsyncOperationSettings();
  }
 
  /** Returns the object with the settings used for calls to createBucket. */
  public UnaryCallSettings<CreateBucketRequest, LogBucket> createBucketSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).createBucketSettings();
@@ -200,6 231,39 @@ public UnaryCallSettings<DeleteSinkRequest, Empty> deleteSinkSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).deleteSinkSettings();
  }
 
  /** Returns the object with the settings used for calls to createLink. */
  public UnaryCallSettings<CreateLinkRequest, Operation> createLinkSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).createLinkSettings();
  }
 
  /** Returns the object with the settings used for calls to createLink. */
  public OperationCallSettings<CreateLinkRequest, Link, LinkMetadata>
  createLinkOperationSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).createLinkOperationSettings();
  }
 
  /** Returns the object with the settings used for calls to deleteLink. */
  public UnaryCallSettings<DeleteLinkRequest, Operation> deleteLinkSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).deleteLinkSettings();
  }
 
  /** Returns the object with the settings used for calls to deleteLink. */
  public OperationCallSettings<DeleteLinkRequest, Empty, LinkMetadata>
  deleteLinkOperationSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).deleteLinkOperationSettings();
  }
 
  /** Returns the object with the settings used for calls to listLinks. */
  public PagedCallSettings<ListLinksRequest, ListLinksResponse, ListLinksPagedResponse>
  listLinksSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).listLinksSettings();
  }
 
  /** Returns the object with the settings used for calls to getLink. */
  public UnaryCallSettings<GetLinkRequest, Link> getLinkSettings() {
  return ((ConfigServiceV2StubSettings) getStubSettings()).getLinkSettings();
  }
 
  /** Returns the object with the settings used for calls to listExclusions. */
  public PagedCallSettings<
  ListExclusionsRequest, ListExclusionsResponse, ListExclusionsPagedResponse>
@@ -367,6 431,28 @@ public UnaryCallSettings.Builder<GetBucketRequest, LogBucket> getBucketSettings(
  return getStubSettingsBuilder().getBucketSettings();
  }
 
  /** Returns the builder for the settings used for calls to createBucketAsync. */
  public UnaryCallSettings.Builder<CreateBucketRequest, Operation> createBucketAsyncSettings() {
  return getStubSettingsBuilder().createBucketAsyncSettings();
  }
 
  /** Returns the builder for the settings used for calls to createBucketAsync. */
  public OperationCallSettings.Builder<CreateBucketRequest, LogBucket, BucketMetadata>
  createBucketAsyncOperationSettings() {
  return getStubSettingsBuilder().createBucketAsyncOperationSettings();
  }
 
  /** Returns the builder for the settings used for calls to updateBucketAsync. */
  public UnaryCallSettings.Builder<UpdateBucketRequest, Operation> updateBucketAsyncSettings() {
  return getStubSettingsBuilder().updateBucketAsyncSettings();
  }
 
  /** Returns the builder for the settings used for calls to updateBucketAsync. */
  public OperationCallSettings.Builder<UpdateBucketRequest, LogBucket, BucketMetadata>
  updateBucketAsyncOperationSettings() {
  return getStubSettingsBuilder().updateBucketAsyncOperationSettings();
  }
 
  /** Returns the builder for the settings used for calls to createBucket. */
  public UnaryCallSettings.Builder<CreateBucketRequest, LogBucket> createBucketSettings() {
  return getStubSettingsBuilder().createBucketSettings();
@@ -439,6 525,39 @@ public UnaryCallSettings.Builder<DeleteSinkRequest, Empty> deleteSinkSettings()
  return getStubSettingsBuilder().deleteSinkSettings();
  }
 
  /** Returns the builder for the settings used for calls to createLink. */
  public UnaryCallSettings.Builder<CreateLinkRequest, Operation> createLinkSettings() {
  return getStubSettingsBuilder().createLinkSettings();
  }
 
  /** Returns the builder for the settings used for calls to createLink. */
  public OperationCallSettings.Builder<CreateLinkRequest, Link, LinkMetadata>
  createLinkOperationSettings() {
  return getStubSettingsBuilder().createLinkOperationSettings();
  }
 
  /** Returns the builder for the settings used for calls to deleteLink. */
  public UnaryCallSettings.Builder<DeleteLinkRequest, Operation> deleteLinkSettings() {
  return getStubSettingsBuilder().deleteLinkSettings();
  }
 
  /** Returns the builder for the settings used for calls to deleteLink. */
  public OperationCallSettings.Builder<DeleteLinkRequest, Empty, LinkMetadata>
  deleteLinkOperationSettings() {
  return getStubSettingsBuilder().deleteLinkOperationSettings();
  }
 
  /** Returns the builder for the settings used for calls to listLinks. */
  public PagedCallSettings.Builder<ListLinksRequest, ListLinksResponse, ListLinksPagedResponse>
  listLinksSettings() {
  return getStubSettingsBuilder().listLinksSettings();
  }
 
  /** Returns the builder for the settings used for calls to getLink. */
  public UnaryCallSettings.Builder<GetLinkRequest, Link> getLinkSettings() {
  return getStubSettingsBuilder().getLinkSettings();
  }
 
  /** Returns the builder for the settings used for calls to listExclusions. */
  public PagedCallSettings.Builder<
  ListExclusionsRequest, ListExclusionsResponse, ListExclusionsPagedResponse>

diff --git a/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/LoggingClient.java b/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/LoggingClient.java
@@ -597,13 597,12 @@ public final WriteLogEntriesResponse writeLogEntries(WriteLogEntriesRequest requ
  * &#42;
  * `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
  * &#42; `folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
- * <p>Projects listed in the `project_ids` field are added to this list.
- * @param filter Optional. A filter that chooses which log entries to return. See [Advanced Logs
- * Queries](https://cloud.google.com/logging/docs/view/advanced-queries). Only log entries
- * that match the filter are returned. An empty filter matches all log entries in the
- * resources listed in `resource_names`. Referencing a parent resource that is not listed in
- * `resource_names` will cause the filter to return no results. The maximum length of the
- * filter is 20000 characters.
  * <p>Projects listed in the `project_ids` field are added to this list. A maximum of 100
  * resources may be specified in a single request.
  * @param filter Optional. Only log entries that match the filter are returned. An empty filter
  * matches all log entries in the resources listed in `resource_names`. Referencing a parent
  * resource that is not listed in `resource_names` will cause the filter to return no results.
  * The maximum length of a filter is 20,000 characters.
  * @param orderBy Optional. How the results should be sorted. Presently, the only permitted values
  * are `"timestamp asc"` (default) and `"timestamp desc"`. The first option returns entries in
  * order of increasing values of `LogEntry.timestamp` (oldest first), and the second option
@@ -864,7 863,7 @@ public final ListMonitoredResourceDescriptorsPagedResponse listMonitoredResource
  * }
  * }</pre>
  *
- * @param parent Required. The resource name that owns the logs:
  * @param parent Required. The resource name to list logs for:
  * <ul>
  * <li>`projects/[PROJECT_ID]`
  * <li>`organizations/[ORGANIZATION_ID]`
@@ -901,7 900,7 @@ public final ListLogsPagedResponse listLogs(BillingAccountName parent) {
  * }
  * }</pre>
  *
- * @param parent Required. The resource name that owns the logs:
  * @param parent Required. The resource name to list logs for:
  * <ul>
  * <li>`projects/[PROJECT_ID]`
  * <li>`organizations/[ORGANIZATION_ID]`
@@ -938,7 937,7 @@ public final ListLogsPagedResponse listLogs(FolderName parent) {
  * }
  * }</pre>
  *
- * @param parent Required. The resource name that owns the logs:
  * @param parent Required. The resource name to list logs for:
  * <ul>
  * <li>`projects/[PROJECT_ID]`
  * <li>`organizations/[ORGANIZATION_ID]`
@@ -975,7 974,7 @@ public final ListLogsPagedResponse listLogs(OrganizationName parent) {
  * }
  * }</pre>
  *
- * @param parent Required. The resource name that owns the logs:
  * @param parent Required. The resource name to list logs for:
  * <ul>
  * <li>`projects/[PROJECT_ID]`
  * <li>`organizations/[ORGANIZATION_ID]`
@@ -1012,7 1011,7 @@ public final ListLogsPagedResponse listLogs(ProjectName parent) {
  * }
  * }</pre>
  *
- * @param parent Required. The resource name that owns the logs:
  * @param parent Required. The resource name to list logs for:
  * <ul>
  * <li>`projects/[PROJECT_ID]`
  * <li>`organizations/[ORGANIZATION_ID]`
@@ -1044,9 1043,9 @@ public final ListLogsPagedResponse listLogs(String parent) {
  * ListLogsRequest request =
  * ListLogsRequest.newBuilder()
  * .setParent(ProjectName.of("[PROJECT]").toString())
  * .addAllResourceNames(new ArrayList<String>())
  * .setPageSize(883849137)
  * .setPageToken("pageToken873572522")
- * .addAllResourceNames(new ArrayList<String>())
  * .build();
  * for (String element : loggingClient.listLogs(request).iterateAll()) {
  * // doThingsWith(element);
@@ -1078,9 1077,9 @@ public final ListLogsPagedResponse listLogs(ListLogsRequest request) {
  * ListLogsRequest request =
  * ListLogsRequest.newBuilder()
  * .setParent(ProjectName.of("[PROJECT]").toString())
  * .addAllResourceNames(new ArrayList<String>())
  * .setPageSize(883849137)
  * .setPageToken("pageToken873572522")
- * .addAllResourceNames(new ArrayList<String>())
  * .build();
  * ApiFuture<String> future = loggingClient.listLogsPagedCallable().futureCall(request);
  * // Do something.
@@ -1111,9 1110,9 @@ public final UnaryCallable<ListLogsRequest, ListLogsPagedResponse> listLogsPaged
  * ListLogsRequest request =
  * ListLogsRequest.newBuilder()
  * .setParent(ProjectName.of("[PROJECT]").toString())
  * .addAllResourceNames(new ArrayList<String>())
  * .setPageSize(883849137)
  * .setPageToken("pageToken873572522")
- * .addAllResourceNames(new ArrayList<String>())
  * .build();
  * while (true) {
  * ListLogsResponse response = loggingClient.listLogsCallable().call(request);

diff --git a/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/gapic_metadata.json b/google-cloud-logging/src/main/java/com/google/cloud/logging/v2/gapic_metadata.json
@@ -43,9 43,15 @@
  "CreateBucket": {
  "methods": ["createBucket", "createBucketCallable"]
  },
  "CreateBucketAsync": {
  "methods": ["createBucketAsyncAsync", "createBucketAsyncOperationCallable", "createBucketAsyncCallable"]
  },
  "CreateExclusion": {
  "methods": ["createExclusion", "createExclusion", "createExclusion", "createExclusion", "createExclusion", "createExclusion", "createExclusionCallable"]
  },
  "CreateLink": {
  "methods": ["createLinkAsync", "createLinkAsync", "createLinkAsync", "createLinkOperationCallable", "createLinkCallable"]
  },
  "CreateSink": {
  "methods": ["createSink", "createSink", "createSink", "createSink", "createSink", "createSink", "createSinkCallable"]
  },
@@ -58,6 64,9 @@
  "DeleteExclusion": {
  "methods": ["deleteExclusion", "deleteExclusion", "deleteExclusion", "deleteExclusionCallable"]
  },
  "DeleteLink": {
  "methods": ["deleteLinkAsync", "deleteLinkAsync", "deleteLinkAsync", "deleteLinkOperationCallable", "deleteLinkCallable"]
  },
  "DeleteSink": {
  "methods": ["deleteSink", "deleteSink", "deleteSink", "deleteSinkCallable"]
  },
@@ -73,6 82,9 @@
  "GetExclusion": {
  "methods": ["getExclusion", "getExclusion", "getExclusion", "getExclusionCallable"]
  },
  "GetLink": {
  "methods": ["getLink", "getLink", "getLink", "getLinkCallable"]
  },
  "GetSettings": {
  "methods": ["getSettings", "getSettings", "getSettings", "getSettingsCallable"]
  },
@@ -88,6 100,9 @@
  "ListExclusions": {
  "methods": ["listExclusions", "listExclusions", "listExclusions", "listExclusions", "listExclusions", "listExclusions", "listExclusionsPagedCallable", "listExclusionsCallable"]
  },
  "ListLinks": {
  "methods": ["listLinks", "listLinks", "listLinks", "listLinksPagedCallable", "listLinksCallable"]
  },
  "ListSinks": {
  "methods": ["listSinks", "listSinks", "listSinks", "listSinks", "listSinks", "listSinks", "listSinksPagedCallable", "listSinksCallable"]
  },
@@ -100,6 115,9 @@
  "UpdateBucket": {
  "methods": ["updateBucket", "updateBucketCallable"]
  },
  "UpdateBucketAsync": {
  "methods": ["updateBucketAsyncAsync", "updateBucketAsyncOperationCallable", "updateBucketAsyncCallable"]
  },
  "UpdateCmekSettings": {
  "methods": ["updateCmekSettings", "updateCmekSettingsCallable"]
  },