diff --git a/.github/.OwlBot.lock.yaml b/.github/.OwlBot.lock.yaml
new file mode 100644
index 00000000..ed87b76c
--- /dev/null
+++ b/.github/.OwlBot.lock.yaml
@@ -0,0 +1,3 @@
+docker:
+ digest: sha256:be68f3f8f8216e2d9eb083f2721fc724c474d1b5327354fb8c7a46fcaa580316
+ image: gcr.io/repo-automation-bots/owlbot-java:latest
diff --git a/.github/.OwlBot.yaml b/.github/.OwlBot.yaml
new file mode 100644
index 00000000..8c7725ac
--- /dev/null
+++ b/.github/.OwlBot.yaml
@@ -0,0 +1,29 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+docker:
+ image: "gcr.io/repo-automation-bots/owlbot-java:latest"
+
+deep-remove-regex:
+- "/grpc-google-.*/src"
+- "/proto-google-.*/src"
+- "/google-.*/src"
+
+deep-copy-regex:
+- source: "/google/cloud/security/privateca/(v.*)/.*-java/proto-google-.*/src"
+ dest: "/owl-bot-staging/$1/proto-google-cloud-security-private-ca-$1/src"
+- source: "/google/cloud/security/privateca/(v.*)/.*-java/grpc-google-.*/src"
+ dest: "/owl-bot-staging/$1/grpc-google-cloud-security-private-ca-$1/src"
+- source: "/google/cloud/security/privateca/v.*/.*-java/gapic-google-.*/src"
+ dest: "/owl-bot-staging/$1/google-cloud-security-private-ca/src"
diff --git a/google-cloud-security-private-ca-bom/pom.xml b/google-cloud-security-private-ca-bom/pom.xml
index 28be3409..32ac98b3 100644
--- a/google-cloud-security-private-ca-bom/pom.xml
+++ b/google-cloud-security-private-ca-bom/pom.xml
@@ -1,4 +1,4 @@
-
+
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()) { + * CaPoolName parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * 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(). + * + *
The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *
See the individual methods for example code. + * + *
Many parameters require resource names to be formatted in a particular way. To assist with + * these names, this class includes a format method for each type of name, and additionally a parse + * method to extract the individual identifiers contained within names that are returned. + * + *
This class can be customized by passing in a custom instance of + * CertificateAuthorityServiceSettings to create(). For example: + * + *
To customize credentials: + * + *
{@code + * CertificateAuthorityServiceSettings certificateAuthorityServiceSettings = + * CertificateAuthorityServiceSettings.newBuilder() + * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) + * .build(); + * CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create(certificateAuthorityServiceSettings); + * }+ * + *
To customize the endpoint: + * + *
{@code + * CertificateAuthorityServiceSettings certificateAuthorityServiceSettings = + * CertificateAuthorityServiceSettings.newBuilder().setEndpoint(myEndpoint).build(); + * CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create(certificateAuthorityServiceSettings); + * }+ * + *
Please refer to the GitHub repository's samples for more quickstart code snippets. + */ +@Generated("by gapic-generator-java") +public class CertificateAuthorityServiceClient implements BackgroundResource { + private final CertificateAuthorityServiceSettings settings; + private final CertificateAuthorityServiceStub stub; + private final OperationsClient operationsClient; + + /** Constructs an instance of CertificateAuthorityServiceClient with default settings. */ + public static final CertificateAuthorityServiceClient create() throws IOException { + return create(CertificateAuthorityServiceSettings.newBuilder().build()); + } + + /** + * Constructs an instance of CertificateAuthorityServiceClient, using the given settings. The + * channels are created based on the settings passed in, or defaults for any settings that are not + * set. + */ + public static final CertificateAuthorityServiceClient create( + CertificateAuthorityServiceSettings settings) throws IOException { + return new CertificateAuthorityServiceClient(settings); + } + + /** + * Constructs an instance of CertificateAuthorityServiceClient, using the given stub for making + * calls. This is for advanced usage - prefer using create(CertificateAuthorityServiceSettings). + */ + @BetaApi("A restructuring of stub classes is planned, so this may break in the future") + public static final CertificateAuthorityServiceClient create( + CertificateAuthorityServiceStub stub) { + return new CertificateAuthorityServiceClient(stub); + } + + /** + * Constructs an instance of CertificateAuthorityServiceClient, using the given settings. This is + * protected so that it is easy to make a subclass, but otherwise, the static factory methods + * should be preferred. + */ + protected CertificateAuthorityServiceClient(CertificateAuthorityServiceSettings settings) + throws IOException { + this.settings = settings; + this.stub = ((CertificateAuthorityServiceStubSettings) settings.getStubSettings()).createStub(); + this.operationsClient = OperationsClient.create(this.stub.getOperationsStub()); + } + + @BetaApi("A restructuring of stub classes is planned, so this may break in the future") + protected CertificateAuthorityServiceClient(CertificateAuthorityServiceStub stub) { + this.settings = null; + this.stub = stub; + this.operationsClient = OperationsClient.create(this.stub.getOperationsStub()); + } + + public final CertificateAuthorityServiceSettings getSettings() { + return settings; + } + + @BetaApi("A restructuring of stub classes is planned, so this may break in the future") + public CertificateAuthorityServiceStub getStub() { + return stub; + } + + /** + * Returns the OperationsClient that can be used to query the status of a long-running operation + * returned by another API method call. + */ + public final OperationsClient getOperationsClient() { + return operationsClient; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Create a new [Certificate][google.cloud.security.privateca.v1.Certificate] in a given Project, + * Location from a particular [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * Certificate certificate = Certificate.newBuilder().build(); + * String certificateId = "certificateId-644529902"; + * Certificate response = + * certificateAuthorityServiceClient.createCertificate(parent, certificate, certificateId); + * } + * }+ * + * @param parent Required. The resource name of the + * [CaPool][google.cloud.security.privateca.v1.CaPool] associated with the + * [Certificate][google.cloud.security.privateca.v1.Certificate], in the format + * `projects/*/locations/*/caPools/*`. + * @param certificate Required. A [Certificate][google.cloud.security.privateca.v1.Certificate] + * with initial field values. + * @param certificateId Optional. It must be unique within a location and match the regular + * expression `[a-zA-Z0-9_-]{1,63}`. This field is required when using a + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * Enterprise [CaPool.Tier][google.cloud.security.privateca.v1.CaPool.Tier], but is optional + * and its value is ignored otherwise. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate createCertificate( + CaPoolName parent, Certificate certificate, String certificateId) { + CreateCertificateRequest request = + CreateCertificateRequest.newBuilder() + .setParent(parent == null ? null : parent.toString()) + .setCertificate(certificate) + .setCertificateId(certificateId) + .build(); + return createCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Create a new [Certificate][google.cloud.security.privateca.v1.Certificate] in a given Project, + * Location from a particular [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").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 + * [CaPool][google.cloud.security.privateca.v1.CaPool] associated with the + * [Certificate][google.cloud.security.privateca.v1.Certificate], in the format + * `projects/*/locations/*/caPools/*`. + * @param certificate Required. A [Certificate][google.cloud.security.privateca.v1.Certificate] + * with initial field values. + * @param certificateId Optional. It must be unique within a location and match the regular + * expression `[a-zA-Z0-9_-]{1,63}`. This field is required when using a + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * Enterprise [CaPool.Tier][google.cloud.security.privateca.v1.CaPool.Tier], but is optional + * and its value is ignored otherwise. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate createCertificate( + String parent, Certificate certificate, String certificateId) { + CreateCertificateRequest request = + CreateCertificateRequest.newBuilder() + .setParent(parent) + .setCertificate(certificate) + .setCertificateId(certificateId) + .build(); + return createCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Create a new [Certificate][google.cloud.security.privateca.v1.Certificate] in a given Project, + * Location from a particular [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateRequest request = + * CreateCertificateRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setCertificateId("certificateId-644529902") + * .setCertificate(Certificate.newBuilder().build()) + * .setRequestId("requestId693933066") + * .setValidateOnly(true) + * .setIssuingCertificateAuthorityId("issuingCertificateAuthorityId-559908707") + * .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 + */ + public final Certificate createCertificate(CreateCertificateRequest request) { + return createCertificateCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Create a new [Certificate][google.cloud.security.privateca.v1.Certificate] in a given Project, + * Location from a particular [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateRequest request = + * CreateCertificateRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setCertificateId("certificateId-644529902") + * .setCertificate(Certificate.newBuilder().build()) + * .setRequestId("requestId693933066") + * .setValidateOnly(true) + * .setIssuingCertificateAuthorityId("issuingCertificateAuthorityId-559908707") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.createCertificateCallable().futureCall(request); + * // Do something. + * Certificate response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateName name = + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]"); + * Certificate response = certificateAuthorityServiceClient.getCertificate(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.Certificate.name] of the + * [Certificate][google.cloud.security.privateca.v1.Certificate] to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate getCertificate(CertificateName name) { + GetCertificateRequest request = + GetCertificateRequest.newBuilder().setName(name == null ? null : name.toString()).build(); + return getCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [Certificate][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]").toString(); + * Certificate response = certificateAuthorityServiceClient.getCertificate(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.Certificate.name] of the + * [Certificate][google.cloud.security.privateca.v1.Certificate] to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate getCertificate(String name) { + GetCertificateRequest request = GetCertificateRequest.newBuilder().setName(name).build(); + return getCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [Certificate][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateRequest request = + * GetCertificateRequest.newBuilder() + * .setName( + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final Certificate getCertificate(GetCertificateRequest request) { + return getCertificateCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [Certificate][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateRequest request = + * GetCertificateRequest.newBuilder() + * .setName( + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]") + * .toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.getCertificateCallable().futureCall(request); + * // Do something. + * Certificate response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * 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.v1.Certificate], in the format + * `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificatesPagedResponse listCertificates(CaPoolName parent) { + ListCertificatesRequest request = + ListCertificatesRequest.newBuilder() + .setParent(parent == null ? null : parent.toString()) + .build(); + return listCertificates(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [Certificates][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").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.v1.Certificate], in the format + * `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificatesPagedResponse listCertificates(String parent) { + ListCertificatesRequest request = + ListCertificatesRequest.newBuilder().setParent(parent).build(); + return listCertificates(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [Certificates][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificatesRequest request = + * ListCertificatesRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").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 + */ + public final ListCertificatesPagedResponse listCertificates(ListCertificatesRequest request) { + return listCertificatesPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [Certificates][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificatesRequest request = + * ListCertificatesRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.listCertificatesPagedCallable().futureCall(request); + * // Do something. + * for (Certificate element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificatesRequest request = + * ListCertificatesRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * 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
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateName name = + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]"); + * Certificate response = certificateAuthorityServiceClient.revokeCertificate(name); + * } + * }+ * + * @param name Required. The resource name for this + * [Certificate][google.cloud.security.privateca.v1.Certificate] in the format + * `projects/*/locations/*/caPools/*/certificates/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate revokeCertificate(CertificateName name) { + RevokeCertificateRequest request = + RevokeCertificateRequest.newBuilder() + .setName(name == null ? null : name.toString()) + .build(); + return revokeCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Revoke a [Certificate][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]").toString(); + * Certificate response = certificateAuthorityServiceClient.revokeCertificate(name); + * } + * }+ * + * @param name Required. The resource name for this + * [Certificate][google.cloud.security.privateca.v1.Certificate] in the format + * `projects/*/locations/*/caPools/*/certificates/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate revokeCertificate(String name) { + RevokeCertificateRequest request = RevokeCertificateRequest.newBuilder().setName(name).build(); + return revokeCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Revoke a [Certificate][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * RevokeCertificateRequest request = + * RevokeCertificateRequest.newBuilder() + * .setName( + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]") + * .toString()) + * .setReason(RevocationReason.forNumber(0)) + * .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 + */ + public final Certificate revokeCertificate(RevokeCertificateRequest request) { + return revokeCertificateCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Revoke a [Certificate][google.cloud.security.privateca.v1.Certificate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * RevokeCertificateRequest request = + * RevokeCertificateRequest.newBuilder() + * .setName( + * CertificateName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE]") + * .toString()) + * .setReason(RevocationReason.forNumber(0)) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.revokeCertificateCallable().futureCall(request); + * // Do something. + * Certificate response = future.get(); + * } + * }
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.v1.Certificate] with + * updated values. + * @param updateMask Required. A list of fields to be updated in this request. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Certificate updateCertificate(Certificate certificate, FieldMask updateMask) { + UpdateCertificateRequest request = + UpdateCertificateRequest.newBuilder() + .setCertificate(certificate) + .setUpdateMask(updateMask) + .build(); + return updateCertificate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Update a [Certificate][google.cloud.security.privateca.v1.Certificate]. Currently, the only + * field you can update is the [labels][google.cloud.security.privateca.v1.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 + */ + public final Certificate updateCertificate(UpdateCertificateRequest request) { + return updateCertificateCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Update a [Certificate][google.cloud.security.privateca.v1.Certificate]. Currently, the only + * field you can update is the [labels][google.cloud.security.privateca.v1.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+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.updateCertificateCallable().futureCall(request); + * // Do something. + * Certificate response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * CertificateAuthority response = + * certificateAuthorityServiceClient.activateCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.activateCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ActivateCertificateAuthorityRequest request = + * ActivateCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ActivateCertificateAuthorityRequest request = + * ActivateCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setPemCaCertificate("pemCaCertificate2100567073") + * .setSubordinateConfig(SubordinateConfig.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + ActivateCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + activateCertificateAuthorityOperationCallable() { + return stub.activateCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Activate a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that + * is in state + * [AWAITING_USER_ACTIVATION][google.cloud.security.privateca.v1.CertificateAuthority.State.AWAITING_USER_ACTIVATION] + * and is of type + * [SUBORDINATE][google.cloud.security.privateca.v1.CertificateAuthority.Type.SUBORDINATE]. After + * the parent Certificate Authority signs a certificate signing request from + * [FetchCertificateAuthorityCsr][google.cloud.security.privateca.v1.CertificateAuthorityService.FetchCertificateAuthorityCsr], + * this method can complete the activation process. + * + *future = + * certificateAuthorityServiceClient + * .activateCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ActivateCertificateAuthorityRequest request = + * ActivateCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setPemCaCertificate("pemCaCertificate2100567073") + * .setSubordinateConfig(SubordinateConfig.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .activateCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * 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 + * [CaPool][google.cloud.security.privateca.v1.CaPool] associated with the + * [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority], in the + * format `projects/*/locations/*/caPools/*`. + * @param certificateAuthority Required. A + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] with + * initial field values. + * @param certificateAuthorityId Required. It must be unique within a location and match the + * regular expression `[a-zA-Z0-9_-]{1,63}` + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").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 + * [CaPool][google.cloud.security.privateca.v1.CaPool] associated with the + * [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority], in the + * format `projects/*/locations/*/caPools/*`. + * @param certificateAuthority Required. A + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] with + * initial field values. + * @param certificateAuthorityId Required. It must be unique within a location and match the + * regular expression `[a-zA-Z0-9_-]{1,63}` + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateAuthorityRequest request = + * CreateCertificateAuthorityRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateAuthorityRequest request = + * CreateCertificateAuthorityRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setCertificateAuthorityId("certificateAuthorityId-1652580953") + * .setCertificateAuthority(CertificateAuthority.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + CreateCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + createCertificateAuthorityOperationCallable() { + return stub.createCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Create a new [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in + * a given Project and Location. + * + *future = + * certificateAuthorityServiceClient + * .createCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateAuthorityRequest request = + * CreateCertificateAuthorityRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setCertificateAuthorityId("certificateAuthorityId-1652580953") + * .setCertificateAuthority(CertificateAuthority.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .createCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * CertificateAuthority response = + * certificateAuthorityServiceClient.disableCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.disableCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DisableCertificateAuthorityRequest request = + * DisableCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DisableCertificateAuthorityRequest request = + * DisableCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + DisableCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + disableCertificateAuthorityOperationCallable() { + return stub.disableCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Disable a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *future = + * certificateAuthorityServiceClient + * .disableCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DisableCertificateAuthorityRequest request = + * DisableCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .disableCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * CertificateAuthority response = + * certificateAuthorityServiceClient.enableCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.enableCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * EnableCertificateAuthorityRequest request = + * EnableCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * EnableCertificateAuthorityRequest request = + * EnableCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + EnableCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + enableCertificateAuthorityOperationCallable() { + return stub.enableCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Enable a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *future = + * certificateAuthorityServiceClient + * .enableCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * EnableCertificateAuthorityRequest request = + * EnableCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .enableCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * FetchCertificateAuthorityCsrResponse response = + * certificateAuthorityServiceClient.fetchCertificateAuthorityCsr(name); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr( + CertificateAuthorityName name) { + FetchCertificateAuthorityCsrRequest request = + FetchCertificateAuthorityCsrRequest.newBuilder() + .setName(name == null ? null : name.toString()) + .build(); + return fetchCertificateAuthorityCsr(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Fetch a certificate signing request (CSR) from a + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that is in + * state + * [AWAITING_USER_ACTIVATION][google.cloud.security.privateca.v1.CertificateAuthority.State.AWAITING_USER_ACTIVATION] + * and is of type + * [SUBORDINATE][google.cloud.security.privateca.v1.CertificateAuthority.Type.SUBORDINATE]. The + * CSR must then be signed by the desired parent Certificate Authority, which could be another + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] resource, or + * could be an on-prem certificate authority. See also + * [ActivateCertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthorityService.ActivateCertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * FetchCertificateAuthorityCsrResponse response = + * certificateAuthorityServiceClient.fetchCertificateAuthorityCsr(name); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr(String name) { + FetchCertificateAuthorityCsrRequest request = + FetchCertificateAuthorityCsrRequest.newBuilder().setName(name).build(); + return fetchCertificateAuthorityCsr(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Fetch a certificate signing request (CSR) from a + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that is in + * state + * [AWAITING_USER_ACTIVATION][google.cloud.security.privateca.v1.CertificateAuthority.State.AWAITING_USER_ACTIVATION] + * and is of type + * [SUBORDINATE][google.cloud.security.privateca.v1.CertificateAuthority.Type.SUBORDINATE]. The + * CSR must then be signed by the desired parent Certificate Authority, which could be another + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] resource, or + * could be an on-prem certificate authority. See also + * [ActivateCertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthorityService.ActivateCertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * FetchCertificateAuthorityCsrRequest request = + * FetchCertificateAuthorityCsrRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final FetchCertificateAuthorityCsrResponse fetchCertificateAuthorityCsr( + FetchCertificateAuthorityCsrRequest request) { + return fetchCertificateAuthorityCsrCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Fetch a certificate signing request (CSR) from a + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that is in + * state + * [AWAITING_USER_ACTIVATION][google.cloud.security.privateca.v1.CertificateAuthority.State.AWAITING_USER_ACTIVATION] + * and is of type + * [SUBORDINATE][google.cloud.security.privateca.v1.CertificateAuthority.Type.SUBORDINATE]. The + * CSR must then be signed by the desired parent Certificate Authority, which could be another + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] resource, or + * could be an on-prem certificate authority. See also + * [ActivateCertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthorityService.ActivateCertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * FetchCertificateAuthorityCsrRequest request = + * FetchCertificateAuthorityCsrRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallable< + FetchCertificateAuthorityCsrRequest, FetchCertificateAuthorityCsrResponse> + fetchCertificateAuthorityCsrCallable() { + return stub.fetchCertificateAuthorityCsrCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *future = + * certificateAuthorityServiceClient + * .fetchCertificateAuthorityCsrCallable() + * .futureCall(request); + * // Do something. + * FetchCertificateAuthorityCsrResponse response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * CertificateAuthority response = + * certificateAuthorityServiceClient.getCertificateAuthority(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.CertificateAuthority.name] + * of the [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] to + * get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CertificateAuthority getCertificateAuthority(CertificateAuthorityName name) { + GetCertificateAuthorityRequest request = + GetCertificateAuthorityRequest.newBuilder() + .setName(name == null ? null : name.toString()) + .build(); + return getCertificateAuthority(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.getCertificateAuthority(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.CertificateAuthority.name] + * of the [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] to + * get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CertificateAuthority getCertificateAuthority(String name) { + GetCertificateAuthorityRequest request = + GetCertificateAuthorityRequest.newBuilder().setName(name).build(); + return getCertificateAuthority(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateAuthorityRequest request = + * GetCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final CertificateAuthority getCertificateAuthority( + GetCertificateAuthorityRequest request) { + return getCertificateAuthorityCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateAuthorityRequest request = + * GetCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.getCertificateAuthorityCallable().futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * for (CertificateAuthority element : + * certificateAuthorityServiceClient.listCertificateAuthorities(parent).iterateAll()) { + * // doThingsWith(element); + * } + * } + * }+ * + * @param parent Required. The resource name of the + * [CaPool][google.cloud.security.privateca.v1.CaPool] associated with the + * [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority], in the + * format `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( + CaPoolName parent) { + ListCertificateAuthoritiesRequest request = + ListCertificateAuthoritiesRequest.newBuilder() + .setParent(parent == null ? null : parent.toString()) + .build(); + return listCertificateAuthorities(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString(); + * for (CertificateAuthority element : + * certificateAuthorityServiceClient.listCertificateAuthorities(parent).iterateAll()) { + * // doThingsWith(element); + * } + * } + * }+ * + * @param parent Required. The resource name of the + * [CaPool][google.cloud.security.privateca.v1.CaPool] associated with the + * [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority], in the + * format `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities(String parent) { + ListCertificateAuthoritiesRequest request = + ListCertificateAuthoritiesRequest.newBuilder().setParent(parent).build(); + return listCertificateAuthorities(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateAuthoritiesRequest request = + * ListCertificateAuthoritiesRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").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 + */ + public final ListCertificateAuthoritiesPagedResponse listCertificateAuthorities( + ListCertificateAuthoritiesRequest request) { + return listCertificateAuthoritiesPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateAuthoritiesRequest request = + * ListCertificateAuthoritiesRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * ApiFuture+ */ + public final UnaryCallable< + ListCertificateAuthoritiesRequest, ListCertificateAuthoritiesPagedResponse> + listCertificateAuthoritiesPagedCallable() { + return stub.listCertificateAuthoritiesPagedCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *future = + * certificateAuthorityServiceClient + * .listCertificateAuthoritiesPagedCallable() + * .futureCall(request); + * // Do something. + * for (CertificateAuthority element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateAuthoritiesRequest request = + * ListCertificateAuthoritiesRequest.newBuilder() + * .setParent(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * 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
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * CertificateAuthority response = + * certificateAuthorityServiceClient.undeleteCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.undeleteCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UndeleteCertificateAuthorityRequest request = + * UndeleteCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.undeleteCertificateAuthorityAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UndeleteCertificateAuthorityRequest request = + * UndeleteCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + UndeleteCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + undeleteCertificateAuthorityOperationCallable() { + return stub.undeleteCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Undelete a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that + * has been deleted. + * + *future = + * certificateAuthorityServiceClient + * .undeleteCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UndeleteCertificateAuthorityRequest request = + * UndeleteCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .undeleteCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]"); + * CertificateAuthority response = + * certificateAuthorityServiceClient.deleteCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.deleteCertificateAuthorityAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in the + * format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCertificateAuthorityRequest request = + * DeleteCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .setIgnoreActiveCertificates(true) + * .build(); + * CertificateAuthority response = + * certificateAuthorityServiceClient.deleteCertificateAuthorityAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCertificateAuthorityRequest request = + * DeleteCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .setIgnoreActiveCertificates(true) + * .build(); + * OperationFuture+ */ + public final OperationCallable< + DeleteCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + deleteCertificateAuthorityOperationCallable() { + return stub.deleteCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Delete a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *future = + * certificateAuthorityServiceClient + * .deleteCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCertificateAuthorityRequest request = + * DeleteCertificateAuthorityRequest.newBuilder() + * .setName( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setRequestId("requestId693933066") + * .setIgnoreActiveCertificates(true) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .deleteCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
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.v1.CertificateAuthority] with + * updated values. + * @param updateMask Required. A list of fields to be updated in this request. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateAuthorityRequest request = + * UpdateCertificateAuthorityRequest.newBuilder() + * .setCertificateAuthority(CertificateAuthority.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + UpdateCertificateAuthorityRequest, CertificateAuthority, OperationMetadata> + updateCertificateAuthorityOperationCallable() { + return stub.updateCertificateAuthorityOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Update a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]. + * + *future = + * certificateAuthorityServiceClient + * .updateCertificateAuthorityOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateAuthority response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateAuthorityRequest request = + * UpdateCertificateAuthorityRequest.newBuilder() + * .setCertificateAuthority(CertificateAuthority.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .updateCertificateAuthorityCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]"); + * CaPool caPool = CaPool.newBuilder().build(); + * String caPoolId = "caPoolId-970668971"; + * CaPool response = + * certificateAuthorityServiceClient.createCaPoolAsync(parent, caPool, caPoolId).get(); + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CaPool][google.cloud.security.privateca.v1.CaPool], in the format + * `projects/*/locations/*`. + * @param caPool Required. A [CaPool][google.cloud.security.privateca.v1.CaPool] with initial + * field values. + * @param caPoolId Required. It must be unique within a location and match the regular expression + * `[a-zA-Z0-9_-]{1,63}` + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString(); + * CaPool caPool = CaPool.newBuilder().build(); + * String caPoolId = "caPoolId-970668971"; + * CaPool response = + * certificateAuthorityServiceClient.createCaPoolAsync(parent, caPool, caPoolId).get(); + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CaPool][google.cloud.security.privateca.v1.CaPool], in the format + * `projects/*/locations/*`. + * @param caPool Required. A [CaPool][google.cloud.security.privateca.v1.CaPool] with initial + * field values. + * @param caPoolId Required. It must be unique within a location and match the regular expression + * `[a-zA-Z0-9_-]{1,63}` + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCaPoolRequest request = + * CreateCaPoolRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setCaPoolId("caPoolId-970668971") + * .setCaPool(CaPool.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * CaPool response = certificateAuthorityServiceClient.createCaPoolAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCaPoolRequest request = + * CreateCaPoolRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setCaPoolId("caPoolId-970668971") + * .setCaPool(CaPool.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * certificateAuthorityServiceClient.createCaPoolOperationCallable().futureCall(request); + * // Do something. + * CaPool response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCaPoolRequest request = + * CreateCaPoolRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setCaPoolId("caPoolId-970668971") + * .setCaPool(CaPool.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.createCaPoolCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPool caPool = CaPool.newBuilder().build(); + * FieldMask updateMask = FieldMask.newBuilder().build(); + * CaPool response = + * certificateAuthorityServiceClient.updateCaPoolAsync(caPool, updateMask).get(); + * } + * }+ * + * @param caPool Required. [CaPool][google.cloud.security.privateca.v1.CaPool] with updated + * values. + * @param updateMask Required. A list of fields to be updated in this request. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCaPoolRequest request = + * UpdateCaPoolRequest.newBuilder() + * .setCaPool(CaPool.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * CaPool response = certificateAuthorityServiceClient.updateCaPoolAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCaPoolRequest request = + * UpdateCaPoolRequest.newBuilder() + * .setCaPool(CaPool.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * certificateAuthorityServiceClient.updateCaPoolOperationCallable().futureCall(request); + * // Do something. + * CaPool response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCaPoolRequest request = + * UpdateCaPoolRequest.newBuilder() + * .setCaPool(CaPool.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.updateCaPoolCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName name = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * CaPool response = certificateAuthorityServiceClient.getCaPool(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.CaPool.name] of the + * [CaPool][google.cloud.security.privateca.v1.CaPool] to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CaPool getCaPool(CaPoolName name) { + GetCaPoolRequest request = + GetCaPoolRequest.newBuilder().setName(name == null ? null : name.toString()).build(); + return getCaPool(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString(); + * CaPool response = certificateAuthorityServiceClient.getCaPool(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.CaPool.name] of the + * [CaPool][google.cloud.security.privateca.v1.CaPool] to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CaPool getCaPool(String name) { + GetCaPoolRequest request = GetCaPoolRequest.newBuilder().setName(name).build(); + return getCaPool(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCaPoolRequest request = + * GetCaPoolRequest.newBuilder() + * .setName(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .build(); + * CaPool response = certificateAuthorityServiceClient.getCaPool(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 + */ + public final CaPool getCaPool(GetCaPoolRequest request) { + return getCaPoolCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCaPoolRequest request = + * GetCaPoolRequest.newBuilder() + * .setName(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.getCaPoolCallable().futureCall(request); + * // Do something. + * CaPool response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]"); + * for (CaPool element : certificateAuthorityServiceClient.listCaPools(parent).iterateAll()) { + * // doThingsWith(element); + * } + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CaPools][google.cloud.security.privateca.v1.CaPool], in the format + * `projects/*/locations/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCaPoolsPagedResponse listCaPools(LocationName parent) { + ListCaPoolsRequest request = + ListCaPoolsRequest.newBuilder() + .setParent(parent == null ? null : parent.toString()) + .build(); + return listCaPools(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CaPools][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString(); + * for (CaPool element : certificateAuthorityServiceClient.listCaPools(parent).iterateAll()) { + * // doThingsWith(element); + * } + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CaPools][google.cloud.security.privateca.v1.CaPool], in the format + * `projects/*/locations/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCaPoolsPagedResponse listCaPools(String parent) { + ListCaPoolsRequest request = ListCaPoolsRequest.newBuilder().setParent(parent).build(); + return listCaPools(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CaPools][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCaPoolsRequest request = + * ListCaPoolsRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * for (CaPool element : certificateAuthorityServiceClient.listCaPools(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 + */ + public final ListCaPoolsPagedResponse listCaPools(ListCaPoolsRequest request) { + return listCaPoolsPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CaPools][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCaPoolsRequest request = + * ListCaPoolsRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.listCaPoolsPagedCallable().futureCall(request); + * // Do something. + * for (CaPool element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCaPoolsRequest request = + * ListCaPoolsRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * while (true) { + * ListCaPoolsResponse response = + * certificateAuthorityServiceClient.listCaPoolsCallable().call(request); + * for (CaPool element : response.getResponsesList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; + * } + * } + * } + * }+ */ + public final UnaryCallable
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName name = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * CaPool response = certificateAuthorityServiceClient.deleteCaPoolAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CaPool][google.cloud.security.privateca.v1.CaPool] in the format + * `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString(); + * CaPool response = certificateAuthorityServiceClient.deleteCaPoolAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CaPool][google.cloud.security.privateca.v1.CaPool] in the format + * `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCaPoolRequest request = + * DeleteCaPoolRequest.newBuilder() + * .setName(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * CaPool response = certificateAuthorityServiceClient.deleteCaPoolAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCaPoolRequest request = + * DeleteCaPoolRequest.newBuilder() + * .setName(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * certificateAuthorityServiceClient.deleteCaPoolOperationCallable().futureCall(request); + * // Do something. + * CaPool response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCaPoolRequest request = + * DeleteCaPoolRequest.newBuilder() + * .setName(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.deleteCaPoolCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CaPoolName caPool = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]"); + * FetchCaCertsResponse response = certificateAuthorityServiceClient.fetchCaCerts(caPool); + * } + * }+ * + * @param caPool Required. The resource name for the + * [CaPool][google.cloud.security.privateca.v1.CaPool] in the format + * `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final FetchCaCertsResponse fetchCaCerts(CaPoolName caPool) { + FetchCaCertsRequest request = + FetchCaCertsRequest.newBuilder() + .setCaPool(caPool == null ? null : caPool.toString()) + .build(); + return fetchCaCerts(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * FetchCaCerts returns the current trust anchor for the + * [CaPool][google.cloud.security.privateca.v1.CaPool]. This will include CA certificate chains + * for all ACTIVE [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] + * resources in the [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String caPool = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString(); + * FetchCaCertsResponse response = certificateAuthorityServiceClient.fetchCaCerts(caPool); + * } + * }+ * + * @param caPool Required. The resource name for the + * [CaPool][google.cloud.security.privateca.v1.CaPool] in the format + * `projects/*/locations/*/caPools/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final FetchCaCertsResponse fetchCaCerts(String caPool) { + FetchCaCertsRequest request = FetchCaCertsRequest.newBuilder().setCaPool(caPool).build(); + return fetchCaCerts(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * FetchCaCerts returns the current trust anchor for the + * [CaPool][google.cloud.security.privateca.v1.CaPool]. This will include CA certificate chains + * for all ACTIVE [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] + * resources in the [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * FetchCaCertsRequest request = + * FetchCaCertsRequest.newBuilder() + * .setCaPool(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * FetchCaCertsResponse response = certificateAuthorityServiceClient.fetchCaCerts(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 + */ + public final FetchCaCertsResponse fetchCaCerts(FetchCaCertsRequest request) { + return fetchCaCertsCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * FetchCaCerts returns the current trust anchor for the + * [CaPool][google.cloud.security.privateca.v1.CaPool]. This will include CA certificate chains + * for all ACTIVE [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] + * resources in the [CaPool][google.cloud.security.privateca.v1.CaPool]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * FetchCaCertsRequest request = + * FetchCaCertsRequest.newBuilder() + * .setCaPool(CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.fetchCaCertsCallable().futureCall(request); + * // Do something. + * FetchCaCertsResponse response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateRevocationListName name = + * CertificateRevocationListName.of( + * "[PROJECT]", + * "[LOCATION]", + * "[CA_POOL]", + * "[CERTIFICATE_AUTHORITY]", + * "[CERTIFICATE_REVOCATION_LIST]"); + * CertificateRevocationList response = + * certificateAuthorityServiceClient.getCertificateRevocationList(name); + * } + * }+ * + * @param name Required. The + * [name][google.cloud.security.privateca.v1.CertificateRevocationList.name] of the + * [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList] + * to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CertificateRevocationList getCertificateRevocationList( + CertificateRevocationListName name) { + GetCertificateRevocationListRequest request = + GetCertificateRevocationListRequest.newBuilder() + .setName(name == null ? null : name.toString()) + .build(); + return getCertificateRevocationList(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a + * [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateRevocationListName.of( + * "[PROJECT]", + * "[LOCATION]", + * "[CA_POOL]", + * "[CERTIFICATE_AUTHORITY]", + * "[CERTIFICATE_REVOCATION_LIST]") + * .toString(); + * CertificateRevocationList response = + * certificateAuthorityServiceClient.getCertificateRevocationList(name); + * } + * }+ * + * @param name Required. The + * [name][google.cloud.security.privateca.v1.CertificateRevocationList.name] of the + * [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList] + * to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CertificateRevocationList getCertificateRevocationList(String name) { + GetCertificateRevocationListRequest request = + GetCertificateRevocationListRequest.newBuilder().setName(name).build(); + return getCertificateRevocationList(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a + * [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateRevocationListRequest request = + * GetCertificateRevocationListRequest.newBuilder() + * .setName( + * CertificateRevocationListName.of( + * "[PROJECT]", + * "[LOCATION]", + * "[CA_POOL]", + * "[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 + */ + public final CertificateRevocationList getCertificateRevocationList( + GetCertificateRevocationListRequest request) { + return getCertificateRevocationListCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a + * [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateRevocationListRequest request = + * GetCertificateRevocationListRequest.newBuilder() + * .setName( + * CertificateRevocationListName.of( + * "[PROJECT]", + * "[LOCATION]", + * "[CA_POOL]", + * "[CERTIFICATE_AUTHORITY]", + * "[CERTIFICATE_REVOCATION_LIST]") + * .toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .getCertificateRevocationListCallable() + * .futureCall(request); + * // Do something. + * CertificateRevocationList response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateAuthorityName parent = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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.v1.CertificateRevocationList], + * in the format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificateRevocationListsPagedResponse listCertificateRevocationLists( + CertificateAuthorityName parent) { + ListCertificateRevocationListsRequest request = + ListCertificateRevocationListsRequest.newBuilder() + .setParent(parent == null ? null : parent.toString()) + .build(); + return listCertificateRevocationLists(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists + * [CertificateRevocationLists][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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.v1.CertificateRevocationList], + * in the format `projects/*/locations/*/caPools/*/certificateAuthorities/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificateRevocationListsPagedResponse listCertificateRevocationLists( + String parent) { + ListCertificateRevocationListsRequest request = + ListCertificateRevocationListsRequest.newBuilder().setParent(parent).build(); + return listCertificateRevocationLists(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists + * [CertificateRevocationLists][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateRevocationListsRequest request = + * ListCertificateRevocationListsRequest.newBuilder() + * .setParent( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[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 + */ + public final ListCertificateRevocationListsPagedResponse listCertificateRevocationLists( + ListCertificateRevocationListsRequest request) { + return listCertificateRevocationListsPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists + * [CertificateRevocationLists][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateRevocationListsRequest request = + * ListCertificateRevocationListsRequest.newBuilder() + * .setParent( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * ApiFuture+ */ + public final UnaryCallable< + ListCertificateRevocationListsRequest, ListCertificateRevocationListsPagedResponse> + listCertificateRevocationListsPagedCallable() { + return stub.listCertificateRevocationListsPagedCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists + * [CertificateRevocationLists][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *future = + * certificateAuthorityServiceClient + * .listCertificateRevocationListsPagedCallable() + * .futureCall(request); + * // Do something. + * for (CertificateRevocationList element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateRevocationListsRequest request = + * ListCertificateRevocationListsRequest.newBuilder() + * .setParent( + * CertificateAuthorityName.of( + * "[PROJECT]", "[LOCATION]", "[CA_POOL]", "[CERTIFICATE_AUTHORITY]") + * .toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * 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> + listCertificateRevocationListsCallable() { + return stub.listCertificateRevocationListsCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Update a + * [CertificateRevocationList][google.cloud.security.privateca.v1.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.v1.CertificateRevocationList] + * with updated values. + * @param updateMask Required. A list of fields to be updated in this request. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateRevocationListRequest request = + * UpdateCertificateRevocationListRequest.newBuilder() + * .setCertificateRevocationList(CertificateRevocationList.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + UpdateCertificateRevocationListRequest, CertificateRevocationList, OperationMetadata> + updateCertificateRevocationListOperationCallable() { + return stub.updateCertificateRevocationListOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Update a + * [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList]. + * + *future = + * certificateAuthorityServiceClient + * .updateCertificateRevocationListOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateRevocationList response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateRevocationListRequest request = + * UpdateCertificateRevocationListRequest.newBuilder() + * .setCertificateRevocationList(CertificateRevocationList.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .updateCertificateRevocationListCallable() + * .futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]"); + * CertificateTemplate certificateTemplate = CertificateTemplate.newBuilder().build(); + * String certificateTemplateId = "certificateTemplateId1920134188"; + * CertificateTemplate response = + * certificateAuthorityServiceClient + * .createCertificateTemplateAsync(parent, certificateTemplate, certificateTemplateId) + * .get(); + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate], in the + * format `projects/*/locations/*`. + * @param certificateTemplate Required. A + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] with initial + * field values. + * @param certificateTemplateId Required. It must be unique within a location and match the + * regular expression `[a-zA-Z0-9_-]{1,63}` + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString(); + * CertificateTemplate certificateTemplate = CertificateTemplate.newBuilder().build(); + * String certificateTemplateId = "certificateTemplateId1920134188"; + * CertificateTemplate response = + * certificateAuthorityServiceClient + * .createCertificateTemplateAsync(parent, certificateTemplate, certificateTemplateId) + * .get(); + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate], in the + * format `projects/*/locations/*`. + * @param certificateTemplate Required. A + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] with initial + * field values. + * @param certificateTemplateId Required. It must be unique within a location and match the + * regular expression `[a-zA-Z0-9_-]{1,63}` + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateTemplateRequest request = + * CreateCertificateTemplateRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setCertificateTemplateId("certificateTemplateId1920134188") + * .setCertificateTemplate(CertificateTemplate.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * CertificateTemplate response = + * certificateAuthorityServiceClient.createCertificateTemplateAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateTemplateRequest request = + * CreateCertificateTemplateRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setCertificateTemplateId("certificateTemplateId1920134188") + * .setCertificateTemplate(CertificateTemplate.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + CreateCertificateTemplateRequest, CertificateTemplate, OperationMetadata> + createCertificateTemplateOperationCallable() { + return stub.createCertificateTemplateOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Create a new [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] in a + * given Project and Location. + * + *future = + * certificateAuthorityServiceClient + * .createCertificateTemplateOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateTemplate response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CreateCertificateTemplateRequest request = + * CreateCertificateTemplateRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setCertificateTemplateId("certificateTemplateId1920134188") + * .setCertificateTemplate(CertificateTemplate.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.createCertificateTemplateCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateTemplateName name = + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]"); + * certificateAuthorityServiceClient.deleteCertificateTemplateAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] in the format + * `projects/*/locations/*/certificateTemplates/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString(); + * certificateAuthorityServiceClient.deleteCertificateTemplateAsync(name).get(); + * } + * }+ * + * @param name Required. The resource name for this + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] in the format + * `projects/*/locations/*/certificateTemplates/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCertificateTemplateRequest request = + * DeleteCertificateTemplateRequest.newBuilder() + * .setName( + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * certificateAuthorityServiceClient.deleteCertificateTemplateAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCertificateTemplateRequest request = + * DeleteCertificateTemplateRequest.newBuilder() + * .setName( + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * certificateAuthorityServiceClient + * .deleteCertificateTemplateOperationCallable() + * .futureCall(request); + * // Do something. + * future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * DeleteCertificateTemplateRequest request = + * DeleteCertificateTemplateRequest.newBuilder() + * .setName( + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.deleteCertificateTemplateCallable().futureCall(request); + * // Do something. + * future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateTemplateName name = + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]"); + * CertificateTemplate response = certificateAuthorityServiceClient.getCertificateTemplate(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.CertificateTemplate.name] + * of the [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] to + * get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CertificateTemplate getCertificateTemplate(CertificateTemplateName name) { + GetCertificateTemplateRequest request = + GetCertificateTemplateRequest.newBuilder() + .setName(name == null ? null : name.toString()) + .build(); + return getCertificateTemplate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String name = + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString(); + * CertificateTemplate response = certificateAuthorityServiceClient.getCertificateTemplate(name); + * } + * }+ * + * @param name Required. The [name][google.cloud.security.privateca.v1.CertificateTemplate.name] + * of the [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] to + * get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final CertificateTemplate getCertificateTemplate(String name) { + GetCertificateTemplateRequest request = + GetCertificateTemplateRequest.newBuilder().setName(name).build(); + return getCertificateTemplate(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateTemplateRequest request = + * GetCertificateTemplateRequest.newBuilder() + * .setName( + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString()) + * .build(); + * CertificateTemplate response = + * certificateAuthorityServiceClient.getCertificateTemplate(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 + */ + public final CertificateTemplate getCertificateTemplate(GetCertificateTemplateRequest request) { + return getCertificateTemplateCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Returns a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * GetCertificateTemplateRequest request = + * GetCertificateTemplateRequest.newBuilder() + * .setName( + * CertificateTemplateName.of("[PROJECT]", "[LOCATION]", "[CERTIFICATE_TEMPLATE]") + * .toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.getCertificateTemplateCallable().futureCall(request); + * // Do something. + * CertificateTemplate response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]"); + * for (CertificateTemplate element : + * certificateAuthorityServiceClient.listCertificateTemplates(parent).iterateAll()) { + * // doThingsWith(element); + * } + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CertificateTemplates][google.cloud.security.privateca.v1.CertificateTemplate], in the + * format `projects/*/locations/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificateTemplatesPagedResponse listCertificateTemplates(LocationName parent) { + ListCertificateTemplatesRequest request = + ListCertificateTemplatesRequest.newBuilder() + .setParent(parent == null ? null : parent.toString()) + .build(); + return listCertificateTemplates(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateTemplates][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString(); + * for (CertificateTemplate element : + * certificateAuthorityServiceClient.listCertificateTemplates(parent).iterateAll()) { + * // doThingsWith(element); + * } + * } + * }+ * + * @param parent Required. The resource name of the location associated with the + * [CertificateTemplates][google.cloud.security.privateca.v1.CertificateTemplate], in the + * format `projects/*/locations/*`. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListCertificateTemplatesPagedResponse listCertificateTemplates(String parent) { + ListCertificateTemplatesRequest request = + ListCertificateTemplatesRequest.newBuilder().setParent(parent).build(); + return listCertificateTemplates(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateTemplates][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateTemplatesRequest request = + * ListCertificateTemplatesRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * for (CertificateTemplate element : + * certificateAuthorityServiceClient.listCertificateTemplates(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 + */ + public final ListCertificateTemplatesPagedResponse listCertificateTemplates( + ListCertificateTemplatesRequest request) { + return listCertificateTemplatesPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists [CertificateTemplates][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateTemplatesRequest request = + * ListCertificateTemplatesRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient + * .listCertificateTemplatesPagedCallable() + * .futureCall(request); + * // Do something. + * for (CertificateTemplate element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * ListCertificateTemplatesRequest request = + * ListCertificateTemplatesRequest.newBuilder() + * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .setFilter("filter-1274492040") + * .setOrderBy("orderBy-1207110587") + * .build(); + * while (true) { + * ListCertificateTemplatesResponse response = + * certificateAuthorityServiceClient.listCertificateTemplatesCallable().call(request); + * for (CertificateTemplate element : response.getResponsesList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; + * } + * } + * } + * }+ */ + public final UnaryCallable
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * CertificateTemplate certificateTemplate = CertificateTemplate.newBuilder().build(); + * FieldMask updateMask = FieldMask.newBuilder().build(); + * CertificateTemplate response = + * certificateAuthorityServiceClient + * .updateCertificateTemplateAsync(certificateTemplate, updateMask) + * .get(); + * } + * }+ * + * @param certificateTemplate Required. + * [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] with updated + * values. + * @param updateMask Required. A list of fields to be updated in this request. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateTemplateRequest request = + * UpdateCertificateTemplateRequest.newBuilder() + * .setCertificateTemplate(CertificateTemplate.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * CertificateTemplate response = + * certificateAuthorityServiceClient.updateCertificateTemplateAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateTemplateRequest request = + * UpdateCertificateTemplateRequest.newBuilder() + * .setCertificateTemplate(CertificateTemplate.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallable< + UpdateCertificateTemplateRequest, CertificateTemplate, OperationMetadata> + updateCertificateTemplateOperationCallable() { + return stub.updateCertificateTemplateOperationCallable(); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Update a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate]. + * + *future = + * certificateAuthorityServiceClient + * .updateCertificateTemplateOperationCallable() + * .futureCall(request); + * // Do something. + * CertificateTemplate response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient = + * CertificateAuthorityServiceClient.create()) { + * UpdateCertificateTemplateRequest request = + * UpdateCertificateTemplateRequest.newBuilder() + * .setCertificateTemplate(CertificateTemplate.newBuilder().build()) + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = + * certificateAuthorityServiceClient.updateCertificateTemplateCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
The default instance has everything set to sensible defaults: + * + *
The builder of this class is recursive, so contained classes are themselves builders. When + * build() is called, the tree of builders is called to create the complete settings object. + * + *
For example, to set the total timeout of createCertificate to 30 seconds: + * + *
{@code + * CertificateAuthorityServiceSettings.Builder certificateAuthorityServiceSettingsBuilder = + * CertificateAuthorityServiceSettings.newBuilder(); + * certificateAuthorityServiceSettingsBuilder + * .createCertificateSettings() + * .setRetrySettings( + * certificateAuthorityServiceSettingsBuilder + * .createCertificateSettings() + * .getRetrySettings() + * .toBuilder() + * .setTotalTimeout(Duration.ofSeconds(30)) + * .build()); + * CertificateAuthorityServiceSettings certificateAuthorityServiceSettings = + * certificateAuthorityServiceSettingsBuilder.build(); + * }+ */ +@Generated("by gapic-generator-java") +public class CertificateAuthorityServiceSettings + extends ClientSettings
Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction ======================= CertificateAuthorityServiceClient =======================
+ *
+ * Service Description: [Certificate Authority
+ * Service][google.cloud.security.privateca.v1.CertificateAuthorityService] manages private
+ * certificate authorities and issued certificates.
+ *
+ * Sample for CertificateAuthorityServiceClient:
+ *
+ * This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public abstract class CertificateAuthorityServiceStub implements BackgroundResource {
+
+ public OperationsStub getOperationsStub() {
+ throw new UnsupportedOperationException("Not implemented: getOperationsStub()");
+ }
+
+ public UnaryCallable The default instance has everything set to sensible defaults:
+ *
+ * The builder of this class is recursive, so contained classes are themselves builders. When
+ * build() is called, the tree of builders is called to create the complete settings object.
+ *
+ * For example, to set the total timeout of createCertificate to 30 seconds:
+ *
+ * {@code
+ * try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
+ * CertificateAuthorityServiceClient.create()) {
+ * CaPoolName parent = CaPoolName.of("[PROJECT]", "[LOCATION]", "[CA_POOL]");
+ * 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.v1;
+
+import javax.annotation.Generated;
diff --git a/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStub.java b/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStub.java
new file mode 100644
index 00000000..d048311b
--- /dev/null
+++ b/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStub.java
@@ -0,0 +1,355 @@
+/*
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.security.privateca.v1.stub;
+
+import static com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient.ListCaPoolsPagedResponse;
+import static com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient.ListCertificateAuthoritiesPagedResponse;
+import static com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient.ListCertificateRevocationListsPagedResponse;
+import static com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient.ListCertificateTemplatesPagedResponse;
+import static com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient.ListCertificatesPagedResponse;
+
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.security.privateca.v1.ActivateCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.CaPool;
+import com.google.cloud.security.privateca.v1.Certificate;
+import com.google.cloud.security.privateca.v1.CertificateAuthority;
+import com.google.cloud.security.privateca.v1.CertificateRevocationList;
+import com.google.cloud.security.privateca.v1.CertificateTemplate;
+import com.google.cloud.security.privateca.v1.CreateCaPoolRequest;
+import com.google.cloud.security.privateca.v1.CreateCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.CreateCertificateRequest;
+import com.google.cloud.security.privateca.v1.CreateCertificateTemplateRequest;
+import com.google.cloud.security.privateca.v1.DeleteCaPoolRequest;
+import com.google.cloud.security.privateca.v1.DeleteCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.DeleteCertificateTemplateRequest;
+import com.google.cloud.security.privateca.v1.DisableCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.EnableCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.FetchCaCertsRequest;
+import com.google.cloud.security.privateca.v1.FetchCaCertsResponse;
+import com.google.cloud.security.privateca.v1.FetchCertificateAuthorityCsrRequest;
+import com.google.cloud.security.privateca.v1.FetchCertificateAuthorityCsrResponse;
+import com.google.cloud.security.privateca.v1.GetCaPoolRequest;
+import com.google.cloud.security.privateca.v1.GetCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.GetCertificateRequest;
+import com.google.cloud.security.privateca.v1.GetCertificateRevocationListRequest;
+import com.google.cloud.security.privateca.v1.GetCertificateTemplateRequest;
+import com.google.cloud.security.privateca.v1.ListCaPoolsRequest;
+import com.google.cloud.security.privateca.v1.ListCaPoolsResponse;
+import com.google.cloud.security.privateca.v1.ListCertificateAuthoritiesRequest;
+import com.google.cloud.security.privateca.v1.ListCertificateAuthoritiesResponse;
+import com.google.cloud.security.privateca.v1.ListCertificateRevocationListsRequest;
+import com.google.cloud.security.privateca.v1.ListCertificateRevocationListsResponse;
+import com.google.cloud.security.privateca.v1.ListCertificateTemplatesRequest;
+import com.google.cloud.security.privateca.v1.ListCertificateTemplatesResponse;
+import com.google.cloud.security.privateca.v1.ListCertificatesRequest;
+import com.google.cloud.security.privateca.v1.ListCertificatesResponse;
+import com.google.cloud.security.privateca.v1.OperationMetadata;
+import com.google.cloud.security.privateca.v1.RevokeCertificateRequest;
+import com.google.cloud.security.privateca.v1.UndeleteCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.UpdateCaPoolRequest;
+import com.google.cloud.security.privateca.v1.UpdateCertificateAuthorityRequest;
+import com.google.cloud.security.privateca.v1.UpdateCertificateRequest;
+import com.google.cloud.security.privateca.v1.UpdateCertificateRevocationListRequest;
+import com.google.cloud.security.privateca.v1.UpdateCertificateTemplateRequest;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
+import com.google.protobuf.Empty;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Base stub class for the CertificateAuthorityService service API.
+ *
+ *
+ *
+ *
+ * {@code
+ * CertificateAuthorityServiceStubSettings.Builder certificateAuthorityServiceSettingsBuilder =
+ * CertificateAuthorityServiceStubSettings.newBuilder();
+ * certificateAuthorityServiceSettingsBuilder
+ * .createCertificateSettings()
+ * .setRetrySettings(
+ * certificateAuthorityServiceSettingsBuilder
+ * .createCertificateSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * CertificateAuthorityServiceStubSettings certificateAuthorityServiceSettings =
+ * certificateAuthorityServiceSettingsBuilder.build();
+ * }
+ */
+@Generated("by gapic-generator-java")
+public class CertificateAuthorityServiceStubSettings
+ extends StubSettings