docs: [artifactregistry] use code font for resource name references (#…

…9997)

* docs: use code font for resource name references
docs: mark the create_time and update_time in the Repository resource as output only fields
docs: mark the repository_id and repository fields in the CreateRepository request as required fields
feat: add support for virtual and remote repositories
feat: add support for cleanup policies
feat: add support for Docker immutable tags
feat: add support for Go and KFP repositories
feat: add support for Physical Zone Separation
feat: expose the size of the Repository resource

PiperOrigin-RevId: 576602679

Source-Link: googleapis/googleapis@8755f15

Source-Link: googleapis/googleapis-gen@3ee7f5e
Copy-Tag: eyJwIjoiamF2YS1hcnRpZmFjdC1yZWdpc3RyeS8uT3dsQm90LnlhbWwiLCJoIjoiM2VlN2Y1ZTFiYjlmMjNmMjcyODc2NzgwNmVhNTk1ODIwNjc4NjQ4MCJ9

* 🦉 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>

java-artifact-registry/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.23.0</version>
+      <version>26.25.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-artifact-registry.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-artifact-registry/1.23.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-artifact-registry/1.28.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-artifact-registry/google-cloud-artifact-registry/src/main/java/com/google/devtools/artifactregistry/v1/ArtifactRegistryClient.java

@@ -1805,8 +1805,8 @@ public final UnaryCallable<GetRepositoryRequest, Repository> getRepositoryCallab
    * }</pre>
    *
    * @param parent Required. The name of the parent resource where the repository will be created.
-   * @param repository The repository to be created.
-   * @param repositoryId The repository id to use for this repository.
+   * @param repository Required. The repository to be created.
+   * @param repositoryId Required. The repository id to use for this repository.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Repository, OperationMetadata> createRepositoryAsync(
@@ -1843,8 +1843,8 @@ public final OperationFuture<Repository, OperationMetadata> createRepositoryAsyn
    * }</pre>
    *
    * @param parent Required. The name of the parent resource where the repository will be created.
