» google_kms_key_ring

A KeyRing is a toplevel logical grouping of CryptoKeys.

To get more information about KeyRing, see:

» Example Usage - Kms Key Ring Basic

resource "google_kms_key_ring" "example-keyring" {
  name = "keyring-example"
  location = "global"
}

» Argument Reference

The following arguments are supported:

  • name - (Required) The resource name for the KeyRing.

  • location - (Required) The location for the KeyRing. A full list of valid locations can be found by running gcloud kms locations list.


  • project - (Optional) The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

» Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

  • self_link: The self link of the created KeyRing in the format projects/{project}/locations/{location}/keyRings/{name}

» Timeouts

This resource provides the following Timeouts configuration options:

  • create - Default is 4 minutes.
  • delete - Default is 4 minutes.

» Import

KeyRing can be imported using any of these accepted formats:

$ terraform import google_kms_key_ring.default projects/{{project}}/locations/{{location}}/keyRings/{{name}}
$ terraform import google_kms_key_ring.default {{project}}/{{location}}/{{name}}
$ terraform import google_kms_key_ring.default {{location}}/{{name}}