/*
 * Copyright 2020 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.
 */
// Generated by the protocol buffer compiler.  DO NOT EDIT!
// source: google/cloud/security/privateca/v1/service.proto

package com.google.cloud.security.privateca.v1;

public interface CreateCertificateRequestOrBuilder
    extends
    // @@protoc_insertion_point(interface_extends:google.cloud.security.privateca.v1.CreateCertificateRequest)
    com.google.protobuf.MessageOrBuilder {

  /**
   *
   *
   * <pre>
   * 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/&#42;&#47;locations/&#42;&#47;caPools/&#42;`.
   * </pre>
   *
   * <code>
   * string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
   * </code>
   *
   * @return The parent.
   */
  java.lang.String getParent();
  /**
   *
   *
   * <pre>
   * 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/&#42;&#47;locations/&#42;&#47;caPools/&#42;`.
   * </pre>
   *
   * <code>
   * string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
   * </code>
   *
   * @return The bytes for parent.
   */
  com.google.protobuf.ByteString getParentBytes();

  /**
   *
   *
   * <pre>
   * 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 [CertificateAuthority.Tier][], but is optional and its
   * value is ignored otherwise.
   * </pre>
   *
   * <code>string certificate_id = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The certificateId.
   */
  java.lang.String getCertificateId();
  /**
   *
   *
   * <pre>
   * 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 [CertificateAuthority.Tier][], but is optional and its
   * value is ignored otherwise.
   * </pre>
   *
   * <code>string certificate_id = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The bytes for certificateId.
   */
  com.google.protobuf.ByteString getCertificateIdBytes();

  /**
   *
   *
   * <pre>
   * Required. A [Certificate][google.cloud.security.privateca.v1.Certificate]
   * with initial field values.
   * </pre>
   *
   * <code>
   * .google.cloud.security.privateca.v1.Certificate certificate = 3 [(.google.api.field_behavior) = REQUIRED];
   * </code>
   *
   * @return Whether the certificate field is set.
   */
  boolean hasCertificate();
  /**
   *
   *
   * <pre>
   * Required. A [Certificate][google.cloud.security.privateca.v1.Certificate]
   * with initial field values.
   * </pre>
   *
   * <code>
   * .google.cloud.security.privateca.v1.Certificate certificate = 3 [(.google.api.field_behavior) = REQUIRED];
   * </code>
   *
   * @return The certificate.
   */
  com.google.cloud.security.privateca.v1.Certificate getCertificate();
  /**
   *
   *
   * <pre>
   * Required. A [Certificate][google.cloud.security.privateca.v1.Certificate]
   * with initial field values.
   * </pre>
   *
   * <code>
   * .google.cloud.security.privateca.v1.Certificate certificate = 3 [(.google.api.field_behavior) = REQUIRED];
   * </code>
   */
  com.google.cloud.security.privateca.v1.CertificateOrBuilder getCertificateOrBuilder();

  /**
   *
   *
   * <pre>
   * Optional. An ID to identify requests. Specify a unique request ID so that
   * if you must retry your request, the server will know to ignore the request
   * if it has already been completed. The server will guarantee that for at
   * least 60 minutes since the first request.
   * For example, consider a situation where you make an initial request and the
   * request times out. If you make the request again with the same request ID,
   * the server can check if original operation with the same request ID was
   * received, and if so, will ignore the second request. This prevents clients
   * from accidentally creating duplicate commitments.
   * The request ID must be a valid UUID with the exception that zero UUID is
   * not supported (00000000-0000-0000-0000-000000000000).
   * </pre>
   *
   * <code>string request_id = 4 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The requestId.
   */
  java.lang.String getRequestId();
  /**
   *
   *
   * <pre>
   * Optional. An ID to identify requests. Specify a unique request ID so that
   * if you must retry your request, the server will know to ignore the request
   * if it has already been completed. The server will guarantee that for at
   * least 60 minutes since the first request.
   * For example, consider a situation where you make an initial request and the
   * request times out. If you make the request again with the same request ID,
   * the server can check if original operation with the same request ID was
   * received, and if so, will ignore the second request. This prevents clients
   * from accidentally creating duplicate commitments.
   * The request ID must be a valid UUID with the exception that zero UUID is
   * not supported (00000000-0000-0000-0000-000000000000).
   * </pre>
   *
   * <code>string request_id = 4 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The bytes for requestId.
   */
  com.google.protobuf.ByteString getRequestIdBytes();

  /**
   *
   *
   * <pre>
   * Optional. If this is true, no
   * [Certificate][google.cloud.security.privateca.v1.Certificate] resource will
   * be persisted regardless of the
   * [CaPool][google.cloud.security.privateca.v1.CaPool]'s
   * [tier][google.cloud.security.privateca.v1.CaPool.tier], and the returned
   * [Certificate][google.cloud.security.privateca.v1.Certificate] will not
   * contain the
   * [pem_certificate][google.cloud.security.privateca.v1.Certificate.pem_certificate]
   * field.
   * </pre>
   *
   * <code>bool validate_only = 5 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The validateOnly.
   */
  boolean getValidateOnly();

  /**
   *
   *
   * <pre>
   * Optional. The resource ID of the
   * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]
   * that should issue the certificate.  This optional field will ignore the
   * load-balancing scheme of the Pool and directly issue the certificate from
   * the CA with the specified ID, contained in the same
   * [CaPool][google.cloud.security.privateca.v1.CaPool] referenced by `parent`.
   * Per-CA quota rules apply. If left empty, a
   * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]
   * will be chosen from the [CaPool][google.cloud.security.privateca.v1.CaPool]
   * by the service. For example, to issue a
   * [Certificate][google.cloud.security.privateca.v1.Certificate] from a
   * Certificate Authority with resource name
   * "projects/my-project/locations/us-central1/caPools/my-pool/certificateAuthorities/my-ca",
   * you can set the
   * [parent][google.cloud.security.privateca.v1.CreateCertificateRequest.parent]
   * to "projects/my-project/locations/us-central1/caPools/my-pool" and the
   * [issuing_certificate_authority_id][google.cloud.security.privateca.v1.CreateCertificateRequest.issuing_certificate_authority_id]
   * to "my-ca".
   * </pre>
   *
   * <code>string issuing_certificate_authority_id = 6 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   *
   * @return The issuingCertificateAuthorityId.
   */
  java.lang.String getIssuingCertificateAuthorityId();
  /**
   *
   *
   * <pre>
   * Optional. The resource ID of the
   * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]
   * that should issue the certificate.  This optional field will ignore the
   * load-balancing scheme of the Pool and directly issue the certificate from
   * the CA with the specified ID, contained in the same
   * [CaPool][google.cloud.security.privateca.v1.CaPool] referenced by `parent`.
   * Per-CA quota rules apply. If left empty, a
   * [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority]
   * will be chosen from the [CaPool][google.cloud.security.privateca.v1.CaPool]
   * by the service. For example, to issue a
   * [Certificate][google.cloud.security.privateca.v1.Certificate] from a
   * Certificate Authority with resource name
   * "projects/my-project/locations/us-central1/caPools/my-pool/certificateAuthorities/my-ca",
   * you can set the
   * [parent][google.cloud.security.privateca.v1.CreateCertificateRequest.parent]
   * to "projects/my-project/locations/us-central1/caPools/my-pool" and the
   * [issuing_certificate_authority_id][google.cloud.security.privateca.v1.CreateCertificateRequest.issuing_certificate_authority_id]
   * to "my-ca".
   * </pre>
   *
   * <code>string issuing_certificate_authority_id = 6 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   *
   * @return The bytes for issuingCertificateAuthorityId.
   */
  com.google.protobuf.ByteString getIssuingCertificateAuthorityIdBytes();
}