Skip to content

Commit ec018ef

Browse files
chore: generate libraries at Tue Feb 17 02:59:58 UTC 2026
1 parent c009879 commit ec018ef

30 files changed

Lines changed: 1186 additions & 254 deletions

File tree

java-kms/google-cloud-kms/src/main/java/com/google/cloud/kms/v1/AutokeyAdminClient.java

Lines changed: 48 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -45,12 +45,13 @@
4545
// AUTO-GENERATED DOCUMENTATION AND CLASS.
4646
/**
4747
* Service Description: Provides interfaces for managing [Cloud KMS
48-
* Autokey](https://cloud.google.com/kms/help/autokey) folder-level configurations. A configuration
49-
* is inherited by all descendent projects. A configuration at one folder overrides any other
50-
* configurations in its ancestry. Setting a configuration on a folder is a prerequisite for Cloud
51-
* KMS Autokey, so that users working in a descendant project can request provisioned
52-
* [CryptoKeys][google.cloud.kms.v1.CryptoKey], ready for Customer Managed Encryption Key (CMEK)
53-
* use, on-demand.
48+
* Autokey](https://cloud.google.com/kms/help/autokey) folder-level or project-level configurations.
49+
* A configuration is inherited by all descendent folders and projects. A configuration at a folder
50+
* or project overrides any other configurations in its ancestry. Setting a configuration on a
51+
* folder is a prerequisite for Cloud KMS Autokey, so that users working in a descendant project can
52+
* request provisioned [CryptoKeys][google.cloud.kms.v1.CryptoKey], ready for Customer Managed
53+
* Encryption Key (CMEK) use, on-demand when using the dedicated key project mode. This is not
54+
* required when using the delegated key management mode for same-project keys.
5455
*
5556
* <p>This class provides the ability to make remote calls to the backing service through method
5657
* calls that map to API methods. Sample code to get started:
@@ -80,7 +81,7 @@
8081
* </tr>
8182
* <tr>
8283
* <td><p> UpdateAutokeyConfig</td>
83-
* <td><p> Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A [KeyHandle][google.cloud.kms.v1.KeyHandle] creation in the folder's descendant projects will use this configuration to determine where to create the resulting [CryptoKey][google.cloud.kms.v1.CryptoKey].</td>
84+
* <td><p> Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or a project. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A [KeyHandle][google.cloud.kms.v1.KeyHandle] creation in the folder's descendant projects will use this configuration to determine where to create the resulting [CryptoKey][google.cloud.kms.v1.CryptoKey].</td>
8485
* <td>
8586
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
8687
* <ul>
@@ -98,7 +99,7 @@
9899
* </tr>
99100
* <tr>
100101
* <td><p> GetAutokeyConfig</td>
101-
* <td><p> Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder.</td>
102+
* <td><p> Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or project.</td>
102103
* <td>
103104
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
104105
* <ul>
@@ -136,7 +137,8 @@
136137
* </tr>
137138
* <tr>
138139
* <td><p> ListLocations</td>
139-
* <td><p> Lists information about the supported locations for this service.</td>
140+
* <td><p> Lists information about the supported locations for this service.This method can be called in two ways:
141+
* <p> &#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42; &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or other locations specifically visibleto the project.</td>
140142
* <td>
141143
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
142144
* <ul>
@@ -312,8 +314,8 @@ public AutokeyAdminStub getStub() {
312314

313315
// AUTO-GENERATED DOCUMENTATION AND METHOD.
314316
/**
315-
* Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder. The caller must
316-
* have both `cloudkms.autokeyConfigs.update` permission on the parent folder and
317+
* Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or a project. The
318+
* caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and
317319
* `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A
318320
* [KeyHandle][google.cloud.kms.v1.KeyHandle] creation in the folder's descendant projects will
319321
* use this configuration to determine where to create the resulting
@@ -352,8 +354,8 @@ public final AutokeyConfig updateAutokeyConfig(
352354

353355
// AUTO-GENERATED DOCUMENTATION AND METHOD.
354356
/**
355-
* Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder. The caller must
356-
* have both `cloudkms.autokeyConfigs.update` permission on the parent folder and
357+
* Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or a project. The
358+
* caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and
357359
* `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A
358360
* [KeyHandle][google.cloud.kms.v1.KeyHandle] creation in the folder's descendant projects will
359361
* use this configuration to determine where to create the resulting
@@ -386,8 +388,8 @@ public final AutokeyConfig updateAutokeyConfig(UpdateAutokeyConfigRequest reques
386388

387389
// AUTO-GENERATED DOCUMENTATION AND METHOD.
388390
/**
389-
* Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder. The caller must
390-
* have both `cloudkms.autokeyConfigs.update` permission on the parent folder and
391+
* Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or a project. The
392+
* caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and
391393
* `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A
392394
* [KeyHandle][google.cloud.kms.v1.KeyHandle] creation in the folder's descendant projects will
393395
* use this configuration to determine where to create the resulting
@@ -421,7 +423,7 @@ public final AutokeyConfig updateAutokeyConfig(UpdateAutokeyConfigRequest reques
421423

422424
// AUTO-GENERATED DOCUMENTATION AND METHOD.
423425
/**
424-
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder.
426+
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or project.
425427
*
426428
* <p>Sample code:
427429
*
@@ -432,13 +434,13 @@ public final AutokeyConfig updateAutokeyConfig(UpdateAutokeyConfigRequest reques
432434
* // - It may require specifying regional endpoints when creating the service client as shown in
433435
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
434436
* try (AutokeyAdminClient autokeyAdminClient = AutokeyAdminClient.create()) {
435-
* AutokeyConfigName name = AutokeyConfigName.of("[FOLDER]");
437+
* AutokeyConfigName name = AutokeyConfigName.ofFolderName("[FOLDER]");
436438
* AutokeyConfig response = autokeyAdminClient.getAutokeyConfig(name);
437439
* }
438440
* }</pre>
439441
*
440442
* @param name Required. Name of the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] resource,
441-
* e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`.
443+
* e.g. `folders/{FOLDER_NUMBER}/autokeyConfig` or `projects/{PROJECT_NUMBER}/autokeyConfig`.
442444
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
443445
*/
444446
public final AutokeyConfig getAutokeyConfig(AutokeyConfigName name) {
@@ -449,7 +451,7 @@ public final AutokeyConfig getAutokeyConfig(AutokeyConfigName name) {
449451

450452
// AUTO-GENERATED DOCUMENTATION AND METHOD.
451453
/**
452-
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder.
454+
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or project.
453455
*
454456
* <p>Sample code:
455457
*
@@ -460,13 +462,13 @@ public final AutokeyConfig getAutokeyConfig(AutokeyConfigName name) {
460462
* // - It may require specifying regional endpoints when creating the service client as shown in
461463
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
462464
* try (AutokeyAdminClient autokeyAdminClient = AutokeyAdminClient.create()) {
463-
* String name = AutokeyConfigName.of("[FOLDER]").toString();
465+
* String name = AutokeyConfigName.ofFolderName("[FOLDER]").toString();
464466
* AutokeyConfig response = autokeyAdminClient.getAutokeyConfig(name);
465467
* }
466468
* }</pre>
467469
*
468470
* @param name Required. Name of the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] resource,
469-
* e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`.
471+
* e.g. `folders/{FOLDER_NUMBER}/autokeyConfig` or `projects/{PROJECT_NUMBER}/autokeyConfig`.
470472
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
471473
*/
472474
public final AutokeyConfig getAutokeyConfig(String name) {
@@ -476,7 +478,7 @@ public final AutokeyConfig getAutokeyConfig(String name) {
476478

477479
// AUTO-GENERATED DOCUMENTATION AND METHOD.
478480
/**
479-
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder.
481+
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or project.
480482
*
481483
* <p>Sample code:
482484
*
@@ -489,7 +491,7 @@ public final AutokeyConfig getAutokeyConfig(String name) {
489491
* try (AutokeyAdminClient autokeyAdminClient = AutokeyAdminClient.create()) {
490492
* GetAutokeyConfigRequest request =
491493
* GetAutokeyConfigRequest.newBuilder()
492-
* .setName(AutokeyConfigName.of("[FOLDER]").toString())
494+
* .setName(AutokeyConfigName.ofFolderName("[FOLDER]").toString())
493495
* .build();
494496
* AutokeyConfig response = autokeyAdminClient.getAutokeyConfig(request);
495497
* }
@@ -504,7 +506,7 @@ public final AutokeyConfig getAutokeyConfig(GetAutokeyConfigRequest request) {
504506

505507
// AUTO-GENERATED DOCUMENTATION AND METHOD.
506508
/**
507-
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder.
509+
* Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder or project.
508510
*
509511
* <p>Sample code:
510512
*
@@ -517,7 +519,7 @@ public final AutokeyConfig getAutokeyConfig(GetAutokeyConfigRequest request) {
517519
* try (AutokeyAdminClient autokeyAdminClient = AutokeyAdminClient.create()) {
518520
* GetAutokeyConfigRequest request =
519521
* GetAutokeyConfigRequest.newBuilder()
520-
* .setName(AutokeyConfigName.of("[FOLDER]").toString())
522+
* .setName(AutokeyConfigName.ofFolderName("[FOLDER]").toString())
521523
* .build();
522524
* ApiFuture<AutokeyConfig> future =
523525
* autokeyAdminClient.getAutokeyConfigCallable().futureCall(request);
@@ -653,7 +655,13 @@ public final ShowEffectiveAutokeyConfigResponse showEffectiveAutokeyConfig(
653655

654656
// AUTO-GENERATED DOCUMENTATION AND METHOD.
655657
/**
656-
* Lists information about the supported locations for this service.
658+
* Lists information about the supported locations for this service.This method can be called in
659+
* two ways:
660+
*
661+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
662+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
663+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
664+
* other locations specifically visibleto the project.
657665
*
658666
* <p>Sample code:
659667
*
@@ -686,7 +694,13 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
686694

687695
// AUTO-GENERATED DOCUMENTATION AND METHOD.
688696
/**
689-
* Lists information about the supported locations for this service.
697+
* Lists information about the supported locations for this service.This method can be called in
698+
* two ways:
699+
*
700+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
701+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
702+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
703+
* other locations specifically visibleto the project.
690704
*
691705
* <p>Sample code:
692706
*
@@ -720,7 +734,13 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
720734

721735
// AUTO-GENERATED DOCUMENTATION AND METHOD.
722736
/**
723-
* Lists information about the supported locations for this service.
737+
* Lists information about the supported locations for this service.This method can be called in
738+
* two ways:
739+
*
740+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
741+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
742+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
743+
* other locations specifically visibleto the project.
724744
*
725745
* <p>Sample code:
726746
*

java-kms/google-cloud-kms/src/main/java/com/google/cloud/kms/v1/AutokeyClient.java

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,8 @@
150150
* </tr>
151151
* <tr>
152152
* <td><p> ListLocations</td>
153-
* <td><p> Lists information about the supported locations for this service.</td>
153+
* <td><p> Lists information about the supported locations for this service.This method can be called in two ways:
154+
* <p> &#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42; &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or other locations specifically visibleto the project.</td>
154155
* <td>
155156
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
156157
* <ul>
@@ -824,7 +825,13 @@ public final ListKeyHandlesPagedResponse listKeyHandles(ListKeyHandlesRequest re
824825

825826
// AUTO-GENERATED DOCUMENTATION AND METHOD.
826827
/**
827-
* Lists information about the supported locations for this service.
828+
* Lists information about the supported locations for this service.This method can be called in
829+
* two ways:
830+
*
831+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
832+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
833+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
834+
* other locations specifically visibleto the project.
828835
*
829836
* <p>Sample code:
830837
*
@@ -857,7 +864,13 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
857864

858865
// AUTO-GENERATED DOCUMENTATION AND METHOD.
859866
/**
860-
* Lists information about the supported locations for this service.
867+
* Lists information about the supported locations for this service.This method can be called in
868+
* two ways:
869+
*
870+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
871+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
872+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
873+
* other locations specifically visibleto the project.
861874
*
862875
* <p>Sample code:
863876
*
@@ -890,7 +903,13 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
890903

891904
// AUTO-GENERATED DOCUMENTATION AND METHOD.
892905
/**
893-
* Lists information about the supported locations for this service.
906+
* Lists information about the supported locations for this service.This method can be called in
907+
* two ways:
908+
*
909+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
910+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
911+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
912+
* other locations specifically visibleto the project.
894913
*
895914
* <p>Sample code:
896915
*

java-kms/google-cloud-kms/src/main/java/com/google/cloud/kms/v1/EkmServiceClient.java

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -212,7 +212,8 @@
212212
* </tr>
213213
* <tr>
214214
* <td><p> ListLocations</td>
215-
* <td><p> Lists information about the supported locations for this service.</td>
215+
* <td><p> Lists information about the supported locations for this service.This method can be called in two ways:
216+
* <p> &#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42; &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or other locations specifically visibleto the project.</td>
216217
* <td>
217218
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
218219
* <ul>
@@ -1251,7 +1252,13 @@ public final VerifyConnectivityResponse verifyConnectivity(VerifyConnectivityReq
12511252

12521253
// AUTO-GENERATED DOCUMENTATION AND METHOD.
12531254
/**
1254-
* Lists information about the supported locations for this service.
1255+
* Lists information about the supported locations for this service.This method can be called in
1256+
* two ways:
1257+
*
1258+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
1259+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
1260+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
1261+
* other locations specifically visibleto the project.
12551262
*
12561263
* <p>Sample code:
12571264
*
@@ -1284,7 +1291,13 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
12841291

12851292
// AUTO-GENERATED DOCUMENTATION AND METHOD.
12861293
/**
1287-
* Lists information about the supported locations for this service.
1294+
* Lists information about the supported locations for this service.This method can be called in
1295+
* two ways:
1296+
*
1297+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
1298+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
1299+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
1300+
* other locations specifically visibleto the project.
12881301
*
12891302
* <p>Sample code:
12901303
*
@@ -1318,7 +1331,13 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
13181331

13191332
// AUTO-GENERATED DOCUMENTATION AND METHOD.
13201333
/**
1321-
* Lists information about the supported locations for this service.
1334+
* Lists information about the supported locations for this service.This method can be called in
1335+
* two ways:
1336+
*
1337+
* <p>&#42; &#42;&#42;List all public locations:&#42;&#42; Use the path `GET /v1/locations`.&#42;
1338+
* &#42;&#42;List project-visible locations:&#42;&#42; Use the path`GET
1339+
* /v1/projects/{project_id}/locations`. This may include publiclocations as well as private or
1340+
* other locations specifically visibleto the project.
13221341
*
13231342
* <p>Sample code:
13241343
*

0 commit comments

Comments
 (0)