Skip to content

Commit baf18bd

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
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>
1 parent 36fd92b commit baf18bd

55 files changed

Lines changed: 29848 additions & 1987 deletions

File tree

Some content is hidden

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

‎java-artifact-registry/README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
2020
<dependency>
2121
<groupId>com.google.cloud</groupId>
2222
<artifactId>libraries-bom</artifactId>
23-
<version>26.23.0</version>
23+
<version>26.25.0</version>
2424
<type>pom</type>
2525
<scope>import</scope>
2626
</dependency>
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
195195
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
196196
[stability-image]: https://img.shields.io/badge/stability-stable-green
197197
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-artifact-registry.svg
198-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-artifact-registry/1.23.0
198+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-artifact-registry/1.28.0
199199
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
200200
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
201201
[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‎

Lines changed: 172 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1805,8 +1805,8 @@ public final UnaryCallable<GetRepositoryRequest, Repository> getRepositoryCallab
18051805
* }</pre>
18061806
*
18071807
* @param parent Required. The name of the parent resource where the repository will be created.
1808-
* @param repository The repository to be created.
1809-
* @param repositoryId The repository id to use for this repository.
1808+
* @param repository Required. The repository to be created.
1809+
* @param repositoryId Required. The repository id to use for this repository.
18101810
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
18111811
*/
18121812
public final OperationFuture<Repository, OperationMetadata> createRepositoryAsync(
@@ -1843,8 +1843,8 @@ public final OperationFuture<Repository, OperationMetadata> createRepositoryAsyn
18431843
* }</pre>
18441844
*
18451845
* @param parent Required. The name of the parent resource where the repository will be created.
1846-
* @param repository The repository to be created.
1847-
* @param repositoryId The repository id to use for this repository.
1846+
* @param repository Required. The repository to be created.
1847+
* @param repositoryId Required. The repository id to use for this repository.
18481848
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
18491849
*/
18501850
public final OperationFuture<Repository, OperationMetadata> createRepositoryAsync(
@@ -2945,6 +2945,172 @@ public final UnaryCallable<DeleteVersionRequest, Operation> deleteVersionCallabl
29452945
return stub.deleteVersionCallable();
29462946
}
29472947

