# REST Resource: projects.secrets.versions

- [Resource: SecretVersion](https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion)
  - [JSON representation](https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#State)
- [Methods](https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#METHODS_SUMMARY)

## Resource: SecretVersion

A secret version resource in the Secret Manager API.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "destroyTime": string, "state": enum (`https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#State`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` in the format `projects/*/secrets/*/versions/*`. `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` IDs in a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets#Secret` start at 1 and are incremented for each subsequent version of the secret. |
| `createTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. The time at which the `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `destroyTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. The time this `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` was destroyed. Only present if `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion.FIELDS.state` is `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#State.ENUM_VALUES.DESTROYED`. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `state` | ``enum (`https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#State`)`` Output only. The current state of the `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |

## State

The state of a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`, indicating if it can be accessed.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Not specified. This value is unused and invalid. |
| `ENABLED` | The `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` may be accessed. |
| `DISABLED` | The `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` may not be accessed, but the secret data is still available and can be placed back into the `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#State.ENUM_VALUES.ENABLED` state. |
| `DESTROYED` | The `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion` is destroyed and the secret data is no longer stored. A version may not leave this state once entered. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions/access` | Accesses a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |
| ### `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions/destroy` | Destroys a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |
| ### `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions/disable` | Disables a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |
| ### `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions/enable` | Enables a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |
| ### `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions/get` | Gets metadata for a `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |
| ### `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions/list` | Lists `https://docs.cloud.google.com/secret-manager/docs/reference/rest/v1beta1/projects.secrets.versions#SecretVersion`. |