add

Author: SevenEarth

tencentcloud/services/kms/data_source_tc_kms_keys.md

@@ -8,5 +8,6 @@ data "tencentcloud_kms_keys" "example" {
   key_state        = 0
   origin           = "TENCENT_KMS"
   key_usage        = "ALL"
+  hsm_cluster_id   = "cls-hsm-mwpd9cjm"
 }
 ```

tencentcloud/services/kms/data_source_tc_kms_service_status.go

@@ -88,12 +88,12 @@ func DataSourceTencentCloudKmsServiceStatus() *schema.Resource {
 				Elem: &schema.Resource{
 					Schema: map[string]*schema.Schema{
 						"hsm_cluster_id": {
-							Type:        schema.TypeInt,
+							Type:        schema.TypeString,
 							Required:    true,
 							Description: "Exclusive cluster ID.",
 						},
 						"hsm_cluster_name": {
-							Type:        schema.TypeInt,
+							Type:        schema.TypeString,
 							Required:    true,
 							Description: "Exclusive cluster name.",
 						},

tencentcloud/services/kms/resource_tc_kms_external_key.md

@@ -6,11 +6,25 @@ Create a basic instance.
 
 ```hcl
 resource "tencentcloud_kms_external_key" "example" {
-  alias               = "tf-example-kms-externalkey"
-  description         = "example of kms external key"
+  alias       = "tf-example-kms-externalkey"
+  description = "example of kms external key"
 
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "terraform"
+  }
+}
+```
+
+Create kms instance with HSM
+
+```hcl
+resource "tencentcloud_kms_external_key" "example" {
+  alias          = "tf-example-kms-externalkey"
+  description    = "example of kms external key"
+  hsm_cluster_id = "cls-hsm-mwpd9cjm"
+  
+  tags = {
+    createdBy = "terraform"
   }
 }
 ```
@@ -26,7 +40,7 @@ resource "tencentcloud_kms_external_key" "example" {
   is_enabled          = true
 
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "terraform"
   }
 }
 ```
@@ -42,7 +56,7 @@ resource "tencentcloud_kms_external_key" "example" {
   is_enabled          = false
 
   tags = {
-    "test-tag" = "unit-test"
+    createdBy = "terraform"
   }
 }
 ```
@@ -52,5 +66,5 @@ Import
 KMS external keys can be imported using the id, e.g.
 
 ```
-$ terraform import tencentcloud_kms_external_key.example 287e8f40-7cbb-11eb-9a3a-xxxxx
-```
+$ terraform import tencentcloud_kms_external_key.example 25068921-2101-11f0-bf1f-5254000328e1
+```

tencentcloud/services/kms/resource_tc_kms_key.md

@@ -18,6 +18,23 @@ resource "tencentcloud_kms_key" "example" {
 }
 ```
 
+Create kms instance with HSM
+
+```hcl
+resource "tencentcloud_kms_key" "example" {
+  alias                         = "tf-example-kms-key"
+  description                   = "example of kms key"
+  key_rotation_enabled          = false
+  is_enabled                    = true
+  pending_delete_window_in_days = 7
+  hsm_cluster_id                = "cls-hsm-mwpd9cjm"
+
+  tags = {
+    createdBy = "Terraform"
+  }
+}
+```
+
 Specify the Key Usage as an asymmetry method.
 
 ```hcl

website/docs/d/kms_keys.html.markdown

@@ -19,6 +19,7 @@ data "tencentcloud_kms_keys" "example" {
   key_state        = 0
   origin           = "TENCENT_KMS"
   key_usage        = "ALL"
+  hsm_cluster_id   = "cls-hsm-mwpd9cjm"
 }
 ```
 

website/docs/r/kms_external_key.html.markdown

@@ -21,7 +21,21 @@ resource "tencentcloud_kms_external_key" "example" {
   description = "example of kms external key"
 
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "terraform"
+  }
+}
+```
+
+### Create kms instance with HSM
+
+```hcl
+resource "tencentcloud_kms_external_key" "example" {
+  alias          = "tf-example-kms-externalkey"
+  description    = "example of kms external key"
+  hsm_cluster_id = "cls-hsm-mwpd9cjm"
+
+  tags = {
+    createdBy = "terraform"
   }
 }
 ```
@@ -37,7 +51,7 @@ resource "tencentcloud_kms_external_key" "example" {
   is_enabled          = true
 
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "terraform"
   }
 }
 ```
@@ -53,7 +67,7 @@ resource "tencentcloud_kms_external_key" "example" {
   is_enabled          = false
 
   tags = {
-    "test-tag" = "unit-test"
+    createdBy = "terraform"
   }
 }
 ```
@@ -86,6 +100,6 @@ In addition to all arguments above, the following attributes are exported:
 KMS external keys can be imported using the id, e.g.
 
 ```
-$ terraform import tencentcloud_kms_external_key.example 287e8f40-7cbb-11eb-9a3a-xxxxx
+$ terraform import tencentcloud_kms_external_key.example 25068921-2101-11f0-bf1f-5254000328e1
 ```
 

website/docs/r/kms_key.html.markdown

@@ -29,6 +29,23 @@ resource "tencentcloud_kms_key" "example" {
 }
 ```
 
+### Create kms instance with HSM
+
+```hcl
+resource "tencentcloud_kms_key" "example" {
+  alias                         = "tf-example-kms-key"
+  description                   = "example of kms key"
+  key_rotation_enabled          = false
+  is_enabled                    = true
+  pending_delete_window_in_days = 7
+  hsm_cluster_id                = "cls-hsm-mwpd9cjm"
+
+  tags = {
+    createdBy = "Terraform"
+  }
+}
+```
+
 ### Specify the Key Usage as an asymmetry method.
 
 ```hcl