- [Resource: CertificateTemplate](https://docs.cloud.google.com/certificate-authority-service/docs/reference/rest/v1/projects.locations.certificateTemplates.md.txt#CertificateTemplate)
  - [JSON representation](https://docs.cloud.google.com/certificate-authority-service/docs/reference/rest/v1/projects.locations.certificateTemplates.md.txt#CertificateTemplate.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/certificate-authority-service/docs/reference/rest/v1/projects.locations.certificateTemplates.md.txt#METHODS_SUMMARY)

## Resource: CertificateTemplate

A `CertificateTemplate` refers to a managed template for certificate issuance.

| JSON representation |
|---|
| ``` { "name": string, "maximumLifetime": string, "predefinedValues": { object (`X509Parameters`) }, "identityConstraints": { object (`CertificateIdentityConstraints`) }, "passthroughExtensions": { object (`CertificateExtensionConstraints`) }, "description": string, "createTime": string, "updateTime": string, "labels": { string: string, ... } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name for this `CertificateTemplate` in the format `projects/*/locations/*/certificateTemplates/*`. |
| `maximumLifetime` | ``string (`Duration` format)`` Optional. The maximum lifetime allowed for issued `Certificates` that use this template. If the issuing `CaPool` resource's `IssuancePolicy` specifies a `maximumLifetime` the minimum of the two durations will be the maximum lifetime for issued `Certificates`. Note that if the issuing `CertificateAuthority` expires before a `Certificate`'s requested maximumLifetime, the effective lifetime will be explicitly truncated to match it. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `"3.5s"`. |
| `predefinedValues` | ``object (`X509Parameters`)`` Optional. A set of X.509 values that will be applied to all issued certificates that use this template. If the certificate request includes conflicting values for the same properties, they will be overwritten by the values defined here. If the issuing `CaPool`'s `IssuancePolicy` defines conflicting `baselineValues` for the same properties, the certificate issuance request will fail. |
| `identityConstraints` | ``object (`CertificateIdentityConstraints`)`` Optional. Describes constraints on identities that may be appear in `Certificates` issued using this template. If this is omitted, then this template will not add restrictions on a certificate's identity. |
| `passthroughExtensions` | ``object (`CertificateExtensionConstraints`)`` Optional. Describes the set of X.509 extensions that may appear in a `Certificate` issued using this `CertificateTemplate`. If a certificate request sets extensions that don't appear in the `passthroughExtensions`, those extensions will be dropped. If the issuing `CaPool`'s `IssuancePolicy` defines `baselineValues` that don't appear here, the certificate issuance request will fail. If this is omitted, then this template will not add restrictions on a certificate's X.509 extensions. These constraints do not apply to X.509 extensions set in this `CertificateTemplate`'s `predefinedValues`. |
| `description` | `string` Optional. A human-readable description of scenarios this template is intended for. |
| `createTime` | ``string (`Timestamp` format)`` Output only. The time at which this `CertificateTemplate` was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`Timestamp` format)`` Output only. The time at which this `CertificateTemplate` was updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Optional. Labels with user-defined metadata. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |

| ## Methods ||
|---|---|
| ### `create` | Create a new `CertificateTemplate` in a given Project and Location. |
| ### `delete` | DeleteCertificateTemplate deletes a `CertificateTemplate`. |
| ### `get` | Returns a `CertificateTemplate`. |
| ### `getIamPolicy` | Gets the access control policy for a resource. |
| ### `list` | Lists `CertificateTemplates`. |
| ### `patch` | Update a `CertificateTemplate`. |
| ### `setIamPolicy` | Sets the access control policy on the specified resource. |
| ### `testIamPermissions` | Returns permissions that a caller has on the specified resource. |