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: https://github.com/googleapis/googleapis-gen/commit/3ee7f5e1bb9f23f2728767806ea5958206786480 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>

Author: gcf-owl-bot[bot]

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()");
  }