# REST Resource: projects.locations.keyRings

- [Resource: KeyRing](https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing)
  - [JSON representation](https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#METHODS_SUMMARY)

## Resource: KeyRing

A `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing` is a toplevel logical grouping of `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings.cryptoKeys#CryptoKey`.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name for the `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing` in the format `projects/*/locations/*/keyRings/*`. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time at which this `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing` 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"`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings/create` | Create a new `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing` in a given Project and Location. |
| ### `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings/get` | Returns metadata for a given `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing`. |
| ### `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings/getIamPolicy` | Gets the access control policy for a resource. |
| ### `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings/list` | Lists `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings#KeyRing`. |
| ### `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings/setIamPolicy` | Sets the access control policy on the specified resource. |
| ### `https://docs.cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings/testIamPermissions` | Returns permissions that a caller has on the specified resource. |