fix(deps): Update the Java code generator (gapic-generator-java) to 2…

….39.0 (#2501) * docs: update storage control documentation and add PHP for publishing PiperOrigin-RevId: 626165497 Source-Link: googleapis/googleapis@1125069 Source-Link: googleapis/googleapis-gen@a09be5f Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYTA5YmU1Zjc3YjBkOGMyOGRhMjkyMWZjZTcyZjBlMWMwNmU3MjViNCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * fix(deps): Update the Java code generator (gapic-generator-java) to 2.39.0 PiperOrigin-RevId: 626430774 Source-Link: googleapis/googleapis@835b84e Source-Link: googleapis/googleapis-gen@43f369d Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDNmMzY5ZDkwZjE5ZDA5YWMxODcyMDE1MWFiMTA2MDQyYmViODExYiJ9 * 🦉 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>
googleapis · Apr 26, 2024 · 518d4be · 518d4be
1 parent 50ac93b
commit 518d4be
Show file tree

Hide file tree

Showing 15 changed files with 257 additions and 176 deletions.
diff --git a/...google-cloud-storage-v2/src/main/java/com/google/storage/v2/stub/StorageStubSettings.java b/...google-cloud-storage-v2/src/main/java/com/google/storage/v2/stub/StorageStubSettings.java
@@ -625,15 +625,6 @@ public StorageStub createStub() throws IOException {
             "Transport not supported: %s", getTransportChannelProvider().getTransportName()));
   }
 
-  /** Returns the endpoint set by the user or the the service's default endpoint. */
-  @Override
-  public String getEndpoint() {
-    if (super.getEndpoint() != null) {
-      return super.getEndpoint();
-    }
-    return getDefaultEndpoint();
-  }
-
   /** Returns the default service name. */
   @Override
   public String getServiceName() {
@@ -1340,15 +1331,6 @@ public UnaryCallSettings.Builder<GetHmacKeyRequest, HmacKeyMetadata> getHmacKeyS
       return updateHmacKeySettings;
     }
 
-    /** Returns the endpoint set by the user or the the service's default endpoint. */
-    @Override
-    public String getEndpoint() {
-      if (super.getEndpoint() != null) {
-        return super.getEndpoint();
-      }
-      return getDefaultEndpoint();
-    }
-
     @Override
     public StorageStubSettings build() throws IOException {
       return new StorageStubSettings(this);

diff --git a/...oud-storage-control/src/main/java/com/google/storage/control/v2/StorageControlClient.java b/...oud-storage-control/src/main/java/com/google/storage/control/v2/StorageControlClient.java
@@ -70,7 +70,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> CreateFolder</td>
- *      <td><p> Creates a new folder.</td>
+ *      <td><p> Creates a new folder. This operation is only applicable to a hierarchical namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -89,7 +89,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> DeleteFolder</td>
- *      <td><p> Permanently deletes an empty folder.</td>
+ *      <td><p> Permanently deletes an empty folder. This operation is only applicable to a hierarchical namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -108,7 +108,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> GetFolder</td>
- *      <td><p> Returns metadata for the specified folder.</td>
+ *      <td><p> Returns metadata for the specified folder. This operation is only applicable to a hierarchical namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -127,7 +127,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> ListFolders</td>
- *      <td><p> Retrieves a list of folders for a given bucket.</td>
+ *      <td><p> Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -147,7 +147,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> RenameFolder</td>
- *      <td><p> Renames a source folder to a destination folder. During a rename, the source and destination folders are locked until the long running operation completes.</td>
+ *      <td><p> Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes. Hierarchical namespace buckets are in allowlist preview.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -365,7 +365,8 @@ public final OperationsClient getOperationsClient() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Creates a new folder.
+   * Creates a new folder. This operation is only applicable to a hierarchical namespace enabled
+   * bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -383,7 +384,8 @@ public final OperationsClient getOperationsClient() {
    * }
    * }</pre>
    *
-   * @param parent Required. Name of the bucket in which the folder will reside.
+   * @param parent Required. Name of the bucket in which the folder will reside. The bucket must be
+   *     a hierarchical namespace enabled bucket.
    * @param folder Required. Properties of the new folder being created. The bucket and name of the
    *     folder are specified in the parent and folder_id fields, respectively. Populating those
    *     fields in `folder` will result in an error.