2948+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
2949+
/**
2950+
* Deletes multiple versions across a repository. The returned operation will complete once the
2951+
* versions have been deleted.
2952+
*
2953+
* <p>Sample code:
2954+
*
2955+
* <pre>{@code
2956+
* // This snippet has been automatically generated and should be regarded as a code template only.
2957+
* // It will require modifications to work:
2958+
* // - It may require correct/in-range values for request initialization.
2959+
* // - It may require specifying regional endpoints when creating the service client as shown in
2960+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
2961+
* try (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
2962+
* PackageName parent = PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]");
2963+
* List<String> names = new ArrayList<>();
2964+
* artifactRegistryClient.batchDeleteVersionsAsync(parent, names).get();
2965+
* }
2966+
* }</pre>
2967+
*
2968+
* @param parent The name of the repository holding all requested versions.
2969+
* @param names Required. The names of the versions to delete. A maximum of 10000 versions can be
2970+
* deleted in a batch.
2971+
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
2972+
*/
2973+
public final OperationFuture<Empty, BatchDeleteVersionsMetadata> batchDeleteVersionsAsync(
2974+
PackageName parent, List<String> names) {
2975+
BatchDeleteVersionsRequest request =
2976+
BatchDeleteVersionsRequest.newBuilder()
2977+
.setParent(parent == null ? null : parent.toString())
2978+
.addAllNames(names)
2979+
.build();
2980+
return batchDeleteVersionsAsync(request);
2981+
}
2982+
2983+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
2984+
/**
2985+
* Deletes multiple versions across a repository. The returned operation will complete once the
2986+
* versions have been deleted.
2987+
*
2988+
* <p>Sample code:
2989+
*
2990+
* <pre>{@code
2991+
* // This snippet has been automatically generated and should be regarded as a code template only.
2992+
* // It will require modifications to work:
2993+
* // - It may require correct/in-range values for request initialization.
2994+
* // - It may require specifying regional endpoints when creating the service client as shown in
2995+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
2996+
* try (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
2997+
* String parent =
2998+
* PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString();
2999+
* List<String> names = new ArrayList<>();
3000+
* artifactRegistryClient.batchDeleteVersionsAsync(parent, names).get();
3001+
* }
3002+
* }</pre>
3003+
*
3004+
* @param parent The name of the repository holding all requested versions.
3005+
* @param names Required. The names of the versions to delete. A maximum of 10000 versions can be
3006+
* deleted in a batch.
3007+
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
3008+
*/
3009+
public final OperationFuture<Empty, BatchDeleteVersionsMetadata> batchDeleteVersionsAsync(
3010+
String parent, List<String> names) {
3011+
BatchDeleteVersionsRequest request =
3012+
BatchDeleteVersionsRequest.newBuilder().setParent(parent).addAllNames(names).build();
3013+
return batchDeleteVersionsAsync(request);
3014+
}
3015+
3016+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
3017+
/**
3018+
* Deletes multiple versions across a repository. The returned operation will complete once the
3019+
* versions have been deleted.
3020+
*
3021+
* <p>Sample code:
3022+
*
3023+
* <pre>{@code
3024+
* // This snippet has been automatically generated and should be regarded as a code template only.
3025+
* // It will require modifications to work:
3026+
* // - It may require correct/in-range values for request initialization.
3027+
* // - It may require specifying regional endpoints when creating the service client as shown in
3028+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
3029+
* try (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
3030+
* BatchDeleteVersionsRequest request =
3031+
* BatchDeleteVersionsRequest.newBuilder()
3032+
* .setParent(
3033+
* PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString())
3034+
* .addAllNames(new ArrayList<String>())
3035+
* .setValidateOnly(true)
3036+
* .build();
3037+
* artifactRegistryClient.batchDeleteVersionsAsync(request).get();
3038+
* }
3039+
* }</pre>
3040+
*
3041+
* @param request The request object containing all of the parameters for the API call.
3042+
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
3043+
*/
3044+
public final OperationFuture<Empty, BatchDeleteVersionsMetadata> batchDeleteVersionsAsync(
3045+
BatchDeleteVersionsRequest request) {
3046+
return batchDeleteVersionsOperationCallable().futureCall(request);
3047+
}
3048+
3049+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
3050+
/**
3051+
* Deletes multiple versions across a repository. The returned operation will complete once the
3052+
* versions have been deleted.
3053+
*
3054+
* <p>Sample code:
3055+
*
3056+
* <pre>{@code
3057+
* // This snippet has been automatically generated and should be regarded as a code template only.
3058+
* // It will require modifications to work:
3059+
* // - It may require correct/in-range values for request initialization.
3060+
* // - It may require specifying regional endpoints when creating the service client as shown in
3061+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
3062+
* try (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
3063+
* BatchDeleteVersionsRequest request =
3064+
* BatchDeleteVersionsRequest.newBuilder()
3065+
* .setParent(
3066+
* PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString())
3067+
* .addAllNames(new ArrayList<String>())
3068+
* .setValidateOnly(true)
3069+
* .build();
3070+
* OperationFuture<Empty, BatchDeleteVersionsMetadata> future =
3071+
* artifactRegistryClient.batchDeleteVersionsOperationCallable().futureCall(request);
3072+
* // Do something.
3073+
* future.get();
3074+
* }
3075+
* }</pre>
3076+
*/
3077+
public final OperationCallable<BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
3078+
batchDeleteVersionsOperationCallable() {
3079+
return stub.batchDeleteVersionsOperationCallable();
3080+
}
3081+
3082+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
3083+
/**
3084+
* Deletes multiple versions across a repository. The returned operation will complete once the
3085+
* versions have been deleted.
3086+
*
3087+
* <p>Sample code:
3088+
*
3089+
* <pre>{@code
3090+
* // This snippet has been automatically generated and should be regarded as a code template only.
3091+
* // It will require modifications to work:
3092+
* // - It may require correct/in-range values for request initialization.
3093+
* // - It may require specifying regional endpoints when creating the service client as shown in
3094+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
3095+
* try (ArtifactRegistryClient artifactRegistryClient = ArtifactRegistryClient.create()) {
3096+
* BatchDeleteVersionsRequest request =
3097+
* BatchDeleteVersionsRequest.newBuilder()
3098+
* .setParent(
3099+
* PackageName.of("[PROJECT]", "[LOCATION]", "[REPOSITORY]", "[PACKAGE]").toString())
3100+
* .addAllNames(new ArrayList<String>())
3101+
* .setValidateOnly(true)
3102+
* .build();
3103+
* ApiFuture<Operation> future =
3104+
* artifactRegistryClient.batchDeleteVersionsCallable().futureCall(request);
3105+
* // Do something.
3106+
* future.get();
3107+
* }
3108+
* }</pre>
3109+
*/
3110+
public final UnaryCallable<BatchDeleteVersionsRequest, Operation> batchDeleteVersionsCallable() {
3111+
return stub.batchDeleteVersionsCallable();
3112+
}
3113+
29483114
// AUTO-GENERATED DOCUMENTATION AND METHOD.
29493115
/**
29503116
* Lists files.
@@ -3239,7 +3405,8 @@ public final UnaryCallable<GetFileRequest, File> getFileCallable() {
32393405
* }
32403406
* }</pre>
32413407
*
3242-
* @param parent The name of the parent resource whose tags will be listed.
3408+
* @param parent The name of the parent package whose tags will be listed. For example:
3409+
* `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.
32433410
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
32443411
*/
32453412
public final ListTagsPagedResponse listTags(String parent) {

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

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,18 @@ public UnaryCallSettings<DeleteVersionRequest, Operation> deleteVersionSettings(
252252
return ((ArtifactRegistryStubSettings) getStubSettings()).deleteVersionOperationSettings();
253253
}
254254

255+
/** Returns the object with the settings used for calls to batchDeleteVersions. */
256+
public UnaryCallSettings<BatchDeleteVersionsRequest, Operation> batchDeleteVersionsSettings() {
257+
return ((ArtifactRegistryStubSettings) getStubSettings()).batchDeleteVersionsSettings();
258+
}
259+
260+
/** Returns the object with the settings used for calls to batchDeleteVersions. */
261+
public OperationCallSettings<BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
262+
batchDeleteVersionsOperationSettings() {
263+
return ((ArtifactRegistryStubSettings) getStubSettings())
264+
.batchDeleteVersionsOperationSettings();
265+
}
266+
255267
/** Returns the object with the settings used for calls to listFiles. */
256268
public PagedCallSettings<ListFilesRequest, ListFilesResponse, ListFilesPagedResponse>
257269
listFilesSettings() {
@@ -617,6 +629,19 @@ public UnaryCallSettings.Builder<DeleteVersionRequest, Operation> deleteVersionS
617629
return getStubSettingsBuilder().deleteVersionOperationSettings();
618630
}
619631

632+
/** Returns the builder for the settings used for calls to batchDeleteVersions. */
633+
public UnaryCallSettings.Builder<BatchDeleteVersionsRequest, Operation>
634+
batchDeleteVersionsSettings() {
635+
return getStubSettingsBuilder().batchDeleteVersionsSettings();
636+
}
637+
638+
/** Returns the builder for the settings used for calls to batchDeleteVersions. */
639+
public OperationCallSettings.Builder<
640+
BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
641+
batchDeleteVersionsOperationSettings() {
642+
return getStubSettingsBuilder().batchDeleteVersionsOperationSettings();
643+
}
644+
620645
/** Returns the builder for the settings used for calls to listFiles. */
621646
public PagedCallSettings.Builder<ListFilesRequest, ListFilesResponse, ListFilesPagedResponse>
622647
listFilesSettings() {

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@
1010
"grpc": {
1111
"libraryClient": "ArtifactRegistryClient",
1212
"rpcs": {
13+
"BatchDeleteVersions": {
14+
"methods": ["batchDeleteVersionsAsync", "batchDeleteVersionsAsync", "batchDeleteVersionsAsync", "batchDeleteVersionsOperationCallable", "batchDeleteVersionsCallable"]
15+
},
1316
"CreateRepository": {
1417
"methods": ["createRepositoryAsync", "createRepositoryAsync", "createRepositoryAsync", "createRepositoryOperationCallable", "createRepositoryCallable"]
1518
},

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

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,8 @@
3434
import com.google.cloud.location.ListLocationsRequest;
3535
import com.google.cloud.location.ListLocationsResponse;
3636
import com.google.cloud.location.Location;
37+
import com.google.devtools.artifactregistry.v1.BatchDeleteVersionsMetadata;
38+
import com.google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest;
3739
import com.google.devtools.artifactregistry.v1.CreateRepositoryRequest;
3840
import com.google.devtools.artifactregistry.v1.CreateTagRequest;
3941
import com.google.devtools.artifactregistry.v1.DeletePackageRequest;
@@ -273,6 +275,16 @@ public UnaryCallable<DeleteVersionRequest, Operation> deleteVersionCallable() {
273275
throw new UnsupportedOperationException("Not implemented: deleteVersionCallable()");
274276
}
275277

278+
public OperationCallable<BatchDeleteVersionsRequest, Empty, BatchDeleteVersionsMetadata>
279+
batchDeleteVersionsOperationCallable() {
280+
throw new UnsupportedOperationException(
281+
"Not implemented: batchDeleteVersionsOperationCallable()");
282+
}
283+
284+
public UnaryCallable<BatchDeleteVersionsRequest, Operation> batchDeleteVersionsCallable() {
285+
throw new UnsupportedOperationException("Not implemented: batchDeleteVersionsCallable()");
286+
}
287+
276288
public UnaryCallable<ListFilesRequest, ListFilesPagedResponse> listFilesPagedCallable() {
277289
throw new UnsupportedOperationException("Not implemented: listFilesPagedCallable()");
278290
}

0 commit comments

Comments
 (0)