# Google Certificate Authority Service V1 Client - Class CreateCertificateRequest (2.4.0)

2.4.0 (latest) 2.3.0 2.2.2 2.1.1 2.0.3 1.7.3 1.5.0 1.4.2 1.3.1 1.2.2 1.1.0 1.0.3 Reference documentation and code samples for the Google Certificate Authority Service V1 Client class CreateCertificateRequest.

Request message for
[CertificateAuthorityService.CreateCertificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Client.CertificateAuthorityServiceClient#_Google_Cloud_Security_PrivateCA_V1_Client_CertificateAuthorityServiceClient__createCertificate__).

Generated from protobuf message `google.cloud.security.privateca.v1.CreateCertificateRequest`

## Namespace

Google \\ Cloud \\ Security \\ PrivateCA \\ V1

## Methods

### __construct

Constructor.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `data` | `mixed` |

### getParent

Required. The resource name of the
[CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool) associated with the
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate), in the
format `projects/*/locations/*/caPools/*`.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setParent

Required. The resource name of the
[CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool) associated with the
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate), in the
format `projects/*/locations/*/caPools/*`.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getCertificateId

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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority)
in the Enterprise
[CertificateAuthority.tier](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority#_Google_Cloud_Security_PrivateCA_V1_CertificateAuthority__getTier__),
but is optional and its value is ignored otherwise.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setCertificateId

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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority)
in the Enterprise
[CertificateAuthority.tier](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority#_Google_Cloud_Security_PrivateCA_V1_CertificateAuthority__getTier__),
but is optional and its value is ignored otherwise.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getCertificate

Required. A [Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate)
with initial field values.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate|null` |   |

### hasCertificate

### clearCertificate

### setCertificate

Required. A [Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate)
with initial field values.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getRequestId

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).

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setRequestId

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).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getValidateOnly

Optional. If this is true, no
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate) resource will
be persisted regardless of the
[CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool)'s
[tier](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool#_Google_Cloud_Security_PrivateCA_V1_CaPool__getTier__), and the returned
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate) will not
contain the
[pem_certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate#_Google_Cloud_Security_PrivateCA_V1_Certificate__getPemCertificate__)
field.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `bool` |   |

### setValidateOnly

Optional. If this is true, no
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate) resource will
be persisted regardless of the
[CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool)'s
[tier](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool#_Google_Cloud_Security_PrivateCA_V1_CaPool__getTier__), and the returned
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate) will not
contain the
[pem_certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate#_Google_Cloud_Security_PrivateCA_V1_Certificate__getPemCertificate__)
field.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `bool` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getIssuingCertificateAuthorityId

Optional. The resource ID of the
[CertificateAuthority](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool) referenced by `parent`.

Per-CA quota rules apply. If left empty, a
[CertificateAuthority](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority)
will be chosen from the [CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool)
by the service. For example, to issue a
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CreateCertificateRequest#_Google_Cloud_Security_PrivateCA_V1_CreateCertificateRequest__getParent__)
to "projects/my-project/locations/us-central1/caPools/my-pool" and the
[issuing_certificate_authority_id](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CreateCertificateRequest#_Google_Cloud_Security_PrivateCA_V1_CreateCertificateRequest__getIssuingCertificateAuthorityId__)
to "my-ca".

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setIssuingCertificateAuthorityId

Optional. The resource ID of the
[CertificateAuthority](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool) referenced by `parent`.

Per-CA quota rules apply. If left empty, a
[CertificateAuthority](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority)
will be chosen from the [CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool)
by the service. For example, to issue a
[Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CreateCertificateRequest#_Google_Cloud_Security_PrivateCA_V1_CreateCertificateRequest__getParent__)
to "projects/my-project/locations/us-central1/caPools/my-pool" and the
[issuing_certificate_authority_id](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CreateCertificateRequest#_Google_Cloud_Security_PrivateCA_V1_CreateCertificateRequest__getIssuingCertificateAuthorityId__)
to "my-ca".

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### static::build

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `parent` | `string` Required. The resource name of the [CaPool](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CaPool) associated with the [Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate), in the format `projects/*/locations/*/caPools/*`. Please see CertificateAuthorityServiceClient::caPoolName() for help formatting this field. |
| `certificate` | `https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate` Required. A [Certificate](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.Certificate) with initial field values. |
| `certificateId` | `string` 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](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority) in the Enterprise [CertificateAuthority.tier](https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CertificateAuthority#_Google_Cloud_Security_PrivateCA_V1_CertificateAuthority__getTier__), but is optional and its value is ignored otherwise. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/php/docs/reference/cloud-security-private-ca/latest/V1.CreateCertificateRequest` |   |