-   * @param repository The repository to be created.
-   * @param repositoryId The repository id to use for this repository.
+   * @param repository Required. The repository to be created.
+   * @param repositoryId Required. The repository id to use for this repository.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Repository, OperationMetadata> createRepositoryAsync(
@@ -2945,6 +2945,172 @@ public final UnaryCallable<DeleteVersionRequest, Operation> deleteVersionCallabl
     return stub.deleteVersionCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Deletes multiple versions across a repository. The returned operation will complete once the
+   * versions have been deleted.
+   *
+   * <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 (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
+   *   PackageName parent = PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]");
+   *   List<String> names = new ArrayList<>();
+   *   artifactRegistryClient.batchDeleteVersionsAsync(parent, names).get();
+   * }
+   * }</pre>
+   *
+   * @param parent The name of the repository holding all requested versions.
+   * @param names Required. The names of the versions to delete. A maximum of 10000 versions can be
+   *     deleted in a batch.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final OperationFuture<Empty, BatchDeleteVersionsMetadata> batchDeleteVersionsAsync(
+      PackageName parent, List<String> names) {
+    BatchDeleteVersionsRequest request =
+        BatchDeleteVersionsRequest.newBuilder()
+            .setParent(parent == null ? null : parent.toString())
+            .addAllNames(names)
+            .build();
+    return batchDeleteVersionsAsync(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Deletes multiple versions across a repository. The returned operation will complete once the
+   * versions have been deleted.
+   *
+   * <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 (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
+   *   String parent =
+   *       PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString();
+   *   List<String> names = new ArrayList<>();
+   *   artifactRegistryClient.batchDeleteVersionsAsync(parent, names).get();
+   * }
+   * }</pre>
+   *
+   * @param parent The name of the repository holding all requested versions.
+   * @param names Required. The names of the versions to delete. A maximum of 10000 versions can be
+   *     deleted in a batch.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final OperationFuture<Empty, BatchDeleteVersionsMetadata> batchDeleteVersionsAsync(
+      String parent, List<String> names) {
+    BatchDeleteVersionsRequest request =
+        BatchDeleteVersionsRequest.newBuilder().setParent(parent).addAllNames(names).build();
+    return batchDeleteVersionsAsync(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Deletes multiple versions across a repository. The returned operation will complete once the
+   * versions have been deleted.
+   *
+   * <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 (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
+   *   BatchDeleteVersionsRequest request =
+   *       BatchDeleteVersionsRequest.newBuilder()
+   *           .setParent(
+   *               PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString())
+   *           .addAllNames(new ArrayList<String>())
+   *           .setValidateOnly(true)
+   *           .build();
+   *   artifactRegistryClient.batchDeleteVersionsAsync(request).get();
+   * }
+   * }</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 OperationFuture<Empty, BatchDeleteVersionsMetadata> batchDeleteVersionsAsync(
+      BatchDeleteVersionsRequest request) {
+    return batchDeleteVersionsOperationCallable().futureCall(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Deletes multiple versions across a repository. The returned operation will complete once the
+   * versions have been deleted.
+   *
+   * <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 (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
+   *   BatchDeleteVersionsRequest request =
+   *       BatchDeleteVersionsRequest.newBuilder()
+   *           .setParent(
+   *               PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString())
+   *           .addAllNames(new ArrayList<String>())
+   *           .setValidateOnly(true)
+   *           .build();
+   *   OperationFuture<Empty, BatchDeleteVersionsMetadata> future =
+   *       artifactRegistryClient.batchDeleteVersionsOperationCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }</pre>
+   */
+  public final OperationCallable<BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
+      batchDeleteVersionsOperationCallable() {
+    return stub.batchDeleteVersionsOperationCallable();
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Deletes multiple versions across a repository. The returned operation will complete once the
+   * versions have been deleted.
+   *
+   * <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 (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
+   *   BatchDeleteVersionsRequest request =
+   *       BatchDeleteVersionsRequest.newBuilder()
+   *           .setParent(
+   *               PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString())
+   *           .addAllNames(new ArrayList<String>())
+   *           .setValidateOnly(true)
+   *           .build();
+   *   ApiFuture<Operation> future =
+   *       artifactRegistryClient.batchDeleteVersionsCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<BatchDeleteVersionsRequest, Operation> batchDeleteVersionsCallable() {
+    return stub.batchDeleteVersionsCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Lists files.
@@ -3239,7 +3405,8 @@ public final UnaryCallable<GetFileRequest, File> getFileCallable() {
    * }
    * }</pre>
    *
-   * @param parent The name of the parent resource whose tags will be listed.
+   * @param parent The name of the parent package whose tags will be listed. For example:
+   *     `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListTagsPagedResponse listTags(String parent) {

java-artifact-registry/google-cloud-artifact-registry/src/main/java/com/google/devtools/artifactregistry/v1/ArtifactRegistrySettings.java

@@ -252,6 +252,18 @@ public UnaryCallSettings<DeleteVersionRequest, Operation> deleteVersionSettings(
     return ((ArtifactRegistryStubSettings) getStubSettings()).deleteVersionOperationSettings();
   }
 
+  /** Returns the object with the settings used for calls to batchDeleteVersions. */
+  public UnaryCallSettings<BatchDeleteVersionsRequest, Operation> batchDeleteVersionsSettings() {
+    return ((ArtifactRegistryStubSettings) getStubSettings()).batchDeleteVersionsSettings();
+  }
+
+  /** Returns the object with the settings used for calls to batchDeleteVersions. */
+  public OperationCallSettings<BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
+      batchDeleteVersionsOperationSettings() {
+    return ((ArtifactRegistryStubSettings) getStubSettings())
+        .batchDeleteVersionsOperationSettings();
+  }
+
   /** Returns the object with the settings used for calls to listFiles. */
   public PagedCallSettings<ListFilesRequest, ListFilesResponse, ListFilesPagedResponse>
       listFilesSettings() {
@@ -617,6 +629,19 @@ public UnaryCallSettings.Builder<DeleteVersionRequest, Operation> deleteVersionS
       return getStubSettingsBuilder().deleteVersionOperationSettings();
     }
 
+    /** Returns the builder for the settings used for calls to batchDeleteVersions. */
+    public UnaryCallSettings.Builder<BatchDeleteVersionsRequest, Operation>
+        batchDeleteVersionsSettings() {
+      return getStubSettingsBuilder().batchDeleteVersionsSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to batchDeleteVersions. */
+    public OperationCallSettings.Builder<
+            BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
+        batchDeleteVersionsOperationSettings() {
+      return getStubSettingsBuilder().batchDeleteVersionsOperationSettings();
+    }
+
     /** Returns the builder for the settings used for calls to listFiles. */
     public PagedCallSettings.Builder<ListFilesRequest, ListFilesResponse, ListFilesPagedResponse>
         listFilesSettings() {

java-artifact-registry/google-cloud-artifact-registry/src/main/java/com/google/devtools/artifactregistry/v1/gapic_metadata.json

@@ -10,6 +10,9 @@
         "grpc": {
           "libraryClient": "ArtifactRegistryClient",
           "rpcs": {
+            "BatchDeleteVersions": {
+              "methods": ["batchDeleteVersionsAsync", "batchDeleteVersionsAsync", "batchDeleteVersionsAsync", "batchDeleteVersionsOperationCallable", "batchDeleteVersionsCallable"]
+            },
             "CreateRepository": {
               "methods": ["createRepositoryAsync", "createRepositoryAsync", "createRepositoryAsync", "createRepositoryOperationCallable", "createRepositoryCallable"]
             },

java-artifact-registry/google-cloud-artifact-registry/src/main/java/com/google/devtools/artifactregistry/v1/stub/ArtifactRegistryStub.java

@@ -34,6 +34,8 @@
 import com.google.cloud.location.ListLocationsRequest;
 import com.google.cloud.location.ListLocationsResponse;
 import com.google.cloud.location.Location;
+import com.google.devtools.artifactregistry.v1.BatchDeleteVersionsMetadata;
+import com.google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest;
 import com.google.devtools.artifactregistry.v1.CreateRepositoryRequest;
 import com.google.devtools.artifactregistry.v1.CreateTagRequest;
 import com.google.devtools.artifactregistry.v1.DeletePackageRequest;
@@ -273,6 +275,16 @@ public UnaryCallable<DeleteVersionRequest, Operation> deleteVersionCallable() {
     throw new UnsupportedOperationException("Not implemented: deleteVersionCallable()");
   }
 
+  public OperationCallable<BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
+      batchDeleteVersionsOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: batchDeleteVersionsOperationCallable()");
+  }
+
+  public UnaryCallable<BatchDeleteVersionsRequest, Operation> batchDeleteVersionsCallable() {
+    throw new UnsupportedOperationException("Not implemented: batchDeleteVersionsCallable()");
+  }
+
   public UnaryCallable<ListFilesRequest, ListFilesPagedResponse> listFilesPagedCallable() {
     throw new UnsupportedOperationException("Not implemented: listFilesPagedCallable()");
   }