@@ -405,7 +407,8 @@ public final Folder createFolder(BucketName parent, Folder folder, String folder
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Creates a new folder.
+   * Creates a new folder. This operation is only applicable to a hierarchical namespace enabled
+   * bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -423,7 +426,8 @@ public final Folder createFolder(BucketName parent, Folder folder, String folder
    * }
    * }</pre>
    *
-   * @param parent Required. Name of the bucket in which the folder will reside.
+   * @param parent Required. Name of the bucket in which the folder will reside. The bucket must be
+   *     a hierarchical namespace enabled bucket.
    * @param folder Required. Properties of the new folder being created. The bucket and name of the
    *     folder are specified in the parent and folder_id fields, respectively. Populating those
    *     fields in `folder` will result in an error.
@@ -445,7 +449,8 @@ public final Folder createFolder(String parent, Folder folder, String folderId)
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Creates a new folder.
+   * Creates a new folder. This operation is only applicable to a hierarchical namespace enabled
+   * bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -477,7 +482,8 @@ public final Folder createFolder(CreateFolderRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Creates a new folder.
+   * Creates a new folder. This operation is only applicable to a hierarchical namespace enabled
+   * bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -508,7 +514,8 @@ public final UnaryCallable<CreateFolderRequest, Folder> createFolderCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Permanently deletes an empty folder.
+   * Permanently deletes an empty folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -536,7 +543,8 @@ public final void deleteFolder(FolderName name) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Permanently deletes an empty folder.
+   * Permanently deletes an empty folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -563,7 +571,8 @@ public final void deleteFolder(String name) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Permanently deletes an empty folder.
+   * Permanently deletes an empty folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -594,7 +603,8 @@ public final void deleteFolder(DeleteFolderRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Permanently deletes an empty folder.
+   * Permanently deletes an empty folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -624,7 +634,8 @@ public final UnaryCallable<DeleteFolderRequest, Empty> deleteFolderCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns metadata for the specified folder.
+   * Returns metadata for the specified folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -652,7 +663,8 @@ public final Folder getFolder(FolderName name) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns metadata for the specified folder.
+   * Returns metadata for the specified folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -679,7 +691,8 @@ public final Folder getFolder(String name) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns metadata for the specified folder.
+   * Returns metadata for the specified folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -710,7 +723,8 @@ public final Folder getFolder(GetFolderRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns metadata for the specified folder.
+   * Returns metadata for the specified folder. This operation is only applicable to a hierarchical
+   * namespace enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -740,7 +754,8 @@ public final UnaryCallable<GetFolderRequest, Folder> getFolderCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of folders for a given bucket.
+   * Retrieves a list of folders. This operation is only applicable to a hierarchical namespace
+   * enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -758,7 +773,8 @@ public final UnaryCallable<GetFolderRequest, Folder> getFolderCallable() {
    * }
    * }</pre>
    *
-   * @param parent Required. Name of the bucket in which to look for folders.
+   * @param parent Required. Name of the bucket in which to look for folders. The bucket must be a
+   *     hierarchical namespace enabled bucket.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListFoldersPagedResponse listFolders(BucketName parent) {
@@ -771,7 +787,8 @@ public final ListFoldersPagedResponse listFolders(BucketName parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of folders for a given bucket.
+   * Retrieves a list of folders. This operation is only applicable to a hierarchical namespace
+   * enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -789,7 +806,8 @@ public final ListFoldersPagedResponse listFolders(BucketName parent) {
    * }
    * }</pre>
    *
-   * @param parent Required. Name of the bucket in which to look for folders.
+   * @param parent Required. Name of the bucket in which to look for folders. The bucket must be a
+   *     hierarchical namespace enabled bucket.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListFoldersPagedResponse listFolders(String parent) {
@@ -799,7 +817,8 @@ public final ListFoldersPagedResponse listFolders(String parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of folders for a given bucket.
+   * Retrieves a list of folders. This operation is only applicable to a hierarchical namespace
+   * enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -836,7 +855,8 @@ public final ListFoldersPagedResponse listFolders(ListFoldersRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of folders for a given bucket.
+   * Retrieves a list of folders. This operation is only applicable to a hierarchical namespace
+   * enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -874,7 +894,8 @@ public final ListFoldersPagedResponse listFolders(ListFoldersRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of folders for a given bucket.
+   * Retrieves a list of folders. This operation is only applicable to a hierarchical namespace
+   * enabled bucket. Hierarchical namespace buckets are in allowlist preview.
    *
    * <p>Sample code:
    *
@@ -917,8 +938,10 @@ public final UnaryCallable<ListFoldersRequest, ListFoldersResponse> listFoldersC
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Renames a source folder to a destination folder. During a rename, the source and destination
-   * folders are locked until the long running operation completes.
+   * Renames a source folder to a destination folder. This operation is only applicable to a
+   * hierarchical namespace enabled bucket. During a rename, the source and destination folders are
+   * locked until the long running operation completes. Hierarchical namespace buckets are in
+   * allowlist preview.
    *
    * <p>Sample code:
    *
@@ -952,8 +975,10 @@ public final OperationFuture<Folder, RenameFolderMetadata> renameFolderAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Renames a source folder to a destination folder. During a rename, the source and destination
-   * folders are locked until the long running operation completes.
+   * Renames a source folder to a destination folder. This operation is only applicable to a
+   * hierarchical namespace enabled bucket. During a rename, the source and destination folders are
+   * locked until the long running operation completes. Hierarchical namespace buckets are in
+   * allowlist preview.
    *
    * <p>Sample code:
    *
@@ -987,8 +1012,10 @@ public final OperationFuture<Folder, RenameFolderMetadata> renameFolderAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Renames a source folder to a destination folder. During a rename, the source and destination
-   * folders are locked until the long running operation completes.
+   * Renames a source folder to a destination folder. This operation is only applicable to a
+   * hierarchical namespace enabled bucket. During a rename, the source and destination folders are
+   * locked until the long running operation completes. Hierarchical namespace buckets are in
+   * allowlist preview.
    *
    * <p>Sample code:
    *
@@ -1021,8 +1048,10 @@ public final OperationFuture<Folder, RenameFolderMetadata> renameFolderAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Renames a source folder to a destination folder. During a rename, the source and destination
-   * folders are locked until the long running operation completes.
+   * Renames a source folder to a destination folder. This operation is only applicable to a
+   * hierarchical namespace enabled bucket. During a rename, the source and destination folders are
+   * locked until the long running operation completes. Hierarchical namespace buckets are in
+   * allowlist preview.
    *
    * <p>Sample code:
    *
@@ -1055,8 +1084,10 @@ public final OperationFuture<Folder, RenameFolderMetadata> renameFolderAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Renames a source folder to a destination folder. During a rename, the source and destination
-   * folders are locked until the long running operation completes.
+   * Renames a source folder to a destination folder. This operation is only applicable to a
+   * hierarchical namespace enabled bucket. During a rename, the source and destination folders are
+   * locked until the long running operation completes. Hierarchical namespace buckets are in
+   * allowlist preview.
    *
    * <p>Sample code:
    *

diff --git a/google-cloud-storage-control/src/main/java/com/google/storage/control/v2/package-info.java b/google-cloud-storage-control/src/main/java/com/google/storage/control/v2/package-info.java
@@ -15,7 +15,7 @@
  */
 
 /**
- * A client to Cloud Storage API
+ * A client to Storage Control API
  *
  * <p>The interfaces provided are listed below, along with usage samples.
  *

diff --git a/...-control/src/main/java/com/google/storage/control/v2/stub/StorageControlStubSettings.java b/...-control/src/main/java/com/google/storage/control/v2/stub/StorageControlStubSettings.java
@@ -322,15 +322,6 @@ public StorageControlStub createStub() throws IOException {
             "Transport not supported: %s", getTransportChannelProvider().getTransportName()));
   }
 
-  /** Returns the endpoint set by the user or the the service's default endpoint. */
-  @Override
-  public String getEndpoint() {
-    if (super.getEndpoint() != null) {
-      return super.getEndpoint();
-    }
-    return getDefaultEndpoint();
-  }
-
   /** Returns the default service name. */
   @Override
   public String getServiceName() {
@@ -715,15 +706,6 @@ public UnaryCallSettings.Builder<RenameFolderRequest, Operation> renameFolderSet
       return listManagedFoldersSettings;
     }
 
-    /** Returns the endpoint set by the user or the the service's default endpoint. */
-    @Override
-    public String getEndpoint() {
-      if (super.getEndpoint() != null) {
-        return super.getEndpoint();
-      }
-      return getDefaultEndpoint();
-    }
-
     @Override
     public StorageControlStubSettings build() throws IOException {
       return new StorageControlStubSettings(this);