# REST Resource: projects.locations.clientTlsPolicies

- [Resource: ClientTlsPolicy](https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies#ClientTlsPolicy)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies#ClientTlsPolicy.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies#METHODS_SUMMARY)

## Resource: ClientTlsPolicy

ClientTlsPolicy is a resource that specifies how a client should authenticate connections to backends of a service. This resource itself does not affect configuration unless it is attached to a backend service resource.

| JSON representation |
|---|
| ``` { "name": string, "description": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "sni": string, "clientCertificate": { object (`https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/CertificateProvider`) }, "serverValidationCa": [ { object (`https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/ValidationCA`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{clientTlsPolicy}` |
| `description` | `string` Optional. Free-text description of the resource. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 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 (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 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. Set of label tags associated with the resource. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `sni` | `string` Optional. Server Name Indication string to present to the server during TLS handshake. E.g: "secure.example.com". |
| `clientCertificate` | ``object (`https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/CertificateProvider`)`` Optional. Defines a mechanism to provision client identity (public and private keys) for peer to peer authentication. The presence of this dictates mTLS. |
| `serverValidationCa[]` | ``object (`https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/ValidationCA`)`` Optional. Defines the mechanism to obtain the Certificate Authority certificate to validate the server certificate. If empty, client does not validate the server certificate. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies/create` | Creates a new ClientTlsPolicy in a given project and location. |
| ### `https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies/delete` | Deletes a single ClientTlsPolicy. |
| ### `https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies/get` | Gets details of a single ClientTlsPolicy. |
| ### `https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies/list` | Lists ClientTlsPolicies in a given project and location. |
| ### `https://docs.cloud.google.com/service-mesh/v1.26/docs/reference/network-security/rest/v1beta1/projects.locations.clientTlsPolicies/patch` | Updates the parameters of a single ClientTlsPolicy. |