diff --git a/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java b/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java index ffd87a80..c3d8946e 100644 --- a/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java +++ b/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java @@ -48,6 +48,18 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + * 

{@code
+ * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+ *     CertificateAuthorityServiceClient.create()) {
+ *   CertificateAuthorityName parent =
+ *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+ *   Certificate certificate = Certificate.newBuilder().build();
+ *   String certificateId = "certificateId-644529902";
+ *   Certificate response =
+ *       certificateAuthorityServiceClient.createCertificate(parent, certificate, certificateId);
+ * }
+ * }
+ * *

Note: close() needs to be called on the CertificateAuthorityServiceClient object to clean up * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). @@ -171,6 +183,20 @@ public final OperationsClient getOperationsClient() { * Project, Location from a particular * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName parent =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   Certificate certificate = Certificate.newBuilder().build();
+   *   String certificateId = "certificateId-644529902";
+   *   Certificate response =
+   *       certificateAuthorityServiceClient.createCertificate(parent, certificate, certificateId);
+   * }
+   * }
+ * * @param parent Required. The resource name of the location and * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * associated with the [Certificate][google.cloud.security.privateca.v1beta1.Certificate], in @@ -203,6 +229,21 @@ public final Certificate createCertificate( * Project, Location from a particular * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String parent =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   Certificate certificate = Certificate.newBuilder().build();
+   *   String certificateId = "certificateId-644529902";
+   *   Certificate response =
+   *       certificateAuthorityServiceClient.createCertificate(parent, certificate, certificateId);
+   * }
+   * }
+ * * @param parent Required. The resource name of the location and * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * associated with the [Certificate][google.cloud.security.privateca.v1beta1.Certificate], in @@ -235,6 +276,24 @@ public final Certificate createCertificate( * Project, Location from a particular * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CreateCertificateRequest request =
+   *       CreateCertificateRequest.newBuilder()
+   *           .setParent(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setCertificateId("certificateId-644529902")
+   *           .setCertificate(Certificate.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Certificate response = certificateAuthorityServiceClient.createCertificate(request);
+   * }
+   * }
+ * * @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 */ @@ -249,6 +308,25 @@ public final Certificate createCertificate(CreateCertificateRequest request) { * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CreateCertificateRequest request =
+   *       CreateCertificateRequest.newBuilder()
+   *           .setParent(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setCertificateId("certificateId-644529902")
+   *           .setCertificate(Certificate.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.createCertificateCallable().futureCall(request);
+   *   // Do something.
+   *   Certificate response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createCertificateCallable() { return stub.createCertificateCallable(); @@ -258,6 +336,17 @@ public final UnaryCallable createCertific /** * Returns a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateName name =
+   *       CertificateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]");
+   *   Certificate response = certificateAuthorityServiceClient.getCertificate(name);
+   * }
+   * }
+ * * @param name Required. The [name][google.cloud.security.privateca.v1beta1.Certificate.name] of * the [Certificate][google.cloud.security.privateca.v1beta1.Certificate] to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -272,6 +361,18 @@ public final Certificate getCertificate(CertificateName name) { /** * Returns a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]")
+   *           .toString();
+   *   Certificate response = certificateAuthorityServiceClient.getCertificate(name);
+   * }
+   * }
+ * * @param name Required. The [name][google.cloud.security.privateca.v1beta1.Certificate.name] of * the [Certificate][google.cloud.security.privateca.v1beta1.Certificate] to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -285,6 +386,22 @@ public final Certificate getCertificate(String name) { /** * Returns a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetCertificateRequest request =
+   *       GetCertificateRequest.newBuilder()
+   *           .setName(
+   *               CertificateName.of(
+   *                       "[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]")
+   *                   .toString())
+   *           .build();
+   *   Certificate response = certificateAuthorityServiceClient.getCertificate(request);
+   * }
+   * }
+ * * @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 */ @@ -297,6 +414,23 @@ public final Certificate getCertificate(GetCertificateRequest request) { * Returns a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetCertificateRequest request =
+   *       GetCertificateRequest.newBuilder()
+   *           .setName(
+   *               CertificateName.of(
+   *                       "[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.getCertificateCallable().futureCall(request);
+   *   // Do something.
+   *   Certificate response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getCertificateCallable() { return stub.getCertificateCallable(); @@ -306,6 +440,20 @@ public final UnaryCallable getCertificateCal /** * Lists [Certificates][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName parent =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   for (Certificate element :
+   *       certificateAuthorityServiceClient.listCertificates(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [Certificates][google.cloud.security.privateca.v1beta1.Certificate], in the format * `projects/*/locations/*/certificateauthorities/*`. @@ -323,6 +471,21 @@ public final ListCertificatesPagedResponse listCertificates(CertificateAuthority /** * Lists [Certificates][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String parent =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   for (Certificate element :
+   *       certificateAuthorityServiceClient.listCertificates(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [Certificates][google.cloud.security.privateca.v1beta1.Certificate], in the format * `projects/*/locations/*/certificateauthorities/*`. @@ -338,6 +501,28 @@ public final ListCertificatesPagedResponse listCertificates(String parent) { /** * Lists [Certificates][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListCertificatesRequest request =
+   *       ListCertificatesRequest.newBuilder()
+   *           .setParent(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   for (Certificate element :
+   *       certificateAuthorityServiceClient.listCertificates(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @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 */ @@ -350,6 +535,28 @@ public final ListCertificatesPagedResponse listCertificates(ListCertificatesRequ * Lists [Certificates][google.cloud.security.privateca.v1beta1.Certificate]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListCertificatesRequest request =
+   *       ListCertificatesRequest.newBuilder()
+   *           .setParent(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.listCertificatesPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Certificate element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCertificatesPagedCallable() { @@ -361,6 +568,25 @@ public final ListCertificatesPagedResponse listCertificates(ListCertificatesRequ * Lists [Certificates][google.cloud.security.privateca.v1beta1.Certificate]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   while (true) {
+   *     ListCertificatesResponse response =
+   *         certificateAuthorityServiceClient.listCertificatesCallable().call(request);
+   *     for (Certificate element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCertificatesCallable() { @@ -371,6 +597,17 @@ public final ListCertificatesPagedResponse listCertificates(ListCertificatesRequ /** * Revoke a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateName name =
+   *       CertificateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]");
+   *   Certificate response = certificateAuthorityServiceClient.revokeCertificate(name);
+   * }
+   * }
+ * * @param name Required. The resource name for this * [Certificate][google.cloud.security.privateca.v1beta1.Certificate] in the format * `projects/*/locations/*/certificateAuthorities/*/certificates/*`. @@ -388,6 +625,18 @@ public final Certificate revokeCertificate(CertificateName name) { /** * Revoke a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]")
+   *           .toString();
+   *   Certificate response = certificateAuthorityServiceClient.revokeCertificate(name);
+   * }
+   * }
+ * * @param name Required. The resource name for this * [Certificate][google.cloud.security.privateca.v1beta1.Certificate] in the format * `projects/*/locations/*/certificateAuthorities/*/certificates/*`. @@ -402,6 +651,23 @@ public final Certificate revokeCertificate(String name) { /** * Revoke a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   RevokeCertificateRequest request =
+   *       RevokeCertificateRequest.newBuilder()
+   *           .setName(
+   *               CertificateName.of(
+   *                       "[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Certificate response = certificateAuthorityServiceClient.revokeCertificate(request);
+   * }
+   * }
+ * * @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 */ @@ -414,6 +680,24 @@ public final Certificate revokeCertificate(RevokeCertificateRequest request) { * Revoke a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   RevokeCertificateRequest request =
+   *       RevokeCertificateRequest.newBuilder()
+   *           .setName(
+   *               CertificateName.of(
+   *                       "[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]", "[CERTIFICATE]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.revokeCertificateCallable().futureCall(request);
+   *   // Do something.
+   *   Certificate response = future.get();
+   * }
+   * }
*/ public final UnaryCallable revokeCertificateCallable() { return stub.revokeCertificateCallable(); @@ -425,6 +709,18 @@ public final UnaryCallable revokeCertific * only field you can update is the * [labels][google.cloud.security.privateca.v1beta1.Certificate.labels] field. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   Certificate certificate = Certificate.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Certificate response =
+   *       certificateAuthorityServiceClient.updateCertificate(certificate, updateMask);
+   * }
+   * }
+ * * @param certificate Required. [Certificate][google.cloud.security.privateca.v1beta1.Certificate] * with updated values. * @param updateMask Required. A list of fields to be updated in this request. @@ -445,6 +741,21 @@ public final Certificate updateCertificate(Certificate certificate, FieldMask up * only field you can update is the * [labels][google.cloud.security.privateca.v1beta1.Certificate.labels] field. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateRequest request =
+   *       UpdateCertificateRequest.newBuilder()
+   *           .setCertificate(Certificate.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Certificate response = certificateAuthorityServiceClient.updateCertificate(request);
+   * }
+   * }
+ * * @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 */ @@ -459,6 +770,22 @@ public final Certificate updateCertificate(UpdateCertificateRequest request) { * [labels][google.cloud.security.privateca.v1beta1.Certificate.labels] field. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateRequest request =
+   *       UpdateCertificateRequest.newBuilder()
+   *           .setCertificate(Certificate.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.updateCertificateCallable().futureCall(request);
+   *   // Do something.
+   *   Certificate response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateCertificateCallable() { return stub.updateCertificateCallable(); @@ -475,6 +802,18 @@ public final UnaryCallable updateCertific * [FetchCertificateAuthorityCsr][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.FetchCertificateAuthorityCsr], * this method can complete the activation process. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.activateCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -500,6 +839,19 @@ public final UnaryCallable updateCertific * [FetchCertificateAuthorityCsr][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.FetchCertificateAuthorityCsr], * this method can complete the activation process. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.activateCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -523,6 +875,25 @@ public final UnaryCallable updateCertific * [FetchCertificateAuthorityCsr][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.FetchCertificateAuthorityCsr], * this method can complete the activation process. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ActivateCertificateAuthorityRequest request =
+   *       ActivateCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPemCaCertificate("pemCaCertificate2100567073")
+   *           .setSubordinateConfig(SubordinateConfig.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.activateCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -543,6 +914,27 @@ public final UnaryCallable updateCertific * this method can complete the activation process. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ActivateCertificateAuthorityRequest request =
+   *       ActivateCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPemCaCertificate("pemCaCertificate2100567073")
+   *           .setSubordinateConfig(SubordinateConfig.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .activateCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< ActivateCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -562,6 +954,27 @@ public final UnaryCallable updateCertific * this method can complete the activation process. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ActivateCertificateAuthorityRequest request =
+   *       ActivateCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPemCaCertificate("pemCaCertificate2100567073")
+   *           .setSubordinateConfig(SubordinateConfig.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .activateCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable activateCertificateAuthorityCallable() { @@ -574,6 +987,21 @@ public final UnaryCallable updateCertific * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in a given * Project and Location. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   CertificateAuthority certificateAuthority = CertificateAuthority.newBuilder().build();
+   *   String certificateAuthorityId = "certificateAuthorityId-1652580953";
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient
+   *           .createCertificateAuthorityAsync(parent, certificateAuthority, certificateAuthorityId)
+   *           .get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority], in * the format `projects/*/locations/*`. @@ -604,6 +1032,21 @@ public final UnaryCallable updateCertific * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in a given * Project and Location. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   CertificateAuthority certificateAuthority = CertificateAuthority.newBuilder().build();
+   *   String certificateAuthorityId = "certificateAuthorityId-1652580953";
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient
+   *           .createCertificateAuthorityAsync(parent, certificateAuthority, certificateAuthorityId)
+   *           .get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority], in * the format `projects/*/locations/*`. @@ -632,6 +1075,23 @@ public final UnaryCallable updateCertific * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in a given * Project and Location. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CreateCertificateAuthorityRequest request =
+   *       CreateCertificateAuthorityRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setCertificateAuthorityId("certificateAuthorityId-1652580953")
+   *           .setCertificateAuthority(CertificateAuthority.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.createCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -647,6 +1107,25 @@ public final UnaryCallable updateCertific * Project and Location. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CreateCertificateAuthorityRequest request =
+   *       CreateCertificateAuthorityRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setCertificateAuthorityId("certificateAuthorityId-1652580953")
+   *           .setCertificateAuthority(CertificateAuthority.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .createCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< CreateCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -661,6 +1140,25 @@ public final UnaryCallable updateCertific * Project and Location. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CreateCertificateAuthorityRequest request =
+   *       CreateCertificateAuthorityRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setCertificateAuthorityId("certificateAuthorityId-1652580953")
+   *           .setCertificateAuthority(CertificateAuthority.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .createCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createCertificateAuthorityCallable() { @@ -671,6 +1169,18 @@ public final UnaryCallable updateCertific /** * Disable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.disableCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -689,6 +1199,19 @@ public final UnaryCallable updateCertific /** * Disable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.disableCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -705,6 +1228,23 @@ public final UnaryCallable updateCertific /** * Disable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   DisableCertificateAuthorityRequest request =
+   *       DisableCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.disableCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -718,6 +1258,25 @@ public final UnaryCallable updateCertific * Disable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   DisableCertificateAuthorityRequest request =
+   *       DisableCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .disableCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< DisableCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -730,6 +1289,25 @@ public final UnaryCallable updateCertific * Disable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   DisableCertificateAuthorityRequest request =
+   *       DisableCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .disableCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable disableCertificateAuthorityCallable() { @@ -740,6 +1318,18 @@ public final UnaryCallable updateCertific /** * Enable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.enableCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -758,6 +1348,19 @@ public final UnaryCallable updateCertific /** * Enable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.enableCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -774,6 +1377,23 @@ public final UnaryCallable updateCertific /** * Enable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   EnableCertificateAuthorityRequest request =
+   *       EnableCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.enableCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -787,6 +1407,25 @@ public final UnaryCallable updateCertific * Enable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   EnableCertificateAuthorityRequest request =
+   *       EnableCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .enableCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< EnableCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -799,6 +1438,25 @@ public final UnaryCallable updateCertific * Enable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   EnableCertificateAuthorityRequest request =
+   *       EnableCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .enableCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable enableCertificateAuthorityCallable() { @@ -818,6 +1476,18 @@ public final UnaryCallable updateCertific * or could be an on-prem certificate authority. See also * [ActivateCertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.ActivateCertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   FetchCertificateAuthorityCsrResponse response =
+   *       certificateAuthorityServiceClient.fetchCertificateAuthorityCsr(name);
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -845,6 +1515,19 @@ public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr( * or could be an on-prem certificate authority. See also * [ActivateCertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.ActivateCertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   FetchCertificateAuthorityCsrResponse response =
+   *       certificateAuthorityServiceClient.fetchCertificateAuthorityCsr(name);
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -869,6 +1552,22 @@ public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr(S * or could be an on-prem certificate authority. See also * [ActivateCertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.ActivateCertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   FetchCertificateAuthorityCsrRequest request =
+   *       FetchCertificateAuthorityCsrRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .build();
+   *   FetchCertificateAuthorityCsrResponse response =
+   *       certificateAuthorityServiceClient.fetchCertificateAuthorityCsr(request);
+   * }
+   * }
+ * * @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 */ @@ -891,6 +1590,24 @@ public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr( * [ActivateCertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.ActivateCertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   FetchCertificateAuthorityCsrRequest request =
+   *       FetchCertificateAuthorityCsrRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .fetchCertificateAuthorityCsrCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   FetchCertificateAuthorityCsrResponse response = future.get();
+   * }
+   * }
*/ public final UnaryCallable< FetchCertificateAuthorityCsrRequest, FetchCertificateAuthorityCsrResponse> @@ -902,6 +1619,18 @@ public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr( /** * Returns a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.getCertificateAuthority(name);
+   * }
+   * }
+ * * @param name Required. The * [name][google.cloud.security.privateca.v1beta1.CertificateAuthority.name] of the * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] to @@ -920,6 +1649,19 @@ public final CertificateAuthority getCertificateAuthority(CertificateAuthorityNa /** * Returns a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.getCertificateAuthority(name);
+   * }
+   * }
+ * * @param name Required. The * [name][google.cloud.security.privateca.v1beta1.CertificateAuthority.name] of the * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] to @@ -936,6 +1678,22 @@ public final CertificateAuthority getCertificateAuthority(String name) { /** * Returns a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetCertificateAuthorityRequest request =
+   *       GetCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.getCertificateAuthority(request);
+   * }
+   * }
+ * * @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 */ @@ -949,6 +1707,22 @@ public final CertificateAuthority getCertificateAuthority( * Returns a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetCertificateAuthorityRequest request =
+   *       GetCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.getCertificateAuthorityCallable().futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getCertificateAuthorityCallable() { @@ -959,6 +1733,19 @@ public final CertificateAuthority getCertificateAuthority( /** * Lists [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   for (CertificateAuthority element :
+   *       certificateAuthorityServiceClient.listCertificateAuthorities(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority], in * the format `projects/*/locations/*`. @@ -977,6 +1764,19 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( /** * Lists [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   for (CertificateAuthority element :
+   *       certificateAuthorityServiceClient.listCertificateAuthorities(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority], in * the format `projects/*/locations/*`. @@ -992,6 +1792,26 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( /** * Lists [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListCertificateAuthoritiesRequest request =
+   *       ListCertificateAuthoritiesRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   for (CertificateAuthority element :
+   *       certificateAuthorityServiceClient.listCertificateAuthorities(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @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 */ @@ -1005,6 +1825,28 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Lists [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListCertificateAuthoritiesRequest request =
+   *       ListCertificateAuthoritiesRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .listCertificateAuthoritiesPagedCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   for (CertificateAuthority element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable< ListCertificateAuthoritiesRequest, ListCertificateAuthoritiesPagedResponse> @@ -1017,6 +1859,25 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Lists [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   while (true) {
+   *     ListCertificateAuthoritiesResponse response =
+   *         certificateAuthorityServiceClient.listCertificateAuthoritiesCallable().call(request);
+   *     for (CertificateAuthority element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCertificateAuthoritiesCallable() { @@ -1028,6 +1889,18 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Restore a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * that is scheduled for deletion. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.restoreCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -1047,6 +1920,19 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Restore a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * that is scheduled for deletion. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.restoreCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -1064,6 +1950,23 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Restore a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * that is scheduled for deletion. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   RestoreCertificateAuthorityRequest request =
+   *       RestoreCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.restoreCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -1078,6 +1981,25 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * that is scheduled for deletion. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   RestoreCertificateAuthorityRequest request =
+   *       RestoreCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .restoreCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< RestoreCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -1091,6 +2013,25 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * that is scheduled for deletion. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   RestoreCertificateAuthorityRequest request =
+   *       RestoreCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .restoreCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable restoreCertificateAuthorityCallable() { @@ -1102,6 +2043,18 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Schedule a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * for deletion. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.scheduleDeleteCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -1121,6 +2074,19 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Schedule a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * for deletion. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.scheduleDeleteCertificateAuthorityAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The resource name for this * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in the * format `projects/*/locations/*/certificateAuthorities/*`. @@ -1138,6 +2104,23 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Schedule a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] * for deletion. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ScheduleDeleteCertificateAuthorityRequest request =
+   *       ScheduleDeleteCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.scheduleDeleteCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -1152,6 +2135,25 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * for deletion. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ScheduleDeleteCertificateAuthorityRequest request =
+   *       ScheduleDeleteCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .scheduleDeleteCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< ScheduleDeleteCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -1165,6 +2167,25 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * for deletion. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ScheduleDeleteCertificateAuthorityRequest request =
+   *       ScheduleDeleteCertificateAuthorityRequest.newBuilder()
+   *           .setName(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .scheduleDeleteCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable scheduleDeleteCertificateAuthorityCallable() { @@ -1175,6 +2196,20 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( /** * Update a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthority certificateAuthority = CertificateAuthority.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient
+   *           .updateCertificateAuthorityAsync(certificateAuthority, updateMask)
+   *           .get();
+   * }
+   * }
+ * * @param certificateAuthority Required. * [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] with * updated values. @@ -1196,6 +2231,22 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( /** * Update a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateAuthorityRequest request =
+   *       UpdateCertificateAuthorityRequest.newBuilder()
+   *           .setCertificateAuthority(CertificateAuthority.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateAuthority response =
+   *       certificateAuthorityServiceClient.updateCertificateAuthorityAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -1209,6 +2260,24 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Update a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateAuthorityRequest request =
+   *       UpdateCertificateAuthorityRequest.newBuilder()
+   *           .setCertificateAuthority(CertificateAuthority.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .updateCertificateAuthorityOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateAuthority response = future.get();
+   * }
+   * }
*/ public final OperationCallable< UpdateCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> @@ -1221,6 +2290,24 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Update a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateAuthorityRequest request =
+   *       UpdateCertificateAuthorityRequest.newBuilder()
+   *           .setCertificateAuthority(CertificateAuthority.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .updateCertificateAuthorityCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateCertificateAuthorityCallable() { @@ -1232,6 +2319,22 @@ public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( * Returns a * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateRevocationListName name =
+   *       CertificateRevocationListName.of(
+   *           "[PROJECT]",
+   *           "[LOCATION]",
+   *           "[CERTIFICATE_AUTHORITY]",
+   *           "[CERTIFICATE_REVOCATION_LIST]");
+   *   CertificateRevocationList response =
+   *       certificateAuthorityServiceClient.getCertificateRevocationList(name);
+   * }
+   * }
+ * * @param name Required. The * [name][google.cloud.security.privateca.v1beta1.CertificateRevocationList.name] of the * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList] @@ -1252,6 +2355,23 @@ public final CertificateRevocationList getCertificateRevocationList( * Returns a * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       CertificateRevocationListName.of(
+   *               "[PROJECT]",
+   *               "[LOCATION]",
+   *               "[CERTIFICATE_AUTHORITY]",
+   *               "[CERTIFICATE_REVOCATION_LIST]")
+   *           .toString();
+   *   CertificateRevocationList response =
+   *       certificateAuthorityServiceClient.getCertificateRevocationList(name);
+   * }
+   * }
+ * * @param name Required. The * [name][google.cloud.security.privateca.v1beta1.CertificateRevocationList.name] of the * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList] @@ -1269,6 +2389,26 @@ public final CertificateRevocationList getCertificateRevocationList(String name) * Returns a * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetCertificateRevocationListRequest request =
+   *       GetCertificateRevocationListRequest.newBuilder()
+   *           .setName(
+   *               CertificateRevocationListName.of(
+   *                       "[PROJECT]",
+   *                       "[LOCATION]",
+   *                       "[CERTIFICATE_AUTHORITY]",
+   *                       "[CERTIFICATE_REVOCATION_LIST]")
+   *                   .toString())
+   *           .build();
+   *   CertificateRevocationList response =
+   *       certificateAuthorityServiceClient.getCertificateRevocationList(request);
+   * }
+   * }
+ * * @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 */ @@ -1283,6 +2423,28 @@ public final CertificateRevocationList getCertificateRevocationList( * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetCertificateRevocationListRequest request =
+   *       GetCertificateRevocationListRequest.newBuilder()
+   *           .setName(
+   *               CertificateRevocationListName.of(
+   *                       "[PROJECT]",
+   *                       "[LOCATION]",
+   *                       "[CERTIFICATE_AUTHORITY]",
+   *                       "[CERTIFICATE_REVOCATION_LIST]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .getCertificateRevocationListCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateRevocationList response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getCertificateRevocationListCallable() { @@ -1294,6 +2456,20 @@ public final CertificateRevocationList getCertificateRevocationList( * Lists * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateAuthorityName parent =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+   *   for (CertificateRevocationList element :
+   *       certificateAuthorityServiceClient.listCertificateRevocationLists(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList], * in the format `projects/*/locations/*/certificateauthorities/*`. @@ -1313,6 +2489,21 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * Lists * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String parent =
+   *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *           .toString();
+   *   for (CertificateRevocationList element :
+   *       certificateAuthorityServiceClient.listCertificateRevocationLists(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList], * in the format `projects/*/locations/*/certificateauthorities/*`. @@ -1330,6 +2521,28 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * Lists * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListCertificateRevocationListsRequest request =
+   *       ListCertificateRevocationListsRequest.newBuilder()
+   *           .setParent(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   for (CertificateRevocationList element :
+   *       certificateAuthorityServiceClient.listCertificateRevocationLists(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @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 */ @@ -1344,6 +2557,30 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListCertificateRevocationListsRequest request =
+   *       ListCertificateRevocationListsRequest.newBuilder()
+   *           .setParent(
+   *               CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]")
+   *                   .toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .listCertificateRevocationListsPagedCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   for (CertificateRevocationList element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable< ListCertificateRevocationListsRequest, ListCertificateRevocationListsPagedResponse> @@ -1357,6 +2594,27 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   while (true) {
+   *     ListCertificateRevocationListsResponse response =
+   *         certificateAuthorityServiceClient
+   *             .listCertificateRevocationListsCallable()
+   *             .call(request);
+   *     for (CertificateRevocationList element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable< ListCertificateRevocationListsRequest, ListCertificateRevocationListsResponse> @@ -1369,6 +2627,21 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * Update a * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   CertificateRevocationList certificateRevocationList =
+   *       CertificateRevocationList.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   CertificateRevocationList response =
+   *       certificateAuthorityServiceClient
+   *           .updateCertificateRevocationListAsync(certificateRevocationList, updateMask)
+   *           .get();
+   * }
+   * }
+ * * @param certificateRevocationList Required. * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList] * with updated values. @@ -1391,6 +2664,22 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * Update a * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateRevocationListRequest request =
+   *       UpdateCertificateRevocationListRequest.newBuilder()
+   *           .setCertificateRevocationList(CertificateRevocationList.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   CertificateRevocationList response =
+   *       certificateAuthorityServiceClient.updateCertificateRevocationListAsync(request).get();
+   * }
+   * }
+ * * @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 */ @@ -1405,6 +2694,24 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateRevocationListRequest request =
+   *       UpdateCertificateRevocationListRequest.newBuilder()
+   *           .setCertificateRevocationList(CertificateRevocationList.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       certificateAuthorityServiceClient
+   *           .updateCertificateRevocationListOperationCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   CertificateRevocationList response = future.get();
+   * }
+   * }
*/ public final OperationCallable< UpdateCertificateRevocationListRequest, CertificateRevocationList, OperationMetadata> @@ -1418,6 +2725,24 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati * [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   UpdateCertificateRevocationListRequest request =
+   *       UpdateCertificateRevocationListRequest.newBuilder()
+   *           .setCertificateRevocationList(CertificateRevocationList.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient
+   *           .updateCertificateRevocationListCallable()
+   *           .futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateCertificateRevocationListCallable() { @@ -1428,6 +2753,17 @@ public final ListCertificateRevocationListsPagedResponse listCertificateRevocati /** * Returns a [ReusableConfig][google.cloud.security.privateca.v1beta1.ReusableConfig]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ReusableConfigName name =
+   *       ReusableConfigName.of("[PROJECT]", "[LOCATION]", "[REUSABLE_CONFIG]");
+   *   ReusableConfig response = certificateAuthorityServiceClient.getReusableConfig(name);
+   * }
+   * }
+ * * @param name Required. The [name][ReusableConfigs.name] of the [ReusableConfigs][] to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -1443,6 +2779,17 @@ public final ReusableConfig getReusableConfig(ReusableConfigName name) { /** * Returns a [ReusableConfig][google.cloud.security.privateca.v1beta1.ReusableConfig]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String name =
+   *       ReusableConfigName.of("[PROJECT]", "[LOCATION]", "[REUSABLE_CONFIG]").toString();
+   *   ReusableConfig response = certificateAuthorityServiceClient.getReusableConfig(name);
+   * }
+   * }
+ * * @param name Required. The [name][ReusableConfigs.name] of the [ReusableConfigs][] to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -1455,6 +2802,20 @@ public final ReusableConfig getReusableConfig(String name) { /** * Returns a [ReusableConfig][google.cloud.security.privateca.v1beta1.ReusableConfig]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetReusableConfigRequest request =
+   *       GetReusableConfigRequest.newBuilder()
+   *           .setName(
+   *               ReusableConfigName.of("[PROJECT]", "[LOCATION]", "[REUSABLE_CONFIG]").toString())
+   *           .build();
+   *   ReusableConfig response = certificateAuthorityServiceClient.getReusableConfig(request);
+   * }
+   * }
+ * * @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 */ @@ -1467,6 +2828,21 @@ public final ReusableConfig getReusableConfig(GetReusableConfigRequest request) * Returns a [ReusableConfig][google.cloud.security.privateca.v1beta1.ReusableConfig]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   GetReusableConfigRequest request =
+   *       GetReusableConfigRequest.newBuilder()
+   *           .setName(
+   *               ReusableConfigName.of("[PROJECT]", "[LOCATION]", "[REUSABLE_CONFIG]").toString())
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.getReusableConfigCallable().futureCall(request);
+   *   // Do something.
+   *   ReusableConfig response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getReusableConfigCallable() { return stub.getReusableConfigCallable(); @@ -1476,6 +2852,19 @@ public final UnaryCallable getReusable /** * Lists [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   for (ReusableConfig element :
+   *       certificateAuthorityServiceClient.listReusableConfigs(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig], in the format * `projects/*/locations/*`. @@ -1493,6 +2882,19 @@ public final ListReusableConfigsPagedResponse listReusableConfigs(LocationName p /** * Lists [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   for (ReusableConfig element :
+   *       certificateAuthorityServiceClient.listReusableConfigs(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the location associated with the * [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig], in the format * `projects/*/locations/*`. @@ -1508,6 +2910,26 @@ public final ListReusableConfigsPagedResponse listReusableConfigs(String parent) /** * Lists [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig]. * + *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListReusableConfigsRequest request =
+   *       ListReusableConfigsRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   for (ReusableConfig element :
+   *       certificateAuthorityServiceClient.listReusableConfigs(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @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 */ @@ -1521,6 +2943,26 @@ public final ListReusableConfigsPagedResponse listReusableConfigs( * Lists [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   ListReusableConfigsRequest request =
+   *       ListReusableConfigsRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   ApiFuture future =
+   *       certificateAuthorityServiceClient.listReusableConfigsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (ReusableConfig element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listReusableConfigsPagedCallable() { @@ -1532,6 +2974,25 @@ public final ListReusableConfigsPagedResponse listReusableConfigs( * Lists [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig]. * *

Sample code: + * + * 

{@code
+   * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+   *     CertificateAuthorityServiceClient.create()) {
+   *   while (true) {
+   *     ListReusableConfigsResponse response =
+   *         certificateAuthorityServiceClient.listReusableConfigsCallable().call(request);
+   *     for (ReusableConfig element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listReusableConfigsCallable() { diff --git a/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/package-info.java b/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/package-info.java index d90b206e..71bc080c 100644 --- a/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/package-info.java +++ b/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/package-info.java @@ -24,6 +24,18 @@ * certificate authorities and issued certificates. * *

Sample for CertificateAuthorityServiceClient: + * + * 

{@code
+ * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+ *     CertificateAuthorityServiceClient.create()) {
+ *   CertificateAuthorityName parent =
+ *       CertificateAuthorityName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_AUTHORITY]");
+ *   Certificate certificate = Certificate.newBuilder().build();
+ *   String certificateId = "certificateId-644529902";
+ *   Certificate response =
+ *       certificateAuthorityServiceClient.createCertificate(parent, certificate, certificateId);
+ * }
+ * }
*/ @Generated("by gapic-generator-java") package com.google.cloud.security.privateca.v1beta1; diff --git a/synth.metadata b/synth.metadata index 0705e34b..52beb197 100644 --- a/synth.metadata +++ b/synth.metadata @@ -4,15 +4,15 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-security-private-ca.git", - "sha": "494d697f90878d2af130c48e7840ce1ca201cf16" + "sha": "edd485063f3f415a2944e52c70f52885f86c039c" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "91e206bcfeaf8948ea03fe3cb1b7616108496cd3", - "internalRef": "350949863" + "sha": "8d8c008e56f1af31d57f75561e0f1848ffb29eeb", + "internalRef": "356341083" } }, {