Skip to content

Commit 7c5452a

Browse files
Documentation changes for keyhandle data source (#12613) (#20758)
[upstream:c540b739b0dcc0819e19fa0cb990a904973462ab] Signed-off-by: Modular Magician <magic-modules@google.com>
1 parent c5103b6 commit 7c5452a

File tree

2 files changed

+20
-3
lines changed

2 files changed

+20
-3
lines changed

.changelog/12613.txt

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
```release-note:note
2+
kmskeyhandle: improved documentation for keyhandle datasource
3+
```

website/docs/d/kms_key_handle.html.markdown

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,16 @@ description: |-
66

77
# google_kms_key_handle
88

9-
Provides access to Google Cloud Platform KMS KeyHandle. For more information see
9+
Provides access to Google Cloud Platform KMS KeyHandle. A key handle is a Cloud KMS resource that helps you safely span the separation of duties to create new Cloud KMS keys for CMEK using Autokey.
10+
11+
~> **Warning:** This resource is in beta, and should be used with the terraform-provider-google-beta provider.
12+
See [Provider Versions](https://terraform.io/docs/providers/google/guides/provider_versions.html) for more details on beta resources.
13+
14+
For more information see
1015
[the official documentation](https://cloud.google.com/kms/docs/resource-hierarchy#key_handles)
1116
and
1217
[API](https://cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyHandles).
1318

14-
A key handle is a Cloud KMS resource that helps you safely span the separation of duties to create new Cloud KMS keys for CMEK using Autokey.
1519

1620
## Example Usage
1721

@@ -42,4 +46,14 @@ The following arguments are supported:
4246
In addition to the arguments listed above, the following computed attributes are
4347
exported:
4448

45-
* `id` - The identifier of the created KeyHandle. Its format is `projects/{projectId}/locations/{location}/keyHandles/{keyHandleName}`.
49+
* `id` - The identifier of the KeyHandle. Its format is `projects/{projectId}/locations/{location}/keyHandles/{keyHandleName}`.
50+
51+
* `kms_key` - The identifier of the KMS Key created for the KeyHandle. Its format is `projects/{projectId}/locations/{location}/keyRings/{keyRingName}/cryptoKeys/{cryptoKeyName}`.
52+
53+
* `location` - The location of the KMS Key and KeyHandle.
54+
55+
* `project` - The identifier of the project where KMS KeyHandle is created.
56+
57+
* `resource_type_selector` - Indicates the resource type that the resulting CryptoKey is meant to protect, e.g. {SERVICE}.googleapis.com/{TYPE}. See documentation for supported resource types.
58+
59+

0 commit comments

Comments
 (0)