# REST Resource: projects.locations.datasets

## Resource: Dataset

A message representing a health dataset.

A health dataset represents a collection of healthcare data pertaining to one or more patients. This may include multiple modalities of healthcare data, such as electronic medical records or medical imaging data.

| JSON representation |
|---|
| ``` { "name": string, "timeZone": string, "encryptionSpec": { object(`https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets#EncryptionSpec`) }, "satisfiesPzs": boolean, "satisfiesPzi": boolean } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Resource name of the dataset, of the form `projects/{projectId}/locations/{locationId}/datasets/{datasetId}`. |
| `timeZone` | `string` Optional. The default timezone used by this dataset. Must be a either a valid IANA time zone name such as "America/New_York" or empty, which defaults to UTC. This is used for parsing times in resources, such as HL7 messages, where no explicit timezone is specified. |
| `encryptionSpec` | ``object(`https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets#EncryptionSpec`)`` Optional. Customer-managed encryption key spec for a Dataset. If set, this Dataset and all of its sub-resources will be secured by this key. If empty, the Dataset is secured by the default Google encryption key. |
| `satisfiesPzs` | `boolean` Output only. Whether the dataset satisfies zone separation. |
| `satisfiesPzi` | `boolean` Output only. Whether the dataset satisfies zone isolation. |

## EncryptionSpec

Represents a customer-managed encryption key spec that can be applied to a resource.

| JSON representation |
|---|
| ``` { "kmsKeyName": string } ``` |

| Fields ||
|---|---|
| `kmsKeyName` | `string` Required. The resource name of customer-managed encryption key that is used to secure a resource and its sub-resources. Only the key in the same location as this Dataset is allowed to be used for encryption. Format is: `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{key}` |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/create` | Creates a new health dataset. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/deidentify` | Creates a new dataset containing de-identified data from the source dataset. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/delete` | Deletes the specified health dataset and all data contained in the dataset. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/get` | Gets any metadata associated with a dataset. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/getIamPolicy` | Gets the access control policy for a resource. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/list` | Lists the health datasets in the current project. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/patch` | Updates dataset metadata. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/setIamPolicy` | Sets the access control policy on the specified resource. |
| ### `https://docs.cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets/testIamPermissions` | Returns permissions that a caller has on the specified resource. |